aws-sdk-core 2.3.23 → 3.89.1

data/lib/seahorse/client/net_http/handler.rb

@@ -1,7 +1,9 @@
+require 'net/https'
 require 'openssl'
 
 module Seahorse
   module Client
+    # @api private
     module NetHttp
 
       # The default HTTP handler for Seahorse::Client.  This is based on
@@ -30,7 +32,10 @@ module Seahorse
         end
 
         # @api private
-        DNS_ERROR_MESSAGE = 'getaddrinfo: nodename nor servname provided, or not known'
+        DNS_ERROR_MESSAGES = [
+          'getaddrinfo: nodename nor servname provided, or not known', # MacOS
+          'getaddrinfo: Name or service not known' # GNU
+        ]
 
         # Raised when a {Handler} cannot construct a `Net::HTTP::Request`
         # from the given http verb.
@@ -52,7 +57,7 @@ module Seahorse
         private
 
         def error_message(req, error)
-          if error.is_a?(SocketError) && error.message == DNS_ERROR_MESSAGE
+          if error.is_a?(SocketError) && DNS_ERROR_MESSAGES.include?(error.message)
             host = req.endpoint.host
             "unable to connect to `#{host}`; SocketError: #{error.message}"
           else
@@ -114,6 +119,9 @@ module Seahorse
 
         def session(config, req, &block)
           pool_for(config).session_for(req.endpoint) do |http|
+            # Ruby 2.5, can disable retries for idempotent operations
+            # avoid patching for Ruby 2.5 for disable retry
+            http.max_retries = 0 if http.respond_to?(:max_retries)
             http.read_timeout = config.http_read_timeout
             yield(http)
           end
@@ -155,7 +163,13 @@ module Seahorse
         # @return [Hash] Returns a vanilla hash of headers to send with the
         #   HTTP request.
         def headers(request)
-          # setting these to stop net/http from providing defaults
+          # Net::HTTP adds default headers for content-type to POSTs (1.8.7+)
+          # and accept-encoding (2.0.0+). Setting a default empty value defeats
+          # this.
+          #
+          # Removing these are necessary for most services to not break request
+          # signatures as well as dynamodb crc32 checks (these fail if the
+          # response is gzipped).
           headers = { 'content-type' => '', 'accept-encoding' => '' }
           request.headers.each_pair do |key, value|
             headers[key] = value

data/lib/seahorse/client/net_http/patches.rb

@@ -2,12 +2,20 @@ require 'net/http'
 
 module Seahorse
   module Client
+    # @api private
     module NetHttp
 
       # @api private
       module Patches
 
         def self.apply!
+          return unless RUBY_VERSION < '2.5'
+          if RUBY_VERSION >= '2.3'
+            Net::HTTP::IDEMPOTENT_METHODS_.clear
+            return
+          end
+          # no further patches needed for above versions
+
           if RUBY_VERSION >= '2.0'
             Net::HTTP.send(:include, Ruby_2)
             Net::HTTP::IDEMPOTENT_METHODS_.clear
@@ -28,7 +36,7 @@ module Seahorse
                 begin
                   res = Net::HTTPResponse.read_new(@socket)
                   res.decode_content = req.decode_content
-                end while res.kind_of?(Net::HTTPContinue)
+                end while res.kind_of?(Net::HTTPInformation)
 
                 res.uri = req.uri
 

data/lib/seahorse/client/networking_error.rb

@@ -11,5 +11,33 @@ module Seahorse
       attr_reader :original_error
 
     end
+
+    # Raised when sending initial headers and data failed
+    # for event stream requests over Http2
+    class Http2InitialRequestError < StandardError
+
+      def initialize(error)
+        @original_error = error
+      end
+
+      # @return [HTTP2::Error]
+      attr_reader :original_error
+
+    end
+
+    # Raised when connection failed to initialize a new stream
+    class Http2StreamInitializeError < StandardError
+
+      def initialize(error)
+        @original_error = error
+      end
+
+      # @return [HTTP2::Error]
+      attr_reader :original_error
+
+    end
+
+    # Rasied when trying to use an closed connection
+    class Http2ConnectionClosedError < StandardError; end
   end
 end

data/lib/seahorse/client/plugin.rb

@@ -7,8 +7,12 @@ module Seahorse
       # @param [Configuration] config
       # @return [void]
       def add_options(config)
-        self.class.options.each do |args, block|
-          config.add_option(*args, &block)
+        self.class.options.each do |option|
+          if option.default_block
+            config.add_option(option.name, &option.default_block)
+          else
+            config.add_option(option.name, option.default)
+          end
         end
       end
 
@@ -38,12 +42,24 @@ module Seahorse
 
       class << self
 
-        def option(name, default = nil, &block)
-          if block_given?
-            options << [[name], Proc.new]
+        # @overload option(name, options = {}, &block)
+        # @option options [Object] :default Can also be set by passing a block.
+        # @option options [String] :doc_default
+        # @option options [Boolean] :required
+        # @option options [String] :doc_type
+        # @option options [String] :docs
+        # @return [void]
+        def option(name, default = nil, options = {}, &block)
+          # For backwards-compat reasons, the default value can be passed as 2nd
+          # positional argument (before the options hash) or as the `:default` option
+          # in the options hash.
+          if Hash === default
+            options = default
           else
-            options << [[name, default]]
+            options[:default] = default
           end
+          options[:default_block] = block if block_given?
+          self.options << PluginOption.new(name, options)
         end
 
         def before_initialize(&block)
@@ -74,6 +90,51 @@ module Seahorse
           @after_initialize_hooks ||= []
         end
 
+        # @api private
+        def literal(string)
+          CodeLiteral.new(string)
+        end
+
+        # @api private
+        class CodeLiteral < String
+          def inspect
+            to_s
+          end
+        end
+
+      end
+
+      # @api private
+      class PluginOption
+
+        def initialize(name, options = {})
+          @name = name
+          @doc_default = nil
+          options.each_pair do |opt_name, opt_value|
+            self.send("#{opt_name}=", opt_value)
+          end
+        end
+
+        attr_reader :name
+        attr_accessor :default
+        attr_accessor :default_block
+        attr_accessor :required
+        attr_accessor :doc_type
+        attr_writer :doc_default
+        attr_accessor :docstring
+
+        def doc_default
+          if @doc_default.nil? && !default.is_a?(Proc)
+            default
+          else
+            @doc_default
+          end
+        end
+
+        def documented?
+          !!docstring
+        end
+
       end
     end
   end

data/lib/seahorse/client/plugin_list.rb

@@ -87,7 +87,9 @@ module Seahorse
             @canonical_name = plugin.name || plugin.object_id
             @plugin = plugin
           when Symbol, String
-            @canonical_name, @gem_name = plugin.to_s.split('.').reverse
+            words = plugin.to_s.split('.')
+            @canonical_name = words.pop
+            @gem_name = words.empty? ? nil : words.join('.')
             @plugin = nil
           else
             @canonical_name = plugin.object_id

data/lib/seahorse/client/plugins/content_length.rb

@@ -7,8 +7,13 @@ module Seahorse
         class Handler < Client::Handler
 
           def call(context)
-            length = context.http_request.body.size
-            context.http_request.headers['Content-Length'] = length
+            begin
+              length = context.http_request.body.size
+              context.http_request.headers['Content-Length'] = length
+            rescue
+              # allowing `Content-Length` failed to be set
+              # see Aws::Plugins::TransferEncoding
+            end
             @handler.call(context)
           end
 

data/lib/seahorse/client/plugins/endpoint.rb

@@ -1,24 +1,28 @@
 module Seahorse
   module Client
     module Plugins
-      # @seahorse.client.option [String] :endpoint
-      #    The HTTP or HTTPS endpoint to send requests to.
-      #    For example:
-      #
-      #        'http://example.com'
-      #        'https://example.com'
-      #        'http://example.com:123'
-      #
       class Endpoint < Plugin
 
-        option(:endpoint)
+        option(:endpoint,
+          doc_type: 'String, URI::HTTPS, URI::HTTP',
+          docstring: <<-DOCS)
+Normally you should not configure the `:endpoint` option
+directly. This is normally constructed from the `:region`
+option. Configuring `:endpoint` is normally reserved for
+connecting to test endpoints. The endpoint should be a URI
+formatted like:
+
+    'http://example.com'
+    'https://example.com'
+    'http://example.com:123'
+
+          DOCS
 
         def add_handlers(handlers, config)
           handlers.add(Handler, priority: 90)
         end
 
         def after_initialize(client)
-
           endpoint = client.config.endpoint
           if endpoint.nil?
             msg = "missing required option `:endpoint'"

data/lib/seahorse/client/plugins/h2.rb

@@ -0,0 +1,64 @@
+require 'seahorse/client/h2/handler'
+
+module Seahorse
+  module Client
+    module Plugins
+      class H2 < Plugin
+
+        # H2 Client
+        option(:max_concurrent_streams, default: 100, doc_type: Integer, docstring: <<-DOCS)
+Maximum concurrent streams used in HTTP2 connection, defaults to 100. Note that server may send back
+:settings_max_concurrent_streams value which will take priority when initializing new streams.
+        DOCS
+
+        option(:connection_timeout, default: 60, doc_type: Integer, docstring: <<-DOCS)
+Connection timeout in seconds, defaults to 60 sec.
+        DOCS
+
+        option(:connection_read_timeout, default: 60, doc_type: Integer, docstring: <<-DOCS)
+Connection read timeout in seconds, defaults to 60 sec.
+        DOCS
+
+        option(:read_chunk_size, default: 1024, doc_type: Integer, docstring: '')
+
+        option(:raise_response_errors, default: true, doc_type: 'Boolean', docstring: <<-DOCS)
+Defaults to `true`, raises errors if exist when #wait or #join! is called upon async response.
+        DOCS
+
+        # SSL Context
+        option(:ssl_ca_bundle, default: nil, doc_type: String, docstring: <<-DOCS)
+Full path to the SSL certificate authority bundle file that should be used when
+verifying peer certificates. If you do not pass `:ssl_ca_directory` or `:ssl_ca_bundle`
+the system default will be used if available.
+        DOCS
+
+        option(:ssl_ca_directory, default: nil, doc_type: String, docstring: <<-DOCS)
+Full path of the directory that contains the unbundled SSL certificate authority
+files for verifying peer certificates. If you do not pass `:ssl_ca_bundle` or
+`:ssl_ca_directory` the system default will be used if available.
+        DOCS
+
+        option(:ssl_ca_store, default: nil, doc_type: String, docstring: '')
+
+        option(:ssl_verify_peer, default: true, doc_type: 'Boolean', docstring: <<-DOCS)
+When `true`, SSL peer certificates are verified when establishing a connection.
+        DOCS
+
+        option(:http_wire_trace, default: false, doc_type:  'Boolean', docstring: <<-DOCS)
+When `true`, HTTP2 debug output will be sent to the `:logger`.
+        DOCS
+
+        option(:enable_alpn, default: false, doc_type: 'Boolean', docstring: <<-DOCS)
+Setting to `true` to enable ALPN in HTTP2 over TLS, requires Ruby version >= 2.3 and
+Openssl version >= 1.0.2. Defaults to false. Note: not all service HTTP2 operations
+supports ALPN on server side, please refer to service documentation.
+        DOCS
+
+        option(:logger)
+
+        handler(Client::H2::Handler, step: :send)
+
+      end
+    end
+  end
+end

data/lib/seahorse/client/plugins/logging.rb

@@ -1,29 +1,27 @@
 module Seahorse
   module Client
     module Plugins
-
-      # Enables logging for all requests.  This plugin allows you to configure
-      # your logging device, the log format and the level to log messages at.
-      #
-      # @see Logging::Formatter
-      #
-      # @seahorse.client.option [Logger] :logger (nil) The Logger instance
-      #   to send log messages to.  If this option is not set, logging
-      #   will be disabled.
-      #
-      # @seahorse.client.option [Symbol] :log_level (:info) The log level
-      #   to send messages to the logger at.
-      #
-      # @seahorse.client.option [Logging::LogFormatter] :log_formatter The log
-      #   formatter.  Defaults to {Seahorse::Client::Logging::Formatter.default}.
-      #
+      # @api private
       class Logging < Plugin
 
-        option(:logger, nil)
+        option(:logger,
+          default: nil,
+          doc_type: 'Logger',
+          docstring: <<-DOCS)
+The Logger instance to send log messages to. If this option
+is not set, logging is disabled.
+          DOCS
 
-        option(:log_level, :info)
+        option(:log_level,
+          default: :info,
+          doc_type: Symbol,
+          docstring: 'The log level to send messages to the logger at.')
 
-        option(:log_formatter, Client::Logging::Formatter.default)
+        option(:log_formatter,
+          default: Seahorse::Client::Logging::Formatter.default,
+          doc_default: 'Aws::Log::Formatter.default',
+          doc_type: 'Aws::Log::Formatter',
+          docstring: 'The log formatter.')
 
         def add_handlers(handlers, config)
           if config.logger

data/lib/seahorse/client/plugins/net_http.rb

@@ -1,23 +1,31 @@
+require 'seahorse/client/net_http/handler'
+
 module Seahorse
   module Client
     module Plugins
-
-      # @seahorse.client.option [String] :http_proxy
-      # @seahorse.client.option [Integer] :http_open_timeout (15)
-      # @seahorse.client.option [Integer] :http_read_timeout (60)
-      # @seahorse.client.option [Integer] :http_idle_timeout (5)
-      # @seahorse.client.option [Float] :http_continue_timeout (1)
-      # @seahorse.client.option [Boolean] :http_wire_trace (false)
-      # @seahorse.client.option [Logger] :logger (nil)
-      # @seahorse.client.option [Boolean] :ssl_verify_peer (true)
-      # @seahorse.client.option [String] :ssl_ca_bundle
-      # @seahorse.client.option [String] :ssl_ca_directory
-      # @seahorse.client.option [String] :ssl_ca_store
       class NetHttp < Plugin
 
-        Client::NetHttp::ConnectionPool::OPTIONS.each_pair do |name, default|
-          option(name, default)
-        end
+        option(:http_proxy, default: nil, doc_type: String, docstring: '')
+
+        option(:http_open_timeout, default: 15, doc_type: Integer, docstring: '')
+
+        option(:http_read_timeout, default: 60, doc_type: Integer, docstring: '')
+
+        option(:http_idle_timeout, default: 5, doc_type: Integer, docstring: '')
+
+        option(:http_continue_timeout, default: 1, doc_type: Integer, docstring: '')
+
+        option(:http_wire_trace, default: false, doc_type: 'Boolean', docstring: '')
+
+        option(:ssl_verify_peer, default: true, doc_type: 'Boolean', docstring: '')
+
+        option(:ssl_ca_bundle, default: nil, doc_type: String, docstring: '')
+
+        option(:ssl_ca_directory, default: nil, doc_type: String, docstring: '')
+
+        option(:ssl_ca_store, default: nil, doc_type: String, docstring: '')
+
+        option(:logger) # for backwards compat
 
         handler(Client::NetHttp::Handler, step: :send)
 

data/lib/seahorse/client/plugins/raise_response_errors.rb

@@ -1,12 +1,12 @@
 module Seahorse
   module Client
     module Plugins
-
-      # @seahorse.client.option [Boolean] :raise_response_errors (true)
-      #   When `true`, response errors are raised.
       class RaiseResponseErrors < Plugin
 
-        option(:raise_response_errors, true)
+        option(:raise_response_errors,
+          default: true,
+          doc_type: 'Boolean',
+          docstring: 'When `true`, response errors are raised.')
 
         # @api private
         class Handler < Client::Handler