Monthly Downloads: 168
Programming language: Ruby
License: Apache License 2.0
Tags: Testing     Frameworks     RSpec     Extra    
Latest version: v0.2.0

rspec-tabular alternatives and similar gems

Based on the "RSpec" category.
Alternatively, view rspec-tabular alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of rspec-tabular or a related project?

Add another 'RSpec' Gem



Gem Version Build Status Code Climate Test Coverage [License](LICENSE)

Inline docs RubyDoc

Rspec extension for writing tabular examples


Add this line to your application's Gemfile:

gem 'rspec-tabular'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rspec-tabular


Here is an overall example using the rspec, followed by some more details of the specified scenarios:

The input values which are specified are exposed as let values, so they can be used in both the subject inputs or in stub/double expectations specified in a before block.

describe '#thing' do
  subject { subject.thing(input1, input2) }
  before ( stub_model(ThingyModel, name: input3) }

  let(:expected_value) { :expected_value }

  inputs            :input1,  :input2,  :input3
  it_with           'value1', 'value2', 'value3',  nil
  it_with           'value4', 'value5', 'value6',  true
  it_with           'value7', 'value8', 'value9',  'foobar'
  specify_with      'value1', 'value2', 'value3',  'foobar'
  it_with(          'value1', 'value2', 'value3' ) { is_expected.to eq(expected_value) }
  specify_with(     'value1', 'value2', 'value3' ) { expect(subject).to eq(expected_value) }

  its_with :method, 'value1', 'value2', 'value3',  'something'

  raise_error_with  'bad1',   'bad2',   'bad3',    'error'
  raise_error_with  'bad4',   'bad5',   'bad6',    TestException
  raise_error_with  'bad4',   'bad5',   'bad6',    TestException, 'error'

  side_effects_with 'value4', 'value5', 'value6'

specify_with is an alias to it_with, therefore they both have the same behaviour.

Please remember inputs or expected result values MUST be literal values, and cannot be values memoized with let, because the let values are not evaluated soon enough. You can use let values in the expectations if they are specified in a block. (e.g., { is_expected.to eq(expected_value) })


Each of the tabular statements has an equivlanet non-tabular example to which is corresponds.

it_with           'value1', 'value2', 'value3', nil

# Equivalent to:
context do
  let(:input1) { 'value1' }
  let(:input2) { 'value2' }
  let(:input3) { 'value3' }

  it { expected.to be_nil }
it_with(          'value1', 'value2', 'value3' ) { is_expected.to eq(expected_value) }

# Equivalent to:
context do
  let(:input1) { 'value1' }
  let(:input2) { 'value2' }
  let(:input3) { 'value3' }

  it { is_expected.to eq('expected') } }
raise_error_with  'bad4',   'bad5',   'bad6',    TestException, 'error'

# Equivalent to:
context do
  let(:input1) { 'bad4' }
  let(:input2) { 'bad5' }
  let(:input3) { 'bad6' }

  specify { expect { subject }.to raise_error(TestException, 'error') }
side_effects_with 'value4', 'value5', 'value6'

# Equivalent to:
context do
  let(:input1) { 'value4' }
  let(:input2) { 'value5' }
  let(:input3) { 'value6' }

  specify { subject } }


After checking out the repo, run bin/setup to install dependencies. Then, run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release to create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Elsewhere on the web

Links to other places on the web where this projects exists:


See [CONTRIBUTING](CONTRIBUTING.md) for how you can contribute changes back into this project.


Copyright 2019 SugarCRM Inc., released under the Apache2 License.

*Note that all licence references and agreements mentioned in the rspec-tabular README section above are relevant to that project's source code only.