Skip to content
This repository
Newer
Older
100644 63 lines (35 sloc) 2.133 kb
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
1 # Cucumber-Rails
2
ddfb7ebe » aslakhellesoy
2011-09-25 Point travis staus to our own
3 [![Build Status](https://secure.travis-ci.org/cucumber/cucumber-rails.png)](http://travis-ci.org/cucumber/cucumber-rails)
f949d91b » chaffeqa
2011-09-22 added travis-ci integration and image in README
4
cf6b2eb0 » aslakhellesoy
2011-08-03 Added a note about Rails 2.x support, linking to the old instructions…
5 Cucumber-Rails brings Cucumber to Rails 3.x. For Rails 2x support, see the [Cucumber Wiki](https://github.com/cucumber/cucumber/wiki/Ruby-on-Rails).
6
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
7 ## Installation
8
9 Before you can use the generator, add the gem to your project's Gemfile as follows:
10
11 group :test do
0a8c86e9 » rdlugosz
2012-04-22 Fix #202 - warning msg should include require: false
12 gem 'cucumber-rails', :require => false
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
13 # database_cleaner is not required, but highly recommended
14 gem 'database_cleaner'
15 end
16
17 Then install it by running:
18
19 bundle install
20
21 Learn about the various options:
22
6f4ae14c » albertoleal
2011-05-11 Fixed some commands on README.md file.
23 rails generate cucumber:install --help
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
24
25 Finally, bootstrap your Rails app, for example:
26
27 rails generate cucumber:install
28
29 ## Running Cucumber
30
31 With Rake:
32
33 rake cucumber
34
35 Without Rake:
36
37 [bundle exec] cucumber
38
708d2967 » aslakhellesoy
2011-06-03 Edited README.md via GitHub
39 ## Bugs and feature requests
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
40
2e3161a7 » aslakhellesoy
2011-06-03 Edited README.md via GitHub
41 The *only* way to have a bug fixed or a new feature accepted is to describe it with a Cucumber feature. Let's say you think you have found a bug in the cucumber:install generator. Fork this project, clone it to your workstation and check out a branch with a descriptive name:
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
42
708d2967 » aslakhellesoy
2011-06-03 Edited README.md via GitHub
43 git clone git@github.com:you/cucumber-rails.git
44 git checkout -b bug-install-generator
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
45
708d2967 » aslakhellesoy
2011-06-03 Edited README.md via GitHub
46 Start by making sure you can run the existing features. Now, create a feature that demonstrates what's wrong. See the existing features for examples. When you have a failing feature that reproduces the bug, commit, push and send a pull request. Someone from the Cucumber-Rails team will review it and hopefully create a fix.
47
48 If you know how to fix the bug yourself, make a second commit (after committing the failing feature) before you send the pull request.
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
49
50 ### Setting up your environment
51
6167d941 » aslakhellesoy
2011-11-03 recommend ruby 1.9.3
52 I strongly recommend rvm and ruby 1.9.3. When you have that, cd into your cucumber-rails repository and:
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
53
b33eadfc » aslakhellesoy
2011-06-03 Edited README.md via GitHub
54 gem install bundler
55 bundle install
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
56
57 ### Running all features
58
b33eadfc » aslakhellesoy
2011-06-03 Edited README.md via GitHub
59 With all dependencies installed, all features should pass:
60
61 rake cucumber
ea033b20 » aslakhellesoy
2011-05-09 Remove support for Rails2
62
63 One of the features uses MongoDB, which needs to be running in order to make features/mongoid.feature to pass.
Something went wrong with that request. Please try again.