NDD RSpec Rails¶ ↑
RSpec utilities for Rails.
The API documentation can be find at RubyDoc.
Installation¶ ↑
Add this line to your application's Gemfile:
gem 'ndd-rspec-rails'
And then execute bundle
Or install it yourself with gem install ndd-rspec-rails
Usage¶ ↑
Prerequisites¶ ↑
This gem requires:
-
activesupport >= 4.0
-
rspec >= 3.0
And is tested with:
-
Ruby 2.4
-
Ruby 2.3
-
Ruby 2.2
Controller matchers¶ ↑
-
have_a_translated_flash
: ensure that a flash message has an associated translation (documentation);
Model matchers¶ ↑
-
have_a_translated_attribute
: ensure that a model has an associated translation (documentation); -
have_a_translated_error
: ensure that an error on a model or an attribute has an associated translation (documentation); -
have_a_translated_model
: ensure that an attribute has an associated translation (documentation);
Development¶ ↑
Prerequisites¶ ↑
In order to extensively test this library with all the supported versions of Ruby and RSpec, you will need to manage:
-
several Ruby environments using RVM
-
several gems sets using Appraisal
-
several test execution environments (Ruby and gems) using WWTD
Setup¶ ↑
After installing RVM, check out the repository and run bin/setup
to setup all the environments. This script will:
-
create the latest Ruby environment with RVM and an associated gems set using the
.ruby-version
and.ruby-gemset
files:
rvm use gem install bundler --no-rdoc --no-ri bundle install
-
install all the required Ruby versions listed in
.travis.yml
. For example:
export LOCAL_RUBY_VERSION=2.2.7 \ && rvm install ruby-$LOCAL_RUBY_VERSION \ && rvm use ruby-$LOCAL_RUBY_VERSION \ && gem install bundler --no-rdoc --no-ri export LOCAL_RUBY_VERSION=2.3.4 \ && rvm install ruby-$LOCAL_RUBY_VERSION \ && rvm use ruby-$LOCAL_RUBY_VERSION \ && gem install bundler --no-rdoc --no-ri export LOCAL_RUBY_VERSION=2.4.1 \ && rvm install ruby-$LOCAL_RUBY_VERSION \ && rvm use ruby-$LOCAL_RUBY_VERSION \ && gem install bundler --no-rdoc --no-ri
-
create a
Gemfile.lock
for each set of the dependencies:
appraisal install
-
install all the dependencies in their associated environment:
wwtd --only-bundle
At last, to test this library in all the supported environments, just run:
wwtd --parallel
Release¶ ↑
As a reminder…
-
update all dependencies in all the environments:
bundle update appraisal update wwtd --only-bundle
-
run the tests in all the environments with
wwtd --parallel
-
update the changelog
-
update the library version
-
release with
bundle exec rake release
Contributing¶ ↑
Bug reports and pull requests are welcome on GitHub at github.com/ddidier/ndd-rspec-rails. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
License¶ ↑
The gem is available as open source under the terms of the MIT License.