reso_api 0.3.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4a950c58781ec5c74884efd37ceb091855cdc061e491c83a206d47e8121a4a7
-  data.tar.gz: a05ad1c1835d3d097e828462028132cd1b508bc1eee4a475bee94c112dfbe38c
+  metadata.gz: 875af398db2f60126a49b410bedfa34d8c0b5427f614b8758176a6f40f8c184a
+  data.tar.gz: c6795fa6d9b96ad8e108fe05559dff495548aa2eed09d2c9454991215146d8a8
 SHA512:
-  metadata.gz: 8076aca2231e877bd54c27a64595dfa6f58ee8e5078ba6d5f4d289b7e642387ad28407485e7203ffb4e1416f8ebc813be3906393a60ba726494ca9ca4af4789a
-  data.tar.gz: 54b68fdbcdde0c9332db35b862c83497ffd0df1f19e676fe390a3bd6bf1246f3cf15723214bbb75f9867df0a0ab7ad6252ec6f7123071041d500bb87b76cd4d0
+  metadata.gz: dc5e5b6c38cf16ac70c05ec7f83eeebfed006ebf54f0f1fadc7b3ab7475aeaa1b04b3ca54125842183e2f5ae8246d3c8772046d4319a2e4a23b47915f32078c2
+  data.tar.gz: c6ccdd77da2494aa8eb37b6b77b30e7b613a0aa626d10c979448b538dc6c4c690d6af2060a5f3a2921422bd198d40ff02e34ac1e5feca5932db4e31948bd2aaa

data/README.md

@@ -143,7 +143,24 @@ $expand in oData is meant to join two resources together. For the Syndication AP
 client.properties(expand: "Media")
 ```
 
-#### Pagination, $top, and $skip
+#### Automatically iterate over all results
+
+By passing a block to Media, Member, Office, and Property resource calls, subsequent paginated calls will automatically be made until the whole result set has been traversed. The block provided is executed for each returned object hash.
+
+Here are a couple of examples of how that can be used:
+
+```ruby
+client.properties(filter: "StandardStatus eq 'Active'") do |hash|
+  puts "#{hash['ListingKey']} – #{hash['UnparsedAddress']}"
+end
+
+client.properties(filter: "StandardStatus eq 'Active'") do |hash|
+  Listing.create(listing_key: hash['ListingKey'], data: hash)
+end
+```
+
+
+#### Manually iterate over all results
 
 The default number of results returned is 100. You can override the default limit using the `$top` parameter. The higher the number specific for `$top`, the longer the API response will take, and pay attention to that different services does enforce a cap for number of records returned.
 

data/lib/reso_api/app/models/reso/api/client.rb

@@ -47,7 +47,7 @@ module RESO
       }
 
       FILTERABLE_ENDPOINTS.keys.each do |method_name|
-        define_method method_name do |*args|
+        define_method method_name do |*args, &block|
           hash = args.first.is_a?(Hash) ? args.first : {}
           endpoint = FILTERABLE_ENDPOINTS[method_name]
           params = {
@@ -61,7 +61,16 @@ module RESO
             "$count": hash[:count].to_s.presence,
             "$debug": hash[:debug]
           }.compact
-          return perform_call(endpoint, params)
+          if !block.nil?
+            response = perform_call(endpoint, params)
+            response["value"].each{|hash| block.call(hash)} if response["value"].class.eql?(Array)
+            while (next_link = response["@odata.nextLink"]).present?
+              response = perform_call(next_link, nil)
+              response["value"].each{|hash| block.call(hash)} if response["value"].class.eql?(Array)
+            end
+          else
+            return perform_call(endpoint, params)
+          end
         end
       end
 
@@ -123,7 +132,7 @@ module RESO
       end
 
       def uri_for_endpoint endpoint
-        return URI([base_url, endpoint].join)
+        return URI(endpoint).host? ? endpoint : URI([base_url, endpoint].join)
       end
 
       def perform_call(endpoint, params)

data/lib/reso_api/version.rb

@@ -1,3 +1,3 @@
 module ResoApi
-  VERSION = "0.3.1"
+  VERSION = "0.4.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: reso_api
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.2
 platform: ruby
 authors:
 - Michael Edlund
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-03-04 00:00:00.000000000 Z
+date: 2022-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler