thoughtbot--factory_bot_rails/README.md

76 lines
2.1 KiB
Markdown
Raw Normal View History

2012-11-30 21:55:44 +00:00
factory_girl [![Build Status](https://secure.travis-ci.org/thoughtbot/factory_girl_rails.png)](http://travis-ci.org/thoughtbot/factory_girl_rails?branch=master)
============
2010-06-09 15:42:48 +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.
Rails
-----
2010-06-09 15:42:48 +00:00
factory_girl_rails provides Rails integration for factory_girl. All
Rails-specific features are only compatible with Rails 3.
2011-07-28 13:46:06 +00:00
Currently, automatic factory definition loading is the only Rails-specific feature.
2010-06-09 15:42:48 +00:00
Download
--------
2010-06-09 15:42:48 +00:00
Github: http://github.com/thoughtbot/factory_girl_rails/tree/master
Gem:
2011-07-28 13:46:06 +00:00
gem install factory_girl_rails
2010-06-09 15:42:48 +00:00
Configuration
-------------
2010-06-09 15:42:48 +00:00
2011-07-28 13:46:06 +00:00
Add factory_girl_rails to your Gemfile:
2010-06-09 15:42:48 +00:00
gem 'factory_girl_rails'
2010-06-09 15:42:48 +00:00
Optionally, to have rails generators automatically generate factories instead
of fixtures, add the following to your application.rb file:
config.generators do |g|
g.fixture_replacement :factory_girl
end
`fixture_replacement :factory_girl` takes an option `:suffix => 'some_suffix'`
to generate factories as "modelname_some_suffix.rb"
2011-07-28 13:54:55 +00:00
Cucumber Integration
--------------------
2011-07-28 13:58:18 +00:00
factory_girl ships with step definitions for Cucumber integration. For more information, see the GETTING_STARTED file in the factory_girl repo.
2011-07-28 13:54:55 +00:00
More Information
----------------
2010-06-09 15:42:48 +00:00
factory_girl: http://github.com/thoughtbot/factory_girl/tree/master
2011-07-28 13:46:06 +00:00
Contributing
------------
Please see CONTRIBUTING.md for details.
Credits
-------
2010-06-09 15:42:48 +00:00
2011-07-28 13:46:06 +00:00
factory_girl was originally written by Joe Ferris.
2010-06-09 15:42:48 +00:00
![thoughtbot](http://thoughtbot.com/images/tm/logo.png)
2010-06-09 15:42:48 +00:00
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
-------
2013-01-04 16:14:31 +00:00
factory_girl is Copyright © 2008-2013 Joe Ferris and thoughtbot. It is free software, and may be redistributed under the terms specified in the LICENSE file.