my_john_deere_api 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 308f6c3b51f2e879f9df9bb1b616947867acd261363aa72e98458f5e6234aa37
-  data.tar.gz: '09257f1b9559a3a5b631f724bf4767151d49b0c6a9ddbc6ded2b024c3063bb8b'
+  metadata.gz: 8f27839609fe2e86e82d918edae99dd77d78cb9d7dad78c061d8ab198837953d
+  data.tar.gz: b302429624cc3f1a504e77235c105f94af9363bc075809f46f1659bf1b59859c
 SHA512:
-  metadata.gz: 6a9f7d5b8303090de1101531ae6b9be02534c1c8d71179117ee5714238ae1ce4d067987a4a324e3a59316a95d7a613ab532c85989c4451109dc6236946be4195
-  data.tar.gz: 369e58fbca78c338cf6e79935037cb154ba1fd5a44385e2623d62ef8a213bb9f60a3c74035efbad066b6a6b414a06e95828702844460890d757b4b6c51fa97d7
+  metadata.gz: 3b2509a126cf7aef80dc4984865660eb20285a4ccbb5aaec61a622449eebc3eb0628d1a44f3de78bfc95af42f639bbecd5a5796219b3d8be3ea4be7612e90b96
+  data.tar.gz: 2b401cacbc5c4fc8e9b224c89639689ceb681d8b697dfdd1b1f3ff62b1b91c5ea40508a2de61ade9ad8744773a90358067e9240faaa3f4088803c3caac1eb196

data/Rakefile

@@ -2,7 +2,7 @@ require 'rake/testtask'
 
 Rake::TestTask.new do |t|
   t.libs << 'test'
-  t.pattern = 'test/**/test*.rb'
+  t.pattern = 'test/**/*_test.rb'
 end
 
 desc "Run tests"

data/lib/my_john_deere_api/helpers/case_conversion.rb

@@ -1,6 +1,8 @@
 require 'uri'
 
 module MyJohnDeereApi::Helpers::CaseConversion
+  private
+
   ##
   # convert a text or camelcase string to underscore
 
@@ -8,8 +10,6 @@ module MyJohnDeereApi::Helpers::CaseConversion
     string.gsub(/([a-z])([A-Z])/, '\1_\2').gsub(/\s+/, '_').gsub(/_+/, '_').downcase
   end
 
-  private :underscore
-
   ##
   # convert text or underscored string to camelcase
 
@@ -22,6 +22,4 @@ module MyJohnDeereApi::Helpers::CaseConversion
 
     new_list.join('')
   end
-
-  private :camelize
 end

data/lib/my_john_deere_api/helpers/uri_helpers.rb

@@ -0,0 +1,19 @@
+require 'uri'
+
+module MyJohnDeereApi::Helpers::UriHelpers
+  private
+
+  ##
+  # extract just the path from the uri, excluding the platform prefix
+  def uri_path(uri)
+    URI.parse(uri).path.gsub(/^\/platform/, '')
+  end
+
+  ##
+  # infer id from uri
+
+  def id_from_uri(uri, label)
+    parts = uri.split('/')
+    parts[parts.index(label.to_s) + 1]
+  end
+end

data/lib/my_john_deere_api/helpers.rb

@@ -1,4 +1,4 @@
 module MyJohnDeereApi::Helpers
-  autoload :UriPath,        'my_john_deere_api/helpers/uri_path'
+  autoload :UriHelpers,        'my_john_deere_api/helpers/uri_helpers'
   autoload :CaseConversion, 'my_john_deere_api/helpers/case_conversion'
 end

data/lib/my_john_deere_api/model/asset.rb

@@ -0,0 +1,43 @@
+module MyJohnDeereApi
+  class Model::Asset
+    include Helpers::UriHelpers
+
+    attr_reader :accessor, :id, :title, :asset_category, :asset_type, :asset_sub_type, :last_modified_date, :links
+
+    ##
+    # arguments:
+    #
+    # [record] a JSON object of type 'Field', returned from the API.
+    #
+    # [accessor (optional)] a valid oAuth Access Token. This is only
+    #                       needed if further API requests are going
+    #                       to be made, as is the case with *flags*.
+
+    def initialize(record, accessor = nil)
+      @accessor = accessor
+
+      @id = record['id']
+      @title = record['title']
+      @asset_category = record['assetCategory']
+      @asset_type = record['assetType']
+      @asset_sub_type = record['assetSubType']
+      @last_modified_date = record['lastModifiedDate']
+
+      @links = {}
+
+      record['links'].each do |association|
+        @links[association['rel']] = uri_path(association['uri'])
+      end
+    end
+
+    ##
+    # locations associated with this asset
+
+    def locations
+      raise AccessTokenError unless accessor
+
+      return @locations if defined?(@locations)
+      @locations = MyJohnDeereApi::Request::Collection::AssetLocations.new(accessor, asset: id).all
+    end
+  end
+end

data/lib/my_john_deere_api/model/asset_location.rb

@@ -0,0 +1,27 @@
+require 'json'
+
+module MyJohnDeereApi
+  class Model::AssetLocation
+    include Helpers::UriHelpers
+
+    attr_reader :accessor, :timestamp, :geometry, :measurement_data, :links
+
+    ##
+    # arguments:
+    #
+    # [record] a JSON object of type 'Field', returned from the API.
+    #
+    # [accessor (optional)] a valid oAuth Access Token. This is only
+    #                       needed if further API requests are going
+    #                       to be made, as is the case with *flags*.
+
+    def initialize(record, accessor = nil)
+      @accessor = accessor
+
+      @timestamp = record['timestamp']
+      @geometry = JSON.parse(record['geometry'])
+      @measurement_data = record['measurementData']
+      @links = {}
+    end
+  end
+end

data/lib/my_john_deere_api/model/field.rb

@@ -1,6 +1,6 @@
 module MyJohnDeereApi
   class Model::Field
-    include Helpers::UriPath
+    include Helpers::UriHelpers
 
     attr_reader :name, :id, :links, :accessor
 
@@ -52,9 +52,7 @@ module MyJohnDeereApi
 
     def organization_id
       return @organization_id if defined?(@organization_id)
-
-      parts = links['self'].split('/')
-      @organization_id = parts[parts.index('organizations') + 1]
+      @organization_id = id_from_uri(links['self'], :organizations)
     end
   end
 end

data/lib/my_john_deere_api/model/flag.rb

@@ -3,7 +3,7 @@ require 'json'
 module MyJohnDeereApi
   class Model::Flag
     include Helpers::CaseConversion
-    include Helpers::UriPath
+    include Helpers::UriHelpers
 
     attr_reader :id, :notes, :geometry, :links, :accessor
 

data/lib/my_john_deere_api/model/organization.rb

@@ -2,7 +2,7 @@ require 'uri'
 
 module MyJohnDeereApi
   class Model::Organization
-    include Helpers::UriPath
+    include Helpers::UriHelpers
 
     attr_reader :name, :type, :id, :links, :accessor
 
@@ -47,5 +47,15 @@ module MyJohnDeereApi
       return @fields if defined?(@fields)
       @fields = MyJohnDeereApi::Request::Collection::Fields.new(accessor, organization: id).all
     end
+
+    ##
+    # assets associated with this organization
+
+    def assets
+      raise AccessTokenError unless accessor
+
+      return @assets if defined?(@assets)
+      @assets = MyJohnDeereApi::Request::Collection::Assets.new(accessor, organization: id).all
+    end
   end
 end

data/lib/my_john_deere_api/model.rb

@@ -1,4 +1,6 @@
 module MyJohnDeereApi::Model
+  autoload :Asset,               'my_john_deere_api/model/asset'
+  autoload :AssetLocation,       'my_john_deere_api/model/asset_location'
   autoload :Organization,        'my_john_deere_api/model/organization'
   autoload :Field,               'my_john_deere_api/model/field'
   autoload :Flag,                'my_john_deere_api/model/flag'

data/lib/my_john_deere_api/request/collection/asset_locations.rb

@@ -0,0 +1,19 @@
+require 'json'
+
+module MyJohnDeereApi::Request
+  class Collection::AssetLocations < Collection::Base
+    ##
+    # The resource path for the first page in the collection
+
+    def resource
+      "/assets/#{associations[:asset]}/locations"
+    end
+
+    ##
+    # This is the class used to model the data
+
+    def model
+      MyJohnDeereApi::Model::AssetLocation
+    end
+  end
+end

data/lib/my_john_deere_api/request/collection/assets.rb

@@ -0,0 +1,19 @@
+require 'json'
+
+module MyJohnDeereApi::Request
+  class Collection::Assets < Collection::Base
+    ##
+    # The resource path for the first page in the collection
+
+    def resource
+      "/organizations/#{associations[:organization]}/assets"
+    end
+
+    ##
+    # This is the class used to model the data
+
+    def model
+      MyJohnDeereApi::Model::Asset
+    end
+  end
+end

data/lib/my_john_deere_api/request/collection/base.rb

@@ -1,7 +1,7 @@
 module MyJohnDeereApi
   class Request::Collection::Base
     include Enumerable
-    include Helpers::UriPath
+    include Helpers::UriHelpers
 
     attr_reader :accessor, :associations
 

data/lib/my_john_deere_api/request/collection.rb

@@ -1,6 +1,8 @@
 module MyJohnDeereApi::Request::Collection
   autoload :Base,                 'my_john_deere_api/request/collection/base'
+  autoload :Assets,               'my_john_deere_api/request/collection/assets'
+  autoload :AssetLocations,       'my_john_deere_api/request/collection/asset_locations'
   autoload :Organizations,        'my_john_deere_api/request/collection/organizations'
   autoload :Fields,               'my_john_deere_api/request/collection/fields'
-  autoload :Flags,               'my_john_deere_api/request/collection/flags'
+  autoload :Flags,                'my_john_deere_api/request/collection/flags'
 end

data/lib/my_john_deere_api/version.rb

@@ -1,3 +1,3 @@
 module MyJohnDeereApi
-  VERSION='0.4.1'
+  VERSION='0.5.0'
 end

data/test/lib/my_john_deere_api/helpers/{test_case_conversion.rb → case_conversion_test.rb}

@@ -2,6 +2,10 @@ require 'support/helper'
 
 class CaseConversionHelperSample
   include JD::Helpers::CaseConversion
+
+  def test
+    'test'
+  end
 end
 
 describe 'Helpers::CaseConversion' do
@@ -29,7 +33,8 @@ describe 'Helpers::CaseConversion' do
     end
 
     it 'is a private method' do
-      assert_raises(NoMethodError) { object.underscore('test') }
+      exception = assert_raises(NoMethodError) { object.underscore('test') }
+      assert_includes exception.message, 'private method'
     end
   end
 
@@ -50,7 +55,12 @@ describe 'Helpers::CaseConversion' do
     end
 
     it 'is a private method' do
-      assert_raises(NoMethodError) { object.camelize('test') }
+      exception = assert_raises(NoMethodError) { object.camelize('test') }
+      assert_includes exception.message, 'private method'
     end
   end
+
+  it "preserves the public nature of the including class's other methods" do
+    assert_equal 'test', object.test
+  end
 end

data/test/lib/my_john_deere_api/helpers/uri_helpers_test.rb

@@ -0,0 +1,58 @@
+require 'support/helper'
+
+class UriHelpersHelperSample
+  include JD::Helpers::UriHelpers
+
+  def test
+    'test'
+  end
+end
+
+describe 'UriHelpers' do
+  let(:object) { UriHelpersHelperSample.new }
+
+  describe '#uri_path' do
+    it 'extracts the path from the uri' do
+      path = object.send(:uri_path, 'https://example.com/turtles')
+      assert_equal '/turtles', path
+    end
+
+    it 'removes leading /platform from the path' do
+      path = object.send(:uri_path, 'https://example.com/platform/turtles')
+      assert_equal '/turtles', path
+    end
+
+    it 'preserves /platform in any other part of the path' do
+      path = object.send(:uri_path, 'https://example.com/platform/turtles/platform')
+      assert_equal '/turtles/platform', path
+    end
+
+    it 'is a private method' do
+      exception = assert_raises(NoMethodError) { object.uri_path('https://example.com/turtles')}
+      assert_includes exception.message, 'private method'
+    end
+  end
+
+  describe '#id_from_uri(uri, label)' do
+    it 'extracts the id immediately following a given label' do
+      uri = 'https://example.com/cows/123/pigs/456/turtles/789/birds/012'
+      assert_equal '789', object.send(:id_from_uri, uri, 'turtles')
+    end
+
+    it 'accepts a symbol for the label' do
+      uri = 'https://example.com/cows/123/pigs/456/turtles/789/birds/012'
+      assert_equal '789', object.send(:id_from_uri, uri, :turtles)
+    end
+
+    it 'is a private method' do
+      uri = 'https://example.com/cows/123/pigs/456/turtles/789/birds/012'
+
+      exception = assert_raises(NoMethodError) { object.id_from_uri(uri, 'turtles') }
+      assert_includes exception.message, 'private method'
+    end
+  end
+
+  it "preserves the public nature of the including class's other methods" do
+    assert_equal 'test', object.test
+  end
+end

data/test/lib/my_john_deere_api/{test_helpers.rb → helpers_test.rb}

@@ -2,8 +2,8 @@ require 'support/helper'
 
 describe 'MyJohnDeereApi::Helpers' do
   describe 'loading dependencies' do
-    it 'loads Helpers::UriPath' do
-      assert JD::Helpers::UriPath
+    it 'loads Helpers::UriHelpers' do
+      assert JD::Helpers::UriHelpers
     end
 
     it 'loads Helpers::CaseConversion' do

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

@@ -0,0 +1,57 @@
+require 'support/helper'
+require 'json'
+
+describe 'MyJohnDeereApi::Model::AssetLocation' do
+  let(:record) do
+    {
+      "@type"=>"ContributedAssetLocation",
+      "timestamp"=>"2017-09-20T21:30:59.000Z",
+      "geometry"=>"{\"type\": \"Feature\",\"geometry\": {\"geometries\": [{\"coordinates\": [ -103.115633, 41.670166],\"type\": \"Point\"}],\"type\": \"GeometryCollection\"}}",
+      "measurementData"=>[
+        {
+          "@type"=>"BasicMeasurement",
+          "name"=>"[1 Foot](https://app.realmfive.com/map?device=0x0080CDEF)",
+          "value"=>"82",
+          "unit"=>"cB"
+        }, {
+          "@type"=>"BasicMeasurement",
+          "name"=>"[2 Feet](https://app.realmfive.com/map?device=0x0080CDEF)",
+          "value"=>"31",
+          "unit"=>"cB"
+        }
+      ],
+      "links"=>[]
+    }
+  end
+
+  let(:client) { JD::Client.new(API_KEY, API_SECRET, environment: :sandbox, access: [ACCESS_TOKEN, ACCESS_SECRET]) }
+  let(:accessor) { VCR.use_cassette('catalog') { client.send(:accessor) } }
+
+  describe '#initialize' do
+    def link_for label
+      record['links'].detect{|link| link['rel'] == label}['uri'].gsub('https://sandboxapi.deere.com/platform', '')
+    end
+
+    it 'sets the attributes from the given record' do
+      location = JD::Model::AssetLocation.new(record)
+
+      assert_nil location.accessor
+
+      # basic attributes
+      assert_equal record['timestamp'], location.timestamp
+      assert_equal JSON.parse(record['geometry']), location.geometry
+      assert_equal record['measurementData'], location.measurement_data
+
+      # links to other things
+      assert_kind_of Hash, location.links
+      assert_equal 0, location.links.size
+    end
+
+    it 'accepts an optional accessor' do
+      accessor = 'mock-accessor'
+
+      location = JD::Model::AssetLocation.new(record, accessor)
+      assert_equal accessor, location.accessor
+    end
+  end
+end

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

@@ -0,0 +1,79 @@
+require 'support/helper'
+
+describe 'MyJohnDeereApi::Model::Asset' do
+  let(:record) do
+    {
+      "@type"=>"ContributedAsset",
+      "title"=>"Happy Device",
+      "assetCategory"=>"DEVICE",
+      "assetType"=>"SENSOR",
+      "assetSubType"=>"OTHER",
+      "id"=>"123456",
+      "lastModifiedDate"=>"2018-01-31T20:36:16.727Z",
+      "links"=>[
+        {"@type"=>"Link", "rel"=>"self", "uri"=>"https://sandboxapi.deere.com/platform/assets/123456"},
+        {"@type"=>"Link", "rel"=>"organization", "uri"=>"https://sandboxapi.deere.com/platform/organizations/234567"},
+        {"@type"=>"Link", "rel"=>"locations", "uri"=>"https://sandboxapi.deere.com/platform/assets/123456/locations"},
+      ]
+    }
+  end
+
+  let(:client) { JD::Client.new(API_KEY, API_SECRET, environment: :sandbox, access: [ACCESS_TOKEN, ACCESS_SECRET]) }
+  let(:accessor) { VCR.use_cassette('catalog') { client.send(:accessor) } }
+
+  describe '#initialize' do
+    def link_for label
+      record['links'].detect{|link| link['rel'] == label}['uri'].gsub('https://sandboxapi.deere.com/platform', '')
+    end
+
+    it 'sets the attributes from the given record' do
+      asset = JD::Model::Asset.new(record)
+
+      assert_nil asset.accessor
+
+      # basic attributes
+      assert_equal record['id'], asset.id
+      assert_equal record['title'], asset.title
+      assert_equal record['assetCategory'], asset.asset_category
+      assert_equal record['assetType'], asset.asset_type
+      assert_equal record['assetSubType'], asset.asset_sub_type
+      assert_equal record['lastModifiedDate'], asset.last_modified_date
+
+      # links to other things
+      assert_kind_of Hash, asset.links
+
+      ['self', 'organization', 'locations'].each do |association|
+        assert_equal link_for(association), asset.links[association]
+      end
+    end
+
+    it 'accepts an optional accessor' do
+      accessor = 'mock-accessor'
+
+      asset = JD::Model::Asset.new(record, accessor)
+      assert_equal accessor, asset.accessor
+    end
+  end
+
+  describe '#locations' do
+    it 'returns a collection of locations for this asset' do
+      accessor
+      organization = VCR.use_cassette('get_organizations') { client.organizations.first }
+      asset = VCR.use_cassette('get_assets') { organization.assets.first }
+      locations = VCR.use_cassette('get_asset_locations') { asset.locations }
+
+      assert_kind_of Array, locations
+
+      locations.each do |location|
+        assert_kind_of JD::Model::AssetLocation, location
+      end
+    end
+
+    it 'raises an exception if an accessor is not available' do
+      asset = JD::Model::Asset.new(record)
+
+      exception = assert_raises(JD::AccessTokenError) { asset.locations }
+      assert_includes exception.message, 'Access Token must be supplied'
+    end
+  end
+end

data/test/lib/my_john_deere_api/model/{test_field.rb → field_test.rb}

@@ -71,4 +71,11 @@ describe 'MyJohnDeereApi::Model::Field' do
       assert_includes exception.message, 'Access Token must be supplied'
     end
   end
+
+  describe 'private #organization_id' do
+    it "infers the organization_id from links" do
+      field = JD::Model::Field.new(record)
+      assert_equal '123456', field.send(:organization_id)
+    end
+  end
 end

data/test/lib/my_john_deere_api/model/{test_organization.rb → organization_test.rb}

@@ -83,4 +83,25 @@ describe 'MyJohnDeereApi::Model::Organization' do
       assert_includes exception.message, 'Access Token must be supplied'
     end
   end
+
+  describe '#assets' do
+    it 'returns a collection of assets for this organization' do
+      accessor
+      organization = VCR.use_cassette('get_organizations') { client.organizations.first }
+      assets = VCR.use_cassette('get_assets') { organization.assets }
+
+      assert_kind_of Array, assets
+
+      assets.each do |assets|
+        assert_kind_of JD::Model::Asset, assets
+      end
+    end
+
+    it 'raises an exception if an accessor is not available' do
+      organization = JD::Model::Organization.new(record)
+
+      exception = assert_raises(JD::AccessTokenError) { organization.assets }
+      assert_includes exception.message, 'Access Token must be supplied'
+    end
+  end
 end

data/test/lib/my_john_deere_api/{test_model.rb → model_test.rb}

@@ -2,6 +2,14 @@ require 'support/helper'
 
 describe 'MyJohnDeereApi::Model' do
   describe 'loading dependencies' do
+    it 'loads Model::Asset' do
+      assert JD::Model::Asset
+    end
+
+    it 'loads Model::AssetLocation' do
+      assert JD::Model::AssetLocation
+    end
+
     it 'loads Model::Organization' do
       assert JD::Model::Organization
     end

data/test/lib/my_john_deere_api/request/collection/asset_locations_test.rb

@@ -0,0 +1,85 @@
+require 'support/helper'
+require 'yaml'
+require 'json'
+
+describe 'MyJohnDeereApi::Request::Collection::AssetLocations' do
+  let(:asset_id) do
+    contents = File.read('test/support/vcr/get_assets.yml')
+    body = YAML.load(contents)['http_interactions'].first['response']['body']['string']
+    JSON.parse(body)['values'].first['id']
+  end
+
+  let(:client) { JD::Client.new(API_KEY, API_SECRET, environment: :sandbox, access: [ACCESS_TOKEN, ACCESS_SECRET]) }
+  let(:accessor) { VCR.use_cassette('catalog') { client.send(:accessor) } }
+  let(:collection) { JD::Request::Collection::AssetLocations.new(accessor, asset: asset_id) }
+
+  describe '#initialize(access_token)' do
+    it 'accepts an access token' do
+      assert_kind_of OAuth::AccessToken, collection.accessor
+    end
+
+    it 'accepts associations' do
+      collection = JD::Request::Collection::AssetLocations.new(accessor, asset: '123')
+
+      assert_kind_of Hash, collection.associations
+      assert_equal '123', collection.associations[:asset]
+    end
+  end
+
+  describe '#resource' do
+    it 'returns /assets/{asset_id}/locations' do
+      assert_equal "/assets/#{asset_id}/locations", collection.resource
+    end
+  end
+
+  describe '#all' do
+    it 'returns all records' do
+      all = VCR.use_cassette('get_asset_locations', record: :new_episodes) { collection.all }
+
+      assert_kind_of Array, all
+      assert_equal collection.count, all.size
+      assert all.size > 0
+
+      all.each do |item|
+        assert_kind_of JD::Model::AssetLocation, item
+      end
+    end
+  end
+
+  describe '#count' do
+    let(:server_response) do
+      contents = File.read('test/support/vcr/get_asset_locations.yml')
+      body = YAML.load(contents)['http_interactions'].first['response']['body']['string']
+      JSON.parse(body)
+    end
+
+    let(:server_count) { server_response['total'] }
+
+    it 'returns the total count of records in the collection' do
+      count = VCR.use_cassette('get_asset_locations') { collection.count }
+
+      assert_equal server_count, count
+    end
+  end
+
+  describe 'results' do
+    let(:location_timestamps) do
+      contents = File.read('test/support/vcr/get_asset_locations.yml')
+      body = YAML.load(contents)['http_interactions'].first['response']['body']['string']
+      JSON.parse(body)['values'].map{|v| v['timestamp']}
+    end
+
+    it 'returns all records as a single enumerator' do
+      count = VCR.use_cassette('get_asset_locations') { collection.count }
+      timestamps = VCR.use_cassette('get_asset_locations', record: :new_episodes) { collection.map(&:timestamp) }
+
+      assert_kind_of Array, timestamps
+      assert_equal count, timestamps.size
+      assert timestamps.size > 0
+
+      location_timestamps.each do |expected_timestamp|
+        assert_includes timestamps, expected_timestamp
+      end
+    end
+  end
+end

data/test/lib/my_john_deere_api/request/collection/assets_test.rb

@@ -0,0 +1,83 @@
+require 'support/helper'
+require 'yaml'
+require 'json'
+
+describe 'MyJohnDeereApi::Request::Collection::Assets' do
+  let(:organization_id) do
+    contents = File.read('test/support/vcr/get_organizations.yml')
+    body = YAML.load(contents)['http_interactions'].first['response']['body']['string']
+    JSON.parse(body)['values'].first['id']
+  end
+
+  let(:client) { JD::Client.new(API_KEY, API_SECRET, environment: :sandbox, access: [ACCESS_TOKEN, ACCESS_SECRET]) }
+  let(:accessor) { VCR.use_cassette('catalog') { client.send(:accessor) } }
+  let(:collection) { JD::Request::Collection::Assets.new(accessor, organization: organization_id) }
+
+  describe '#initialize(access_token)' do
+    it 'accepts an access token' do
+      assert_kind_of OAuth::AccessToken, collection.accessor
+    end
+
+    it 'accepts associations' do
+      collection = JD::Request::Collection::Assets.new(accessor, organization: '123')
+
+      assert_kind_of Hash, collection.associations
+      assert_equal '123', collection.associations[:organization]
+    end
+  end
+
+  describe '#resource' do
+    it 'returns /organizations/{org_id}/assets' do
+      assert_equal "/organizations/#{organization_id}/assets", collection.resource
+    end
+  end
+
+  describe '#all' do
+    it 'returns all records' do
+      all = VCR.use_cassette('get_assets', record: :new_episodes) { collection.all }
+
+      assert_kind_of Array, all
+      assert_equal collection.count, all.size
+
+      all.each do |item|
+        assert_kind_of JD::Model::Asset, item
+      end
+    end
+  end
+
+  describe '#count' do
+    let(:server_response) do
+      contents = File.read('test/support/vcr/get_assets.yml')
+      body = YAML.load(contents)['http_interactions'].first['response']['body']['string']
+      JSON.parse(body)
+    end
+
+    let(:server_count) { server_response['total'] }
+
+    it 'returns the total count of records in the collection' do
+      count = VCR.use_cassette('get_assets') { collection.count }
+
+      assert_equal server_count, count
+    end
+  end
+
+  describe 'results' do
+    let(:asset_titles) do
+      contents = File.read('test/support/vcr/get_assets.yml')
+      body = YAML.load(contents)['http_interactions'].first['response']['body']['string']
+      JSON.parse(body)['values'].map{|v| v['title']}
+    end
+
+    it 'returns all records as a single enumerator' do
+      count = VCR.use_cassette('get_assets') { collection.count }
+      titles = VCR.use_cassette('get_assets', record: :new_episodes) { collection.map(&:title) }
+
+      assert_kind_of Array, titles
+      assert_equal count, titles.size
+
+      asset_titles.each do |expected_title|
+        assert_includes titles, expected_title
+      end
+    end
+  end
+end

data/test/lib/my_john_deere_api/request/{test_collection.rb → collection_test.rb}

@@ -6,6 +6,14 @@ describe 'MyJohnDeereApi::Request::Collection' do
       assert JD::Request::Collection::Base
     end
 
+    it 'loads Request::Collection::Assets' do
+      assert JD::Request::Collection::Assets
+    end
+
+    it 'loads Request::Collection::AssetLocations' do
+      assert JD::Request::Collection::AssetLocations
+    end
+
     it 'loads Request::Collection::Organizations' do
       assert JD::Request::Collection::Organizations
     end

data/test/support/vcr/get_asset_locations.yml

@@ -0,0 +1,55 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://sandboxapi.deere.com/platform/assets/029c288a-14d9-459f-8ee6-b4e840e672a1/locations
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/vnd.deere.axiom.v3+json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      User-Agent:
+      - OAuth gem v0.5.4
+      Authorization:
+      - OAuth oauth_consumer_key="johndeere-wgmADngYCRmfpEbVgSyc709wnyRux5J7PAv8SE7B",
+        oauth_nonce="qTv5xV20gMbjd7IiRtg8xZlNfZHXX7Dmo1JrfP6xY1A", oauth_signature="exY2Q9m%2FlxXM%2BryRe6b9P7FmT1c%3D",
+        oauth_signature_method="HMAC-SHA1", oauth_timestamp="1578698931", oauth_token="47bbb9c9-41a8-4bec-8127-e3c5760af2f6",
+        oauth_version="1.0"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 10 Jan 2020 23:28:51 GMT
+      Content-Type:
+      - application/vnd.deere.axiom.v3+json;charset=UTF-8
+      X-Deere-Handling-Server:
+      - ip-10-214-44-15
+      X-Frame-Options:
+      - SAMEORIGIN
+      X-Deere-Elapsed-Ms:
+      - '58'
+      Cache-Control:
+      - no-store
+      Content-Language:
+      - en-US
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"links":[{"rel":"self","uri":"https://sandboxapi.deere.com/platform/assets/029c288a-14d9-459f-8ee6-b4e840e672a1/locations"}],"total":2,"values":[{"@type":"ContributedAssetLocation","timestamp":"2017-09-20T21:30:59.000Z","geometry":"{\"type\":
+        \"Feature\",\"geometry\": {\"geometries\": [{\"coordinates\": [ -103.115633,
+        41.670166],\"type\": \"Point\"}],\"type\": \"GeometryCollection\"}}","measurementData":[{"@type":"BasicMeasurement","name":"[1
+        Foot](https://app.realmfive.com/map?device=0x0080CDEF)","value":"82","unit":"cB"},{"@type":"BasicMeasurement","name":"[2
+        Feet](https://app.realmfive.com/map?device=0x0080CDEF)","value":"31","unit":"cB"}],"links":[]},{"@type":"ContributedAssetLocation","timestamp":"2017-09-20T21:29:59.000Z","geometry":"{\"type\":
+        \"Feature\",\"geometry\": {\"geometries\": [{\"coordinates\": [ -103.115633,
+        41.670166],\"type\": \"Point\"}],\"type\": \"GeometryCollection\"}}","measurementData":[{"@type":"BasicMeasurement","name":"[Moisture
+        - 1 Foot](https://app.realmfive.com/map?device=0x0080CDEF)","value":"82","unit":"cB"},{"@type":"BasicMeasurement","name":"[Moisture
+        - 2 Feet](https://app.realmfive.com/map?device=0x0080CDEF)","value":"31","unit":"cB"}],"links":[]}]}'
+    http_version: 
+  recorded_at: Fri, 10 Jan 2020 23:28:52 GMT
+recorded_with: VCR 5.0.0

data/test/support/vcr/get_assets.yml

@@ -0,0 +1,48 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://sandboxapi.deere.com/platform/organizations/444563/assets
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/vnd.deere.axiom.v3+json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      User-Agent:
+      - OAuth gem v0.5.4
+      Authorization:
+      - OAuth oauth_consumer_key="johndeere-wgmADngYCRmfpEbVgSyc709wnyRux5J7PAv8SE7B",
+        oauth_nonce="6Q43mOlqL5POK9tW4g378nTYY2NzAPxtWCpE6ngfM", oauth_signature="ECsBHW1vv01ybBLwrHTne421c%2Bw%3D",
+        oauth_signature_method="HMAC-SHA1", oauth_timestamp="1578694864", oauth_token="47bbb9c9-41a8-4bec-8127-e3c5760af2f6",
+        oauth_version="1.0"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 10 Jan 2020 22:21:04 GMT
+      Content-Type:
+      - application/vnd.deere.axiom.v3+json;charset=UTF-8
+      X-Deere-Handling-Server:
+      - ip-10-214-44-225
+      X-Frame-Options:
+      - SAMEORIGIN
+      X-Deere-Elapsed-Ms:
+      - '32'
+      Cache-Control:
+      - no-store
+      Content-Language:
+      - en-US
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"links":[{"rel":"self","uri":"https://sandboxapi.deere.com/platform/organizations/444563/assets"}],"total":3,"values":[{"@type":"ContributedAsset","title":"Flex
+        (Watermark)","assetCategory":"DEVICE","assetType":"SENSOR","assetSubType":"ENVIRONMENTAL","lastModifiedDate":"2019-09-20T21:13:38.232Z","id":"029c288a-14d9-459f-8ee6-b4e840e672a1","links":[{"@type":"Link","rel":"self","uri":"https://sandboxapi.deere.com/platform/assets/029c288a-14d9-459f-8ee6-b4e840e672a1"},{"@type":"Link","rel":"contributionDefinition","uri":"https://sandboxapi.deere.com/platform/contributionDefinitions/d93611c7-6f74-474f-9569-2cf88f866a32"},{"@type":"Link","rel":"organization","uri":"https://sandboxapi.deere.com/platform/organizations/444563"},{"@type":"Link","rel":"locations","uri":"https://sandboxapi.deere.com/platform/assets/029c288a-14d9-459f-8ee6-b4e840e672a1/locations"},{"@type":"Link","rel":"lastKnownLocation","uri":"https://sandboxapi.deere.com/platform/assets/029c288a-14d9-459f-8ee6-b4e840e672a1/locations?lastKnown=true"}]},{"@type":"ContributedAsset","title":"Pivot","assetCategory":"DEVICE","assetType":"SENSOR","assetSubType":"IRRIGATION_PIVOT","lastModifiedDate":"2019-09-20T21:14:13.931Z","id":"900b3657-0868-46b7-8322-70f204d44281","links":[{"@type":"Link","rel":"self","uri":"https://sandboxapi.deere.com/platform/assets/900b3657-0868-46b7-8322-70f204d44281"},{"@type":"Link","rel":"contributionDefinition","uri":"https://sandboxapi.deere.com/platform/contributionDefinitions/d93611c7-6f74-474f-9569-2cf88f866a32"},{"@type":"Link","rel":"organization","uri":"https://sandboxapi.deere.com/platform/organizations/444563"},{"@type":"Link","rel":"locations","uri":"https://sandboxapi.deere.com/platform/assets/900b3657-0868-46b7-8322-70f204d44281/locations"},{"@type":"Link","rel":"lastKnownLocation","uri":"https://sandboxapi.deere.com/platform/assets/900b3657-0868-46b7-8322-70f204d44281/locations?lastKnown=true"}]},{"@type":"ContributedAsset","title":"Float","assetCategory":"DEVICE","assetType":"SENSOR","assetSubType":"ENVIRONMENTAL","lastModifiedDate":"2019-09-20T21:13:58.799Z","id":"da668043-a366-4dac-bfc9-3aeafe1175dd","links":[{"@type":"Link","rel":"self","uri":"https://sandboxapi.deere.com/platform/assets/da668043-a366-4dac-bfc9-3aeafe1175dd"},{"@type":"Link","rel":"contributionDefinition","uri":"https://sandboxapi.deere.com/platform/contributionDefinitions/d93611c7-6f74-474f-9569-2cf88f866a32"},{"@type":"Link","rel":"organization","uri":"https://sandboxapi.deere.com/platform/organizations/444563"},{"@type":"Link","rel":"locations","uri":"https://sandboxapi.deere.com/platform/assets/da668043-a366-4dac-bfc9-3aeafe1175dd/locations"},{"@type":"Link","rel":"lastKnownLocation","uri":"https://sandboxapi.deere.com/platform/assets/da668043-a366-4dac-bfc9-3aeafe1175dd/locations?lastKnown=true"}]}]}'
+    http_version: 
+  recorded_at: Fri, 10 Jan 2020 22:21:05 GMT
+recorded_with: VCR 5.0.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: my_john_deere_api
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Jaime. Bellmyer
@@ -103,46 +103,56 @@ files:
 - lib/my_john_deere_api/errors/access_token_error.rb
 - lib/my_john_deere_api/helpers.rb
 - lib/my_john_deere_api/helpers/case_conversion.rb
-- lib/my_john_deere_api/helpers/uri_path.rb
+- lib/my_john_deere_api/helpers/uri_helpers.rb
 - lib/my_john_deere_api/model.rb
+- lib/my_john_deere_api/model/asset.rb
+- lib/my_john_deere_api/model/asset_location.rb
 - lib/my_john_deere_api/model/field.rb
 - lib/my_john_deere_api/model/flag.rb
 - lib/my_john_deere_api/model/organization.rb
 - lib/my_john_deere_api/request.rb
 - lib/my_john_deere_api/request/collection.rb
+- lib/my_john_deere_api/request/collection/asset_locations.rb
+- lib/my_john_deere_api/request/collection/assets.rb
 - lib/my_john_deere_api/request/collection/base.rb
 - lib/my_john_deere_api/request/collection/fields.rb
 - lib/my_john_deere_api/request/collection/flags.rb
 - lib/my_john_deere_api/request/collection/organizations.rb
 - lib/my_john_deere_api/version.rb
-- test/lib/my_john_deere_api/errors/test_access_token_error.rb
-- test/lib/my_john_deere_api/helpers/test_case_conversion.rb
-- test/lib/my_john_deere_api/helpers/test_uri_path.rb
-- test/lib/my_john_deere_api/model/test_field.rb
-- test/lib/my_john_deere_api/model/test_flag.rb
-- test/lib/my_john_deere_api/model/test_organization.rb
-- test/lib/my_john_deere_api/request/collection/test_base.rb
-- test/lib/my_john_deere_api/request/collection/test_fields.rb
-- test/lib/my_john_deere_api/request/collection/test_flags.rb
-- test/lib/my_john_deere_api/request/collection/test_organizations.rb
-- test/lib/my_john_deere_api/request/test_collection.rb
-- test/lib/my_john_deere_api/test_authorize.rb
-- test/lib/my_john_deere_api/test_client.rb
-- test/lib/my_john_deere_api/test_consumer.rb
-- test/lib/my_john_deere_api/test_errors.rb
-- test/lib/my_john_deere_api/test_helpers.rb
-- test/lib/my_john_deere_api/test_model.rb
-- test/lib/my_john_deere_api/test_request.rb
-- test/lib/my_john_deere_api/test_version.rb
+- test/lib/my_john_deere_api/authorize_test.rb
+- test/lib/my_john_deere_api/client_test.rb
+- test/lib/my_john_deere_api/consumer_test.rb
+- test/lib/my_john_deere_api/errors/access_token_error_test.rb
+- test/lib/my_john_deere_api/errors_test.rb
+- test/lib/my_john_deere_api/helpers/case_conversion_test.rb
+- test/lib/my_john_deere_api/helpers/uri_helpers_test.rb
+- test/lib/my_john_deere_api/helpers_test.rb
+- test/lib/my_john_deere_api/model/asset_location_test.rb
+- test/lib/my_john_deere_api/model/asset_test.rb
+- test/lib/my_john_deere_api/model/field_test.rb
+- test/lib/my_john_deere_api/model/flag_test.rb
+- test/lib/my_john_deere_api/model/organization_test.rb
+- test/lib/my_john_deere_api/model_test.rb
+- test/lib/my_john_deere_api/request/collection/asset_locations_test.rb
+- test/lib/my_john_deere_api/request/collection/assets_test.rb
+- test/lib/my_john_deere_api/request/collection/base_test.rb
+- test/lib/my_john_deere_api/request/collection/fields_test.rb
+- test/lib/my_john_deere_api/request/collection/flags_test.rb
+- test/lib/my_john_deere_api/request/collection/organizations_test.rb
+- test/lib/my_john_deere_api/request/collection_test.rb
+- test/lib/my_john_deere_api/request_test.rb
+- test/lib/my_john_deere_api/version_test.rb
+- test/my_john_deere_api_test.rb
 - test/support/helper.rb
 - test/support/vcr/app_consumer.yml
 - test/support/vcr/catalog.yml
 - test/support/vcr/get_access_token.yml
+- test/support/vcr/get_asset_locations.yml
+- test/support/vcr/get_assets.yml
 - test/support/vcr/get_fields.yml
 - test/support/vcr/get_flags.yml
 - test/support/vcr/get_organizations.yml
 - test/support/vcr/get_request_token.yml
-- test/test_my_john_deere_api.rb
 homepage: https://github.com/Intellifarm/my_john_deere_api
 licenses:
 - MIT

data/lib/my_john_deere_api/helpers/uri_path.rb

@@ -1,9 +0,0 @@
-require 'uri'
-
-module MyJohnDeereApi::Helpers::UriPath
-  def uri_path(uri)
-    URI.parse(uri).path.gsub(/^\/platform/, '')
-  end
-
-  private :uri_path
-end

data/test/lib/my_john_deere_api/helpers/test_uri_path.rb

@@ -1,28 +0,0 @@
-require 'support/helper'
-
-class UriPathHelperSample
-  include JD::Helpers::UriPath
-end
-
-describe 'UriPath' do
-  let(:object) { UriPathHelperSample.new }
-
-  it 'extracts the path from the uri' do
-    path = object.send(:uri_path, 'https://example.com/turtles')
-    assert_equal '/turtles', path
-  end
-
-  it 'removes leading /platform from the path' do
-    path = object.send(:uri_path, 'https://example.com/platform/turtles')
-    assert_equal '/turtles', path
-  end
-
-  it 'preserves /platform in any other part of the path' do
-    path = object.send(:uri_path, 'https://example.com/platform/turtles/platform')
-    assert_equal '/turtles/platform', path
-  end
-
-  it 'is a private method' do
-    assert_raises(NoMethodError) { object.uri_path('https://example.com/turtles')}
-  end
-end