callable_tree 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9213a2a82a38c85e401f291bf2d37e60210bf167c765576033eed93fb1d7cbbd
-  data.tar.gz: 4a3f2fce73c82b8e5b7e537d21eeedc500e84dbe9f3c972c596701b654a9f234
+  metadata.gz: d7daab378247c364839a830fd43b028fd0933cef6026a1df1a614fb4a59c7a66
+  data.tar.gz: 66ac7c3de2198ef3acd80bddadeccc0f3ccd34e5a3d3de7d959bd43fb0801436
 SHA512:
-  metadata.gz: 72ccbffb1ffe2e66ddf41b2f29c715c9cda1d6a91dc8ee5ef493bcaa531b2c1c99ee9024b1776a8c9ecad6e82b84b051d0121c55e9abc26a1ba3d4bb449dced2
-  data.tar.gz: 243f05208c10de0a60af884479f8a2a9d3edc5735b16fece2994b694d0734bf75f57f1dfc57afc8c265df038fe736fd86e063042362d495140410819f47bbc70
+  metadata.gz: 7b15c987aeeab91a5250f48e6d429d4176478f74dc7866a0209b0cf7f82909f58fa8f96dbae30c5d37151e63f8dab6c1e8028b2faf15b3919d9afe9ed43eb4fd
+  data.tar.gz: eb1017e10c4f94635058523979c2aeea5edd7d6899a932f2481ae72bd93b74657cd73dc2c1a12935b069e34910f9dba260ef8b62cb70e8a4f4b6dc73915ba0e5

data/.github/workflows/build.yml

@@ -5,13 +5,13 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby: ['2.4', '2.5', '2.6', '2.7', '3.0']
+        ruby: ['2.4', '2.5', '2.6', '2.7', '3.0', '3.1']
     steps:
       - uses: actions/checkout@v2
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
-      - run: gem install bundler:2.2.4
+      - run: gem install bundler:2.3.3
       - uses: actions/cache@v2
         with:
           path: vendor/bundle

data/.github/workflows/codeql-analysis.yml

@@ -0,0 +1,70 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ main, develop ]
+  schedule:
+    - cron: '35 15 * * 0'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'ruby' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1

data/.ruby-version

@@ -1 +1 @@
-3.0.0
+3.1.0

data/CHANGELOG.md

@@ -1,6 +1,34 @@
 ## [Unreleased]
 
+## [0.3.0] - 2021-12-27
+
+- Change `CallableTree::Node#match?` to accept inputs to the node as variable length arguments.
+- Change `CallableTree::Node#call` to accept inputs to the node as variable length arguments.
+- Change `CallableTree::Node#terminate?` to accept inputs to the node as variable length arguments, after the `output` argument.
+- Add `CallableTree::Node::Internal#[]` to return the child node using `index`.
+- Change `CallableTree::Node::Internal#children` to return a new array including child nodes of the node.
+- Add `CallableTree::Node::Internal#children!` to return destructively changeable array including child nodes of the node.
+
+## [0.2.3] - 2021-11-07
+
+- Add `CallableTree::Node::Internal#shake` to recursively execute `CallableTree::Node::Internal#reject`, including child nodes. The child nodes that are empty because their children have been rejected will also be rejected.
+- Add `CallableTree::Node::Internal#shake!` that make destructive change.
+- Add `CallableTree::Node#outline` that may be useful for writing the specs.
+
+## [0.2.2] - 2021-10-24
+
+- Add `CallableTree::Node::Internal#reject` to return a new node instance without rejected child nodes.
+- Add `CallableTree::Node::Internal#reject!` to destructively reject child nodes.
+
+## [0.2.1] - 2021-07-24
+
+- Add `CallableTree::Node#root?`.
+- Add `CallableTree::Node::Internal#seek!` that make destructive change.
+- Add `CallableTree::Node::Internal#broadcast!` that make destructive change.
+- Add `CallableTree::Node::Internal#compose!` that make destructive change.
+
 ## [0.2.0] - 2021-06-15
+
 - Change `CallableTree::Node::Internal#append` to return a new instance.
   To keep the same behavior as the older version, use `CallableTree::Node::External#append!` that make destructive change.
 - Remove `CallableTree::Node::Internal#<<`. Use `CallableTree::Node::External#append!` instead.
@@ -8,6 +36,7 @@
   To keep the same behavior as the older version, use `CallableTree::Node::External#verbosify!` that make destructive change.
 
 ## [0.1.3] - 2021-06-12
+
 - Minor improvements
 
 ## [0.1.2] - 2021-05-29

data/Gemfile.lock

@@ -1,13 +1,13 @@
 PATH
   remote: .
   specs:
-    callable_tree (0.2.0)
+    callable_tree (0.3.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    diff-lcs (1.4.4)
-    rake (13.0.3)
+    diff-lcs (1.5.0)
+    rake (13.0.6)
     rspec (3.10.0)
       rspec-core (~> 3.10.0)
       rspec-expectations (~> 3.10.0)
@@ -20,7 +20,7 @@ GEM
     rspec-mocks (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.10.0)
-    rspec-support (3.10.2)
+    rspec-support (3.10.3)
 
 PLATFORMS
   x86_64-darwin-19
@@ -32,4 +32,4 @@ DEPENDENCIES
   rspec (~> 3.0)
 
 BUNDLED WITH
-   2.2.17
+   2.3.3

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2021 　
+Copyright (c) 2021 jsmmr
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,5 +1,7 @@
 # CallableTree
 
+[![build](https://github.com/jsmmr/ruby_callable_tree/actions/workflows/build.yml/badge.svg)](https://github.com/jsmmr/ruby_callable_tree/actions/workflows/build.yml)
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -40,11 +42,11 @@ module Node
     class Parser
       include CallableTree::Node::Internal
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.json'
       end
 
-      # If there is need to convert the input value for
+      # If there is need to convert the input values for
       # child nodes, override the `call` method.
       def call(input, **options)
         File.open(input) do |file|
@@ -56,7 +58,7 @@ module Node
       # If a returned value of the `call` method is `nil`,
       # but there is no need to call the sibling nodes,
       # override the `terminate?` method to return `true`.
-      def terminate?(output, **options)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -68,11 +70,11 @@ module Node
         @type = type
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !!input[@type.to_s]
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input[@type.to_s]
           .map { |element| [element['name'], element['emoji']] }
           .to_h
@@ -84,11 +86,11 @@ module Node
     class Parser
       include CallableTree::Node::Internal
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.xml'
       end
 
-      # If there is need to convert the input value for
+      # If there is need to convert the input values for
       # child nodes, override the `call` method.
       def call(input, **options)
         File.open(input) do |file|
@@ -99,7 +101,7 @@ module Node
       # If a returned value of the `call` method is `nil`,
       # but there is no need to call the sibling nodes,
       # override the `terminate?` method to return `true`.
-      def terminate?(output, **options)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -111,11 +113,11 @@ module Node
         @type = type
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !input.get_elements("//#{@type}").empty?
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input
           .get_elements("//#{@type}")
           .first
@@ -138,7 +140,7 @@ tree = CallableTree::Node::Root.new.append(
   )#.seek
 )#.seek
 
-Dir.glob(__dir__ + '/docs/*') do |file|
+Dir.glob("#{__dir__}/docs/*") do |file|
   options = { foo: :bar }
   pp tree.call(file, **options)
   puts '---'
@@ -180,12 +182,12 @@ end
 
 tree = CallableTree::Node::Root.new.append(
   Node::LessThan.new(5).append(
-    lambda { |input, **| input * 2 }, # anonymous external node
-    lambda { |input, **| input + 1 }  # anonymous external node
+    ->(input) { input * 2 }, # anonymous external node
+    ->(input) { input + 1 }  # anonymous external node
   ).broadcast,
   Node::LessThan.new(10).append(
-    lambda { |input, **| input * 3 }, # anonymous external node
-    lambda { |input, **| input - 1 }  # anonymous external node
+    ->(input) { input * 3 }, # anonymous external node
+    ->(input) { input - 1 }  # anonymous external node
   ).broadcast
 ).broadcast
 
@@ -432,28 +434,28 @@ This is an example of logging.
 module Node
   module Logging
     INDENT_SIZE = 2
-    BLANK = ' '.freeze
+    BLANK = ' '
 
     module Match
-      LIST_STYLE = '*'.freeze
+      LIST_STYLE = '*'
 
-      def match?(_input, **)
+      def match?(_input, **_options)
         super.tap do |matched|
-          prefix = LIST_STYLE.rjust(self.depth * INDENT_SIZE - INDENT_SIZE + LIST_STYLE.length, BLANK)
-          puts "#{prefix} #{self.identity}: [matched: #{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 :'.freeze
-      OUTPUT_LABEL = 'Output:'.freeze
+      INPUT_LABEL  = 'Input :'
+      OUTPUT_LABEL = 'Output:'
 
-      def call(input, **)
+      def call(input, **_options)
         super.tap do |output|
-          input_prefix = INPUT_LABEL.rjust(self.depth * INDENT_SIZE + INPUT_LABEL.length, BLANK)
+          input_prefix = INPUT_LABEL.rjust(depth * INDENT_SIZE + INPUT_LABEL.length, BLANK)
           puts "#{input_prefix} #{input}"
-          output_prefix = OUTPUT_LABEL.rjust(self.depth * INDENT_SIZE + OUTPUT_LABEL.length, BLANK)
+          output_prefix = OUTPUT_LABEL.rjust(depth * INDENT_SIZE + OUTPUT_LABEL.length, BLANK)
           puts "#{output_prefix} #{output}"
         end
       end
@@ -577,24 +579,24 @@ module Node
 end
 
 Node::HooksSample.new
-  .before_call do |input, **options|
+  .before_call do |input, **_options|
     puts "before_call input: #{input}";
     input + 1
   end
   .append(
     # anonymous external node
-    lambda do |input, **options|
+    lambda do |input, **_options|
       puts "external input: #{input}"
       input * 2
     end
   )
-  .around_call do |input, **options, &block|
+  .around_call do |input, **_options, &block|
     puts "around_call input: #{input}"
     output = block.call
     puts "around_call output: #{output}"
     output * input
   end
-  .after_call do |output, **options|
+  .after_call do |output, **_options|
     puts "after_call output: #{output}"
     output * 2
   end

data/examples/external-verbosify.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'callable_tree'
 require 'json'
 require 'rexml/document'
@@ -7,7 +9,7 @@ module Node
     class Parser
       include CallableTree::Node::Internal
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.json'
       end
 
@@ -18,7 +20,7 @@ module Node
         end
       end
 
-      def terminate?(_output, **)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -30,11 +32,11 @@ module Node
         @type = type
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !!input[@type.to_s]
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input[@type.to_s]
           .map { |element| [element['name'], element['emoji']] }
           .to_h
@@ -46,7 +48,7 @@ module Node
     class Parser
       include CallableTree::Node::Internal
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.xml'
       end
 
@@ -56,7 +58,7 @@ module Node
         end
       end
 
-      def terminate?(_output, **)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -68,11 +70,11 @@ module Node
         @type = type
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !input.get_elements("//#{@type}").empty?
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input
           .get_elements("//#{@type}")
           .first
@@ -94,7 +96,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/hooks-call.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'callable_tree'
 
 module Node
@@ -8,24 +10,24 @@ module Node
 end
 
 Node::HooksSample.new
-  .before_call do |input, **options|
+  .before_call do |input, **_options|
     puts "before_call input: #{input}";
     input + 1
   end
   .append(
     # anonymous external node
-    lambda do |input, **options|
+    lambda do |input, **_options|
       puts "external input: #{input}"
       input * 2
     end
   )
-  .around_call do |input, **options, &block|
+  .around_call do |input, **_options, &block|
     puts "around_call input: #{input}"
     output = block.call
     puts "around_call output: #{output}"
     output * input
   end
-  .after_call do |output, **options|
+  .after_call do |output, **_options|
     puts "after_call output: #{output}"
     output * 2
   end

data/examples/identity.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'callable_tree'
 require 'json'
 require 'rexml/document'
@@ -20,7 +22,7 @@ module Node
     class Parser
       include CallableTree::Node::Internal
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.json'
       end
 
@@ -31,7 +33,7 @@ module Node
         end
       end
 
-      def terminate?(_output, **)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -47,11 +49,11 @@ module Node
         Identity.new(klass: super, type: @type)
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !!input[@type.to_s]
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input[@type.to_s]
           .map { |element| [element['name'], element['emoji']] }
           .to_h
@@ -63,7 +65,7 @@ module Node
     class Parser
       include CallableTree::Node::Internal
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.xml'
       end
 
@@ -73,7 +75,7 @@ module Node
         end
       end
 
-      def terminate?(_output, **)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -89,11 +91,11 @@ module Node
         Identity.new(klass: super, type: @type)
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !input.get_elements("//#{@type}").empty?
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input
           .get_elements("//#{@type}")
           .first
@@ -115,7 +117,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-broadcast.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'callable_tree'
 
 module Node
@@ -16,12 +18,12 @@ end
 
 tree = CallableTree::Node::Root.new.append(
   Node::LessThan.new(5).append(
-    lambda { |input, **| input * 2 }, # anonymous external node
-    lambda { |input, **| input + 1 }  # anonymous external node
+    ->(input) { input * 2 }, # anonymous external node
+    ->(input) { input + 1 }  # anonymous external node
   ).broadcast,
   Node::LessThan.new(10).append(
-    lambda { |input, **| input * 3 }, # anonymous external node
-    lambda { |input, **| input - 1 }  # anonymous external node
+    ->(input) { input * 3 }, # anonymous external node
+    ->(input) { input - 1 }  # anonymous external node
   ).broadcast
 ).broadcast
 

data/examples/internal-compose.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'callable_tree'
 
 module Node

data/examples/internal-seek.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'callable_tree'
 require 'json'
 require 'rexml/document'
@@ -7,7 +9,7 @@ module Node
     class Parser
       include CallableTree::Node::Internal
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.json'
       end
 
@@ -18,7 +20,7 @@ module Node
         end
       end
 
-      def terminate?(_output, **)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -30,11 +32,11 @@ module Node
         @type = type
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !!input[@type.to_s]
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input[@type.to_s]
           .map { |element| [element['name'], element['emoji']] }
           .to_h
@@ -46,7 +48,7 @@ module Node
     class Parser
       include CallableTree::Node::Internal
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.xml'
       end
 
@@ -56,7 +58,7 @@ module Node
         end
       end
 
-      def terminate?(_output, **)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -68,11 +70,11 @@ module Node
         @type = type
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !input.get_elements("//#{@type}").empty?
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input
           .get_elements("//#{@type}")
           .first
@@ -94,7 +96,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/logging.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'callable_tree'
 require 'json'
 require 'rexml/document'
@@ -5,28 +7,28 @@ require 'rexml/document'
 module Node
   module Logging
     INDENT_SIZE = 2
-    BLANK = ' '.freeze
+    BLANK = ' '
 
     module Match
-      LIST_STYLE = '*'.freeze
+      LIST_STYLE = '*'
 
-      def match?(_input, **)
+      def match?(_input, **_options)
         super.tap do |matched|
-          prefix = LIST_STYLE.rjust(self.depth * INDENT_SIZE - INDENT_SIZE + LIST_STYLE.length, BLANK)
-          puts "#{prefix} #{self.identity}: [matched: #{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 :'.freeze
-      OUTPUT_LABEL = 'Output:'.freeze
+      INPUT_LABEL  = 'Input :'
+      OUTPUT_LABEL = 'Output:'
 
-      def call(input, **)
+      def call(input, **_options)
         super.tap do |output|
-          input_prefix = INPUT_LABEL.rjust(self.depth * INDENT_SIZE + INPUT_LABEL.length, BLANK)
+          input_prefix = INPUT_LABEL.rjust(depth * INDENT_SIZE + INPUT_LABEL.length, BLANK)
           puts "#{input_prefix} #{input}"
-          output_prefix = OUTPUT_LABEL.rjust(self.depth * INDENT_SIZE + OUTPUT_LABEL.length, BLANK)
+          output_prefix = OUTPUT_LABEL.rjust(depth * INDENT_SIZE + OUTPUT_LABEL.length, BLANK)
           puts "#{output_prefix} #{output}"
         end
       end
@@ -51,7 +53,7 @@ module Node
       include CallableTree::Node::Internal
       prepend Logging::Match
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.json'
       end
 
@@ -62,7 +64,7 @@ module Node
         end
       end
 
-      def terminate?(_output, **)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -80,11 +82,11 @@ module Node
         Identity.new(klass: super, type: @type)
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !!input[@type.to_s]
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input[@type.to_s]
           .map { |element| [element['name'], element['emoji']] }
           .to_h
@@ -97,7 +99,7 @@ module Node
       include CallableTree::Node::Internal
       prepend Logging::Match
 
-      def match?(input, **options)
+      def match?(input, **_options)
         File.extname(input) == '.xml'
       end
 
@@ -107,7 +109,7 @@ module Node
         end
       end
 
-      def terminate?(_output, **)
+      def terminate?(_output, *_inputs, **_options)
         true
       end
     end
@@ -125,11 +127,11 @@ module Node
         Identity.new(klass: super, type: @type)
       end
 
-      def match?(input, **options)
+      def match?(input, **_options)
         !input.get_elements("//#{@type}").empty?
       end
 
-      def call(input, **options)
+      def call(input, **_options)
         input
           .get_elements("//#{@type}")
           .first
@@ -151,7 +153,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/lib/callable_tree/node/external/verbose.rb

@@ -3,6 +3,7 @@
 module CallableTree
   module Node
     module External
+      # TODO: Add :inputs
       Output = Struct.new(:value, :options, :routes)
 
       module Verbose
@@ -10,8 +11,8 @@ module CallableTree
           true
         end
 
-        def call(input = nil, **options)
-          output = super(input, **options)
+        def call(*inputs, **options)
+          output = super(*inputs, **options)
           routes = self.routes
 
           Output.new(output, options, routes)

data/lib/callable_tree/node/external.rb

@@ -37,11 +37,15 @@ module CallableTree
           .class
       end
 
+      def outline
+        { identity => nil }
+      end
+
       private
 
       def initialize_copy(_node)
         super
-        send(:parent=, nil)
+        self.parent = nil
       end
 
       class Proxy

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

@@ -23,15 +23,17 @@ module CallableTree
           self
         end
 
-        def call(input = nil, **options)
-          input = before_callbacks.reduce(input) do |input, callable|
-            callable.call(input, self, **options)
+        def call(*inputs, **options)
+          input_head, *input_tail = inputs
+
+          input_head = before_callbacks.reduce(input_head) do |input_head, callable|
+            callable.call(input_head, *input_tail, self, **options)
           end
 
-          output = super(input, **options)
+          output = super(input_head, *input_tail, **options)
 
           output = around_callbacks.reduce(output) do |output, callable|
-            callable.call(input, self, **options) { output }
+            callable.call(input_head, *input_tail, self, **options) { output }
           end
 
           after_callbacks.reduce(output) do |output, callable|

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CallableTree
+  module Node
+    module Internal
+      module Strategy
+        class Broadcast
+          def call(nodes, *inputs, **options)
+            nodes.map do |node|
+              node.call(*inputs, **options) if node.match?(*inputs, **options)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module CallableTree
+  module Node
+    module Internal
+      module Strategy
+        class Compose
+          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)
+              else
+                input
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module CallableTree
+  module Node
+    module Internal
+      module Strategy
+        class Seek
+          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)
+                [output, terminated]
+              end
+              .select { |_output, terminated| terminated }
+              .map { |output, _terminated| output }
+              .first
+          end
+        end
+      end
+    end
+  end
+end

data/lib/callable_tree/node/internal.rb

@@ -3,10 +3,17 @@
 module CallableTree
   module Node
     module Internal
+      extend ::Forwardable
       include Node
 
+      def_delegators :child_nodes, :[], :at
+
       def children
-        @children ||= []
+        [*child_nodes]
+      end
+
+      def children!
+        child_nodes
       end
 
       def append(*callables)
@@ -18,52 +25,104 @@ module CallableTree
       def append!(*callables)
         callables
           .map { |callable| nodeify(callable) }
-          .tap { |nodes| children.push(*nodes) } # Use Array#push for Ruby 2.4
+          .tap { |nodes| child_nodes.push(*nodes) } # Use Array#push for Ruby 2.4
+
+        self
+      end
+
+      def reject(&block)
+        clone.tap do |node|
+          node.reject!(&block)
+        end
+      end
 
+      def reject!(&block)
+        child_nodes.reject!(&block)
         self
       end
 
-      def match?(_input = nil, **_options)
-        !children.empty?
+      def shake(&block)
+        clone.tap do |node|
+          node.shake!(&block)
+        end
+      end
+
+      def shake!(&block)
+        reject!(&block) if block_given?
+
+        reject! do |node|
+          node.is_a?(Internal) && node.shake!(&block).child_nodes.empty?
+        end
+      end
+
+      def match?(*, **)
+        !child_nodes.empty?
       end
 
-      def call(input = nil, **options)
-        strategy.call(children, input: input, options: options)
+      def call(*inputs, **options)
+        strategy.call(child_nodes, *inputs, **options)
       end
 
       def seek
-        if strategy.is_a?(Seek)
+        if strategy.is_a?(Strategy::Seek)
           self
         else
           clone.tap do |node|
-            node.send(:strategy=, Seek.new)
+            node.send(:strategy=, Strategy::Seek.new)
           end
         end
       end
 
+      def seek!
+        self.strategy = Strategy::Seek.new unless strategy.is_a?(Strategy::Seek)
+        self
+      end
+
       def broadcast
-        if strategy.is_a?(Broadcast)
+        if strategy.is_a?(Strategy::Broadcast)
           self
         else
           clone.tap do |node|
-            node.send(:strategy=, Broadcast.new)
+            node.send(:strategy=, Strategy::Broadcast.new)
           end
         end
       end
 
+      def broadcast!
+        self.strategy = Strategy::Broadcast.new unless strategy.is_a?(Strategy::Broadcast)
+        self
+      end
+
       def compose
-        if strategy.is_a?(Compose)
+        if strategy.is_a?(Strategy::Compose)
           self
         else
           clone.tap do |node|
-            node.send(:strategy=, Compose.new)
+            node.send(:strategy=, Strategy::Compose.new)
           end
         end
       end
 
+      def compose!
+        self.strategy = Strategy::Compose.new unless strategy.is_a?(Strategy::Compose)
+        self
+      end
+
+      def outline(&block)
+        key = block ? block.call(self) : identity
+        value = child_nodes.reduce({}) { |memo, node| memo.merge!(node.outline(&block)) }
+        { key => value }
+      end
+
+      protected
+
+      def child_nodes
+        @child_nodes ||= []
+      end
+
       private
 
-      attr_writer :children, :strategy
+      attr_writer :child_nodes, :strategy
 
       def nodeify(callable)
         if callable.is_a?(Node)
@@ -71,17 +130,17 @@ module CallableTree
         else
           External.proxify(callable)
         end
-        .tap { |node| node.send(:parent=, self) }
+          .tap { |node| node.send(:parent=, self) }
       end
 
       def strategy
-        @strategy ||= Seek.new
+        @strategy ||= Strategy::Seek.new
       end
 
       def initialize_copy(_node)
         super
-        send(:parent=, nil)
-        self.children = children.map do |node|
+        self.parent = nil
+        self.child_nodes = child_nodes.map do |node|
           node.clone.tap { |new_node| new_node.send(:parent=, self) }
         end
       end

data/lib/callable_tree/node.rb

@@ -4,12 +4,16 @@ module CallableTree
   module Node
     attr_reader :parent
 
+    def root?
+      parent.nil?
+    end
+
     def ancestors
       ::Enumerator.new do |y|
         node = self
         loop do
           y << node
-          break unless node = node&.parent
+          break unless node = node.parent
         end
       end
     end
@@ -23,18 +27,22 @@ module CallableTree
     end
 
     def depth
-      parent.nil? ? 0 : parent.depth + 1
+      root? ? 0 : parent.depth + 1
+    end
+
+    def outline
+      raise ::CallableTree::Error, 'Not implemented'
     end
 
-    def match?(_input = nil, **_options)
+    def match?(*_inputs, **_options)
       true
     end
 
-    def call(_input = nil, **_options)
+    def call(*_inputs, **_options)
       raise ::CallableTree::Error, 'Not implemented'
     end
 
-    def terminate?(output = nil, **_options)
+    def terminate?(output, *_inputs, **_options)
       !output.nil?
     end
 

data/lib/callable_tree/version.rb

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

data/lib/callable_tree.rb

@@ -8,9 +8,9 @@ require 'forwardable'
 require_relative 'callable_tree/version'
 require_relative 'callable_tree/node'
 require_relative 'callable_tree/node/hooks/call'
-require_relative 'callable_tree/node/internal/broadcast'
-require_relative 'callable_tree/node/internal/seek'
-require_relative 'callable_tree/node/internal/compose'
+require_relative 'callable_tree/node/internal/strategy/broadcast'
+require_relative 'callable_tree/node/internal/strategy/seek'
+require_relative 'callable_tree/node/internal/strategy/compose'
 require_relative 'callable_tree/node/external/verbose'
 require_relative 'callable_tree/node/external'
 require_relative 'callable_tree/node/internal'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: callable_tree
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - jsmmr
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-06-14 00:00:00.000000000 Z
+date: 2021-12-27 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
@@ -20,6 +20,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".github/workflows/build.yml"
+- ".github/workflows/codeql-analysis.yml"
 - ".gitignore"
 - ".rspec"
 - ".ruby-version"
@@ -49,9 +50,9 @@ files:
 - lib/callable_tree/node/external/verbose.rb
 - lib/callable_tree/node/hooks/call.rb
 - lib/callable_tree/node/internal.rb
-- lib/callable_tree/node/internal/broadcast.rb
-- lib/callable_tree/node/internal/compose.rb
-- lib/callable_tree/node/internal/seek.rb
+- lib/callable_tree/node/internal/strategy/broadcast.rb
+- lib/callable_tree/node/internal/strategy/compose.rb
+- lib/callable_tree/node/internal/strategy/seek.rb
 - lib/callable_tree/node/root.rb
 - lib/callable_tree/version.rb
 homepage: https://github.com/jsmmr/ruby_callable_tree
@@ -60,7 +61,7 @@ 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.2.0/CHANGELOG.md
+  changelog_uri: https://github.com/jsmmr/ruby_callable_tree/blob/v0.3.0/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -76,7 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.16
+rubygems_version: 3.3.3
 signing_key:
 specification_version: 4
 summary: Builds a tree by linking callable nodes. The nodes that match the conditions

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

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module CallableTree
-  module Node
-    module Internal
-      class Broadcast
-        def call(nodes, input:, options:)
-          nodes.map do |node|
-            node.call(input, **options) if node.match?(input, **options)
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module CallableTree
-  module Node
-    module Internal
-      class Compose
-        def call(nodes, input:, options:)
-          nodes.reduce(input) do |input, node|
-            if node.match?(input, **options)
-              node.call(input, **options)
-            else
-              input
-            end
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module CallableTree
-  module Node
-    module Internal
-      class Seek
-        def call(nodes, input:, options:)
-          nodes
-            .lazy
-            .select { |node| node.match?(input, **options) }
-            .map do |node|
-              output = node.call(input, **options)
-              terminated = node.terminate?(output, **options)
-              [output, terminated]
-            end
-            .select { |_output, terminated| terminated }
-            .map { |output, _terminated| output }
-            .first
-        end
-      end
-    end
-  end
-end