thoughtbot--factory_bot/README.md

# factory_girl [![Build Status](https://secure.travis-ci.org/thoughtbot/factory_girl.png)](http://travis-ci.org/thoughtbot/factory_girl?branch=master)

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](http://github.com/thoughtbot/factory_girl_rails).

Documentation
-------------

You should find the documentation for your version of factory_girl on [Rubygems](http://rubygems.org/gems/factory_girl).

See [GETTING_STARTED.md](http://github.com/thoughtbot/factory_girl/blob/master/GETTING_STARTED.md) for information on defining and using factories.

Install
--------

```shell
gem install factory_girl
```
or add the following line to Gemfile:

```ruby
gem 'factory_girl'
```
and run `bundle install` from your shell.

More Information
----------------

* [Rubygems](http://rubygems.org/gems/factory_girl)
* [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
------------

Please see the [contribution guidelines](http://github.com/thoughtbot/factory_girl/blob/master/CONTRIBUTION_GUIDELINES.md).

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

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.
Report Travis status from master branch 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)`
change readme to markdown and add in credit and license info 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`
Converted the contribution guidelines; updates to readme 2011-02-07 22:52:28 +00:00			`[factory_girl_rails](http://github.com/thoughtbot/factory_girl_rails).`
Extract examples out to a different file so that the readme people see on Github won't contact examples from master 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).`

Fix link to GETTING_STARTED. 2011-06-29 14:45:40 +00:00			`See [GETTING_STARTED.md](http://github.com/thoughtbot/factory_girl/blob/master/GETTING_STARTED.md) for information on defining and using factories.`
change readme to markdown and add in credit and license info 2011-01-19 16:21:20 +00:00
More clear install message 2011-07-05 12:17:41 +00:00			`Install`
change readme to markdown and add in credit and license info 2011-01-19 16:21:20 +00:00			`--------`

Clear up the language for pedantic people. 2011-07-05 17:18:15 +00:00			```shell
More clear install message 2011-07-05 12:17:41 +00:00			`gem install factory_girl`
			```
			`or add the following line to Gemfile:`
Fix syntax highlighting 2011-07-16 21:26:30 +00:00
More clear install message 2011-07-05 12:17:41 +00:00			```ruby
			`gem 'factory_girl'`
			```
Clear up the language for pedantic people. 2011-07-05 17:18:15 +00:00			and run `bundle install` from your shell.
change readme to markdown and add in credit and license info 2011-01-19 16:21:20 +00:00
			`More Information`
			`----------------`

Extract examples out to a different file so that the readme people see on Github won't contact examples from master 2011-02-07 22:48:29 +00:00			`* [Rubygems](http://rubygems.org/gems/factory_girl)`
change readme to markdown and add in credit and license info 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`
			`------------`

Add link to contribution guidelines. 2011-06-29 14:46:28 +00:00			`Please see the [contribution guidelines](http://github.com/thoughtbot/factory_girl/blob/master/CONTRIBUTION_GUIDELINES.md).`
change readme to markdown and add in credit and license info 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`

			`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.`