httpx 0.20.5 → 0.21.1

data/sig/connection.rbs

@@ -28,7 +28,7 @@ module HTTPX
     attr_reader options: Options
     attr_writer timers: Timers
 
-    @origins: Array[URI::Generic]
+    @type: io_type
     @window_size: Integer
     @read_buffer: Buffer
     @write_buffer: Buffer
@@ -40,7 +40,7 @@ module HTTPX
 
     def addresses=: (Array[ipaddr]) -> void
 
-    def match?: (URI::Generic, options) -> bool
+    def match?: (URI::Generic uri, Options options) -> bool
 
     def mergeable?: (Connection) -> bool
 
@@ -54,13 +54,15 @@ module HTTPX
 
     def match_altsvcs?: (URI::Generic uri) -> bool
 
+    def match_altsvc_options?: (URI::Generic uri, Options options) -> bool
+
     def connecting?: () -> bool
 
     def inflight?: () -> boolish
 
     def interests: () -> io_interests?
 
-    def to_io: () -> IO
+    def to_io: () -> ::IO
 
     def call: () -> void
 
@@ -77,7 +79,7 @@ module HTTPX
 
     private
 
-    def initialize: (String, URI::Generic, options) -> untyped
+    def initialize: (io_type, URI::Generic, options) -> untyped
 
     def connect: () -> void
 
@@ -103,5 +105,11 @@ module HTTPX
     def handle_error: (StandardError) -> void
 
     def purge_after_closed: () -> void
+
+    def set_request_timeouts: (Request request) -> void
+
+    def write_timeout_callback: (Request request, Numeric write_timeout) -> void
+
+    def read_timeout_callback: (Request request, Numeric read_timeout, ?singleton(RequestTimeoutError) error_type) -> void
   end
 end

data/sig/errors.rbs

@@ -23,6 +23,19 @@ module HTTPX
   class ResolveTimeoutError < TimeoutError
   end
 
+  class RequestTimeoutError < TimeoutError
+    attr_reader request: Request
+    attr_reader response: response?
+
+    def initialize: (Request request, response? response, Numeric timeout) -> void
+  end
+
+  class ReadTimeoutError < RequestTimeoutError
+  end
+
+  class WriteTimeoutError < RequestTimeoutError
+  end
+
   class ResolveError < Error
   end
 

data/sig/io.rbs

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

data/sig/options.rbs

@@ -10,7 +10,7 @@ module HTTPX
     SETTINGS_TIMEOUT: Integer
     DEFAULT_OPTIONS: Hash[Symbol, untyped]
 
-    type timeout_type = :connect_timeout | :settings_timeout | :operation_timeout | :keep_alive_timeout | :total_timeout
+    type timeout_type = :connect_timeout | :settings_timeout | :operation_timeout | :keep_alive_timeout | :total_timeout | :read_timeout | :write_timeout | :request_timeout
     type timeout = Hash[timeout_type, Numeric]
 
     def self.new: (?options) -> instance
@@ -65,6 +65,9 @@ module HTTPX
     # body
     attr_reader origin: URI::Generic?
 
+    # base_path
+    attr_reader base_path: String?
+
     # ssl
 
     # http2_settings

data/sig/plugins/circuit_breaker.rbs

@@ -0,0 +1,61 @@
+module HTTPX
+  module Plugins
+    module CircuitBreaker
+
+      class CircuitStore
+        @circuits: Hash[String, Circuit]
+
+        def try_open: (generic_uri uri, response response) -> void
+
+        def try_respond: (Request request) -> response?
+
+        private
+
+        def get_circuit_for_uri: (generic_uri uri) -> Circuit
+
+        def initialize: (Options & _CircuitOptions options) -> void
+      end
+
+      class Circuit
+        @state: :closed | :open | :half_open
+        @max_attempts: Integer
+        @reset_attempts_in: Float
+        @break_in: Float
+        @circuit_breaker_half_open_drip_rate: Float
+        @attempts: Integer
+
+        @response: response?
+        @opened_at: Float?
+        @attempted_at: Float?
+
+        def respond: () -> response?
+
+        def try_open: (response) -> void
+
+        def try_close: () -> void
+
+        private
+
+        def initialize: (Integer max_attempts, Float reset_attempts_in, Float break_in, Float circuit_breaker_half_open_drip_rate) -> void
+      end
+
+      interface _CircuitOptions
+        def circuit_breaker_max_attempts: () -> Integer
+        def circuit_breaker_reset_attempts_in: () -> Float
+        def circuit_breaker_break_in: () -> Float
+        def circuit_breaker_half_open_drip_rate: () -> Float
+        def circuit_breaker_break_on: () -> (^(Response) -> boolish | nil)
+      end
+
+      def self.load_dependencies: (singleton(Session)) -> void
+      def self.extra_options: (Options) -> (Options & _CircuitOptions)
+
+      module InstanceMethods
+        @circuit_store: CircuitStore
+      end
+
+    end
+
+    type sessionCircuitBreaker = Session & CircuitBreaker::InstanceMethods
+  end
+end

data/sig/plugins/compression/brotli.rbs

@@ -6,7 +6,7 @@ module HTTPX
         def self.configure: (singleton(Session)) -> void
 
         def self?.deflater: () -> _Deflater
-        def self?.decoder: (Numeric bytesize) -> Inflater
+        def self?.decoder: (Integer | Float bytesize) -> Inflater
 
         module Deflater
           extend _Deflater

data/sig/plugins/compression/deflate.rbs

@@ -6,7 +6,7 @@ module HTTPX
         def self.configure: (singleton(Session)) -> void
 
         def self?.deflater: () -> _Deflater
-        def self?.inflater: (Numeric bytesize) -> GZIP::Inflater
+        def self?.inflater: (Integer | Float bytesize) -> GZIP::Inflater
 
         module Deflater
           extend _Deflater

data/sig/plugins/compression/gzip.rbs

@@ -6,15 +6,15 @@ module HTTPX
         def self.configure: (singleton(Session)) -> void
 
         def self?.deflater: () -> _Deflater
-        def self?.inflater: (Numeric bytesize) -> Inflater
+        def self?.inflater: (Integer | Float bytesize) -> Inflater
 
         class Deflater
           include _Deflater
 
           @compressed_chunk: String
-          
+
           private
-          
+
           def initialize: () -> untyped
           def write: (string) -> void
           def compressed_chunk: () -> String

data/sig/plugins/compression.rbs

@@ -13,7 +13,7 @@ module HTTPX
       interface _Inflater
         def inflate: (string) -> String
 
-        def initialize: (Numeric bytesize) -> untyped
+        def initialize: (Integer | Float bytesize) -> untyped
       end
 
       def self.configure: (singleton(Session)) -> void

data/sig/plugins/multipart.rbs

@@ -61,7 +61,7 @@ module HTTPX
         @boundary: String
         @intermediate_boundary: String
 
-        def call: (Response response, untyped) -> Hash[String, untyped]
+        def call: (Response response, *untyped) -> Hash[String, untyped]
 
         private
 

data/sig/plugins/proxy/socks5.rbs

@@ -4,14 +4,15 @@ module HTTPX
   module Plugins
     module Proxy
       module Socks5
-      
+        VERSION: Integer
+
         module ConnectionMethods
           def __socks5_proxy_connect: () ->  void
           def __socks5_on_packet: (String packet) ->  void
           def __socks5_check_version: (int) -> void
           def __on_socks5_error: (string) -> void
         end
-        
+
         class SocksParser
           include Callbacks
 

data/sig/plugins/proxy.rbs

@@ -21,7 +21,7 @@ module HTTPX
 
         private
 
-        def initialize: (uri: generic_uri, ?scheme: String, ?username: String, ?password: String, **extra) -> untyped
+        def initialize: (uri: generic_uri, ?scheme: String, ?username: String, ?password: String, **untyped) -> untyped
       end
 
       def self.configure: (singleton(Session)) -> void

data/sig/registry.rbs

@@ -1,12 +1,13 @@
-module HTTPX::Registry[T, V]
+module HTTPX::Registry[unchecked out T, unchecked out V]
   class Error < HTTPX::Error
   end
 
   # type registrable = Symbol | String | Class
 
-  def self.registry: (T tag) -> Class
-                   | () -> Hash[T, V]
-  def self.register: (T tag,  V handler) -> void
+  def self.registry: [T, V] (T) -> Class
+                   | [T, V] () -> Hash[T, V]
+
+  def self.register: [T, V] (T tag,  V handler) -> void
 
   def registry: (?T tag) -> V
 end

data/sig/request.rbs

@@ -50,6 +50,12 @@ module HTTPX
 
     def trailers?: () -> boolish
 
+    def read_timeout: () -> Numeric
+
+    def write_timeout: () -> Numeric
+
+    def request_timeout: () -> Numeric
+
     class Body
       @headers: Headers
       @body: body_encoder?
@@ -61,7 +67,7 @@ module HTTPX
 
       def rewind: () -> void
       def empty?: () -> bool
-      def bytesize: () -> Numeric
+      def bytesize: () -> (Integer | Float)
       def stream: (Transcoder::_Encoder) -> bodyIO
       def unbounded_body?: () -> bool
       def chunked?: () -> bool

data/sig/resolver/native.rbs

@@ -10,7 +10,10 @@ module HTTPX
       @family: ip_family
       @options: Options
       @ns_index: Integer
-      @nameserver: String
+      @nameserver: Array[String]?
+      @ndots: Integer
+      @start_timeout: Float?
+      @search: Array[String]
       @_timeouts: Array[Numeric]
       @timeouts: Hash[String, Array[Numeric]]
       @connections: Array[Connection]
@@ -37,7 +40,7 @@ module HTTPX
 
       def consume: () -> void
 
-      def do_retry: (?Numeric loop_time) -> void
+      def do_retry: (?Numeric? loop_time) -> void
 
       def dread: (Integer) -> void
                | () -> void

data/sig/response.rbs

@@ -1,5 +1,7 @@
 module HTTPX
   interface _Response
+    def finished?: () -> bool
+
     def raise_for_status: () -> self
 
     def error: () -> StandardError?
@@ -61,7 +63,7 @@ module HTTPX
       def each: () { (String) -> void } -> void
               | () -> Enumerable[String]
 
-      def bytesize: () -> Numeric
+      def bytesize: () -> (Integer | Float)
       def empty?: () -> bool
       def copy_to: (String | File | _Writer destination) -> void
       def close: () -> void

data/sig/timers.rbs

@@ -1,7 +1,7 @@
 module HTTPX
   class Timers
     @intervals: Array[Interval]
-    @next_interval_at: Numeric
+    @next_interval_at: Float
 
     def after: (Numeric interval_in_secs) { () -> void } -> void
 

data/sig/transcoder/json.rbs

@@ -5,6 +5,9 @@ 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_dump: (_ToJson obj, *untyped) -> String
+
     class Encoder
       extend Forwardable
       include _Encoder
@@ -17,7 +20,7 @@ module HTTPX::Transcoder
 
       private
 
-      def initialize: (_ToJson json) -> untyped
+      def initialize: (_ToJson json) -> void
     end
   end
 end

data/sig/transcoder/xml.rbs

@@ -0,0 +1,21 @@
+module HTTPX::Transcoder
+  module XML
+
+    def self?.encode: (untyped xml) -> Encoder
+    def self?.decode: (HTTPX::Response response) -> _Decoder
+
+    class Encoder
+      @raw: untyped # can be nokogiri object
+
+      def content_type: () -> String
+
+      def bytesize: () -> (Integer | Float)
+
+      def to_s: () -> String
+
+      private
+
+      def initialize: (String xml) -> void
+    end
+  end
+end

data/sig/transcoder.rbs

@@ -18,11 +18,11 @@ module HTTPX
     end
 
     interface _Encoder
-      def bytesize: () -> Numeric
+      def bytesize: () -> (Integer | Float)
     end
 
     interface _Decoder
-      def call: (Response response, untyped options) -> untyped
+      def call: (Response response, *untyped) -> untyped
     end
   end
 end

data/sig/utils.rbs

@@ -4,9 +4,9 @@ module HTTPX
 
     def self?.parse_retry_after: (String) -> Numeric
 
-    def self?.now: () -> Numeric
+    def self?.now: () -> Float
 
-    def self?.elapsed_time: (Numeric monotonic_time) -> Numeric
+    def self?.elapsed_time: (Integer | Float monotonic_time) -> Float
 
     def self?.to_uri: (generic_uri uri) -> URI::Generic
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: httpx
 version: !ruby/object:Gem::Version
-  version: 0.20.5
+  version: 0.21.1
 platform: ruby
 authors:
 - Tiago Cardoso
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-10 00:00:00.000000000 Z
+date: 2022-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http-2-next
@@ -86,6 +86,8 @@ extra_rdoc_files:
 - doc/release_notes/0_20_3.md
 - doc/release_notes/0_20_4.md
 - doc/release_notes/0_20_5.md
+- doc/release_notes/0_21_0.md
+- doc/release_notes/0_21_1.md
 - doc/release_notes/0_2_0.md
 - doc/release_notes/0_2_1.md
 - doc/release_notes/0_3_0.md
@@ -164,6 +166,8 @@ files:
 - doc/release_notes/0_20_3.md
 - doc/release_notes/0_20_4.md
 - doc/release_notes/0_20_5.md
+- doc/release_notes/0_21_0.md
+- doc/release_notes/0_21_1.md
 - doc/release_notes/0_2_0.md
 - doc/release_notes/0_2_1.md
 - doc/release_notes/0_3_0.md
@@ -217,6 +221,9 @@ files:
 - lib/httpx/plugins/aws_sdk_authentication.rb
 - lib/httpx/plugins/aws_sigv4.rb
 - lib/httpx/plugins/basic_authentication.rb
+- lib/httpx/plugins/circuit_breaker.rb
+- lib/httpx/plugins/circuit_breaker/circuit.rb
+- lib/httpx/plugins/circuit_breaker/circuit_store.rb
 - lib/httpx/plugins/compression.rb
 - lib/httpx/plugins/compression/brotli.rb
 - lib/httpx/plugins/compression/deflate.rb
@@ -253,6 +260,7 @@ files:
 - lib/httpx/plugins/stream.rb
 - lib/httpx/plugins/upgrade.rb
 - lib/httpx/plugins/upgrade/h2.rb
+- lib/httpx/plugins/webdav.rb
 - lib/httpx/pmatch_extensions.rb
 - lib/httpx/pool.rb
 - lib/httpx/punycode.rb
@@ -275,6 +283,7 @@ files:
 - lib/httpx/transcoder/chunker.rb
 - lib/httpx/transcoder/form.rb
 - lib/httpx/transcoder/json.rb
+- lib/httpx/transcoder/xml.rb
 - lib/httpx/utils.rb
 - lib/httpx/version.rb
 - sig/buffer.rbs
@@ -287,6 +296,7 @@ files:
 - sig/errors.rbs
 - sig/headers.rbs
 - sig/httpx.rbs
+- sig/io.rbs
 - sig/loggable.rbs
 - sig/options.rbs
 - sig/parser/http1.rbs
@@ -298,6 +308,7 @@ files:
 - sig/plugins/aws_sdk_authentication.rbs
 - sig/plugins/aws_sigv4.rbs
 - sig/plugins/basic_authentication.rbs
+- sig/plugins/circuit_breaker.rbs
 - sig/plugins/compression.rbs
 - sig/plugins/compression/brotli.rbs
 - sig/plugins/compression/deflate.rbs
@@ -342,6 +353,7 @@ files:
 - sig/transcoder/chunker.rbs
 - sig/transcoder/form.rbs
 - sig/transcoder/json.rbs
+- sig/transcoder/xml.rbs
 - sig/utils.rbs
 homepage: https://gitlab.com/honeyryderchuck/httpx
 licenses:
@@ -368,7 +380,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
 summary: HTTPX, to the future, and beyond