mirror of
https://github.com/thoughtbot/factory_bot.git
synced 2022-11-09 11:43:51 -05:00
125 lines
3.4 KiB
Text
125 lines
3.4 KiB
Text
h1. factory_girl
|
|
|
|
Written by "Joe Ferris":mailto:jferris@thoughtbot.com.
|
|
|
|
Thanks to Tammer Saleh, Dan Croak, and Jon Yurek of thoughtbot, inc.
|
|
|
|
Copyright 2008 Joe Ferris and thoughtbot, inc.
|
|
|
|
h2. Download
|
|
|
|
Github: "Page":http://github.com/thoughtbot/factory_girl/tree/master "Clone":git://github.com/thoughtbot/factory_girl.git
|
|
|
|
Gem: <pre>gem install thoughtbot-factory_girl --source http://gems.github.com</pre>
|
|
|
|
h2. Defining factories
|
|
|
|
<pre><code># This will guess the User class
|
|
Factory.define :user do |u|
|
|
u.first_name 'John'
|
|
u.last_name 'Doe'
|
|
u.admin false
|
|
end
|
|
|
|
# This will use the User class (Admin would have been guessed)
|
|
Factory.define :admin, :class => User do |u|
|
|
u.first_name 'Admin'
|
|
u.last_name 'User'
|
|
u.admin true
|
|
end</code></pre>
|
|
|
|
|
|
It is recommended that you create a test/factories.rb file and define your
|
|
factories there. This file can be included from test_helper or directly from
|
|
your test files. Don't forget:
|
|
<pre><code>require 'factory_girl'</code></pre>
|
|
|
|
|
|
h2. Lazy Attributes
|
|
|
|
Most attributes can be added using static values that are evaluated when the
|
|
factory is defined, but some attributes (such as associations and other
|
|
attributes that must be dynamically generated) will need values assigned each
|
|
time an instance is generated. These "lazy" attributes can be added by passing
|
|
a block instead of a parameter:
|
|
|
|
<pre><code>Factory.define :user do |u|
|
|
# ...
|
|
u.activation_code { User.generate_activation_code }
|
|
end</code></pre>
|
|
|
|
|
|
h2. Dependent Attributes
|
|
|
|
Some attributes may need to be generated based on the values of other
|
|
attributes. This can be done by calling the attribute name on
|
|
Factory::AttributeProxy, which is yielded to lazy attribute blocks:
|
|
|
|
<pre><code>Factory.define :user do |u|
|
|
u.first_name 'Joe'
|
|
u.last_name 'Blow'
|
|
u.email {|a| "#{a.first_name}.#{a.last_name}@example.com".downcase }
|
|
end
|
|
|
|
Factory(:user, :last_name => 'Doe').email
|
|
# => "joe.doe@example.com"</code></pre>
|
|
|
|
|
|
h2. Associations
|
|
|
|
Associated instances can be generated by using the association method when
|
|
defining a lazy attribute:
|
|
|
|
<pre><code>Factory.define :post do |p|
|
|
# ...
|
|
p.author {|author| author.association(:user, :last_name => 'Writely') }
|
|
end</code></pre>
|
|
|
|
|
|
When using the association method, the same build strategy (build, create, or attributes_for) will be used for all generated instances:
|
|
|
|
<pre><code># Builds and saves a User and a Post
|
|
post = Factory(:post)
|
|
post.new_record? # => false
|
|
post.author.new_record # => false
|
|
|
|
# Builds but does not save a User and a Post
|
|
Factory.build(:post)
|
|
post.new_record? # => true
|
|
post.author.new_record # => true</code></pre>
|
|
|
|
|
|
h2. Sequences
|
|
|
|
Unique values in a specific format (for example, e-mail addresses) can be
|
|
generated using sequences. Sequences are defined by calling Factory.sequence,
|
|
and values in a sequence are generated by calling Factory.next:
|
|
|
|
<pre><code># Defines a new sequence
|
|
Factory.sequence :email do |n|
|
|
"person#{n}@example.com"
|
|
end
|
|
|
|
Factory.next :email
|
|
# => "person1@example.com"
|
|
|
|
Factory.next :email
|
|
# => "person2@example.com"</code></pre>
|
|
|
|
|
|
h2. Using factories
|
|
|
|
<pre><code># Build and save a User instance
|
|
Factory(:user)
|
|
|
|
# Build a User instance and override the first_name property
|
|
Factory.build(:user, :first_name => 'Joe')
|
|
|
|
# Return an attributes Hash that can be used to build a User instance
|
|
attrs = Factory.attributes_for(:user)</code></pre>
|
|
|
|
h2. More Information
|
|
|
|
"Our blog":http://giantrobots.thoughtbot.com
|
|
|
|
"factory_girl rdoc":http://dev.thoughtbot.com/factory_girl
|