Setting up

Let's go ahead and create an application. We will be using Sinatra as a framework for our application. That means that we will be using Ruby as a programming language. You can read more about Sinatra here

There are several ways to create a new Sinatra application but we will make use of a script that creates an app for us AND configures it (at least partially) for use with Cucumber and another testing framework called RSpec.

Open your Gemfile and add the following lines:

# Gemfile

gem 'sinatra'
gem 'cucumber-sinatra'

Then run bundle install to install the new gem we just added.

after the installation is complete, run:

$ cucumber-sinatra init --app WorkshopApp application.rb

If prompted with what actions the generator should take:

Generating with init generator:

  [CONFLICT]  features/support/env.rb

1. skip
2. overwrite
3. render
4. diff
5. abort

Go ahead and choose 2. overwrite

There will be a lot of new files created and we will go over all of them in a while. For now, I want you to open up your Gemfile again and add:

# Gemfile

gem 'capybara'
gem 'rspec'

Run bundle install to install new gem then run cucumber again.

The first step (in both scenarios) is passing. That is a really good sign!

2 scenarios (2 undefined)
14 steps (5 skipped, 7 undefined, 2 passed)
0m0.045s

Before we move to the next step we need to re-arrange a few things:

1. Create a lib folder

   $ mkdir lib

2. Move application.rb to the newly created lib folder

   $ mv application.rb lib

3. Update path to application.rb in features/support/env.rb

   Open the file with your text editor. At the top of that file you'll should see the following line

   # features/support/env.rb
   
   # locate:
   require File.join(File.dirname(__FILE__), '..', '..', 'application.rb')
   
   # change it to look like the following:
   require File.join(File.dirname(__FILE__), '..', '..', 'lib/application.rb')

4. Run cucumber again to make sure the 2 steps from earlier on are still passing :-)

Great! That's all for now. Let's move to the next step where we'll get a few more steps in our scenarios to pass.