association_collection_tools 0.0.1 → 0.0.2

data/README

@@ -16,20 +16,21 @@ a. fast_copy
 A method called fast_copy is added to has_and_belongs_to_many association
 collections that makes the process of cloning HABTM associations *MUCH*
 more efficient.  Simply replace person1.items = person2.items with 
-person1.items.fast_copy(person2) and you're database, network and RAM will
+person1.items.fast_copy(person2) and your database, network and RAM will
 thank you.  See below for more details.
 
-b. ids
+b. fast_add
+fast_add operates just like fast_copy, but instead of replacing the existing
+objects in the association, it appends new objects to the association.
+
+c. ids
 A method called ids is added to has_many and has_and_belongs_to_many
 association collections.  It returns the list of object ids in the association
 collection without unnecessarily instantiating the objects.
 
 == Installation
 
-1. This plugin requires that the memcache-client gem is installed.
-   # gem install association_collection_tools
-
-2. Install the plugin OR the gem
+1. Install the plugin OR the gem
    $ script/plugin install svn://rubyforge.org/var/svn/zventstools/projects/association_collection_tools
    - OR -
    # gem install association_collection_tools
@@ -103,6 +104,12 @@ actually already exists and I'm just blind, but from the looks of
 http://dev.rubyonrails.org/ticket/2917, it appears that it is a
 documentation bug.
 
+== HABTM Fast Add
+fast_add operates just like fast_copy, but instead of replacing the existing
+objects in the association, it appends new objects to the association.
+
+person1.items.fast_add([1,2], {:user_id => user_id})
+
 == HABTM and has_many ids
 Return the list of IDs in this association collection without unnecessarily 
 instantiating a bunch of Active Record objects.  What good is the id of

data/lib/association_collection_tools.rb

@@ -73,7 +73,13 @@ module ActiveRecord
       def fast_copy(other_object,attributes = {})
         self.fast_clear
         other_object_assocation_ids = other_object.send(@reflection.name).ids
-        return [] if other_object_assocation_ids.empty?
+        self.fast_add(other_object_assocation_ids, attributes)
+      end
+
+      # fast_add allows you to quickly add objects identified by an array
+      # of ids to a HABTM association.
+      def fast_add(ids,attributes = {})
+        return [] if ids.empty?
 
         column_names = [ @reflection.primary_key_name,
           @reflection.association_foreign_key ]
@@ -83,8 +89,8 @@ module ActiveRecord
           attribute_values << attributes[k]
         }
 
-        @owner.connection.execute("REPLACE INTO #{@reflection.options[:join_table]} (#{column_names.join(",")}) VALUES #{other_object_assocation_ids.map{|aid| "(#{@owner.quoted_id},#{aid}#{attributes.empty? ? "" : ("," + attribute_values.join(','))})"}.join(",")}")
-        return other_object_assocation_ids
+        @owner.connection.execute("REPLACE INTO #{@reflection.options[:join_table]} (#{column_names.join(",")}) VALUES #{ids.map{|aid| "(#{@owner.quoted_id},#{aid}#{attributes.empty? ? "" : ("," + attribute_values.join(','))})"}.join(",")}")
+        return ids
       end
 
       # Return the list of IDs in this association collection without 

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.10
 specification_version: 1
 name: association_collection_tools
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
-date: 2006-11-02
+  version: 0.0.2
+date: 2006-11-03
 summary: Adds fast_copy method to has_and_belongs_to_many associations cloning associations much faster than the assignment operator.  Adds ids methods to has_many and has_and_belongs_to_many associations for retrieving object ids without instantiating ActiveRecord objects.
 require_paths: 
 - lib
@@ -40,13 +40,5 @@ extensions: []
 
 requirements: []
 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: memcache-client
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.0.3
-    version: 
+dependencies: []
+