net-hippie 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 998433769957af723da2f4803acd93083a124bbefb5af0bf95a5083a0afae59c
-  data.tar.gz: 45b2708548b30020c6a74f269669545ed3355d4c567a914763313dd516f35afd
+  metadata.gz: e3fdff6728d13d3fece5e05908cc04e9c0999909ab392f73c9dc67a3203bbfb6
+  data.tar.gz: e3e94c49e148b6931b543b011cf10da959d36d6b8f0f6b2dd1f4620e5ff21521
 SHA512:
-  metadata.gz: bd3c51b47e5bc632c105daf5aa589cc1df70952ea2b7baa05c699b63e5a54b74054f19d4d42f2715d9d0339a7b28a55e17714e087fa6a385689b158426f6f0bf
-  data.tar.gz: b7374b67ac0bcf7f93a0ac9715e5fe8cd517e614dcdd06cdf924bb61ca76c4f222b802e9b3cf3dd5a735c78ac5f076f3db13128ef59c510e826c1748d19c72c0
+  metadata.gz: 1f1ec4190b76c30c45efa6c00198326eb08f4e80280557dc42a6afb3c70166e80e624986ac14823f1d3f6a24ba16afb923f5ead14420fd34fdc5f88620f82a90
+  data.tar.gz: 0331df5f99e4b75ba58185c9dbba971e97f1233f3c0625dc0d7a6948e41cd2b3cc63bebeb4c7bba08767c677a72a1e2e3aee6df2d45afa54c2b0701096a97dc4

data/CHANGELOG.md

@@ -8,6 +8,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.4.0] - 2025-10-08
+### Added
+- Streaming response support via block parameter
+- Backward compatible with existing block API (arity-based detection)
+
 ## [1.3.0] - 2025-04-30
 ### Changed
 - Ruby 2.3+ required
@@ -95,7 +100,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - with\_retry.
 - authorization header helpers
 
-[Unreleased]: https://github.com/xlgmokha/net-hippie/compare/v1.3.0...HEAD
+[Unreleased]: https://github.com/xlgmokha/net-hippie/compare/v1.4.0...HEAD
+[1.4.0]: https://github.com/xlgmokha/net-hippie/compare/v1.3.0...v1.4.0
 [1.3.0]: https://github.com/xlgmokha/net-hippie/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/xlgmokha/net-hippie/compare/v1.1.1...v1.2.0
 [1.1.1]: https://github.com/xlgmokha/net-hippie/compare/v1.1.0...v1.1.1

data/README.md

@@ -90,6 +90,40 @@ headers = { 'Authorization' => Net::Hippie.bearer_auth('token') }
 Net::Hippie.get('https://www.example.org', headers: headers)
 ```
 
+### Streaming Responses
+
+Net::Hippie supports streaming responses by passing a block that accepts the response object:
+
+```ruby
+Net::Hippie.post('https://api.example.com/stream', body: { prompt: 'Hello' }) do |response|
+  response.read_body do |chunk|
+    print chunk
+  end
+end
+```
+
+This is useful for Server-Sent Events (SSE) or other streaming APIs:
+
+```ruby
+client = Net::Hippie::Client.new
+client.post('https://api.openai.com/v1/chat/completions',
+  headers: {
+    'Authorization' => Net::Hippie.bearer_auth(ENV['OPENAI_API_KEY']),
+    'Content-Type' => 'application/json'
+  },
+  body: { model: 'gpt-4', messages: [{ role: 'user', content: 'Hi' }], stream: true }
+) do |response|
+  buffer = ""
+  response.read_body do |chunk|
+    buffer += chunk
+    while (line = buffer.slice!(/.*\n/))
+      next if line.strip.empty?
+      puts line if line.start_with?('data: ')
+    end
+  end
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/test` to run the tests.

data/lib/net/hippie/client.rb

@@ -26,14 +26,10 @@ module Net
 
       def execute(uri, request, limit: follow_redirects, &block)
         connection = connection_for(uri)
+        return execute_with_block(connection, request, &block) if block_given?
+
         response = connection.run(request)
-        if limit.positive? && response.is_a?(Net::HTTPRedirection)
-          url = connection.build_url_for(response['location'])
-          request = request_for(Net::HTTP::Get, url)
-          execute(url, request, limit: limit - 1, &block)
-        else
-          block_given? ? yield(request, response) : response
-        end
+        follow_redirect?(response, limit) ? follow_redirect(connection, response, limit) : response
       end
 
       def get(uri, headers: {}, body: {}, &block)
@@ -78,6 +74,20 @@ module Net
 
       attr_reader :default_headers
 
+      def execute_with_block(connection, request, &block)
+        block.arity == 2 ? yield(request, connection.run(request)) : connection.run(request, &block)
+      end
+
+      def follow_redirect?(response, limit)
+        limit.positive? && response.is_a?(Net::HTTPRedirection)
+      end
+
+      def follow_redirect(connection, response, limit)
+        url = connection.build_url_for(response['location'])
+        request = request_for(Net::HTTP::Get, url)
+        execute(url, request, limit: limit - 1)
+      end
+
       def attempt(attempt, max)
         yield
       rescue *CONNECTION_ERRORS => error

data/lib/net/hippie/connection.rb

@@ -15,8 +15,12 @@ module Net
         @http = http
       end
 
-      def run(request)
-        @http.request(request)
+      def run(request, &block)
+        if block_given?
+          @http.request(request, &block)
+        else
+          @http.request(request)
+        end
       end
 
       def build_url_for(path)

data/lib/net/hippie/version.rb

@@ -2,6 +2,6 @@
 
 module Net
   module Hippie
-    VERSION = '1.3.0'
+    VERSION = '1.4.0'
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: net-hippie
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - mo
 bindir: exe
 cert_chain: []
-date: 2025-04-30 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -198,7 +198,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.6
+rubygems_version: 3.7.2
 specification_version: 4
 summary: net/http for hippies. ☮️
 test_files: []