reso_api 0.3.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91f8dc7ead6ed968688dfc9c53c0e5a35ed1c4dffe5801fad27d97fae704bf57
-  data.tar.gz: e5a3d7475620f94bf470fde3e92a4e9dfbd4820c44df7aa1ed056e35bdb04ace
+  metadata.gz: 1308c7aa20b15c5aa0182575eb75e2a8a559b666de0ad71e1fd2e88d596e161c
+  data.tar.gz: '009565c60f86a0cd7af1272de8be1960577cc721d366d6216799728a6b9d816c'
 SHA512:
-  metadata.gz: b1e5e3408a40ee54db7dec2d959a16af34a9f6b31e4590d30116da71a7b81b9513f4de5eb14f996cc3b21a1cd9293a8a48c31841cfbebdf1b2edba7e540cc9c5
-  data.tar.gz: e7a10e99a931cd6a7e3eeb122d27fbc8c77a872846c4709264d3054586b63fff6a66c56488e9e41d455a95f9c4047df6db92ea114f22502fb3fc1479d2167f40
+  metadata.gz: 19afef8507aa12c680ec019d956380d7a9333fb02ea25a35ab1c7695d0c42180490730d8da684125c48e7cc918218566753b1e2ad2834528c362386eae765b03
+  data.tar.gz: 808c88eeca611e3b33203de52b865074bbef6ea74bd9ec3aedba809b3627a10ec4ff58ebdab855edaca9fe6cb0d60a2c39774d24b1b3c754dee7ab4c22533774

data/README.md

@@ -140,10 +140,27 @@ client.properties(orderby: "City desc")
 $expand in oData is meant to join two resources together. For the Syndication API this means you can bring in photos to any property query.
 
 ```ruby
-client.properties(еxpand: "Media")
+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,17 @@ 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?
+              endpoint = next_link.delete_prefix(base_url)
+              response = perform_call(endpoint, nil)
+              response["value"].each{|hash| block.call(hash)} if response["value"].class.eql?(Array)
+            end
+          else
+            return perform_call(endpoint, params)
+          end
         end
       end
 

data/lib/reso_api/version.rb

@@ -1,3 +1,3 @@
 module ResoApi
-  VERSION = "0.3.0"
+  VERSION = "0.4.1"
 end

metadata

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