my_john_deere_api 2.1.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b404eb35593809c27e7f5932317e89a182416efbbf5c9ab017a2eb98a0a2b28a
-  data.tar.gz: 6b051603fecfa6893230de4fb2a4e5828b4e42ebd4ed59709e46e5681888964a
+  metadata.gz: 3f611ef5d6785246196c22bc5e453374da5a4a513a689ad649ba1907de39c93f
+  data.tar.gz: 773b32b36229740d1d7885f4e8728cff83f32cb7b19d1ae65847b1bbdd8bea4a
 SHA512:
-  metadata.gz: 0b46d15e4f6e5321eed51f4855a10aa618c3637dc7179faae2e4545d7dc3eec41aceaf4f5c08642257f550b60ae2bdfd44d6161be4bd97ae7be150c7eb0617e6
-  data.tar.gz: 05faaa3f5d5784797a53a96c2dea408fdc844b8c14120054c6ff9f6e594de3a1278aece5fc3ac13e03bc3e7a4290f381131a4e3f28bd2dd3fe0f2e9795e5ab09
+  metadata.gz: 7cd73bbcea8e2615b5bbf4bbf4c91531a991b5c09566f1e7917fbb77d26309b9d4b8f5c532f081c3dd0f463e004ea716f687b2a953420798a7f71f98ee5de16e
+  data.tar.gz: 316d9852d79c9f86c6ec55b6bf5417dcaf47ca06da5eb391b79e19d18c9e20541c625aaa098102dec981ade2e503c673f10267a263069d2f355fcdd06ff46a11

data/README.md

@@ -154,6 +154,7 @@ client
         |   ├── all
         |   ├── first
         |   └── find(asset_id)
+        |       ├── save
         |       ├── update(attributes)
         |       └── locations
         |           ├── create(attributes)
@@ -381,6 +382,14 @@ asset.title
 # => 'New Title', also John Deere record is updated
 ```
 
+The `save` method updates John Deere with any local changes that have been made.
+
+```ruby
+asset.title = 'New Title'
+asset.save
+# => Successful Net::HTTPNoContent object
+```
+
 
 ### Direct API Requests
 

data/lib/my_john_deere_api/model/asset.rb

@@ -18,6 +18,24 @@ module MyJohnDeereApi
       }
     end
 
+    ##
+    # Change the title, locally
+
+    def title=(value)
+      mark_as_unsaved
+      @title = value
+    end
+
+    ##
+    # Save any attribute changes to John Deere
+
+    def save
+      if unsaved?
+        mark_as_saved
+        Request::Update::Asset.new(client, self, attributes).request
+      end
+    end
+
     ##
     # Update the attributes in John Deere
 

data/lib/my_john_deere_api/model/base.rb

@@ -21,6 +21,7 @@ module MyJohnDeereApi
       @id = record['id']
       @record_type = record['@type']
       @client = client
+      @unsaved = false
 
       map_attributes(record)
 
@@ -65,5 +66,32 @@ module MyJohnDeereApi
         raise TypeMismatchError, "Expected record of type '#{expected_record_type}', but received type '#{type}'"
       end
     end
+
+    ##
+    # Mark as unsaved, so we know to save it later
+
+    def mark_as_unsaved
+      @unsaved = true
+    end
+
+    ##
+    # Mark as saved, so we don't try to save it later
+
+    def mark_as_saved
+      @unsaved = false
+    end
+
+    ##
+    # Are changes to this model synced with JD?
+    def saved?
+      !@unsaved
+    end
+
+    ##
+    # Are there pending changes to send to JD?
+
+    def unsaved?
+      @unsaved
+    end
   end
 end

data/lib/my_john_deere_api/version.rb

@@ -1,3 +1,3 @@
 module MyJohnDeereApi
-  VERSION='2.1.1'
+  VERSION='2.2.0'
 end

data/test/lib/my_john_deere_api/model/asset_test.rb

@@ -65,6 +65,37 @@ describe 'MyJohnDeereApi::Model::Asset' do
     end
   end
 
+  describe '#save' do
+    it 'sends any recent updates to John Deere' do
+      asset = klass.new(record, client)
+      new_title = 'i REALLY like turtles!'
+
+      asset.title = new_title
+      assert_equal new_title, asset.title
+
+      response = VCR.use_cassette('put_asset') { asset.save }
+      assert_kind_of Net::HTTPNoContent, response
+    end
+
+    it 'does not make a JD request if nothing has changed' do
+      asset = klass.new(record, client)
+      response = asset.save
+
+      assert_nil response
+    end
+
+    it 'marks the record as saved' do
+      asset = klass.new(record, client)
+      asset.title = 'i REALLY like turtles!'
+
+      response = VCR.use_cassette('put_asset') { asset.save }
+      assert_kind_of Net::HTTPNoContent, response
+
+      response = asset.save
+      assert_nil response
+    end
+  end
+
   describe '#update' do
     it 'updates the attributes' do
       asset = klass.new(record, client)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: my_john_deere_api
 version: !ruby/object:Gem::Version
-  version: 2.1.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Jaime Bellmyer