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

data/lib/aws-sdk-code-generator/views/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module AwsSdkCodeGenerator
   module Views
     class Version < View

data/lib/aws-sdk-code-generator/views/waiters_module.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module AwsSdkCodeGenerator
+  module Views
+    class WaitersModule < View
+
+      def initialize(options)
+        @module_name = options.fetch(:module_name)
+        @waiters = Waiter.build_list(options.fetch(:waiters))
+        @custom = options.fetch(:custom)
+      end
+
+      # @return [String]
+      attr_reader :module_name
+
+      # @return [Array<Waiter>]
+      attr_reader :waiters
+
+      # @return [String|nil]
+      def generated_src_warning
+        return if @custom
+        GENERATED_SRC_WARNING
+      end
+
+      # @return [Boolean]
+      def waiters?
+        waiters.size > 0
+      end
+
+      # @return [String<Markdown>]
+      def waiters_markdown_table
+        Waiter.markdown_table(@waiters)
+      end
+
+    end
+  end
+end

data/lib/aws-sdk-code-generator/waiter.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module AwsSdkCodeGenerator
+  class Waiter
+
+    # @return [String]
+    attr_accessor :name
+
+    # @return [String]
+    attr_accessor :documentation
+
+    # @return [String]
+    attr_accessor :class_name
+
+    # @return [String]
+    attr_accessor :client_method
+
+    # @return [Integer]
+    attr_accessor :delay
+
+    # @return [Integer]
+    attr_accessor :max_attempts
+
+    # @return [String]
+    attr_accessor :acceptors
+
+    # @return [Boolean]
+    attr_accessor :last
+
+    class << self
+
+      # @return [Array<Waiter>]
+      def build_list(waiters)
+        waiters = waiters ? waiters['waiters'] : {}
+        waiters = waiters.map do |waiter_name, waiter|
+          Waiter.new.tap do |w|
+            w.name = Underscore.underscore(waiter_name)
+            w.class_name = waiter_name
+            w.client_method = Underscore.underscore(waiter['operation'])
+            w.delay = waiter['delay'].to_i
+            w.max_attempts = waiter['maxAttempts'].to_i
+            w.acceptors = acceptors(waiter['acceptors'])
+            w.documentation = Docstring.block_comment(waiter['description'])
+          end
+        end.sort_by(&:name)
+        waiters.last.last = true unless waiters.empty?
+        waiters
+      end
+
+      # @return [Map<String, Array<Waiter> >]
+      def build_operations_map(waiters)
+        operations_map = {}
+        waiters = build_list(waiters)
+        waiters.each do |w|
+          (operations_map[w.client_method] ||= []) << w
+        end
+        operations_map
+      end
+
+      # @param [Array<Waiter>]
+      # @return [String<Markdown>]
+      def markdown_table(waiters)
+        table = []
+        table << ['waiter_name', 'params', ':delay', ':max_attempts']
+        waiters.each do |waiter|
+          table << [
+            waiter.name,
+            "{Client##{waiter.client_method}}",
+            waiter.delay,
+            waiter.max_attempts
+          ]
+        end
+        Docstring.markdown_table(table)
+      end
+
+      private
+
+      def acceptors(acceptors)
+        acceptors.each do |acceptor|
+          if acceptor['argument']
+            acceptor['argument'] = Underscore.underscore_jmespath(
+              acceptor['argument']
+            )
+          end
+        end
+        HashFormatter.new(
+          wrap: false,
+          inline: false,
+          quote_strings: true
+        ).format(acceptors: acceptors)
+      end
+
+    end
+  end
+end

data/lib/aws-sdk-code-generator/yard_option_tag.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module AwsSdkCodeGenerator
+  class YardOptionTag
+
+    # @option options [required, String] :name
+    # @option options [Boolean] :required (false)
+    # @option options [required, String] :ruby_type
+    # @option options [String, nil] :docstring (nil)
+    # @option options [Object] :default_value
+    # @option options [String] :option_hash_name ('options')
+    def initialize(options)
+      @name = options.fetch(:name)
+      @ruby_type = options.fetch(:ruby_type)
+      @required = options.fetch(:required, false) ? 'required, ' : ''
+      @docstring = options.fetch(:docstring).to_s
+      @default_value = options[:default_value]
+      @option_hash_name = options.fetch(:option_hash_name, 'options')
+      @indent = options.fetch(:indent, "")
+    end
+
+    def build
+      if @docstring.empty?
+        first_line.rstrip
+      else
+        first_line + Docstring.block_comment(@docstring, gap: "   #{@indent}")
+      end
+    end
+    alias to_str build
+    alias to_s build
+
+    private
+
+    def first_line
+      "# #{@indent}@option #{@option_hash_name} [#{@required}#{@ruby_type}] :#{@name}#{default_value}\n"
+    end
+
+    def default_value
+      @default_value.nil? ? '' : " (#{@default_value.inspect})"
+    end
+
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-code-generator
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre
+  version: 0.2.0.pre
 platform: ruby
 authors:
 - Amazon Web Services
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-12-10 00:00:00.000000000 Z
+date: 2020-06-24 00:00:00.000000000 Z
 dependencies: []
 description: Generates the service code for the AWS SDK for Ruby
 email:
@@ -18,86 +18,80 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/aws-sdk-code-generator.rb
+- lib/aws-sdk-code-generator/api.rb
 - lib/aws-sdk-code-generator/apply_docs.rb
+- lib/aws-sdk-code-generator/client_constructor.rb
+- lib/aws-sdk-code-generator/client_operation_documentation.rb
+- lib/aws-sdk-code-generator/client_operation_list.rb
+- lib/aws-sdk-code-generator/client_response_structure_example.rb
 - lib/aws-sdk-code-generator/code_builder.rb
-- lib/aws-sdk-code-generator/dsl/access_control_statement.rb
-- lib/aws-sdk-code-generator/dsl/attribute_accessor.rb
-- lib/aws-sdk-code-generator/dsl/attribute_reader.rb
-- lib/aws-sdk-code-generator/dsl/attribute_writer.rb
-- lib/aws-sdk-code-generator/dsl/autoload_statement.rb
-- lib/aws-sdk-code-generator/dsl/block_param.rb
-- lib/aws-sdk-code-generator/dsl/class.rb
-- lib/aws-sdk-code-generator/dsl/code_literal.rb
-- lib/aws-sdk-code-generator/dsl/code_object.rb
-- lib/aws-sdk-code-generator/dsl/docstring.rb
-- lib/aws-sdk-code-generator/dsl/eigenclass.rb
-- lib/aws-sdk-code-generator/dsl/extend_statement.rb
-- lib/aws-sdk-code-generator/dsl/formatter.rb
-- lib/aws-sdk-code-generator/dsl/include_statement.rb
-- lib/aws-sdk-code-generator/dsl/main.rb
-- lib/aws-sdk-code-generator/dsl/method.rb
-- lib/aws-sdk-code-generator/dsl/module.rb
-- lib/aws-sdk-code-generator/dsl/option_tag.rb
-- lib/aws-sdk-code-generator/dsl/param.rb
-- lib/aws-sdk-code-generator/dsl/param_list.rb
-- lib/aws-sdk-code-generator/dsl/return_tag.rb
-- lib/aws-sdk-code-generator/dsl/tag_default.rb
-- lib/aws-sdk-code-generator/dsl/tag_docstring.rb
-- lib/aws-sdk-code-generator/dsl/tag_type.rb
+- lib/aws-sdk-code-generator/crosslink.rb
+- lib/aws-sdk-code-generator/docstring.rb
+- lib/aws-sdk-code-generator/error_list.rb
 - lib/aws-sdk-code-generator/errors.rb
+- lib/aws-sdk-code-generator/eventstream_example.rb
 - lib/aws-sdk-code-generator/gem_builder.rb
-- lib/aws-sdk-code-generator/generators/client_api_module.rb
-- lib/aws-sdk-code-generator/generators/client_class.rb
-- lib/aws-sdk-code-generator/generators/client_operation_documentation.rb
-- lib/aws-sdk-code-generator/generators/errors_module.rb
-- lib/aws-sdk-code-generator/generators/resource/action.rb
-- lib/aws-sdk-code-generator/generators/resource/batch_builder.rb
-- lib/aws-sdk-code-generator/generators/resource/builder.rb
-- lib/aws-sdk-code-generator/generators/resource/client_getter.rb
-- lib/aws-sdk-code-generator/generators/resource/client_request.rb
-- lib/aws-sdk-code-generator/generators/resource/client_request_docs.rb
-- lib/aws-sdk-code-generator/generators/resource/client_request_params.rb
-- lib/aws-sdk-code-generator/generators/resource/collection_class.rb
-- lib/aws-sdk-code-generator/generators/resource/data_attribute_getter.rb
-- lib/aws-sdk-code-generator/generators/resource/data_loaded_method.rb
-- lib/aws-sdk-code-generator/generators/resource/data_method.rb
-- lib/aws-sdk-code-generator/generators/resource/exists_method.rb
-- lib/aws-sdk-code-generator/generators/resource/extract_identifier_method.rb
-- lib/aws-sdk-code-generator/generators/resource/has_association.rb
-- lib/aws-sdk-code-generator/generators/resource/has_many_association.rb
-- lib/aws-sdk-code-generator/generators/resource/identifier_getter.rb
-- lib/aws-sdk-code-generator/generators/resource/identifiers_method.rb
-- lib/aws-sdk-code-generator/generators/resource/initialize_method.rb
-- lib/aws-sdk-code-generator/generators/resource/load_method.rb
-- lib/aws-sdk-code-generator/generators/resource/value_source.rb
-- lib/aws-sdk-code-generator/generators/resource/waiter_method.rb
-- lib/aws-sdk-code-generator/generators/resource_class.rb
-- lib/aws-sdk-code-generator/generators/response_structure_example.rb
-- lib/aws-sdk-code-generator/generators/root_resource_class.rb
-- lib/aws-sdk-code-generator/generators/service_documentation.rb
-- lib/aws-sdk-code-generator/generators/shared_example.rb
-- lib/aws-sdk-code-generator/generators/structure_type_class.rb
-- lib/aws-sdk-code-generator/generators/syntax_example.rb
-- lib/aws-sdk-code-generator/generators/types_module.rb
-- lib/aws-sdk-code-generator/generators/waiter_class.rb
-- lib/aws-sdk-code-generator/generators/waiters_module.rb
 - lib/aws-sdk-code-generator/hash_formatter.rb
 - lib/aws-sdk-code-generator/helper.rb
+- lib/aws-sdk-code-generator/plugin_list.rb
+- lib/aws-sdk-code-generator/resource_action.rb
+- lib/aws-sdk-code-generator/resource_action_code.rb
+- lib/aws-sdk-code-generator/resource_association.rb
+- lib/aws-sdk-code-generator/resource_attribute.rb
+- lib/aws-sdk-code-generator/resource_batch_action.rb
+- lib/aws-sdk-code-generator/resource_batch_action_code.rb
+- lib/aws-sdk-code-generator/resource_batch_action_documentation.rb
+- lib/aws-sdk-code-generator/resource_batch_builder.rb
+- lib/aws-sdk-code-generator/resource_builder.rb
+- lib/aws-sdk-code-generator/resource_client_request.rb
+- lib/aws-sdk-code-generator/resource_client_request_documentation.rb
+- lib/aws-sdk-code-generator/resource_client_request_params.rb
+- lib/aws-sdk-code-generator/resource_data_method.rb
+- lib/aws-sdk-code-generator/resource_has_association.rb
+- lib/aws-sdk-code-generator/resource_has_many_association.rb
+- lib/aws-sdk-code-generator/resource_has_many_association_code.rb
+- lib/aws-sdk-code-generator/resource_identifier.rb
+- lib/aws-sdk-code-generator/resource_identifiers_method.rb
+- lib/aws-sdk-code-generator/resource_load_method.rb
+- lib/aws-sdk-code-generator/resource_method.rb
+- lib/aws-sdk-code-generator/resource_skip_params.rb
+- lib/aws-sdk-code-generator/resource_value_source.rb
+- lib/aws-sdk-code-generator/resource_waiter.rb
 - lib/aws-sdk-code-generator/service.rb
+- lib/aws-sdk-code-generator/shared_example.rb
+- lib/aws-sdk-code-generator/syntax_example.rb
+- lib/aws-sdk-code-generator/syntax_example_hash.rb
 - lib/aws-sdk-code-generator/underscore.rb
 - lib/aws-sdk-code-generator/view.rb
 - lib/aws-sdk-code-generator/views.rb
+- lib/aws-sdk-code-generator/views/apig_endpoint_class.rb
+- lib/aws-sdk-code-generator/views/apig_readme.rb
+- lib/aws-sdk-code-generator/views/async_client_class.rb
+- lib/aws-sdk-code-generator/views/authorizer_class.rb
+- lib/aws-sdk-code-generator/views/client_api_module.rb
+- lib/aws-sdk-code-generator/views/client_class.rb
+- lib/aws-sdk-code-generator/views/docstring.rb
+- lib/aws-sdk-code-generator/views/errors_module.rb
+- lib/aws-sdk-code-generator/views/event_streams_module.rb
 - lib/aws-sdk-code-generator/views/features/env.rb
+- lib/aws-sdk-code-generator/views/features/smoke.rb
+- lib/aws-sdk-code-generator/views/features/smoke_step_definitions.rb
 - lib/aws-sdk-code-generator/views/features/step_definitions.rb
 - lib/aws-sdk-code-generator/views/gemspec.rb
+- lib/aws-sdk-code-generator/views/resource_class.rb
+- lib/aws-sdk-code-generator/views/root_resource_class.rb
 - lib/aws-sdk-code-generator/views/service_module.rb
 - lib/aws-sdk-code-generator/views/spec/spec_helper.rb
+- lib/aws-sdk-code-generator/views/types_module.rb
 - lib/aws-sdk-code-generator/views/version.rb
-homepage: http://github.com/aws/aws-sdk-ruby
+- 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
+homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
-- Apache 2.0
+- Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -112,9 +106,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: AWS SDK for Ruby - Code Generator
 test_files: []

data/lib/aws-sdk-code-generator/dsl/access_control_statement.rb

@@ -1,23 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class AccessControlStatement
-
-      include Dsl::CodeObject
-
-      def initialize(access)
-        if [:public, :protected, :private].include?(access)
-          @access = access
-        else
-          raise ArgumentError, "expected :public, :protected, or :private"
-        end
-      end
-
-      attr_reader :access
-
-      def lines
-        [access.to_s]
-      end
-
-    end
-  end
-end

data/lib/aws-sdk-code-generator/dsl/attribute_accessor.rb

@@ -1,43 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class AttributeAccessor
-
-      include Dsl::CodeObject
-
-      # @option options [Boolean] :api_private (false)
-      def initialize(name, options = {}, &block)
-        @name = name
-        @tags = []
-        yield(self) if block
-        api_private! if options.fetch(:api_private, false)
-      end
-
-      attr_reader :name
-
-      def returns(type, options = {})
-        @tags << ReturnTag.new(options.merge(type:type))
-      end
-
-      def api_private!
-        @tags << "# @api private"
-      end
-
-      def documented?
-        !@tags.empty?
-      end
-
-      def lines
-        lines = []
-        @tags.each do |tag|
-          lines.concat(tag.lines.to_a)
-        end
-        lines + ["#{macro} :#{@name}"]
-      end
-
-      def macro
-        "attr_accessor"
-      end
-
-    end
-  end
-end

data/lib/aws-sdk-code-generator/dsl/attribute_reader.rb

@@ -1,11 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class AttributeReader < AttributeAccessor
-
-      def macro
-        "attr_reader"
-      end
-
-    end
-  end
-end

data/lib/aws-sdk-code-generator/dsl/attribute_writer.rb

@@ -1,11 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class AttributeWriter < AttributeAccessor
-
-      def macro
-        "attr_writer"
-      end
-
-    end
-  end
-end