reforge 0.1.0

data/lib/reforge/transformation/tree/aggregate_node.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Reforge
+  class Transformation
+    class Tree
+      class AggregateNode
+        include Factories
+
+        attr_reader :implementation
+
+        def initialize(key_type)
+          @path = []
+          @implementation = implementation_from(key_type)
+          @key_type = key_type
+        end
+
+        def call(source)
+          implementation.call(source)
+        end
+
+        def []=(key, node)
+          validate_node!(node)
+          validate_key!(key)
+          validate_no_redefinition!(key)
+
+          implementation.children[key] = node
+          node.update_path(@path + [key])
+        end
+
+        def [](key)
+          validate_key!(key)
+
+          implementation.children[key]
+        end
+
+        def update_path(path)
+          @path = path
+          implementation.update_path(path)
+        end
+
+        private
+
+        def validate_node!(node)
+          return if node.is_a?(AggregateNode) || node.is_a?(TransformNode)
+
+          raise ArgumentError, "The node must be an AggregateNode or TransformNode"
+        end
+
+        def validate_key!(key)
+          return if key.is_a?(@key_type)
+
+          invalid_path = @path + [key]
+          raise ArgumentError, "Expected #{key.inspect} at node path #{invalid_path} to be of #{@key_type} type"
+        end
+
+        def validate_no_redefinition!(key)
+          return if implementation.children[key].nil?
+
+          invalid_path = @path + [key]
+          raise NodeRedefinitionError, "Node already exists at #{invalid_path}"
+        end
+      end
+    end
+  end
+end

data/lib/reforge/transformation/tree/aggregate_node/array_node.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Reforge
+  class Transformation
+    class Tree
+      class AggregateNode
+        class ArrayNode
+          attr_reader :children
+
+          def initialize
+            @children = []
+          end
+
+          def call(source)
+            # TRICKY: holes can be present, e.g. at key 1 after setting children at keys 0 and 2
+            children.map { |child| child&.call(source) }
+          end
+
+          def update_path(path)
+            # TRICKY: holes can be present, e.g. at key 1 after setting children at keys 0 and 2
+            children.each_with_index { |child, index| child&.update_path(path + [index]) }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/reforge/transformation/tree/aggregate_node/factories.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Reforge
+  class Transformation
+    class Tree
+      class AggregateNode
+        module Factories
+          IMPLEMENTATION_FACTORIES = {
+            Integer => -> { ArrayNode.new },
+            String => -> { HashNode.new },
+            Symbol => -> { HashNode.new }
+          }.freeze
+          IMPLEMENTATION_TYPES = IMPLEMENTATION_FACTORIES.keys.freeze
+
+          def implementation_from(key_type)
+            validate_key_type!(key_type)
+
+            IMPLEMENTATION_FACTORIES[key_type].call
+          end
+
+          private
+
+          def validate_key_type!(key_type)
+            return if IMPLEMENTATION_TYPES.include?(key_type)
+
+            raise ArgumentError, "No AggregateNode implementation for key_type #{key_type}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/reforge/transformation/tree/aggregate_node/hash_node.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Reforge
+  class Transformation
+    class Tree
+      class AggregateNode
+        class HashNode
+          attr_reader :children
+
+          def initialize
+            @children = {}
+          end
+
+          def call(source)
+            children.transform_values { |child| child.call(source) }
+          end
+
+          def update_path(path)
+            children.each { |key, child| child.update_path(path + [key]) }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/reforge/transformation/tree/transform_node.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Reforge
+  class Transformation
+    class Tree
+      class TransformNode
+        attr_reader :transform
+
+        def initialize(transform)
+          validate_transform!(transform)
+
+          @transform = transform
+        end
+
+        def call(source)
+          transform.call(source)
+        end
+
+        def update_path(path)
+          @path = path
+        end
+
+        private
+
+        def validate_transform!(transform)
+          return if transform.is_a?(Transform)
+
+          raise ArgumentError, "The transform must be a Transform"
+        end
+      end
+    end
+  end
+end

data/lib/reforge/zeitwerk.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "zeitwerk"
+
+# TRICKY: Zeitwerk::Loader.for_gem would work if this were in lib/reforge.rb, but we have initialization here to
+# keep loader logic consolidated. We need to reconstruct the work the work done by that method, and to do so correctly
+# from any location we need to establish a path to our root module and its home directory
+reforge_path = "#{__dir__}/../reforge.rb"
+reforge_dir = File.dirname(File.realpath(reforge_path))
+
+loader = Zeitwerk::Loader.new
+loader.tag = File.basename(reforge_path)
+loader.inflector = Zeitwerk::Inflector.new
+loader.inflector.inflect("dsl" => "DSL")
+loader.push_dir(reforge_dir)
+loader.setup

data/reforge.gemspec

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+Gem::Specification.new do |spec|
+  spec.name = "reforge"
+  spec.version = "0.1.0"
+  spec.authors = ["Nate Eizenga"]
+  spec.email = ["eizengan@gmail.com"]
+
+  spec.summary = "Simple DSL-driven data transformation for Ruby"
+  spec.homepage = "https://github.com/eizengan/reforge"
+  spec.license = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    # spec.metadata["allowed_push_host"] = "Set to 'http://mygemserver.com'"
+
+    spec.metadata["homepage_uri"] = spec.homepage
+    spec.metadata["source_code_uri"] = spec.homepage
+    spec.metadata["changelog_uri"] = "https://github.com/eizengan/reforge/blob/main/CHANGELOG.md"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = "~> 2.6.6"
+
+  spec.add_dependency "zeitwerk", "~> 2.4"
+
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "pry-byebug", "~> 3.9"
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop", "~> 1.0"
+  spec.add_development_dependency "rubocop-performance", "~> 1.8"
+  spec.add_development_dependency "simplecov", "~> 0.17.1" # 0.18 breaks Code Climate. Ref: https://github.com/codeclimate/test-reporter/issues/413
+  spec.add_development_dependency "super_diff", "~> 0.5"
+end

metadata

@@ -0,0 +1,203 @@
+--- !ruby/object:Gem::Specification
+name: reforge
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nate Eizenga
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-01-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.17.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.17.1
+- !ruby/object:Gem::Dependency
+  name: super_diff
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+description:
+email:
+- eizengan@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".tool-versions"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- INTRODUCTION.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/reforge.rb
+- lib/reforge/configuration.rb
+- lib/reforge/transformation.rb
+- lib/reforge/transformation/dsl.rb
+- lib/reforge/transformation/transform.rb
+- lib/reforge/transformation/transform/factories.rb
+- lib/reforge/transformation/transform/memo.rb
+- lib/reforge/transformation/tree.rb
+- lib/reforge/transformation/tree/aggregate_node.rb
+- lib/reforge/transformation/tree/aggregate_node/array_node.rb
+- lib/reforge/transformation/tree/aggregate_node/factories.rb
+- lib/reforge/transformation/tree/aggregate_node/hash_node.rb
+- lib/reforge/transformation/tree/transform_node.rb
+- lib/reforge/zeitwerk.rb
+- reforge.gemspec
+homepage: https://github.com/eizengan/reforge
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/eizengan/reforge
+  source_code_uri: https://github.com/eizengan/reforge
+  changelog_uri: https://github.com/eizengan/reforge/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: 2.6.6
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key:
+specification_version: 4
+summary: Simple DSL-driven data transformation for Ruby
+test_files: []