modelfactory 0.7.0 → 0.8.0

data/History.txt

@@ -1,3 +1,7 @@
+== 0.8.0 2008-12-10
+
+* added the ability to specify multiple named types of defaults
+
 == 0.7.0 2008-11-11
 
 * Documentation and rubygem

data/README.txt

@@ -3,6 +3,9 @@
 ModelFactory is a module designed to replace the use of fixtures for testing
 Rails applications.
 
+The best explanation for the motivation behind ModelFactory (and the inspiration
+for this module) comes from Dan Manges' blog: http://www.dcmanges.com/blog/38
+
 The idea is that instead of keeping your test data in a nearly opaque fixture
 file, you generate data in the test itself using a custom factory API designed
 for your test environment.
@@ -16,13 +19,18 @@ the database.
 
 === A Note About Defaults
 
-When writing tests that use factory-generated objects, it's important never
-to depend on default values in your test assertions. If you depend on defaults
-in your tests they become more fragile and the intention is harder to discern.
+The purpose of default values is to generate valid instances, not to serve as
+replacements for fixture data. When writing tests that use factory-generated
+objects, it's important never to depend on default values in your test assertions.
+If you depend on defaults in your tests they become more fragile and the intention
+is harder to discern. Alway override values you care about when using factory objects.
 
 If you find yourself repeating the same initialization to avoid using defaults,
 consider whether it would be appropriate to add a custom toplevel method to
-your factory module that includes this initialization.
+your factory module that includes this initialization. You can also specify
+multiple named types of defaults, described below. Be aware that both of these
+techniques should be used sparingly, as they can have some of the same issues
+as fixtures.
 
 === A Note About ID Generation
 
@@ -80,6 +88,36 @@ Then in your tests you use Factory methods to instantiate your test objects:
    assert !user.likes_blue?
  end
 
+You can also specify types of models in your calls to defaults, but be careful. This can
+easily start to become a lot like fixtures:
+
+ module Factory
+   extend ModelFactory
+
+   default User, :joined {
+     :first_name => 'Harry',
+     :last_name => 'Manchester',
+     :joined => true,
+     :set_password => true,
+   }
+  
+   default User, :unjoined {
+     :first_name => 'Harry',
+     :last_name => 'Manchester',
+     :joined => false,
+     :set_password => false,
+   }
+ end
+
+Then in your test:
+
+ def test_something
+   user1 = Factory.create_joined_user(:first_name => 'Bill')
+   user2 = Factory.create_unjoined_user(:first_name => 'Sandy')
+   assert  user1.joined?
+   assert !user2.joined?
+ end
+
 == Installing ModelFactory
 
  sudo gem install modelfactory

data/lib/model_factory.rb

@@ -1,3 +1,4 @@
+require 'rubygems'
 require 'active_record'
 
 module ModelFactory
@@ -12,9 +13,12 @@ module ModelFactory
   # object as a dependency use the special method default_* instead of
   # create_* or new_*.
   #
-  def default(class_type, defaults={})
+  def default(class_type, *args)
+    defaults   = args.pop || {}
+    prefix     = args.first
     class_name = class_type.name.demodulize.underscore
-  
+    class_name = "#{prefix}_#{class_name}" if prefix
+
     (class << self; self; end).module_eval do
       define_method "create_#{class_name}" do |*args|
         attributes = args.first || {}
@@ -78,10 +82,8 @@ module ModelFactory
     if protected_attrs or accessible_attrs
       attributes.each do |key, value|
         # Support symbols and strings.
-        [key, key.to_s].each do |attr|
-          next if protected_attrs  and not protected_attrs.include?(attr)
-          next if accessible_attrs and accessible_attrs.include?(attr)
-        end
+        next if protected_attrs  and not (protected_attrs.include?(key) or protected_attrs.include?(key.to_s))
+        next if accessible_attrs and (accessible_attrs.include?(key) or accessible_attrs.include?(key.to_s))
         modified = true
         instance.send("#{key}=", value)
       end

data/lib/model_factory/version.rb

@@ -1,7 +1,7 @@
 module ModelFactory #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
-    MINOR = 7
+    MINOR = 8
     TINY  = 0
 
     STRING = [MAJOR, MINOR, TINY].join('.')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: modelfactory
 version: !ruby/object:Gem::Version 
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors: 
 - Justin Balthrop
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-11-13 00:00:00 -08:00
+date: 2008-12-10 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -73,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: modelfactory
-rubygems_version: 1.2.0
+rubygems_version: 1.3.1
 signing_key: 
 specification_version: 2
 summary: A replacement for fixtures.