Rails generators which produce tests using shoulda instead of straight up Test::Unit. Other goodies as well.
Pull request Compare This branch is 7 commits ahead of technicalpickles:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Shoulda generators

One night at a Boston Ruby hackfest, I finally got sick of using the Rails default generators, and then having to twiddle them to meet my needs and tastes. This includes using things like:

The next morning, I was struck awake at 5am with the inspiration to start implementing it. shoulda_generator is the result of this effort.

What you get


  • A new model
  • A migration for the model
    • Skip using --skip-migration
  • A factory defined with factory_girl
    • Skip using --skip-factory
  • A shoulda unit test with a few simple 'should's



  • Everything included in shoulda_model
  • A controller (sans unnecessary comments)
  • Choice of haml (default) or ERB
    • Specify which with the --templating option
  • Simple layout styled with blueprint
    • Skip using --skip-layout
  • A helper
  • A shoulda functional test using factory_girl factory, using should_be_restful or not
    • Specify with --functional-test-style, accepts basic and should_be_restful


  • shoulda installed as a plugin
  • factory_girl gem installed
  • haml gem installed on the system, and the project has been hamlified using haml --rails

Getting it

shoulda_generator is available as a gem via GitHub. If you haven't done so already, you need to setup GitHub as a gem source:

$ gem sources -a http://gems.github.com

Now you can install it:

$ sudo gem install technicalpickles-shoulda_generator

Example usage

Usage is the same as the default Rails generators.

$ script/generate shoulda_model post title:string body:text published:boolean
$ script/generate shoulda_scaffold post title:string body:text published:boolean

Configuring it

You can override the default values for templating by placing a .shoulda_generator file in your home directory.

Here's an example .shoulda_generator:

:templating: erb              # supported options: haml|erb

Developing it

Source is hosted on GitHub: http://github.com/technicalpickles/shoulda_generator/tree/master

You can do the usual fork/commit cycle until you have something ready to share. Send pull requests my way.