httpx 1.8.4 → 1.9.1

data/sig/io/tcp.rbs

@@ -25,6 +25,7 @@ module HTTPX
     @keep_open: bool
 
     @ip_index: Integer
+    @attempt_started_at: Float?
 
     # TODO: lift when https://github.com/ruby/rbs/issues/1497 fixed
     def initialize: (URI::Generic origin, Array[Resolver::Entry]? addresses, Options options) ?{ (instance) -> void } -> void
@@ -33,6 +34,10 @@ module HTTPX
 
     def addresses?: () -> bool
 
+    def connect_attempt_time_left: () -> Float?
+
+    def next_address!: (StandardError e) -> void
+
     def to_io: () -> IO
 
     def protocol: () -> String

data/sig/options.rbs

@@ -10,9 +10,6 @@ module HTTPX
     CONNECT_TIMEOUT: Integer
     READ_TIMEOUT: Integer
     WRITE_TIMEOUT: Integer
-    REQUEST_TIMEOUT: Integer
-    TOTAL_REQUEST_TIMEOUT: Integer
-    OPERATION_TIMEOUT: Integer
     KEEP_ALIVE_TIMEOUT: Integer
     PING_TIMEOUT: Integer
     SETTINGS_TIMEOUT: Integer
@@ -26,22 +23,21 @@ module HTTPX
     USER_AGENT: String
 
     type timeout_type = :connect_timeout | :settings_timeout | :close_handshake_timeout | :operation_timeout | :keep_alive_timeout | :read_timeout | :write_timeout | :total_request_timeout | :request_timeout | :ping_timeout
-    type timeout = Hash[timeout_type, interval?]
     type redact_value = :headers | :body | bool
     type resolver_cache_option = :memory | :file | (Object & Resolver::_Cache)
 
     def self.new: (?options) -> instance
 
-    attr_reader self.options_names: Array[Symbol]
+    attr_reader self.options_names: Set[Symbol]
 
     # headers
     attr_reader uri: URI?
 
     # headers
-    attr_reader headers: headers?
+    attr_reader headers: headers
 
     # timeout
-    attr_reader timeout: timeout
+    attr_reader timeout: Timeouts
 
     # http2_settings
     attr_reader http2_settings: Hash[Symbol, Integer | bool]
@@ -74,7 +70,7 @@ module HTTPX
     attr_reader transport: io_type | nil
 
     # addresses
-    attr_reader addresses: Array[Resolver::Entry]?
+    attr_reader addresses: (Hash[String, Array[Resolver::Entry]] | Array[Resolver::Entry])?
 
     # supported_compression_formats
     attr_reader supported_compression_formats: Array[String]
@@ -174,8 +170,6 @@ module HTTPX
 
     def do_initialize: () -> void
 
-    def access_option: (Hash[Symbol, untyped] | Object | nil obj, Symbol k, Hash[Symbol, Symbol]? ivar_map) -> untyped
-
     # integer
     def option_max_concurrent_requests: (int value) -> maybe_unbounded
     def option_max_requests: (int value) -> maybe_unbounded
@@ -217,15 +211,52 @@ module HTTPX
 
     def option_headers: (headers_input | Headers value) -> Headers
 
-    def option_timeout: (_ToHash[timeout_type, interval?]) -> timeout
+    def option_timeout: (Timeouts | _ToHash[timeout_type, interval?]) -> Timeouts
 
     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_addresses: (ipaddr | _ToAry[ipaddr] value) -> Array[Resolver::Entry]
+                        | (Hash[String,  _ToAry[ipaddr]] value) -> Hash[String, Array[Resolver::Entry]]
 
     def option_ip_families: (ip_family | _ToAry[ip_family] value) -> Array[ip_family]
+
+    class Timeouts
+      attr_reader connect_timeout: interval?
+      attr_reader settings_timeout: interval?
+      attr_reader read_timeout: interval?
+      attr_reader write_timeout: interval?
+      attr_reader request_timeout: interval?
+      attr_reader total_request_timeout: interval?
+      attr_reader operation_timeout: interval?
+      attr_reader close_handshake_timeout: interval
+      attr_reader keep_alive_timeout: interval
+      attr_reader ping_timeout: interval
+
+      def initialize: (
+        ?connect_timeout: interval?,
+        ?settings_timeout: interval?,
+        ?read_timeout: interval?,
+        ?write_timeout: interval?,
+        ?request_timeout: interval?,
+        ?total_request_timeout: interval?,
+        ?operation_timeout: interval?,
+        ?close_handshake_timeout: interval?,
+        ?keep_alive_timeout: interval?,
+        ?ping_timeout: interval?
+      ) -> void
+
+      def merge: (Timeouts | Hash[Symbol, interval?]) -> Timeouts
+
+      def []: (Symbol) -> interval?
+
+      def to_h: () -> Hash[Symbol, interval?]
+
+      private
+
+      def deadline_timeouts?: () -> boolish
+    end
   end
 
   type options = Options | Hash[Symbol, untyped]

data/sig/parser/http1.rbs

@@ -18,7 +18,7 @@ module HTTPX
       VERSIONS: Array[String]
 
       attr_reader status_code: Integer
-      attr_reader http_version: [Integer, Integer]
+      attr_reader http_version: String
       attr_reader headers: parsed_headers
 
       @observer: _HTTP1Events

data/sig/plugins/auth/digest.rbs

@@ -8,7 +8,6 @@ module HTTPX
         @user: String
         @password: String
         @hashed: bool
-        @nonce: Integer
 
         def can_authenticate?: (String? authenticate) -> boolish
 

data/sig/plugins/auth.rbs

@@ -1,14 +1,14 @@
 module HTTPX
   module Plugins
     module Auth
-      type auth_header_value_type = String | ^(?Request request, ?bool should_regenerate) -> string
+      type auth_header_value_type = String | ^(?requestAuth request, ?bool should_regenerate) -> string
 
       interface _AuthOptions
         def auth_header_value: () -> auth_header_value_type?
 
         def auth_header_type: () -> String?
 
-        def auth_header_expires_at: () -> (^(Request request) -> _ToF?)?
+        def auth_header_expires_at: () -> (^(requestAuth request) -> _ToF?)?
 
         def auth_header_expires_in: () -> Float?
       end
@@ -17,10 +17,11 @@ module HTTPX
         @auth_header_value: String?
         @auth_header_value_mtx: Thread::Mutex
         @skip_auth_header_value: bool
+        @auth_header_expires_at: interval?
 
-        def authorization: (?string token, ?auth_header_type: string) ?{ (?Request, ?bool) -> string } -> instance
+        def authorization: (?string token, ?auth_header_type: string) ?{ (?requestAuth, ?bool) -> string } -> instance
 
-        def bearer_auth: (?string token) ?{ (Request) -> string } -> instance
+        def bearer_auth: (?string token) ?{ (requestAuth) -> string } -> instance
 
         def skip_auth_header: [T] { () -> T } -> T
 
@@ -28,7 +29,11 @@ module HTTPX
 
         private
 
-        def generate_auth_token: (Request & RequestMethods request, bool should_regenerate) -> String?
+        def generate_auth_token: (requestAuth request, bool should_regenerate) -> String?
+
+        def try_invalidate_auth_header_value: () -> void
+
+        def set_auth_header_expires_at: (requestAuth request) -> void
 
         def dynamic_auth_token?: (auth_header_value_type auth_header_value) -> boolish
       end
@@ -52,6 +57,8 @@ module HTTPX
           def auth_error?: (response response, Options options) -> boolish
         end
       end
+
+      type requestAuth = Request & RequestMethods
     end
 
     type sessionAuth = Session & Auth::InstanceMethods

data/sig/plugins/expect.rbs

@@ -24,6 +24,12 @@ module HTTPX
         @informational_status: Integer?
       end
 
+      module ConnectionMethods
+        private
+
+        def set_request_expect_timeout: (Request request) -> void
+      end
+
       interface _ExpectOptions
         def expect_timeout: () -> Integer?
 

data/sig/plugins/fiber_concurrency.rbs

@@ -16,19 +16,28 @@ module HTTPX
 
         def current_context?: () -> boolish
 
+        def closed_for_select?: () -> bool
+
         def send: (request request) -> void
 
         private
 
-        def backlog?: () -> bool
+        def backlog?: () -> boolish
+
+        def clear_pending_requests: () -> void
       end
 
       module HTTP1Methods
+        def interests: () -> io_interests?
+
+        def backlog?: () -> bool
       end
 
       module HTTP2Methods
         @contexts: Hash[Fiber, Set[Request]]
 
+        def backlog?: () -> bool
+
         private
 
         def add_to_context: (request request) -> void

data/sig/plugins/hedging.rbs

@@ -0,0 +1,44 @@
+module HTTPX
+  module Plugins
+    module Hedging
+      interface _HedgingOptions
+        def hedge_after: () -> (^(requestHedging request, Response response) -> interval | interval)?
+      end
+
+      module InstanceMethods
+        private
+
+        def hedge_connection: (connectionHedging connection) -> connectionHedging
+
+        def hedge_request!: (requestHedging request, connectionHedging connection, Selector selector) -> void
+
+        def when_to_hedge: (requestHedging request) -> interval?
+      end
+
+      module RequestMethods
+        attr_reader hedge_request: requestHedging?
+
+        @is_hedge_request: bool
+
+        def hedge_request=: (requestHedging? request) -> void
+      end
+
+      module ConnectionMethods
+        attr_reader hedge_connection: connectionHedging?
+
+        attr_accessor is_hedge_connection: bool
+
+        def hedge_connection=: (connectionHedging? connection) -> void
+
+        def try_yield_connection: [T] () { (connectionHedging) -> T } -> T
+      end
+    end
+    type optionsHedging = Options & Hedging::_HedgingOptions
+
+    type sessionHedging = Session & Hedging::InstanceMethods
+
+    type requestHedging = Request & Hedging::RequestMethods
+
+    type connectionHedging = Connection & Hedging::ConnectionMethods
+  end
+end

data/sig/plugins/proxy/http.rbs

@@ -2,6 +2,13 @@ module HTTPX
   module Plugins
     module Proxy
       module HTTP
+        module OptionsMethods
+          def connect_request_class: () -> singleton(Request) # & ConnectRequestMethods)
+
+          def proxy_headers: () -> Headers?
+
+          def enable_proxy_tunnel: () -> bool?
+        end
 
         module InstanceMethods
           def with_proxy_basic_auth: (Hash[Symbol, untyped] opts) -> instance
@@ -14,14 +21,14 @@ module HTTPX
         module ConnectionMethods
           @tunnel_parser: Connection::HTTP1 | Connection::HTTP2
 
-          def __http_proxy_connect: (Connection::_Parser parser) ->  void
+          def __http_proxy_connect: () ->  void
           def __http_on_connect: (top, Response) ->  void
         end
 
         module ProxyParser
         end
 
-        class ConnectRequest < Request
+        module ConnectRequestMethods : Request
           def initialize: (generic_uri uri, Options options) -> void
         end
       end

data/sig/plugins/proxy.rbs

@@ -26,6 +26,7 @@ module HTTPX
 
         @ns: Integer
         @uris: Array[URI::Generic | String]
+        @initial_credentials: boolish
         @authenticator: _Authenticator
 
         def shift: () -> void
@@ -38,7 +39,7 @@ module HTTPX
 
         private
 
-        def initialize: (?uri: generic_uri | Array[generic_uri], ?scheme: String, ?username: String, ?password: String, ?no_proxy: Array[generic_uri] | generic_uri, **untyped) -> void
+        def initialize: (?uri: generic_uri | Array[generic_uri], ?ns: Integer, ?scheme: String?, ?username: String?, ?password: String?, ?no_proxy: Array[generic_uri] | generic_uri | nil, **untyped) -> void
 
         def infer_default_auth_scheme: (URI::Generic uri) -> String?
 
@@ -58,7 +59,7 @@ module HTTPX
       end
 
       module InstanceMethods
-        @__proxy_uris: Array[generic_uri]
+        @proxy_parameters: Parameters?
 
         private
 

data/sig/plugins/retries.rbs

@@ -45,11 +45,11 @@ module HTTPX
 
         def try_partial_retry: (retriesRequest request, retriesResponse response) -> void
 
-        def prepare_to_retry: (retriesRequest request, retriesResponse response) -> void
+        def prepare_to_retry: (retriesRequest request, retriesResponse response, interval? retry_after) -> void
 
         def can_reconnect?: (retriesRequest request, retriesResponse response) -> bool
 
-        def when_to_retry: (retriesRequest request, retriesResponse response, retriesOptions options) -> Numeric?
+        def when_to_retry: (retriesRequest request, retriesResponse response, retriesOptions options) -> interval?
       end
 
       module RequestMethods

data/sig/plugins/stream_bidi.rbs

@@ -33,8 +33,6 @@ module HTTPX
         include _Selectable
 
         def wakeup: () -> void
-
-        def inflight?: () -> bool
       end
 
       module InstanceMethods

data/sig/plugins/tracing.rbs

@@ -2,13 +2,13 @@ module HTTPX
   module Plugins
     module Tracing
       interface _Tracer
-        def enabled?: (retriesRequest request) -> boolish
+        def enabled?: (tracingRequest request) -> boolish
 
-        def start: (retriesRequest request) -> void
+        def start: (tracingRequest request) -> void
 
-        def reset: (retriesRequest request) -> void
+        def reset: (tracingRequest request) -> void
 
-        def finish: (retriesRequest request, response response) -> void
+        def finish: (tracingRequest request, response response) -> void
       end
 
       class Wrapper
@@ -27,13 +27,30 @@ module HTTPX
 
       module RequestMethods
         attr_accessor init_time: Time?
+
+        attr_accessor handshake_time: Float?
+
+        attr_accessor enqueue_time: Time?
+
+        private
+
+        def calculate_init_time: () -> Time
       end
 
       module ConnectionMethods
         @init_time: Time?
       end
 
-      type retriesRequest = Request & RequestMethods
+      module HTTP2Methods
+        @handshake_init_time: Time
+        @pending: Array[tracingRequest]
+
+        private
+
+        def on_settings: (*untyped) -> void
+      end
+
+      type tracingRequest = Request & RequestMethods
     end
 
     type sessionTracing = Session

data/sig/request/body.rbs

@@ -4,7 +4,7 @@ module HTTPX
 
     @headers: Headers
     @body: body_encoder?
-    @unbounded_body: bool
+    @unbounded_body: bool?
 
     def initialize: (Headers h, Options options, **untyped) -> void
 

data/sig/resolver/entry.rbs

@@ -4,10 +4,10 @@ module HTTPX
 
     @expires_in: interval
 
-    def initialize: (IPAddr | _ToS address, ?Numeric expires_in, ?rescue_on_convert: boolish) -> void
+    def initialize: (ipaddr address, ?Numeric expires_in, ?rescue_on_convert: boolish) -> void
 
     def expired?: () -> bool
 
-    def self.convert: (IPAddr | _ToS address) -> Resolver::Entry
+    def self.convert: (ipaddr address) -> Resolver::Entry
   end
 end

data/sig/resolver/https.rbs

@@ -37,6 +37,8 @@ module HTTPX
 
       # def closed?: () -> bool
 
+      def closed_for_select?: () -> bool
+
       def deactivate: () -> void
 
       def terminate: () -> void

data/sig/resolver/native.rbs

@@ -23,10 +23,13 @@ module HTTPX
       @large_packet: Buffer?
       @io: UDP | TCP
       @name: String?
+      @message_id: Integer?
       @timer: Timers::Timer?
 
       attr_reader state: Symbol
 
+      def closed_for_select?: () -> bool
+
       def call: () -> void
 
       def interests: () -> (:r | :w | nil)

data/sig/resolver/resolver.rbs

@@ -13,7 +13,7 @@ module HTTPX
 
       attr_reader options: Options
 
-      attr_writer current_selector: Selector?
+      attr_accessor current_selector: Selector?
 
       attr_writer current_session: Session?
 

data/sig/resolver/system.rbs

@@ -19,6 +19,8 @@ module HTTPX
 
       attr_reader state: Symbol
 
+      def closed_for_select?: () -> bool
+
       def initialize: (Options options) -> void
 
       private

data/sig/resolver.rbs

@@ -17,7 +17,7 @@ module HTTPX
     self.@hosts_resolver: Resolv::Hosts
     self.@supported_ip_families: Array[Integer]
 
-    type dns_decoding_response = [:ok, Array[dns_result]] | [:decode_error, Resolv::DNS::DecodeError] | [:retriable_error | :dns_error, Integer] | Symbol
+    type dns_decoding_response = [:ok, Array[dns_result], Integer] | [:decode_error, Resolv::DNS::DecodeError] | [:retriable_error | :dns_error, Integer, Integer] | [:no_domain_found | :message_truncated, nil, Integer]
 
     def self?.supported_ip_families: () -> Array[ip_family]
 

data/sig/response.rbs

@@ -60,8 +60,7 @@ module HTTPX
   end
 
   class ContentType
-    MIME_TYPE_RE: Regexp
-    CHARSET_RE: Regexp
+    SPLIT_PATTERN: Regexp
 
     @header_value: String?
     @mime_type: String?

data/sig/selector.rbs

@@ -2,6 +2,8 @@ module HTTPX
   interface _Selectable
     def state: () -> Symbol
 
+    def closed_for_select?: () -> bool
+
     def to_io: () -> IO
 
     def call: () -> void
@@ -21,9 +23,12 @@ module HTTPX
     def force_close: (?bool delete_pending) -> void
 
     def terminate: () -> void
+
+    def inflight?: () -> boolish
   end
 
   class Selector
+    HAS_FIBER_SCHEDULER: bool
 
     type selectable = Resolver::Resolver | Connection | (Object & _Loggable & _Selectable)
 
@@ -33,20 +38,23 @@ module HTTPX
 
     READABLE: Array[io_interests]
     WRITABLE: Array[io_interests]
+    MAX_BUSY_ITERATIONS: Integer
 
     @timers: Timers
 
     @selectables: Array[selectable]
     @is_timer_interval: bool
+    @busy_iterations: Integer
+    @last_select_registered: Integer?
 
     def each: () -> ::Enumerator[selectable, self]
             | () { (selectable) -> void } -> self
 
     def next_tick: () -> void
 
-    def terminate: () -> void
+    def terminate: (?Array[selectable]) -> void
 
-    def find_resolver: (Options options) -> Resolver::Resolver?
+    def find_resolver: (Options options) -> resolver?
 
     def find_connection: (http_uri request_uri, Options options) -> Connection?
 
@@ -69,12 +77,18 @@ module HTTPX
 
     def select_many: (io_select_selectable r, io_select_selectable w, interval? interval) { (selectable) -> void } -> void
 
+    def selectables_with_closed_ios: (io_select_selectable r, io_select_selectable w) -> _Each[selectable]
+
     def select_one: (selectable io, io_interests interests, interval? interval) { (selectable) -> void } -> void
 
     def next_timeout: () -> interval?
 
+    def busy_loop_check: (interval? timeout) -> void
+
+    def busy_loop_error_message: (interval? timeout) -> String
+
     def rw_wait: (io_select_selectable IO, interval? interval) -> untyped?
   end
 
   type io_interests = :r | :w | :rw
-end
+end

data/sig/session.rbs

@@ -15,8 +15,6 @@ module HTTPX
     @wrapped: bool
     @closing: bool
 
-    type resolver = Resolver::Multi | Resolver::Resolver
-
     def wrap: () { (instance) -> void } -> void
 
     def close: (?Selector selector) -> void
@@ -42,21 +40,25 @@ module HTTPX
     def initialize: (?options) { (self) -> void } -> void
                   | (?options) -> void
 
-    def selector_close: (Selector close) -> void
+    def can_checkin?: (Connection connection) -> boolish
+
+    def selector_close: (Selector close, *untyped) -> void
 
-    def deactivate: (Selector selector) -> void
+    def deactivate: (Selector selector, ?Exception? error) -> void
 
     def on_promise: (untyped, untyped) -> void
 
     def fetch_response: (Request request, Selector selector, Options options) -> response?
 
-    def send_request: (Request request, Selector selector, ?Options options) -> void
+    def send_request: (Request request, Selector selector, ?Options options) ?{ (Connection) -> void } -> void
+
+    def do_request: (Request request, Connection connection, Selector selector) -> void
 
     def set_request_callbacks: (Request request) -> void
 
     def build_requests: (verb, uri, request_params) -> Array[Request]
                       | (Array[[verb, uri] | [verb, uri, request_params]], ?request_params) -> Array[Request]
-                      | (verb, _Each[[uri] | [uri, request_params]], request_params) -> Array[Request]
+                      | (verb, _Each[uri | [uri] | [uri, request_params]], request_params) -> Array[Request]
 
     def do_init_connection: (Connection connection, Selector selector) -> void
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: httpx
 version: !ruby/object:Gem::Version
-  version: 1.8.4
+  version: 1.9.1
 platform: ruby
 authors:
 - Tiago Cardoso
@@ -173,6 +173,8 @@ extra_rdoc_files:
 - doc/release_notes/1_8_2.md
 - doc/release_notes/1_8_3.md
 - doc/release_notes/1_8_4.md
+- doc/release_notes/1_9_0.md
+- doc/release_notes/1_9_1.md
 files:
 - LICENSE.txt
 - README.md
@@ -318,6 +320,8 @@ files:
 - doc/release_notes/1_8_2.md
 - doc/release_notes/1_8_3.md
 - doc/release_notes/1_8_4.md
+- doc/release_notes/1_9_0.md
+- doc/release_notes/1_9_1.md
 - lib/httpx.rb
 - lib/httpx/adapters/datadog.rb
 - lib/httpx/adapters/faraday.rb
@@ -373,6 +377,7 @@ files:
 - lib/httpx/plugins/grpc/grpc_encoding.rb
 - lib/httpx/plugins/grpc/message.rb
 - lib/httpx/plugins/h2c.rb
+- lib/httpx/plugins/hedging.rb
 - lib/httpx/plugins/internal_telemetry.rb
 - lib/httpx/plugins/ntlm_auth.rb
 - lib/httpx/plugins/ntlm_v2_auth.rb
@@ -484,6 +489,7 @@ files:
 - sig/plugins/grpc/grpc_encoding.rbs
 - sig/plugins/grpc/message.rbs
 - sig/plugins/h2c.rbs
+- sig/plugins/hedging.rbs
 - sig/plugins/ntlm_auth.rbs
 - sig/plugins/ntlm_v2_auth.rbs
 - sig/plugins/oauth.rbs