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

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

@@ -1,17 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class IncludeStatement
-
-      include Dsl::CodeObject
-
-      def initialize(module_name)
-        @module_name = module_name
-      end
-
-      def lines
-        ["include #{@module_name}"]
-      end
-
-    end
-  end
-end

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

@@ -1,105 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class Main
-
-      include Dsl::CodeObject
-
-      # @option options [Main, Module] :parent (nil)
-      def initialize(options = {}, &block)
-        @comments = Docstring.new(nil)
-        @top_content = []
-        @code_objects = []
-        @parent = options.fetch(:parent, nil)
-        yield(self) if block
-      end
-
-      # @return [nil, CodeObject]
-      attr_accessor :parent
-
-      # @return [nil, CodeObject]
-      def root
-        root = self
-        root = root.parent while root && root.parent
-        root
-      end
-
-      def add(*code_objects)
-        code_objects.each do |code_obj|
-          @code_objects << code_obj unless code_obj.nil?
-        end
-      end
-
-      def code(code = nil, &block)
-        @code_objects << CodeLiteral.new(code, &block)
-      end
-
-      def comments(docstring)
-        @comments = Docstring.new(docstring)
-      end
-
-      def include_module(module_name)
-        add(IncludeStatement.new(module_name))
-      end
-      alias :include :include_module
-
-      def extend_module(module_name)
-        add(ExtendStatement.new(module_name))
-      end
-      alias :extend :extend_module
-
-      def require_statement(path)
-        @top_content << "require '#{path}'"
-      end
-      alias require require_statement
-
-      # Allows inserting top-of document content.
-      def top(string)
-        root.instance_variable_get("@top_content") << string
-      end
-
-      def require_relative(path)
-        @top_content << "require_relative '#{path}'"
-      end
-
-      def method(name, options = {}, &block)
-        m = Dsl::Method.new(name, options)
-        yield(m) if block
-        add(m)
-      end
-
-      def module(name, &block)
-        m = Dsl::Module.new(name, parent: self)
-        yield(m) if block
-        add(m)
-        m
-      end
-
-      def class(name, options = {}, &block)
-        c = Dsl::Class.new(name, options.merge(parent: self))
-        yield(c) if block
-        add(c)
-        c
-      end
-
-      def lines
-
-        lines = []
-
-        lines.concat(@comments.lines)
-        lines << :newline unless @comments.empty?
-
-        @top_content.each do |statement|
-          lines << statement
-        end
-        lines << :newline unless @top_content.empty?
-
-        @code_objects.each.with_index do |code_obj, n|
-          lines.concat(code_obj.lines)
-          lines << :newline unless n == @code_objects.size - 1
-        end
-        lines
-      end
-
-    end
-  end
-end

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

@@ -1,108 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class Method
-
-      include Dsl::CodeObject
-
-      # @option options [Symbol] :access (:public)
-      # @option options [String, nil] :docstring (nil)
-      def initialize(name, options = {}, &block)
-        @name = name.to_s
-        @access = options.fetch(:access, :public)
-        @code_objects = []
-        @params = []
-        @option_tags = []
-        @return_tags = []
-        @aliases = []
-        @docstring = Dsl::Docstring.new(options.fetch(:docstring, nil))
-        @api_private = options.fetch(:api_private, false)
-        yield(self) if block
-      end
-
-      attr_reader :name
-
-      attr_reader :access
-
-      attr_reader :aliases
-
-      def param(name, options = {})
-        @params << Param.new(name, options)
-      end
-
-      def option(options)
-        @option_tags << OptionTag.new(options)
-      end
-
-      def returns(type, options = {})
-        @return_tags << ReturnTag.new(options.merge(type:type))
-      end
-
-      def add(*code_objects)
-        @code_objects.concat(code_objects)
-      end
-
-      def code(code = nil, &block)
-        @code_objects << CodeLiteral.new(code, &block)
-      end
-
-      def empty?
-        @code_objects.empty?
-      end
-
-      def docstring(docstring = nil, &block)
-        @docstring.append(docstring)
-        yield(@docstring) if block
-        @docstring
-      end
-
-      def block_param
-        @params << BlockParam.new
-      end
-
-      def alias_as(other_name)
-        @aliases << other_name.to_s
-      end
-
-      def lines
-        code = []
-        code.concat(yard_docs)
-        code << method_signature
-        code << method_body
-        code << method_end
-        code.concat(@aliases.map { |a| "alias :#{a} :#{@name}" })
-        code
-      end
-
-      private
-
-      def yard_docs
-        docs = []
-        docs.concat(@docstring.lines)
-        tags = []
-        tags.concat(ParamList.new(@params).tags)
-        tags.concat(@option_tags)
-        tags.concat(@return_tags)
-        tags << "# @api private" if @api_private
-        tags.each.with_index do |tag, n|
-          docs.concat(tag.lines.to_a)
-        end
-        docs.compact
-      end
-
-      def method_signature
-        "def #{@name}#{ParamList.new(@params).signature}"
-      end
-
-      def method_body
-        @code_objects.inject([]) do |lines, code_obj|
-          lines.concat(code_obj.lines)
-        end
-      end
-
-      def method_end
-        "end"
-      end
-
-    end
-  end
-end

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

@@ -1,167 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class Module < Dsl::Main
-
-      include Dsl::CodeObject
-
-      # @option options [Main, Module] :parent (nil)
-      def initialize(name, options = {}, &block)
-        @name = name
-        @code_objects = []
-        @access = :public
-        @parent = options.fetch(:parent, nil)
-        @docstring = Dsl::Docstring.new(nil)
-        yield(self) if block
-      end
-
-      attr_reader :name
-
-      def add(*code_objects)
-        code_objects.each do |code_object|
-          if Dsl::Method === code_object && code_object.access != @access
-            add(AccessControlStatement.new(code_object.access))
-          elsif Dsl::AccessControlStatement === code_object
-            @access = code_object.access
-          end
-          super(code_object)
-        end
-      end
-
-      def require_statement(path)
-        root.require(path)
-      end
-      alias require require_statement
-
-      def docstring(docstring = nil)
-        @docstring ||= Dsl::Docstring.new
-        @docstring.append(docstring) unless docstring.nil?
-        @docstring
-      end
-
-      def require_relative(path)
-        root.require_relative(path)
-      end
-
-      def constructor(options = {}, &block)
-        method(:initialize, options, &block)
-      end
-
-      def attr_accessor(name, options = {}, &block)
-        a = Dsl::AttributeAccessor.new(name, options)
-        yield(a) if block
-        add(a)
-      end
-
-      def autoload(const_name, path)
-        @code_objects << AutoloadStatement.new(const_name, path)
-      end
-
-      def attr_reader(name, options = {}, &block)
-        a = Dsl::AttributeReader.new(name, options)
-        yield(a) if block
-        add(a)
-      end
-
-      def attr_writer(name, &block)
-        a = Dsl::AttributeWriter.new(name)
-        yield(a) if block
-        add(a)
-      end
-
-      def eigenclass(&block)
-        m = Dsl::Eigenclass.new
-        yield(m) if block
-        add(m)
-      end
-
-      def lines
-        code = []
-        code.concat(@docstring.lines)
-        code += open_module
-        code << :newline if padded?(0)
-
-        @code_objects.each.with_index do |code_object, n|
-          code << code_object.lines
-          code << :newline if separator?(n)
-        end
-
-        if @code_objects.empty?
-          code[-1] += "; end"
-        else
-          code += close_module
-        end
-        code
-      end
-
-      private
-
-      def open_module
-        ["module #{@name}"]
-      end
-
-      def close_module
-        ["end"]
-      end
-
-      def padded?(n)
-        !@code_objects[n].kind_of?(Dsl::Module) &&
-        !(
-          @code_objects.all? { |obj| autoload_statement?(obj) } ||
-          @code_objects.all? { |obj| mixin?(obj) } ||
-          @code_objects.all? { |obj| undocumented_attr_macro?(obj) }
-        )
-      end
-
-      def separator?(n)
-        if last?(n)
-          padded?(@code_objects.size - 1)
-        elsif grouped_statements?(n)
-          false
-        else
-          true
-        end
-      end
-
-      def last?(n)
-        @code_objects.size == n + 1
-      end
-
-      def grouped_statements?(n)
-        two_autoloads?(n) ||
-        two_mixins?(n) ||
-        two_undocumented_attr_macros?(n)
-      end
-
-      def two_autoloads?(n)
-        @code_objects[n + 1] &&
-        autoload_statement?(@code_objects[n + 1]) &&
-        autoload_statement?(@code_objects[n])
-      end
-
-      def two_mixins?(n)
-        @code_objects[n + 1] &&
-        mixin?(@code_objects[n + 1]) &&
-        mixin?(@code_objects[n])
-      end
-
-      def two_undocumented_attr_macros?(n)
-        @code_objects[n + 1] &&
-        undocumented_attr_macro?(@code_objects[n + 1]) &&
-        undocumented_attr_macro?(@code_objects[n])
-      end
-
-      def autoload_statement?(code_object)
-        Dsl::AutoloadStatement === code_object
-      end
-
-      def mixin?(code_object)
-        Dsl::IncludeStatement === code_object
-      end
-
-      def undocumented_attr_macro?(code_object)
-        Dsl::AttributeAccessor === code_object && !code_object.documented?
-      end
-
-    end
-  end
-end

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

@@ -1,36 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class OptionTag
-
-      # @option options [required, String] :name
-      # @option options [required, String] :type
-      # @option options [String] :param ('options')
-      # @option options [Boolean] :required (false)
-      # @option options [String, nil] :docstring (nil)
-      # @option options [Object] :default
-      def initialize(options)
-        @name = options.fetch(:name)
-        @type = options.fetch(:type)
-        @param = options.fetch(:param, 'options')
-        @required = options.fetch(:required, false) ? 'required, ' : ''
-        @docstring = Dsl::TagDocstring.new(options.fetch(:docstring, nil))
-        @default = Dsl::TagDefault.new(options.fetch(:default, nil))
-      end
-
-      def lines
-        [first_line] + @docstring.lines
-      end
-
-      private
-
-      def first_line
-        "# @option #{@param} [#{@required}#{@type}] :#{@name}#{yard_default}"
-      end
-
-      def yard_default
-        @default.empty? ? '' : " (#{@default})"
-      end
-
-    end
-  end
-end

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

@@ -1,43 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    class Param
-
-      # @option options [String] :type
-      # @option options [Object] :default
-      # @option options [String] :docstring
-      # @option options [Boolean] :documented (true)
-      def initialize(name, options = {})
-        @name = name.to_s
-        @type = TagType.new(options.fetch(:type, nil))
-        @default = TagDefault.new(options.fetch(:default, nil))
-        @docstring = TagDocstring.new(options.fetch(:docstring, nil))
-        @documented = options.fetch(:documented, true)
-      end
-
-      attr_reader :name, :default
-
-      def documented?
-        !!@documented
-      end
-
-      def tag
-        if [@type, @default, @docstring].all?(&:empty?)
-          []
-        else
-          [first_line] + @docstring.lines
-        end
-      end
-
-      private
-
-      def first_line
-        "# @param#{@type} #{@name}#{yard_default}"
-      end
-
-      def yard_default
-        @default.empty? ? '' : " (#{@default})"
-      end
-
-    end
-  end
-end

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

@@ -1,38 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    # @api private
-    class ParamList
-
-      def initialize(params)
-        @params = params
-      end
-
-      def signature
-        if @params.empty?
-          nil
-        else
-          "(#{@params.map { |p| param_signature(p) }.join(', ')})"
-        end
-      end
-
-      def tags
-        lines = []
-        @params.each do |param|
-          lines.concat(param.tag) if param.documented?
-        end
-        lines
-      end
-
-      private
-
-      def param_signature(param)
-        if param.default.empty?
-          param.name
-        else
-          "#{param.name} = #{param.default}"
-        end
-      end
-
-    end
-  end
-end

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

@@ -1,19 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    # @api private
-    class ReturnTag
-
-      # @option options [required, String] :type
-      # @option options [String] :docstring
-      def initialize(options)
-        @type = Dsl::TagType.new(options.fetch(:type))
-        @docstring = Dsl::TagDocstring.new(options.fetch(:docstring, nil))
-      end
-
-      def lines
-        ["# @return#{@type}"] + @docstring.lines
-      end
-
-    end
-  end
-end

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

@@ -1,20 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    # @api private
-    class TagDefault
-
-      def initialize(default)
-        @default = default
-      end
-
-      def to_s
-        @default.inspect
-      end
-
-      def empty?
-        @default.nil?
-      end
-
-    end
-  end
-end

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

@@ -1,27 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    # @api private
-    class TagDocstring
-
-      def initialize(docstring)
-        @lines = docstring.to_s.strip.lines.inject([]) do |lines, line|
-          line = line.rstrip
-          if line.empty?
-            lines << "#"
-          else
-            lines << "#   #{line.rstrip}"
-          end
-        end
-      end
-
-      # @return Array<String>
-      attr_reader :lines
-
-      # @return [Boolean]
-      def empty?
-        @lines.empty?
-      end
-
-    end
-  end
-end

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

@@ -1,18 +0,0 @@
-module AwsSdkCodeGenerator
-  module Dsl
-    # @api private
-    class TagType < String
-
-      def self.new(type)
-        if type
-          types = Array(type)
-          types = types.map { |t| t.nil? ? 'nil' : t.to_s }
-          super(types.empty? ? '' : " [#{types.join(', ')}]")
-        else
-          super('')
-        end
-      end
-
-    end
-  end
-end