rbtr-lang-go 2026.9.0.dev1__tar.gz

rbtr_lang_go-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_go-2026.9.0.dev1/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: rbtr-lang-go
+Version: 2026.9.0.dev1
+Summary: rbtr — Go language plugin
+Keywords: code-search,code-index,tree-sitter,static-analysis,semantic-search,developer-tools,go,golang
+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 :: Go
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Text Processing :: Indexing
+Classifier: Typing :: Typed
+Requires-Dist: rbtr==2026.9.0.dev1
+Requires-Dist: tree-sitter-go
+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-go#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-go
+
+Go support for [rbtr]. Optional plugin — install with
+`pip install rbtr[go]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+- **Functions & methods** — `func`; a method with a receiver is scoped to its
+  receiver type.
+- **Classes** — `struct`, `interface`, and named types.
+- **Variables** — package-level `var` / `const` (and grouped blocks).
+- **Imports** — `import` declarations (single and grouped), for cross-file
+  edges. An import path carries the module prefix `go.mod` declares, which is
+  read from the repository and stripped, and it names a package — a directory
+  — so the edge reaches every `.go` file in it.
+
+Leading `//` doc comments fold into the symbol's content.
+
+## Chunks produced
+
+```go
+func Greet(name string) string { … }   // function "Greet"
+type Server struct { … }               // class "Server"
+func (s *Server) Start() { … }         // method "Start", scope "Server"
+const MaxConns = 100                   // variable "MaxConns"
+import "fmt"                           // import, metadata {module: fmt}
+```
+
+## Embedded / injected chunks
+
+None. Go does not embed other languages.
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-go` grammar. No dependency on other language plugins.

rbtr_lang_go-2026.9.0.dev1/README.md

@@ -0,0 +1,37 @@
+# rbtr-lang-go
+
+Go support for [rbtr]. Optional plugin — install with
+`pip install rbtr[go]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+- **Functions & methods** — `func`; a method with a receiver is scoped to its
+  receiver type.
+- **Classes** — `struct`, `interface`, and named types.
+- **Variables** — package-level `var` / `const` (and grouped blocks).
+- **Imports** — `import` declarations (single and grouped), for cross-file
+  edges. An import path carries the module prefix `go.mod` declares, which is
+  read from the repository and stripped, and it names a package — a directory
+  — so the edge reaches every `.go` file in it.
+
+Leading `//` doc comments fold into the symbol's content.
+
+## Chunks produced
+
+```go
+func Greet(name string) string { … }   // function "Greet"
+type Server struct { … }               // class "Server"
+func (s *Server) Start() { … }         // method "Start", scope "Server"
+const MaxConns = 100                   // variable "MaxConns"
+import "fmt"                           // import, metadata {module: fmt}
+```
+
+## Embedded / injected chunks
+
+None. Go does not embed other languages.
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-go` grammar. No dependency on other language plugins.

rbtr_lang_go-2026.9.0.dev1/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["uv_build>=0.11.26,<1"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "rbtr_lang_go"
+
+[tool.uv.sources.rbtr]
+workspace = true
+
+[project]
+name = "rbtr-lang-go"
+version = "2026.9.0-dev1"
+description = "rbtr — Go language plugin"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "code-search",
+    "code-index",
+    "tree-sitter",
+    "static-analysis",
+    "semantic-search",
+    "developer-tools",
+    "go",
+    "golang",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Go",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Text Processing :: Indexing",
+    "Typing :: Typed",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "rbtr==2026.9.0-dev1",
+    "tree-sitter-go",
+]
+
+[[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-go#readme"
+Issues = "https://github.com/janrito/rbtr/issues"
+Changelog = "https://github.com/janrito/rbtr/releases"
+
+[project.entry-points."rbtr.languages"]
+go = "rbtr_lang_go.plugin:go"
+
+[dependency-groups]
+dev = ["rbtr[test]"]

rbtr_lang_go-2026.9.0.dev1/pyproject.toml.orig

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["uv_build>=0.11.26,<1"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "rbtr_lang_go"
+# No source-exclude: the plugin's tests, samples, and snapshots ship with
+# the wheel (they are the language's golden record), and go.scm ships as
+# package data.
+
+[project]
+name = "rbtr-lang-go"
+version = "2026.9.0-dev1"
+description = "rbtr — Go 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",
+  "go",
+  "golang",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Go",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Libraries",
+  "Topic :: Text Processing :: Indexing",
+  "Typing :: Typed",
+]
+requires-python = ">=3.13"
+dependencies = [
+  "rbtr==2026.9.0-dev1",
+  "tree-sitter-go",
+]
+
+[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-go#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.
+go = "rbtr_lang_go.plugin:go"
+
+[tool.uv.sources]
+rbtr = { workspace = true }
+
+[dependency-groups]
+dev = ["rbtr[test]"]

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

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

rbtr_lang_go-2026.9.0.dev1/src/rbtr_lang_go/go.scm

@@ -0,0 +1,53 @@
+; Top-level comments (Go uses one `comment` type for `//` and `/* */`).
+; The engine groups these and folds a block flush before a symbol into it.
+(comment) @comment
+
+(function_declaration
+  name: (identifier) @_fn_name) @function
+
+(method_declaration
+  receiver: (parameter_list
+    (parameter_declaration
+      type: [
+        (type_identifier) @_scope
+        (pointer_type (type_identifier) @_scope)
+      ]))
+  name: (field_identifier) @_method_name) @method
+
+(type_declaration
+  (type_spec
+    name: (type_identifier) @_cls_name)) @class
+
+(type_spec
+  (interface_type
+    (method_elem
+      name: (field_identifier) @_method_name) @method))
+
+(type_declaration
+  (type_alias
+    name: (type_identifier) @_cls_name)) @class
+
+(import_declaration
+  (import_spec
+    path: (interpreted_string_literal) @_import_module) @import)
+
+(import_declaration
+  (import_spec_list
+    (import_spec
+      path: (interpreted_string_literal) @_import_module) @import))
+
+(source_file
+  (var_declaration
+    (var_spec
+      name: (identifier) @_var_name) @variable))
+
+(source_file
+  (const_declaration
+    (const_spec
+      name: (identifier) @_var_name) @variable))
+
+(source_file
+  (var_declaration
+    (var_spec_list
+      (var_spec
+        name: (identifier) @_var_name) @variable)))

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

@@ -0,0 +1,57 @@
+"""Go language plugin.
+
+Provides full support: functions, methods, type declarations,
+and import extraction.
+
+Extracted chunks::
+
+    func hello() {}                 → function "hello", scope ""
+    func (u User) Name() string {}  → method "Name", scope ""
+    type User struct { ... }        → class "User", scope ""
+    type Reader interface { ... }   → class "Reader", scope ""
+
+    import "fmt"
+        → import, metadata {module: "fmt"}
+    import ("fmt" "os/exec")
+        → 2 import chunks: {module: "fmt"}, {module: "os/exec"}
+"""
+
+from __future__ import annotations
+
+import re
+
+from rbtr.languages.registration import LanguageRegistration, QueryExtraction, load_query
+
+# ── Manifest ─────────────────────────────────────────────────────────
+
+_MODULE_LINE = re.compile(r"^\s*module\s+(\S+)", re.MULTILINE)
+
+
+# ── Plugin ───────────────────────────────────────────────────────────
+
+
+go = LanguageRegistration(
+    id="go",
+    extensions=frozenset({".go"}),
+    grammar_module="tree_sitter_go",
+    extraction=QueryExtraction(
+        query=load_query(__package__, "go"),
+        scope_types=frozenset({"type_spec"}),
+    ),
+    package_directory=True,
+    extraction_serial=4,
+    manifest="go.mod",
+)
+
+
+@go.manifest_reader
+def go_module_prefix(text: str) -> tuple[tuple[str, str], ...]:
+    """Strip the module path `go.mod` declares from every import.
+
+    Imports inside a module are written from the module root, so `module
+    example.com/m` makes `example.com/m/b` the directory `b`.
+    """
+    match = _MODULE_LINE.search(text)
+    if match is None:
+        return ()
+    return ((f"{match.group(1)}/", ""),)

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

@@ -0,0 +1,3 @@
+[
+  "go.go::\"example.com/greeter/greeter\" -> greeter/text.go::Trim [imports]"
+]