abstract_mapper 0.0.2 → 0.1.0

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: abstract_mapper
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.1.0
 platform: ruby
 authors:
 - Andrew Kozin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-06 00:00:00.000000000 Z
+date: 2015-09-18 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: attributes_dsl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
 - !ruby/object:Gem::Dependency
   name: ice_nine
   requirement: !ruby/object:Gem::Requirement
@@ -92,24 +106,25 @@ files:
 - config/metrics/simplecov.yml
 - config/metrics/yardstick.yml
 - lib/abstract_mapper.rb
-- lib/abstract_mapper/attributes.rb
-- lib/abstract_mapper/branch.rb
+- lib/abstract_mapper/ast.rb
+- lib/abstract_mapper/ast/branch.rb
+- lib/abstract_mapper/ast/node.rb
 - lib/abstract_mapper/builder.rb
-- lib/abstract_mapper/command.rb
 - lib/abstract_mapper/commands.rb
+- lib/abstract_mapper/commands/base.rb
 - lib/abstract_mapper/dsl.rb
+- lib/abstract_mapper/errors.rb
 - lib/abstract_mapper/errors/unknown_command.rb
 - lib/abstract_mapper/errors/wrong_node.rb
 - lib/abstract_mapper/errors/wrong_rule.rb
 - lib/abstract_mapper/functions.rb
-- lib/abstract_mapper/node.rb
 - lib/abstract_mapper/optimizer.rb
-- lib/abstract_mapper/pair_rule.rb
 - lib/abstract_mapper/rspec.rb
-- lib/abstract_mapper/rule.rb
 - lib/abstract_mapper/rules.rb
+- lib/abstract_mapper/rules/base.rb
+- lib/abstract_mapper/rules/pair.rb
+- lib/abstract_mapper/rules/sole.rb
 - lib/abstract_mapper/settings.rb
-- lib/abstract_mapper/sole_rule.rb
 - lib/abstract_mapper/version.rb
 - lib/rspec/doubles.rb
 - lib/rspec/nodes.rb
@@ -118,9 +133,10 @@ files:
 - spec/integration/mapper_definition_spec.rb
 - spec/integration/rspec_examples_spec.rb
 - spec/spec_helper.rb
-- spec/unit/abstract_mapper/branch_spec.rb
+- spec/unit/abstract_mapper/ast/branch_spec.rb
+- spec/unit/abstract_mapper/ast/node_spec.rb
 - spec/unit/abstract_mapper/builder_spec.rb
-- spec/unit/abstract_mapper/command_spec.rb
+- spec/unit/abstract_mapper/commands/base_spec.rb
 - spec/unit/abstract_mapper/commands_spec.rb
 - spec/unit/abstract_mapper/dsl_spec.rb
 - spec/unit/abstract_mapper/errors/unknown_command_spec.rb
@@ -131,13 +147,12 @@ files:
 - spec/unit/abstract_mapper/functions/identity_spec.rb
 - spec/unit/abstract_mapper/functions/restrict_spec.rb
 - spec/unit/abstract_mapper/functions/subclass_spec.rb
-- spec/unit/abstract_mapper/node_spec.rb
 - spec/unit/abstract_mapper/optimizer_spec.rb
-- spec/unit/abstract_mapper/pair_rule_spec.rb
-- spec/unit/abstract_mapper/rule_spec.rb
+- spec/unit/abstract_mapper/rules/base_spec.rb
+- spec/unit/abstract_mapper/rules/pair_spec.rb
+- spec/unit/abstract_mapper/rules/sole_spec.rb
 - spec/unit/abstract_mapper/rules_spec.rb
 - spec/unit/abstract_mapper/settings_spec.rb
-- spec/unit/abstract_mapper/sole_rule_spec.rb
 - spec/unit/abstract_mapper_spec.rb
 homepage: https://github.com/nepalez/abstract_mapper
 licenses:
@@ -159,7 +174,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: AST for ruby mappers
@@ -169,9 +184,6 @@ test_files:
 - spec/integration/faceter.rb
 - spec/integration/rspec_examples_spec.rb
 - spec/unit/abstract_mapper/dsl_spec.rb
-- spec/unit/abstract_mapper/rule_spec.rb
-- spec/unit/abstract_mapper/sole_rule_spec.rb
-- spec/unit/abstract_mapper/pair_rule_spec.rb
 - spec/unit/abstract_mapper/functions/compact_spec.rb
 - spec/unit/abstract_mapper/functions/filter_spec.rb
 - spec/unit/abstract_mapper/functions/restrict_spec.rb
@@ -182,11 +194,14 @@ test_files:
 - spec/unit/abstract_mapper/errors/wrong_node_spec.rb
 - spec/unit/abstract_mapper/errors/unknown_command_spec.rb
 - spec/unit/abstract_mapper/errors/wrong_rule_spec.rb
+- spec/unit/abstract_mapper/rules/pair_spec.rb
+- spec/unit/abstract_mapper/rules/sole_spec.rb
+- spec/unit/abstract_mapper/rules/base_spec.rb
 - spec/unit/abstract_mapper/commands_spec.rb
-- spec/unit/abstract_mapper/node_spec.rb
+- spec/unit/abstract_mapper/commands/base_spec.rb
 - spec/unit/abstract_mapper/settings_spec.rb
-- spec/unit/abstract_mapper/branch_spec.rb
+- spec/unit/abstract_mapper/ast/node_spec.rb
+- spec/unit/abstract_mapper/ast/branch_spec.rb
 - spec/unit/abstract_mapper/optimizer_spec.rb
-- spec/unit/abstract_mapper/command_spec.rb
 - spec/unit/abstract_mapper_spec.rb
 has_rdoc: 

data/lib/abstract_mapper/attributes.rb

@@ -1,65 +0,0 @@
-# encoding: utf-8
-
-class AbstractMapper
-
-  # Defines attributes along with the DSL for setting them
-  #
-  module Attributes
-
-    # @private
-    def self.included(klass)
-      klass.__send__ :extend, DSL
-    end
-
-    # @!attribute [r] attributes
-    #
-    # @return [Hash] The initialized attributes
-    #
-    attr_reader :attributes
-
-    # Initializes the instance with the hash of attributes
-    #
-    # @param [Hash] attributes
-    #
-    def initialize(attributes)
-      @attributes = Functions[:restrict, self.class.attributes][attributes]
-    end
-
-    # Attributes DSL
-    #
-    module DSL
-
-      # Makes a attributes inheritable
-      #
-      # @private
-      #
-      def inherited(klass)
-        attributes.each { |key, value| klass.attribute key, default: value }
-      end
-
-      # Default attributes for the node
-      #
-      # @return [Hash]
-      #
-      def attributes
-        @attributes ||= {}
-      end
-
-      # Declares the attribute
-      #
-      # @param [#to_sym] name
-      # @param [Hash] options
-      # @option options [Object] :default
-      #
-      # @return [undefined]
-      #
-      def attribute(name, options = {})
-        attributes[name.to_sym] = options[:default]
-        define_method(name) { attributes[name.to_sym] }
-      end
-
-    end # module DSL
-
-  end # module Attributes
-
-end # class AbstractMapper

data/lib/abstract_mapper/branch.rb

@@ -1,120 +0,0 @@
-# encoding: utf-8
-
-class AbstractMapper
-
-  # A special type of the composed node, that describes transformation,
-  # applied to some level of nested input.
-  #
-  # Unlike the simple node, describing a transformation of data, the
-  # branch carries a collection of subnodes along with methods to [#update]
-  # itself with the same attributes and different subnodes.
-  #
-  # Tne branch only stores subnodes and composes transformations.
-  # Its has no access to DSL and knows neither how to build a tree
-  # (see [AbstractMapper::Builder]), nor how to optimize it later
-  # (see [AbstractMapper::Optimizer]).
-  #
-  # @api public
-  #
-  class Branch < Node
-
-    include Enumerable
-
-    # @!scope class
-    # @!method new(*attributes, &block)
-    # Creates a new branch
-    #
-    # @param [Object, Array<Object>] attributes
-    #   The list of type-specific attributes of the branch
-    # @param [Proc] block
-    #   The block that returns an array of subnodes for the branch
-    #
-    # @return [Branch::Node]
-
-    # @private
-    def initialize(attributes = {})
-      @subnodes = block_given? ? yield : []
-      super(attributes, &nil)
-    end
-
-    # Returns a new branch of the same type, with the same attributes,
-    # but with a different collection of subnodes, transmitted by the block.
-    #
-    # @example
-    #   branch = Branch.new(:foo)
-    #   # => <Branch(:foo) []>
-    #   branch.update { Node.new(:bar) }
-    #   # => <Branch(:foo) [<Node(:bar)>]>
-    #
-    # @param [Proc] block
-    #   The block that should return an array of subnodes for the branch
-    #
-    # @return [AbstractMapper::Branch]
-    #
-    # @yield block
-    #
-    def update
-      self.class.new(attributes) { yield }
-    end
-
-    # @!method each
-    # Returns the enumerator for subnodes
-    #
-    # @return [Enumerator]
-    #
-    def each(&block)
-      @subnodes.each(&block)
-    end
-
-    # Returns a new branch with the other node added to its subnodes
-    #
-    # @param [AbstractMapper::Node] other
-    #
-    # @return [AbstractMapper::Branch]
-    #
-    def <<(other)
-      update { entries << other }
-    end
-
-    # The composition of transformations from all subnodes of the branch
-    #
-    # To be reloaded by the subclasses to apply the composition to
-    # a corresponding level of nested data.
-    #
-    # @return [Transproc::Function]
-    #
-    # @abstract
-    #
-    def transproc
-      map(&:transproc).inject(:>>)
-    end
-
-    # Adds subnodes to the default description of the branch
-    #
-    # @return [String]
-    #
-    def to_s
-      "#{super} [#{map(&:inspect).join(", ")}]"
-    end
-
-    # Checks equality of branches by type, attributes and subnodes
-    #
-    # @param [Other] other
-    #
-    # @return [Boolean]
-    #
-    def eql?(other)
-      super && entries.eql?(other.entries)
-    end
-
-    private
-
-    # Substitutes the name of the class by the special name "Root"
-    # to describe the root node of AST.
-    def __name__
-      instance_of?(Branch) ? "Root" : super
-    end
-
-  end # class Branch
-
-end # class AbstractMapper

data/lib/abstract_mapper/command.rb

@@ -1,68 +0,0 @@
-# encoding: utf-8
-
-class AbstractMapper
-
-  # Describes the command of the mapper
-  #
-  # Every command has a name, a node that is added to the AST and the function,
-  # that converts command attributes into the node's.
-  #
-  # Method `#call` builds a correspodning node for the AST.
-  #
-  # @api private
-  #
-  class Command
-
-    # @!attribute [r] name
-    #
-    # @return [Symbol] The name of the DSL command
-    #
-    attr_reader :name
-
-    # @!attribute [r] klass
-    #
-    # @return [Class] The class of the node to be created
-    #
-    attr_reader :klass
-
-    # @!attribute [r] converter
-    #
-    # @return [#call] The converter of the command's arguments into the node's
-    #
-    attr_reader :converter
-
-    # @!scope class
-    # @!method new(name, klass, converter)
-    # Creates the named command for node klass and arguments converter
-    #
-    # @param [#to_sym] name The name of the DSL command
-    # @param [Class] klass The klass of the node to be created
-    # @param [#call] converter The function that coerces attributes
-    #
-    # @return [AbstractMapper::Command]
-
-    # @private
-    def initialize(name, klass, converter = nil)
-      @name = name.to_sym
-      @klass = klass
-      @branch = Functions[:subclass?, Branch][klass]
-      @converter = converter || proc { |args = {}| args }
-      IceNine.deep_freeze(self)
-    end
-
-    # Builds the AST node
-    #
-    # @param [Object, Array] args
-    #   The argument of the command that should be converted to node attributes
-    # @param [Proc] block
-    #
-    # @return [AbstractMapper::Node]
-    #
-    def call(*args, &block)
-      block = nil if @branch
-      klass.new(converter.call(*args), &block)
-    end
-
-  end # class Command
-
-end # class AbstractMapper

data/lib/abstract_mapper/node.rb

@@ -1,87 +0,0 @@
-# encoding: utf-8
-
-class AbstractMapper
-
-  # An immutable node of the abstract syntax tree (AST), that describes
-  # either some "end-up" transformation, or a level of nested input data.
-  #
-  # Every node is expected to accept attributes and (possibly) block, and
-  # implement `#transproc` that implements the `#call` method to
-  # transform input data to the output.
-  #
-  # Nodes describe only the structure of AST, they know
-  # neither how to build the tree with DSL (see [AbstractMapper::Builder]),
-  # nor how to optimize it later (see [AbstractMapper::Optimizer]).
-  #
-  # @api public
-  #
-  class Node
-
-    include Attributes # adds attributes and their DSL
-    include Comparable
-
-    # @!attribute [r] block
-    #
-    # @return [Proc] The block given to initializer
-    #
-    attr_reader :block
-
-    # @private
-    def initialize(_ = {}, &block)
-      super
-      @block      = block
-      IceNine.deep_freeze(self)
-    end
-
-    # @!method transproc
-    # The transformation function for the branch
-    #
-    # @return [Transproc::Function]
-    #
-    # @abstract
-    #
-    def transproc
-      Functions[:identity]
-    end
-
-    # Returns a human-readable string representating the node
-    #
-    # @return [String]
-    #
-    def inspect
-      "<#{self}>"
-    end
-
-    # Converts the node into string with its name and attributes
-    #
-    # @return [String]
-    #
-    def to_s
-      "#{__name__}#{__attributes__}"
-    end
-
-    # Compares the node to another one by type and attributes
-    #
-    # @param [Object] other
-    #
-    # @return [Boolean]
-    #
-    def ==(other)
-      other.instance_of?(self.class) && attributes.eql?(other.attributes)
-    end
-    alias_method :eql?, :==
-
-    private
-
-    def __name__
-      self.class.name.split("::").last
-    end
-
-    def __attributes__
-      return if attributes.empty?
-      "(#{attributes.map { |k, v| "#{k}: #{v.inspect}" }.join(", ")})"
-    end
-
-  end # class Node
-
-end # class AbstractMapper