httpx 1.2.6 → 1.4.4

data/sig/response.rbs

@@ -1,5 +1,7 @@
 module HTTPX
   interface _Response
+    def <<: (String data) -> void
+
     def finished?: () -> bool
 
     def raise_for_status: () -> self
@@ -23,6 +25,7 @@ module HTTPX
     @options: Options
     @request: Request
     @content_type: ContentType
+    @finished: bool
 
     def copy_to: (_ToPath | _Writer destination) -> void
 
@@ -38,9 +41,11 @@ module HTTPX
 
     def content_type: () -> ContentType
 
+    def finish!: () -> void
+
     def complete?: () -> bool
 
-    def json: (?json_options opts) -> untyped
+    def json: (?JSON::options opts) -> untyped
 
     def form: () -> Hash[String, untyped]
 
@@ -77,9 +82,9 @@ module HTTPX
     @options: Options
     @error: Exception
 
-    attr_reader request: Request
+    %a{pure} attr_reader request: Request
 
-    attr_reader response: Response?
+    %a{pure} attr_reader response: Response?
 
     def status: () -> (Integer | _ToS)
 
@@ -91,7 +96,7 @@ module HTTPX
 
     private
 
-    def initialize: (Request, Exception, options) -> untyped
+    def initialize: (Request, Exception) -> untyped
   end
 
   type response = Response | ErrorResponse

data/sig/selector.rbs

@@ -1,22 +1,49 @@
 module HTTPX
+  type selectable = Connection | Resolver::Native
+
   class Selector
-    type selectable = Connection | Resolver::Native | Resolver::System
+    include _Each[selectable]
 
     READABLE: Array[Symbol]
     WRITABLE: Array[Symbol]
+
+    @timers: Timers
+
     @selectables: Array[selectable]
+    @is_timer_interval: bool
+
+    def next_tick: () -> void
+
+    def terminate: () -> void
+
+    def find_resolver: (Options options) -> Resolver::Resolver?
+
+    def find_connection: (http_uri request_uri, Options options) -> Connection?
+
+    def each_connection: () { (Connection) -> void} -> void
+                       | () -> Enumerable[Connection]
+
+    def find_mergeable_connection: (Connection connection) -> Connection?
+
+    def empty?: () -> bool
 
     def register: (selectable io) -> void
-    def deregister: (selectable io) -> selectable?
 
-    def select: (Numeric? interval) { (selectable) -> void } -> void
+    def deregister: (selectable io) -> selectable?
 
     private
 
-    def initialize: () -> untyped
+    def initialize: () -> void
+
+    def select: (Numeric? interval) { (selectable) -> void } -> void
 
     def select_many: (Numeric? interval) { (selectable) -> void } -> void
+
     def select_one: (Numeric? interval) { (selectable) -> void } -> void
+
+    def next_timeout: () -> Numeric?
+
+    def emit_error: (StandardError e) -> void
   end
 
   type io_interests = :r | :w | :rw

data/sig/session.rbs

@@ -7,49 +7,83 @@ module HTTPX
 
     @options: Options
     @responses: Hash[Request, response]
-    @persistent: bool?
+
+    # returns the HTTPX::Pool object which manages the networking required to
+    # perform requests.
+    @pool: Pool
+
+    @persistent: bool
+    @wrapped: bool
 
     def self.plugin: (Symbol | Module plugin, ?options? options) ?{ (Class) -> void } -> singleton(Session)
 
     def wrap: () { (instance) -> void } -> void
 
-    def close: (*untyped) -> void
+    def close: (?Selector selector) -> void
+
+    def build_request: (verb verb, generic_uri uri, ?request_params params, ?Options options) -> Request
+
+    def select_connection: (Connection connection, Selector selector) -> void
+
+    def pin_connection: (Resolver::Resolver | Connection connection, Selector selector) -> void
+
+    def deselect_connection: (Connection connection, Selector selector, ?bool cloned) -> void
 
-    def build_request: (verb, generic_uri, ?options) -> Request
+    def select_resolver: (Resolver::Native | Resolver::HTTPS resolver, Selector selector) -> void
+
+    def deselect_resolver: (Resolver::Resolver resolver, Selector selector) -> void
+
+    def try_clone_connection: (Connection connection, Selector selector, Integer? family) -> Connection
+
+    def find_connection: (http_uri request_uri, Selector selector, Options options) -> Connection
+
+    private
 
     def initialize: (?options) { (self) -> void } -> void
                   | (?options) -> void
 
-    private
+    def deactivate: (Selector selector) -> void
 
-    def pool: -> Pool
     def on_response: (Request, response) -> void
-    def on_promise: (untyped, untyped) -> void
-    def fetch_response: (Request request, Array[Connection] connections, untyped options) -> response?
 
-    def find_connection: (Request request, Array[Connection] connections, Options options) -> Connection
+    def on_promise: (untyped, untyped) -> void
 
-    def send_request: (Request request, Array[Connection] connections, ?Options options) -> void
+    def fetch_response: (Request request, Selector selector, Options options) -> response?
 
-    def set_connection_callbacks: (Connection connection, Array[Connection] connections, Options options, ?cloned: bool) -> void
+    def send_request: (Request request, Selector selector, ?Options options) -> void
 
     def set_request_callbacks: (Request request) -> void
 
-    def build_altsvc_connection: (Connection existing_connection, Array[Connection] connections, URI::Generic alt_origin, String origin, Hash[String, String] alt_params, Options options) -> (Connection & AltSvc::ConnectionMixin)?
-
-    def build_requests: (verb, uri, options) -> Array[Request]
-                      | (Array[[verb, uri, options]], options) -> Array[Request]
-                      | (Array[[verb, uri]], options) -> Array[Request]
-                      | (verb, _Each[[uri, options]], Options) -> Array[Request]
-                      | (verb, _Each[uri], options) -> Array[Request]
+    def build_requests: (verb, uri, request_params) -> Array[Request]
+                      | (Array[[verb, uri, request_params]], Hash[Symbol, untyped]) -> Array[Request]
+                      | (Array[[verb, uri]], request_params) -> Array[Request]
+                      | (verb, _Each[[uri, request_params]], Hash[Symbol, untyped]) -> Array[Request]
+                      | (verb, _Each[uri], request_params) -> Array[Request]
 
-    def init_connection: (http_uri uri, Options options) -> Connection
+    def do_init_connection: (Connection connection, Selector selector) -> void
 
     def send_requests: (*Request) -> Array[response]
 
-    def _send_requests: (Array[Request] requests) -> Array[Connection]
+    def _send_requests: (Array[Request] requests, Selector selector) -> void
+
+    def receive_requests: (Array[Request] requests, Selector selector) -> Array[response]
+
+    def resolve_connection: (Connection connection, Selector selector) -> void
+
+    def on_resolver_connection: (Connection connection, Selector selector) -> void
+
+    def on_resolver_close: (Resolver::Resolver resolver, Selector selector) -> void
+
+    def find_resolver_for: (Connection connection, Selector selector) -> (Resolver::Multi | Resolver::Resolver)
+
+    def coalesce_connections: (Connection conn1, Connection conn2, Selector selector, bool from_pool) -> bool
+
+    def get_current_selector: () -> Selector?
+                            | () { () -> Selector } -> Selector
+
+    def set_current_selector: (Selector? selector) -> void
 
-    def receive_requests: (Array[Request] requests, Array[Connection] connections) -> Array[response]
+    def selector_store: () -> Hash[instance, Selector]
 
     attr_reader self.default_options: Options
   end

data/sig/timers.rbs

@@ -1,10 +1,12 @@
 module HTTPX
   class Timers
+    type callback = ^() -> void
+
     @intervals: Array[Interval]
     @next_interval_at: Float
 
-    def after: (Numeric interval_in_secs, ^() -> void) -> Interval
-             | (Numeric interval_in_secs) { () -> void } -> Interval
+    def after: (Numeric interval_in_secs, ^() -> void) -> Timer
+             | (Numeric interval_in_secs) { () -> void } -> Timer
 
     def wait_interval: () -> Numeric?
 
@@ -15,8 +17,6 @@ module HTTPX
     class Interval
       include Comparable
 
-      type callback = ^() -> void
-
       attr_reader interval: Numeric
 
       @callbacks: Array[callback]
@@ -25,6 +25,8 @@ module HTTPX
 
       def on_empty: () { () -> void } -> void
 
+      def cancel: () -> void
+
       def to_f: () -> Float
 
       def <<: (callback) -> void
@@ -41,5 +43,14 @@ module HTTPX
 
       def initialize: (Numeric interval) -> void
     end
+
+    class Timer
+      @interval: Interval
+      @callback: callback
+
+      def initialize: (Interval interval, callback callback) -> void
+
+      def cancel: () -> void
+    end
   end
 end

data/sig/transcoder/body.rbs

@@ -4,10 +4,8 @@ module HTTPX
       class Error < HTTPX::Error
       end
 
-      class Encoder
-        extend Forwardable
-
-        @raw: bodyIO
+      class Encoder #  < SimpleDelegator
+        @raw: Object & bodyIO
 
         def bytesize: () -> (Integer | Float)
 

data/sig/transcoder/chunker.rbs

@@ -8,7 +8,7 @@ module HTTPX::Transcoder
     def self?.encode: (_Each[String] chunks) -> Encoder
 
     class Encoder
-      @raw: _Each[String]
+      @raw: Object & _Each[String]
 
       def each: () { (String) -> void } -> void
               | () -> Enumerator[String, void]

data/sig/transcoder/deflate.rbs

@@ -5,6 +5,7 @@ module HTTPX
       def self?.decode: (Response body, ?bytesize: Integer) -> GZIP::Inflater
 
       class Deflater < Transcoder::Deflater
+        @deflater: Zlib::Deflate
       end
     end
   end

data/sig/transcoder/form.rbs

@@ -6,6 +6,8 @@ module HTTPX::Transcoder
   type urlencoded_input = Enumerable[[_ToS, form_nested_value | Multipart::multipart_nested_value]]
 
   module Form
+    PARAM_DEPTH_LIMIT: Integer
+
     def self?.encode: (urlencoded_input form) -> (Encoder | Multipart::Encoder)
     def self?.decode: (HTTPX::Response response) -> _Decoder
     def self?.multipart?: (form_nested_value | Multipart::multipart_nested_value data) -> bool
@@ -14,6 +16,8 @@ module HTTPX::Transcoder
       extend Forwardable
       include _ToS
 
+      @raw: String
+
       def bytesize: () -> Integer
 
       def content_type: () -> String
@@ -22,5 +26,9 @@ module HTTPX::Transcoder
 
       def initialize: (urlencoded_input form) -> untyped
     end
+
+    module Decoder
+      def self?.call: (HTTPX::Response response, *untyped) -> Hash[String, untyped]
+    end
   end
 end

data/sig/transcoder/gzip.rbs

@@ -1,7 +1,7 @@
 module HTTPX
   module Transcoder
     module GZIP
-      def self?.encode: (_Encoder body) -> Deflater
+      def self?.encode: (body_encoder body) -> Deflater
       def self?.decode: (Response response, ?bytesize: Integer) -> Inflater
 
       class Deflater < Transcoder::Deflater
@@ -15,6 +15,9 @@ module HTTPX
       end
 
       class Inflater
+        @inflater: Zlib::Inflate
+        @bytesize: Integer
+
         def initialize: (Integer | Float bytesize) -> void
 
         def call: (String chunk) -> String

data/sig/transcoder/json.rbs

@@ -5,7 +5,7 @@ module HTTPX::Transcoder
     def self?.encode: (_ToJson json) -> Encoder
     def self?.decode: (HTTPX::Response response) -> _Decoder
 
-    def self?.json_load: (string source, ?json_options) -> untyped
+    def self?.json_load: (string source, ?JSON::options) -> untyped
     def self?.json_dump: (_ToJson obj, *untyped) -> String
 
     class Encoder

data/sig/transcoder/multipart.rbs

@@ -9,7 +9,7 @@ module HTTPX
 
       MULTIPART_VALUE_COND: ^(_Reader | record_multipart_value value) -> bool
 
-      type multipart_value = string | Pathname | File | _Reader
+      type multipart_value = string | Pathname | File | Tempfile | _Reader
 
       type record_multipart_value = { content_type: String, filename: String, body: multipart_value } |
                                     { content_type: String, body: multipart_value }
@@ -24,10 +24,12 @@ module HTTPX
         @form: Enumerable[[Symbol | string, Object & multipart_nested_value]]
         @parts: Array[Object & _Reader]
 
-        def bytesize: () -> Integer
+        attr_reader bytesize: Integer
 
         def content_type: () -> String
 
+        def to_s: () -> String
+
         def read: (?int? length, ?string? buffer) -> String?
 
         def rewind: () -> void
@@ -81,13 +83,13 @@ module HTTPX
 
       module Part
         def self?.call: [U] (Object & _MultipartInput multipart_input) -> [U, String, String]
-                      | (Object & multipart_nested_value input) -> ([StringIO, String, String?] | [File, String, String])
+                      | (multipart_nested_value value) -> ([StringIO, String, String?] | [File | Tempfile, String, String])
       end
 
       module MimeTypeDetector
         DEFAULT_MIMETYPE: String
 
-        def self?.call: (::IO file, String filename) -> String?
+        def self?.call: (::IO | Tempfile file, String filename) -> String?
       end
     end
   end

data/sig/transcoder/utils/body_reader.rbs

@@ -1,13 +1,13 @@
 module HTTPX
   module Transcoder
     class BodyReader
-      @body: _Reader | _Each[String]
+      @body: Object & (_Reader | _Each[String])
 
-      def initialize: (bodyIO body) -> void
+      def initialize: (body_encoder body) -> void
 
       def bytesize: () -> (Integer | Float)
 
-      def read: (?int? length, ?string outbuf) -> String?
+      def read: (?int? length, ?string? outbuf) -> String?
 
       def close: () -> void
     end

data/sig/transcoder/utils/deflater.rbs

@@ -5,16 +5,15 @@ module HTTPX
 
       @body: BodyReader
       @buffer: Response::Buffer?
-      @body: _Encoder | StringIO
       @closed: bool
 
       attr_reader content_type: String
 
-      def initialize: (_Encoder body) -> void
+      def initialize: (body_encoder body) -> void
 
       def bytesize: () -> (Integer | Float)
 
-      def read: (?int? length, ?string outbuf) -> String?
+      def read: (?int? length, ?string? outbuf) -> String?
 
       def close: () -> void
 

metadata

@@ -1,29 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: httpx
 version: !ruby/object:Gem::Version
-  version: 1.2.6
+  version: 1.4.4
 platform: ruby
 authors:
 - Tiago Cardoso
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-17 00:00:00.000000000 Z
+date: 2025-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: http-2-next
+  name: http-2
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.0.0
 description: A client library for making HTTP requests from Ruby.
 email:
 - cardoso_tiago@hotmail.com
@@ -144,6 +143,16 @@ extra_rdoc_files:
 - doc/release_notes/1_2_4.md
 - doc/release_notes/1_2_5.md
 - doc/release_notes/1_2_6.md
+- doc/release_notes/1_3_0.md
+- doc/release_notes/1_3_1.md
+- doc/release_notes/1_3_2.md
+- doc/release_notes/1_3_3.md
+- doc/release_notes/1_3_4.md
+- doc/release_notes/1_4_0.md
+- doc/release_notes/1_4_1.md
+- doc/release_notes/1_4_2.md
+- doc/release_notes/1_4_3.md
+- doc/release_notes/1_4_4.md
 files:
 - LICENSE.txt
 - README.md
@@ -259,6 +268,16 @@ files:
 - doc/release_notes/1_2_4.md
 - doc/release_notes/1_2_5.md
 - doc/release_notes/1_2_6.md
+- doc/release_notes/1_3_0.md
+- doc/release_notes/1_3_1.md
+- doc/release_notes/1_3_2.md
+- doc/release_notes/1_3_3.md
+- doc/release_notes/1_3_4.md
+- doc/release_notes/1_4_0.md
+- doc/release_notes/1_4_1.md
+- doc/release_notes/1_4_2.md
+- doc/release_notes/1_4_3.md
+- doc/release_notes/1_4_4.md
 - lib/httpx.rb
 - lib/httpx/adapters/datadog.rb
 - lib/httpx/adapters/faraday.rb
@@ -297,6 +316,7 @@ files:
 - lib/httpx/plugins/circuit_breaker.rb
 - lib/httpx/plugins/circuit_breaker/circuit.rb
 - lib/httpx/plugins/circuit_breaker/circuit_store.rb
+- lib/httpx/plugins/content_digest.rb
 - lib/httpx/plugins/cookies.rb
 - lib/httpx/plugins/cookies/cookie.rb
 - lib/httpx/plugins/cookies/jar.rb
@@ -329,6 +349,7 @@ files:
 - lib/httpx/plugins/upgrade.rb
 - lib/httpx/plugins/upgrade/h2.rb
 - lib/httpx/plugins/webdav.rb
+- lib/httpx/plugins/xml.rb
 - lib/httpx/pmatch_extensions.rb
 - lib/httpx/pool.rb
 - lib/httpx/punycode.rb
@@ -345,7 +366,6 @@ files:
 - lib/httpx/response/buffer.rb
 - lib/httpx/selector.rb
 - lib/httpx/session.rb
-- lib/httpx/session2.rb
 - lib/httpx/session_extensions.rb
 - lib/httpx/timers.rb
 - lib/httpx/transcoder.rb
@@ -362,8 +382,6 @@ files:
 - lib/httpx/transcoder/multipart/part.rb
 - lib/httpx/transcoder/utils/body_reader.rb
 - lib/httpx/transcoder/utils/deflater.rb
-- lib/httpx/transcoder/utils/inflater.rb
-- lib/httpx/transcoder/xml.rb
 - lib/httpx/utils.rb
 - lib/httpx/version.rb
 - sig/altsvc.rbs
@@ -397,6 +415,7 @@ files:
 - sig/plugins/callbacks.rbs
 - sig/plugins/circuit_breaker.rbs
 - sig/plugins/compression.rbs
+- sig/plugins/content_digest.rbs
 - sig/plugins/cookies.rbs
 - sig/plugins/cookies/cookie.rbs
 - sig/plugins/cookies/jar.rbs
@@ -420,8 +439,11 @@ files:
 - sig/plugins/rate_limiter.rbs
 - sig/plugins/response_cache.rbs
 - sig/plugins/retries.rbs
+- sig/plugins/ssrf_filter.rbs
 - sig/plugins/stream.rbs
 - sig/plugins/upgrade.rbs
+- sig/plugins/webdav.rbs
+- sig/plugins/xml.rbs
 - sig/pool.rbs
 - sig/request.rbs
 - sig/request/body.rbs
@@ -447,8 +469,6 @@ files:
 - sig/transcoder/multipart.rbs
 - sig/transcoder/utils/body_reader.rbs
 - sig/transcoder/utils/deflater.rbs
-- sig/transcoder/utils/inflater.rbs
-- sig/transcoder/xml.rbs
 - sig/utils.rbs
 homepage: https://gitlab.com/os85/httpx
 licenses:
@@ -460,7 +480,6 @@ metadata:
   source_code_uri: https://gitlab.com/os85/httpx
   homepage_uri: https://honeyryderchuck.gitlab.io/httpx/
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -475,8 +494,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: HTTPX, to the future, and beyond
 test_files: []

data/lib/httpx/session2.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "session"
-module HTTPX
-  class Session
-    def initialize(options = EMPTY_HASH, &blk)
-      @options = self.class.default_options.merge(options)
-      @responses = {}
-      @persistent = @options.persistent
-      wrap(&blk) if blk
-    end
-
-    def wrap
-      begin
-        prev_persistent = @persistent
-        @persistent = true
-        yield self
-      ensure
-        @persistent = prev_persistent
-      end
-    end
-  end
-end

data/lib/httpx/transcoder/utils/inflater.rb

@@ -1,19 +0,0 @@
-module HTTPX
-  module Transcoder
-    class Inflater
-      def initialize(bytesize)
-        @bytesize = bytesize
-      end
-
-      def call(chunk)
-        buffer = @inflater.inflate(chunk)
-        @bytesize -= chunk.bytesize
-        if @bytesize <= 0
-          buffer << @inflater.finish
-          @inflater.close
-        end
-        buffer
-      end
-    end
-  end
-end

data/lib/httpx/transcoder/xml.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-require "delegate"
-require "forwardable"
-require "uri"
-
-module HTTPX::Transcoder
-  module Xml
-    module_function
-
-    MIME_TYPES = %r{\b(application|text)/(.+\+)?xml\b}.freeze
-
-    class Encoder
-      def initialize(xml)
-        @raw = xml
-      end
-
-      def content_type
-        charset = @raw.respond_to?(:encoding) ? @raw.encoding.to_s.downcase : "utf-8"
-        "application/xml; charset=#{charset}"
-      end
-
-      def bytesize
-        @raw.to_s.bytesize
-      end
-
-      def to_s
-        @raw.to_s
-      end
-    end
-
-    def encode(xml)
-      Encoder.new(xml)
-    end
-
-    begin
-      require "nokogiri"
-
-      def decode(response)
-        content_type = response.content_type.mime_type
-
-        raise HTTPX::Error, "invalid form mime type (#{content_type})" unless MIME_TYPES.match?(content_type)
-
-        Nokogiri::XML.method(:parse)
-      end
-    rescue LoadError
-      def decode(_response)
-        raise HTTPX::Error, "\"nokogiri\" is required in order to decode XML"
-      end
-    end
-  end
-end

data/sig/transcoder/utils/inflater.rbs

@@ -1,12 +0,0 @@
-module HTTPX
-  module Transcoder
-    class Inflater
-      @inflater: Zlib::Inflate
-      @bytesize: Integer
-
-      def initialize: (Integer | Float bytesize) -> void
-
-      def call: (String chunk) -> String
-    end
-  end
-end