aws-sdk-core 2.9.44 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 440592f3f6409519e7a1ed1f9d6e9ed490d5968e
-  data.tar.gz: 4ffc90aba8537aa2a738bf52d64d46f13e8e95d2
+  metadata.gz: 3f55f302102507d66ac7cb1672d67203bbe137a5
+  data.tar.gz: b46426f548e4dc984795742b6dd372dd272ab835
 SHA512:
-  metadata.gz: 7fb3fb74b76ed36c8af578e9d8e20bf63bf54adf6343ab839d7ac74f57feb056bc7a600117f7ebfb2115dfbf4d5c71725953c4ea87614c5d371d70b7c175e78f
-  data.tar.gz: 231ef4b8775da33a1b4f3a4e1794e7178e261bbcd3ad02b4ceeeb69281668626c31cc68d4e7476b6c392eab368f8b16358050f648b3b0e2f0d72d9ed82ad7c72
+  metadata.gz: a590861591be9e0d1bc4dfbe189343efff48587f0c6c92b6d47892e30eafbc96edb9153fc76341a4dc4a272c7773d3f0f8c4fbd0f3c6301419d82d26acd23bf5
+  data.tar.gz: 8f497d018657e2d7ac594fcebdf7fc773277a97ce2541a254e36b465c477a9a4694575b49f497026f7fbb2077ac7917c4eb72c49bbea42e9fd64e7b5f1902f44

data/VERSION

@@ -0,0 +1 @@
+3.1.0

data/lib/aws-sdk-core/client_stubs.rb

@@ -16,7 +16,6 @@ module Aws
         @config.stub_responses.each do |operation_name, stubs|
           apply_stubs(operation_name, Array === stubs ? stubs : [stubs])
         end
-        @config.stub_responses = true
       end
     end
 
@@ -186,7 +185,7 @@ module Aws
     # @return [Structure] Returns a stubbed response data structure. The
     #   actual class returned will depend on the given `operation_name`.
     def stub_data(operation_name, data = {})
-      Stubbing::StubData.new(operation(operation_name)).stub(data)
+      Stubbing::StubData.new(config.api.operation(operation_name)).stub(data)
     end
 
     # @api private

data/lib/aws-sdk-core/credential_provider.rb

@@ -1,3 +1,5 @@
+require_relative 'deprecations'
+
 module Aws
   module CredentialProvider
 

data/lib/aws-sdk-core/credential_provider_chain.rb

@@ -62,7 +62,8 @@ module Aws
       if options[:config]
         SharedCredentials.new(profile_name: options[:config].profile)
       else
-        SharedCredentials.new(profile_name: 'default')
+        SharedCredentials.new(
+          profile_name: ENV['AWS_PROFILE'].nil? ? 'default' : ENV['AWS_PROFILE'])
       end
     rescue Errors::NoSuchProfileError
       nil

data/lib/aws-sdk-core/errors.rb

@@ -1,10 +1,10 @@
 require 'thread'
 
 module Aws
-
-  # Each Service module has its own Errors module, e.g. {S3::Errors}.
   module Errors
 
+    class NonSupportedRubyVersionError < RuntimeError; end
+
     # The base class for all errors returned by an Amazon Web Service.
     # All ~400 level client errors and ~500 level server errors are raised
     # as service errors.  This indicates it was an error returned from the
@@ -38,20 +38,31 @@ module Aws
     # This error indicates a checksum failed.
     class ChecksumError < RuntimeError; end
 
-    # Raised when a {Service} is constructed and the specified shared
+    # Raised when a client is constructed and the specified shared
     # credentials profile does not exist.
     class NoSuchProfileError < RuntimeError; end
 
-    # Raised when a {Service} is constructed, where Assume Role credentials are
+    # Raised when a client is constructed, where Assume Role credentials are
     # expected, and there is no source profile specified.
     class NoSourceProfileError < RuntimeError; end
 
-    # Raised when a {Service} is constructed and credentials are not
+    # Raised when a client is constructed and credentials are not
     # set, or the set credentials are empty.
-    class MissingCredentialsError < RuntimeError; end
+    class MissingCredentialsError < RuntimeError
+      def initialize(*args)
+        msg = 'unable to sign request without credentials set'
+        super(msg)
+      end
+    end
 
-    # Raised when a {Service} is constructed and region is not specified.
-    class MissingRegionError < ArgumentError; end
+    # Raised when a client is constructed and region is not specified.
+    class MissingRegionError < ArgumentError
+      def initialize(*args)
+        msg = "missing region; use :region option or "
+        msg << "export region name to ENV['AWS_REGION']"
+        super(msg)
+      end
+    end
 
     # Raised when attempting to connect to an endpoint and a `SocketError`
     # is received from the HTTP client. This error is typically the result

data/lib/aws-sdk-core/ini_parser.rb

@@ -1,4 +1,5 @@
 module Aws
+  # @api private
   class IniParser
     class << self
 

data/lib/aws-sdk-core/json/handler.rb

@@ -38,10 +38,11 @@ module Aws
       def parse_body(context)
         if simple_json?(context)
           Json.load(context.http_response.body_contents)
-        else
-          rules = context.operation.output
+        elsif rules = context.operation.output
           json = context.http_response.body_contents
           Parser.new(rules).parse(json == '' ? '{}' : json)
+        else
+          EmptyStructure.new
         end
       end
 

data/lib/aws-sdk-core/json/parser.rb

@@ -21,7 +21,7 @@ module Aws
 
       def structure(ref, values, target = nil)
         shape = ref.shape
-        target = ref[:struct_class].new if target.nil?
+        target = ref.shape.struct_class.new if target.nil?
         values.each do |key, value|
           member_name, member_ref = shape.member_by_location_name(key)
           if member_ref

data/lib/aws-sdk-core/json.rb

@@ -1,14 +1,13 @@
 require 'json'
+require_relative 'json/builder'
+require_relative 'json/error_handler'
+require_relative 'json/handler'
+require_relative 'json/parser'
 
 module Aws
   # @api private
   module Json
 
-    autoload :Builder, 'aws-sdk-core/json/builder'
-    autoload :ErrorHandler, 'aws-sdk-core/json/error_handler'
-    autoload :Handler, 'aws-sdk-core/json/handler'
-    autoload :Parser, 'aws-sdk-core/json/parser'
-
     class ParseError < StandardError
 
       def initialize(error)

data/lib/aws-sdk-core/log/param_filter.rb

@@ -9,9 +9,10 @@ module Aws
       # logs. This is updated automatically as part of each release. See the
       # `tasks/sensitive.rake` for more information.
       #
-      # ** DO NOT EDIT THE FOLLOWING LINE OF CODE **
-      #
-      SENSITIVE = [:access_token, :admin_contact, :artifact_credentials, :auth_code, :base_32_string_seed, :client_id, :client_secret, :copy_source_sse_customer_key, :id_token, :local_console_password, :new_password, :old_password, :password, :plaintext, :previous_password, :private_key, :proposed_password, :public_key, :qr_code_png, :refresh_token, :registrant_contact, :secret_access_key, :secret_hash, :shared_secret, :sse_customer_key, :ssekms_key_id, :tech_contact, :trust_password, :upload_credentials, :username, :value]
+      # @api private
+      # begin
+      SENSITIVE = [:access_token, :account_name, :account_password, :admin_contact, :artifact_credentials, :auth_code, :authentication_token, :base_32_string_seed, :client_id, :client_secret, :copy_source_sse_customer_key, :credentials, :db_password, :description, :email, :email_address, :id, :id_token, :input, :local_console_password, :master_account_email, :message, :name, :new_password, :notes, :old_password, :owner_information, :parameters, :password, :payload, :plaintext, :previous_password, :private_key, :proposed_password, :public_key, :qr_code_png, :query, :refresh_token, :registrant_contact, :secret_access_key, :secret_hash, :service_password, :shared_secret, :sse_customer_key, :ssekms_key_id, :status_message, :task_parameters, :tech_contact, :temporary_password, :text, :trust_password, :upload_credentials, :upload_url, :username, :value, :values, :variables, :zip_file]
+      # end
 
       def initialize(options = {})
         @filters = Set.new(SENSITIVE + Array(options[:filter]))

data/lib/aws-sdk-core/pageable_response.rb

@@ -120,6 +120,7 @@ module Aws
     # to call on a pageable response, as this would trigger n api calls
     # simply to count the number of response pages, when likely what is
     # wanted is to access count on the data. Same for #to_h.
+    # @api private
     module UnsafeEnumerableMethods
 
       def count

data/lib/aws-sdk-core/pager.rb

@@ -1,14 +1,16 @@
+require 'jmespath'
+
 module Aws
   # @api private
   class Pager
 
-    def initialize(rules)
-      @more_results = rules['more_results']
-      @more_results = underscore(@more_results) if @more_results
-      if rules['limit_key']
-        @limit_key = underscore(rules['limit_key']).to_sym
-      end
-      map_tokens(rules)
+    # @option options [required, Hash<JMESPath,JMESPath>] :tokens
+    # @option options [String<JMESPath>] :limit_key
+    # @option options [String<JMESPath>] :more_results
+    def initialize(options)
+      @tokens = options.fetch(:tokens)
+      @limit_key = options.fetch(:limit_key, nil)
+      @more_results = options.fetch(:more_results, nil)
     end
 
     # @return [Symbol, nil]
@@ -37,32 +39,35 @@ module Aws
       if @more_results
         JMESPath.search(@more_results, response.data)
       else
-        next_tokens = self.next_tokens(response)
-        prev_tokens = self.prev_tokens(response)
-        !(next_tokens.empty? || next_tokens == prev_tokens)
+        next_t = next_tokens(response)
+        prev_t = prev_tokens(response)
+        !(next_t.empty? || next_t == prev_t)
       end
     end
 
     private
 
-    def map_tokens(rules)
-      input = Array(rules['input_token'])
-      output = Array(rules['output_token'])
-      @tokens = {}
-      input.each.with_index do |key, n|
-        @tokens[underscore(output[n])] = underscore(key)
-      end
-    end
-
-    def underscore(str)
-      str.
-        gsub(' or ', '||').
-        gsub(/\w+/) { |part| Seahorse::Util.underscore(part) }
-    end
-
     def empty_value?(value)
       value.nil? || value == '' || value == [] || value == {}
     end
 
+    class NullPager
+
+      # @return [nil]
+      attr_reader :limit_key
+
+      def next_tokens
+        {}
+      end
+
+      def prev_tokens
+        {}
+      end
+
+      def truncated?(response)
+        false
+      end
+
+    end
   end
 end

data/lib/aws-sdk-core/param_converter.rb

@@ -40,7 +40,7 @@ module Aws
 
     def structure(ref, values)
       values = c(ref, values)
-      if Struct === values || Hash === values
+      if ::Struct === values || Hash === values
         values.each_pair do |k, v|
           unless v.nil?
             if ref.shape.member?(k)
@@ -165,10 +165,10 @@ module Aws
     end
 
     add(StructureShape, Hash) { |h| h.dup }
-    add(StructureShape, Struct)
+    add(StructureShape, ::Struct)
 
     add(MapShape, Hash) { |h| h.dup }
-    add(MapShape, Struct) do |s|
+    add(MapShape, ::Struct) do |s|
       s.members.each.with_object({}) {|k,h| h[k] = s[k] }
     end
 

data/lib/aws-sdk-core/param_validator.rb

@@ -16,7 +16,11 @@ module Aws
     # @param [Seahorse::Model::Shapes::ShapeRef] rules
     # @option options [Boolean] :validate_required (true)
     def initialize(rules, options = {})
-      @rules = rules
+      @rules = rules || begin
+        shape = StructureShape.new
+        shape.struct_class = EmptyStructure
+        ShapeRef.new(shape: shape)
+      end
       @validate_required = options[:validate_required] != false
     end
 
@@ -74,8 +78,10 @@ module Aws
     end
 
     def map(ref, values, errors, context)
-
-      return unless correct_type?(ref, values, errors, context)
+      unless Hash === values
+        errors << expected_got(context, "a hash", values)
+        return
+      end
 
       key_ref = ref.shape.key
       value_ref = ref.shape.value
@@ -123,7 +129,7 @@ module Aws
     def correct_type?(ref, value, errors, context)
       case value
       when Hash then true
-      when ref[:struct_class] then true
+      when ref.shape.struct_class then true
       else
         errors << expected_got(context, "a hash", value)
         false

data/lib/aws-sdk-core/plugins/credentials_configuration.rb

@@ -0,0 +1,62 @@
+module Aws
+  # @api private
+  module Plugins
+    # @api private
+    class CredentialsConfiguration < Seahorse::Client::Plugin
+
+      option(:access_key_id, doc_type: String, docstring: '')
+
+      option(:secret_access_key, doc_type: String, docstring: '')
+
+      option(:session_token, doc_type: String, docstring: '')
+
+      option(:profile,
+        doc_default: 'default',
+        doc_type: String,
+        docstring: <<-DOCS)
+Used when loading credentials from the shared credentials file
+at HOME/.aws/credentials.  When not specified, 'default' is used.
+        DOCS
+
+      option(:credentials,
+        required: true,
+        doc_type: 'Aws::CredentialProvider',
+        docstring: <<-DOCS
+Your AWS credentials. This can be an instance of any one of the
+following classes:
+
+* `Aws::Credentials` - Used for configuring static, non-refreshing
+  credentials.
+
+* `Aws::InstanceProfileCredentials` - Used for loading credentials
+  from an EC2 IMDS on an EC2 instance.
+
+* `Aws::SharedCredentials` - Used for loading credentials from a
+  shared file, such as `~/.aws/config`.
+
+* `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+
+When `:credentials` are not configured directly, the following
+locations will be searched for credentials:
+
+* `Aws.config[:credentials]`
+* The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
+* ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
+* `~/.aws/credentials`
+* `~/.aws/config`
+* EC2 IMDS instance profile - When used by default, the timeouts are
+  very aggressive. Construct and pass an instance of
+  `Aws::InstanceProfileCredentails` to enable retries and extended
+  timeouts.
+        DOCS
+      ) do |config|
+        CredentialProviderChain.new(config).resolve
+      end
+
+      option(:instance_profile_credentials_retries, 0)
+
+      option(:instance_profile_credentials_timeout, 1)
+
+    end
+  end
+end

data/lib/aws-sdk-core/plugins/global_configuration.rb

@@ -31,17 +31,17 @@ module Aws
     #     Aws::EC2.new
     #     #=> raises ArgumentError: invalid configuration option `:force_path_style'
     #
-    # To avoid this issue, you can nest service specific options 
+    # To avoid this issue, you can nest service specific options
     #
     #     Aws.config[:s3] = { force_path_style: true }
     #
     #     Aws::EC2.new # no error this time
     #     Aws::S3.new.config.force_path_style #=> true
     #
+    # @api private
     class GlobalConfiguration < Seahorse::Client::Plugin
 
-      # @api private
-      IDENTIFIERS = Set.new(SERVICE_MODULE_NAMES.map(&:downcase).map(&:to_sym))
+      @identifiers = Set.new()
 
       # @api private
       def before_initialize(client_class, options)
@@ -62,18 +62,27 @@ module Aws
 
       def apply_aws_defaults(client_class, options)
         Aws.config.each do |option_name, default|
-          next if IDENTIFIERS.include?(option_name)
+          next if self.class.identifiers.include?(option_name)
           next if options.key?(option_name)
           options[option_name] = default
         end
       end
 
-    end
-  end
+      class << self
 
-  service_added do |name, _, _|
-    Plugins::GlobalConfiguration::IDENTIFIERS << name.downcase.to_sym
-  end
+        # Registers an additional service identifier.
+        # @api private
+        def add_identifier(identifier)
+          @identifiers << identifier
+        end
 
-end
+        # @return [Set<String>]
+        # @api private
+        def identifiers
+          @identifiers
+        end
 
+      end
+    end
+  end
+end

data/lib/aws-sdk-core/plugins/idempotency_token.rb

@@ -6,13 +6,12 @@ module Aws
     # Provides support for auto filling operation parameters
     # that enabled with `idempotencyToken` trait  with random UUID v4
     # when no value is provided
+    # @api private
     class IdempotencyToken < Seahorse::Client::Plugin
 
       # @api private
       class Handler < Seahorse::Client::Handler
 
-        # @param [RequestContext] context
-        # @param [Response]
         def call(context)
           auto_fill(context.params, context.operation.input)
           @handler.call(context)

data/lib/aws-sdk-core/plugins/logging.rb

@@ -1,28 +1,28 @@
 module Aws
   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 Log::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 < Seahorse::Client::Plugin
 
-      option(:logger)
+      option(:logger,
+        doc_type: 'Logger',
+        docstring: <<-DOCS
+The Logger instance to send log messages to.  If this option
+is not set, logging will be 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) do |config|
+      option(:log_formatter,
+        doc_type: 'Aws::Log::Formatter',
+        doc_default: literal('Aws::Log::Formatter.default'),
+        docstring: 'The log formatter.'
+      ) do |config|
         Log::Formatter.default if config.logger
       end
 

data/lib/aws-sdk-core/plugins/param_converter.rb

@@ -1,12 +1,16 @@
 module Aws
   module Plugins
-
-    # @seahorse.client.option [Boolean] :convert_params (true)
-    #   When `true`, an attempt is made to coerce request parameters
-    #   into the required types.
+    # @api private
     class ParamConverter < Seahorse::Client::Plugin
 
-      option(:convert_params, true)
+      option(:convert_params,
+         default: true,
+         doc_type: 'Boolean',
+         docstring: <<-DOCS
+When `true`, an attempt is made to coerce request parameters into
+the required types.
+         DOCS
+      )
 
       def add_handlers(handlers, config)
         handlers.add(Handler, step: :initialize) if config.convert_params

data/lib/aws-sdk-core/plugins/param_validator.rb

@@ -1,12 +1,15 @@
 module Aws
   module Plugins
-
-    # @seahorse.client.option [Boolean] :validate_params (true)
-    #   When `true`, request parameters are validated before
-    #   sending the request.
+    # @api private
     class ParamValidator < Seahorse::Client::Plugin
 
-      option(:validate_params, true)
+      option(:validate_params,
+        default: true,
+        doc_type: 'Boolean',
+        docstring: <<-DOCS)
+When `true`, request parameters are validated before
+sending the request.
+      DOCS
 
       def add_handlers(handlers, config)
         if config.validate_params

data/lib/aws-sdk-core/plugins/protocols/ec2.rb

@@ -1,3 +1,5 @@
+require_relative '../../query'
+
 module Aws
   module Plugins
     module Protocols
@@ -26,7 +28,6 @@ module Aws
         end
 
         handler(Handler)
-
         handler(Xml::ErrorHandler, step: :sign)
 
       end

data/lib/aws-sdk-core/plugins/protocols/json_rpc.rb

@@ -1,20 +1,21 @@
 module Aws
   module Plugins
     module Protocols
-
-      # @seahorse.client.option [Boolean] :simple_json (false)
-      #   Disables request parameter conversion, validation, and formatting.
-      #   Also disable response data type conversions. This option is useful
-      #   when you want to ensure the highest level of performance by
-      #   avoiding overhead of walking request parameters and response data
-      #   structures.
-      #
-      #   When `:simple_json` is enabled, the request parameters hash must
-      #   be formatted exactly as the DynamoDB API expects.
-      #
       class JsonRpc < Seahorse::Client::Plugin
 
-        option(:simple_json, false)
+        option(:simple_json,
+          default: false,
+          doc_type: 'Boolean',
+          docstring: <<-DOCS)
+Disables request parameter conversion, validation, and formatting.
+Also disable response data type conversions. This option is useful
+when you want to ensure the highest level of performance by
+avoiding overhead of walking request parameters and response data
+structures.
+
+When `:simple_json` is enabled, the request parameters hash must
+be formatted exactly as the DynamoDB API expects.
+          DOCS
 
         option(:validate_params) { |config| !config.simple_json }
 

data/lib/aws-sdk-core/plugins/protocols/query.rb

@@ -1,11 +1,11 @@
+require_relative '../../query'
+
 module Aws
   module Plugins
     module Protocols
       class Query < Seahorse::Client::Plugin
-
         handler(Aws::Query::Handler)
         handler(Xml::ErrorHandler, step: :sign)
-
       end
     end
   end

data/lib/aws-sdk-core/plugins/regional_endpoint.rb

@@ -1,14 +1,6 @@
 module Aws
   module Plugins
-
-    # @seahorse.client.option [required, String] :region
-    #   The AWS region to connect to.  The region is used to construct
-    #   the client endpoint.  Defaults to `ENV['AWS_REGION']`.
-    #   Also checks `AMAZON_REGION` and `AWS_DEFAULT_REGION`.
-    #
-    # @seahorse.client.option [String] :endpoint A default endpoint is
-    #   constructed from the `:region`.
-    #
+    # @api private
     class RegionalEndpoint < Seahorse::Client::Plugin
 
       # raised when region is not configured
@@ -16,22 +8,38 @@ module Aws
 
       option(:profile)
 
-      option(:region) do |cfg|
+      option(:region,
+        required: true,
+        doc_type: String,
+        docstring: <<-DOCS) do |cfg|
+The AWS region to connect to.  The configured `:region` is
+used to determine the service `:endpoint`. When not passed,
+a default `:region` is search for in the following locations:
+
+* `Aws.config[:region]`
+* `ENV['AWS_REGION']`
+* `ENV['AMAZON_REGION']`
+* `ENV['AWS_DEFAULT_REGION']`
+* `~/.aws/credentials`
+* `~/.aws/config`
+        DOCS
         resolve_region(cfg)
       end
 
-      option(:endpoint) do |cfg|
+      option(:endpoint, doc_type: String, docstring: <<-DOCS) do |cfg|
+The client endpoint is normally constructed from the `:region`
+option. You should only configure an `:endpoint` when connecting
+to test endpoints. This should be avalid HTTP(S) URI.
+        DOCS
         endpoint_prefix = cfg.api.metadata['endpointPrefix']
         if cfg.region && endpoint_prefix
-          EndpointProvider.resolve(cfg.region, endpoint_prefix)
+          Aws::Partitions::EndpointProvider.resolve(cfg.region, endpoint_prefix)
         end
       end
 
       def after_initialize(client)
         if client.config.region.nil? or client.config.region == ''
-          msg = "missing region; use :region option or "
-          msg << "export region name to ENV['AWS_REGION']"
-          raise Errors::MissingRegionError, msg
+          raise Errors::MissingRegionError
         end
       end