流暢なインターフェースでマッチャーを定義する

chain メソッドを使用して、流暢なインターフェースでマッチャーを定義します。

引数を持つチェーンメソッド

次の内容で "between_spec.rb" という名前のファイルがあるとします:

RSpec::Matchers.define :be_bigger_than do |first|
  match do |actual|
    (actual > first) && (actual < @second)
  end

  chain :and_smaller_than do |second|
    @second = second
  end
end

RSpec.describe 5 do
  it { is_expected.to be_bigger_than(4).and_smaller_than(6) }
end

rspec between_spec.rb --format documentation を実行すると、

出力に "1 example, 0 failures" が含まれることを確認します。

また、出力に "is expected to be bigger than 4" が含まれることを確認します。

チェーンセッター

次の内容で "between_spec.rb" という名前のファイルがあるとします:

RSpec::Matchers.define :be_bigger_than do |first|
  match do |actual|
    (actual > first) && (actual < second)
  end

  chain :and_smaller_than, :second
end

RSpec.describe 5 do
  it { is_expected.to be_bigger_than(4).and_smaller_than(6) }
end

rspec between_spec.rb --format documentation を実行すると、

出力に "1 example, 0 failures" が含まれることを確認します。

また、出力に "is expected to be bigger than 4" が含まれることを確認します。

include_chain_clauses_in_custom_matcher_descriptions を true に設定し、引数を持つチェーンメソッド

次の内容で "between_spec.rb" という名前のファイルがあるとします:

RSpec.configure do |config|
  config.expect_with :rspec do |c|
    c.include_chain_clauses_in_custom_matcher_descriptions = true
  end
end

RSpec::Matchers.define :be_bigger_than do |first|
  match do |actual|
    (actual > first) && (actual < @second)
  end

  chain :and_smaller_than do |second|
    @second = second
  end
end

RSpec.describe 5 do
  it { is_expected.to be_bigger_than(4).and_smaller_than(6) }
end

rspec between_spec.rb --format documentation を実行すると、

出力に "1 example, 0 failures" が含まれることを確認します。

また、出力に "is expected to be bigger than 4 and smaller than 6" が含まれることを確認します。