fulfil-io 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d85caade2af0ca4d9ede6a970d0c9b802960e5bc192a41d70eb9c70f153640b1
-  data.tar.gz: 13b43002ee089a9781221b7c42cef81a12474a11ccdb9f6e9df248eaabff8f84
+  metadata.gz: 63d67b77df97810e72d56c2cd60a859004ee97de438bd11332cb643c8b8d0466
+  data.tar.gz: 82708a84ce96c3254236ab4ce7e05a9d64477dc12b94ebb47d758ad267cc818e
 SHA512:
-  metadata.gz: 415418f4c4a54490b95d3823272096e481b064bf0be0f45cd44dc2c093af7616d93e56b46e0286447febf154f1187fbcbf31a0d3f3d8e456846a5590b636bc04
-  data.tar.gz: 854d989c8b343dabd2317850f578a7a2c37c9a19d04873b19eb278c278a78a51c94a928d5cf24f5a7265f05a63ff6d1dfcb5853971448843957827af9554bb9e
+  metadata.gz: 609049e9604f06602526be98da080e33bdbc1a1d5a46e4d338cc5a86cf5f9df9584963b6462e30da5d493b354bb73ca7c489d1c9229b37230ef7654af821cc43
+  data.tar.gz: f27513ccae674a68a294e12aacecf82c92a2caa6d65077a6abc7497c41703b7b689a4cb2a1b421a9b65c95584243d5a9d95b2f33b11571ec76eba009005cce13

data/README.md

@@ -145,6 +145,18 @@ $ Fulfil.rate_limit.limit
 $ Fulfil.rate_limit.resets_at
 => #<DateTime: 2022-01-21T16:36:01-04:00 />
 ```
+
+Automatic retries are supported whenever the rate limit is reached. However, it's not enabled by default. To enable it, set the `retry_on_rate_limit` to `true`. By default, the request will be retried in 1 second.
+
+```ruby
+# config/initializers/fulfil.rb
+
+Fulfil.configure do |config|
+  config.retry_on_rate_limit = true # Defaults to false
+  config.retry_on_rate_limit_wait = 0.25 # Defaults to 1 (second)
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run

data/lib/fulfil/client.rb

@@ -164,6 +164,13 @@ module Fulfil
     rescue HTTP::ResponseError => e
       raise ResponseError, "Can't process response: #{e}"
       []
+    # If configured, the client will wait whenever the `RateLimitExceeded` exception
+    # is raised. Check `Fulfil::Configuration` for more details.
+    rescue RateLimitExceeded => e
+      raise e unless config.retry_on_rate_limit?
+
+      sleep config.retry_on_rate_limit_wait
+      retry
     end
 
     def client
@@ -172,5 +179,9 @@ module Fulfil
       client = client.headers(@headers)
       client
     end
+
+    def config
+      Fulfil.config
+    end
   end
 end

data/lib/fulfil/configuration.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Fulfil
+  # The `Fulfil::Configuration` contains the available configuration options
+  # for the `Fulfil` gem.
+  class Configuration
+    # Allow the `Fulfil::Client` to automatically retry when the rate limit is hit.
+    # By default, the `Fulfil::Client` will wait 1 second before retrying again.
+    attr_accessor :retry_on_rate_limit
+    attr_accessor :retry_on_rate_limit_wait
+
+    def initialize
+      @retry_on_rate_limit = false
+      @retry_on_rate_limit_wait = 1
+    end
+
+    def retry_on_rate_limit?
+      @retry_on_rate_limit
+    end
+  end
+
+  # Returns Fulfil's configuration.
+  # @return [Fulfil::Configuration] Fulfil's configuration
+  def self.config
+    @config ||= Configuration.new
+  end
+
+  # Allows setting a new configuration for Fulfil.
+  # @return [Fulfil::Configuration] Fulfil's new configuration
+  def self.config=(configuration)
+    @config = configuration
+  end
+
+  # Allows modifying Fulfil's configuration.
+  #
+  # Example usage:
+  #
+  #   Fulfil.configure do |config|
+  #     config.api_key = "..."
+  #   end
+  #
+  def self.configure
+    yield(config)
+  end
+end

data/lib/fulfil/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fulfil
-  VERSION = "0.6.1"
+  VERSION = "0.7.0"
 end

data/lib/fulfil.rb

@@ -2,6 +2,7 @@
 
 require 'fulfil/version'
 require 'fulfil/error'
+require 'fulfil/configuration'
 require 'fulfil/client'
 require 'fulfil/model'
 require 'fulfil/interactive_report'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fulfil-io
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Chris Moore
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-04-22 00:00:00.000000000 Z
+date: 2022-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -152,6 +152,7 @@ files:
 - lib/fulfil-io.rb
 - lib/fulfil.rb
 - lib/fulfil/client.rb
+- lib/fulfil/configuration.rb
 - lib/fulfil/error.rb
 - lib/fulfil/interactive_report.rb
 - lib/fulfil/model.rb
@@ -180,7 +181,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.3.12
 signing_key:
 specification_version: 4
 summary: Interact with the Fulfil.io API