rbtr-lang-ruby 2026.9.0.dev1__tar.gz

rbtr_lang_ruby-2026.9.0.dev1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alejandro Giacometti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rbtr_lang_ruby-2026.9.0.dev1/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: rbtr-lang-ruby
+Version: 2026.9.0.dev1
+Summary: rbtr — Ruby language plugin
+Keywords: code-search,code-index,tree-sitter,static-analysis,semantic-search,developer-tools,ruby
+Author: Alejandro Giacometti
+Author-email: Alejandro Giacometti <alejandro.giacometti@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Ruby
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Text Processing :: Indexing
+Classifier: Typing :: Typed
+Requires-Dist: rbtr==2026.9.0.dev1
+Requires-Dist: tree-sitter-ruby
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/janrito/rbtr
+Project-URL: Repository, https://github.com/janrito/rbtr
+Project-URL: Documentation, https://github.com/janrito/rbtr/tree/main/packages/rbtr-lang-ruby#readme
+Project-URL: Issues, https://github.com/janrito/rbtr/issues
+Project-URL: Changelog, https://github.com/janrito/rbtr/releases
+Description-Content-Type: text/markdown
+
+# rbtr-lang-ruby
+
+Ruby support for [rbtr]. Optional plugin — install with
+`pip install rbtr[ruby]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+- **Functions & methods** — `def` (a method inside a class/module is scoped
+  to it; top-level `def` is a function).
+- **Classes** — `class` and `module` definitions (a module also scopes its
+  members).
+- **Variables** — constants and module-level assignments.
+- **Imports** — `require` and `require_relative`, for cross-file edges.
+
+Leading `#` doc comments fold into the symbol's content.
+
+## Chunks produced
+
+```ruby
+def greet(name); …; end          # function "greet"
+class User                       # class "User"
+  def save; …; end               #   method "save", scope "User"
+end
+MAX = 100                        # variable "MAX"
+require_relative "config"        # import, metadata {module: config}
+```
+
+## Embedded / injected chunks
+
+None. Ruby does not embed other languages.
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-ruby` grammar. No dependency on other language plugins.

rbtr_lang_ruby-2026.9.0.dev1/README.md

@@ -0,0 +1,36 @@
+# rbtr-lang-ruby
+
+Ruby support for [rbtr]. Optional plugin — install with
+`pip install rbtr[ruby]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+- **Functions & methods** — `def` (a method inside a class/module is scoped
+  to it; top-level `def` is a function).
+- **Classes** — `class` and `module` definitions (a module also scopes its
+  members).
+- **Variables** — constants and module-level assignments.
+- **Imports** — `require` and `require_relative`, for cross-file edges.
+
+Leading `#` doc comments fold into the symbol's content.
+
+## Chunks produced
+
+```ruby
+def greet(name); …; end          # function "greet"
+class User                       # class "User"
+  def save; …; end               #   method "save", scope "User"
+end
+MAX = 100                        # variable "MAX"
+require_relative "config"        # import, metadata {module: config}
+```
+
+## Embedded / injected chunks
+
+None. Ruby does not embed other languages.
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-ruby` grammar. No dependency on other language plugins.

rbtr_lang_ruby-2026.9.0.dev1/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["uv_build>=0.11.26,<1"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "rbtr_lang_ruby"
+
+[tool.uv.sources.rbtr]
+workspace = true
+
+[project]
+name = "rbtr-lang-ruby"
+version = "2026.9.0-dev1"
+description = "rbtr — Ruby language plugin"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "code-search",
+    "code-index",
+    "tree-sitter",
+    "static-analysis",
+    "semantic-search",
+    "developer-tools",
+    "ruby",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Ruby",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Text Processing :: Indexing",
+    "Typing :: Typed",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "rbtr==2026.9.0-dev1",
+    "tree-sitter-ruby",
+]
+
+[[project.authors]]
+name = "Alejandro Giacometti"
+email = "alejandro.giacometti@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/janrito/rbtr"
+Repository = "https://github.com/janrito/rbtr"
+Documentation = "https://github.com/janrito/rbtr/tree/main/packages/rbtr-lang-ruby#readme"
+Issues = "https://github.com/janrito/rbtr/issues"
+Changelog = "https://github.com/janrito/rbtr/releases"
+
+[project.entry-points."rbtr.languages"]
+ruby = "rbtr_lang_ruby.plugin:ruby"
+
+[dependency-groups]
+dev = ["rbtr[test]"]

rbtr_lang_ruby-2026.9.0.dev1/pyproject.toml.orig

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["uv_build>=0.11.26,<1"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "rbtr_lang_ruby"
+# No source-exclude: the plugin's tests, samples, and snapshots ship with
+# the wheel (they are the language's golden record), and ruby.scm ships as
+# package data.
+
+[project]
+name = "rbtr-lang-ruby"
+version = "2026.9.0-dev1"
+description = "rbtr — Ruby language plugin"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "Alejandro Giacometti", email = "alejandro.giacometti@gmail.com" },
+]
+keywords = [
+  "code-search",
+  "code-index",
+  "tree-sitter",
+  "static-analysis",
+  "semantic-search",
+  "developer-tools",
+  "ruby",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Ruby",
+  "Topic :: Software Development :: Libraries",
+  "Topic :: Text Processing :: Indexing",
+  "Typing :: Typed",
+]
+requires-python = ">=3.13"
+dependencies = [
+  "rbtr==2026.9.0-dev1",
+  "tree-sitter-ruby",
+]
+
+[project.urls]
+Homepage = "https://github.com/janrito/rbtr"
+Repository = "https://github.com/janrito/rbtr"
+Documentation = "https://github.com/janrito/rbtr/tree/main/packages/rbtr-lang-ruby#readme"
+Issues = "https://github.com/janrito/rbtr/issues"
+Changelog = "https://github.com/janrito/rbtr/releases"
+
+[project.entry-points."rbtr.languages"]
+# The value resolves to the language's `LanguageRegistration` (named by its
+# id) — see the rbtr ARCHITECTURE "External plugins" note.
+ruby = "rbtr_lang_ruby.plugin:ruby"
+
+[tool.uv.sources]
+rbtr = { workspace = true }
+
+[dependency-groups]
+dev = ["rbtr[test]"]

rbtr_lang_ruby-2026.9.0.dev1/src/rbtr_lang_ruby/__init__.py

@@ -0,0 +1 @@
+"""Ruby language plugin package."""

rbtr_lang_ruby-2026.9.0.dev1/src/rbtr_lang_ruby/plugin.py

@@ -0,0 +1,97 @@
+"""Ruby language plugin.
+
+Provides symbol extraction (methods, classes, modules, constants,
+and the RSpec `describe`/`context`/`it` DSL) and structured import
+metadata from `require` / `require_relative`.  Constants scope to
+their enclosing class/module.  RSpec groups (`describe`/`context`/
+`feature`) are classes and examples (`it`/`specify`/`example`) are
+functions, named by their description string.
+
+Extracted chunks::
+
+    def greet ... end               → function "greet", scope ""
+    class Shape ... end             → class "Shape", scope ""
+    module Utils ... end            → class "Utils", scope ""
+    class Foo
+      def bar ... end               → method "bar", scope "Foo"
+    end
+
+    require "json"
+        → import, metadata {module: "json"}
+    require_relative "helpers"
+        → import, metadata {module: "helpers", dots: "1"}
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from rbtr.domain.models import ImportMeta
+from rbtr.languages.registration import (
+    ImportResolver,
+    LanguageRegistration,
+    QueryExtraction,
+    load_query,
+    parse_path_relative,
+)
+
+if TYPE_CHECKING:
+    from tree_sitter import Node
+
+# ── Query ────────────────────────────────────────────────────────────
+
+
+# ── Import extractor ─────────────────────────────────────────────────
+
+
+def extract_import_meta(
+    resolver: ImportResolver, node: Node, captures: dict[str, list[Node]]
+) -> ImportMeta:
+    """Extract import data from a Ruby `require` / `require_relative` node.
+
+    Reads `@_import_module` from captures (the query captures
+    the string argument), then sets `dots` for
+    `require_relative` (always relative to the current file).
+
+    Examples:
+
+        `require "json"`:
+            module="json"
+
+        `require_relative "helpers"`:
+            module="helpers", dots="1"
+
+        `require_relative "./config"`:
+            module="config", dots="1"
+
+        `require_relative "../lib/utils"`:
+            module="lib/utils", dots="2"
+    """
+    meta = resolver(node, captures)
+    method = node.child_by_field_name("method")
+    if method and method.text == b"require_relative":
+        # `require_relative` is always relative to the current file. Strip any
+        # `./`/`../` prefix into `dots` (a bare path is the current dir, dots=1)
+        # so the resolver doesn't see a leftover `./` it can't match.
+        dots, cleaned = parse_path_relative(meta.module)
+        meta.module = cleaned
+        meta.dots = str(dots or 1)
+    return meta
+
+
+# ── Plugin ───────────────────────────────────────────────────────────
+
+
+ruby = LanguageRegistration(
+    id="ruby",
+    extensions=frozenset({".rb"}),
+    grammar_module="tree_sitter_ruby",
+    extraction=QueryExtraction(
+        query=load_query(__package__, "ruby"),
+        scope_types=frozenset({"class", "module"}),
+    ),
+    source_roots=("", "lib"),
+    extraction_serial=5,
+)
+
+ruby.import_extractor(extract_import_meta)

rbtr_lang_ruby-2026.9.0.dev1/src/rbtr_lang_ruby/ruby.scm

@@ -0,0 +1,51 @@
+
+; Comments (Ruby: `#` line and `=begin`/`=end` block, both `comment`).
+(comment) @comment
+
+(method
+  name: (identifier) @_fn_name) @function
+
+(singleton_method
+  name: (identifier) @_fn_name) @function
+
+(class
+  name: (constant) @_cls_name) @class
+
+(module
+  name: (constant) @_cls_name) @class
+
+(call
+  method: (identifier) @_call_name
+  arguments: (argument_list
+    (string) @_import_module)
+  (#eq? @_call_name "require"))  @import
+
+(call
+  method: (identifier) @_call_name
+  arguments: (argument_list
+    (string) @_import_module)
+  (#eq? @_call_name "require_relative"))  @import
+
+(assignment
+  left: (constant) @_var_name) @variable
+
+(assignment
+  left: (left_assignment_list (constant) @_var_name)) @variable
+
+(assignment
+  left: (left_assignment_list (rest_assignment (constant) @_var_name))) @variable
+
+(call
+  method: (identifier) @_call_name
+  arguments: (argument_list . (string (string_content) @_cls_name))
+  (#any-of? @_call_name "describe" "context" "feature" "shared_examples" "shared_context")) @class
+
+(call
+  method: (identifier) @_call_name
+  arguments: (argument_list . (constant) @_cls_name)
+  (#any-of? @_call_name "describe" "context" "feature")) @class
+
+(call
+  method: (identifier) @_call_name
+  arguments: (argument_list . (string (string_content) @_fn_name))
+  (#any-of? @_call_name "it" "specify" "example" "scenario")) @function

rbtr_lang_ruby-2026.9.0.dev1/src/rbtr_lang_ruby/tests/__snapshots__/test_samples/test_edges_match_snapshot.json

@@ -0,0 +1,3 @@
+[
+  "ruby.rb::require_relative \"./config\" -> config.rb::DEFAULT_LOCALE [imports]"
+]