lhs 12.1.0 → 12.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3a3fd78d0dd9d0ee88751c3b0ba15652bd4a15d9
-  data.tar.gz: 0629f8dfc7068fa195ce3fc5d556313b59c0a713
+  metadata.gz: 73ccff4b48445ae9b548d688af83448b607dd635
+  data.tar.gz: d786114a63d3d8d8eeb87495d84e1823c0cfcd50
 SHA512:
-  metadata.gz: 9042c4d3e3d7b70be32018087fef6c1b472de591048b19866aad7f2fa9098e223490f318b5527a3e53708a0e591419bb0f77f47650df5c1c1f26f5ffd5b38b1e
-  data.tar.gz: 8c0571a35bcacaa09ccd58fa729b083e84d1613cee295cfec64208c1d130d9615c1e9b32cc92ab36978e8e82722316d063baf4baa806c8c5b8e0df6d6b6b018e
+  metadata.gz: a2320ec4f39b5255536ab3d5a1819aac8919b4199e852b8968e3866d5a7144edb53c3a64ccdce11b4627de8bd990b360b5a5069f7ac4ac95624235e7aa5b5d38
+  data.tar.gz: 03af49fcdce27f7000e3446429f532b2d005dcc1de19cc17e1de177da534cb859e8dfba6ea29c9cfe49b32007e338a82c975c0304ce8b0686e0a179a56407396

data/README.md

@@ -670,6 +670,28 @@ record = Record.find('1z-5r1fkaj')
 record.update(recommended: false)
 ```
 
+## Becomes
+
+Based on [ActiveRecord's implementation](http://api.rubyonrails.org/classes/ActiveRecord/Persistence.html#method-i-becomes), LHS implements `becomes`, too.
+It's a way to convert records of a certain type A to another certain type B.
+
+_NOTE: RPC-style actions, that are discouraged in REST anyway, are utilizable with this functionality, too. See the following example:_ 
+
+```ruby
+class Location < LHS::Record
+  endpoint 'http://sync/locations'
+  endpoint 'http://sync/locations/:id'
+end
+
+class Synchronization < LHS::Record
+  endpoint 'http://sync/locations/:id/sync'
+end
+
+location = Location.find(1)
+synchronization = location.becomes(Synchronization)
+synchronization.save!
+```
+
 ## Destroy
 
 You can delete records remotely by calling `destroy` on an LHS::Record.

data/lib/lhs/concerns/item/becomes.rb

@@ -0,0 +1,12 @@
+require 'active_support'
+
+class LHS::Item < LHS::Proxy
+
+  module Becomes
+    extend ActiveSupport::Concern
+
+    def becomes(klass)
+      klass.new(_raw)
+    end
+  end
+end

data/lib/lhs/item.rb

@@ -1,6 +1,8 @@
 # An item is a concrete record.
 # It can be part of another proxy like collection.
 class LHS::Item < LHS::Proxy
+  autoload :Becomes,
+    'lhs/concerns/item/becomes'
   autoload :Destroy,
     'lhs/concerns/item/destroy'
   autoload :Save,
@@ -10,6 +12,7 @@ class LHS::Item < LHS::Proxy
   autoload :Validation,
     'lhs/concerns/item/validation'
 
+  include Becomes
   include Create
   include Destroy
   include Save

data/lib/lhs/version.rb

@@ -1,3 +1,3 @@
 module LHS
-  VERSION = "12.1.0"
+  VERSION = "12.2.0"
 end

data/spec/item/becomes_spec.rb

@@ -0,0 +1,36 @@
+require 'rails_helper'
+
+describe LHS::Item do
+  before(:each) do
+    class Location < LHS::Record
+      endpoint 'http://sync/locations'
+      endpoint 'http://sync/locations/:id'
+    end
+
+    class Synchronization < LHS::Record
+      endpoint 'http://sync/locations/:id/sync'
+    end
+
+    stub_request(:get, "http://sync/locations/1")
+      .to_return(body: {
+        id: 1,
+        name: 'localsearch'
+      }.to_json)
+
+    stub_request(:post, "http://sync/locations/1/sync")
+      .with(body: {
+        name: 'localsearch'
+      }.to_json)
+      .to_return(status: 201)
+  end
+
+  context 'convert records from class A to class B' do
+    it "becomes a record of another class" do
+      location = Location.find(1)
+      synchronization = location.becomes(Synchronization)
+      expect(synchronization).to be_kind_of(Synchronization)
+      synchronization.save!
+      expect(synchronization).to be_kind_of(Synchronization)
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lhs
 version: !ruby/object:Gem::Version
-  version: 12.1.0
+  version: 12.2.0
 platform: ruby
 authors:
 - https://github.com/local-ch/lhs/graphs/contributors
@@ -205,6 +205,7 @@ files:
 - lib/lhs/concerns/data/json.rb
 - lib/lhs/concerns/data/to_hash.rb
 - lib/lhs/concerns/inspect.rb
+- lib/lhs/concerns/item/becomes.rb
 - lib/lhs/concerns/item/destroy.rb
 - lib/lhs/concerns/item/save.rb
 - lib/lhs/concerns/item/update.rb
@@ -316,6 +317,7 @@ files:
 - spec/endpoint/for_url_spec.rb
 - spec/item/accessors_spec.rb
 - spec/item/add_error_spec.rb
+- spec/item/becomes_spec.rb
 - spec/item/delegate_spec.rb
 - spec/item/destroy_spec.rb
 - spec/item/dig_spec.rb
@@ -485,6 +487,7 @@ test_files:
 - spec/endpoint/for_url_spec.rb
 - spec/item/accessors_spec.rb
 - spec/item/add_error_spec.rb
+- spec/item/becomes_spec.rb
 - spec/item/delegate_spec.rb
 - spec/item/destroy_spec.rb
 - spec/item/dig_spec.rb