1
0
Fork 0
mirror of https://github.com/thoughtbot/factory_bot_rails.git synced 2022-11-09 11:49:18 -05:00
thoughtbot--factory_bot_rails/README.md

2.1 KiB

factory_girl Build Status

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

factory_girl_rails provides Rails integration for factory_girl. All Rails-specific features are only compatible with Rails 3.

Currently, automatic factory definition loading is the only Rails-specific feature.

Download

Github: http://github.com/thoughtbot/factory_girl_rails/tree/master

Gem:

gem install factory_girl_rails

Configuration

Add factory_girl_rails to your Gemfile:

gem 'factory_girl_rails'

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

If you use factory_girl for fixture replacement, ensure that factory_girl_rails is available in the development group. If it's not, Rails will generate standard yml files instead of factory files.

fixture_replacement :factory_girl takes an option :suffix => 'some_suffix' to generate factories as "modelname_some_suffix.rb"

More Information

factory_girl: http://github.com/thoughtbot/factory_girl/tree/master

Contributing

Please see CONTRIBUTING.md for details.

Credits

factory_girl was originally written by Joe Ferris.

thoughtbot

factory_girl is maintained and funded by thoughtbot, inc

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

License

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.