has_many_polymorphic 0.3.0 → 0.4.0

data/MIT-LICENSE.txt

@@ -1,20 +1,20 @@
-Copyright (c) 2007-2011 Collective Idea
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+Copyright (c) 2007-2011 Collective Idea
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -1,53 +1,53 @@
-= HasManyPolymorphic
-
-This mixin adds a has many polymorphic relationship to a model and creates all the relationships needed by rails to handle it.
- 
-== Options
-- Models
-	- the models you want to autoload so all the relationships are created on initialzation of Rails
-	
-== Example Usage
-
-	RussellEdge::HasManyPolymorphic.options[:models] = %w(PreferenceType)
-		
-== Params
-- Name 
-	- name of the relationship, there is a convention that whatever name you choose, the polymorphic table columns on your through table should match.
-        
-- Options
-	- through - the model that handles the through relationship
-	- models  - models that should be included in this polymophic relationship
-        
-        
-== Added methods
-        
-  - {name param}
-	- the name of your relationship is used for the method name of this method. it will return an array of the models that are related via the has_many relationships
-        
-There is an after_save call back that will save the relationships when they are added or removed. If you want to remove a relationship the models need to be destroyed and this model reloaded.
-        
-== Example Usage
-		  
-    class PreferenceType < ActiveRecord::Base
-      has_many_polymorphic :preferenced_records,
-        :through => :valid_preference_types,
-        :models => [:desktops, :organizers]
-    end
-		  
-this gives you the following
-		
-    preferenceType = PreferenceType.first
-    preferenceType.desktops
-    preferenceType.organizers
-		   
-and
-		   
-		  preferenceType.preferenced_records
-		   
-which is a concatentated array of the models. You also get the following
-		   
-    desktop = Desktop.first
-    desktop.preference_types
-		   
-    organizer = Organizer.first
+= HasManyPolymorphic
+
+This mixin adds a has many polymorphic relationship to a model and creates all the relationships needed by rails to handle it.
+ 
+== Options
+- Models
+	- the models you want to autoload so all the relationships are created on initialzation of Rails
+	
+== Example Usage
+
+	RussellEdge::HasManyPolymorphic.options[:models] = %w(PreferenceType)
+		
+== Params
+- Name 
+	- name of the relationship, there is a convention that whatever name you choose, the polymorphic table columns on your through table should match.
+        
+- Options
+	- through - the model that handles the through relationship
+	- models  - models that should be included in this polymophic relationship
+        
+        
+== Added methods
+        
+  - {name param}
+	- the name of your relationship is used for the method name of this method. it will return an array of the models that are related via the has_many relationships
+        
+There is an after_save call back that will save the relationships when they are added or removed. If you want to remove a relationship the models need to be destroyed and this model reloaded.
+        
+== Example Usage
+		  
+    class PreferenceType < ActiveRecord::Base
+      has_many_polymorphic :preferenced_records,
+        :through => :valid_preference_types,
+        :models => [:desktops, :organizers]
+    end
+		  
+this gives you the following
+		
+    preferenceType = PreferenceType.first
+    preferenceType.desktops
+    preferenceType.organizers
+		   
+and
+		   
+		  preferenceType.preferenced_records
+		   
+which is a concatentated array of the models. You also get the following
+		   
+    desktop = Desktop.first
+    desktop.preference_types
+		   
+    organizer = Organizer.first
     organizer.preference_types

data/lib/has_many_polymorphic.rb

@@ -1,7 +1,7 @@
-require 'has_many_polymorphic/has_many_polymorphic'
-ActiveRecord::Base.send :include, RussellEdge::HasManyPolymorphic
-
-#used to tie into Rails initialization to load the models so the relationships are created
-require 'has_many_polymorphic/autoload'
-
-
+require 'has_many_polymorphic/has_many_polymorphic'
+ActiveRecord::Base.send :include, RussellEdge::HasManyPolymorphic
+
+#used to tie into Rails initialization to load the models so the relationships are created
+require 'has_many_polymorphic/autoload'
+
+

data/lib/has_many_polymorphic/autoload.rb

@@ -1,37 +1,37 @@
-module RussellEdge
-  module HasManyPolymorphic
-
-=begin rdoc
-Searches for models that use <tt>has_many_polymorphic</tt> and makes sure that they get loaded during app initialization.
-This ensures that helper methods are injected into the target classes.
-=end
-    
-	#define the models that use has_many_polymorphic. has_many_polymorphs combed the file system for models
-	#that had the has_many_polymorphs method.  This is not as robust but more efficent.  It can be set via
-	#
-	#RussellEdge::HasManyPolymorphic::OPTIONS = { :models => %w(PreferenceType AnotherModel) }
-	# 
-    DEFAULT_OPTIONS = {:models => %w()}
-    mattr_accessor :options
-    @@options = HashWithIndifferentAccess.new(DEFAULT_OPTIONS)
-
-    # Dispatcher callback to load polymorphic relationships
-    def self.autoload
-      options[:models].each do |model|
-        #try to load model if it exists.
-        begin
-          model.constantize
-        rescue=>e
-        end
-      end
-      
-    end
-  end
-end
-
-#create Railtie to plugin into rails initialization
-class RussellEdge::HasManyPolymorphic::RailTie < Rails::Railtie
-  initializer "has_many_polymorphic.autoload_models", :after => :initialize do |app|
-      RussellEdge::HasManyPolymorphic.autoload
-   end
-end
+module RussellEdge
+  module HasManyPolymorphic
+
+=begin rdoc
+Searches for models that use <tt>has_many_polymorphic</tt> and makes sure that they get loaded during app initialization.
+This ensures that helper methods are injected into the target classes.
+=end
+    
+	#define the models that use has_many_polymorphic. has_many_polymorphs combed the file system for models
+	#that had the has_many_polymorphs method.  This is not as robust but more efficent.  It can be set via
+	#
+	#RussellEdge::HasManyPolymorphic::OPTIONS = { :models => %w(PreferenceType AnotherModel) }
+	# 
+    DEFAULT_OPTIONS = {:models => %w()}
+    mattr_accessor :options
+    @@options = HashWithIndifferentAccess.new(DEFAULT_OPTIONS)
+
+    # Dispatcher callback to load polymorphic relationships
+    def self.autoload
+      options[:models].each do |model|
+        #try to load model if it exists.
+        begin
+          model.constantize
+        rescue=>e
+        end
+      end
+      
+    end
+  end
+end
+
+#create Railtie to plugin into rails initialization
+class RussellEdge::HasManyPolymorphic::RailTie < Rails::Railtie
+  initializer "has_many_polymorphic.autoload_models", :after => :initialize do |app|
+      RussellEdge::HasManyPolymorphic.autoload
+   end
+end

data/lib/has_many_polymorphic/has_many_polymorphic.rb

@@ -1,144 +1,144 @@
-module RussellEdge #:nodoc:
-    module HasManyPolymorphic #:nodoc:
-
-      def self.included(base)
-        base.extend(ClassMethods)
-      end
-
-      module ClassMethods
-      
-        ##
-        #  HasManyPolymorphic
-        #  This mixin adds a has many polymorphic relationship to a model and creates all the relationships needed
-        #  by rails to handle it.
-        #
-        #  Params
-        #
-        #  Name - name of the relationship, there is a convention that whatever name you choose, the polymorphic
-        #  table columns on your through table should match.
-        #
-        #  Options
-        #   - through - the model that handles the through relationship
-        #   - models  - models that should be included in this polymophic relationship
-        #
-        #
-        #  One method is added for you to use
-        #
-        #  - {name param}
-        #    - the name of your relationship is used for the method name of this method. it will return
-        #    an array of the models that are related via the has_many relationships
-        #
-        #  There is an after_save call back that will save the relationships when they are added or removed
-        #  If you want to remove a relationship the models need to be destroyed and this model reloaded.
-        #
-        #  Example Usage
-		#  
-		#  class PreferenceType < ActiveRecord::Base
-		#  	has_morpheus :preferenced_records,
-        #       :through => :valid_preference_types,
-        #       :models => [:desktops, :organizers]
-		#  end
-		#  
-		#  this gives you the following
-		#
-		#  preferenceType = PreferenceType.first
-		#  preferenceType.desktops
-		#  preferenceType.organizers
-		#   
-		#  and
-		#   
-		#  preferenceType.preferenced_records
-		#   
-		#  which is a concatentated array of the models. You also get the following
-		#   
-		#  desktop = Desktop.first
-		#  desktop.preference_types
-		#   
-		#  organizer = Organizer.first
-		#  organizer.preference_types
-        ##
-
-        def has_many_polymorphic(name, options = {})
-          target_class_name = self.name
-          instance_array_name = "#{name}_array".to_sym
-          
-          #declare array to related models
-          attr_accessor instance_array_name
-        
-          #create the has_many relationship
-          has_many options[:through], :dependent => :destroy
-
-          #create the has_many relationship for each model
-          options[:models].each do |model|
-            has_many model, :through => options[:through], :source => model.to_s.singularize,
-              :conditions => ["#{options[:through]}.#{name.to_s.singularize}_type = ?", model.to_s.classify], :dependent => :destroy
-          end
-
-          #modify the through class to add the belongs to relationships
-          options[:through].to_s.classify.constantize.class_exec do
-            options[:models].each do |model|
-              belongs_to model.to_s.singularize.to_sym, :class_name => model.to_s.classify, :foreign_key => "#{name.to_s.singularize}_id"
-            end
-          end
-
-          #I want to keep the  << and push methods of array so this helps to keep them.
-          define_method name do
-            #used the declared instance variable array
-            records = self.send(instance_array_name.to_s)
-            records = records || []
-            options[:models].each do |model|
-              records = records | self.send(model.to_s)
-            end
-            
-            #set it back to the instance variable
-            self.send("#{instance_array_name.to_s}=", records)
-            
-            records
-          end
-
-          #before we save this model make sure you save all the relationships.
-          before_save do |record|
-            record.send(name).each do |reln_record|
-              conditions = "#{name.to_s.singularize}_id = #{reln_record.id} and #{name.to_s.singularize}_type = '#{reln_record.class.name}'"
-              exisiting_record = record.send("#{options[:through]}").find(:first,
-                :conditions => conditions)
-				
-			  #handle STI get superclass class_name if not sub class of ActiveRecord::Base	
-			  class_name = (reln_record.superclass == ActiveRecord::Base) ? reln_record.class.name : reln_record.superclass.class.name
-              if exisiting_record.nil?
-                values_hash = {}
-                values_hash["#{record.class.name.underscore}_id"] = record.id
-                values_hash["#{name.to_s.singularize}_type"] = reln_record.class.name
-                values_hash["#{name.to_s.singularize}_id"] = reln_record.id
-              
-                options[:through].to_s.classify.constantize.create(values_hash)
-              end
-            end
-          end
-			
-	      #include instance methods into this model
-          include RussellEdge::HasManyPolymorphic::InstanceMethods
-
-          #add the relationship to the models.
-          options[:models].each do |model|
-            model.to_s.classify.constantize.class_exec do
-              has_many options[:through], :as => name.to_s.singularize
-              has_many target_class_name.tableize, :through => options[:through]
-            end
-          end
-
-        end
-      end
-				
-      module InstanceMethods
-        #clear array on reload
-        def reload(*args)
-          @records = []
-
-          super args
-        end
-
-      end
-
-    end
+module RussellEdge #:nodoc:
+    module HasManyPolymorphic #:nodoc:
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      module ClassMethods
+      
+        ##
+        #  HasManyPolymorphic
+        #  This mixin adds a has many polymorphic relationship to a model and creates all the relationships needed
+        #  by rails to handle it.
+        #
+        #  Params
+        #
+        #  Name - name of the relationship, there is a convention that whatever name you choose, the polymorphic
+        #  table columns on your through table should match.
+        #
+        #  Options
+        #   - through - the model that handles the through relationship
+        #   - models  - models that should be included in this polymophic relationship
+        #
+        #
+        #  One method is added for you to use
+        #
+        #  - {name param}
+        #    - the name of your relationship is used for the method name of this method. it will return
+        #    an array of the models that are related via the has_many relationships
+        #
+        #  There is an after_save call back that will save the relationships when they are added or removed
+        #  If you want to remove a relationship the models need to be destroyed and this model reloaded.
+        #
+        #  Example Usage
+		#  
+		#  class PreferenceType < ActiveRecord::Base
+		#  	has_morpheus :preferenced_records,
+        #       :through => :valid_preference_types,
+        #       :models => [:desktops, :organizers]
+		#  end
+		#  
+		#  this gives you the following
+		#
+		#  preferenceType = PreferenceType.first
+		#  preferenceType.desktops
+		#  preferenceType.organizers
+		#   
+		#  and
+		#   
+		#  preferenceType.preferenced_records
+		#   
+		#  which is a concatentated array of the models. You also get the following
+		#   
+		#  desktop = Desktop.first
+		#  desktop.preference_types
+		#   
+		#  organizer = Organizer.first
+		#  organizer.preference_types
+        ##
+
+        def has_many_polymorphic(name, options = {})
+          target_class_name = self.name
+          instance_array_name = "#{name}_array".to_sym
+          
+          #declare array to related models
+          attr_accessor instance_array_name
+        
+          #create the has_many relationship
+          has_many options[:through], :dependent => :destroy
+
+          #create the has_many relationship for each model
+          options[:models].each do |model|
+            has_many model, :through => options[:through], :source => model.to_s.singularize,
+              :conditions => ["#{options[:through]}.#{name.to_s.singularize}_type = ?", model.to_s.classify], :dependent => :destroy
+          end
+
+          #modify the through class to add the belongs to relationships
+          options[:through].to_s.classify.constantize.class_exec do
+            options[:models].each do |model|
+              belongs_to model.to_s.singularize.to_sym, :class_name => model.to_s.classify, :foreign_key => "#{name.to_s.singularize}_id"
+            end
+          end
+
+          #I want to keep the  << and push methods of array so this helps to keep them.
+          define_method name do
+            #used the declared instance variable array
+            records = self.send(instance_array_name.to_s)
+            records = records || []
+            options[:models].each do |model|
+              records = records | self.send(model.to_s)
+            end
+            
+            #set it back to the instance variable
+            self.send("#{instance_array_name.to_s}=", records)
+            
+            records
+          end
+
+          #before we save this model make sure you save all the relationships.
+          before_save do |record|
+            record.send(name).each do |reln_record|
+              #handle STI get superclass class_name if not sub class of ActiveRecord::Base	
+              klass_name = (reln_record.class.superclass == ActiveRecord::Base) ? reln_record.class.name : reln_record.class.superclass.name
+              conditions = "#{name.to_s.singularize}_id = #{reln_record.id} and #{name.to_s.singularize}_type = '#{klass_name}'"
+              exisiting_record = record.send("#{options[:through]}").find(:first,:conditions => conditions)
+				
+              if exisiting_record.nil?
+                class_name = (reln_record.class.superclass == ActiveRecord::Base) ? reln_record.class.name : reln_record.class.superclass.name
+                values_hash = {}
+                values_hash["#{record.class.name.underscore}_id"] = record.id
+                values_hash["#{name.to_s.singularize}_type"] = klass_name
+                values_hash["#{name.to_s.singularize}_id"] = reln_record.id
+              
+                options[:through].to_s.classify.constantize.create(values_hash)
+              end
+            end
+          end
+			
+	      #include instance methods into this model
+          include RussellEdge::HasManyPolymorphic::InstanceMethods
+
+          #add the relationship to the models.
+          options[:models].each do |model|
+            model.to_s.classify.constantize.class_exec do
+              has_many options[:through], :as => name.to_s.singularize
+              has_many target_class_name.tableize, :through => options[:through]
+            end
+          end
+
+        end
+      end
+				
+      module InstanceMethods
+        #clear array on reload
+        def reload(*args)
+          @records = []
+
+          super args
+        end
+
+      end
+
+    end
   end

data/lib/has_many_polymorphic/version.rb

@@ -1,3 +1,3 @@
-module HasManyPolymorphic
-  VERSION = '0.3.0' unless defined?(::HasManyPolymorphic::VERSION)
+module HasManyPolymorphic
+  VERSION = '0.4.0' unless defined?(::HasManyPolymorphic::VERSION)
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: has_many_polymorphic
 version: !ruby/object:Gem::Version 
-  hash: 19
-  prerelease: 
+  hash: 15
+  prerelease: false
   segments: 
   - 0
-  - 3
+  - 4
   - 0
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors: 
 - Russell Holmes
@@ -15,7 +15,8 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-08-24 00:00:00 Z
+date: 2011-08-24 00:00:00 -04:00
+default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: activerecord
@@ -48,6 +49,7 @@ files:
 - lib/has_many_polymorphic.rb
 - MIT-LICENSE.txt
 - README.rdoc
+has_rdoc: true
 homepage: https://github.com/russ1985/has_many_polymorphic
 licenses: []
 
@@ -77,7 +79,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.8.6
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Simple replacement for has_many_polymorphs