aws-sdk-core 2.4.0 → 3.53.0

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

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

@@ -1,3 +1,5 @@
+require 'pathname'
+
 module Seahorse
   module Client
     module Plugins
@@ -39,7 +41,14 @@ module Seahorse
             context.http_response.on_error do
               body = context.http_response.body
               File.unlink(body) if ManagedFile === body
-              context.http_response.body = StringIO.new
+              # Aws::S3::Encryption::DecryptHandler (with lower priority)
+              # has callbacks registered after ResponseTarget::Handler,
+              # where http_response.body is an IODecrypter
+              # and has error callbacks handling for it.
+              # Thus avoid early remove of IODecrypter at ResponseTarget::Handler
+              unless context.http_response.body.respond_to?(:io)
+                context.http_response.body = StringIO.new
+              end
             end
           end
 

data/lib/seahorse/client/request_context.rb

@@ -6,6 +6,7 @@ module Seahorse
 
       # @option options [required,Symbol] :operation_name (nil)
       # @option options [required,Model::Operation] :operation (nil)
+      # @option options [Model::Authorizer] :authorizer (nil)
       # @option options [Hash] :params ({})
       # @option options [Configuration] :config (nil)
       # @option options [Http::Request] :http_request (Http::Request.new)
@@ -14,6 +15,7 @@ module Seahorse
       def initialize(options = {})
         @operation_name = options[:operation_name]
         @operation = options[:operation]
+        @authorizer = options[:authorizer]
         @client = options[:client]
         @params = options[:params] || {}
         @config = options[:config]
@@ -29,6 +31,9 @@ module Seahorse
       # @return [Model::Operation]
       attr_accessor :operation
 
+      # @return [Model::Authorizer] APIG SDKs only
+      attr_accessor :authorizer
+
       # @return [Seahorse::Client::Base]
       attr_accessor :client
 

data/lib/seahorse/client/response.rb

@@ -1,6 +1,8 @@
+require 'delegate'
+
 module Seahorse
   module Client
-    class Response
+    class Response < Delegator
 
       # @option options [RequestContext] :context (nil)
       # @option options [Integer] :status_code (nil)
@@ -63,29 +65,16 @@ module Seahorse
         self
       end
 
+      # Necessary to define as a subclass of Delegator
       # @api private
-      def inspect
-        @data.inspect
-      end
-
-      # @api private
-      def pretty_print(q)
-        @data.pretty_print(q)
+      def __getobj__
+        @data
       end
 
+      # Necessary to define as a subclass of Delegator
       # @api private
-      def respond_to?(*args)
-        @data.respond_to?(args.first, false) || super
-      end
-
-      private
-
-      def method_missing(*args, &block)
-        if @data.respond_to?(args.first, false)
-          @data.send(*args, &block)
-        else
-          super
-        end
+      def __setobj__(obj)
+        @data = obj
       end
 
     end

data/lib/seahorse/model/api.rb

@@ -5,6 +5,8 @@ module Seahorse
       def initialize
         @metadata = {}
         @operations = {}
+        @authorizers = {}
+        @endpoint_operation = nil
       end
 
       # @return [String, nil]
@@ -13,6 +15,9 @@ module Seahorse
       # @return [Hash]
       attr_accessor :metadata
 
+      # @return [Symbol|nil]
+      attr_accessor :endpoint_operation
+
       def operations(&block)
         if block_given?
           @operations.each(&block)
@@ -33,10 +38,42 @@ module Seahorse
         @operations.keys
       end
 
+      def async_operation_names
+        @operations.select {|_, op| op.async }.keys
+      end
+
       def add_operation(name, operation)
         @operations[name.to_sym] = operation
       end
 
+      def authorizers(&block)
+        if block_given?
+          @authorizers.each(&block)
+        else
+          @authorizers.enum_for(:each)
+        end
+      end
+
+      def authorizer(name)
+        if @authorizers.key?(name.to_sym)
+          @authorizers[name.to_sym]
+        else
+          raise ArgumentError, "unknown authorizer #{name.inspect}"
+        end
+      end
+
+      def authorizer_names
+        @authorizers.keys
+      end
+
+      def add_authorizer(name, authorizer)
+        @authorizers[name.to_sym] = authorizer
+      end
+
+      def inspect(*args)
+        "#<#{self.class.name}>"
+      end
+
     end
   end
 end

data/lib/seahorse/model/authorizer.rb

@@ -0,0 +1,21 @@
+module Seahorse
+  module Model
+    class Authorizer
+
+      def initialize
+        @type = 'provided'
+        @placement = {}
+      end
+
+      # @return [String]
+      attr_accessor :name
+
+      # @return [String]
+      attr_accessor :type
+
+      # @return [Hash]
+      attr_accessor :placement
+
+    end
+  end
+end

data/lib/seahorse/model/operation.rb

@@ -8,6 +8,7 @@ module Seahorse
         @deprecated = false
         @errors = []
         @metadata = {}
+        @async = false
       end
 
       # @return [String, nil]
@@ -22,9 +23,21 @@ module Seahorse
       # @return [Boolean]
       attr_accessor :deprecated
 
+      # @return [Boolean]
+      attr_accessor :endpoint_operation
+
+      # @return [Hash]
+      attr_accessor :endpoint_discovery
+
       # @return [String, nil]
       attr_accessor :documentation
 
+      # @return [Hash, nil]
+      attr_accessor :endpoint_pattern
+
+      # @return [String, nil]
+      attr_accessor :authorizer
+
       # @return [ShapeRef, nil]
       attr_accessor :input
 
@@ -34,6 +47,13 @@ module Seahorse
       # @return [Array<ShapeRef>]
       attr_accessor :errors
 
+      # APIG only
+      # @return [Boolean]
+      attr_accessor :require_apikey
+
+      # @return [Boolean]
+      attr_accessor :async
+
       def [](key)
         @metadata[key.to_s]
       end