thoughtbot-factory_girl 1.1 → 1.1.1

data/README.textile

@@ -1,31 +1,41 @@
-= factory_girl
+h1. factory_girl
 
-  written by Joe Ferris <jferris@thoughtbot.com>
-  thanks to Tammer Saleh, Dan Croak, and Jon Yurek of thoughtbot, inc.
-  Copyright 2008 Joe Ferris and thoughtbot, inc.
+Written by "Joe Ferris":mailto:jferris@thoughtbot.com.
 
-== Defining factories
+Thanks to Tammer Saleh, Dan Croak, and Jon Yurek of thoughtbot, inc.
 
-  # This will guess the User class
-  Factory.define :user do |u|
-    u.first_name 'John'
-    u.last_name  'Doe'
-    u.admin false
-  end
+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>
 
-  # 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
 
 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:
-  require 'factory_girl'
+<pre><code>require 'factory_girl'</code></pre>
+
 
-== Lazy Attributes
+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
@@ -33,73 +43,83 @@ 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:
 
-  Factory.define :user do |u|
-    # ...
-    u.activation_code { User.generate_activation_code }
-  end
+<pre><code>Factory.define :user do |u|
+  # ...
+  u.activation_code { User.generate_activation_code }
+end</code></pre>
 
-== Dependent Attributes
+
+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:
 
-  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
+<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>
 
-  Factory(:user, :last_name => 'Doe').email
-  # => "joe.doe@example.com"
 
-== Associations
+h2. Associations
 
 Associated instances can be generated by using the association method when
 defining a lazy attribute:
 
-  Factory.define :post do |p|
-    # ...
-    p.author {|author| author.association(:user, :last_name => 'Writely') }
-  end
+<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:
 
-  # Builds and saves a User and a Post
-  post = Factory(:post)
-  post.new_record?       # => false
-  post.author.new_record # => false
+<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>
 
-  # Builds but does not save a User and a Post
-  Factory.build(:post)
-  post.new_record?       # => true
-  post.author.new_record # => true
 
-== Sequences
+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:
 
-  # Defines a new sequence
-  Factory.sequence :email do |n|
-    "person#{n}@example.com"
-  end
+<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>
+
 
-  Factory.next :email
-  # => "person1@example.com"
+h2. Using factories
 
-  Factory.next :email
-  # => "person2@example.com"
+<pre><code># Build and save a User instance
+Factory(:user)
 
-== Using factories
+# Build a User instance and override the first_name property
+Factory.build(:user, :first_name => 'Joe')
 
-  # Build and save a User instance
-  Factory(:user)
+# Return an attributes Hash that can be used to build a User instance
+attrs = Factory.attributes_for(:user)</code></pre>
 
-  # Build a User instance and override the first_name property
-  Factory.build(:user, :first_name => 'Joe')
+h2. More Information
 
-  # Return an attributes Hash that can be used to build a User instance
-  attrs = Factory.attributes_for(:user)
+"Our blog":http://giantrobots.thoughtbot.com
 
+"factory_girl rdoc":http://dev.thoughtbot.com/factory_girl

data/Rakefile

@@ -31,7 +31,7 @@ end
 
 spec = Gem::Specification.new do |s|
   s.name        = %q{factory_girl}
-  s.version     = "1.1"
+  s.version     = "1.1.1"
   s.summary     = %q{factory_girl provides a framework and DSL for defining and
                      using model instance factories.}
   s.description = %q{factory_girl provides a framework and DSL for defining and

data/lib/factory_girl/factory.rb

@@ -4,7 +4,7 @@ class Factory
   self.factories = {}
   self.sequences = {}
 
-  attr_reader :name
+  attr_reader :factory_name
 
   # Defines a new factory that can be used by the build strategies (create and
   # build) to build new objects.
@@ -61,13 +61,13 @@ class Factory
   end
 
   def build_class #:nodoc:
-    @build_class ||= @options[:class] || name.to_s.classify.constantize
+    @build_class ||= @options[:class] || factory_name.to_s.classify.constantize
   end
 
   def initialize (name, options = {}) #:nodoc:
     options.assert_valid_keys(:class)
-    @name    = name
-    @options = options
+    @factory_name = name
+    @options      = options
 
     @static_attributes     = {}
     @lazy_attribute_blocks = {}
@@ -114,7 +114,7 @@ class Factory
   # and:
   #
   #   Factory.define :user do |f|
-  #     f.add_attribute :user, 'Billy Idol'
+  #     f.add_attribute :name, 'Billy Idol'
   #   end
   #
   # are equivilent. 

data/test/factory_test.rb

@@ -82,8 +82,8 @@ class FactoryTest < Test::Unit::TestCase
       @factory = Factory.new(@name)
     end
 
-    should "have a name" do
-      assert_equal @name, @factory.name
+    should "have a factory name" do
+      assert_equal @name, @factory.factory_name
     end
 
     should "have a build class" do

data/test/integration_test.rb

@@ -11,7 +11,7 @@ class IntegrationTest < Test::Unit::TestCase
     end
 
     Factory.define :post do |f|
-      f.title 'Test Post'
+      f.name   'Test Post'
       f.author {|a| a.association(:user) }
     end
 

data/test/models.rb

@@ -13,7 +13,7 @@ class CreateSchema < ActiveRecord::Migration
     end
 
     create_table :posts, :force => true do |t|
-      t.string  :title
+      t.string  :name  
       t.integer :author_id
     end
   end
@@ -27,6 +27,6 @@ class User < ActiveRecord::Base
 end
 
 class Post < ActiveRecord::Base
-  validates_presence_of :title, :author_id
+  validates_presence_of :name, :author_id
   belongs_to :author, :class_name => 'User'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: thoughtbot-factory_girl
 version: !ruby/object:Gem::Version 
-  version: "1.1"
+  version: 1.1.1
 platform: ruby
 authors: 
 - Joe Ferris
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-06-06 00:00:00 -07:00
+date: 2008-06-23 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -68,7 +68,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.0.1
+rubygems_version: 1.2.0
 signing_key: 
 specification_version: 2
 summary: factory_girl provides a framework and DSL for defining and using model instance factories.