Rspec::Parameterized::Context

Generate interfaces like RSpec::Parameterized to support parameterized testing that is evaluated in transaction.

Support Ruby 2.5 and later.

Installation

Add this line to your application's Gemfile:

gem 'rspec-parameterized-context'

Then add this lines to files under spec/support/

RSpec.configure do |config|
  config.extend RSpecParameterizedContext
end

Usage

Syntax

Provide interfaces like RSpec::Parameterized.

Pass where and with_them to parameterized method as one block and specify parameterized count as size keyword argument.

describe "Addition" do
  parameterized do
    where(:a, :b, :answer, size: 3) do
      [
        [1 , 2 , 3],
        [5 , 8 , 13],
        [0 , 0 , 0]
      ]
    end

    with_them do
      it do
        expect(a + b).to eq answer
      end
    end
  end
end

Feature

• rspec-parameterized-context supports to evaluate block that given where method in transaction.

# Assume today is 2020/9/9
describe 'Evaluting block that given to where in transaction' do
  let(:now) { Date.new(2020, 1, 1) }
  # And travel to 2020/1/1
  before { travel_to(now) }

  parameterized do
    where(:current_on, size: 1) do
      [
        [Date.current],
      ]
    end

    with_them do
      it do
        # current_on is evaluated as 2020/1/1
        expect(current_on).to eq now
      end
    end
  end
end

• You can run specific context by focus_index parameter

describe "Addition" do
  parameterized do
    where(:a, :b, :answer, size: 3, focus_index: 1) do
      [
        [1 , 2 , 3],
        [5 , 8 , 13], # will run only this context
        [0 , 0 , 0]
      ]
    end

    with_them do
      it do
        expect(a + b).to eq answer
      end
    end
  end
end

Contributing

• Fork the project.
• Create feature branch.
• Commit and push.
• Make sure to add tests for it.
• Create pull request.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Rspec::Parameterized::Context project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.