httpx 0.17.0 → 0.18.3

data/lib/httpx.rb

@@ -13,6 +13,7 @@ require "httpx/callbacks"
 require "httpx/loggable"
 require "httpx/registry"
 require "httpx/transcoder"
+require "httpx/timers"
 require "httpx/pool"
 require "httpx/headers"
 require "httpx/request"

data/sig/chainable.rbs

@@ -32,6 +32,7 @@ module HTTPX
               | (:stream, ?options) -> Plugins::sessionStream
               | (:aws_sigv4, ?options) -> Plugins::awsSigV4Session
               | (:grpc, ?options) -> Plugins::grpcSession
+              | (:response_cache, ?options) -> Plugins::sessionResponseCache
               | (Symbol | Module, ?options) { (Class) -> void } -> Session
               | (Symbol | Module, ?options) -> Session
 

data/sig/connection/http1.rbs

@@ -15,6 +15,11 @@ module HTTPX
     @max_requests: Integer
     @parser: Parser::HTTP1
     @buffer: Buffer
+    @version: [Integer, Integer]
+    @handshake_completed: bool
+    @pipelining: bool
+
+    @request: Request?
 
     def interests: () -> io_interests?
 

data/sig/connection/http2.rbs

@@ -92,5 +92,8 @@ module HTTPX
 
     class Error < ::HTTPX::Error
     end
+
+    class GoawayError < Error
+    end
   end
 end

data/sig/connection.rbs

@@ -25,7 +25,15 @@ module HTTPX
     attr_reader state: Symbol
     attr_reader pending: Array[Request]
     attr_reader options: Options
-    attr_writer timers: untyped # Timers::Timer
+    attr_writer timers: Timers
+
+    @origins: Array[URI::Generic]
+    @window_size: Integer
+    @read_buffer: Buffer
+    @write_buffer: Buffer
+    @inflight: Integer
+    @keep_alive_timeout: Numeric?
+    @total_timeout: Numeric?
 
     def addresses: () -> Array[ipaddr]?
 
@@ -62,6 +70,7 @@ module HTTPX
 
     def timeout: () -> Numeric?
 
+    def deactivate: () -> void
     private
 
     def initialize: (String, URI::Generic, options) -> untyped
@@ -76,6 +85,8 @@ module HTTPX
 
     def parser: () -> _Parser
 
+    def send_request_to_parser: (Request request) -> void
+
     def build_parser: () -> _Parser
                     | (String) -> _Parser
 
@@ -83,15 +94,10 @@ module HTTPX
 
     def transition: (Symbol) -> void
 
-    def handle_response: () -> void
-
     def on_error: (HTTPX::TimeoutError | Error | StandardError) -> void
 
     def handle_error: (StandardError) -> void
 
-    def total_timeout: () -> untyped?
-    # def total_timeout: () -> Timers::Timer?
-    #
     def purge_after_closed: () -> void
   end
 end

data/sig/plugins/aws_sdk_authentication.rbs

@@ -1,25 +1,43 @@
 module HTTPX
   module Plugins
     module AwsSdkAuthentication
+      class Configuration
+        attr_reader profile: String?
+
+        private
+
+        def initialize: (String? profile) -> void
+      end
+
       class Credentials
+        @aws_credentials: untyped
+
         include _SigV4Credentials
 
         private
-        
+
         def initialize: (untyped aws_credentials) -> untyped
       end
 
+      interface _AwsSdkOptions
+        def aws_profile: () -> String?
+      end
+
       def self.load_dependencies: (singleton(Session)) -> void
 
       def self.configure: (singleton(Session)) -> void
 
-      def self.extra_options: (Options) -> (Options)
+      def self.extra_options: (Options) -> (Options & _AwsSdkOptions)
+
+      def self.credentials: (String? profile) -> Credentials
+
+      def self.region: (String? profile) -> String
 
       module InstanceMethods
-        def aws_sdk_authentication: (**untyped) -> instance
+        def aws_sdk_authentication: (?credentials: Credentials, ?region: String, **untyped) -> instance
       end
     end
 
-    type sessionAwsSdkAuthentication = Session & AwsSdkAuthentication::InstanceMethods
+    type sessionAwsSdkAuthentication = awsSigV4Session & AwsSdkAuthentication::InstanceMethods
   end
 end

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,6 +4,7 @@ module HTTPX
       MAX_RETRIES: Integer
       IDEMPOTENT_METHODS: Array[verb]
       RETRYABLE_ERRORS: Array[singleton(StandardError)]
+      DEFAULT_JITTER: ^(Numeric) -> Numeric
 
       interface _RetryCallback
         def call: (response) -> bool?
@@ -12,6 +13,8 @@ module HTTPX
       interface _RetriesOptions
         def retry_after: () -> Numeric?
 
+        def retry_jitter: () -> ^(Numeric) -> Numeric
+
         def max_retries: () -> Integer?
 
         def retry_change_requests: () -> boolish

data/sig/pool.rbs

@@ -10,6 +10,8 @@ module HTTPX
 
     def find_connection: (generic_uri, Options) -> Connection?
 
+    def deactivate: (*Array[Connection]) -> void
+
     private
 
     def initialize: () -> untyped
@@ -26,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/resolver/native.rbs

@@ -5,8 +5,6 @@ module HTTPX
       include ResolverMixin
       include _ToIO
 
-      type state = :idle | :open | :closed
-
       DEFAULTS: Hash[Symbol, untyped]
       DNS_PORT: Integer
 
@@ -21,7 +19,8 @@ module HTTPX
       @queries: Hash[String, Connection]
       @read_buffer: String
       @write_buffer: Buffer
-      @state: state
+
+      attr_reader state: Symbol
 
       def closed?: () -> bool
 
@@ -58,7 +57,7 @@ module HTTPX
 
       def build_socket: () -> void
 
-      def transition: (state nextstate) -> void
+      def transition: (Symbol nextstate) -> void
 
       def handle_error: (NativeResolveError | StandardError) -> void
     end

data/sig/resolver/system.rbs

@@ -5,6 +5,8 @@ module HTTPX
 
       RESOLV_ERRORS: Array[singleton(StandardError)] # ResolvError
 
+      attr_reader state: Symbol
+
       def closed?: () -> true
 
       def empty?: () -> true

data/sig/response.rbs

@@ -1,6 +1,8 @@
 module HTTPX
   interface _Response
-    def raise_for_status: () -> void
+    def raise_for_status: () -> self
+
+    def error: () -> StandardError?
   end
 
   class Response
@@ -89,7 +91,6 @@ module HTTPX
     @options: Options
 
     attr_reader request: Request
-    attr_reader error: Exception
 
     def status: () -> (Integer | _ToS)
 

data/sig/timers.rbs

@@ -0,0 +1,32 @@
+module HTTPX
+  class Timers
+    @interval: Array[Interval]
+
+    def after: (Numeric interval_in_secs) { () -> void } -> void
+
+    def wait_interval: () -> Numeric?
+
+    def fire: (?StandardError error) -> void
+
+    def cancel: () -> void
+
+    private
+
+    def initialize: () -> void
+
+    class Interval
+      include Comparable
+
+      attr_reader interval: Numeric
+
+      def to_f: () -> Float
+
+      def <<: (^() -> void) -> void
+
+      def elapse: (Numeric elapsed) -> Numeric
+      private
+
+      def initialize: (Numeric interval) -> void
+    end
+  end
+end

data/sig/utils.rbs

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: httpx
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.18.3
 platform: ruby
 authors:
 - Tiago Cardoso
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-08-31 00:00:00.000000000 Z
+date: 2021-12-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http-2-next
@@ -24,20 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.4.1
-- !ruby/object:Gem::Dependency
-  name: timers
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 description: A client library for making HTTP requests from Ruby.
 email:
 - cardoso_tiago@hotmail.com
@@ -76,6 +62,10 @@ extra_rdoc_files:
 - doc/release_notes/0_16_0.md
 - doc/release_notes/0_16_1.md
 - doc/release_notes/0_17_0.md
+- doc/release_notes/0_18_0.md
+- doc/release_notes/0_18_1.md
+- doc/release_notes/0_18_2.md
+- doc/release_notes/0_18_3.md
 - doc/release_notes/0_1_0.md
 - doc/release_notes/0_2_0.md
 - doc/release_notes/0_2_1.md
@@ -131,6 +121,10 @@ files:
 - doc/release_notes/0_16_0.md
 - doc/release_notes/0_16_1.md
 - doc/release_notes/0_17_0.md
+- doc/release_notes/0_18_0.md
+- doc/release_notes/0_18_1.md
+- doc/release_notes/0_18_2.md
+- doc/release_notes/0_18_3.md
 - doc/release_notes/0_1_0.md
 - doc/release_notes/0_2_0.md
 - doc/release_notes/0_2_1.md
@@ -214,6 +208,8 @@ files:
 - lib/httpx/plugins/proxy/ssh.rb
 - lib/httpx/plugins/push_promise.rb
 - lib/httpx/plugins/rate_limiter.rb
+- lib/httpx/plugins/response_cache.rb
+- lib/httpx/plugins/response_cache/store.rb
 - lib/httpx/plugins/retries.rb
 - lib/httpx/plugins/stream.rb
 - lib/httpx/plugins/upgrade.rb
@@ -232,6 +228,7 @@ files:
 - lib/httpx/selector.rb
 - lib/httpx/session.rb
 - lib/httpx/session2.rb
+- lib/httpx/timers.rb
 - lib/httpx/transcoder.rb
 - lib/httpx/transcoder/body.rb
 - lib/httpx/transcoder/chunker.rb
@@ -278,6 +275,7 @@ files:
 - sig/plugins/proxy/ssh.rbs
 - sig/plugins/push_promise.rbs
 - sig/plugins/rate_limiter.rbs
+- sig/plugins/response_cache.rbs
 - sig/plugins/retries.rbs
 - sig/plugins/stream.rbs
 - sig/plugins/upgrade.rbs
@@ -292,6 +290,7 @@ files:
 - sig/response.rbs
 - sig/selector.rbs
 - sig/session.rbs
+- sig/timers.rbs
 - sig/transcoder.rbs
 - sig/transcoder/body.rbs
 - sig/transcoder/chunker.rbs
@@ -307,6 +306,7 @@ metadata:
   documentation_uri: https://honeyryderchuck.gitlab.io/httpx/rdoc/
   source_code_uri: https://gitlab.com/honeyryderchuck/httpx
   homepage_uri: https://honeyryderchuck.gitlab.io/httpx/
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -322,7 +322,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.2.22
 signing_key:
 specification_version: 4
 summary: HTTPX, to the future, and beyond