2016-02-01 22:20:37 +00:00
# factory_girl [](http://travis-ci.org/thoughtbot/factory_girl?branch=master) [](https://gemnasium.com/thoughtbot/factory_girl) [](https://codeclimate.com/github/thoughtbot/factory_girl)
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.
2012-03-09 20:52:29 +00:00
If you want to use factory_girl with Rails, see
2012-01-12 20:23:33 +00:00
[factory_girl_rails ](https://github.com/thoughtbot/factory_girl_rails ).
2011-02-07 22:48:29 +00:00
Documentation
-------------
2012-01-12 20:23:33 +00:00
You should find the documentation for your version of factory_girl on [Rubygems ](https://rubygems.org/gems/factory_girl ).
2011-02-07 22:48:29 +00:00
2014-05-30 17:53:05 +00:00
See [GETTING_STARTED] 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
2012-03-23 21:14:13 +00:00
Supported Ruby versions
-----------------------
2014-01-24 17:02:17 +00:00
The factory_girl 3.x+ series supports MRI Ruby 1.9. Additionally, factory_girl
2014-05-30 17:53:05 +00:00
3.6+ supports JRuby 1.6.7.2+ while running in 1.9 mode. See [GETTING_STARTED]
2012-08-02 13:19:51 +00:00
for more information on configuring the JRuby environment.
2012-03-23 21:14:13 +00:00
2014-01-24 17:02:17 +00:00
For versions of Ruby prior to 1.9, please use factory_girl 2.x.
2012-03-23 21:14:13 +00:00
2011-01-19 16:21:20 +00:00
More Information
----------------
2012-01-12 20:23:33 +00:00
* [Rubygems ](https://rubygems.org/gems/factory_girl )
2013-12-19 15:11:25 +00:00
* [Stack Overflow ](http://stackoverflow.com/questions/tagged/factory-girl )
2012-01-12 20:23:33 +00:00
* [Issues ](https://github.com/thoughtbot/factory_girl/issues )
2012-01-12 20:24:14 +00:00
* [GIANT ROBOTS SMASHING INTO OTHER GIANT ROBOTS ](http://robots.thoughtbot.com/ )
2011-01-19 16:21:20 +00:00
2014-05-30 17:53:05 +00:00
[GETTING_STARTED]: http://rubydoc.info/gems/factory_girl/file/GETTING_STARTED.md
2011-01-19 16:21:20 +00:00
Contributing
------------
2014-05-29 14:26:42 +00:00
Please see [CONTRIBUTING.md ](https://github.com/thoughtbot/factory_girl/blob/master/CONTRIBUTING.md ).
2011-01-19 16:21:20 +00:00
2013-10-13 19:25:26 +00:00
factory_girl was originally written by Joe Ferris and is now maintained by Josh
Clayton. Many improvements and bugfixes were contributed by the [open source
community](https://github.com/thoughtbot/factory_girl/graphs/contributors).
2011-01-19 16:21:20 +00:00
2015-03-12 13:52:31 +00:00
License
-------
2011-01-19 16:21:20 +00:00
2016-01-02 05:54:00 +00:00
factory_girl is Copyright © 2008-2016 Joe Ferris and thoughtbot. It is free
2015-03-12 13:52:31 +00:00
software, and may be redistributed under the terms specified in the
[LICENSE ](/LICENSE ) file.
2011-01-19 16:21:20 +00:00
2015-03-12 13:52:31 +00:00
About thoughtbot
----------------
factory_girl is maintained and funded by thoughtbot, inc.
2011-01-19 16:21:20 +00:00
The names and logos for thoughtbot are trademarks of thoughtbot, inc.
2015-03-12 13:52:31 +00:00
We love open source software!
See [our other projects][community] or
[hire us][hire] to design, develop, and grow your product.
2011-01-19 16:21:20 +00:00
2015-03-12 13:52:31 +00:00
[community]: https://thoughtbot.com/community?utm_source=github
[hire]: https://thoughtbot.com?utm_source=github
