o_patch 0.0.1 → 0.0.2

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    N2EzZDY2NDZjYWM5NTFmMzA1OWVjNmE0MmU4YTE3NzQzZmZiNzA2YQ==
-  data.tar.gz: !binary |-
-    MTBmOTIzNmQ0NjhlMzcyY2I4ZGI2NWM1MjE4YThkYTM4ZTc1NTk2MA==
+SHA1:
+  metadata.gz: 2acac7437a2fda4c9d014ce2aea3f2c6ee7fd927
+  data.tar.gz: 33f410f04aae3cc1ad121c814309d13b380fde43
 SHA512:
-  metadata.gz: !binary |-
-    ZDFmM2Q2OTJkZTgzNTFiNTM1ZmMzZTFlMTQ3ZGNhYTFkZWIxOGQ1NDQ1YmIy
-    NTRhMDY0NjliYTI1MzgxZDk4NjNhMzQ1MzI3NzFiYjRiMzU5ZDk4MTc5MDU0
-    ODFkMjI5MmVjMWMxZGZlODMxODVjOWU0ZTE4OWQyN2VjNDE0NmE=
-  data.tar.gz: !binary |-
-    NGRmYTFiZDEyYWVkN2E0ZDlkYTEwMTdkZmNlYTkxYWM2ZDZkZWExZTVmODVk
-    YjllZTI3YzY5NTYxMzU5Nzk4ZTBjNzQ3MmNiMjcyYzAxZDkyZTBlY2JhMWQ5
-    NTIxYmU2NjBkNzQ1MWMzZjQ5ZmZlNWY4ZTFkMDg1NjYxMzI2MTk=
+  metadata.gz: 89e83a940dcad0c3b670ba7b7d80033ab3a0495d8d871c282d6669bf46c4719db26031961e6d8548265ad2c557085998d1014147981040253ba776268fba38d2
+  data.tar.gz: 1856749f67be4da20d40aa9e3f014964d46c20faed70273e053bf59fd36dfda7c2eee54f4f52a2a4a8b6073471e383183109727d5157fb038e06facca597c030

data/.gitignore

@@ -1,3 +1,4 @@
 /.bundle
 /vendor/bundle
 .DS_Store
+/pkg

data/.travis.yml

@@ -0,0 +1,3 @@
+rvm:
+- 2.0.0
+script: "bundle exec rspec spec/"

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    o_patch (0.0.1)
+    o_patch (0.0.2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,4 +1,89 @@
-opatch
-======
+# OPatch [![Build Status](https://travis-ci.org/AlbertGazizov/opatch.png)](https://travis-ci.org/AlbertGazizov/opatch) [![Code Climate](https://codeclimate.com/github/AlbertGazizov/opatch.png)](https://codeclimate.com/github/AlbertGazizov/opatch)
+
+
+
+OPatch is ruby objects patcher in declarative way. By providing simple DSL it allows you write complex patch logic with ease
+
+## Usage
+Let's say you have the folowing plain ruby classes:
+```ruby
+  class Person
+    attr_accessor :name, :address
+
+    def initialize(name:, address: nil)
+      @name = name
+      @address = address
+    end
+  end
+
+  class Address
+    attr_accessor :city, :country
+
+    def initialize(city:, country:)
+      @city = city
+      @country = country
+    end
+  end
+```
+And you have the following instance of the Person class:
+```ruby
+  person = Person.new(name: "John Smith", address: Address.new(city: "Kazan", country: "Russia"))
+```
+Now you want to update person's name and address fields, let's use OPatch for that.
+You need to call OPatch with attributes you want to update:
+```ruby
+  new_attributes = { name: "Jim White", address: { country: "USA", city: "New York" } }
+  OPatch.patch(person, new_attributes) do
+    field  :name
+    object :address do
+      field :country
+      field :city
+    end
+  end
+```
+That's all! Now you have the person updated:
+```ruby
+  => #<Person:0x007f8bc42487c0 @name="Jim White", @address=#<Address:0x007f8bc4248838 @city="New York", @country="USA">>
+```
+
+### Creating nested objects
+Opatch allows you to build nested objects if you specify build block.
+Lets see how it works if we want to build address when it wasn't created initialilly:
+```ruby
+  person = Person.new(name: "John Smith")
+  => #<Person:0x007f8bc40239e0 @name="John Smith", @address=nil>
+```
+```ruby
+  new_attributes = { address: { country: "USA", city: "New York" } }
+  OPatch.patch(person, new_attributes) do
+    field  :name
+    object :address, build: proc { |person, attributes| person.address = Address.new(attributes) }  do
+      field :country
+      field :city
+    end
+  end
+```
+```ruby
+  => #<Person:0x007f8bc4130590 @name="John Smith", @address=#<Address:0x007f8bc4049a28 @city="New York", @country="USA">>
+```
+
+
+### Deleting nested objects
+If you provide nil for the nested object the object will be removed:
+```ruby
+  person = Person.new(name: "John Smith", address: Address.new(city: "Kazan", country: "Russia"))
+
+  OPatch.patch(person, name: 'Vasya', address: nil) do
+    field  :name
+    object :address do
+      field :country
+      field :city
+    end
+  end
+
+  => #<Person:0x007f8bc400a850 @name="Vasya", @address=nil>
+```
+
+### Author
+Albert Gazizov, [@deeper4k](https://twitter.com/deeper4k)
 
-Declarative ruby objects patcher

data/lib/o_patch/patcher.rb

@@ -56,12 +56,12 @@ class OPatch::Patcher
       attributes[collection_name].each do |child_attributes|
         key_value = attributes_key_value(child_attributes, key)
         if key_value
-          child_object = collection_hash[key_value].first
+          child_object = (collection_hash[key_value] || []).first
           raise "#{collection_name} don't have an object with key: #{key_value}" unless child_object
           if child_attributes[:_destroy]
             collection.delete(child_object)
           else
-            self.class.patch(child_object, child_attributes, &block)
+            self.class.patch(child_object, child_attributes, &block) if block_given?
           end
         else
           build_block.call(entity, child_attributes)

data/o_patch.gemspec

@@ -3,7 +3,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = "o_patch"
-  spec.version       = "0.0.1"
+  spec.version       = "0.0.2"
   spec.authors       = ["Albert Gazizov"]
   spec.description   = %q{Declarative ruby objects patcher}
   spec.summary       = %q{Declarative ruby objects patcher}

metadata

@@ -1,50 +1,51 @@
 --- !ruby/object:Gem::Specification
 name: o_patch
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Albert Gazizov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-28 00:00:00.000000000 Z
+date: 2015-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  type: :development
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
-  name: bundler
+  type: :development
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
-  prerelease: false
 - !ruby/object:Gem::Dependency
-  type: :development
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  name: rake
+  type: :development
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  prerelease: false
 description: Declarative ruby objects patcher
 email: 
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
+- ".travis.yml"
 - Gemfile
 - Gemfile.lock
 - LICENSE
@@ -64,17 +65,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.1
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Declarative ruby objects patcher