RubyDoc.info: File: README – Documentation for cucumberator (0.0.8)

Cucumberator is Cucumber extension to write steps in command line, whatch how browser responds to them and save directly to your .feature file.

How to use

Put @cucumberize tag in front of empty Scenario you want to append with new steps.
Or place step "Then I will write new steps" anywhere in scenario [PREFERRED]
Fire up the cucumber and wait until prompt shows up.
Write a step, watch it happen on the browser!

All steps are automatically saved into .feature file unless it's unsuccessful. If you're unhappy with the last step, type "undo". See all commands with "help".

If you have Continuous Integration, do not forget to remove cucumberator tag/step before pushing! ;-)

Available commands

When you're in cucumberator prompt, the following commands are available:

save - force-saves last step into current feature file
last-step - display last executed step (to be saved on 'save' command)
undo - remove last saved line from feature file
next - execute next step and stop
steps - display available steps
where - display current location in file
exit - exits current scenario
exit-all - exists whole Cucumber feature
help - displays all available commands

Installation

If you use bundler (and you should), add to your Gemfile

gem "cucumberator", :require => false

Otherwise, install with

gem install cucumberator

Then require it in one of your ruby files under features/support (e.g. env.rb)

require 'cucumberator'

Now use special step in any place:

# ...some steps...
Then I will write new steps
# ...can be the end or other steps...

or put @cucumberize before last empty Scenario you want to fill up, for example

@javascript @cucumberize
Scenario: check fancy ajax login

and then run this feature file, watch your console for prompt to show up. Enjoy writing steps on the go!

Compability

Latest cucumberator version supports:

Ruby >= 1.9
Cucumber >= 1.3

TODO

tests
refactor Cucumberator::Writer - too fat already

Suggestions?