callable_tree 0.3.8 → 0.3.9

data/examples/builder/external-verbosify.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require 'callable_tree'
+require 'json'
+require 'rexml/document'
+
+JSONParser =
+  CallableTree::Node::Internal::Builder
+  .new
+  .matcher do |input, **_options|
+    File.extname(input) == '.json'
+  end
+  .caller do |input, **options, &block|
+    File.open(input) do |file|
+      json = ::JSON.load(file)
+      # The following block call is equivalent to calling `super` in the class style.
+      block.call(json, **options)
+    end
+  end
+  .terminator { true }
+  .build
+
+XMLParser =
+  CallableTree::Node::Internal::Builder
+  .new
+  .matcher do |input, **_options|
+    File.extname(input) == '.xml'
+  end
+  .caller do |input, **options, &block|
+    File.open(input) do |file|
+      # The following block call is equivalent to calling `super` in the class style.
+      block.call(REXML::Document.new(file), **options)
+    end
+  end
+  .terminator { true }
+  .build
+
+def build_json_scraper(type)
+  CallableTree::Node::External::Builder
+    .new
+    .matcher do |input, **_options|
+      !input[type.to_s].nil?
+    end
+    .caller do |input, **_options|
+      input[type.to_s]
+        .to_h { |element| [element['name'], element['emoji']] }
+    end
+    .build
+end
+
+AnimalsJSONScraper = build_json_scraper(:animals)
+FruitsJSONScraper = build_json_scraper(:fruits)
+
+def build_xml_scraper(type)
+  CallableTree::Node::External::Builder
+    .new
+    .matcher do |input, **_options|
+      !input.get_elements("//#{type}").empty?
+    end
+    .caller do |input, **_options|
+      input
+        .get_elements("//#{type}")
+        .first
+        .to_h { |element| [element['name'], element['emoji']] }
+    end
+    .build
+end
+
+AnimalsXMLScraper = build_xml_scraper(:animals)
+FruitsXMLScraper = build_xml_scraper(:fruits)
+
+tree = CallableTree::Node::Root.new.seekable.append(
+  JSONParser.new.seekable.append(
+    AnimalsJSONScraper.new.verbosify,
+    FruitsJSONScraper.new.verbosify
+  ),
+  XMLParser.new.seekable.append(
+    AnimalsXMLScraper.new.verbosify,
+    FruitsXMLScraper.new.verbosify
+  )
+)
+
+Dir.glob("#{__dir__}/../docs/*") do |file|
+  options = { foo: :bar }
+  pp tree.call(file, **options)
+  puts '---'
+end

data/examples/builder/identity.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require 'callable_tree'
+require 'json'
+require 'rexml/document'
+
+JSONParser =
+  CallableTree::Node::Internal::Builder
+  .new
+  .matcher do |input, **_options|
+    File.extname(input) == '.json'
+  end
+  .caller do |input, **options, &block|
+    File.open(input) do |file|
+      json = ::JSON.load(file)
+      # The following block call is equivalent to calling `super` in the class style.
+      block.call(json, **options)
+    end
+  end
+  .terminator { true }
+  .identifier { |_node_:| _node_.object_id }
+  .build
+
+XMLParser =
+  CallableTree::Node::Internal::Builder
+  .new
+  .matcher do |input, **_options|
+    File.extname(input) == '.xml'
+  end
+  .caller do |input, **options, &block|
+    File.open(input) do |file|
+      # The following block call is equivalent to calling `super` in the class style.
+      block.call(REXML::Document.new(file), **options)
+    end
+  end
+  .terminator { true }
+  .identifier { |_node_:| _node_.object_id }
+  .build
+
+def build_json_scraper(type)
+  CallableTree::Node::External::Builder
+    .new
+    .matcher do |input, **_options|
+      !input[type.to_s].nil?
+    end
+    .caller do |input, **_options|
+      input[type.to_s]
+        .to_h { |element| [element['name'], element['emoji']] }
+    end
+    .identifier { |_node_:| _node_.object_id }
+    .build
+end
+
+AnimalsJSONScraper = build_json_scraper(:animals)
+FruitsJSONScraper = build_json_scraper(:fruits)
+
+def build_xml_scraper(type)
+  CallableTree::Node::External::Builder
+    .new
+    .matcher do |input, **_options|
+      !input.get_elements("//#{type}").empty?
+    end
+    .caller do |input, **_options|
+      input
+        .get_elements("//#{type}")
+        .first
+        .to_h { |element| [element['name'], element['emoji']] }
+    end
+    .identifier { |_node_:| _node_.object_id }
+    .build
+end
+
+AnimalsXMLScraper = build_xml_scraper(:animals)
+FruitsXMLScraper = build_xml_scraper(:fruits)
+
+tree = CallableTree::Node::Root.new.seekable.append(
+  JSONParser.new.seekable.append(
+    AnimalsJSONScraper.new.verbosify,
+    FruitsJSONScraper.new.verbosify
+  ),
+  XMLParser.new.seekable.append(
+    AnimalsXMLScraper.new.verbosify,
+    FruitsXMLScraper.new.verbosify
+  )
+)
+
+Dir.glob("#{__dir__}/../docs/*") do |file|
+  options = { foo: :bar }
+  pp tree.call(file, **options)
+  puts '---'
+end

data/examples/builder/internal-broadcastable.rb

@@ -2,57 +2,57 @@
 
 require 'callable_tree'
 
-less_than = proc do |num|
+def less_than(num)
   # The following block call is equivalent to calling `super` in the class style.
-  proc { |input, &block| block.call(input) && input < num }
+  proc { |input, &original| original.call(input) && input < num }
 end
 
 LessThan5 =
   CallableTree::Node::Internal::Builder
   .new
-  .matcher(&less_than.call(5))
+  .matcher(&method(:less_than).call(5))
   .build
 
 LessThan10 =
   CallableTree::Node::Internal::Builder
   .new
-  .matcher(&less_than.call(10))
+  .matcher(&method(:less_than).call(10))
   .build
 
-add = proc do |num|
+def add(num)
   proc { |input| input + num }
 end
 
 Add1 =
   CallableTree::Node::External::Builder
   .new
-  .caller(&add.call(1))
+  .caller(&method(:add).call(1))
   .build
 
-subtract = proc do |num|
+def subtract(num)
   proc { |input| input - num }
 end
 
 Subtract1 =
   CallableTree::Node::External::Builder
   .new
-  .caller(&subtract.call(1))
+  .caller(&method(:subtract).call(1))
   .build
 
-multiply = proc do |num|
+def multiply(num)
   proc { |input| input * num }
 end
 
 Multiply2 =
   CallableTree::Node::External::Builder
   .new
-  .caller(&multiply.call(2))
+  .caller(&method(:multiply).call(2))
   .build
 
 Multiply3 =
   CallableTree::Node::External::Builder
   .new
-  .caller(&multiply.call(3))
+  .caller(&method(:multiply).call(3))
   .build
 
 tree = CallableTree::Node::Root.new.broadcastable.append(

data/examples/builder/internal-composable.rb

@@ -2,57 +2,57 @@
 
 require 'callable_tree'
 
-less_than = proc do |num|
+def less_than(num)
   # The following block call is equivalent to calling `super` in the class style.
-  proc { |input, &block| block.call(input) && input < num }
+  proc { |input, &original| original.call(input) && input < num }
 end
 
 LessThan5 =
   CallableTree::Node::Internal::Builder
   .new
-  .matcher(&less_than.call(5))
+  .matcher(&method(:less_than).call(5))
   .build
 
 LessThan10 =
   CallableTree::Node::Internal::Builder
   .new
-  .matcher(&less_than.call(10))
+  .matcher(&method(:less_than).call(10))
   .build
 
-add = proc do |num|
+def add(num)
   proc { |input| input + num }
 end
 
 Add1 =
   CallableTree::Node::External::Builder
   .new
-  .caller(&add.call(1))
+  .caller(&method(:add).call(1))
   .build
 
-subtract = proc do |num|
+def subtract(num)
   proc { |input| input - num }
 end
 
 Subtract1 =
   CallableTree::Node::External::Builder
   .new
-  .caller(&subtract.call(1))
+  .caller(&method(:subtract).call(1))
   .build
 
-multiply = proc do |num|
+def multiply(num)
   proc { |input| input * num }
 end
 
 Multiply2 =
   CallableTree::Node::External::Builder
   .new
-  .caller(&multiply.call(2))
+  .caller(&method(:multiply).call(2))
   .build
 
 Multiply3 =
   CallableTree::Node::External::Builder
   .new
-  .caller(&multiply.call(3))
+  .caller(&method(:multiply).call(3))
   .build
 
 tree = CallableTree::Node::Root.new.composable.append(

data/examples/builder/internal-seekable.rb

@@ -10,16 +10,14 @@ JSONParser =
   .matcher do |input, **_options|
     File.extname(input) == '.json'
   end
-  .caller do |input, **options, &block|
+  .caller do |input, **options, &original|
     File.open(input) do |file|
       json = ::JSON.load(file)
       # The following block call is equivalent to calling `super` in the class style.
-      block.call(json, **options)
+      original.call(json, **options)
     end
   end
-  .terminator do
-    true
-  end
+  .terminator { true }
   .build
 
 XMLParser =
@@ -28,27 +26,24 @@ XMLParser =
   .matcher do |input, **_options|
     File.extname(input) == '.xml'
   end
-  .caller do |input, **options, &block|
+  .caller do |input, **options, &original|
     File.open(input) do |file|
       # The following block call is equivalent to calling `super` in the class style.
-      block.call(REXML::Document.new(file), **options)
+      original.call(REXML::Document.new(file), **options)
     end
   end
-  .terminator do
-    true
-  end
+  .terminator { true }
   .build
 
 def build_json_scraper(type)
   CallableTree::Node::External::Builder
     .new
     .matcher do |input, **_options|
-      !!input[type.to_s]
+      !input[type.to_s].nil?
     end
     .caller do |input, **_options|
       input[type.to_s]
-        .map { |element| [element['name'], element['emoji']] }
-        .to_h
+        .to_h { |element| [element['name'], element['emoji']] }
     end
     .build
 end
@@ -66,8 +61,7 @@ def build_xml_scraper(type)
       input
         .get_elements("//#{type}")
         .first
-        .map { |element| [element['name'], element['emoji']] }
-        .to_h
+        .to_h { |element| [element['name'], element['emoji']] }
     end
     .build
 end

data/examples/builder/logging.rb

@@ -10,15 +10,14 @@ JSONParser =
   .matcher do |input, **_options|
     File.extname(input) == '.json'
   end
-  .caller do |input, **options, &block|
+  .caller do |input, **options, &original|
     File.open(input) do |file|
       json = ::JSON.load(file)
       # The following block call is equivalent to calling `super` in the class style.
-      block.call(json, **options)
+      original.call(json, **options)
     end
   end
   .terminator { true }
-  # .identifier { |_node_:| :as_you_like } # optional
   .hookable
   .build
 
@@ -28,14 +27,13 @@ XMLParser =
   .matcher do |input, **_options|
     File.extname(input) == '.xml'
   end
-  .caller do |input, **options, &block|
+  .caller do |input, **options, &original|
     File.open(input) do |file|
       # The following block call is equivalent to calling `super` in the class style.
-      block.call(REXML::Document.new(file), **options)
+      original.call(REXML::Document.new(file), **options)
     end
   end
   .terminator { true }
-  # .identifier { |_node_:| :as_you_like } # optional
   .hookable
   .build
 
@@ -43,14 +41,12 @@ def build_json_scraper(type)
   CallableTree::Node::External::Builder
     .new
     .matcher do |input, **_options|
-      !!input[type.to_s]
+      !input[type.to_s].nil?
     end
     .caller do |input, **_options|
       input[type.to_s]
-        .map { |element| [element['name'], element['emoji']] }
-        .to_h
+        .to_h { |element| [element['name'], element['emoji']] }
     end
-    # .identifier { |_node_:| :as_you_like } # optional
     .hookable
     .build
 end
@@ -68,10 +64,8 @@ def build_xml_scraper(type)
       input
         .get_elements("//#{type}")
         .first
-        .map { |element| [element['name'], element['emoji']] }
-        .to_h
+        .to_h { |element| [element['name'], element['emoji']] }
     end
-    # .identifier { |_node_:| :as_you_like } # optional
     .hookable
     .build
 end

data/examples/class/external-verbosify.rb

@@ -38,8 +38,7 @@ module Node
 
       def call(input, **_options)
         input[@type.to_s]
-          .map { |element| [element['name'], element['emoji']] }
-          .to_h
+          .to_h { |element| [element['name'], element['emoji']] }
       end
     end
   end
@@ -78,8 +77,7 @@ module Node
         input
           .get_elements("//#{@type}")
           .first
-          .map { |element| [element['name'], element['emoji']] }
-          .to_h
+          .to_h { |element| [element['name'], element['emoji']] }
       end
     end
   end

data/examples/class/identity.rb

@@ -55,8 +55,7 @@ module Node
 
       def call(input, **_options)
         input[@type.to_s]
-          .map { |element| [element['name'], element['emoji']] }
-          .to_h
+          .to_h { |element| [element['name'], element['emoji']] }
       end
     end
   end
@@ -99,8 +98,7 @@ module Node
         input
           .get_elements("//#{@type}")
           .first
-          .map { |element| [element['name'], element['emoji']] }
-          .to_h
+          .to_h { |element| [element['name'], element['emoji']] }
       end
     end
   end

data/examples/class/internal-seekable.rb

@@ -38,8 +38,7 @@ module Node
 
       def call(input, **_options)
         input[@type.to_s]
-          .map { |element| [element['name'], element['emoji']] }
-          .to_h
+          .to_h { |element| [element['name'], element['emoji']] }
       end
     end
   end
@@ -78,8 +77,7 @@ module Node
         input
           .get_elements("//#{@type}")
           .first
-          .map { |element| [element['name'], element['emoji']] }
-          .to_h
+          .to_h { |element| [element['name'], element['emoji']] }
       end
     end
   end

data/examples/class/logging.rb

@@ -58,8 +58,7 @@ module Node
 
       def call(input, **_options)
         input[@type.to_s]
-          .map { |element| [element['name'], element['emoji']] }
-          .to_h
+          .to_h { |element| [element['name'], element['emoji']] }
       end
     end
   end
@@ -105,8 +104,7 @@ module Node
         input
           .get_elements("//#{@type}")
           .first
-          .map { |element| [element['name'], element['emoji']] }
-          .to_h
+          .to_h { |element| [element['name'], element['emoji']] }
       end
     end
   end

data/lib/callable_tree/node/internal/strategy/broadcast.rb

@@ -7,9 +7,26 @@ module CallableTree
         class Broadcast
           include Strategy
 
+          def initialize(terminable: false)
+            self.terminable = terminable
+            @terminator =
+              if terminable
+                proc { |node, output, *inputs, **options| node.terminate?(output, *inputs, **options) }
+              else
+                proc { false }
+              end
+          end
+
           def call(nodes, *inputs, **options)
-            nodes.map do |node|
-              node.call(*inputs, **options) if node.match?(*inputs, **options)
+            nodes.reduce([]) do |outputs, node|
+              output = (node.call(*inputs, **options) if node.match?(*inputs, **options))
+              outputs << output
+
+              if @terminator.call(node, output, *inputs, **options)
+                break outputs
+              else
+                outputs
+              end
             end
           end
         end

data/lib/callable_tree/node/internal/strategy/compose.rb

@@ -7,12 +7,24 @@ module CallableTree
         class Compose
           include Strategy
 
+          def initialize(terminable: false)
+            self.terminable = terminable
+            @terminator =
+              if terminable
+                proc { |node, output, *inputs, **options| node.terminate?(output, *inputs, **options) }
+              else
+                proc { false }
+              end
+          end
+
           def call(nodes, *inputs, **options)
             head, *tail = inputs
             nodes.reduce(head) do |input, node|
-              inputs = [input, *tail]
-              if node.match?(*inputs, **options)
-                node.call(*inputs, **options)
+              if node.match?(input, *tail, **options)
+                output = node.call(input, *tail, **options)
+                break output if @terminator.call(node, output, input, *tail, **options)
+
+                output
               else
                 input
               end

data/lib/callable_tree/node/internal/strategy/seek.rb

@@ -7,13 +7,23 @@ module CallableTree
         class Seek
           include Strategy
 
+          def initialize(terminable: true)
+            self.terminable = terminable
+            @terminator =
+              if terminable
+                proc { |node, output, *inputs, **options| node.terminate?(output, *inputs, **options) }
+              else
+                proc { false }
+              end
+          end
+
           def call(nodes, *inputs, **options)
             nodes
               .lazy
               .select { |node| node.match?(*inputs, **options) }
               .map do |node|
                 output = node.call(*inputs, **options)
-                terminated = node.terminate?(output, *inputs, **options)
+                terminated = @terminator.call(node, output, *inputs, **options)
                 [output, terminated]
               end
               .select { |_output, terminated| terminated }

data/lib/callable_tree/node/internal/strategy.rb

@@ -13,7 +13,7 @@ module CallableTree
         end
 
         def ==(other)
-          name == other.name
+          name == other.name && terminable? == other.terminable?
         end
 
         def eql?(other)
@@ -21,8 +21,16 @@ module CallableTree
         end
 
         def hash
-          self.class.name.hash
+          [self.class.name, terminable].join('-').hash
         end
+
+        def terminable?
+          terminable
+        end
+
+        private
+
+        attr_accessor :terminable
       end
     end
   end