callable_tree 0.1.0

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'callable_tree'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/callable_tree.gemspec

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'lib/callable_tree/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'callable_tree'
+  spec.version       = CallableTree::VERSION
+  spec.authors       = ['jsmmr']
+  spec.email         = ['jsmmr@icloud.com']
+
+  spec.summary       = 'Builds a tree by linking callable nodes. The nodes that match the calling condition are called in a chain from the root node to the leaf node. This is like nested case statements.'
+  spec.description   = 'Builds a tree by linking callable nodes. The nodes that match the calling condition are called in a chain from the root node to the leaf node. This is like nested case statements.'
+  spec.homepage      = 'https://github.com/jsmmr/ruby_callable_tree'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.4.0')
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/jsmmr/ruby_callable_tree'
+  spec.metadata['changelog_uri'] = 'https://github.com/jsmmr/ruby_callable_tree/CHANGELOG.md'
+
+  # 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{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+
+  # For more information and examples about making a new gem, checkout our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/examples/docs/animals.json

@@ -0,0 +1,6 @@
+{
+  "animals": [
+    { "name": "Dog", "emoji": "🐶" },
+    { "name": "Cat", "emoji": "🐱" }
+  ]
+}

data/examples/docs/animals.xml

@@ -0,0 +1 @@
+<root><animals><animal name="Dog" emoji="🐶" /><animal name="Cat" emoji="🐱" /></animals></root>

data/examples/docs/fruits.json

@@ -0,0 +1,6 @@
+{
+  "fruits": [
+    { "name": "Red Apple", "emoji": "🍎" },
+    { "name": "Green Apple", "emoji": "🍏" }
+  ]
+}

data/examples/docs/fruits.xml

@@ -0,0 +1 @@
+<root><fruits><fruit name="Red Apple" emoji="🍎" /><fruit name="Green Apple" emoji="🍏" /></fruits></root>

data/examples/example1.rb

@@ -0,0 +1,101 @@
+require 'callable_tree'
+require 'json'
+require 'rexml/document'
+
+module Node
+  module JSON
+    class Parser
+      include CallableTree::Node::Internal
+
+      def match?(input, **options)
+        File.extname(input) == '.json'
+      end
+
+      def call(input, **options)
+        File.open(input) do |file|
+          json = ::JSON.load(file)
+          super(json, **options)
+        end
+      end
+
+      def terminate?(_output, **)
+        true
+      end
+    end
+
+    class Scraper
+      include CallableTree::Node::External
+
+      def initialize(type:)
+        @type = type
+      end
+
+      def match?(input, **options)
+        !!input[@type.to_s]
+      end
+
+      def call(input, **options)
+        input[@type.to_s]
+          .map { |element| [element['name'], element['emoji']] }
+          .to_h
+      end
+    end
+  end
+
+  module XML
+    class Parser
+      include CallableTree::Node::Internal
+
+      def match?(input, **options)
+        File.extname(input) == '.xml'
+      end
+
+      def call(input, **options)
+        File.open(input) do |file|
+          super(REXML::Document.new(file), **options)
+        end
+      end
+
+      def terminate?(_output, **)
+        true
+      end
+    end
+
+    class Scraper
+      include CallableTree::Node::External
+
+      def initialize(type:)
+        @type = type
+      end
+
+      def match?(input, **options)
+        !input.get_elements("//#{@type}").empty?
+      end
+
+      def call(input, **options)
+        input
+          .get_elements("//#{@type}")
+          .first
+          .map { |element| [element['name'], element['emoji']] }
+          .to_h
+      end
+    end
+  end
+end
+
+tree = CallableTree::Node::Root.new.append(
+  Node::JSON::Parser.new.append(
+    Node::JSON::Scraper.new(type: :animals),
+    Node::JSON::Scraper.new(type: :fruits)
+  ),
+  Node::XML::Parser.new.append(
+    Node::XML::Scraper.new(type: :animals),
+    Node::XML::Scraper.new(type: :fruits)
+  )
+)
+
+Dir.glob(__dir__ + '/docs/*') do |file|
+  options = { foo: :bar }
+  puts tree.call(file, **options)
+  puts '---'
+end

data/examples/example2.rb

@@ -0,0 +1,101 @@
+require 'callable_tree'
+require 'json'
+require 'rexml/document'
+
+module Node
+  module JSON
+    class Parser
+      include CallableTree::Node::Internal
+
+      def match?(input, **options)
+        File.extname(input) == '.json'
+      end
+
+      def call(input, **options)
+        File.open(input) do |file|
+          json = ::JSON.load(file)
+          super(json, **options)
+        end
+      end
+
+      def terminate?(_output, **)
+        true
+      end
+    end
+
+    class Scraper
+      include CallableTree::Node::External
+
+      def initialize(type:)
+        @type = type
+      end
+
+      def match?(input, **options)
+        !!input[@type.to_s]
+      end
+
+      def call(input, **options)
+        input[@type.to_s]
+          .map { |element| [element['name'], element['emoji']] }
+          .to_h
+      end
+    end
+  end
+
+  module XML
+    class Parser
+      include CallableTree::Node::Internal
+
+      def match?(input, **options)
+        File.extname(input) == '.xml'
+      end
+
+      def call(input, **options)
+        File.open(input) do |file|
+          super(REXML::Document.new(file), **options)
+        end
+      end
+
+      def terminate?(_output, **)
+        true
+      end
+    end
+
+    class Scraper
+      include CallableTree::Node::External
+
+      def initialize(type:)
+        @type = type
+      end
+
+      def match?(input, **options)
+        !input.get_elements("//#{@type}").empty?
+      end
+
+      def call(input, **options)
+        input
+          .get_elements("//#{@type}")
+          .first
+          .map { |element| [element['name'], element['emoji']] }
+          .to_h
+      end
+    end
+  end
+end
+
+tree = CallableTree::Node::Root.new.append(
+  Node::JSON::Parser.new.append(
+    Node::JSON::Scraper.new(type: :animals).verbosify,
+    Node::JSON::Scraper.new(type: :fruits).verbosify
+  ),
+  Node::XML::Parser.new.append(
+    Node::XML::Scraper.new(type: :animals).verbosify,
+    Node::XML::Scraper.new(type: :fruits).verbosify
+  )
+)
+
+Dir.glob(__dir__ + '/docs/*') do |file|
+  options = { foo: :bar }
+  puts tree.call(file, **options)
+  puts '---'
+end

data/examples/example3.rb

@@ -0,0 +1,122 @@
+require 'callable_tree'
+require 'json'
+require 'rexml/document'
+
+module Node
+  class Identity
+    attr_reader :klass, :type
+
+    def initialize(klass:, type:)
+      @klass = klass
+      @type = type
+    end
+
+    def to_s
+      "#{klass}(#{type})"
+    end
+  end
+
+  module JSON
+    class Parser
+      include CallableTree::Node::Internal
+
+      def match?(input, **options)
+        File.extname(input) == '.json'
+      end
+
+      def call(input, **options)
+        File.open(input) do |file|
+          json = ::JSON.load(file)
+          super(json, **options)
+        end
+      end
+
+      def terminate?(_output, **)
+        true
+      end
+    end
+
+    class Scraper
+      include CallableTree::Node::External
+
+      def initialize(type:)
+        @type = type
+      end
+
+      def identity
+        Identity.new(klass: super, type: @type)
+      end
+
+      def match?(input, **options)
+        !!input[@type.to_s]
+      end
+
+      def call(input, **options)
+        input[@type.to_s]
+          .map { |element| [element['name'], element['emoji']] }
+          .to_h
+      end
+    end
+  end
+
+  module XML
+    class Parser
+      include CallableTree::Node::Internal
+
+      def match?(input, **options)
+        File.extname(input) == '.xml'
+      end
+
+      def call(input, **options)
+        File.open(input) do |file|
+          super(REXML::Document.new(file), **options)
+        end
+      end
+
+      def terminate?(_output, **)
+        true
+      end
+    end
+
+    class Scraper
+      include CallableTree::Node::External
+
+      def initialize(type:)
+        @type = type
+      end
+
+      def identity
+        Identity.new(klass: super, type: @type)
+      end
+
+      def match?(input, **options)
+        !input.get_elements("//#{@type}").empty?
+      end
+
+      def call(input, **options)
+        input
+          .get_elements("//#{@type}")
+          .first
+          .map { |element| [element['name'], element['emoji']] }
+          .to_h
+      end
+    end
+  end
+end
+
+tree = CallableTree::Node::Root.new.append(
+  Node::JSON::Parser.new.append(
+    Node::JSON::Scraper.new(type: :animals).verbosify,
+    Node::JSON::Scraper.new(type: :fruits).verbosify
+  ),
+  Node::XML::Parser.new.append(
+    Node::XML::Scraper.new(type: :animals).verbosify,
+    Node::XML::Scraper.new(type: :fruits).verbosify
+  )
+)
+
+Dir.glob(__dir__ + '/docs/*') do |file|
+  options = { foo: :bar }
+  puts tree.call(file, **options)
+  puts '---'
+end

data/examples/example4.rb

@@ -0,0 +1,158 @@
+require 'callable_tree'
+require 'json'
+require 'rexml/document'
+
+module Node
+  module Logging
+    INDENT_SIZE = 2
+    BLANK = ' '.freeze
+
+    module Match
+      LIST_STYLE = '*'.freeze
+
+      def match?(_input, **)
+        super.tap do |matched|
+          prefix = LIST_STYLE.rjust(self.depth * INDENT_SIZE - INDENT_SIZE + LIST_STYLE.length, BLANK)
+          puts "#{prefix} #{self.identity}: [matched: #{matched}]"
+        end
+      end
+    end
+
+    module Call
+      INPUT_LABEL  = 'Input :'.freeze
+      OUTPUT_LABEL = 'Output:'.freeze
+
+      def call(input, **)
+        super.tap do |output|
+          input_prefix = INPUT_LABEL.rjust(self.depth * INDENT_SIZE + INPUT_LABEL.length, BLANK)
+          puts "#{input_prefix} #{input}"
+          output_prefix = OUTPUT_LABEL.rjust(self.depth * INDENT_SIZE + OUTPUT_LABEL.length, BLANK)
+          puts "#{output_prefix} #{output}"
+        end
+      end
+    end
+  end
+
+  class Identity
+    attr_reader :klass, :type
+
+    def initialize(klass:, type:)
+      @klass = klass
+      @type = type
+    end
+
+    def to_s
+      "#{klass}(#{type})"
+    end
+  end
+
+  module JSON
+    class Parser
+      include CallableTree::Node::Internal
+      prepend Logging::Match
+
+      def match?(input, **options)
+        File.extname(input) == '.json'
+      end
+
+      def call(input, **options)
+        File.open(input) do |file|
+          json = ::JSON.load(file)
+          super(json, **options)
+        end
+      end
+
+      def terminate?(_output, **)
+        true
+      end
+    end
+
+    class Scraper
+      include CallableTree::Node::External
+      prepend Logging::Match
+      prepend Logging::Call
+
+      def initialize(type:)
+        @type = type
+      end
+
+      def identity
+        Identity.new(klass: super, type: @type)
+      end
+
+      def match?(input, **options)
+        !!input[@type.to_s]
+      end
+
+      def call(input, **options)
+        input[@type.to_s]
+          .map { |element| [element['name'], element['emoji']] }
+          .to_h
+      end
+    end
+  end
+
+  module XML
+    class Parser
+      include CallableTree::Node::Internal
+      prepend Logging::Match
+
+      def match?(input, **options)
+        File.extname(input) == '.xml'
+      end
+
+      def call(input, **options)
+        File.open(input) do |file|
+          super(REXML::Document.new(file), **options)
+        end
+      end
+
+      def terminate?(_output, **)
+        true
+      end
+    end
+
+    class Scraper
+      include CallableTree::Node::External
+      prepend Logging::Match
+      prepend Logging::Call
+
+      def initialize(type:)
+        @type = type
+      end
+
+      def identity
+        Identity.new(klass: super, type: @type)
+      end
+
+      def match?(input, **options)
+        !input.get_elements("//#{@type}").empty?
+      end
+
+      def call(input, **options)
+        input
+          .get_elements("//#{@type}")
+          .first
+          .map { |element| [element['name'], element['emoji']] }
+          .to_h
+      end
+    end
+  end
+end
+
+tree = CallableTree::Node::Root.new.append(
+  Node::JSON::Parser.new.append(
+    Node::JSON::Scraper.new(type: :animals).verbosify,
+    Node::JSON::Scraper.new(type: :fruits).verbosify
+  ),
+  Node::XML::Parser.new.append(
+    Node::XML::Scraper.new(type: :animals).verbosify,
+    Node::XML::Scraper.new(type: :fruits).verbosify
+  )
+)
+
+Dir.glob(__dir__ + '/docs/*') do |file|
+  options = { foo: :bar }
+  puts tree.call(file, **options)
+  puts '---'
+end