boram/factory_girl

Fixture replacement for focused and readable tests.

factory_girl

factory_girl is a fixtures replacement with a straightforward definition syntax, support for multiple build strategies (saved instances, unsaved instances, attribute hashes, and stubbed objects), and support for multiple factories for the same class (user, admin_user, and so on), including factory inheritance.

If you want to use factory_girl with Rails, see factory_girl_rails.

Documentation

You should find the documentation for your version of factory_girl on Rubygems.

See GETTING_STARTED for information on defining and using factories.

Install

gem install factory_girl

or add the following line to Gemfile:

gem 'factory_girl'

and run bundle install from your shell.

Supported Ruby versions

The FactoryGirl 3.x+ series supports MRI Ruby 1.9. Additionally, FactoryGirl 3.6+ supports JRuby 1.6.7.2+ while running in 1.9 mode. See GETTING_STARTED for more information on configuring the JRuby environment.

For versions of Ruby prior to 1.9, please use FactoryGirl 2.x.

More Information

• Rubygems
• Mailing list
• Issues
• GIANT ROBOTS SMASHING INTO OTHER GIANT ROBOTS

Contributing

Please see the contribution guidelines.

Credits

factory_girl was written by Joe Ferris with contributions from several authors, including:

• Alex Sharp
• Eugene Bolshakov
• Jon Yurek
• Josh Nichols
• Josh Owens
• Nate Sutton
• Josh Clayton
• Thomas Walpole

factory_girl is maintained and funded by thoughtbot, inc

The names and logos for thoughtbot are trademarks of thoughtbot, inc.

License

factory_girl is Copyright © 2008-2012 Joe Ferris and thoughtbot. It is free software, and may be redistributed under the terms specified in the LICENSE file.