factory_girl 1.1.5 → 1.2.0

data/test/test_helper.rb

@@ -5,6 +5,7 @@ require 'rubygems'
 require 'test/unit'
 require 'activerecord'
 require 'factory_girl'
+gem 'thoughtbot-shoulda', ">= 2.0.0"
 require 'shoulda'
 require 'mocha'
 require 'models'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: factory_girl
 version: !ruby/object:Gem::Version 
-  version: 1.1.5
+  version: 1.2.0
 platform: ruby
 authors: 
 - Joe Ferris
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-12-11 00:00:00 -05:00
+date: 2009-02-17 00:00:00 -05:00
 default_executable: 
 dependencies: []
 
@@ -20,26 +20,49 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
-- README.textile
+- README.rdoc
 files: 
 - Changelog
 - CONTRIBUTION_GUIDELINES.rdoc
 - LICENSE
 - Rakefile
-- README.textile
+- README.rdoc
 - lib/factory_girl/aliases.rb
+- lib/factory_girl/attribute/association.rb
+- lib/factory_girl/attribute/dynamic.rb
+- lib/factory_girl/attribute/static.rb
 - lib/factory_girl/attribute.rb
-- lib/factory_girl/attribute_proxy.rb
 - lib/factory_girl/factory.rb
+- lib/factory_girl/proxy/attributes_for.rb
+- lib/factory_girl/proxy/build.rb
+- lib/factory_girl/proxy/create.rb
+- lib/factory_girl/proxy/stub.rb
+- lib/factory_girl/proxy.rb
 - lib/factory_girl/sequence.rb
+- lib/factory_girl/syntax/blueprint.rb
+- lib/factory_girl/syntax/generate.rb
+- lib/factory_girl/syntax/make.rb
+- lib/factory_girl/syntax/sham.rb
+- lib/factory_girl/syntax.rb
 - lib/factory_girl.rb
 - test/aliases_test.rb
-- test/attribute_proxy_test.rb
+- test/association_attribute_test.rb
 - test/attribute_test.rb
+- test/attributes_for_strategy_test.rb
+- test/build_strategy_test.rb
+- test/create_strategy_test.rb
+- test/dynamic_attribute_test.rb
 - test/factory_test.rb
 - test/integration_test.rb
 - test/models.rb
 - test/sequence_test.rb
+- test/static_attribute_test.rb
+- test/strategy_test.rb
+- test/stub_strategy_test.rb
+- test/syntax/blueprint_test.rb
+- test/syntax/generate_test.rb
+- test/syntax/make_test.rb
+- test/syntax/sham_test.rb
 - test/test_helper.rb
 has_rdoc: true
 homepage: 
@@ -50,7 +73,7 @@ rdoc_options:
 - --line-numbers
 - --inline-source
 - --main
-- README.textile
+- README.rdoc
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -74,8 +97,19 @@ specification_version: 2
 summary: factory_girl provides a framework and DSL for defining and using model instance factories.
 test_files: 
 - test/aliases_test.rb
-- test/attribute_proxy_test.rb
+- test/association_attribute_test.rb
 - test/attribute_test.rb
+- test/attributes_for_strategy_test.rb
+- test/build_strategy_test.rb
+- test/create_strategy_test.rb
+- test/dynamic_attribute_test.rb
 - test/factory_test.rb
 - test/integration_test.rb
 - test/sequence_test.rb
+- test/static_attribute_test.rb
+- test/strategy_test.rb
+- test/stub_strategy_test.rb
+- test/syntax/blueprint_test.rb
+- test/syntax/generate_test.rb
+- test/syntax/make_test.rb
+- test/syntax/sham_test.rb

data/README.textile

@@ -1,151 +0,0 @@
-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>
-
-Note: if you install factory_girl using the gem from Github, you'll need this
-in your environment.rb if you want to use Rails 2.1's dependency manager:
-
-config.gem "thoughtbot-factory_girl",
-           :lib    => "factory_girl",
-           :source => "http://gems.github.com"
-
-h2. Contributing
-
-Please read the contribution guidelines before submitting patches or pull requests.
-
-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>
-
-Because this pattern is so common, a prettier syntax is available for defining
-associations:
-
-<pre><code># The following definitions are equivilent:
-Factory.define :post do |p|
-  p.author {|a| a.association(:user) }
-end
-
-Factory.define :post do |p|
-  p.association :author, :factory => :user
-end</code></pre>
-
-If the factory name is the same as the association name, the factory name can
-be left out.
-
-
-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

data/lib/factory_girl/attribute_proxy.rb

@@ -1,92 +0,0 @@
-class Factory
-
-  class AttributeProxy
-
-    attr_accessor :factory, :attribute_name, :strategy, :current_values #:nodoc:
-
-    def initialize (factory, attr, strategy, values) #:nodoc:
-      @factory        = factory
-      @attribute_name = attr
-      @strategy       = strategy
-      @current_values = values
-    end
-
-    # Generates an association using the current build strategy.
-    #
-    # Arguments:
-    #   name: (Symbol)
-    #     The name of the factory that should be used to generate this
-    #     association.
-    #   attributes: (Hash)
-    #     A hash of attributes that should be overridden for this association.
-    #
-    # Returns:
-    #   The generated association for the current build strategy. Note that
-    #   assocaitions are not generated for the attributes_for strategy. Returns
-    #   nil in this case.
-    #
-    # Example:
-    #
-    #   Factory.define :user do |f|
-    #     # ...
-    #   end
-    #
-    #   Factory.define :post do |f|
-    #     # ...
-    #     f.author {|a| a.association :user, :name => 'Joe' }
-    #   end
-    #
-    #   # Builds (but doesn't save) a Post and a User
-    #   Factory.build(:post)
-    #
-    #   # Builds and saves a User, builds a Post, assigns the User to the 
-    #   # author association, and saves the User.
-    #   Factory.create(:post)
-    #
-    def association (name, attributes = {})
-      if strategy == :attributes_for
-        nil
-      else
-        Factory.create(name, attributes)
-      end
-    end
-
-    # Returns the value for specified attribute. A value will only be available
-    # if it was overridden when calling the factory, or if a value is added
-    # earlier in the definition of the factory.
-    #
-    # Arguments:
-    #   attribute: (Symbol)
-    #     The attribute whose value should be returned.
-    #
-    # Returns:
-    #   The value of the requested attribute. (Object)
-    def value_for (attribute)
-      unless current_values.key?(attribute)
-        raise ArgumentError, "No such attribute: #{attribute.inspect}"
-      end
-      current_values[attribute]
-    end
-
-    # Undefined methods are delegated to value_for, which means that:
-    #
-    #   Factory.define :user do |f|
-    #     f.first_name 'Ben'
-    #     f.last_name {|a| a.value_for(:first_name) }
-    #   end
-    #
-    # and:
-    #
-    #   Factory.define :user do |f|
-    #     f.first_name 'Ben'
-    #     f.last_name {|a| a.first_name }
-    #   end
-    #
-    # are equivilent.
-    def method_missing (name, *args, &block)
-      current_values[name]
-    end
-
-  end
-
-end

data/test/attribute_proxy_test.rb

@@ -1,121 +0,0 @@
-require(File.join(File.dirname(__FILE__), 'test_helper'))
-
-class AttributeProxyTest < Test::Unit::TestCase
-
-  context "an association proxy" do
-
-    setup do
-      @factory  = mock('factory')
-      @attr     = :user
-      @attrs    = { :first_name => 'John' }
-      @strategy = :create
-      @proxy  = Factory::AttributeProxy.new(@factory, @attr, @strategy, @attrs)
-    end
-
-    should "have a factory" do
-      assert_equal @factory, @proxy.factory
-    end
-
-    should "have an attribute name" do
-      assert_equal @attr, @proxy.attribute_name
-    end
-
-    should "have a build strategy" do
-      assert_equal @strategy, @proxy.strategy
-    end
-
-    should "have attributes" do
-      assert_equal @attrs, @proxy.current_values
-    end
-
-    context "building an association" do
-
-      setup do
-        @association = mock('built-user')
-        @name        = :user
-        @attribs     = { :first_name => 'Billy' }
-
-        Factory.stubs(@strategy).returns(@association)
-      end
-
-      should "delegate to the appropriate method on Factory" do
-        Factory.expects(@strategy).with(@name, @attribs).returns(@association)
-        @proxy.association(@name, @attribs)
-      end
-
-      should "return the built association" do
-        assert_equal @association, @proxy.association(@name)
-      end
-
-    end
-
-    context "building an association using the attributes_for strategy" do
-
-      setup do
-        @strategy = :attributes_for
-        @proxy  = Factory::AttributeProxy.new(@factory, @attr, @strategy, @attrs)
-      end
-
-      should "not build the association" do
-        Factory.expects(@strategy).never
-        @proxy.association(:user)
-      end
-
-      should "return nil for the association" do
-        Factory.stubs(@strategy).returns(:user)
-        assert_nil @proxy.association(:user)
-      end
-
-    end
-
-    context "building an association using the build strategy" do
-
-      setup do
-        @strategy = :build
-        @built    = 'object'
-        @proxy    = Factory::AttributeProxy.new(@factory, @attr, @strategy, @attrs)
-        Factory.stubs(:create).returns(@built)
-      end
-
-      should "create the association" do
-        Factory.expects(:create).with(:user, {}).returns(@built)
-        @proxy.association(:user)
-      end
-
-      should "return the created object" do
-        assert_equal @built, @proxy.association(:user)
-      end
-
-    end
-
-    context "fetching the value of an attribute" do
-
-      setup do
-        @attr = :first_name
-      end
-
-      should "return the correct value" do
-        assert_equal @attrs[@attr], @proxy.value_for(@attr)
-      end
-
-      should "call value_for for undefined methods" do
-        assert_equal @attrs[@attr], @proxy.send(@attr)
-      end
-
-    end
-
-    context "fetching the value of an undefined attribute" do
-
-      setup do
-        @attr = :beachball
-      end
-
-      should "raise an ArgumentError" do
-        assert_raise(ArgumentError) { @proxy.value_for(@attr) }
-      end
-
-    end
-
-  end
-
-end