2011-09-02 17:23:43 +00:00
# factory_girl [![Build Status](https://secure.travis-ci.org/thoughtbot/factory_girl.png)](http://travis-ci.org/thoughtbot/factory_girl?branch=master)
2011-01-19 16:21:20 +00:00
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
2011-02-07 22:52:28 +00:00
[factory_girl_rails ](http://github.com/thoughtbot/factory_girl_rails ).
2011-02-07 22:48:29 +00:00
Documentation
-------------
You should find the documentation for your version of factory_girl on [Rubygems ](http://rubygems.org/gems/factory_girl ).
2011-12-22 03:34:32 +00:00
See [GETTING_STARTED ](https://github.com/thoughtbot/factory_girl/blob/master/GETTING_STARTED.md ) for information on defining and using factories.
2011-01-19 16:21:20 +00:00
2011-07-05 12:17:41 +00:00
Install
2011-01-19 16:21:20 +00:00
--------
2011-07-05 17:18:15 +00:00
```shell
2011-07-05 12:17:41 +00:00
gem install factory_girl
```
or add the following line to Gemfile:
2011-07-16 21:26:30 +00:00
2011-07-05 12:17:41 +00:00
```ruby
gem 'factory_girl'
```
2011-07-05 17:18:15 +00:00
and run `bundle install` from your shell.
2011-01-19 16:21:20 +00:00
More Information
----------------
2011-02-07 22:48:29 +00:00
* [Rubygems ](http://rubygems.org/gems/factory_girl )
2011-01-19 16:21:20 +00:00
* [Mailing list ](http://groups.google.com/group/factory_girl )
* [Issues ](http://github.com/thoughtbot/factory_girl/issues )
* [GIANT ROBOTS SMASHING INTO OTHER GIANT ROBOTS ](http://giantrobots.thoughtbot.com )
Contributing
------------
2011-06-29 14:46:28 +00:00
Please see the [contribution guidelines ](http://github.com/thoughtbot/factory_girl/blob/master/CONTRIBUTION_GUIDELINES.md ).
2011-01-19 16:21:20 +00:00
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
2011-09-02 17:24:39 +00:00
* Josh Clayton
* Thomas Walpole
2011-01-19 16:21:20 +00:00
The syntax layers are derived from software written by the following authors:
* Pete Yandell
* Rick Bradley
* Yossef Mendelssohn
![thoughtbot ](http://thoughtbot.com/images/tm/logo.png )
factory_girl is maintained and funded by [thoughtbot, inc ](http://thoughtbot.com/community )
The names and logos for thoughtbot are trademarks of thoughtbot, inc.
License
-------
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.