kobana 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bc6a9da2db1bd8cb2aa863f729e4ee3ef9cd4c143e9c38e5ce5e64c633e1f98
-  data.tar.gz: 2841dae640966617c6c9a897681cc26ae0ace4c933613ae0147d91ab0ffda53e
+  metadata.gz: fb9688ae8ad7106ca655b5db3b61f0a901c740ed818a60339c9f506833cbae32
+  data.tar.gz: 4d9d89c6a37ef389ea0c30ff33d8e6e29cf29e94c1e7cb6760a73b3a99750e5f
 SHA512:
-  metadata.gz: 1740ebb8d3b894fd4b0b215450ea4563da1ece74da1002d046f874b8661007716989e9ed8c52279ed95983714e42cca1b3bc3a4c05e369910ca2aec6b68b67f8
-  data.tar.gz: 75ec69765d55582b1363d014ba78ebc4e93d5407e6aef4b18020bd1c3c78d1d4c59b8207d0d40bf9522e81a08364e03779d7743ebcd9a8b5894f15d58d91f4bf
+  metadata.gz: 5d3246c4cbb7357282c1bef55d9dbb0dbd00e092e96e1c4c95acc354183589eedbd47baa9c27cae48732f29e8b7e2b20579bb31577cc5fa5237c48a79ee2b17a
+  data.tar.gz: 9e4cf09cc138db4cee8cfd52fcb1312043c9833d38e2676eb8e808a39b183722e1bd2c5f63cfa594881be428f4a95d515f10f67aa893b9be0e36e284dc2a0c7c

data/CHANGELOG.md

@@ -1,5 +1,6 @@
 ## [Unreleased]
 
+- Add configurable HTTP timeouts (`config.open_timeout` / `config.timeout`, in seconds, passed to Faraday). Default `nil` (no timeout) keeps existing behavior; set them to fail fast instead of blocking when the API is slow.
 - Add debug option
 
 ## [0.1.0] - 2023-10-27

data/README.md

@@ -88,6 +88,24 @@ client.configure do |config|
 end
 ```
 
+#### HTTP timeouts
+
+By default the client has **no** HTTP timeout, so a slow or hanging API call
+blocks the caller until the underlying socket gives up. Set `open_timeout`
+(connection establishment) and/or `timeout` (response read), in seconds, to fail
+fast instead — both are passed straight to Faraday:
+
+```ruby
+Kobana.configure do |config|
+  config.api_token = 'YOUR_API_TOKEN'
+  config.open_timeout = 2 # seconds to establish the TCP connection
+  config.timeout = 8      # seconds to read the response
+end
+```
+
+When unset (`nil`), behavior is unchanged. Tune `timeout` above the longest
+expected operation (e.g. large multipart uploads / batch exports).
+
 ### Usage
 
 The gem supports both global configuration (backward compatible) and multi-client usage patterns.

data/lib/kobana/configuration.rb

@@ -2,12 +2,18 @@
 
 module Kobana
   class Configuration
-    attr_accessor :api_token, :environment, :custom_headers, :debug, :api_version
+    # `open_timeout` and `timeout` are passed straight to Faraday (in seconds).
+    # Both default to nil (no timeout) to preserve historical behavior; set them
+    # to fail fast instead of blocking the caller when the API is slow/hanging.
+    attr_accessor :api_token, :environment, :custom_headers, :debug, :api_version,
+                  :open_timeout, :timeout
 
     def initialize
       @custom_headers = {}
       @environment = :sandbox
-      @api_version = :v2
+      # nil means "no global override" — each resource uses its own declared
+      # api_version (see Resources::Base). Set this to force a version globally.
+      @api_version = nil
     end
 
     def inspect

data/lib/kobana/resources/connection.rb

@@ -45,10 +45,18 @@ module Kobana
             faraday.request :json
             faraday.adapter Faraday.default_adapter
             faraday.headers = headers
+            apply_timeouts(faraday, config)
             faraday.response :logger, logger if config.debug
           end
         end
 
+        # Applies Faraday connect/read timeouts from the configuration when set.
+        # No-op when unset, so the default behavior (no timeout) is preserved.
+        def apply_timeouts(faraday, config)
+          faraday.options.open_timeout = config.open_timeout if config.open_timeout
+          faraday.options.timeout = config.timeout if config.timeout
+        end
+
         public
 
         def multipart_connection
@@ -67,6 +75,7 @@ module Kobana
             faraday.headers = headers.merge(
               "Content-Type" => "multipart/form-data"
             )
+            apply_timeouts(faraday, config)
             faraday.response :logger, logger if config.debug
           end
         end

data/lib/kobana/resources/operations.rb

@@ -68,7 +68,7 @@ module Kobana
           return unless response[:data].is_a?(Hash)
 
           @errors = response[:data][:errors] if response[:data].key?(:errors)
-          @errors = [title: response[:data][:error]] if response[:data].key?(:error)
+          @errors = [{ title: response[:data][:error] }] if response[:data].key?(:error)
         end
       end
 

data/lib/kobana/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kobana
-  VERSION = "0.3.1"
+  VERSION = "0.3.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kobana
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Kivanio Barbosa
@@ -104,14 +104,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.6
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 4.0.13
 specification_version: 4
 summary: Kobana API Client
 test_files: []