RSpec functions

Transcript

1. 1.

   RSpec functions Kenta Murata 2012.09.21 12೥9݄21೔༵ۚ೔

2. 2.

   Only about 2.11.x 12೥9݄21೔༵ۚ೔

3. 3.

   Core 12೥9݄21೔༵ۚ೔

4. 4.

   Terms require ‘spec_helper’ describe Account do context ‘when the subject

   is an admin’ do subject { described_class.make(:admin => true) } it { should be_admin } end context ‘when the subject is not an admin’ do subject { described_class.make(:admin => false) } it { should_not be_admin } end end 12೥9݄21೔༵ۚ೔
5. 5.

   Terms require ‘spec_helper’ describe Account do context ‘when the subject

   is an admin’ do subject { described_class.make(:admin => true) } it { should be_admin } end context ‘when the subject is not an admin’ do subject { described_class.make(:admin => false) } it { should_not be_admin } end end Example group 12೥9݄21೔༵ۚ೔
6. 6.

   Terms require ‘spec_helper’ describe Account do context ‘when the subject

   is an admin’ do subject { described_class.make(:admin => true) } it { should be_admin } end context ‘when the subject is not an admin’ do subject { described_class.make(:admin => false) } it { should_not be_admin } end end Example group Example group 12೥9݄21೔༵ۚ೔
7. 7.

   Terms require ‘spec_helper’ describe Account do context ‘when the subject

   is an admin’ do subject { described_class.make(:admin => true) } it { should be_admin } end context ‘when the subject is not an admin’ do subject { described_class.make(:admin => false) } it { should_not be_admin } end end Code example Code example 12೥9݄21೔༵ۚ೔
8. 8.

   Terms require ‘spec_helper’ describe Account do context ‘when the subject

   is an admin’ do subject { described_class.make(:admin => true) } it { should be_admin } end context ‘when the subject is not an admin’ do subject { described_class.make(:admin => false) } it { should_not be_admin } end end Expectation Expectation 12೥9݄21೔༵ۚ೔
9. 9.

   Terms require ‘spec_helper’ describe Account do context ‘when the subject

   is an admin’ do subject { described_class.make(:admin => true) } it { should be_admin } end context ‘when the subject is not an admin’ do subject { described_class.make(:admin => false) } it { should_not be_admin } end end Spec file 12೥9݄21೔༵ۚ೔
10. 10.

    Terms BDD TDD Expectations Assertions Code examples Tests Example groups

    Test cases 12೥9݄21೔༵ۚ೔
11. 11.

    Shared example shared_examples “a collection” do # assumes the described

    class can be initialized with an Array let(:collection) { described_class.new([7, 2, 4]) } context “initialized with 3 items” do it “says it has three items” do collection.size.should eq(3) end end describe “#include?” do context “with an item that is in the collection” do it “returns true” do collection.should be_include(7) end end end end 12೥9݄21೔༵ۚ೔
12. 12.

    Using shared example require ‘set’ describe Array do it_behaves_like “a

    collection” end describe Set do it_behaves_like “a collection” end 12೥9݄21೔༵ۚ೔
13. 13.

    Shared example with parameters shared_examples “a measurable object” do |measurement,

    measurement_methods| measurement_methods.each do |measurement_method| describe “##{measurement_method}“ do it “should return #{measurement}” do subject.send(measurement_method).should eq(measurement) end end end end describe Array, “with 3 items” do subject { [1, 2, 3] } it_behaves_like “a measurable object”, 3, [:size, :length] end describe String, “of 6 ASCII-chars” do subject { “FooBar” } it_behaves_like “a measurable object”, 6, [:bytesize, :size, :length] end 12೥9݄21೔༵ۚ೔
14. 14.

    Shared example with parameters shared_examples “a measurable object” do |measurement,

    measurement_methods| measurement_methods.each do |measurement_method| describe “##{measurement_method}“ do it “should return #{measurement}” do subject.send(measurement_method).should eq(measurement) end end end end describe Array, “with 3 items” do subject { [1, 2, 3] } it_behaves_like “a measurable object”, 3, [:size, :length] end describe String, “of 6 ASCII-chars” do subject { “FooBar” } it_behaves_like “a measurable object”, 6, [:bytesize, :size, :length] end 12೥9݄21೔༵ۚ೔
15. 15.

    Shared example with parameters shared_examples “a measurable object” do |measurement,

    measurement_methods| measurement_methods.each do |measurement_method| describe “##{measurement_method}“ do it “should return #{measurement}” do subject.send(measurement_method).should eq(measurement) end end end end describe Array, “with 3 items” do subject { [1, 2, 3] } it_behaves_like “a measurable object”, 3, [:size, :length] end describe String, “of 6 ASCII-chars” do subject { “FooBar” } it_behaves_like “a measurable object”, 6, [:bytesize, :size, :length] end 12೥9݄21೔༵ۚ೔
16. 16.

    shared context shared_context “shared stuff” do before { @some_var =

    :some_value } def shared_method “it works” end let(:shared_let) { { ‘arbitrary’ => ‘object’ } } subject { ‘this is the subject’ } end 12೥9݄21೔༵ۚ೔
17. 17.

    include shared context describe ‘group that includes a shared context

    using ‘include_context’” do include_context ‘shared stuff’ specify ‘access things defined in the included shared context’ do shared_method.should eq(‘it works’) shared_let[‘arbitrary’].should eq(‘object’) @some_var.should be(:some_value) subject.should eq(‘this is the subject’) end end 12೥9݄21೔༵ۚ೔
18. 18.

    shared context with metadata shared_context “shared stuff”, :foo => :bar

    do before { @some_var = :some_value } def shared_method “it works” end let(:shared_let) { { ‘arbitrary’ => ‘object’ } } subject { ‘this is the subject’ } end 12೥9݄21೔༵ۚ೔
19. 19.

    shared context with metadata shared_context “shared stuff”, :foo => :bar

    do before { @some_var = :some_value } def shared_method “it works” end let(:shared_let) { { ‘arbitrary’ => ‘object’ } } subject { ‘this is the subject’ } end 12೥9݄21೔༵ۚ೔
20. 20.

    include shared context by metadata describe ‘group that includes a

    shared context by metadata”, :foo => :bar do specify ‘access things defined in the included shared context’ do shared_method.should eq(‘it works’) shared_let[‘arbitrary’].should eq(‘object’) @some_var.should be(:some_value) subject.should eq(‘this is the subject’) end end 12೥9݄21೔༵ۚ೔
21. 21.

    include shared context by metadata describe ‘group that includes a

    shared context by metadata”, :foo => :bar do specify ‘access things defined in the included shared context’ do shared_method.should eq(‘it works’) shared_let[‘arbitrary’].should eq(‘object’) @some_var.should be(:some_value) subject.should eq(‘this is the subject’) end end 12೥9݄21೔༵ۚ೔
22. 22.

    pending with condition pending(“reason”, :if => true) { expectations }

    # this is pending pending(“reason”, :if => false) { expectations } # this is not pending pending(“reason”, :unless => true) { expectations } # this is not pending pending(“reason”, :unless => false) { expectations } # this is pending 12೥9݄21೔༵ۚ೔
23. 23.

    around hook describe “...” do around(:each) do |ex| before preparation

    ex.run ensure finalization end end ... end 12೥9݄21೔༵ۚ೔
24. 24.

    example usage of around hook # examples are run in

    temporary directries around(:each) do |ex| Dir.mktmpdir do |tmpdir| Dir.chdir tmpdir do ex.run end end end 12೥9݄21೔༵ۚ೔
25. 25.

    example usage of around hook # with Timecop around(:each) do

    |ex| Timecop.travel(Time.local(2012, 7, 20, 12, 34, 56)) do ex.run end end 12೥9݄21೔༵ۚ೔
26. 26.

    let and let! • helper method for memoization • let(:name)

    { ... } • is not called automatically • let!(:name) { ... } • is called automatically in a before hook 12೥9݄21೔༵ۚ೔
27. 27.

    metadata describe “with metadata”, :foo, :bar, :baz => 42 do

    it ‘has `:fast => true` metadata’ do example.metadata[:fast].should eq(true) end it ‘has `:bar => true` metadata’ do example.metadata[:bar].should eq(true) end it ‘has `:baz => 42` metadata’ do example.metadata[:baz].should eq(42) end it ‘has `:hoge => true` metadata’, :hoge do example.metadata[:hoge].should eq(true) end end 12೥9݄21೔༵ۚ೔
28. 28.

    metadata describe “with metadata”, :foo, :bar, :baz => 42 do

    it ‘has `:fast => true` metadata’ do example.metadata[:fast].should eq(true) end it ‘has `:bar => true` metadata’ do example.metadata[:bar].should eq(true) end it ‘has `:baz => 42` metadata’ do example.metadata[:baz].should eq(42) end it ‘has `:hoge => true` metadata’, :hoge do example.metadata[:hoge].should eq(true) end end 12೥9݄21೔༵ۚ೔
29. 29.

    :focus • If examples with :focus metadata, rspec evaluates only

    these examples. 12೥9݄21೔༵ۚ೔
30. 30.

    fail fast • Use fail_fast option to tell RSpec to

    abort the run on first failure. 12೥9݄21೔༵ۚ೔
31. 31.

    fail fast # write the following configuration in spec_helper.rb RSpec.configure

    do |config| config.fail_fast = true end # or use --fail-fast command line option $ rspec --fail-fast 12೥9݄21೔༵ۚ೔
32. 32.

    Expectations 12೥9݄21೔༵ۚ೔

33. 33.

    The basic structure •actual.should matcher(expected) •actual.should_not matcher(expected) 12೥9݄21೔༵ۚ೔

34. 34.

    Built-in matchers 12೥9݄21೔༵ۚ೔

35. 35.

    identity actual.should be(expected) it is same as: (actual.equal? expected).should be_true

    12೥9݄21೔༵ۚ೔
36. 36.

    equivalence actual.should eq(expected) it is same as: (actual == expected).should

    be_true actual.should eql(expected) it is same as: (actual.eql? expected).should be_true actual.should equal(expected) it is same as: (actual.equal? expected).should be_true 12೥9݄21೔༵ۚ೔
37. 37.

    Comparisons actual.should be > expected actual.should be >= expected actual.should

    be < expected actual.should be <= expected actual.should =~ /expression/ actual.should match(/expression/) actual.should be_within(delta).of(expected) it is same as: (actual - expected).abs.should be <= delta 12೥9݄21೔༵ۚ೔
38. 38.

    errors and throws expect { ... }.to raise_error expect {

    ... }.to raise_error(ExceptionClass) expect { ... }.to raise_error(/pattern matches to message/) expect { ... }.to raise_error(ExcpetionClass, /pattern/) expect { ... }.to throw_symbol expect { ... }.to throw_symbol(:symbol) expect { ... }.to throw_symbol(:symbol, value) 12೥9݄21೔༵ۚ೔
39. 39.

    predicates actual.should be_xxx # maps to actual.xxx? actual.should have_xxx(:arg) #

    maps to actual.has_xxx?(:arg) e.g.) [].should be_empty? {:foo => :bar}.should have_key(:foo) 12೥9݄21೔༵ۚ೔
40. 40.

    collection membership [1, 2, 3].should include(1) [1, 2, 3].should include(1,

    2) {:a => :b}.should include(:a => :b) “this string”.should include(“is str”) (1..10).should cover(3) # only >1.9 12೥9݄21೔༵ۚ೔
41. 41.

    yield module Foo def self.foo(*args) yield *args end def self.bar(*args)

    end end expect {|blk| Foo.foo(1, &blk) }.to yield_control expect {|blk| Foo.bar(1, &blk) }.not_to yield_control 12೥9݄21೔༵ۚ೔
42. 42.

    yield with args module Foo def self.foo(*args) yield *args end

    def self.bar(*args) end def self.baz(*args) yield end end expect {|blk| Foo.foo(1, &blk) }.to yield_with_args expect {|blk| Foo.bar(1, &blk) }.not_to yield_with_args expect {|blk| Foo.baz(1, &blk) }.not_to yield_with_args 12೥9݄21೔༵ۚ೔
43. 43.

    yield with args module Foo def self.foo(*args) yield *args end

    def self.bar(*args) end def self.baz(*args) yield end end expect {|blk| Foo.foo(‘abc’, ‘xyz’, &blk) }.to yield_with_args(‘abc’, ‘xyz’) expect {|blk| Foo.foo(‘abc’, ‘xyz’, &blk) }.to yield_with_args(/bc/, /xy/) Use == or === to compare arguments 12೥9݄21೔༵ۚ೔
44. 44.

    yield with no args module Foo def self.foo(*args) yield *args

    end def self.bar(*args) end def self.baz(*args) yield end end expect {|blk| Foo.foo(‘abc’, ‘xyz’, &blk) }.not_to yield_with_no_args expect {|blk| Foo.bar(‘abc’, ‘xyz’, &blk) }.not_to yield_with_no_args expect {|blk| Foo.baz(‘abc’, ‘xyz’, &blk) }.to yield_with_no_args 12೥9݄21೔༵ۚ೔
45. 45.

    yield successive args expect {|blk| [1, 2, 3].each(&blk) }.to yield_successive_args(1,

    2, 3) expect {|blk| [1, 2, 3].each(&blk) }.to yield_successive_args(Fixnum, Fixnum, Fixnum) expect {|blk| {:a => 1, :b => 2}.each(&blk) }.to yield_successive_args([:a, 1], [:b, 2]) expect {|blk| {:a => 1, :b => 2}.each(&blk) }.to yield_successive_args( lambda {|x| x.last == 1 }, lambda {|x| x.last == 2 } ) Use == or === to compare arguments 12೥9݄21೔༵ۚ೔
46. 46.

    Custom matcher RSpec::Matchers.define :be_a_multiple_of do |expected| match do |actual| actual

    % expected == 0 end failure_message_for_should do |actual| “expected that #{actual} would be a multiple of #{expected}” end failure_message_for_should_not do |actual| “expected that #{actual} wouldn’t be a multiple of #{expected}” end description do “be multiple of #{expected}” # used for auto-generated description end end 12೥9݄21೔༵ۚ೔
47. 47.

    Custom matcher describe 9 do it { should be_a_multiple_of(3) }

    # pass end describe 9 do it { should_not be_a_multiple_of(4) } # pass end describe 9 do it { should be_a_multiple_of(4) } #=> “expected that 9 would be a multiple of 4” end describe 9 do it { should_not be_a_multiple_of(3) } #=> “expected that 9 wouldn’t be a multiple of 3” end 12೥9݄21೔༵ۚ೔
48. 48.

    References • https://www.relishapp.com/rspec/rspec-core/ v/2-11/docs • https://www.relishapp.com/rspec/rspec- expectations/v/2-11/docs • https://www.relishapp.com/rspec/rspec- mocks/v/2-11/docs

    • https://www.relishapp.com/rspec/rspec-rails/ v/2-11/docs 12೥9݄21೔༵ۚ೔