A gem that helps you generate your factory files.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
spec
.gitignore
.rspec
.travis.yml
Gemfile
README.md
Rakefile
factory_factory_girl.gemspec

README.md

Build Status Code Climate Test Coverage

FactoryFactoryGirl

Mission

FactoryGirl is a really useful gem that lets us generate test data more efficiently. However, if you start with new projects very frequently, you will feel painful to write project's attributes, especially some commonly seen attributes.

For example, you use FFaker::Job.title to generate all your name or title's value, and use FFaker::Lorem.paragraph to generate description or content's value. Then you just need to copy & paste those methods to serveral columns in serveral factories, or even in serveral project's factories.

So I created FactoryFactoryGirl. The mission of this gem is helping people generate their factory more quickly, with some pre-defined rules like:

FactoryFactoryGirl.configure do |config|
  config.match(/name|title/, function: "FFaker::Job.title")
  config.match(/content|descripton/, function: "FFaker::Lorem.paragraph")
  config.match(/country|region/, value: "Taiwan")
end

And run:

$ rails g factory_factory_girl:model post

or

$ rails g factory_factory_girl:model job

Then you will see you factory file have some pre-defined value.

FactoryGirl.define do
  ........
  name { FFaker::Job.title }
  content { FFaker::Lorem.paragraph }
  country "Taiwan"
  .......
end

And the rule you defined in this project, can be used in any other projects. You won't need to copy & paste the setting of those frequently seen column's.

I think this gem could be helpful, but also needs a lot of work. So if you find any bug or want any new feature, please open an issue or email me , thanks 😄.

Installation

Add this line to your application's Gemfile:

gem 'factory_factory_girl'

And then execute:

$ bundle

Or install it yourself as:

$ gem install factory_factory_girl

Usage

Set your generation rule in initializers/factory_factory_girl like

FactoryFactoryGirl.configure do |config|
  config.match(/name|title/, function: "FFaker::Job.title")
  config.match(/content|descripton/, function: "FFaker::Lorem.paragraph")
end

And run

$ rails g factory_factory_girl:model YOUR_MODEL

Notice that the default directory is test/factories (this is inherit from factory_girl_rails), so if you put your factories somewhere else, you need to specify it like

$ rails g factory_factory_girl:model YOUR_MODEL --dir=spec/factories

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

  • Fork it
  • Create your feature branch (git checkout -b my-new-feature)
  • Commit your changes (git commit -am 'Add some feature')
  • Push to the branch (git push origin my-new-feature)
  • Create a new Pull Request

Wanted contribution topic

  • More specs
  • New feature
  • Bug report/fix