Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Create records from Cucumber features without writing step definitions.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .ruby-version
Octocat-spinner-32 MIT-LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 Rakefile
Octocat-spinner-32 cucumber_factory.gemspec
README.rdoc

Cucumber Factory - create ActiveRecord objects without step definitions

Cucumber Factory allows you to create ActiveRecord objects directly from your Cucumber features. No step definitions required.

Examples

The following will call Movie.make, Factory.create(:movie), Movie.create! or Movie.new, depending on what's available:

Given there is a movie

To create a new record with attributes set, you can say:

Given there is a movie with the title "Sunshine" and the year "2007"

Boolean attributes can be set by appending “which”, “that” or “who” at the end:

Given there is a movie which is awesome
And there is a movie with the name "Sunshine" that is not a comedy
And there is a director who is popular

Instead of “and” you can also use “but” and commas to join sentences:

Given there is a movie which is awesome, popular and successful but not science fiction
And there is a director with the income "500000" but with the account balance "-30000"

Setting associations

You can set belongs_to associations by referring to the last created record of a kind by saying “above”:

Given there is a movie with the title "Before Sunrise"
And there is a movie with the prequel above

The example above also shows how to set has_many associations - you simply set the belongs_to association on the other side.

You can also set associations by referring to any string attribute used previously:

Given there is a movie with the title "Before Sunrise"
And there is a movie with the title "Limitless"
And there is a movie with the prequel "Before Sunrise"

You can also explicitly give a record a name and use it to set a belongs_to association below:

Given "Before Sunrise" is a movie
And there is a movie with the title "Limitless"
And there is a movie with the prequel "Before Sunrise"

Note that in the example above, “Before Sunrise” is only a name you can use to refer to the record. The name is not actually used for the movie title, or any other attribute value.

Fixture factory support

Machinist blueprints and factory_girl factories will be used when available.

You can use named Machinist blueprint such as Movie.blueprint(:comedy) like this:

Given there is a movie (comedy) with the title "Groundhog Day"

Overriding factory steps

If you want to override a factory step with your own version, just do so:

Given /^there is a movie with good actors$/ do
  movie = Movie.make
  movie.actors << Actor.make(:name => 'Clive Owen')
  movie.actors << Actor.make(:name => 'Denzel Washington')
end

Custom steps will always be preferred over factory steps. Also Cucumber will not raise a warning about ambiguous steps if the only other matching step is a factory step.

Installation and setup

Cucumber Factory is a gem, which you can install with

sudo gem install cucumber_factory

In Rails 2, add the following to your environment.rb:

config.gem 'cucumber_factory'

In Rails 3, add the following to your Gemfile:

gem 'cucumber_factory'

Finally, create a file features/step_definitions/factory_steps.rb, which just says

Cucumber::Factory.add_steps(self)

Rails 3 compatibility

We cannot guarantee Rails 3 compatibility at this point, but we will upgrade the gem when Rails 3 is released.

Credits

Henning Koch

makandra.com

gem-session.com

Something went wrong with that request. Please try again.