A library for setting up Ruby objects as test data.

factories factory-bot factory-girl fixtures rails ruby rubygems testing thoughtbot

Go to file

Chad Pytel ed2309abfe Prefer the shorter syntax * Make that setup more prominent * Use it in the documentation		2013-12-13 10:02:23 -05:00
features	Convert to expect syntax	2013-01-18 13:58:36 -05:00
gemfiles	Bump version to 4.3.0	2013-11-03 22:21:04 -05:00
lib	Bump version to 4.3.0	2013-11-03 22:21:04 -05:00
spec	Add *_pair methods to create only two records	2013-11-01 17:32:50 -04:00
.autotest	Remove whitespace [Gun.io WhitespaceBot]	2011-10-21 13:40:41 -04:00
.gitignore	Ignore bin dir from bundler	2012-03-09 10:38:38 -05:00
.rspec	Use rspec2	2010-11-11 15:54:14 -06:00
.simplecov	Clean up SimpleCov usage	2012-04-23 21:50:39 -05:00
.travis.yml	Add Ruby 2.0.0 to list of versions to test on Travis	2013-11-02 13:00:19 -04:00
.yardopts	Converted the contribution guidelines; updates to readme	2011-02-07 17:52:28 -05:00
Appraisals	Update versions of Rails for Appraisal	2013-11-02 12:59:33 -04:00
CONTRIBUTION_GUIDELINES.md	http => https	2012-01-12 21:23:33 +01:00
GETTING_STARTED.md	Prefer the shorter syntax	2013-12-13 10:02:23 -05:00
Gemfile	Update dependency on ActiveRecord so it does not pull in 1.6.0	2013-08-02 15:36:23 -04:00
Gemfile.lock	Bump version to 4.3.0	2013-11-03 22:21:04 -05:00
LICENSE	Extend copyright year through 2013	2013-01-04 11:01:55 -05:00
NEWS	Bump version to 4.2.0	2013-01-18 16:13:08 -05:00
README.md	Update README credits	2013-10-13 15:25:26 -04:00
Rakefile	Bump versions of ActiveRecord in Appraisal and fix default task	2013-06-14 15:07:53 -04:00
cucumber.yml	Fixed issues with some attributes being skipped and added support for linked associations in step definitions	2009-09-15 16:56:20 -04:00
factory_girl.gemspec	add license information to gemspec	2013-01-29 09:45:36 -05:00

README.md

factory_girl

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.

Documentation

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

See GETTING_STARTED for information on defining and using factories.

Install

gem install factory_girl

or add the following line to Gemfile:

gem 'factory_girl'

and run bundle install from your shell.

Supported Ruby versions

The FactoryGirl 3.x+ series supports MRI Ruby 1.9. Additionally, FactoryGirl 3.6+ supports JRuby 1.6.7.2+ 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.

More Information

Contributing

Please see the contribution guidelines.

Credits

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.

factory_girl is maintained and funded by thoughtbot, inc

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