tree_haver 3.2.6 → 4.0.0

data/lib/tree_haver/rspec/dependency_tags.rb

@@ -531,18 +531,22 @@ module TreeHaver
 
         # Check if commonmarker gem is available
         #
+        # Uses BackendRegistry which allows commonmarker-merge to register its checker.
+        #
         # @return [Boolean] true if commonmarker gem is available
         def commonmarker_available?
           return @commonmarker_available if defined?(@commonmarker_available)
-          @commonmarker_available = TreeHaver::Backends::Commonmarker.available?
+          @commonmarker_available = TreeHaver::BackendRegistry.available?(:commonmarker)
         end
 
         # Check if markly gem is available
         #
+        # Uses BackendRegistry which allows markly-merge to register its checker.
+        #
         # @return [Boolean] true if markly gem is available
         def markly_available?
           return @markly_available if defined?(@markly_available)
-          @markly_available = TreeHaver::Backends::Markly.available?
+          @markly_available = TreeHaver::BackendRegistry.available?(:markly)
         end
 
         # Check if prism gem is available
@@ -550,7 +554,7 @@ module TreeHaver
         # @return [Boolean] true if Prism is available
         def prism_available?
           return @prism_available if defined?(@prism_available)
-          @prism_available = TreeHaver::Backends::Prism.available?
+          @prism_available = TreeHaver::BackendRegistry.available?(:prism)
         end
 
         # Check if psych is available (stdlib, should always be true)
@@ -558,7 +562,7 @@ module TreeHaver
         # @return [Boolean] true if Psych is available
         def psych_available?
           return @psych_available if defined?(@psych_available)
-          @psych_available = TreeHaver::Backends::Psych.available?
+          @psych_available = TreeHaver::BackendRegistry.available?(:psych)
         end
 
         # Check if Citrus backend is available
@@ -568,7 +572,7 @@ module TreeHaver
         # @return [Boolean] true if Citrus backend is available
         def citrus_available?
           return @citrus_available if defined?(@citrus_available)
-          @citrus_available = TreeHaver::Backends::Citrus.available?
+          @citrus_available = TreeHaver::BackendRegistry.available?(:citrus)
         end
 
         # ============================================================

data/lib/tree_haver/tree.rb

@@ -52,7 +52,7 @@ module TreeHaver
   #
   #   # Or explicitly via inner_tree
   #   tree.inner_tree.some_backend_specific_method
-  class Tree
+  class Tree < Base::Tree
     # The wrapped backend-specific tree object
     #
     # This provides direct access to the underlying backend tree for advanced usage
@@ -66,20 +66,19 @@ module TreeHaver
     #       tree.inner_tree.print_dot_graph(f)
     #     end
     #   end
-    attr_reader :inner_tree
+    # NOTE: inner_tree is inherited from Base::Tree
 
     # The source text
     #
     # Stored to enable text extraction from nodes via byte offsets.
     #
     # @return [String] The original source code
-    attr_reader :source
+    # NOTE: source is inherited from Base::Tree
 
     # @param tree [Object] Backend-specific tree object
     # @param source [String] Source text for node text extraction
     def initialize(tree, source: nil)
-      @inner_tree = tree
-      @source = source
+      super(tree, source: source)
     end
 
     # Get the root node of the tree

data/lib/tree_haver/version.rb

@@ -9,8 +9,8 @@ module TreeHaver
   module Version
     # Current version of the tree_haver gem
     #
-    # @return [String] the version string (e.g., "3.0.0")
-    VERSION = "3.2.6"
+    # @return [String] the version string
+    VERSION = "4.0.0"
   end
 
   # Traditional location for VERSION constant

data/lib/tree_haver.rb

@@ -109,6 +109,10 @@ module TreeHaver
   autoload :LibraryPathUtils, File.join(__dir__, "tree_haver", "library_path_utils")
   autoload :LanguageRegistry, File.join(__dir__, "tree_haver", "language_registry")
   autoload :BackendAPI, File.join(__dir__, "tree_haver", "backend_api")
+  autoload :BackendRegistry, File.join(__dir__, "tree_haver", "backend_registry")
+
+  # Base classes for backend implementations
+  autoload :Base, File.join(__dir__, "tree_haver", "base")
 
   # Base error class for TreeHaver exceptions
   # @see https://github.com/Faveod/ruby-tree-sitter/pull/83 for inherit from Exception reasoning
@@ -181,8 +185,6 @@ module TreeHaver
   # - {Backends::Citrus} - Uses Citrus PEG parser (pure Ruby, portable)
   # - {Backends::Prism} - Uses Ruby's built-in Prism parser (Ruby-only, stdlib in 3.4+)
   # - {Backends::Psych} - Uses Ruby's built-in Psych parser (YAML-only, stdlib)
-  # - {Backends::Commonmarker} - Uses commonmarker gem (Markdown)
-  # - {Backends::Markly} - Uses markly gem (Markdown/GFM)
   module Backends
     autoload :MRI, File.join(__dir__, "tree_haver", "backends", "mri")
     autoload :Rust, File.join(__dir__, "tree_haver", "backends", "rust")
@@ -191,11 +193,7 @@ module TreeHaver
     autoload :Citrus, File.join(__dir__, "tree_haver", "backends", "citrus")
     autoload :Prism, File.join(__dir__, "tree_haver", "backends", "prism")
     autoload :Psych, File.join(__dir__, "tree_haver", "backends", "psych")
-    autoload :Commonmarker, File.join(__dir__, "tree_haver", "backends", "commonmarker")
-    autoload :Markly, File.join(__dir__, "tree_haver", "backends", "markly")
 
-    # Known backend conflicts
-    #
     # Maps each backend to an array of backends that block it from working.
     # For example, :ffi is blocked by :mri because once ruby_tree_sitter loads,
     # FFI calls to ts_parser_set_language will segfault.
@@ -209,8 +207,6 @@ module TreeHaver
       citrus: [],
       prism: [],        # Prism has no conflicts with other backends
       psych: [],        # Psych has no conflicts with other backends
-      commonmarker: [], # Commonmarker has no conflicts with other backends
-      markly: [],       # Markly has no conflicts with other backends
     }.freeze
 
     # Pure Ruby backends that parse specific languages
@@ -220,8 +216,6 @@ module TreeHaver
     PURE_RUBY_BACKENDS = {
       prism: {language: :ruby, module_name: "Prism"},
       psych: {language: :yaml, module_name: "Psych"},
-      commonmarker: {language: :markdown, module_name: "Commonmarker"},
-      markly: {language: :markdown, module_name: "Markly"},
     }.freeze
   end
 
@@ -744,13 +738,13 @@ module TreeHaver
         Backends::Prism
       when :psych
         Backends::Psych
-      when :commonmarker
-        Backends::Commonmarker
-      when :markly
-        Backends::Markly
       when :auto
         backend_module  # Fall back to normal resolution for :auto
       else
+        # Check if this is a registered plugin backend
+        registered = registered_backend(requested)
+        return registered if registered
+
         # Unknown backend name - return nil to trigger error in caller
         nil
       end
@@ -885,10 +879,6 @@ module TreeHaver
         Backends::Prism
       when :psych
         Backends::Psych
-      when :commonmarker
-        Backends::Commonmarker
-      when :markly
-        Backends::Markly
       else
         # auto-select: prefer native/fast backends, fall back to pure Ruby (Citrus)
         # Each backend must be both allowed (by ENV) and available (gem installed)
@@ -1049,6 +1039,28 @@ module TreeHaver
       nil
     end
 
+    # Register a backend module
+    #
+    # Allows external gems to register their backend implementation so it can be
+    # found by TreeHaver.backend = :name and other lookup methods.
+    #
+    # @param name [Symbol] backend name (e.g. :rbs, :commonmarker)
+    # @param mod [Module] the backend module
+    # @return [void]
+    def register_backend(name, mod)
+      @backend_registry ||= {}
+      @backend_registry[name.to_sym] = mod
+    end
+
+    # Get a registered backend module
+    #
+    # @param name [Symbol] backend name
+    # @return [Module, nil] registered backend module
+    def registered_backend(name)
+      @backend_registry ||= {}
+      @backend_registry[name.to_sym]
+    end
+
     # Fetch a registered language entry
     #
     # @api private

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tree_haver
 version: !ruby/object:Gem::Version
-  version: 3.2.6
+  version: 4.0.0
 platform: ruby
 authors:
 - Peter H. Boling
@@ -261,15 +261,20 @@ files:
 - SECURITY.md
 - lib/tree_haver.rb
 - lib/tree_haver/backend_api.rb
+- lib/tree_haver/backend_registry.rb
 - lib/tree_haver/backends/citrus.rb
-- lib/tree_haver/backends/commonmarker.rb
 - lib/tree_haver/backends/ffi.rb
 - lib/tree_haver/backends/java.rb
-- lib/tree_haver/backends/markly.rb
 - lib/tree_haver/backends/mri.rb
 - lib/tree_haver/backends/prism.rb
 - lib/tree_haver/backends/psych.rb
 - lib/tree_haver/backends/rust.rb
+- lib/tree_haver/base.rb
+- lib/tree_haver/base/language.rb
+- lib/tree_haver/base/node.rb
+- lib/tree_haver/base/parser.rb
+- lib/tree_haver/base/point.rb
+- lib/tree_haver/base/tree.rb
 - lib/tree_haver/citrus_grammar_finder.rb
 - lib/tree_haver/compat.rb
 - lib/tree_haver/grammar_finder.rb
@@ -293,10 +298,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://tree-haver.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/tree_haver/tree/v3.2.6
-  changelog_uri: https://github.com/kettle-rb/tree_haver/blob/v3.2.6/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/tree_haver/tree/v4.0.0
+  changelog_uri: https://github.com/kettle-rb/tree_haver/blob/v4.0.0/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/tree_haver/issues
-  documentation_uri: https://www.rubydoc.info/gems/tree_haver/3.2.6
+  documentation_uri: https://www.rubydoc.info/gems/tree_haver/4.0.0
   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