Textmate Bundle for Cucumber

This is a fork of the rspec-story-tmbundle. The goal is to keep the same functionality that the original bundle had but make it compatible with Cucumber and also take advantage of the benefits that Cucumber offers.

So far the basic file switching and syntax highlighting is working. You can also run a feature. (See below.) File creation and more advanced step generation commands have not yet been ported fully. Feel free to help out. :)

If you are doing ruby development with webrat you may also want the webrat bundle.

Bundle Features:

• Color highlighting for plain text features (supports all the languages that Cucumber does)
• Snippets for plain text features and step files.
• Predefined completions (escape key) for common feature keywords.
• Spellchecking turned on by default for the plain text features.
• Switch between plain text feature and corresponding step matcher file.
• Run a feature with HTML output.
• Run a single scenario with HTML output.

TODO:

• Add a Goto Step command
• Automatically create template step file with pending steps based on the steps used in the feature.
  • Use Cucumber’s built in functionality to do this and clean out the story bundle’s way.
• Tidy up HTML output and add a Textmate formatter with a clickable backtrace.
• Snippets for tables.
• Multi-language support for the snippets?

Installation

mkdir -p ~/Library/Application\ Support/TextMate/Bundles/
cd ~/Library/Application\ Support/TextMate/Bundles
git clone git://github.com/bmabey/cucumber-tmbundle.git Cucumber.tmbundle

• In TextMate: From your drop down menu, select Bundles -> Bundle Editor -> Reload Bundles.
• To install the color themes for the syntax highlighting:
  • Click on the themes found in the color_themes dir by clicking on them in Finder.

Migrating from RSpec Story Runner Bundle

To avoid file detection collisions with the RSpec Story bundle I would suggest you turn it off when using the Cucumber bundle and vice-versa. You can do this by clicking on the ‘Filter List’ button in the Bundle Editor section of Textmate. (Warning: Switching to the Cucumber color themes will clobber the Story runner color themes when you reinstall the theme.)

Updating

Update your bundle by running the “Update Cucumber Bundle” command. (Thanks to Tim Harper for this.)

Running Features

The bundle uses the ‘cucumber’ command by default to run the features. If you have a “script/cucumber” located in youre project (i.e. you’re using cucumber as a rails plugin) it will use that local version instead. You may override the default running options a number of ways. To change them globally you can set a TM_CUCUMBER_OPTS variable in textmate.

# profile watir  

# rake features:watir

Switching Between Features and Step files

     Basic features (no sub-directories):
       /project_root/features
              |- basic_feature.feature (extension must be .feature)
              |- support
                 |- env.rb
              |- step_definitions
                  |- basic_feature_steps.rb
     Using feature sub-directories:
       /project_root/features
             |- feature_one
             |   |- some_feature.feature
             |   |- step_definitions
             |       |- some_feature_steps.rb
             |
             |- feature_two
             | .....

These directory structures can be used together (basic features can reside in the root features directory, and feature sets can be put in sub directories).

Credits

• Ben Mabey – Author/Main contributor
• John Thornton – Author/Main contributor
• Andre Foeken – Original color syntax highlighting
• Tim Harper – Update Bundle Command, file detection bug fixes
• Aslak Hellesøy – Rake task improvement, snippet updates, Cucumber!
• Dr. Nic – Snippet and grammar updates, updated ‘Run Focused Scenario’ command
• Pedro Visintin – Syntax fix