callable_tree 0.3.7 → 0.3.9

data/examples/{identity.rb → 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
@@ -117,7 +115,7 @@ tree = CallableTree::Node::Root.new.append(
   )
 )
 
-Dir.glob("#{__dir__}/docs/*") do |file|
+Dir.glob("#{__dir__}/../docs/*") do |file|
   options = { foo: :bar }
   pp tree.call(file, **options)
   puts '---'

data/examples/{internal-seekable.rb → 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
@@ -96,7 +94,7 @@ tree = CallableTree::Node::Root.new.seekable.append(
   )
 )
 
-Dir.glob("#{__dir__}/docs/*") do |file|
+Dir.glob("#{__dir__}/../docs/*") do |file|
   options = { foo: :bar }
   pp tree.call(file, **options)
   puts '---'

data/examples/{logging.rb → class/logging.rb}

@@ -5,36 +5,6 @@ require 'json'
 require 'rexml/document'
 
 module Node
-  module Logging
-    INDENT_SIZE = 2
-    BLANK = ' '
-
-    module Match
-      LIST_STYLE = '*'
-
-      def match?(_input, **_options)
-        super.tap do |matched|
-          prefix = LIST_STYLE.rjust(depth * INDENT_SIZE - INDENT_SIZE + LIST_STYLE.length, BLANK)
-          puts "#{prefix} #{identity}: [matched: #{matched}]"
-        end
-      end
-    end
-
-    module Call
-      INPUT_LABEL  = 'Input :'
-      OUTPUT_LABEL = 'Output:'
-
-      def call(input, **_options)
-        super.tap do |output|
-          input_prefix = INPUT_LABEL.rjust(depth * INDENT_SIZE + INPUT_LABEL.length, BLANK)
-          puts "#{input_prefix} #{input}"
-          output_prefix = OUTPUT_LABEL.rjust(depth * INDENT_SIZE + OUTPUT_LABEL.length, BLANK)
-          puts "#{output_prefix} #{output}"
-        end
-      end
-    end
-  end
-
   class Identity
     attr_reader :klass, :type
 
@@ -51,7 +21,7 @@ module Node
   module JSON
     class Parser
       include CallableTree::Node::Internal
-      prepend Logging::Match
+      prepend CallableTree::Node::Hooks::Matcher
 
       def match?(input, **_options)
         File.extname(input) == '.json'
@@ -71,8 +41,8 @@ module Node
 
     class Scraper
       include CallableTree::Node::External
-      prepend Logging::Match
-      prepend Logging::Call
+      prepend CallableTree::Node::Hooks::Matcher
+      prepend CallableTree::Node::Hooks::Caller
 
       def initialize(type:)
         @type = type
@@ -88,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
@@ -97,7 +66,7 @@ module Node
   module XML
     class Parser
       include CallableTree::Node::Internal
-      prepend Logging::Match
+      prepend CallableTree::Node::Hooks::Matcher
 
       def match?(input, **_options)
         File.extname(input) == '.xml'
@@ -116,8 +85,8 @@ module Node
 
     class Scraper
       include CallableTree::Node::External
-      prepend Logging::Match
-      prepend Logging::Call
+      prepend CallableTree::Node::Hooks::Matcher
+      prepend CallableTree::Node::Hooks::Caller
 
       def initialize(type:)
         @type = type
@@ -135,25 +104,56 @@ 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
 end
 
+module Logging
+  INDENT_SIZE = 2
+  BLANK = ' '
+  LIST_STYLE = '*'
+  INPUT_LABEL  = 'Input :'
+  OUTPUT_LABEL = 'Output:'
+
+  def self.loggable(node)
+    node.after_matcher! do |matched, _node_:, **|
+      prefix = LIST_STYLE.rjust((_node_.depth * INDENT_SIZE) - INDENT_SIZE + LIST_STYLE.length, BLANK)
+      puts "#{prefix} #{_node_.identity}: [matched: #{matched}]"
+      matched
+    end
+
+    if node.external?
+      node
+        .before_caller! do |input, *, _node_:, **|
+          input_prefix = INPUT_LABEL.rjust((_node_.depth * INDENT_SIZE) + INPUT_LABEL.length, BLANK)
+          puts "#{input_prefix} #{input}"
+          input
+        end
+        .after_caller! do |output, _node_:, **|
+          output_prefix = OUTPUT_LABEL.rjust((_node_.depth * INDENT_SIZE) + OUTPUT_LABEL.length, BLANK)
+          puts "#{output_prefix} #{output}"
+          output
+        end
+    end
+  end
+end
+
+loggable = Logging.method(:loggable)
+
 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::JSON::Parser.new.tap(&loggable).append(
+    Node::JSON::Scraper.new(type: :animals).tap(&loggable).verbosify,
+    Node::JSON::Scraper.new(type: :fruits).tap(&loggable).verbosify
   ),
-  Node::XML::Parser.new.append(
-    Node::XML::Scraper.new(type: :animals).verbosify,
-    Node::XML::Scraper.new(type: :fruits).verbosify
+  Node::XML::Parser.new.tap(&loggable).append(
+    Node::XML::Scraper.new(type: :animals).tap(&loggable).verbosify,
+    Node::XML::Scraper.new(type: :fruits).tap(&loggable).verbosify
   )
 )
 
-Dir.glob("#{__dir__}/docs/*") do |file|
+Dir.glob("#{__dir__}/../docs/*") do |file|
   options = { foo: :bar }
   pp tree.call(file, **options)
   puts '---'

data/lib/callable_tree/node/builder.rb

@@ -24,6 +24,11 @@ module CallableTree
         self
       end
 
+      def identifier(&block)
+        @identifier = block
+        self
+      end
+
       def hookable(hookable = true)
         @hookable = hookable
         self
@@ -33,6 +38,7 @@ module CallableTree
         matcher = @matcher
         caller = @caller
         terminator = @terminator
+        identifier = @identifier
         hookable = @hookable
 
         validate(
@@ -47,6 +53,7 @@ module CallableTree
             if hookable
               prepend Hooks::Matcher
               prepend Hooks::Caller
+              prepend Hooks::Terminator
             end
 
             if matcher
@@ -72,6 +79,12 @@ module CallableTree
                 end
               end
             end
+
+            if identifier
+              define_method(:identity) do
+                identifier.call(_node_: self) { super() }
+              end
+            end
           end
       end
 

data/lib/callable_tree/node/hooks/terminator.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module CallableTree
+  module Node
+    module Hooks
+      module Terminator
+        def self.included(_subclass)
+          raise ::CallableTree::Error, "#{self} must be prepended"
+        end
+
+        def before_terminator(&block)
+          clone.before_terminator!(&block)
+        end
+
+        def before_terminator!(&block)
+          before_terminator_callbacks << block
+          self
+        end
+
+        def around_terminator(&block)
+          clone.around_terminator!(&block)
+        end
+
+        def around_terminator!(&block)
+          around_terminator_callbacks << block
+          self
+        end
+
+        def after_terminator(&block)
+          clone.after_terminator!(&block)
+        end
+
+        def after_terminator!(&block)
+          after_terminator_callbacks << block
+          self
+        end
+
+        def terminate?(output, *inputs, **options)
+          output = before_terminator_callbacks.reduce(output) do |output, callable|
+            callable.call(output, *inputs, **options, _node_: self)
+          end
+
+          terminated =
+            if around_terminator_callbacks.empty?
+              super(output, *inputs, **options)
+            else
+              around_terminator_callbacks_head, *around_terminator_callbacks_tail = around_terminator_callbacks
+              terminator = proc { super(output, *inputs, **options) }
+
+              terminated =
+                around_terminator_callbacks_head
+                .call(
+                  output,
+                  *inputs,
+                  **options,
+                  _node_: self
+                ) { terminator.call }
+
+              around_terminator_callbacks_tail.reduce(terminated) do |terminated, callable|
+                callable.call(
+                  output,
+                  *inputs,
+                  **options,
+                  _node_: self
+                ) { terminated }
+              end
+            end
+
+          after_terminator_callbacks.reduce(terminated) do |terminated, callable|
+            callable.call(terminated, **options, _node_: self)
+          end
+        end
+
+        def before_terminator_callbacks
+          @before_terminator_callbacks ||= []
+        end
+
+        def around_terminator_callbacks
+          @around_terminator_callbacks ||= []
+        end
+
+        def after_terminator_callbacks
+          @after_terminator_callbacks ||= []
+        end
+
+        private
+
+        attr_writer :before_terminator_callbacks, :around_terminator_callbacks, :after_terminator_callbacks
+
+        def initialize_copy(_node)
+          super
+          self.before_terminator_callbacks = before_terminator_callbacks.map(&:itself)
+          self.around_terminator_callbacks = around_terminator_callbacks.map(&:itself)
+          self.after_terminator_callbacks = after_terminator_callbacks.map(&:itself)
+        end
+      end
+    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

data/lib/callable_tree/node/internal.rb

@@ -42,7 +42,7 @@ module CallableTree
         if recursive
           child_nodes
             .lazy
-            .select { |node| node.internal? }
+            .select(&:internal?)
             .map { |node| node.find(recursive: true, &block) }
             .reject(&:nil?)
             .first
@@ -89,20 +89,18 @@ module CallableTree
         strategy.is_a?(Strategy::Seek)
       end
 
-      def seek
-        if seek?
+      def seek(terminable: true)
+        if strategy == Strategy::Seek.new(terminable: terminable)
           self
         else
-          clone.tap do |node|
-            node.strategy = Strategy::Seek.new
-          end
+          clone.seek!(terminable: terminable)
         end
       end
 
-      def seek!
-        tap do |node|
-          node.strategy = Strategy::Seek.new unless seek?
-        end
+      def seek!(terminable: true)
+        self.strategy = Strategy::Seek.new(terminable: terminable)
+
+        self
       end
 
       alias seekable? seek?
@@ -113,20 +111,18 @@ module CallableTree
         strategy.is_a?(Strategy::Broadcast)
       end
 
-      def broadcast
-        if broadcast?
+      def broadcast(terminable: false)
+        if strategy == Strategy::Broadcast.new(terminable: terminable)
           self
         else
-          clone.tap do |node|
-            node.strategy = Strategy::Broadcast.new
-          end
+          clone.broadcast!(terminable: terminable)
         end
       end
 
-      def broadcast!
-        tap do |node|
-          node.strategy = Strategy::Broadcast.new unless broadcast?
-        end
+      def broadcast!(terminable: false)
+        self.strategy = Strategy::Broadcast.new(terminable: terminable)
+
+        self
       end
 
       alias broadcastable? broadcast?
@@ -137,20 +133,18 @@ module CallableTree
         strategy.is_a?(Strategy::Compose)
       end
 
-      def compose
-        if compose?
+      def compose(terminable: false)
+        if strategy == Strategy::Compose.new(terminable: terminable)
           self
         else
-          clone.tap do |node|
-            node.strategy = Strategy::Compose.new
-          end
+          clone.compose!(terminable: terminable)
         end
       end
 
-      def compose!
-        tap do |node|
-          node.strategy = Strategy::Compose.new unless compose?
-        end
+      def compose!(terminable: false)
+        self.strategy = Strategy::Compose.new(terminable: terminable)
+
+        self
       end
 
       alias composable? compose?

data/lib/callable_tree/node/root.rb

@@ -6,6 +6,7 @@ module CallableTree
       include Internal
       prepend Hooks::Matcher
       prepend Hooks::Caller
+      prepend Hooks::Terminator
 
       def self.inherited(subclass)
         raise ::CallableTree::Error, "#{subclass} cannot inherit #{self}"

data/lib/callable_tree/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CallableTree
-  VERSION = '0.3.7'
+  VERSION = '0.3.9'
 end

data/lib/callable_tree.rb

@@ -9,6 +9,7 @@ require_relative 'callable_tree/version'
 require_relative 'callable_tree/node'
 require_relative 'callable_tree/node/hooks/matcher'
 require_relative 'callable_tree/node/hooks/caller'
+require_relative 'callable_tree/node/hooks/terminator'
 require_relative 'callable_tree/node/internal/strategy'
 require_relative 'callable_tree/node/internal/strategy/broadcast'
 require_relative 'callable_tree/node/internal/strategy/seek'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: callable_tree
 version: !ruby/object:Gem::Version
-  version: 0.3.7
+  version: 0.3.9
 platform: ruby
 authors:
 - jsmmr
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-04-09 00:00:00.000000000 Z
+date: 2022-11-06 00:00:00.000000000 Z
 dependencies: []
 description: Builds a tree by linking callable nodes. The nodes that match the conditions
   are called in a chain from the root node to the leaf node. These are like nested
@@ -19,10 +19,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
 - ".github/workflows/build.yml"
 - ".github/workflows/codeql-analysis.yml"
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - ".ruby-version"
 - CHANGELOG.md
 - Gemfile
@@ -33,22 +35,24 @@ files:
 - bin/console
 - bin/setup
 - callable_tree.gemspec
-- examples/builder/hooks-caller.rb
+- examples/builder/external-verbosify.rb
+- examples/builder/hooks.rb
+- examples/builder/identity.rb
 - examples/builder/internal-broadcastable.rb
 - examples/builder/internal-composable.rb
 - examples/builder/internal-seekable.rb
 - examples/builder/logging.rb
+- examples/class/external-verbosify.rb
+- examples/class/hooks.rb
+- examples/class/identity.rb
+- examples/class/internal-broadcastable.rb
+- examples/class/internal-composable.rb
+- examples/class/internal-seekable.rb
+- examples/class/logging.rb
 - examples/docs/animals.json
 - examples/docs/animals.xml
 - examples/docs/fruits.json
 - examples/docs/fruits.xml
-- examples/external-verbosify.rb
-- examples/hooks-caller.rb
-- examples/identity.rb
-- examples/internal-broadcastable.rb
-- examples/internal-composable.rb
-- examples/internal-seekable.rb
-- examples/logging.rb
 - lib/callable_tree.rb
 - lib/callable_tree/node.rb
 - lib/callable_tree/node/builder.rb
@@ -57,6 +61,7 @@ files:
 - lib/callable_tree/node/external/verbose.rb
 - lib/callable_tree/node/hooks/caller.rb
 - lib/callable_tree/node/hooks/matcher.rb
+- lib/callable_tree/node/hooks/terminator.rb
 - lib/callable_tree/node/internal.rb
 - lib/callable_tree/node/internal/builder.rb
 - lib/callable_tree/node/internal/strategy.rb
@@ -71,7 +76,8 @@ licenses:
 metadata:
   homepage_uri: https://github.com/jsmmr/ruby_callable_tree
   source_code_uri: https://github.com/jsmmr/ruby_callable_tree
-  changelog_uri: https://github.com/jsmmr/ruby_callable_tree/blob/v0.3.7/CHANGELOG.md
+  changelog_uri: https://github.com/jsmmr/ruby_callable_tree/blob/v0.3.9/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths: