tree_haver v2.0.0 released!

🏷️ release tree_haver 🏷️ v2.0.0

2.0.0 - 2025-12-15

• TAG: v2.0.0
• COVERAGE: 82.78% – 601/726 lines in 11 files
• BRANCH COVERAGE: 70.45% – 186/264 branches in 11 files
• 91.90% documented

Added

• Added support for Citrus backend (backends/citrus.rb) - a pure Ruby grammar parser with its own distinct grammar structure
• Added TreeHaver::Tree unified wrapper class providing consistent API across all backends
• Added TreeHaver::Node unified wrapper class providing consistent API across all backends
• Added TreeHaver::Point class that works as both object and hash for position compatibility
• Added passthrough mechanism via method_missing for accessing backend-specific features
• Added inner_node accessor on TreeHaver::Node for advanced backend-specific usage
• Added inner_tree accessor on TreeHaver::Tree for advanced backend-specific usage
• Added comprehensive test suite for TreeHaver::Node wrapper class (88 examples)
• Added comprehensive test suite for TreeHaver::Tree wrapper class (17 examples)
• Added comprehensive test suite for TreeHaver::Parser class (12 examples)
• Added complete test coverage for Citrus backend (41 examples)
• Enhanced TreeHaver::Language tests for dynamic language helpers

Changed

• BREAKING: All backends now return TreeHaver::Tree from Parser#parse and Parser#parse_string
• BREAKING: TreeHaver::Tree#root_node now returns TreeHaver::Node instead of backend-specific node
• BREAKING: All child/sibling/parent methods on nodes now return TreeHaver::Node wrappers
• Updated MRI backend (backends/mri.rb) to return wrapped TreeHaver::Tree with source
• Updated Rust backend (backends/rust.rb) to return wrapped TreeHaver::Tree with source
• Updated FFI backend (backends/ffi.rb) to return wrapped TreeHaver::Tree with source
• Updated Java backend (backends/java.rb) to return wrapped TreeHaver::Tree with source
• Updated Citrus backend (backends/citrus.rb) to return wrapped TreeHaver::Tree with source
• Disabled old pass-through stub classes in tree_haver.rb (wrapped in if false for reference)

Fixed

• Fixed TreeHaver::Tree#supports_editing? and #edit to handle Delegator wrappers correctly by using .method(:edit) check instead of respond_to?
• Fixed PathValidator to accept versioned .so files (e.g., .so.0, .so.14) which are standard on Linux systems
• Fixed backend portability - code now works identically across MRI, Rust, FFI, Java, and Citrus backends
• Fixed inconsistent API - node.type now works on all backends (was node.kind on TreeStump)
• Fixed position objects - start_point and end_point now return objects that work as both .row and [:row]
• Fixed child iteration - node.each and node.children now consistently return TreeHaver::Node objects
• Fixed text extraction - node.text now works consistently by storing source in TreeHaver::Tree

Official Discord 👉️

Many paths lead to being a sponsor or a backer of this project. Are you on such a path?