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

Ralin Chimev a44854dc0c Update Gemspec file to not use `git ls-files` The gem is dependent on Git (factory_girl_rails.gemspec uses git ls-files). Some prod environments do not have git and if you try adding a gem through git or path option in bundler, 'git ls-files' in the .gemspec fails. Instead of using git, we could use pure Ruby code to list the gem files. Fixes #177.		2016-06-16 07:27:33 -04:00
bin	Add bin/setup, improve contributing guidelines	2014-05-27 00:41:28 -07:00
features	Correctly configure Aruba command timeout	2016-04-07 17:52:00 -04:00
gemfiles	Bump appraised version of Rails 5	2016-05-17 10:32:41 -04:00
lib	Add filename_proc option to Factory generator	2015-03-16 09:02:12 -04:00
.gitignore	Explicitly define gemfiles for Travis	2014-07-25 16:11:58 -04:00
.travis.yml	Appraise against Rails 5.0.0.beta3	2016-04-07 17:53:06 -04:00
Appraisals	Bump appraised version of Rails 5	2016-05-17 10:32:41 -04:00
CONTRIBUTING.md	Reference thoughtbot's open-source code of conduct in CONTRIBUTING.md	2015-04-15 23:33:55 -04:00
factory_girl_rails.gemspec	Update Gemspec file to not use `git ls-files`	2016-06-16 07:27:33 -04:00
Gemfile	Bump versions of Ruby and Rails to test on Travis	2015-03-14 20:14:50 -04:00
Gemfile.lock	Bump appraised version of Rails 5	2016-05-17 10:32:41 -04:00
LICENSE	Extend copyright year through 2013	2013-01-04 11:14:31 -05:00
NEWS	Add missing NEWS entries for 4.6.0 and 4.5.0	2016-05-18 09:27:09 -04:00
Rakefile	Use Appraisal	2012-11-02 16:35:09 -04:00
README.md	Add $ to command line instruction	2016-06-16 07:21:15 -04:00

README.md

factory_girl_rails

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.

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

Supported Rails versions are listed in Appraisals. Supported Ruby versions are listed in .travis.yml.

Download

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

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

If you use factory_girl for fixture replacement and already have a factories.rb file in the directory that contains your tests, factory_girl_rails will insert new factory definitions at the top of factories.rb.

Contributing

Please see CONTRIBUTING.md.

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.