aws-sdk-code-generator 0.2.0.pre → 0.2.1.pre

data/templates/root_resource_class.mustache

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+{{#generated_src_warning}}
+{{generated_src_warning}}
+{{/generated_src_warning}}
+module {{module_name}}
+
+  {{#documentation?}}
+  # This class provides a resource oriented interface for {{service_name}}.
+  # To create a resource object:
+  #
+  #     resource = {{module_name}}::Resource.new(region: 'us-west-2')
+  #
+  # You can supply a client object with custom configuration that will be used for all resource operations.
+  # If you do not pass `:client`, a default client will be constructed.
+  #
+  #     client = {{module_name}}::Client.new(region: 'us-west-2')
+  #     resource = {{module_name}}::Resource.new(client: client)
+  #
+  {{/documentation?}}
+  class Resource
+
+    # @param options ({})
+    # @option options [Client] :client
+    def initialize(options = {})
+      @client = options[:client] || Client.new(options)
+    end
+
+    # @return [Client]
+    def client
+      @client
+    end
+    {{#actions?}}
+
+    # @!group Actions
+    {{#actions}}
+
+    {{> method}}
+    {{/actions}}
+    {{/actions?}}
+    {{#associations?}}
+
+    # @!group Associations
+    {{#associations}}
+
+    {{> method}}
+    {{/associations}}
+    {{/associations?}}
+
+  end
+end

data/templates/service_module.mustache

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+{{#generated_src_warning}}
+{{generated_src_warning}}
+{{/generated_src_warning}}
+{{#requires}}
+require '{{.}}'
+{{/requires}}
+
+{{#relative_requires}}
+require_relative '{{.}}'
+{{/relative_requires}}
+
+# This module provides support for {{full_name}}. This module is available in the
+# `{{gem_name}}` gem.
+#
+# # Client
+#
+# The {Client} class provides one method for each API operation. Operation
+# methods each accept a hash of request parameters and return a response
+# structure.
+{{#example_operation_name}}
+#
+#     {{example_var_name}} = {{module_name}}::Client.new
+#     resp = {{example_var_name}}.{{example_operation_name}}(params)
+{{/example_operation_name}}
+#
+# See {Client} for more information.
+#
+# # Errors
+#
+# Errors returned from {{full_name}} are defined in the
+# {Errors} module and all extend {Errors::ServiceError}.
+#
+#     begin
+#       # do stuff
+#     rescue {{module_name}}::Errors::ServiceError
+#       # rescues all {{full_name}} API errors
+#     end
+#
+# See {Errors} for more information.
+#
+# @service
+module {{module_name}}
+
+  GEM_VERSION = '{{gem_version}}'
+
+end

data/templates/spec/spec_helper.mustache

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+{{#generated_src_warning}}
+{{generated_src_warning}}
+{{/generated_src_warning}}
+require_relative '../../aws-sdk-core/spec/shared_spec_helper'
+
+$:.unshift(File.expand_path('../../lib', __FILE__))
+{{#gem_dependencies}}
+$:.unshift(File.expand_path('../../../{{dependency}}/lib', __FILE__))
+{{/gem_dependencies}}
+
+require 'rspec'
+require 'webmock/rspec'
+require '{{gem_name}}'

data/templates/types_module.mustache

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+{{#generated_src_warning}}
+{{generated_src_warning}}
+{{/generated_src_warning}}
+module {{module_name}}
+  module Types
+    {{#structures}}
+
+    {{> documentation}}
+    {{#empty?}}
+    class {{class_name}} < Aws::EmptyStructure; end
+    {{/empty?}}
+    {{^empty?}}
+    class {{class_name}} < Struct.new(
+      {{#members}}
+      :{{member_name}}{{^last}},{{/last}}{{#last}}){{/last}}
+      {{/members}}
+      SENSITIVE = {{sensitive_params}}
+      include Aws::Structure
+    end
+    {{/empty?}}
+    {{/structures}}
+    {{#eventstreams}}
+
+    {{> documentation}}
+    class {{class_name}} < Enumerator
+
+      def event_types
+        {{#empty?}}
+        []
+        {{/empty?}}
+        {{^empty?}}
+        [
+        {{#types}}
+          :{{member_name}}{{^last}},{{/last}}
+        {{/types}}
+        ]
+        {{/empty?}}
+      end
+
+    end
+    {{/eventstreams}}
+
+  end
+end

data/templates/version.mustache

@@ -0,0 +1 @@
+{{version}}

data/templates/waiters_module.mustache

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+{{#generated_src_warning}}
+{{generated_src_warning}}
+{{/generated_src_warning}}
+require 'aws-sdk-core/waiters'
+
+module {{module_name}}
+  {{#waiters?}}
+  # Waiters are utility methods that poll for a particular state to occur
+  # on a client. Waiters can fail after a number of attempts at a polling
+  # interval defined for the service client.
+  #
+  # For a list of operations that can be waited for and the
+  # client methods called for each operation, see the table below or the
+  # {Client#wait_until} field documentation for the {Client}.
+  #
+  # # Invoking a Waiter
+  # To invoke a waiter, call #wait_until on a {Client}. The first parameter
+  # is the waiter name, which is specific to the service client and indicates
+  # which operation is being waited for. The second parameter is a hash of
+  # parameters that are passed to the client method called by the waiter,
+  # which varies according to the waiter name.
+  #
+  # # Wait Failures
+  # To catch errors in a waiter, use WaiterFailed,
+  # as shown in the following example.
+  #
+  #     rescue rescue Aws::Waiters::Errors::WaiterFailed => error
+  #       puts "failed waiting for instance running: #{error.message}
+  #     end
+  #
+  # # Configuring a Waiter
+  # Each waiter has a default polling interval and a maximum number of
+  # attempts it will make before returning control to your program.
+  # To set these values, use the `max_attempts` and `delay` parameters
+  # in your `#wait_until` call.
+  # The following example waits for up to 25 seconds, polling every five seconds.
+  #
+  #     client.wait_until(...) do |w|
+  #       w.max_attempts = 5
+  #       w.delay = 5
+  #     end
+  #
+  # To disable wait failures, set the value of either of these parameters
+  # to `nil`.
+  #
+  # # Extending a Waiter
+  # To modify the behavior of waiters, you can register callbacks that are
+  # triggered before each polling attempt and before waiting.
+  #
+  # The following example implements an exponential backoff in a waiter
+  # by doubling the amount of time to wait on every attempt.
+  #
+  #     client.wait_until(...) do |w|
+  #       w.interval = 0 # disable normal sleep
+  #       w.before_wait do |n, resp|
+  #         sleep(n ** 2)
+  #       end
+  #     end
+  #
+  # # Available Waiters
+  #
+  # The following table lists the valid waiter names, the operations they call,
+  # and the default `:delay` and `:max_attempts` values.
+  #
+  {{#waiters_markdown_table}}
+  {{#lines}}
+  # {{{.}}}{{/lines}}
+  {{/waiters_markdown_table}}
+  #
+  {{/waiters?}}
+  module Waiters
+    {{#waiters}}
+
+    {{> documentation}}
+    class {{class_name}}
+
+      # @param [Hash] options
+      # @option options [required, Client] :client
+      # @option options [Integer] :max_attempts ({{max_attempts}})
+      # @option options [Integer] :delay ({{delay}})
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      def initialize(options)
+        @client = options.fetch(:client)
+        @waiter = Aws::Waiters::Waiter.new({
+          max_attempts: {{max_attempts}},
+          delay: {{delay}},
+          poller: Aws::Waiters::Poller.new(
+            operation_name: :{{client_method}},
+            {{#acceptors}}
+            {{#lines}}
+            {{{.}}}{{/lines}}
+            {{/acceptors}}
+          )
+        }.merge(options))
+      end
+
+      # @option (see Client#{{client_method}})
+      # @return (see Client#{{client_method}})
+      def wait(params = {})
+        @waiter.wait(client: @client, params: params)
+      end
+
+      # @api private
+      attr_reader :waiter
+
+    end
+    {{/waiters}}
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-code-generator
 version: !ruby/object:Gem::Version
-  version: 0.2.0.pre
+  version: 0.2.1.pre
 platform: ruby
 authors:
 - Amazon Web Services
@@ -9,7 +9,35 @@ autorequire:
 bindir: bin
 cert_chain: []
 date: 2020-06-24 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  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'
+- !ruby/object:Gem::Dependency
+  name: mustache
+  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: Generates the service code for the AWS SDK for Ruby
 email:
 - trevrowe@amazon.com
@@ -87,6 +115,29 @@ files:
 - lib/aws-sdk-code-generator/views/waiters_module.rb
 - lib/aws-sdk-code-generator/waiter.rb
 - lib/aws-sdk-code-generator/yard_option_tag.rb
+- templates/apig_endpoint_class.mustache
+- templates/apig_readme.mustache
+- templates/async_client_class.mustache
+- templates/authorizer_class.mustache
+- templates/client_api_module.mustache
+- templates/client_class.mustache
+- templates/code.mustache
+- templates/documentation.mustache
+- templates/errors_module.mustache
+- templates/event_streams_module.mustache
+- templates/features/env.mustache
+- templates/features/smoke.mustache
+- templates/features/smoke_step_definitions.mustache
+- templates/features/step_definitions.mustache
+- templates/gemspec.mustache
+- templates/method.mustache
+- templates/resource_class.mustache
+- templates/root_resource_class.mustache
+- templates/service_module.mustache
+- templates/spec/spec_helper.mustache
+- templates/types_module.mustache
+- templates/version.mustache
+- templates/waiters_module.mustache
 homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0