tree_haver 3.1.1 → 3.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 141cf04a77bd50b8802a20eb098ddb03352b08fa6b1592b95180dcf336cc25e1
-  data.tar.gz: 134418492ecd86ef348221dfb7cef3f7c459acee00318c2669bdd666dc37d4ba
+  metadata.gz: 1f88732dc79b665917e925613ebeed944e011bb3ecb20248ebc940a48069fd41
+  data.tar.gz: '093f3bc6b818083e4205598dcef5782d2fb201e742464758c9c00f99ff3fba50'
 SHA512:
-  metadata.gz: bafe3a43549cecf6e38a3c8f68c4f072348050d2a3807c4ad8fa9ec2f1d073892abaf5b4300e750a2282849c1bdd081c9ef122b1f2dcb0c5044bddedb451c7b2
-  data.tar.gz: 62e7cd0947fdda50ea54f9e9a1b07a05c142388ef56a7a25a9ebb177f12804883cc3fc59dbfbbd3d5f08d062f59f89e850bb5d71733521344c53b5eec19ada78
+  metadata.gz: 2290e9e88865420ba8c39bb26af72e866797a5efeff30177b6c34d10d066014daf4e473f2a240647428d6d452bd0a46aa8828da5b2161723a37b286508c075c6
+  data.tar.gz: f31f3e85b30e4558cfbd7c6beb5307938c0a2aceb369b660bf16a3291beac095e5d2eb71291057c3ed49c280c56a85968d0d9bdb04b2d34406ec68c356372338

data/CHANGELOG.md

@@ -30,6 +30,25 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [3.1.2] - 2025-12-29
+
+- TAG: [v3.1.2][3.1.2t]
+- COVERAGE: 87.40% -- 2171/2484 lines in 22 files
+- BRANCH COVERAGE: 67.04% -- 726/1083 branches in 22 files
+- 90.03% documented
+
+### Added
+
+- Enhanced `TreeHaver::RSpec::DependencyTags` debugging
+  - `env_summary` method returns relevant environment variables for diagnosis
+  - `grammar_works?` now logs detailed trace when `TREE_HAVER_DEBUG=1`
+  - `before(:suite)` prints both env vars and dependency status when debugging
+  - Helps diagnose differences between local and CI environments
+- Many new specs for:
+  - TreeHaver::GrammarFinder
+  - TreeHaver::Node
+  - TreeHaver::Tree
+
 ## [3.1.1] - 2025-12-28
 
 - TAG: [v3.1.1][3.1.1t]
@@ -419,7 +438,9 @@ 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/v3.1.1...HEAD
+[Unreleased]: https://github.com/kettle-rb/tree_haver/compare/v3.1.2...HEAD
+[3.1.2]: https://github.com/kettle-rb/tree_haver/compare/v3.1.1...v3.1.2
+[3.1.2t]: https://github.com/kettle-rb/tree_haver/releases/tag/v3.1.2
 [3.1.1]: https://github.com/kettle-rb/tree_haver/compare/v3.1.0...v3.1.1
 [3.1.1t]: https://github.com/kettle-rb/tree_haver/releases/tag/v3.1.1
 [3.1.0]: https://github.com/kettle-rb/tree_haver/compare/v3.0.0...v3.1.0

data/README.md

@@ -1943,7 +1943,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.461-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-2.484-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/mri.rb

@@ -18,10 +18,20 @@ module TreeHaver
       #
       # Attempts to require ruby_tree_sitter on first call and caches the result.
       #
+      # @note When this method returns true, the FFI backend becomes permanently
+      #   unavailable for the remainder of the process. This is because loading
+      #   ruby_tree_sitter defines `::TreeSitter::Parser`, which the FFI backend
+      #   checks to detect conflicts. The MRI backend statically links tree-sitter,
+      #   while FFI dynamically links libtree-sitter.so - when both are loaded,
+      #   FFI will segfault when trying to set a language on a parser due to
+      #   incompatible pointer types from different tree-sitter builds.
+      #
       # @return [Boolean] true if ruby_tree_sitter is available
+      # @see TreeHaver::Backends::FFI.available? FFI availability check
       # @example
       #   if TreeHaver::Backends::MRI.available?
       #     puts "MRI backend is ready"
+      #     # Note: FFI backend is now blocked for this process
       #   end
       class << self
         def available?

data/lib/tree_haver/rspec/dependency_tags.rb

@@ -530,6 +530,21 @@ module TreeHaver
           }
         end
 
+        # Get environment variable summary for debugging
+        #
+        # @return [Hash{String => String}] relevant environment variables
+        def env_summary
+          {
+            "TREE_SITTER_BASH_PATH" => ENV["TREE_SITTER_BASH_PATH"],
+            "TREE_SITTER_TOML_PATH" => ENV["TREE_SITTER_TOML_PATH"],
+            "TREE_SITTER_JSON_PATH" => ENV["TREE_SITTER_JSON_PATH"],
+            "TREE_SITTER_JSONC_PATH" => ENV["TREE_SITTER_JSONC_PATH"],
+            "TREE_SITTER_RUNTIME_LIB" => ENV["TREE_SITTER_RUNTIME_LIB"],
+            "TREE_HAVER_BACKEND" => ENV["TREE_HAVER_BACKEND"],
+            "TREE_HAVER_DEBUG" => ENV["TREE_HAVER_DEBUG"],
+          }
+        end
+
         # Reset all memoized availability checks
         #
         # Useful in tests that need to re-check availability after mocking.
@@ -550,10 +565,37 @@ module TreeHaver
         # @param test_source [String] sample source code to parse
         # @return [Boolean] true if parsing works without errors
         def grammar_works?(language, test_source)
+          debug = ENV["TREE_HAVER_DEBUG"]
+          env_var = "TREE_SITTER_#{language.to_s.upcase}_PATH"
+          env_value = ENV[env_var]
+
+          if debug
+            puts "  [grammar_works? #{language}] ENV[#{env_var}] = #{env_value.inspect}"
+            puts "  [grammar_works? #{language}] Attempting TreeHaver.parser_for(#{language.inspect})..."
+          end
+
           parser = TreeHaver.parser_for(language)
+          if debug
+            puts "  [grammar_works? #{language}] Parser created: #{parser.class}"
+            puts "  [grammar_works? #{language}] Parser backend: #{parser.respond_to?(:backend) ? parser.backend : "unknown"}"
+          end
+
           result = parser.parse(test_source)
-          !result.nil? && result.root_node && !result.root_node.has_error?
-        rescue TreeHaver::NotAvailable, TreeHaver::Error, StandardError
+          success = !result.nil? && result.root_node && !result.root_node.has_error?
+
+          if debug
+            puts "  [grammar_works? #{language}] Parse result nil?: #{result.nil?}"
+            puts "  [grammar_works? #{language}] Root node: #{result&.root_node&.class}"
+            puts "  [grammar_works? #{language}] Has error?: #{result&.root_node&.has_error?}"
+            puts "  [grammar_works? #{language}] Success: #{success}"
+          end
+
+          success
+        rescue TreeHaver::NotAvailable, TreeHaver::Error, StandardError => e
+          if debug
+            puts "  [grammar_works? #{language}] Exception: #{e.class}: #{e.message}"
+            puts "  [grammar_works? #{language}] Returning false"
+          end
           false
         end
 
@@ -586,6 +628,11 @@ RSpec.configure do |config|
   config.before(:suite) do
     # Print dependency summary if TREE_HAVER_DEBUG is set
     if ENV["TREE_HAVER_DEBUG"]
+      puts "\n=== TreeHaver Environment Variables ==="
+      deps.env_summary.each do |var, value|
+        puts "  #{var}: #{value.inspect}"
+      end
+
       puts "\n=== TreeHaver Test Dependencies ==="
       deps.summary.each do |dep, available|
         status = case available

data/lib/tree_haver/version.rb

@@ -10,7 +10,7 @@ module TreeHaver
     # Current version of the tree_haver gem
     #
     # @return [String] the version string (e.g., "3.0.0")
-    VERSION = "3.1.1"
+    VERSION = "3.1.2"
   end
 
   # Traditional location for VERSION constant

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tree_haver
 version: !ruby/object:Gem::Version
-  version: 3.1.1
+  version: 3.1.2
 platform: ruby
 authors:
 - Peter H. Boling
@@ -289,10 +289,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://tree-haver.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/tree_haver/tree/v3.1.1
-  changelog_uri: https://github.com/kettle-rb/tree_haver/blob/v3.1.1/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/tree_haver/tree/v3.1.2
+  changelog_uri: https://github.com/kettle-rb/tree_haver/blob/v3.1.2/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/tree_haver/issues
-  documentation_uri: https://www.rubydoc.info/gems/tree_haver/3.1.1
+  documentation_uri: https://www.rubydoc.info/gems/tree_haver/3.1.2
   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