deep_cloning 2.0.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Jan De Poorter
+
+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

@@ -0,0 +1,28 @@
+= Deep Cloning Plugin
+
+This plugin gives every ActiveRecord::Base object the possibility to do a deep clone.
+
+Repository is on github: http://github.com/DefV/deep_cloning/tree/master
+
+Install with:
+  script/plugin install git://github.com/DefV/deep_cloning.git
+
+== Example
+
+=== Cloning a model without an attribute
+   pirate.dup :except => :name
+ 
+=== Cloning a model without multiple attributes
+   pirate.dup :except => [:name, :nick_name]
+=== Cloning one single association
+   pirate.dup :include => :mateys
+
+=== Cloning multiple associations
+   pirate.dup :include => [:mateys, :treasures]
+
+=== Cloning really deep
+   pirate.dup :include => {:treasures => :gold_pieces}
+
+=== Cloning really deep with multiple associations
+   pirate.dup :include => [:mateys, {:treasures => :gold_pieces}]
+Copyright (c) 2008 Jan De Poorter, released under the MIT license

data/lib/deep_cloning.rb

@@ -0,0 +1,61 @@
+# DeepCloning
+
+module DeepCloning
+  def self.included(base) #:nodoc:
+    base.alias_method_chain :dup, :deep_cloning
+  end
+
+  # dups an ActiveRecord model. 
+  # if passed the :include option, it will deep dup the given associations
+  # if passed the :except option, it won't dup the given attributes
+  #
+  # === Usage:
+  # 
+  # ==== Cloning a model without an attribute
+  #   pirate.dup :except => :name
+  # 
+  # ==== Cloning a model without multiple attributes
+  #   pirate.dup :except => [:name, :nick_name]
+  # ==== Cloning one single association
+  #   pirate.dup :include => :mateys
+  #
+  # ==== Cloning multiple associations
+  #   pirate.dup :include => [:mateys, :treasures]
+  #
+  # ==== Cloning really deep
+  #   pirate.dup :include => {:treasures => :gold_pieces}
+  #
+  # ==== Cloning really deep with multiple associations
+  #   pirate.dup :include => [:mateys, {:treasures => :gold_pieces}]
+  #
+  def dup_with_deep_cloning options = {}
+    kopy = dup_without_deep_cloning()
+    
+    if options[:except]
+      Array(options[:except]).each do |attribute|
+        kopy.send("#{attribute}=", self.class.column_defaults[attribute.to_s])
+      end
+    end
+    
+    if options[:include]
+      Array(options[:include]).each do |association, deep_associations|
+        if (association.kind_of? Hash)
+          deep_associations = association[association.keys.first]
+          association = association.keys.first
+        end
+        opts = deep_associations.blank? ? {} : {:include => deep_associations}
+        cloned_object = case self.class.reflect_on_association(association).macro
+                        when :belongs_to, :has_one
+                          self.send(association) && self.send(association).dup(opts)
+                        when :has_many, :has_and_belongs_to_many
+                          self.send(association).collect { |obj| obj.dup(opts) }
+                        end
+        kopy.send("#{association}=", cloned_object)
+      end
+    end
+
+    return kopy
+  end
+end
+
+ActiveRecord::Base.send :include, DeepCloning

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: deep_cloning
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Jan De Poorter
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-06 00:00:00.000000000 Z
+dependencies: []
+description: Allows you to dup an ActiveRecord object with selectively keeping attributes
+  / associations with :include, :exclude, ...
+email: jan@sumocoders.be
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/deep_cloning.rb
+- MIT-LICENSE
+- README.rdoc
+homepage: https://github.com/defv/deep_cloning
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Easily duplicate ActiveRecord objects
+test_files: []