c5d11518d7
* Rename files and code
* Change factory_girl dependency to factory_bot
This change will bring _rails name in line with factory_bot
|
||
|---|---|---|
| bin | ||
| features | ||
| gemfiles | ||
| lib | ||
| .gitignore | ||
| .travis.yml | ||
| Appraisals | ||
| CONTRIBUTING.md | ||
| factory_bot_rails.gemspec | ||
| factory_girl_rails.gemspec | ||
| Gemfile | ||
| Gemfile.lock | ||
| LICENSE | ||
| NEWS | ||
| Rakefile | ||
| README.md | ||
factory_bot_rails 
factory_bot 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_bot_rails provides Rails integration for factory_bot.
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_bot_rails
Gem:
$ gem install factory_bot_rails
Configuration
Add factory_bot_rails to your Gemfile:
group :development, :test do
gem 'factory_bot_rails'
end
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_bot 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_bot dir: 'custom/dir/for/factories'
end
If you use factory_bot for fixture replacement, ensure that factory_bot_rails is available in the development group. If it's not, Rails will generate standard .yml files instead of factory files.
factory_bot takes an option suffix: 'some_suffix' to generate factories as
modelname_some_suffix.rb.
If you use factory_bot for fixture replacement and already have a
factories.rb file in the directory that contains your tests,
factory_bot_rails will insert new factory definitions at the top of
factories.rb.
You may need to configure your test suite to include factory_bot methods; see configuration.
Contributing
Please see CONTRIBUTING.md.
Credits
factory_bot was originally written by Joe Ferris.
factory_bot is maintained and funded by thoughtbot, inc
The names and logos for thoughtbot are trademarks of thoughtbot, inc.
License
factory_bot_rails is Copyright © 2008-2016 Joe Ferris and thoughtbot. It is free software, and may be redistributed under the terms specified in the LICENSE file.