factory_girl Build Status Dependency Status

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 3, see factory_girl_rails.


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

See GETTING_STARTED for information on defining and using factories.


gem install factory_girl

or add the following line to Gemfile:

gem 'factory_girl'

and run bundle install from your shell.

More Information


Please see the contribution guidelines.


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

The syntax layers are derived from software written by the following authors:

  • Pete Yandell
  • Rick Bradley
  • Yossef Mendelssohn


factory_girl is maintained and funded by thoughtbot, inc

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


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