Popularity
1.0
Stable
Activity
2.4
-
1
14
0

Monthly Downloads: 38
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

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

Add another 'RSpec' Gem

README

Rspec::Tabular

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

Inline docs RubyDoc

Rspec extension for writing tabular examples

Installation

Add this line to your application's Gemfile:

gem 'rspec-tabular'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rspec-tabular

Usage

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) })

Equivalencies

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 }
end
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') } }
end
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') }
end
side_effects_with 'value4', 'value5', 'value6'

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

  specify { subject } }
end

Development

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:

Contributing

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

License

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.