httpx 0.15.4 → 0.18.0

data/sig/plugins/cookies/jar.rbs

@@ -1,27 +1,26 @@
 module HTTPX
   module Plugins::Cookies
     class Jar
-      type cookie = Cookie | Array[String, String, cookie_attributes] | Array[String, String] | cookie_attributes
+      type cookie = Cookie | Array[[String, String, cookie_attributes]] | Array[[String, String]] | cookie_attributes
 
       include Enumerable[Cookie]
 
       @cookies: Array[Cookie]
 
-      def parse: (String) -> void
+      def parse: (String set_cookie) -> void
 
-      def add: (Cookie) -> void
-             | (Cookie, String) -> void
+      def add: (Cookie name, ?String path) -> void
 
       def []: (uri) -> Array[Cookie]
 
-      def each: (uri) { (Cookie) -> void } -> void
-              | (uri) -> Enumerable[Cookie]
-              | () { (Cookie) -> void } -> void
-              | () -> Enumerable[Cookie]
+      def each: (?uri) { (Cookie) -> void } -> void
+              | (?uri) -> Enumerable[Cookie]
+
+      def merge: (_Each[cookie] cookies) -> instance
+
       private
 
-      def initialize: () -> void
-                    | (_Each[cookie]) -> untyped
+      def initialize: (?_Each[cookie] cookies) -> untyped
     end
   end
 end

data/sig/plugins/cookies.rbs

@@ -1,13 +1,12 @@
 module HTTPX
   module Plugins
     module Cookies
-      type jar = Jar | _Each[cookies]
+      type jar = Jar | _Each[Jar::cookie]
 
       interface _CookieOptions
         def cookies: () -> Jar?
-        def cookies=: (jar) -> Jar
       end
- 
+
       def self.extra_options: (Options) -> (Options & _CookieOptions)
 
       module InstanceMethods
@@ -19,7 +18,7 @@ module HTTPX
       end
     end
 
-    type sessionCookies = Session & Plugins::Cookies::InstanceMethods
-    type headersCookies = Headers & Plugins::Cookies::HeadersMethods
+    type sessionCookies = Session & Cookies::InstanceMethods
+    type headersCookies = Headers & Cookies::HeadersMethods
   end
 end

data/sig/plugins/digest_authentication.rbs

@@ -5,9 +5,8 @@ module HTTPX
 
       interface _DigestOptions
         def digest: () -> Digest?
-        def digest=: (Digest) -> Digest
       end
- 
+
       def self.extra_options: (Options) -> (Options & _DigestOptions)
 
       def self.load_dependencies: (*untyped) -> void
@@ -27,6 +26,6 @@ module HTTPX
       end
     end
 
-    type sessionDigestAuthentication = Plugins::sessionAuthentication & Plugins::DigestAuthentication::InstanceMethods
+    type sessionDigestAuthentication = sessionAuthentication & DigestAuthentication::InstanceMethods
   end
 end

data/sig/plugins/expect.rbs

@@ -2,15 +2,13 @@ module HTTPX
   module Plugins
     module Expect
       EXPECT_TIMEOUT: Integer
-      
+
       interface _ExpectOptions
         def expect_timeout: () -> Integer?
-        def expect_timeout=: (int) -> Integer
 
         def expect_threshold_size: () -> Integer?
-        def expect_threshold_size=: (int) -> Integer
       end
- 
+
       def self.extra_options: (Options) -> (Options & _ExpectOptions)
     end
   end

data/sig/plugins/follow_redirects.rbs

@@ -5,15 +5,13 @@ module HTTPX
     module FollowRedirects
       MAX_REDIRECTS: Integer
       REDIRECT_STATUS: Range[Integer]
-      
+
       interface _FollowRedirectsOptions
         def max_redirects: () -> Integer?
-        def max_redirects=: (int) -> Integer
 
         def follow_insecure_redirects: () -> bool?
-        def follow_insecure_redirects=: (bool) -> bool
       end
- 
+
       def self.extra_options: (Options) -> (Options & _FollowRedirectsOptions)
 
       module InstanceMethods
@@ -30,6 +28,6 @@ module HTTPX
       end
     end
 
-    type sessionFollowRedirects = Session & Plugins::FollowRedirects::InstanceMethods
+    type sessionFollowRedirects = Session & FollowRedirects::InstanceMethods
   end
 end

data/sig/plugins/grpc.rbs

@@ -15,6 +15,8 @@ module HTTPX
       type grpc_request = untyped | _Each[untyped]
       type grpc_response = untyped | _Each[untyped]
 
+      type credentials = Proc
+
       class Call
         attr_writer decoder: _Callable
 
@@ -39,7 +41,7 @@ module HTTPX
 
         def self?.decode: (String message, encodings: Array[String], encoders: Compression::encodings_registry) -> String
                         | (String message, encodings: Array[String], encoders: Compression::encodings_registry) { (String) -> void } -> void
-        
+
         def self?.cancel: (Request) -> void
 
         def self?.verify_status: (StreamResponse | response) -> void
@@ -47,19 +49,14 @@ module HTTPX
 
       interface _GRPCOptions
         def grpc_service: () -> String?
-        def grpc_service=: (string) -> String
 
         def grpc_compression: () -> compression_option?
-        def grpc_compression=: (compression_option) -> compression_option
 
         def grpc_rpcs: () -> Hash[String, rpc_def]?
-        def grpc_rpcs=: (Hash[String, rpc_def]) -> Hash[String, rpc_def]
 
         def grpc_deadline: () -> Integer?
-        def grpc_deadline=: (Integer) -> Integer
 
         def call_credentials: () -> credentials?
-        def call_credentials=: (credentials) -> credentials
       end
 
       def self.extra_options: (Options) -> (Options & _GRPCOptions)
@@ -88,6 +85,6 @@ module HTTPX
       end
     end
 
-    type grpcSession = Session & Plugins::GRPC::InstanceMethods
+    type grpcSession = Session & GRPC::InstanceMethods
   end
 end

data/sig/plugins/h2c.rbs

@@ -15,7 +15,5 @@ module HTTPX
         def upgrade_to_h2c: (Request, Response) -> void
       end
     end
-
-    type sessionH2C = Session & Plugins::H2C::InstanceMethods
   end
 end

data/sig/plugins/multipart.rbs

@@ -1,43 +1,97 @@
 module HTTPX
   module Plugins
     module Multipart
+      interface _MultipartInput
+        def filename: () -> String
+        def content_type: () -> String
+        def read: (?int? length, ?string? output) -> String?
+      end
+
+      MULTIPART_VALUE_COND: ^(_Reader | record_multipart_value value) -> bool
+
       def self.load_dependencies: (singleton(Session)) -> void
       def self.configure: (*untyped) -> void
       def self?.encode: (untyped) -> (Encoder | Transcoder::Form::Encoder)
+      def self?.decode: (HTTPX::Response response) -> Transcoder::_Decoder
+
+      def self?.normalize_keys: [U] (_ToS key, _ToAry[untyped] | _ToHash[_ToS, untyped] | untyped value) { (String, ?untyped) -> U } -> U
 
       type multipart_value = string | Pathname | File | _Reader
 
-      type record_multipart_value = multipart_value |
-                                    { content_type: String, filename: String, body: multipart_value } |
+      type record_multipart_value = { content_type: String, filename: String, body: multipart_value } |
                                     { content_type: String, body: multipart_value }
 
       type multipart_nested_value = multipart_value | _ToAry[multipart_value] | _ToHash[string, multipart_value]
 
-      type multipart_input = Enumerable[[string, multipart_value], untyped]
-
       class Encoder
         include Transcoder::_Encoder
-        include _Reader
+
+        @boundary: String
+        @part_index: Integer
+        @buffer: String
+
+        @form: Enumerable[[Symbol | string, multipart_nested_value]]
+        @parts: Array[_Reader]
 
         def content_type: () -> String
 
+        def read: (?int? length, ?string? buffer) -> String?
+
+        def rewind: () -> void
+
         private
 
-        def initialize: (_Each[Symbol | string, multipart_nested_value] multipart_data) -> untyped
+        def to_parts: (Enumerable[[Symbol | string, multipart_nested_value]] multipart_data) -> Array[_Reader]
+
+        def initialize: (Enumerable[[Symbol | string, multipart_nested_value]] multipart_data) -> untyped
 
         def header_part: (string key, String content_type, String? filename) -> StringIO
 
-        def read_chunks: (String buffer, Integer? length) -> void
+        def read_chunks: (String buffer, ?Integer? length) -> void
+
+        def read_from_part: (?Integer? max_length) -> String?
+      end
+
+      class Decoder
+        BOUNDARY_RE: Regexp
+
+        @state: :idle | :part_header | :part_body | :parse_boundary | :done
+        @buffer: String
+        @parts: Hash[String, untyped]
+        @boundary: String
+        @intermediate_boundary: String
+
+        def call: (Response response, untyped) -> Hash[String, untyped]
+
+        private
+
+        def initialize: (Response response) -> void
+
+        def parse: () -> void
 
-        def read_from_part: (Integer? max_length) -> void
+        def get_filename: (String head) -> String?
+      end
+
+      class FilePart #  < SimpleDelegator
+        attr_reader original_filename: String
+        attr_reader content_type: String
+
+        # @file: Tempfile
+
+        # private
+
+        def initialize: (String filename, String content_type) -> void
       end
 
       module Part
-        def self?.call: (multipart_nested_value) -> ([_Reader, String, String?])
+        def self?.call: [U] (_MultipartInput multipart_input) -> [U, String, String]
+                      | (multipart_nested_value input) -> ([StringIO, String, String?] | [File, String, String])
       end
 
       module MimeTypeDetector
-        def self?.call: (IO file, ?String filename) -> String?
+        DEFAULT_MIMETYPE: String
+
+        def self?.call: (::IO file, String filename) -> String?
       end
     end
   end

data/sig/plugins/ntlm_authentication.rbs

@@ -4,9 +4,8 @@ module HTTPX
 
       interface _NTLMOptions
         def ntlm: () -> NTLMParams?
-        def ntlm=: (NTLMParams) -> NTLMParams
       end
- 
+
       def self.extra_options: (Options) -> (Options & _NTLMOptions)
 
       def self.load_dependencies: (*untyped) -> void
@@ -22,6 +21,6 @@ module HTTPX
       end
     end
 
-    type sessionNTLMAuthentication = Plugins::sessionAuthentication & Plugins::NTLMAuthentication::InstanceMethods
+    type sessionNTLMAuthentication = sessionAuthentication & NTLMAuthentication::InstanceMethods
   end
 end

data/sig/plugins/persistent.rbs

@@ -2,15 +2,10 @@ module HTTPX
   module Plugins
     module Persistent
       def self.load_dependencies: (singleton(Session)) -> void
-      
-      interface _PersistentOptions
-        def persistent: () -> bool?
-        def persistent=: (bool) -> bool
-      end
- 
-      def self.extra_options: (Options) -> (Options & _PersistentOptions)
+
+      def self.extra_options: (Options) -> (Options)
     end
-    
+
     type sessionPersistent = sessionFollowRedirects
   end
 end

data/sig/plugins/proxy/ssh.rbs

@@ -3,16 +3,16 @@ module HTTPX
     module Proxy
       module SSH
         def self.load_dependencies: (singleton(Session)) -> void
-      
-        module InstancenMethods
+
+        module InstanceMethods
           private
 
-          def build_gateway_socket: (int, URI::HTTPS | URI::HTTPS, Options) ->  IO
+          def build_gateway_socket: (int, URI::HTTP | URI::HTTPS, Options) ->  _ToIO
         end
       end
     end
 
 
-    type sessionSSHProxy = Plugins::Proxy::InstanceMethods & Plugins::Proxy::SSH::InstanceMethods
+    type sessionSSHProxy = Proxy::InstanceMethods & Proxy::SSH::InstanceMethods
   end
 end

data/sig/plugins/proxy.rbs

@@ -1,5 +1,6 @@
 module HTTPX
-  HTTPProxyError: singleton(Error)
+  class HTTPProxyError < Error
+  end
 
   module Plugins
     module Proxy
@@ -8,8 +9,8 @@ module HTTPX
 
       class Parameters
         attr_reader uri: URI::Generic
-        attr_reader username: string?
-        attr_reader password: string?
+        attr_reader username: String?
+        attr_reader password: String?
 
         def authenticated?: () -> boolish
         def token_authentication: () -> String?
@@ -18,29 +19,28 @@ module HTTPX
 
         private
 
-        def initialize: (uri: generic_uri, ?username: string, ?password: string) -> untyped
+        def initialize: (uri: generic_uri, ?username: String, ?password: String) -> untyped
       end
 
       def self.configure: (singleton(Session)) -> void
-      
-      type proxyParam = Parameters | Hash
-      
+
+      type proxyParam = Parameters | Hash[Symbol, untyped]
+
       interface _ProxyOptions
         def proxy: () -> proxyParam?
-        def proxy=: (Parameters | _ToHash) -> proxyParam
       end
- 
+
       def self.extra_options: (Options) -> (Options & _ProxyOptions)
 
       module InstanceMethods
         private
 
-        def proxy_uris: (uri, Options & _ProxyOptions) -> { uri: (URI | string), username: string, password: string }
-                      | (uri, Options & _ProxyOptions) -> { uri: (URI | string) }
-                      | (uri, Options & _ProxyOptions) -> nil
+        def proxy_uris: (generic_uri, Options & _ProxyOptions) -> { uri: generic_uri, username: String, password: String }
+                      | (generic_uri, Options & _ProxyOptions) -> { uri: generic_uri }
+                      | (generic_uri, Options & _ProxyOptions) -> nil
       end
     end
 
-    type sessionProxy = Session & Plugins::Proxy::InstanceMethods
+    type sessionProxy = Session & Proxy::InstanceMethods
   end
 end

data/sig/plugins/push_promise.rbs

@@ -1,8 +1,6 @@
 module HTTPX
   module Plugins
     module PushPromise
-      def self.extra_options: (Options) -> Options
-
       module ResponseMethods
         def pushed?: () -> boolish
         def mark_as_pushed!: () -> void

data/sig/plugins/response_cache.rbs

@@ -0,0 +1,35 @@
+module HTTPX
+  module Plugins
+    module ResponseCache
+      CACHEABLE_VERBS: Array[Symbol]
+
+      def self?.cacheable_request?: (Request request) -> bool
+      def self?.cacheable_response?: (response response) -> bool
+      def self?.cached_response?: (response response) -> bool
+
+      class Store
+        @store: Hash[URI::Generic, Response]
+
+        def lookup: (URI::Generic uri) -> Response?
+
+        def cached?: (URI::Generic uri) -> bool
+
+        def cache: (URI::Generic uri, Response response) -> void
+
+        def prepare: (Request request) -> void
+      end
+
+      module InstanceMethods
+        @response_cache: Store
+
+        def clear_response_cache: () -> void
+      end
+
+      module ResponseMethods
+        def copy_from_cached: (Response other) -> void
+      end
+    end
+
+    type sessionResponseCache = Session & ResponseCache::InstanceMethods
+  end
+end

data/sig/plugins/retries.rbs

@@ -4,25 +4,24 @@ module HTTPX
       MAX_RETRIES: Integer
       IDEMPOTENT_METHODS: Array[verb]
       RETRYABLE_ERRORS: Array[singleton(StandardError)]
-      
+      DEFAULT_JITTER: ^(Numeric) -> Numeric
+
       interface _RetryCallback
         def call: (response) -> bool?
       end
 
       interface _RetriesOptions
         def retry_after: () -> Numeric?
-        def retry_after=: (Numeric) -> Numeric
+
+        def retry_jitter: () -> ^(Numeric) -> Numeric
 
         def max_retries: () -> Integer?
-        def max_retries=: (int) -> Integer
 
-        def retry_change_requests: () -> bool?
-        def retry_change_requests=: (bool) -> bool
+        def retry_change_requests: () -> boolish
 
         def retry_on: () -> _RetryCallback?
-        def retry_on=: (_RetryCallback) -> _RetryCallback
       end
- 
+
       def self.extra_options: (Options) -> (Options & _RetriesOptions)
 
       module InstanceMethods
@@ -39,6 +38,6 @@ module HTTPX
       end
     end
 
-    type sessionRetries = Session & Plugins::Retries::InstanceMethods
+    type sessionRetries = Session & Retries::InstanceMethods
   end
 end

data/sig/plugins/stream.rbs

@@ -35,6 +35,6 @@ module HTTPX
 
     end
 
-    type sessionStream = Session & Plugins::Stream::InstanceMethods
+    type sessionStream = Session & Stream::InstanceMethods
   end
 end

data/sig/plugins/upgrade.rbs

@@ -7,9 +7,8 @@ module HTTPX
 
       interface _UpgradeOptions
         def upgrade_handlers: () -> handlers_registry?
-        def upgrade_handlers=: (handlers_registry) -> handlers_registry
       end
- 
+
       def self.extra_options: (Options) -> (Options & _UpgradeOptions)
 
       module ConnectionMethods
@@ -18,6 +17,6 @@ module HTTPX
 
         def hijack_io: () -> void
       end
-    end      
+    end
   end
 end

data/sig/pool.rbs

@@ -4,13 +4,14 @@ module HTTPX
 
     def next_tick: () -> void
 
-    def close: (Array[Connection]) -> void
-             | () -> void
+    def close: (*Array[Connection]) -> void
 
     def init_connection: (Connection, Options) -> void
 
     def find_connection: (generic_uri, Options) -> Connection?
 
+    def deactivate: (*Array[Connection]) -> void
+
     private
 
     def initialize: () -> untyped
@@ -27,6 +28,10 @@ module HTTPX
 
     def unregister_connection: (Connection) -> void
 
+    def select_connection: (resolver | Connection connection) -> void
+
+    def deselect_connection: (resolver | Connection connection) -> void
+
     def coalesce_connections: (Connection, Connection) -> void
 
     def next_timeout: () -> Numeric?

data/sig/registry.rbs

@@ -2,7 +2,7 @@ module HTTPX::Registry[T, V]
   # type registrable = Symbol | String | Class
 
   def self.registry: (T tag) -> Class
-                   | () -> Hash[K, V]
+                   | () -> Hash[T, V]
   def self.register: (T tag,  V handler) -> void
 
   def registry: (?T tag) -> V

data/sig/request.rbs

@@ -1,12 +1,13 @@
 module HTTPX
   class Request
+    extend Forwardable
     include Callbacks
 
-    METHODS: Array[verb]
+    METHODS: Array[Symbol]
     USER_AGENT: String
 
-    attr_reader verb: verb
-    attr_reader uri: URI::HTTP | URI::HTTPS
+    attr_reader verb: Symbol
+    attr_reader uri: URI::Generic
     attr_reader headers: Headers
     attr_reader body: Body
     attr_reader state: Symbol
@@ -14,13 +15,13 @@ module HTTPX
     attr_reader response: response?
     attr_reader drain_error: StandardError?
 
-    def initialize: (verb | String, uri, ?options?) -> untyped
+    def initialize: (Symbol | String, generic_uri, ?options) -> untyped
 
     def interests: () -> (:r | :w)
 
-    def merge_headers: (Headers | Hash) -> void
+    def merge_headers: (_Each[[String, headers_value]]) -> void
 
-    def scheme: () -> ("http" | "https")
+    def scheme: () -> String
 
     def response=: (response) -> void
 
@@ -49,6 +50,7 @@ module HTTPX
       def each: () { (String) -> void } -> void
               | () -> Enumerable[String]
 
+      def rewind: () -> void
       def empty?: () -> bool
       def bytesize: () -> Numeric
       def stream: (Transcoder::_Encoder) -> bodyIO
@@ -59,8 +61,9 @@ module HTTPX
     end
 
     class ProcIO
-      include _Writer
-      def initialize: (^(_ToS) -> void) -> untyped
+      def initialize: (^(String) -> void) -> untyped
+
+      def write: (String data) -> Integer
     end
   end
 end

data/sig/resolver/native.rbs

@@ -1,9 +1,13 @@
 module HTTPX
   module Resolver
     class Native
+      extend Forwardable
       include ResolverMixin
       include _ToIO
 
+      DEFAULTS: Hash[Symbol, untyped]
+      DNS_PORT: Integer
+
       @options: Options
       @ns_index: Integer
       @resolver_options: Hash[Symbol, untyped]
@@ -15,7 +19,8 @@ module HTTPX
       @queries: Hash[String, Connection]
       @read_buffer: String
       @write_buffer: Buffer
-      @state: :idle | :closed
+
+      attr_reader state: Symbol
 
       def closed?: () -> bool
 
@@ -35,6 +40,8 @@ module HTTPX
 
       def initialize: (options) -> untyped
 
+      def calculate_interests: () -> (:r | :w)
+
       def consume: () -> void
 
       def do_retry: () -> void
@@ -46,15 +53,13 @@ module HTTPX
 
       def parse: (String) -> void
 
-      def resolve: (Connection, String hostname) -> void
-                 | (Connection) -> void
-                 | () -> void
+      def resolve: (?Connection connection, ?String hostname) -> void
 
       def build_socket: () -> void
 
       def transition: (Symbol nextstate) -> void
 
-      def handle_error: (StandardError) -> void
+      def handle_error: (NativeResolveError | StandardError) -> void
     end
   end
 end