httpx 1.5.1 → 1.6.0

data/sig/io/udp.rbs

@@ -2,9 +2,14 @@ module HTTPX
   class UDP
     include Loggable
 
+    @host: String
+    @port: Integer
+    @io: UDPSocket
+    @options: Options
+
     def initialize: (String ip, Integer port, Options options) -> void
 
-    def to_io: () -> ::IO
+    def to_io: () -> IO
 
     def connect: () -> void
 
@@ -13,7 +18,7 @@ module HTTPX
     # :nocov:
     def close: () -> void
 
-    def read: (Integer size, ?(Buffer | String) buffer) -> Integer?
+    def read: (Integer size, String buffer) -> Integer?
 
     def write: (Buffer buffer) -> Integer?
   end

data/sig/io/unix.rbs

@@ -19,7 +19,6 @@ module HTTPX
 
     def connect: () -> void
 
-    def expired?: () -> bool
     private
 
     def build_socket: () -> Socket

data/sig/io.rbs

@@ -1,6 +1,3 @@
 module HTTPX
   type io_type = "udp" | "tcp" | "ssl" | "unix"
-
-  module IO
-  end
 end

data/sig/options.rbs

@@ -13,7 +13,8 @@ module HTTPX
     KEEP_ALIVE_TIMEOUT: Integer
     SETTINGS_TIMEOUT: Integer
     CLOSE_HANDSHAKE_TIMEOUT: Integer
-    SET_TEMPORARY_NAME: ^(Module mod, ?Symbol pl) -> void
+    SET_TEMPORARY_NAME: ^(Class klass, ?Symbol pl) -> void
+
     DEFAULT_OPTIONS: Hash[Symbol, untyped]
     REQUEST_BODY_IVARS: Array[Symbol]
 
@@ -22,6 +23,8 @@ module HTTPX
 
     def self.new: (?options) -> instance
 
+    attr_reader self.options_names: Array[Symbol]
+
     # headers
     attr_reader uri: URI?
 
@@ -53,7 +56,7 @@ module HTTPX
     attr_reader transport: io_type | nil
 
     # addresses
-    attr_reader addresses: Array[ipaddr]?
+    attr_reader addresses: Array[Resolver::Entry]?
 
     # supported_compression_formats
     attr_reader supported_compression_formats: Array[String]
@@ -70,12 +73,17 @@ module HTTPX
     # base_path
     attr_reader base_path: String?
 
-    # ssl
+    # classes
+    attr_reader resolver_native_class: singleton(Resolver::Native)
 
-    # http2_settings
+    attr_reader resolver_system_class: singleton(Resolver::System)
 
+    attr_reader resolver_https_class: singleton(Resolver::HTTPS)
+
+    attr_reader http1_class: singleton(Connection::HTTP1)
+
+    attr_reader http2_class: singleton(Connection::HTTP2)
 
-    # classes
     attr_reader connection_class: singleton(Connection)
 
     attr_reader pool_class: singleton(Pool)
@@ -92,7 +100,7 @@ module HTTPX
 
     attr_reader options_class: singleton(Options)
 
-    attr_reader resolver_class: Symbol | Class
+    attr_reader resolver_class: Symbol | singleton(Resolver::Resolver)
 
     attr_reader ssl: Hash[Symbol, untyped]
 
@@ -136,13 +144,58 @@ module HTTPX
 
     private
 
-    REQUEST_IVARS: Array[Symbol]
-
     def initialize: (?options options) -> void
 
-    def do_initialize: (?options options) -> void
-
     def access_option: (Hash[Symbol, untyped] | Object | nil obj, Symbol k, Hash[Symbol, Symbol]? ivar_map) -> untyped
+
+    # integer
+    def option_max_concurrent_requests: (Numeric value) -> Numeric
+    def option_max_requests: (Numeric value) -> Numeric
+    def option_window_size: (Numeric value) -> Numeric
+    def option_buffer_size: (Numeric value) -> Numeric
+    def option_body_threshold_size: (Numeric value) -> Numeric
+    def option_debug_level: (Numeric value) -> Numeric
+
+    # to hash
+    def option_ssl: (_ToHash[Symbol, untyped] value) -> Hash[Symbol, untyped]
+    def option_http2_settings: (_ToHash[Symbol, untyped] value) -> Hash[Symbol, untyped]
+    def option_resolver_options: (_ToHash[Symbol, untyped] value) -> Hash[Symbol, untyped]
+    def option_pool_options: (_ToHash[Symbol, untyped] value) -> Hash[Symbol, untyped]
+
+    # no transform
+    def option_request_class: (singleton(Request) value) -> singleton(Request)
+    def option_response_class: (singleton(Response) value) -> singleton(Response)
+    def option_headers_class: (singleton(Headers) value) -> singleton(Headers)
+    def option_request_body_class: (singleton(Request::Body) value) -> singleton(Request::Body)
+    def option_response_body_class: (singleton(Response::Body) value) -> singleton(Response::Body)
+    def option_connection_class: (singleton(Connection) value) -> singleton(Connection)
+    def option_options_class: (singleton(Options) value) -> singleton(Options)
+    def option_pool_class: (singleton(Pool) value) -> singleton(Pool)
+    def option_resolver_class: (Symbol | singleton(Resolver::Resolver) value) -> (Symbol | singleton(Resolver::Resolver))
+    def option_io: (io_option value) -> io_option
+    def option_fallback_protocol: (String value) -> String
+    def option_debug: (_IOLogger value) -> _IOLogger
+    def option_debug_redact: (bool value) -> bool
+    def option_compress_request_body: (bool value) -> bool
+    def option_decompress_response_body: (bool value) -> bool
+    def option_persistent: (bool value) -> bool
+    def option_close_on_fork: (bool value) -> bool
+
+    def option_origin: (http_uri | String value) -> http_uri
+
+    def option_base_path: (_ToStr value) -> String
+
+    def option_headers: (headers_input | Headers value) -> Headers
+
+    def option_timeout: (_ToHash[timeout_type, Numeric?]) -> timeout
+
+    def option_supported_compression_formats: (_ToS | _ToAry[_ToS] value) -> Array[String]
+
+    def option_transport: (_ToS value) -> String
+
+    def option_addresses: (ipaddr | _ToAry[ipaddr] value) -> Array[ipaddr]
+
+    def option_ip_families: (Integer | _ToAry[Integer] value) -> Array[Integer]
   end
 
   type options = Options | Hash[Symbol, untyped]

data/sig/plugins/fiber_concurrency.rbs

@@ -0,0 +1,51 @@
+module HTTPX
+  module Plugins
+    module FiberConcurrency
+      module InstanceMethods
+      end
+
+      module RequestMethods
+        attr_reader context: Fiber?
+
+        def set_context!: () -> void
+
+        def current_context?: () -> bool
+      end
+
+      module ConnectionMethods
+
+        def current_context?: () -> bool
+
+        def send: (request request) -> void
+      end
+
+      module HTTP1Methods
+      end
+
+      module HTTP2Methods
+        @contexts: Hash[Fiber, Set[Request]]
+
+        private
+
+        def add_to_context: (request request) -> void
+
+        def clear_from_context: (request request) -> void
+      end
+
+      module NativeResolverMethods
+      end
+
+      module SystemResolverMethods
+      end
+
+      module FiberConcurrencyH2C
+        module HTTP2Methods
+        end
+      end
+
+      type request = Request & RequestMethods
+    end
+
+    type sessionFiberConcurrency = Session & FiberConcurrency::InstanceMethods
+  end
+end

data/sig/plugins/h2c.rbs

@@ -7,7 +7,11 @@ module HTTPX
       def self.configure: (singleton(Session)) -> void
       def self.call: (Connection, Request, response) -> void
 
-      class H2CParser < Connection::HTTP2
+      interface _H2COptions
+        def h2c_class: () -> (singleton(Connection::HTTP2) & H2CParser)
+      end
+
+      module H2CParser
         def upgrade: (Request, Response) -> void
       end
 

data/sig/plugins/persistent.rbs

@@ -9,6 +9,6 @@ module HTTPX
       end
     end
 
-    type sessionPersistent = Session & Persistent::InstanceMethods
+    type sessionPersistent = sessionFiberConcurrency & Persistent::InstanceMethods
   end
 end

data/sig/plugins/proxy/socks4.rbs

@@ -1,5 +1,5 @@
 module HTTPX
-  class Socks4Error < HTTPProxyError
+  class Socks4Error < ProxyError
   end
 
   module Plugins

data/sig/plugins/proxy/socks5.rbs

@@ -1,5 +1,5 @@
 module HTTPX
-  class Socks5Error < HTTPProxyError
+  class Socks5Error < ProxyError
   end
 
   module Plugins

data/sig/plugins/proxy.rbs

@@ -1,8 +1,9 @@
 module HTTPX
-  class HTTPProxyError < ConnectionError
+  class ProxyError < ConnectionError
   end
 
   class ProxySSL < SSL
+    attr_reader proxy_io: TCP | SSL
   end
 
   module Plugins
@@ -11,7 +12,9 @@ module HTTPX
     end
 
     module Proxy
-      Error: singleton(HTTPProxyError)
+      class ProxyConnectionError < ProxyError
+      end
+
       PROXY_ERRORS: Array[singleton(StandardError)]
 
       class Parameters

data/sig/plugins/ssrf_filter.rbs

@@ -8,7 +8,7 @@ module HTTPX
 
       IPV6_BLACKLIST: Array[[IPAddr, IPAddr]]
 
-      def self?.unsafe_ip_address?: (IPAddr) -> bool
+      def self?.unsafe_ip_address?: (Resolver::Entry ipaddr) -> bool
 
       interface _Options
         def allowed_schemes: () -> Array[String]

data/sig/plugins/stream_bidi.rbs

@@ -25,8 +25,8 @@ module HTTPX
 
       class Signal
         @closed: bool
-        @pipe_read: ::IO
-        @pipe_write: ::IO
+        @pipe_read: IO
+        @pipe_write: IO
 
         include _Selectable
 

data/sig/request.rbs

@@ -1,6 +1,7 @@
 module HTTPX
   class Request
     extend Forwardable
+    include Loggable
     include Callbacks
 
     METHODS: Array[Symbol]
@@ -16,7 +17,7 @@ module HTTPX
     attr_reader drain_error: StandardError?
     attr_reader active_timeouts: Array[Symbol]
 
-    attr_accessor peer_address: ipaddr?
+    attr_accessor peer_address: (String | IPAddr)?
 
     attr_writer persistent: bool
 
@@ -29,6 +30,8 @@ module HTTPX
 
     def initialize: (Symbol | String verb, generic_uri uri, Options options, ?request_params params) -> untyped
 
+    def complete!: (?response response) -> void
+
     def ping?: () -> bool
 
     def ping!: () -> void

data/sig/resolver/entry.rbs

@@ -0,0 +1,13 @@
+module HTTPX
+  class Resolver::Entry
+    attr_reader address: IPAddr | String
+
+    @expires_in: Numeric
+
+    def initialize: (IPAddr | _ToS address, ?Numeric expires_in, ?rescue_on_convert: boolish) -> void
+
+    def expired?: () -> bool
+
+    def self.convert: (IPAddr | _ToS address) -> Resolver::Entry
+  end
+end

data/sig/resolver/native.rbs

@@ -23,6 +23,7 @@ module HTTPX
       @large_packet: Buffer?
       @io: UDP | TCP
       @name: String?
+      @timer: Timers::Timer?
 
       attr_reader state: Symbol
 

data/sig/resolver/resolver.rbs

@@ -22,7 +22,6 @@ module HTTPX
 
       @record_type: singleton(Resolv::DNS::Resource)
       @resolver_options: Hash[Symbol, untyped]
-      @system_resolver: Resolv::Hosts
       @connections: Array[Connection]
 
       def close: () -> void
@@ -35,7 +34,7 @@ module HTTPX
 
       def each_connection: () { (Connection connection) -> void } -> void
 
-      def emit_addresses: (Connection connection, ip_family family, Array[IPAddr], ?bool early_resolve) -> void
+      def emit_addresses: (Connection connection, ip_family family, Array[ipaddr], ?bool early_resolve) -> void
 
       def self.multi?: () -> bool
 
@@ -43,7 +42,7 @@ module HTTPX
 
       def resolve: (?Connection connection, ?String hostname) -> void
 
-      def emit_resolved_connection: (Connection connection, Array[IPAddr] addresses, bool early_resolve) -> void
+      def emit_resolved_connection: (Connection connection, Array[ipaddr] addresses, bool early_resolve) -> void
 
       def initialize: (ip_family family, Options options) -> void
 

data/sig/resolver/system.rbs

@@ -11,8 +11,8 @@ module HTTPX
       @queries: Array[[ip_family, Connection]]
       @ips: Array[[ip_family, Connection, (Array[Addrinfo] | StandardError)]]
       @pipe_mutex: Thread::Mutex
-      @pipe_read: ::IO
-      @pipe_write: ::IO
+      @pipe_read: IO
+      @pipe_write: IO
 
       attr_reader state: Symbol
 

data/sig/resolver.rbs

@@ -1,5 +1,5 @@
 module HTTPX
-  type ipaddr = IPAddr | String
+  type ipaddr = String | IPAddr | Resolv::IPv4 | Resolver::Entry
 
   module Resolver
     type dns_resource = singleton(Resolv::DNS::Resource)
@@ -13,26 +13,25 @@ module HTTPX
     self.@lookups: Hash[String, Array[dns_result]]
     self.@identifier_mutex: Thread::Mutex
     self.@identifier: Integer
-    self.@system_resolver: Resolv::Hosts
+    self.@hosts_resolver: Resolv::Hosts
 
     type dns_decoding_response = [:ok, Array[dns_result]] | [:decode_error, Resolv::DNS::DecodeError] | [:dns_error, Integer] | Symbol
 
-    def self?.nolookup_resolve: (String hostname) -> Array[IPAddr]?
+    def self?.nolookup_resolve: (String hostname) -> Array[Entry]?
 
-    def self?.ip_resolve: (String hostname) -> Array[IPAddr]?
+    def self?.ip_resolve: (String hostname) -> Array[Entry]?
 
-    def self?.system_resolve: (String hostname) -> Array[IPAddr]?
+    def self?.hosts_resolve: (String hostname) -> Array[Entry]?
 
-    def self?.resolver_for: (:native resolver_type) -> singleton(Native) |
-                            (:system resolver_type) -> singleton(System) |
-                            (:https resolver_type) -> singleton(HTTPS) |
-                            [U] (U resolver_type) -> U
+    def self?.resolver_for: (Symbol | singleton(Resolver) resolver_type, Options options) -> singleton(Resolver)
 
-    def self?.cached_lookup: (String hostname) -> Array[IPAddr]?
+    def self?.cached_lookup: (String hostname) -> Array[Entry]?
 
     def self?.cached_lookup_set: (String hostname, ip_family family, Array[dns_result] addresses) -> void
 
-    def self?.lookup: (String hostname, Hash[String, Array[dns_result]] lookups, Numeric ttl) -> Array[IPAddr]?
+    def self?.cached_lookup_evict: (String hostname, _ToS ip) -> void
+
+    def self?.lookup: (String hostname, Hash[String, Array[dns_result]] lookups, Numeric ttl) -> Array[Entry]?
 
     def self?.generate_id: () -> Integer
 

data/sig/response.rbs

@@ -35,7 +35,7 @@ module HTTPX
 
     def uri: () -> URI::Generic
 
-    def peer_address: () -> ipaddr?
+    def peer_address: () -> (String | IPAddr)?
 
     def merge_headers: (_Each[[String, headers_value]]) -> void
 
@@ -90,7 +90,7 @@ module HTTPX
 
     def uri: () -> URI::Generic
 
-    def peer_address: () -> ipaddr?
+    def peer_address: () -> (String | IPAddr)?
 
     def close: () -> void
 

data/sig/selector.rbs

@@ -2,7 +2,7 @@ module HTTPX
   interface _Selectable
     def state: () -> Symbol
 
-    def to_io: () -> ::IO
+    def to_io: () -> IO
 
     def call: () -> void
 
@@ -14,14 +14,20 @@ module HTTPX
   end
 
   class Selector
-    include _Each[_Selectable]
+    type selectable = Resolver::Resolver | Connection | (Object & _Selectable)
 
-    READABLE: Array[Symbol]
-    WRITABLE: Array[Symbol]
+    type io_select_selectable = (selectable | Array[selectable])?
+
+    include _Each[selectable]
+
+    extend Forwardable
+
+    READABLE: Array[io_interests]
+    WRITABLE: Array[io_interests]
 
     @timers: Timers
 
-    @selectables: Array[_Selectable]
+    @selectables: Array[selectable]
     @is_timer_interval: bool
 
     def next_tick: () -> void
@@ -39,21 +45,23 @@ module HTTPX
 
     def empty?: () -> bool
 
-    def register: (_Selectable io) -> void
+    def register: (selectable io) -> void
 
-    def deregister: (_Selectable io) -> _Selectable?
+    def deregister: (selectable io) -> selectable?
 
     private
 
     def initialize: () -> void
 
-    def select: (Numeric? interval) { (_Selectable) -> void } -> void
+    def select: (Numeric? interval) { (selectable) -> void } -> void
 
-    def select_many: (Numeric? interval) { (_Selectable) -> void } -> void
+    def select_many: (io_select_selectable r, io_select_selectable w, Numeric? interval) { (selectable) -> void } -> void
 
-    def select_one: (Numeric? interval) { (_Selectable) -> void } -> void
+    def select_one: (selectable io, io_interests interests, Numeric? interval) { (selectable) -> void } -> void
 
     def next_timeout: () -> Numeric?
+
+    def rw_wait: (io_select_selectable IO, Numeric? interval) -> untyped?
   end
 
   type io_interests = :r | :w | :rw

data/sig/session.rbs

@@ -40,6 +40,8 @@ module HTTPX
     def initialize: (?options) { (self) -> void } -> void
                   | (?options) -> void
 
+    def selector_close: (Selector close) -> void
+
     def deactivate: (Selector selector) -> void
 
     def on_promise: (untyped, untyped) -> void
@@ -81,6 +83,8 @@ module HTTPX
 
     def selector_store: () -> Hash[instance, Selector]
 
+    def thread_selector_store: (Thread th) -> Hash[instance, Selector]?
+
     attr_reader self.default_options: Options
     self.@plugins: Array[Module]
 

data/sig/transcoder/form.rbs

@@ -3,14 +3,14 @@ module HTTPX::Transcoder
 
   type form_nested_value = form_value | _ToAry[form_value] | _ToHash[string, form_value]
 
-  type urlencoded_input = Enumerable[[_ToS, form_nested_value | Multipart::multipart_nested_value]]
+  type urlencoded_input = Enumerable[[_ToS, form_nested_value]]
 
   module Form
     PARAM_DEPTH_LIMIT: Integer
 
-    def self?.encode: (urlencoded_input form) -> (Encoder | Multipart::Encoder)
+    def self?.encode: (urlencoded_input form) -> Encoder
+
     def self?.decode: (HTTPX::Response response) -> _Decoder
-    def self?.multipart?: (form_nested_value | Multipart::multipart_nested_value data) -> bool
 
     class Encoder
       extend Forwardable

data/sig/transcoder/multipart.rbs

@@ -16,6 +16,12 @@ module HTTPX
 
       type multipart_nested_value = multipart_value | _ToAry[multipart_value] | _ToHash[string, multipart_value]
 
+      type multipart_input = Enumerable[[_ToS, Multipart::multipart_nested_value]]
+
+      def self?.encode: (multipart_input form_data) -> Multipart::Encoder
+
+      def self?.multipart?: (form_nested_value | multipart_nested_value form_data) -> bool
+
       class Encoder
         @boundary: String
         @part_index: Integer
@@ -36,9 +42,9 @@ module HTTPX
 
         private
 
-        def to_parts: (Enumerable[[Symbol | string, multipart_nested_value]] multipart_data) -> Array[_Reader]
+        def to_parts: (multipart_input multipart_data) -> Array[_Reader]
 
-        def initialize: (Enumerable[[Symbol | string, multipart_nested_value]] multipart_data) -> untyped
+        def initialize: (multipart_input multipart_data) -> untyped
 
         def header_part: (String key, String content_type, String? filename) -> StringIO
 
@@ -90,7 +96,7 @@ module HTTPX
       module MimeTypeDetector
         DEFAULT_MIMETYPE: String
 
-        def self?.call: (::IO | Tempfile file, String filename) -> String?
+        def self?.call: (IO | Tempfile file, String filename) -> String?
       end
     end
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: httpx
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.6.0
 platform: ruby
 authors:
 - Tiago Cardoso
 bindir: bin
 cert_chain: []
-date: 2025-06-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http-2
@@ -155,6 +155,7 @@ extra_rdoc_files:
 - doc/release_notes/1_4_4.md
 - doc/release_notes/1_5_0.md
 - doc/release_notes/1_5_1.md
+- doc/release_notes/1_6_0.md
 files:
 - LICENSE.txt
 - README.md
@@ -282,6 +283,7 @@ files:
 - doc/release_notes/1_4_4.md
 - doc/release_notes/1_5_0.md
 - doc/release_notes/1_5_1.md
+- doc/release_notes/1_6_0.md
 - lib/httpx.rb
 - lib/httpx/adapters/datadog.rb
 - lib/httpx/adapters/faraday.rb
@@ -327,6 +329,7 @@ files:
 - lib/httpx/plugins/cookies/set_cookie_parser.rb
 - lib/httpx/plugins/digest_auth.rb
 - lib/httpx/plugins/expect.rb
+- lib/httpx/plugins/fiber_concurrency.rb
 - lib/httpx/plugins/follow_redirects.rb
 - lib/httpx/plugins/grpc.rb
 - lib/httpx/plugins/grpc/call.rb
@@ -362,6 +365,7 @@ files:
 - lib/httpx/request.rb
 - lib/httpx/request/body.rb
 - lib/httpx/resolver.rb
+- lib/httpx/resolver/entry.rb
 - lib/httpx/resolver/https.rb
 - lib/httpx/resolver/multi.rb
 - lib/httpx/resolver/native.rb
@@ -428,6 +432,7 @@ files:
 - sig/plugins/cookies/set_cookie_parser.rbs
 - sig/plugins/digest_auth.rbs
 - sig/plugins/expect.rbs
+- sig/plugins/fiber_concurrency.rbs
 - sig/plugins/follow_redirects.rbs
 - sig/plugins/grpc.rbs
 - sig/plugins/grpc/call.rbs
@@ -461,6 +466,7 @@ files:
 - sig/request.rbs
 - sig/request/body.rbs
 - sig/resolver.rbs
+- sig/resolver/entry.rbs
 - sig/resolver/https.rbs
 - sig/resolver/multi.rbs
 - sig/resolver/native.rbs
@@ -507,7 +513,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: HTTPX, to the future, and beyond
 test_files: []