README

Prerequisites

• Ruby: 2.4.0p0
• Rails: 5.1.4
• PostgreSQL: 9.3

Prepared Rails for BDD

Skip unit test, bundle and used PostgreSQL

rails new rails-bdd -T --skip-test-unit, -B --skip-bundle, -d postgresql

Install gem locally

bundle install --path vendor/bundle

Add Rspec Rails gem to Gemfile

group :development, :test do
  gem 'rspec-rails'
end

Install Rspec Rails gem

bundle

Bootstrap the application with RSpec

bundle exec rails generate rspec:install

Add Shoulda Matchers gem to Gemfile

group :test do
  gem 'shoulda-matchers'
end

Configure Shoulda Matchers gem

Add the following block to the end of spec/rails_helper.rb

Shoulda::Matchers.configure do |config|
  config.integrate do |with|
    with.test_framework :rspec
    with.library :rails
  end
end

Added Cucumber gem

group :test do
  gem 'shoulda-matchers'
  gem 'cucumber-rails', require: false
  gem 'database_cleaner'
end

Install Cucumber gem

bundle

Bootstrap the application with Cucumber

rails generate cucumber:install

Testing

Running all test (RSpec and Cucumber)

bundle exec rake ci:tests

RSpec

Single test

rspec spec/models/post_spec.rb

All test

rspec

Cucumber

Single test

cucumber features/home_page.feature

All test

cucumber

• Ruby version

• System dependencies

• Configuration

• Database creation

• Database initialization

• How to run the test suite

• Services (job queues, cache servers, search engines, etc.)

• Deployment instructions

• ...