Makers
Minimalistic factory inspired in factory_girl for rails.
Install
Put this line in your Gemfile:
gem 'makers', group: [:development, :test]
Then bundle:
$ bundle
Configuration
There is no need to configure anything, all this is done automatically for rspec and minitest:
- Loading the definitions.
- Replacing the fixtures generators.
- Including the methods inside your testing framework.
- Cleaning the database after each test.
Usage
Methods
There are three methods available:
attributes_for
build
create
Is possible to override the defaults passing a hash:
build :user, name: 'other'
create :category, title: 'other'
To create lists just pass the desired size as second parameter to build and create methods:
build :user, 2, name: 'other'
create :category, 5, title: 'other'
Makers
Define them in a ruby file inside test/makers or spec/makers folders:
maker :user do
name 'example'
end
Inheritance
Can be declare nested or separated:
maker :user do
name 'example'
maker :user_with_email do
email '[email protected]'
end
end
maker :user_with_age, parent: :user do
age 9
end
Sequences
Generates an unique sequence of numbers for the attribute of the maker:
maker :user do
sequence(:email) { |n| "example#{n}@mail.com" }
sequence(:age)
end
Associations
Associations are used by name:
maker :user do
posts
comments 4 # You can customize the number of records
end
maker :post do
user
end
maker :comment do
user
end
Aliases
The aliases are important when there is the need of context:
maker :user, aliases: :author do
comments
end
maker :post, aliases: :comment do
title
end
Dependent attributes
If you need to use some logic that depends of another attribute you can use a block or sequence:
maker :user do
name 'example'
email { "#{name}@mail.com" }
sequence(:username) { |n| "#{name}-#{n}" }
end
Callbacks
The available callbacks are before(:build), before(:create), after(:build) and after(:create):
maker :user do
after(:build) { |u| u.name = 'sample' }
end
You can declare global callbacks in your test or spec helper as well:
Makers.configure do
after(:create) do |object|
log object.errors unless object.valid?
end
end
Credits
This gem is maintained and funded by mmontossi.
License
It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.