kotovalexarian-likes-github/thoughtbot--factory_bot_rails

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

Factory Bot ♥ Rails

Find a file

Iazel 8021fb5b1c Update README.md Add how-to disable factories generator and how-to change default directory. `:suffix` option is moved to `generators.factory_girl` Closes #92		2013-04-05 11:18:42 -04:00
features	Break generator up for separate frameworks	2013-04-05 11:13:35 -04:00
gemfiles	Bump version to 4.2.1	2013-02-08 15:16:10 -05:00
lib	Break generator up for separate frameworks	2013-04-05 11:13:35 -04:00
.gitignore	[Closes #72 ] Remove Gemfile.lock from repo	2012-11-02 13:35:38 -04:00
.travis.yml	Allow Rails 3.1 to select the 'turn' gem it wants to use	2013-01-07 16:42:54 -05:00
Appraisals	Bump rails gem versions to latest for Appraisal	2013-01-29 16:39:31 -05:00
CONTRIBUTING.md	Add a document describing how to contribute.	2011-07-22 17:15:01 -04:00
factory_girl_rails.gemspec	add license information to gemspec	2013-02-15 16:52:15 -05:00
Gemfile	Uses secure RubyGems URL	2013-02-27 21:56:08 -05:00
LICENSE	Extend copyright year through 2013	2013-01-04 11:14:31 -05:00
Rakefile	Use Appraisal	2012-11-02 16:35:09 -04:00
README.md	Update README.md	2013-04-05 11:18:42 -04: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.

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'

Generators for factories will automatically substitute fixture (and maybe any other fixture_replacement you set). If you want disable this feature, add the following to your application.rb file:

config.generators do |g|
  g.factory_girl false
end

Default factories directory is test/factories, or spec/factories if test_framework generator is set to :rspec; change this behavior with:

config.generators do |g|
  g.factory_girl dir: 'custom/dir/for/factories'
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.

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.

factory_girl is maintained and funded by thoughtbot, inc

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