tree_haver v4.0.5 released!

🏷️ release

tree_haver 🏷️ v4.0.5

4.0.5 - 2026-01-09

FFI Backend: Added child_by_field_name method to TreeHaver::Backends::FFI::Node
- Enables field-based child access using tree-sitter’s ts_node_child_by_field_name C API
- Works with all grammars (JSON, JSONC, TOML, Bash, etc.) that define field names
- Fixes compatibility issues with json-merge, jsonc-merge, and other gems that use field access
- Example: pair.child_by_field_name("key") returns the key node from a JSON pair
RSpec Dependency Tags: Added compute_blocked_backends method
- Determines blocked backends from TREE_HAVER_BACKEND env and ARGV --tag options
- Called by summary when @blocked_backends isn’t set yet (before RSpec.configure runs)
- Fixes issue where gem-specific before(:suite) hooks could load blocked backends
RSpec Dependency Tags: Added LD_LIBRARY_PATH and DYLD_LIBRARY_PATH to env_summary
- These library paths are relevant for tree-sitter shared library loading
- Useful for debugging grammar loading issues
RSpec Dependency Tags: Added TREE_SITTER_RBS_PATH to env_summary

Language#method_missing: Simplified error handling in Language#method_missing
- Removed unreachable rescue block for FFI::NotFoundError
- FFI::NotFoundError inherits from LoadError, so it’s already caught by the prior rescue clause
- Reduces code complexity without changing behavior
Parser#initialize: Simplified error handling in Parser#initialize
- Same fix as Language - removed unreachable FFI::NotFoundError handling
- Added comment noting that FFI::NotFoundError inherits from LoadError
FFI Backend Native#try_load!: Removed redundant FFI::NotFoundError from rescue clause
- Only rescues LoadError now with comment explaining inheritance
GrammarFinder.tree_sitter_runtime_usable?: Removed redundant StandardError rescue clause
- LoadError already catches FFI::NotFoundError
- Added comment explaining the inheritance relationship

Test Isolation: Fixed state leakage in language_registry_spec.rb
- Tests were registering real language names (:toml, :json, :yaml) with fake paths
- These registrations persisted and polluted other tests that expected real grammar paths
- Changed all tests to use unique test-only language names (prefixed with test_lang_)
- Fixes 2 spec failures when running all tests together (TreeHaver::Tree#edit specs)

Official Discord 👉️

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