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.
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:
bundle install from your shell.
Supported Ruby versions
The FactoryGirl 3.x+ series supports MRI Ruby 1.9. Additionally, FactoryGirl 3.6+ supports JRuby 188.8.131.52+ 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.
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.