tree_haver 4.0.1 → 4.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 872ceb8aab416345826221f841d8cc79037a4d270fd9b556ef57cbcf9d702f7a
-  data.tar.gz: edcb75fd0ddb051e6be4ad9c1eed410b2aa3cd14f0595bc8fd20679c07f1eed7
+  metadata.gz: 16ff994e79a2627158244ff89554d062a5feacb3f3c6605545c8dfbf86dac3d0
+  data.tar.gz: 66250d72daf7a7617ef9fa610a43253b84836658e6112b9bf276d3edc91ba4a3
 SHA512:
-  metadata.gz: 00fbca360e93a8cd116e83c35678e3d3e6010c744984ef230a24d82b82e964687202b46aa30d39b5c04606e8581ed06158a63c71a30b6c59f6ab0f0566f99277
-  data.tar.gz: a261ba76e4ee22673ba34c4c599b8567913146d7fd3eb96c5fd854c9b8c2efda13afeb6e2c37a69a0a810b37e3bdf65697a7e9a55849e7fa6b9464c8cd40940f
+  metadata.gz: 80b3aff0e492dbdc1fcfc23fce6ab05a514b6fdc75630e822267c93bf232d638550340813abac8f23f1602516b63a800093e82ae95a573160fcaf2fde089ea18
+  data.tar.gz: 4a168f874d4e455e4db82e6786abeef2fc7c1b6007d3cc101fcce1aa0eea6b91c656a32cafb73da9fda1c7830e6397f6a7441ef7ffc4340f2e1254b183afda28

data/CHANGELOG.md

@@ -30,6 +30,50 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [4.0.3] - 2026-01-08
+
+- TAG: [v4.0.3][4.0.3t]
+- COVERAGE: 95.27% -- 2033/2134 lines in 28 files
+- BRANCH COVERAGE: 84.17% -- 803/954 branches in 28 files
+- 95.49% documented
+
+### Changed
+
+- **RSpec Dependency Tags**: Refactored FFI backend isolation to use standard `:ffi_backend` tag
+  - The `--tag ffi_backend` now triggers `isolated_test_mode` in `dependency_tags.rb`
+  - This prevents MRI backend from loading during availability checks
+  - Legacy `*_backend_only` tags are still supported for backwards compatibility
+  - Simplifies the testing pattern: one tag serves as both dependency tag and isolation trigger
+
+### Deprecated
+
+- **`:ffi_backend_only` tag**: Use `:ffi_backend` instead. The `*_backend_only` tags are now redundant.
+
+## [4.0.2] - 2026-01-08
+
+- TAG: [v4.0.2][4.0.2t]
+- COVERAGE: 95.27% -- 2033/2134 lines in 28 files
+- BRANCH COVERAGE: 84.07% -- 802/954 branches in 28 files
+- 95.49% documented
+
+### Added
+
+- **FFI Backend**: Implemented `missing?` method on `TreeHaver::Backends::FFI::Node`
+  - Added `ts_node_is_missing` FFI function attachment
+  - This method was missing entirely, causing `NoMethodError` when checking for MISSING nodes
+
+### Changed
+
+- **TreeHaver::Node**: Removed defensive `respond_to?` checks from `has_error?` and `missing?` methods
+  - All tree-sitter backends (MRI, Rust, FFI, Java) must implement these methods on their inner nodes
+  - This enforces proper backend API compliance rather than silently masking missing implementations
+
+### Fixed
+
+- **FFI Backend**: Added explicit boolean conversion (`!!`) to `has_error?` return value
+  - FFI `:bool` return type may behave inconsistently across Ruby versions and platforms
+  - Ensures `has_error?` always returns `true` or `false`, not truthy/falsy values
+
 ## [4.0.1] - 2026-01-08
 
 - TAG: [v4.0.1][4.0.1t]
@@ -965,7 +1009,11 @@ Despite the major version bump to 3.0.0 (following semver due to the breaking `L
 
 - Initial release
 
-[Unreleased]: https://github.com/kettle-rb/tree_haver/compare/v4.0.1...HEAD
+[Unreleased]: https://github.com/kettle-rb/tree_haver/compare/v4.0.3...HEAD
+[4.0.3]: https://github.com/kettle-rb/tree_haver/compare/v4.0.2...v4.0.3
+[4.0.3t]: https://github.com/kettle-rb/tree_haver/releases/tag/v4.0.3
+[4.0.2]: https://github.com/kettle-rb/tree_haver/compare/v4.0.1...v4.0.2
+[4.0.2t]: https://github.com/kettle-rb/tree_haver/releases/tag/v4.0.2
 [4.0.1]: https://github.com/kettle-rb/tree_haver/compare/v4.0.0...v4.0.1
 [4.0.1t]: https://github.com/kettle-rb/tree_haver/releases/tag/v4.0.1
 [4.0.0]: https://github.com/kettle-rb/tree_haver/compare/v3.2.6...v4.0.0

data/README.md

@@ -2182,7 +2182,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-2.132-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-2.134-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year

data/lib/tree_haver/backends/ffi.rb

@@ -273,6 +273,7 @@ module TreeHaver
             attach_function(:ts_node_end_point, [:ts_node], :ts_point)
             attach_function(:ts_node_is_null, [:ts_node], :bool)
             attach_function(:ts_node_is_named, [:ts_node], :bool)
+            attach_function(:ts_node_is_missing, [:ts_node], :bool)
             attach_function(:ts_node_has_error, [:ts_node], :bool)
 
             # Only mark as fully loaded after all attach_function calls succeed
@@ -701,7 +702,20 @@ module TreeHaver
         #
         # @return [Boolean] true if node subtree contains errors
         def has_error?
-          Native.ts_node_has_error(@val)
+          # Explicit boolean conversion ensures consistent behavior across Ruby versions
+          # FFI :bool return type may behave differently on some platforms
+          !!Native.ts_node_has_error(@val)
+        end
+
+        # Check if this is a MISSING node
+        #
+        # A MISSING node represents a token that was expected by the grammar
+        # but was not found in the source. Tree-sitter inserts MISSING nodes
+        # to allow parsing to continue despite syntax errors.
+        #
+        # @return [Boolean] true if this is a MISSING node
+        def missing?
+          !!Native.ts_node_is_missing(@val)
         end
 
         # Iterate over child nodes

data/lib/tree_haver/node.rb

@@ -263,7 +263,6 @@ module TreeHaver
     # Check if the node is missing
     # @return [Boolean]
     def missing?
-      return false unless @inner_node.respond_to?(:missing?)
       @inner_node.missing?
     end
 

data/lib/tree_haver/rspec/dependency_tags.rb

@@ -346,11 +346,13 @@ module TreeHaver
 
         # Check if FFI backend is available WITHOUT loading MRI first
         #
-        # This is used for the :ffi_backend_only tag which runs FFI tests
-        # in isolation before MRI can be loaded. Unlike ffi_available?,
-        # this method does NOT check mri_backend_available?.
+        # This method is primarily for backwards compatibility with the legacy
+        # :ffi_backend_only tag. The preferred approach is to use the standard
+        # :ffi_backend tag, which now also triggers isolated_test_mode when
+        # used with --tag ffi_backend.
         #
         # @return [Boolean] true if FFI backend is usable in isolation
+        # @deprecated Use :ffi_backend tag instead of :ffi_backend_only
         def ffi_backend_only_available?
           # If TREE_HAVER_BACKEND explicitly selects a different native backend,
           # FFI is not available for testing
@@ -1044,14 +1046,25 @@ RSpec.configure do |config|
     end
   end
 
+  # Check if we're running isolated backend tests using standard backend tags
+  # When running with --tag ffi_backend (or other native backend tags), we need
+  # to block conflicting backends to prevent them from loading first.
+  # This replaces the old *_backend_only pattern with the standard *_backend tags.
   TreeHaver::Backends::BLOCKED_BY.each do |backend, blockers|
-    # Check if we're running this backend's isolated tests
-    isolated_tag = :"#{backend}_backend_only"
-    if inclusion_rules[isolated_tag]
+    # Check if we're running this backend's tests using standard tag (e.g., :ffi_backend)
+    standard_tag = :"#{backend}_backend"
+    if inclusion_rules[standard_tag]
       isolated_test_mode = true
       # Add all backends that would block this one
       blockers.each { |blocker| blocked_backends << blocker }
     end
+
+    # Also support legacy *_backend_only tags for backwards compatibility
+    legacy_tag = :"#{backend}_backend_only"
+    if inclusion_rules[legacy_tag]
+      isolated_test_mode = true
+      blockers.each { |blocker| blocked_backends << blocker }
+    end
   end
 
   # Store blocked_backends in a module variable so before(:suite) can access it

data/lib/tree_haver/version.rb

@@ -10,7 +10,7 @@ module TreeHaver
     # Current version of the tree_haver gem
     #
     # @return [String] the version string
-    VERSION = "4.0.1"
+    VERSION = "4.0.3"
   end
 
   # Traditional location for VERSION constant

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tree_haver
 version: !ruby/object:Gem::Version
-  version: 4.0.1
+  version: 4.0.3
 platform: ruby
 authors:
 - Peter H. Boling
@@ -298,10 +298,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://tree-haver.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/tree_haver/tree/v4.0.1
-  changelog_uri: https://github.com/kettle-rb/tree_haver/blob/v4.0.1/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/tree_haver/tree/v4.0.3
+  changelog_uri: https://github.com/kettle-rb/tree_haver/blob/v4.0.3/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/tree_haver/issues
-  documentation_uri: https://www.rubydoc.info/gems/tree_haver/4.0.1
+  documentation_uri: https://www.rubydoc.info/gems/tree_haver/4.0.3
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/tree_haver/wiki
   news_uri: https://www.railsbling.com/tags/tree_haver