callable_tree 0.3.9 → 0.3.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f81f9d9f97c638d350599e56656dd0430765f8ab79e572b3906963ffc94d32b
-  data.tar.gz: 7fb4ad3eb420568d51cb3c3969969fa5c14bf82d99b6f2fb2035ce081e641d64
+  metadata.gz: aa3020e36165379b1ad6b642240470a33503150fd3bc945206f0685b2dbb80f4
+  data.tar.gz: 0b5314f8b192d2908640df885db697bf7a283878f08568e0ce713aa2bd6fd38b
 SHA512:
-  metadata.gz: cdf78b08f6d7b6ea112b510ac564724b7c15842bc44ccf4e603bc17083f0a0999705656e37277729006f8f955340f21e0191af720b474492d97e74b6cd6c2a51
-  data.tar.gz: c0fd6fed3b3ec188b51375558a202543d72ee70aaffe25489dd1cf99c6f8882377e61868e32dc07eed43947cb85248c419c35ebbc89f2ca326f829a0bdb533cd
+  metadata.gz: 2476e82ba6ad533bf752d75aec400bc06e9ce7106ca53a736e1b987641cf0f5d3a375126df90a5963feaf3f887ab589d2c87d61790ff08b583469e1fac13b312
+  data.tar.gz: 7eb64d2ecc3ae2333e60346173675c341b89ae14cc2d28e2f32f6b48d19d08cd580c2392d976ea6c550a2e66fee2b909c2b286e09a56e7c52b473adbbcadb82a

data/.github/workflows/build.yml

@@ -1,18 +1,32 @@
 name: build
 on: [push]
 jobs:
-  build:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 4.0
+          bundler-cache: true
+      - name: Run bundle install
+        run: |
+          bundle config path vendor/bundle
+          bundle install --jobs 4 --retry 3
+      - run: bundle exec rubocop
+
+  test:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby: ['2.4', '2.5', '2.6', '2.7', '3.0', '3.1', '3.2.0-preview1']
+        ruby: ['2.4', '2.5', '2.6', '2.7', '3.0', '3.1', '3.2', '3.3', '3.4', '4.0']
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
-      - run: gem install bundler:2.3.7
-      - uses: actions/cache@v3
+          bundler-cache: true
+      - uses: actions/cache@v5
         with:
           path: vendor/bundle
           key: ${{ runner.os }}-ruby-${{ matrix.ruby }}-gems-${{ hashFiles('**/Gemfile.lock') }}

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

@@ -38,11 +38,11 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v6
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
+      uses: github/codeql-action/init@v4
       with:
         languages: ${{ matrix.language }}
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -53,7 +53,7 @@ jobs:
     # 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@v2
+      uses: github/codeql-action/autobuild@v4
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 https://git.io/JvXDl
@@ -67,4 +67,4 @@ jobs:
     #   make release
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v2
+      uses: github/codeql-action/analyze@v4

data/.gitignore

@@ -9,3 +9,5 @@
 
 # rspec failure tracking
 .rspec_status
+
+/Gemfile.lock

data/.rubocop.yml

@@ -1,5 +1,8 @@
+inherit_from: .rubocop_todo.yml
+
 AllCops:
   NewCops: enable
+  TargetRubyVersion: 2.4
 Style/HashSyntax:
   EnforcedShorthandSyntax: never
 Naming/BlockForwarding:

data/.rubocop_todo.yml

@@ -0,0 +1,120 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-01-02 20:06:51 UTC using RuboCop version 1.82.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: enums
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/callable_tree/node/external_spec.rb'
+    - 'spec/callable_tree/node/internal/strategizable_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedParentClasses.
+Lint/MissingSuper:
+  Exclude:
+    - 'lib/callable_tree/node/root.rb'
+
+# Offense count: 10
+# Configuration parameters: AllowKeywordBlockArguments.
+Lint/UnderscorePrefixedVariableName:
+  Exclude:
+    - 'examples/builder/identity.rb'
+    - 'examples/builder/logging.rb'
+    - 'examples/class/logging.rb'
+
+# Offense count: 8
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/callable_tree/node/builder.rb'
+    - 'lib/callable_tree/node/external/builder.rb'
+    - 'spec/callable_tree/node/builder_spec.rb'
+
+# Offense count: 7
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 25
+
+# Offense count: 38
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 798
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 8
+
+# Offense count: 14
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 45
+
+# Offense count: 8
+# Configuration parameters: ExpectMatchingDefinition, CheckDefinitionPathHierarchy, CheckDefinitionPathHierarchyRoots, Regex, IgnoreExecutableScripts, AllowedAcronyms.
+# CheckDefinitionPathHierarchyRoots: lib, spec, test, src
+# AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
+Naming/FileName:
+  Exclude:
+    - 'Rakefile.rb'
+    - 'examples/builder/external-verbosify.rb'
+    - 'examples/builder/internal-broadcastable.rb'
+    - 'examples/builder/internal-composable.rb'
+    - 'examples/builder/internal-seekable.rb'
+    - 'examples/class/external-verbosify.rb'
+    - 'examples/class/internal-broadcastable.rb'
+    - 'examples/class/internal-composable.rb'
+    - 'examples/class/internal-seekable.rb'
+
+# Offense count: 1
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'spec/callable_tree/node/builder_spec.rb'
+
+# Offense count: 1
+Style/ClassVars:
+  Exclude:
+    - 'lib/callable_tree/node/internal/strategizable.rb'
+
+# Offense count: 40
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 45
+Style/MultilineBlockChain:
+  Exclude:
+    - 'examples/builder/external-verbosify.rb'
+    - 'examples/builder/hooks.rb'
+    - 'examples/builder/identity.rb'
+    - 'examples/builder/internal-seekable.rb'
+    - 'examples/builder/logging.rb'
+    - 'examples/class/hooks.rb'
+    - 'examples/class/logging.rb'
+    - 'lib/callable_tree/node/internal/strategy/seek.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: respond_to_missing?
+Style/OptionalBooleanParameter:
+  Exclude:
+    - 'lib/callable_tree/node/builder.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 210

data/.ruby-version

@@ -1 +1 @@
-3.1.2
+4.0.0

data/AGENTS.md

@@ -0,0 +1,44 @@
+# Agent Guide for callable_tree
+
+## Project Overview
+`callable_tree` is a Ruby gem that builds a tree of callable nodes. It allows for complex logic flow (like nested `if`/`case`) to be represented as a tree of objects. Nodes are traversed based on matching conditions (`match?`), and executed (`call`).
+
+## Core Concepts
+- **Nodes**:
+  - `Root`: The entry point of the tree.
+  - `Internal`: Branch nodes that contain child nodes. Strategies:
+    - `seekable`: Calls the first matching child (like `case`).
+    - `broadcastable`: Calls all matching children.
+    - `composable`: Pipes output from one child to the next.
+  - `External`: Leaf nodes that perform actual work.
+- **Traversal**:
+  - `match?(input)`: Determines if a node should process the input.
+  - `call(input)`: Executes the node logic.
+  - `terminate?`: Controls when to stop traversal (mostly for `seekable`).
+
+## Directory Structure
+- `lib/`: Source code.
+- `spec/`: RSpec tests.
+- `examples/`: Usage examples (Class-style and Builder-style).
+
+## Development
+- **Tool Version Manager**: mise
+- **Language**: Ruby (>= 2.4.0)
+- **Dependency Management**: Bundler
+  - Execute `bundle` commands via `mise` (e.g., `mise x -- bundle exec ...`)
+- **Testing**: RSpec
+  - Run all tests: `mise x -- bundle exec rake` or `mise x -- bundle exec rake spec`
+- **Commit Messages**: Follow the convention in [CONTRIBUTING.md](CONTRIBUTING.md).
+- **Linter/Formatter**:
+  - Uses `rubocop`.
+  - Run checks: `mise x -- bundle exec rubocop`
+- **CI/CD**:
+  - GitHub Actions: `.github/workflows/build.yml` runs tests and linter on push/PR.
+- **Release Process**:
+  - Version: `lib/callable_tree/version.rb`
+  - Tagging: Create a git tag (e.g., `v0.4.0`) and push.
+
+## Architecture
+- **Composite Pattern**: Used for `Internal` nodes to treat individual objects and compositions uniformly.
+- **Builder Pattern**: `CallableTree::Node::Internal::Builder` and `CallableTree::Node::External::Builder` provide a fluent interface for constructing complex trees.
+

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [0.3.11] - 2026-01-03
+
+- Fix a typo in `Strategizable#strategize` where it incorrectly called `strategy!` instead of `strategize!`.`
+
+## [0.3.10] - 2022-12-30
+
+- Change `CallableTree::Node::Internal#broadcastable` to take `matchable` keyword parameter as boolean. It defaults to `true`, which is the same behavior as before.
+- Change `CallableTree::Node::Internal#composable` to take `matchable` keyword parameter as boolean. It defaults to `true`, which is the same behavior as before.
+- Change `CallableTree::Node::Internal#seekable` to take `matchable` keyword parameter as boolean. It defaults to `true`, which is the same behavior as before.
+
 ## [0.3.9] - 2022-11-06
 
 - Change `CallableTree::Node::Internal#broadcastable` to take `terminable` keyword parameter as boolean. It defaults to `false`, which is the same behavior as before.

data/CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Commit Message Convention
+
+We follow the [Conventional Commits](https://www.conventionalcommits.org/) specification.
+
+## Format
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+## Header
+
+The header is mandatory and must not exceed 72 characters.
+
+### Type
+
+Must be one of the following:
+
+- **feat**: A new feature
+- **fix**: A bug fix
+- **docs**: Documentation only changes
+- **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
+- **refactor**: A code change that neither fixes a bug nor adds a feature
+- **perf**: A code change that improves performance
+- **test**: Adding missing tests or correcting existing tests
+- **build**: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
+- **ci**: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
+- **chore**: Other changes that don't modify src or test files
+- **revert**: Reverts a previous commit
+
+### Scope
+
+The scope is optional and should be a phrase describing the section of the codebase affected.
+
+### Subject
+
+The subject contains a succinct description of the change:
+
+- Use the imperative, present tense: "change" not "changed" nor "changes"
+- Don't capitalize the first letter
+- No dot (.) at the end
+
+## Body
+
+The body is optional and should include the motivation for the change and contrast this with previous behavior.
+
+## Footer
+
+The footer is optional and should contain any information about **Breaking Changes** and is also the place to reference GitHub issues that this commit closes.
+
+## Branch Naming
+
+We generally use the following prefixes for branch names:
+
+- `feature/`: New features (e.g., `feature/login-screen`)
+- `fix/`: Bug fixes (e.g., `fix/memory-leak`)
+- `docs/`: Documentation only changes (e.g., `docs/update-readme`)
+- `style/`: Changes that do not affect the meaning of the code (e.g., `style/rubocop-fixes`)
+- `refactor/`: Code changes that neither fix a bug nor add a feature (e.g., `refactor/extract-method`)
+- `test/`: Adding or correcting tests (e.g., `test/add-rspec-cases`)
+- `chore/`: Changes to the build process or auxiliary tools and libraries (e.g., `chore/update-gems`)
+
+Use kebab-case for the branch name (e.g., `feature/my-new-feature`).
+

data/Gemfile

@@ -5,6 +5,8 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in callable_tree.gemspec
 gemspec
 
-gem 'rake', '~> 13.0'
+gem 'rake', '~> 13.3'
 
-gem 'rspec', '~> 3.0'
+gem 'rspec', '~> 3.13'
+
+gem 'rubocop', require: false if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new('4.0')

data/README.md

@@ -21,14 +21,14 @@ Or install it yourself as:
 
 ## Usage
 
-Builds a tree by linking `CallableTree` node instances. The `call` methods of the nodes where the `match?` method returns a truthy value are called in a chain from the root node to the leaf node.
+Builds a tree of `CallableTree` nodes. Invokes the `call` method on nodes where `match?` returns a truthy value, chaining execution from root to leaf.
 
 - `CallableTree::Node::Internal`
-  - This `module` is used to define a node that can have child nodes. This node has several strategies (`seekable`, `broadcastable`, `composable`).
+  - Defines a node that can have child nodes. Supports several strategies (`seekable`, `broadcastable`, `composable`).
 - `CallableTree::Node::External`
-  - This `module` is used to define a leaf node that cannot have child nodes.
+  - Defines a leaf node, which cannot have child nodes.
 - `CallableTree::Node::Root`
-  - This `class` includes `CallableTree::Node::Internal`. When there is no need to customize the internal node, use this `class`.
+  - Includes `CallableTree::Node::Internal`. Use this class when customization of the internal node is not required.
 
 ### Basic
 
@@ -36,7 +36,7 @@ There are two ways to define the nodes: class style and builder style.
 
 #### `CallableTree::Node::Internal#seekable` (default strategy)
 
-This strategy does not call the next sibling node if the `call` method of the current node returns a value other than `nil`. This behavior is changeable by overriding the `terminate?` method.
+This strategy stops processing subsequent sibling nodes if the current node's `call` method returns a non-nil value. This behavior is changeable by overriding the `terminate?` method.
 
 ##### Class style
 
@@ -51,8 +51,7 @@ module Node
         File.extname(input) == '.json'
       end
 
-      # If there is need to convert the input values for
-      # child nodes, override the `call` method.
+      # Override `call` if you need to transform input values for child nodes.
       def call(input, **options)
         File.open(input) do |file|
           json = ::JSON.load(file)
@@ -60,9 +59,7 @@ module Node
         end
       end
 
-      # 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`.
+      # Override `terminate?` to return `true` to stop processing sibling nodes even if `call` returns `nil`.
       def terminate?(_output, *_inputs, **_options)
         true
       end
@@ -94,17 +91,14 @@ module Node
         File.extname(input) == '.xml'
       end
 
-      # If there is need to convert the input values for
-      # child nodes, override the `call` method.
+      # Override `call` if you need to transform input values for child nodes.
       def call(input, **options)
         File.open(input) do |file|
           super(REXML::Document.new(file), **options)
         end
       end
 
-      # 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`.
+      # Override `terminate?` to return `true` to stop processing sibling nodes even if `call` returns `nil`.
       def terminate?(_output, *_inputs, **_options)
         true
       end
@@ -131,7 +125,7 @@ module Node
   end
 end
 
-# The `seekable` method call can be omitted since it is the default strategy.
+# The `seekable` call can be omitted as it is the default strategy.
 tree = CallableTree::Node::Root.new.seekable.append(
   Node::JSON::Parser.new.seekable.append(
     Node::JSON::Scraper.new(type: :animals),
@@ -265,7 +259,7 @@ Run `examples/builder/internal-seekable.rb`:
 
 #### `CallableTree::Node::Internal#broadcastable`
 
-This strategy broadcasts to output a result of the child nodes as array. It also ignores their `terminate?` methods by default.
+This strategy broadcasts input to all child nodes and returns their results as an array. It ignores child `terminate?` methods by default.
 
 ##### Class style
 
@@ -411,7 +405,7 @@ Run `examples/builder/internal-broadcastable.rb`:
 
 #### `CallableTree::Node::Internal#composable`
 
-This strategy composes the child nodes to input the output of the previous node into the next node and to output a result.
+This strategy chains child nodes, passing the output of the previous node as input to the next.
 It also ignores their `terminate?` methods by default.
 
 ##### Class style
@@ -560,7 +554,7 @@ Run `examples/builder/internal-composable.rb`:
 
 #### `CallableTree::Node::External#verbosify`
 
-If you want verbose output results, call this method.
+Use this method to enable verbose output.
 
 `examples/builder/external-verbosify.rb`:
 ```ruby
@@ -659,19 +653,19 @@ module Logging
       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
+    return unless 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
 
@@ -739,7 +733,7 @@ Run `examples/builder/logging.rb`:
 
 #### `CallableTree::Node#identity`
 
-If you want to customize the node identity, specify identifier.
+Specify an identifier to customize the node identity.
 
 `examples/builder/identity.rb`:
 ```ruby
@@ -778,7 +772,7 @@ end
 ...
 ```
 
-Run `examples/class/identity.rb`:
+Run `examples/builder/identity.rb`:
 ```sh
  % ruby examples/builder/identity.rb
 #<struct CallableTree::Node::External::Output

data/examples/builder/external-verbosify.rb

@@ -12,7 +12,7 @@ JSONParser =
   end
   .caller do |input, **options, &block|
     File.open(input) do |file|
-      json = ::JSON.load(file)
+      json = JSON.parse(file.read)
       # The following block call is equivalent to calling `super` in the class style.
       block.call(json, **options)
     end

data/examples/builder/identity.rb

@@ -12,7 +12,7 @@ JSONParser =
   end
   .caller do |input, **options, &block|
     File.open(input) do |file|
-      json = ::JSON.load(file)
+      json = JSON.parse(file.read)
       # The following block call is equivalent to calling `super` in the class style.
       block.call(json, **options)
     end

data/examples/builder/internal-seekable.rb

@@ -12,7 +12,7 @@ JSONParser =
   end
   .caller do |input, **options, &original|
     File.open(input) do |file|
-      json = ::JSON.load(file)
+      json = JSON.parse(file.read)
       # The following block call is equivalent to calling `super` in the class style.
       original.call(json, **options)
     end

data/examples/builder/logging.rb

@@ -12,7 +12,7 @@ JSONParser =
   end
   .caller do |input, **options, &original|
     File.open(input) do |file|
-      json = ::JSON.load(file)
+      json = JSON.parse(file.read)
       # The following block call is equivalent to calling `super` in the class style.
       original.call(json, **options)
     end
@@ -87,19 +87,19 @@ module Logging
       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
+    return unless 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
 

data/examples/class/external-verbosify.rb

@@ -15,7 +15,7 @@ module Node
 
       def call(input, **options)
         File.open(input) do |file|
-          json = ::JSON.load(file)
+          json = ::JSON.parse(file.read)
           super(json, **options)
         end
       end

data/examples/class/identity.rb

@@ -28,7 +28,7 @@ module Node
 
       def call(input, **options)
         File.open(input) do |file|
-          json = ::JSON.load(file)
+          json = ::JSON.parse(file.read)
           super(json, **options)
         end
       end

data/examples/class/internal-seekable.rb

@@ -15,7 +15,7 @@ module Node
 
       def call(input, **options)
         File.open(input) do |file|
-          json = ::JSON.load(file)
+          json = ::JSON.parse(file.read)
           super(json, **options)
         end
       end

data/examples/class/logging.rb

@@ -29,7 +29,7 @@ module Node
 
       def call(input, **options)
         File.open(input) do |file|
-          json = ::JSON.load(file)
+          json = ::JSON.parse(file.read)
           super(json, **options)
         end
       end
@@ -124,19 +124,19 @@ module Logging
       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
+    return unless 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
 

data/lib/callable_tree/node/builder.rb

@@ -50,6 +50,7 @@ module CallableTree
         ::Class
           .new do
             include node_type
+
             if hookable
               prepend Hooks::Matcher
               prepend Hooks::Caller

data/lib/callable_tree/node/external/verbose.rb

@@ -11,7 +11,7 @@ module CallableTree
         end
 
         def call(*inputs, **options)
-          output = super(*inputs, **options)
+          output = super
           options.delete(:_node_)
           routes = self.routes
 

data/lib/callable_tree/node/external.rb

@@ -6,10 +6,10 @@ module CallableTree
       include Node
 
       def self.included(mod)
-        if mod.include?(Internal)
-          raise ::CallableTree::Error,
-                "#{mod} cannot include #{self} together with #{Internal}"
-        end
+        return unless mod.include?(Internal)
+
+        raise ::CallableTree::Error,
+              "#{mod} cannot include #{self} together with #{Internal}"
       end
 
       def self.proxify(callable)
@@ -32,6 +32,7 @@ module CallableTree
 
       def verbosify!
         extend Verbose
+
         self
       end
 

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

@@ -42,7 +42,7 @@ module CallableTree
 
           terminated =
             if around_terminator_callbacks.empty?
-              super(output, *inputs, **options)
+              super
             else
               around_terminator_callbacks_head, *around_terminator_callbacks_tail = around_terminator_callbacks
               terminator = proc { super(output, *inputs, **options) }

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

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module CallableTree
+  module Node
+    module Internal
+      module Strategizable
+        def self.included(mod)
+          mod.extend ClassMethods
+        end
+
+        DEFAUTL_FACTORY = proc do |klass, *_args, matchable:, terminable:, **_kwargs|
+          klass.new(matchable: matchable, terminable: terminable)
+        end
+
+        @@strategy_configs = {
+          seek: {
+            klass: Strategy::Seek,
+            alias: :seekable,
+            matchable: true,
+            terminable: true,
+            factory: DEFAUTL_FACTORY
+          },
+          broadcast: {
+            klass: Strategy::Broadcast,
+            alias: :broadcastable,
+            matchable: true,
+            terminable: false,
+            factory: DEFAUTL_FACTORY
+          },
+          compose: {
+            klass: Strategy::Compose,
+            alias: :composable,
+            matchable: true,
+            terminable: false,
+            factory: DEFAUTL_FACTORY
+          }
+        }
+
+        class << self
+          private
+
+          def strategy_configs
+            @@strategy_configs
+          end
+
+          def define_strategy_methods(key, config)
+            define_method(:"#{config[:alias]}?") { strategy.is_a?(config[:klass]) }
+
+            define_method(config[:alias]) do |*args, matchable: config[:matchable], terminable: config[:terminable], **kwargs|
+              # TODO: Modify to use strategize method
+              if strategy == config[:factory].call(
+                config[:klass], *args, matchable: matchable, terminable: terminable, **kwargs
+              )
+                self
+              else
+                clone.__send__(:"#{config[:alias]}!", *args, matchable: matchable, terminable: terminable, **kwargs)
+              end
+            end
+
+            define_method(:"#{config[:alias]}!") do |*args, matchable: config[:matchable], terminable: config[:terminable], **kwargs|
+              strategize!(key, *args, matchable: matchable, terminable: terminable, **kwargs)
+            end
+          end
+        end
+
+        module ClassMethods
+          def store_strategy(key, config)
+            raise ::CallableTree::Error, 'Strategy class is required. [:klass]' unless config[:klass]
+
+            key = key.to_sym
+            config[:alias] = key unless config[:alias]
+            config[:factory] = DEFAUTL_FACTORY unless config[:factory]
+            Strategizable.__send__(:strategy_configs)[key] = config
+            Strategizable.__send__(:define_strategy_methods, key, config)
+          end
+        end
+
+        @@strategy_configs.each { |key, config| define_strategy_methods(key, config) }
+
+        # Backward compatibility
+        alias seek? seekable?
+        alias seek seekable
+        alias seek! seekable!
+        alias broadcast? broadcastable?
+        alias broadcast broadcastable
+        alias broadcast! broadcastable!
+        alias compose? composable?
+        alias compose composable
+        alias compose! composable!
+
+        protected
+
+        attr_writer :strategy
+
+        private
+
+        def strategize(name, *args, matchable:, terminable:, **kwargs)
+          clone.strategize!(name, *args, matchable: matchable, terminable: terminable, **kwargs)
+        end
+
+        def strategize!(name, *args, matchable:, terminable:, **kwargs)
+          config = @@strategy_configs[name.to_sym]
+          raise ::CallableTree::Error, "Strategy is not found. [#{name}]" unless config
+
+          self.strategy = config[:factory].call(
+            config[:klass], *args, matchable: matchable, terminable: terminable, **kwargs
+          )
+          self
+        end
+
+        def strategy
+          @strategy ||= @@strategy_configs[:seek][:klass].new
+        end
+      end
+    end
+  end
+end

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

@@ -7,26 +7,19 @@ module CallableTree
         class Broadcast
           include Strategy
 
-          def initialize(terminable: false)
+          def initialize(matchable: true, terminable: false)
+            self.matchable = matchable
             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.reduce([]) do |outputs, node|
-              output = (node.call(*inputs, **options) if node.match?(*inputs, **options))
+            nodes.each_with_object([]) do |node, outputs|
+              output = (node.call(*inputs, **options) if matcher.call(node, *inputs, **options))
               outputs << output
 
-              if @terminator.call(node, output, *inputs, **options)
-                break outputs
-              else
-                outputs
-              end
+              break outputs if terminator.call(node, output, *inputs, **options)
+
+              outputs
             end
           end
         end

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

@@ -7,22 +7,17 @@ module CallableTree
         class Compose
           include Strategy
 
-          def initialize(terminable: false)
+          def initialize(matchable: true, terminable: false)
+            self.matchable = matchable
             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|
-              if node.match?(input, *tail, **options)
+              if matcher.call(node, input, *tail, **options)
                 output = node.call(input, *tail, **options)
-                break output if @terminator.call(node, output, input, *tail, **options)
+                break output if terminator.call(node, output, input, *tail, **options)
 
                 output
               else

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

@@ -7,23 +7,18 @@ module CallableTree
         class Seek
           include Strategy
 
-          def initialize(terminable: true)
+          def initialize(matchable: true, terminable: true)
+            self.matchable = matchable
             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) }
+              .select { |node| matcher.call(node, *inputs, **options) }
               .map do |node|
                 output = node.call(*inputs, **options)
-                terminated = @terminator.call(node, 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 && terminable? == other.terminable?
+          name == other.name && matchable? == other.matchable? && terminable? == other.terminable?
         end
 
         def eql?(other)
@@ -21,7 +21,11 @@ module CallableTree
         end
 
         def hash
-          [self.class.name, terminable].join('-').hash
+          [self.class.name, matchable, terminable].join('-').hash
+        end
+
+        def matchable?
+          matchable
         end
 
         def terminable?
@@ -30,7 +34,25 @@ module CallableTree
 
         private
 
-        attr_accessor :terminable
+        attr_accessor :matchable, :terminable
+
+        def matcher
+          @matcher ||=
+            if matchable
+              proc { |node, *inputs, **options| node.match?(*inputs, **options) }
+            else
+              proc { false }
+            end
+        end
+
+        def terminator
+          @terminator ||=
+            if terminable
+              proc { |node, output, *inputs, **options| node.terminate?(output, *inputs, **options) }
+            else
+              proc { false }
+            end
+        end
       end
     end
   end

data/lib/callable_tree/node/internal.rb

@@ -5,12 +5,13 @@ module CallableTree
     module Internal
       extend ::Forwardable
       include Node
+      include Strategizable
 
       def self.included(mod)
-        if mod.include?(External)
-          raise ::CallableTree::Error,
-                "#{mod} cannot include #{self} together with #{External}"
-        end
+        return unless mod.include?(External)
+
+        raise ::CallableTree::Error,
+              "#{mod} cannot include #{self} together with #{External}"
       end
 
       def_delegators :child_nodes, :[], :at
@@ -39,14 +40,14 @@ module CallableTree
         node = child_nodes.find(&block)
         return node if node
 
-        if recursive
-          child_nodes
-            .lazy
-            .select(&:internal?)
-            .map { |node| node.find(recursive: true, &block) }
-            .reject(&:nil?)
-            .first
-        end
+        return unless recursive
+
+        child_nodes
+          .lazy
+          .select(&:internal?)
+          .map { |node| node.find(recursive: true, &block) }
+          .reject(&:nil?) # rubocop:disable Style/CollectionCompact
+          .first
       end
 
       def reject(recursive: false, &block)
@@ -85,72 +86,6 @@ module CallableTree
         strategy.call(child_nodes, *inputs, **options)
       end
 
-      def seek?
-        strategy.is_a?(Strategy::Seek)
-      end
-
-      def seek(terminable: true)
-        if strategy == Strategy::Seek.new(terminable: terminable)
-          self
-        else
-          clone.seek!(terminable: terminable)
-        end
-      end
-
-      def seek!(terminable: true)
-        self.strategy = Strategy::Seek.new(terminable: terminable)
-
-        self
-      end
-
-      alias seekable? seek?
-      alias seekable seek
-      alias seekable! seek!
-
-      def broadcast?
-        strategy.is_a?(Strategy::Broadcast)
-      end
-
-      def broadcast(terminable: false)
-        if strategy == Strategy::Broadcast.new(terminable: terminable)
-          self
-        else
-          clone.broadcast!(terminable: terminable)
-        end
-      end
-
-      def broadcast!(terminable: false)
-        self.strategy = Strategy::Broadcast.new(terminable: terminable)
-
-        self
-      end
-
-      alias broadcastable? broadcast?
-      alias broadcastable broadcast
-      alias broadcastable! broadcast!
-
-      def compose?
-        strategy.is_a?(Strategy::Compose)
-      end
-
-      def compose(terminable: false)
-        if strategy == Strategy::Compose.new(terminable: terminable)
-          self
-        else
-          clone.compose!(terminable: terminable)
-        end
-      end
-
-      def compose!(terminable: false)
-        self.strategy = Strategy::Compose.new(terminable: terminable)
-
-        self
-      end
-
-      alias composable? compose?
-      alias composable compose
-      alias composable! compose!
-
       def outline(&block)
         key = block ? block.call(self) : identity
         value = child_nodes.reduce({}) { |memo, node| memo.merge!(node.outline(&block)) }
@@ -165,10 +100,6 @@ module CallableTree
         false
       end
 
-      protected
-
-      attr_writer :strategy
-
       def child_nodes
         @child_nodes ||= []
       end
@@ -186,10 +117,6 @@ module CallableTree
           .tap { |node| node.parent = self }
       end
 
-      def strategy
-        @strategy ||= Strategy::Seek.new
-      end
-
       def initialize_copy(_node)
         super
         self.parent = nil

data/lib/callable_tree/node.rb

@@ -13,7 +13,7 @@ module CallableTree
         node = self
         loop do
           y << node
-          break unless node = node.parent
+          break unless (node = node.parent)
         end
       end
     end

data/lib/callable_tree/version.rb

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

data/lib/callable_tree.rb

@@ -14,6 +14,7 @@ require_relative 'callable_tree/node/internal/strategy'
 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/internal/strategizable'
 require_relative 'callable_tree/node/external/verbose'
 require_relative 'callable_tree/node/external'
 require_relative 'callable_tree/node/internal'

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "4.0.0"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: callable_tree
 version: !ruby/object:Gem::Version
-  version: 0.3.9
+  version: 0.3.11
 platform: ruby
 authors:
 - jsmmr
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-11-06 00:00:00.000000000 Z
+date: 1980-01-02 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
@@ -25,10 +24,12 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
+- ".rubocop_todo.yml"
 - ".ruby-version"
+- AGENTS.md
 - CHANGELOG.md
+- CONTRIBUTING.md
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -64,21 +65,22 @@ files:
 - 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/strategizable.rb
 - lib/callable_tree/node/internal/strategy.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
+- mise.toml
 homepage: https://github.com/jsmmr/ruby_callable_tree
 licenses:
 - MIT
 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.9/CHANGELOG.md
+  changelog_uri: https://github.com/jsmmr/ruby_callable_tree/blob/v0.3.11/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -93,8 +95,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: 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

data/Gemfile.lock

@@ -1,34 +0,0 @@
-PATH
-  remote: .
-  specs:
-    callable_tree (0.3.9)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    diff-lcs (1.5.0)
-    rake (13.0.6)
-    rspec (3.11.0)
-      rspec-core (~> 3.11.0)
-      rspec-expectations (~> 3.11.0)
-      rspec-mocks (~> 3.11.0)
-    rspec-core (3.11.0)
-      rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-mocks (3.11.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-support (3.11.1)
-
-PLATFORMS
-  x86_64-darwin-21
-
-DEPENDENCIES
-  callable_tree!
-  rake (~> 13.0)
-  rspec (~> 3.0)
-
-BUNDLED WITH
-   2.3.7