amoeba 2.1.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 057039190fd1b4431eb35d8e6f0911bff75185ad
-  data.tar.gz: 4fa23a784b6eed67fab53bfacda76e9974a796d4
+  metadata.gz: 8ef5bca881e5bca87a026e6ec8c6094df2542013
+  data.tar.gz: c452e76e155190c56519de94abf924534ad8b746
 SHA512:
-  metadata.gz: 77579cc4fa532edeaa0637a10ea5f34b8639bea7c5262a6165efc441a4ea7a5d2d2e8cc5c24fcb4af99e801d93c2e454ec08ebed7db8f1dffc28fb3206c11eb3
-  data.tar.gz: ce4a34f97cc598c79ce74add51e1acacd0e8f8eb024ee7fc7c4352c88f1cce9a9f129c893078ba3f0391fbe3503916cedb40202802199286026c975c93cc470b
+  metadata.gz: 7db1e43070c41e05c211962fc7d720b3cecc9ba681f8302b8ba6daae29b6fa94390adff0863970b394a9032b45471cb231227ecd2670039e83f2799884ec6be4
+  data.tar.gz: 850f23a3ae73ab859cff8540110f668e5b54d06757bb6954fed09a61f7c681ea7114c292f755d50f3563318b184d5e912a533b90b155f47aecbedc09c9a51b22

data/.cane

@@ -0,0 +1,4 @@
+--no-doc
+--style-measure 99
+--abc-max 5
+--style-exclude spec/**/*

data/.gitignore

@@ -4,3 +4,5 @@ Gemfile*.lock
 pkg/*
 spec/test.sqlite3
 coverage
+.idea
+gemfiles/*.lock

data/.rubocop.yml

@@ -0,0 +1,17 @@
+AllCops:
+  Include:
+    - '**/Rakefile'
+  Exclude:
+    - 'spec/**/*'
+Metrics/LineLength:
+  Max: 99
+Style/FileName:
+  Enabled: false
+Style/ModuleFunction:
+  Enabled: false
+Style/Encoding:
+  Enabled: false
+Documentation:
+  Enabled: false
+Metrics/MethodLength:
+  Max: 15

data/.travis.yml

@@ -1,11 +1,19 @@
 language: ruby
 rvm:
-  - 1.9.3
-  - 1.9.2
   - 2.0.0
+  - 2.1
+  - 2.2
   - ruby-head
   - jruby-19mode # JRuby in 1.9 mode
-  - rbx-19mode
+  - rbx-2
 gemfile:
-  - gemfiles/Gemfile.rails-3.2.x
-  - Gemfile
+  - gemfiles/activerecord_3.2.gemfile
+  - gemfiles/activerecord_4.0.gemfile
+  - gemfiles/activerecord_4.1.gemfile
+  - gemfiles/activerecord_4.2.gemfile
+  - gemfiles/activerecord_head.gemfile
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-19mode
+bundler_args: --without local_development

data/Appraisals

@@ -0,0 +1,24 @@
+appraise 'activerecord-3.2' do
+  gem 'activerecord', '~> 3.2.0'
+end
+
+appraise 'activerecord-4.0' do
+  gem 'activerecord', '~> 4.0.0'
+end
+
+appraise 'activerecord-4.1' do
+  gem 'activerecord', '~> 4.1.0'
+end
+
+appraise 'activerecord-4.2' do
+  gem 'activerecord', '~> 4.2.0'
+end
+
+appraise 'activerecord-head' do
+  git 'git://github.com/rails/arel.git' do
+    gem 'arel'
+  end
+  git 'git://github.com/rails/rails.git' do
+    gem 'activerecord'
+  end
+end

data/Gemfile

@@ -1,10 +1,12 @@
-source "http://rubygems.org"
-
-# Specify your gem's dependencies in power_dup.gemspec
+source 'https://rubygems.org'
 gemspec
-gem 'activerecord', '~> 4.1.2'
 
 group :development, :test do
   gem 'rake'
   gem 'coveralls', require: false
 end
+
+group :local_development do
+  gem 'pry'
+  gem 'appraisal'
+end

data/README.md

@@ -1,12 +1,8 @@
-# IMPORTANT NEWS
+# Amoeba
 
-* As of December 11th, 2012 Amoeba no longer overrides the built in `ActiveRecord::Base#dup` method and instead implements its own method called `amoeba_dup`. Make sure to update your code if you do a bundle update and or double check that your gemfile has a version restriction bound to v1.x e.g. '~> 1.2' listed for amoeba.
+Easy cloning of active_record objects including associations and several operations under associations and attributes.
 
-## Amoeba
-
-Easy copying of rails associations such as `has_many`.
-
-![amoebalogo](http://rocksolidwebdesign.com/wp_cms/wp-content/uploads/2012/02/amoeba_logo.jpg)
+[![Code Climate](https://codeclimate.com/github/rocksolidwebdesign/amoeba/badges/gpa.svg)](https://codeclimate.com/github/rocksolidwebdesign/amoeba)
 
 ## What?
 
@@ -18,7 +14,7 @@ This gem is named "Amoeba" because amoebas are (small life forms that are) good
 
 An ActiveRecord extension gem to allow the duplication of associated child record objects when duplicating an active record model.
 
-Rails 3.2 compatible.
+Rails 3.2, 4.x compatible.
 
 ### Features
 
@@ -116,8 +112,8 @@ If you only want some of the associations copied but not others, you may use the
 
       amoeba do
         enable
-        include_field :tags
-        include_field :authors
+        include_association :tags
+        include_association :authors
       end
     end
 
@@ -133,8 +129,8 @@ Using the inclusive style within the amoeba block actually implies that you wish
       has_many :authors
 
       amoeba do
-        include_field :tags
-        include_field :authors
+        include_association :tags
+        include_association :authors
       end
     end
 
@@ -142,7 +138,7 @@ Using the inclusive style within the amoeba block actually implies that you wish
       belongs_to :post
     end
 
-You may also specify fields to be copied by passing an array. If you call the `include_field` with a single value, it will be appended to the list of already included fields. If you pass an array, your array will overwrite the original values.
+You may also specify fields to be copied by passing an array. If you call the `include_association` with a single value, it will be appended to the list of already included fields. If you pass an array, your array will overwrite the original values.
 
     class Post < ActiveRecord::Base
       has_many :comments
@@ -150,7 +146,7 @@ You may also specify fields to be copied by passing an array. If you call the `i
       has_many :authors
 
       amoeba do
-        include_field [:tags, :authors]
+        include_association [:tags, :authors]
       end
     end
 
@@ -172,7 +168,7 @@ If you have more fields to include than to exclude, you may wish to shorten the
       has_many :authors
 
       amoeba do
-        exclude_field :comments
+        exclude_association :comments
       end
     end
 
@@ -182,7 +178,7 @@ If you have more fields to include than to exclude, you may wish to shorten the
 
 This example does the same thing as the inclusive style example, it will copy the post's tags and authors but not its comments. As with inclusive style, there is no need to explicitly enable amoeba when specifying fields to exclude.
 
-The exclusive style, when used, will automatically disable any other style that was previously selected, so if you selected include fields, and then you choose some exclude fields, the `exclude_field` method will disable the previously slected inclusive style and wipe out any corresponding include fields.
+The exclusive style, when used, will automatically disable any other style that was previously selected, so if you selected include fields, and then you choose some exclude fields, the `exclude_association` method will disable the previously slected inclusive style and wipe out any corresponding include fields.
 
 #### Cloning
 
@@ -218,7 +214,7 @@ This example will actually duplicate the warnings and widgets in the database. I
 
 #### Limiting Association Types
 
-By default, amoeba recognizes and attemps to copy any children of the following association types:
+By default, amoeba recognizes and attempts to copy any children of the following association types:
 
  - has one
  - has many
@@ -346,7 +342,7 @@ or this, using an array:
       has_and_belongs_to_many :tags
 
       amoeba do
-        include_field :tags
+        include_association :tags
 
         customize([
           lambda do |orig_obj,copy_of_obj|
@@ -413,11 +409,11 @@ This example should result in something like this:
     new_post.title # "Copy of Hello world"
     new_post.contents # "Original contents: I like cats, cats are awesome. (copied version)"
 
-Like `nullify`, the preprocessing directives do not automatically enable the copying of associated child records. If only preprocessing directives are used and you do want to copy child records and no `include_field` or `exclude_field` list is provided, you must still explicitly enable the copying of child records by calling the enable method from within the amoeba block on your model.
+Like `nullify`, the preprocessing directives do not automatically enable the copying of associated child records. If only preprocessing directives are used and you do want to copy child records and no `include_association` or `exclude_association` list is provided, you must still explicitly enable the copying of child records by calling the enable method from within the amoeba block on your model.
 
 ### Precedence
 
-You may use a combination of configuration methods within each model's amoeba block. Recognized association types take precedence over inclusion or exclusion lists. Inclusive style takes precedence over exclusive style, and these two explicit styles take precedence over the indiscriminate style. In other words, if you list fields to copy, amoeba will only copy the fields you list, or only copy the fields you don't exclude as the case may be. Additionally, if a field type is not recognized it will not be copied, regardless of whether it appears in an inclusion list. If you want amoeba to automatically copy all of your child records, do not list any fields using either `include_field` or `exclude_field`.
+You may use a combination of configuration methods within each model's amoeba block. Recognized association types take precedence over inclusion or exclusion lists. Inclusive style takes precedence over exclusive style, and these two explicit styles take precedence over the indiscriminate style. In other words, if you list fields to copy, amoeba will only copy the fields you list, or only copy the fields you don't exclude as the case may be. Additionally, if a field type is not recognized it will not be copied, regardless of whether it appears in an inclusion list. If you want amoeba to automatically copy all of your child records, do not list any fields using either `include_association` or `exclude_association`.
 
 The following example syntax is perfectly valid, and will result in the usage of inclusive style. The order in which you call the configuration methods within the amoeba block does not matter:
 
@@ -432,13 +428,13 @@ The following example syntax is perfectly valid, and will result in the usage of
       has_many :authors
 
       amoeba do
-        exclude_field :authors
-        include_field :tags
+        exclude_association :authors
+        include_association :tags
         nullify :date_published
         prepend :title => "Copy of "
         append :contents => " (copied version)"
         regex :contents => {:replace => /dog/, :with => 'cat'}
-        include_field :authors
+        include_association :authors
         enable
         nullify :topic_id
       end
@@ -450,7 +446,7 @@ The following example syntax is perfectly valid, and will result in the usage of
 
 This example will copy all of a post's tags and authors, but not its comments. It will also nullify the publishing date and dissociate the post from its original topic. It will also preprocess the post's fields as in the previous preprocessing example.
 
-Note that, because of precedence, inclusive style is used and the list of exclude fields is never consulted. Additionally, the `enable` method is redundant because amoeba is automatically enabled when using `include_field`.
+Note that, because of precedence, inclusive style is used and the list of exclude fields is never consulted. Additionally, the `enable` method is redundant because amoeba is automatically enabled when using `include_association`.
 
 The preprocessing directives are run after child records are copied andare run in this order.
 
@@ -646,18 +642,18 @@ The `:relaxed` parenting style will prefer parent settings.
       has_and_belongs_to_many :sections
 
       amoeba do
-        exclude_field :images
+        exclude_association :images
         propagate :relaxed
       end
     end
 
     class Shirt < Product
-      include_field :images
-      include_field :sections
+      include_association :images
+      include_association :sections
       prepend :title => "Copy of "
     end
 
-In this example, the conflicting `include_field` settings on the child will be ignored and the parent `exclude_field` setting will be used, while the `prepend` setting on the child will be honored because it doesn't conflict with the parent.
+In this example, the conflicting `include_association` settings on the child will be ignored and the parent `exclude_association` setting will be used, while the `prepend` setting on the child will be honored because it doesn't conflict with the parent.
 
 ##### Strict Parenting
 
@@ -668,18 +664,18 @@ The `:strict` style will ignore child settings altogether and inherit any parent
       has_and_belongs_to_many :sections
 
       amoeba do
-        exclude_field :images
+        exclude_association :images
         propagate :strict
       end
     end
 
     class Shirt < Product
-      include_field :images
-      include_field :sections
+      include_association :images
+      include_association :sections
       prepend :title => "Copy of "
     end
 
-In this example, the only processing that will happen when a Shirt is duplicated is whatever processing is allowed by the parent. So in this case the parent's `exclude_field` directive takes precedence over the child's `include_field` settings, and not only that, but none of the other settings for the child are used either. The `prepend` setting of the child is completely ignored.
+In this example, the only processing that will happen when a Shirt is duplicated is whatever processing is allowed by the parent. So in this case the parent's `exclude_association` directive takes precedence over the child's `include_association` settings, and not only that, but none of the other settings for the child are used either. The `prepend` setting of the child is completely ignored.
 
 ##### Parenting and Precedence
 
@@ -704,13 +700,13 @@ This version will use both the parent and child settings, so both the images and
       has_and_belongs_to_many :sections
 
       amoeba do
-        include_field :images
+        include_association :images
         propagate
       end
     end
 
     class Shirt < Product
-      include_field :sections
+      include_association :sections
     end
 
 The next version will use only the child settings because passing an array will override any previous settings rather than adding to them and the child config takes precedence in the `submissive` parenting style. So in this case only the sections will be copied.
@@ -720,13 +716,13 @@ The next version will use only the child settings because passing an array will
       has_and_belongs_to_many :sections
 
       amoeba do
-        include_field :images
+        include_association :images
         propagate
       end
     end
 
     class Shirt < Product
-      include_field [:sections]
+      include_association [:sections]
     end
 
 ##### A Relaxed Override Example
@@ -738,13 +734,13 @@ This version will use both the parent and child settings, so both the images and
       has_and_belongs_to_many :sections
 
       amoeba do
-        include_field :images
+        include_association :images
         propagate :relaxed
       end
     end
 
     class Shirt < Product
-      include_field :sections
+      include_association :sections
     end
 
 The next version will use only the parent settings because passing an array will override any previous settings rather than adding to them and the parent config takes precedence in the `relaxed` parenting style. So in this case only the images will be copied.
@@ -754,13 +750,13 @@ The next version will use only the parent settings because passing an array will
       has_and_belongs_to_many :sections
 
       amoeba do
-        include_field [:images]
+        include_association [:images]
         propagate
       end
     end
 
     class Shirt < Product
-      include_field :sections
+      include_association :sections
     end
 
 ### Validating Nested Attributes
@@ -791,7 +787,7 @@ For example this will throw a validation error saying that your posts are invali
 
     author.save # this will fail validation
 
-Wheras this will work fine:
+Where this will work fine:
 
     class Author < ActiveRecord::Base
       has_many :posts, :inverse_of => :author
@@ -847,21 +843,102 @@ This issue with `accepts_nested_attributes_for` can also be solved by using `:in
 
 The crux of the issue is that upon duplication, the new `Author` instance does not yet have an ID because it has not yet been persisted, so the `:posts` do not yet have an `:author_id` either, and thus no `:author` and thus they will fail validation. This issue may likely affect amoeba usage so if you get some validation failures, be sure to add `:inverse_of` to your models.
 
+
+## Cloning using custom method
+
+If you need to clone model with custom method you can use `through`:
+
+    class ChildPrototype < ActiveRecord::Base
+      amoeba do
+        through :become_child
+      end
+
+      def become_child
+        self.dup.becomes(Child)
+      end
+    end
+
+    class Child < ChildPrototype
+    end
+
+After cloning we will get instance of `Child` instead of `ChildPrototype`
+
+## Remapping associations
+
+If you will need to do complex cloning with remapping associations name you can user `remapper`:
+
+    class ObjectPrototype < ActiveRecord::Base
+      has_many :child_prototypes
+
+      amoeba do
+        method :become_real
+        remapper :remap_associations
+      end
+
+      def become_real
+        self.dup().becomes( RealObject )
+      end
+
+      def remap_associations( name )
+        :childs if name == :child_prototypes
+      end
+    end
+
+    class RealObject < ObjectPrototype
+      has_many :childs
+    end
+
+    class ChildPrototype < ActiveRecord::Base
+      amoeba do
+        method :become_child
+      end
+
+      def become_child
+        self.dup().becomes( Child )
+      end
+    end
+
+    class Child < ChildPrototype
+    end
+
+In result we will get next:
+
+    prototype = ObjectPrototype.new
+    prototype.child_prototypes << ChildPrototype.new
+    object = prototype.amoeba_dup
+    object.class # => RealObject
+    object.childs.first.class #=> Child
+
 ## Configuration Reference
 
 Here is a static reference to the available configuration methods, usable within the amoeba block on your rails models.
 
+### through
+
+ Set method what we will use for cloning model instead of `dup`.
+
+ for example:
+
+    amoeba do
+      through :supper_pupper_dup
+    end
+
+    def supper_pupper_dup
+      puts "multiplied by budding"
+      self.dup
+    end
+
 ### Controlling Associations
 
 #### enable
 
-  Enables amoeba in the default style of copying all known associated child records. Using the enable method is only required if you wish to enable amoeba but you are not using either the `include_field` or `exclude_field` directives. If you use either inclusive or exclusive style, amoeba is automatically enabled for you, so calling `enable` would be redundant, though it won't hurt.
+  Enables amoeba in the default style of copying all known associated child records. Using the enable method is only required if you wish to enable amoeba but you are not using either the `include_association` or `exclude_association` directives. If you use either inclusive or exclusive style, amoeba is automatically enabled for you, so calling `enable` would be redundant, though it won't hurt.
 
-#### include_field
+#### include_association
 
   Adds a field to the list of fields which should be copied. All associations not in this list will not be copied. This method may be called multiple times, once per desired field, or you may pass an array of field names. Passing a single symbol will add to the list of included fields. Passing an array will empty the list and replace it with the array you pass.
 
-#### exclude_field
+#### exclude_association
 
   Adds a field to the list of fields which should not be copied. Only the associations that are not in this list will be copied. This method may be called multiple times, once per desired field, or you may pass an array of field names. Passing a single symbol will add to the list of excluded fields. Passing an array will empty the list and replace it with the array you pass.
 
@@ -897,6 +974,19 @@ Here is a static reference to the available configuration methods, usable within
 
   will choose the relaxed parenting style of inherited settings for this child. A parenting style set via the `raised` method takes precedence over the parenting style set using the `propagate` method.
 
+#### remapper
+
+  Set the method what will be used for remapping of association name. Method will have one argument - association name as Symbol. If method will return nil then association will not be remapped.
+
+  for example:
+      amoeba do
+        remapper :childs_to_parents
+      end
+
+      def childs_to_parents(association_name)
+        :parents if association_name == :childs
+      end
+
 ### Pre-Processing Fields
 
 #### nullify