philiprehberger-http_client 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33e21c126de3c43a3923e7cf7ae975f3fb6c138fe03836236bcab6a83530da94
-  data.tar.gz: 240a93399f0fc981253749452d52096a4ccaa0b184010831321f7ced135c6463
+  metadata.gz: dc47cd54c2873fe7bf5dacad5d62bb028b4ccd9b36e028182e7700cbfeb589de
+  data.tar.gz: 26739ada42f419275cada8b35136f0b35fe1c4c2744067466f5e20fc851c4a58
 SHA512:
-  metadata.gz: 2137a02d80460a9b6653964dc59fdea65f7c791612c050a83a792fd1db5413e39936852cd49ca0183108d9c9390253d7a176d772607ebc1ddeb3929cc7c14e56
-  data.tar.gz: 8d0a7b892f1c74f32ad72c7c3da50f790ba503fe3580768dd8e798a0cc46e8089ee29b42afc67ba083be321932fb3dc9e3dc27d73348d1348149f1e1b31110eb
+  metadata.gz: d4a8181bf4925a8314d54cbe34db75dd19a79af46d5c7f432bb33172df6c89d1c6b6e0bede1cdbdada2613f8291c1c15a7dee6559ddbf73d432437891ae67531
+  data.tar.gz: 48a8ca6c36e77ca87950da44209d7e39eecfe23ee7ed7d9bebf6c63f717c849fb021e69a7aada4a81d52996be7a206c5bff5c53099283abf9cb467f1709907bb

data/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] - 2026-03-12
+
+### Fixed
+- Re-release with no code changes (RubyGems publish fix)
+
+## [0.3.0] - 2026-03-12
+
+### Added
+
+- `retry_on_status` option to retry on specific HTTP status codes (e.g., 429, 503)
+- Form-urlencoded body support via `form:` parameter on POST, PUT, and PATCH
+- `bearer_token` helper method for Bearer token authentication
+- `basic_auth` helper method for HTTP Basic authentication
+
+### Fixed
+
+- Exponential backoff delay: first retry now uses base delay instead of 2x base delay
+
 ## [0.2.0] - 2026-03-12
 
 ### Added

data/README.md

@@ -76,6 +76,25 @@ client.get("/health")
 #   Response: 200
 ```
 
+### Form data
+
+```ruby
+response = client.post("/login", form: { username: "alice", password: "secret" })
+# Content-Type: application/x-www-form-urlencoded is set automatically
+```
+
+### Authentication helpers
+
+```ruby
+# Bearer token
+client.bearer_token("your-api-token")
+client.get("/protected")  # Authorization: Bearer your-api-token
+
+# Basic auth
+client.basic_auth("username", "password")
+client.get("/protected")  # Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
+```
+
 ### Retries
 
 Automatically retry on network errors (connection refused, timeouts, etc.):
@@ -90,6 +109,19 @@ client = Philiprehberger::HttpClient.new(
 response = client.get("/unstable-endpoint")
 ```
 
+You can also retry on specific HTTP status codes:
+
+```ruby
+client = Philiprehberger::HttpClient.new(
+  base_url: "https://api.example.com",
+  retries: 3,
+  retry_delay: 1,
+  retry_on_status: [429, 503]
+)
+```
+
+> **Note:** Network error retries and HTTP status retries both count toward the same retry limit.
+
 ### Exponential backoff
 
 ```ruby
@@ -99,6 +131,7 @@ client = Philiprehberger::HttpClient.new(
   retry_delay: 1,
   retry_backoff: :exponential
 )
+# Delay sequence: 1s, 2s, 4s
 ```
 
 ### Per-request timeout
@@ -129,7 +162,8 @@ client.head("/resource")
 | `timeout`     | Integer | `30`    | Read/open timeout in seconds         |
 | `retries`     | Integer | `0`     | Retry attempts on network errors     |
 | `retry_delay` | Numeric | `1`     | Seconds between retries              |
-| `retry_backoff` | String/Symbol | `:fixed` | Backoff strategy — `:fixed` or `:exponential` |
+| `retry_backoff` | Symbol | `:fixed` | Backoff strategy — `:fixed` or `:exponential` |
+| `retry_on_status` | Array | `nil` | HTTP status codes to retry on (e.g., `[429, 503]`) |
 
 ### Methods
 
@@ -142,6 +176,8 @@ client.head("/resource")
 | `delete(path, **opts)` | Send DELETE request |
 | `head(path, **opts)` | Send HEAD request |
 | `request_count` | Total number of requests made by this client |
+| `bearer_token(token)` | Set Bearer token auth for all subsequent requests |
+| `basic_auth(user, pass)` | Set Basic auth for all subsequent requests |
 
 ### `Response`
 

data/lib/philiprehberger/http_client/client.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "base64"
 require "net/http"
 require "uri"
 require "json"
@@ -22,6 +23,7 @@ module Philiprehberger
         @retries = retry_options.fetch(:retries, 0)
         @retry_delay = retry_options.fetch(:retry_delay, 1)
         @retry_backoff = retry_options.fetch(:retry_backoff, :fixed)
+        @retry_on_status = retry_options[:retry_on_status]
         @interceptors = []
         @request_count = 0
       end
@@ -75,13 +77,11 @@ module Philiprehberger
       # @param path [String] Request path
       # @param body [String, nil] Raw body string
       # @param json [Hash, Array, nil] JSON-serializable body (sets Content-Type automatically)
+      # @param form [Hash, nil] Form-urlencoded body (sets Content-Type automatically)
       # @param headers [Hash] Additional headers
       # @return [Response]
-      def post(path, body: nil, json: nil, headers: {}, timeout: nil)
-        uri = build_uri(path)
-        request = Net::HTTP::Post.new(uri)
-        set_body(request, body, json, headers)
-        execute(uri, request, headers, timeout: timeout)
+      def post(path, **opts)
+        request_with_body(Net::HTTP::Post, path, **opts)
       end
 
       # Perform a PUT request.
@@ -89,13 +89,11 @@ module Philiprehberger
       # @param path [String] Request path
       # @param body [String, nil] Raw body string
       # @param json [Hash, Array, nil] JSON-serializable body
+      # @param form [Hash, nil] Form-urlencoded body
       # @param headers [Hash] Additional headers
       # @return [Response]
-      def put(path, body: nil, json: nil, headers: {}, timeout: nil)
-        uri = build_uri(path)
-        request = Net::HTTP::Put.new(uri)
-        set_body(request, body, json, headers)
-        execute(uri, request, headers, timeout: timeout)
+      def put(path, **opts)
+        request_with_body(Net::HTTP::Put, path, **opts)
       end
 
       # Perform a PATCH request.
@@ -103,13 +101,11 @@ module Philiprehberger
       # @param path [String] Request path
       # @param body [String, nil] Raw body string
       # @param json [Hash, Array, nil] JSON-serializable body
+      # @param form [Hash, nil] Form-urlencoded body
       # @param headers [Hash] Additional headers
       # @return [Response]
-      def patch(path, body: nil, json: nil, headers: {}, timeout: nil)
-        uri = build_uri(path)
-        request = Net::HTTP::Patch.new(uri)
-        set_body(request, body, json, headers)
-        execute(uri, request, headers, timeout: timeout)
+      def patch(path, **opts)
+        request_with_body(Net::HTTP::Patch, path, **opts)
       end
 
       # Perform a DELETE request.
@@ -122,6 +118,26 @@ module Philiprehberger
         request = Net::HTTP::Delete.new(uri)
         execute(uri, request, headers, timeout: timeout)
       end
+
+      # Set a Bearer token for all subsequent requests.
+      #
+      # @param token [String] the bearer token
+      # @return [self]
+      def bearer_token(token)
+        @default_headers["authorization"] = "Bearer #{token}"
+        self
+      end
+
+      # Set Basic auth credentials for all subsequent requests.
+      #
+      # @param username [String]
+      # @param password [String]
+      # @return [self]
+      def basic_auth(username, password)
+        encoded = Base64.strict_encode64("#{username}:#{password}")
+        @default_headers["authorization"] = "Basic #{encoded}"
+        self
+      end
     end
   end
 end

data/lib/philiprehberger/http_client/connection.rb

@@ -5,8 +5,21 @@ module Philiprehberger
     # Internal helpers for building URIs, HTTP connections, executing requests,
     # and constructing Response objects. Mixed into Client to keep it concise.
     module Connection
+      RETRYABLE_ERRORS = [
+        Errno::ECONNREFUSED, Errno::ECONNRESET, Errno::ETIMEDOUT,
+        Net::OpenTimeout, Net::ReadTimeout, SocketError
+      ].freeze
+
       private
 
+      def request_with_body(http_class, path, **opts)
+        headers = opts.fetch(:headers, {})
+        uri = build_uri(path)
+        request = http_class.new(uri)
+        set_body(request, opts[:body], opts[:json], opts[:form], headers)
+        execute(uri, request, headers, timeout: opts[:timeout])
+      end
+
       def build_uri(path, params = {})
         url = "#{@base_url}/#{path.sub(%r{^/}, '')}"
         uri = URI.parse(url)
@@ -17,10 +30,13 @@ module Philiprehberger
         uri
       end
 
-      def set_body(request, body, json_body, headers)
+      def set_body(request, body, json_body, form_body, headers)
         if json_body
           request.body = JSON.generate(json_body)
           headers["content-type"] ||= "application/json"
+        elsif form_body
+          request.body = URI.encode_www_form(form_body)
+          headers["content-type"] ||= "application/x-www-form-urlencoded"
         elsif body
           request.body = body
         end
@@ -47,20 +63,28 @@ module Philiprehberger
 
       def perform_with_retries(uri, request, timeout: nil)
         attempts = 0
-        begin
-          perform_request(uri, request, timeout: timeout)
-        rescue Errno::ECONNREFUSED, Errno::ECONNRESET, Errno::ETIMEDOUT,
-               Net::OpenTimeout, Net::ReadTimeout, SocketError => e
-          attempts += 1
-          raise e unless attempts <= @retries
+        loop do
+          response = perform_request(uri, request, timeout: timeout)
+          return response unless retry_on_status?(response.status, attempts)
+
+          wait_and_retry(attempts += 1)
+        rescue *RETRYABLE_ERRORS => e
+          raise e unless (attempts += 1) <= @retries
 
           sleep(retry_delay_for(attempts))
-          retry
         end
       end
 
+      def retry_on_status?(status, attempts)
+        @retry_on_status&.include?(status) && attempts < @retries
+      end
+
+      def wait_and_retry(attempt)
+        sleep(retry_delay_for(attempt))
+      end
+
       def retry_delay_for(attempt)
-        @retry_backoff == :exponential ? @retry_delay * (2**attempt) : @retry_delay
+        @retry_backoff == :exponential ? @retry_delay * (2**(attempt - 1)) : @retry_delay
       end
 
       def perform_request(uri, request, timeout: nil)

data/lib/philiprehberger/http_client/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HttpClient
-    VERSION = "0.2.0"
+    VERSION = "0.3.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-http_client
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Philip Rehberger