Rails%203%20In%20Action

84 CHAPTER 4 Oh CRUD!
4.1.1 Writing a feature
Create a new file in the features directory called viewing_projects.feature, shown in the
following listing.
Listing 4.1 features/viewing_projects.feature
Feature: Viewing projects
In order to assign tickets to a project
As a user
I want to be able to see a list of available projects
Scenario: Listing all projects
Given there is a project called "TextMate 2"
And I am on the homepage
When I follow "TextMate 2"
Then I should be on the project page for "TextMate 2"
If you run rake cucumber:ok here, all the features will run. Instead, you want to run
just the feature you’re working on because you don’t want the other feature to be
altered by what you do here. When you’re done, you’ll run rake cucumber:ok to
ensure that everything is still working.
To run just this one feature, use the bin/cucumber executable, which was added to
your project when you ran bundle install --binstubs. If you didn’t use the
--binstubs option, you would have to use bin/cucumber instead, and typing all of
that gets a bit boring after a while.
Now, to run this single feature, you run the following command:
bin/cucumber features/viewing_projects.feature
You should always use bin/cucumber rather than straight cucumber to run the bundled
version of your gems because you could be using different versions of the same
gem across separate projects. By running the bin/cucumber command, you ensure
that you’re loading the version of the gem specified by your bundle rather than the
system version of that gem.
The first line of the only scenario in the feature fails, all because you haven’t
defined the “there is a project” step yet, as Cucumber informs you in the output:
3 scenarios (1 undefined, 2 passed)
15 steps (3 skipped, 1 undefined, 11 passed)
You can implement step definitions for
undefined steps with these snippets:
Given /^there is a project called "([^"]*)"$/ do |arg1|
pending # express the regexp above with the code you wish you had
end
As you can see in the step output, you’ve got one undefined step. Underneath that,
Cucumber very handily gives you a step definition you can use to define this step. In this
step, you need to create a new Project object. Rather than doing it manually by calling
Project.create everywhere you need it, you can set up a little thing called factories.