ar-extensions 0.9.3 → 0.9.4

data/README

@@ -1,3 +1,5 @@
+*ar-extensions is not compatible and is not being developed for Rails 3. Please use the activerecord-import gem which supports the same interface.*
+
 LICENSE
 ----------
 This is licensed under the ruby license. 
@@ -10,6 +12,11 @@ Email: zach.dennis@gmail.com
  - For project information and feedback please consult http://rubyforge.org/projects/arext/
  - For release information please see below
 
+ActiveRecord::Extensions 0.9.4
+------------------------------
+April 6, 2011
+ - Added :synchronize_keys option for import which allows people to synchronize on specified fields besides the primary key. Note these fields should be unique
+
 ActiveRecord::Extensions 0.9.0, 0.9.1
 ------------------------------
 April 17, 2009

data/lib/ar-extensions/import.rb

@@ -123,6 +123,11 @@ class ActiveRecord::Base
     #  BlogPost.import posts, :synchronize=>[ post ]
     #  puts post.author_name # => 'yoda'
     #
+    #  # Example synchronizing unsaved/new instances in memory by using a uniqued imported field
+    #  posts = [BlogPost.new(:title => "Foo"), BlogPost.new(:title => "Bar")]
+    #  BlogPost.import posts, :synchronize => posts
+    #  puts posts.first.new_record? # => false
+    #
     # == On Duplicate Key Update (MySQL only)
     #
     # The :on_duplicate_key_update option can be either an Array or a Hash. 
@@ -206,8 +211,10 @@ class ActiveRecord::Base
         num_inserts = import_without_validations_or_callbacks( column_names, array_of_attributes, options )
         OpenStruct.new :failed_instances=>[], :num_inserts=>num_inserts
       end
+
       if options[:synchronize]
-        synchronize( options[:synchronize] )
+        sync_keys = options[:synchronize_keys] || [self.primary_key]
+        synchronize( options[:synchronize], sync_keys)
       end
 
       return_obj.num_inserts = 0 if return_obj.num_inserts.nil?

data/lib/ar-extensions/synchronize.rb

@@ -2,28 +2,54 @@ module ActiveRecord # :nodoc:
   class Base # :nodoc:
       
     # Synchronizes the passed in ActiveRecord instances with data
-    # from the database. This is like calling reload
-    # on an individual ActiveRecord instance but it is intended for use on
-    # multiple instances. 
-    #
+    # from the database. This is like calling reload on an individual
+    # ActiveRecord instance but it is intended for use on multiple instances. 
+    # 
     # This uses one query for all instance updates and then updates existing
     # instances rather sending one query for each instance
-    def self.synchronize(instances, key=self.primary_key)
+    #
+    # == Examples
+    # # Synchronizing existing models (ie: models with an id)
+    # posts = Post.find_by_author("Zach")
+    # Post.import [:id, :author], [[posts.first.id, "Zachary"]], :synchronize => posts
+    # posts.first.author # => "Zachary" instead of Zach
+    # 
+    # # Synchronizing new/unsaved models by using a unique column to perform the sync
+    # posts = [Post.new(:author => "Zach")]
+    # posts.first.new_record? # => true
+    # posts.first.id # => nil
+    # Post.import posts, :synchronize => posts
+    # posts.first.new_record? # => false
+    # posts.first.id # => 1
+    #
+    def self.synchronize(instances, keys=[self.primary_key])
       return if instances.empty?
+
+      conditions = {}
+      order = ""
+      
+      key_values = keys.map { |key| instances.map(&"#{key}".to_sym) }
+      keys.zip(key_values).each { |key, values| conditions[key] = values }
+      order = keys.map{ |key| "#{key} ASC" }.join(",")
       
-      keys = instances.map(&"#{key}".to_sym)
       klass = instances.first.class
-      fresh_instances = klass.find( :all, :conditions=>{ key=>keys }, :order=>"#{key} ASC" )
 
-      instances.each_with_index do |instance, index|
-        instance.clear_aggregation_cache
-        instance.clear_association_cache
-        instance.instance_variable_set '@attributes', fresh_instances[index].attributes
+      fresh_instances = klass.find( :all, :conditions=>conditions, :order=>order )
+      instances.each do |instance|
+        matched_instance = fresh_instances.detect do |fresh_instance|
+          keys.all?{ |key| fresh_instance.send(key) == instance.send(key) }
+        end
+        
+        if matched_instance
+          instance.clear_aggregation_cache
+          instance.clear_association_cache
+          instance.instance_variable_set '@attributes', matched_instance.attributes
+        end
       end
     end
 
     # See ActiveRecord::ConnectionAdapters::AbstractAdapter.synchronize
-    def synchronize(instances, key=ActiveRecord::Base.primary_key)
+    def synchronize(instances, key=[ActiveRecord::Base.primary_key])
       self.class.synchronize(instances, key)
     end
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ar-extensions
 version: !ruby/object:Gem::Version 
-  hash: 61
-  prerelease: false
+  hash: 51
+  prerelease: 
   segments: 
   - 0
   - 9
-  - 3
-  version: 0.9.3
+  - 4
+  version: 0.9.4
 platform: ruby
 authors: 
 - Zach Dennis
@@ -119,7 +119,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: arext
-rubygems_version: 1.3.7
+rubygems_version: 1.6.0
 signing_key: 
 specification_version: 3
 summary: Extends ActiveRecord functionality.