rbtr-lang-c 2026.9.0.dev1__tar.gz

rbtr_lang_c-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_c-2026.9.0.dev1/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: rbtr-lang-c
+Version: 2026.9.0.dev1
+Summary: rbtr — C language plugin
+Keywords: code-search,code-index,tree-sitter,static-analysis,semantic-search,developer-tools,c
+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 :: C
+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-c
+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-c#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-c
+
+C support for [rbtr]. A **default** plugin — installed with rbtr
+itself (`pip install rbtr`).
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+- **Functions** — function definitions and prototypes.
+- **Classes** — `struct` / `enum` / `union` and `typedef` types (a
+  `typedef struct G G;` yields two: the definition and the alias).
+- **Variables** — top-level variables and enum constants (C enum constants
+  leak into the enclosing scope, so they are file-scope variables).
+- **Imports** — `#include <system>` and `#include "local"` headers.
+
+## Chunks produced
+
+```c
+void greet(const char *name);      /* function "greet"          */
+struct Point { int x, y; };        /* class "Point"             */
+enum Color { RED, GREEN };         /* class "Color"; variables RED, GREEN */
+#include <stdio.h>                 /* import, metadata {module: stdio.h}   */
+#include "greeter.h"               /* import, metadata {module: greeter.h} */
+```
+
+## Embedded / injected chunks
+
+None. C does not embed other languages.
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-c` grammar. No dependency on other language plugins.

rbtr_lang_c-2026.9.0.dev1/README.md

@@ -0,0 +1,33 @@
+# rbtr-lang-c
+
+C support for [rbtr]. A **default** plugin — installed with rbtr
+itself (`pip install rbtr`).
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+- **Functions** — function definitions and prototypes.
+- **Classes** — `struct` / `enum` / `union` and `typedef` types (a
+  `typedef struct G G;` yields two: the definition and the alias).
+- **Variables** — top-level variables and enum constants (C enum constants
+  leak into the enclosing scope, so they are file-scope variables).
+- **Imports** — `#include <system>` and `#include "local"` headers.
+
+## Chunks produced
+
+```c
+void greet(const char *name);      /* function "greet"          */
+struct Point { int x, y; };        /* class "Point"             */
+enum Color { RED, GREEN };         /* class "Color"; variables RED, GREEN */
+#include <stdio.h>                 /* import, metadata {module: stdio.h}   */
+#include "greeter.h"               /* import, metadata {module: greeter.h} */
+```
+
+## Embedded / injected chunks
+
+None. C does not embed other languages.
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-c` grammar. No dependency on other language plugins.

rbtr_lang_c-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_c"
+
+[tool.uv.sources.rbtr]
+workspace = true
+
+[project]
+name = "rbtr-lang-c"
+version = "2026.9.0-dev1"
+description = "rbtr — C language plugin"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "code-search",
+    "code-index",
+    "tree-sitter",
+    "static-analysis",
+    "semantic-search",
+    "developer-tools",
+    "c",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: C",
+    "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-c",
+]
+
+[[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-c#readme"
+Issues = "https://github.com/janrito/rbtr/issues"
+Changelog = "https://github.com/janrito/rbtr/releases"
+
+[project.entry-points."rbtr.languages"]
+c = "rbtr_lang_c.plugin:c"
+
+[dependency-groups]
+dev = ["rbtr[test]"]

rbtr_lang_c-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_c"
+# No source-exclude: the plugin's tests, samples, and snapshots ship with
+# the wheel (they are the language's golden record), and c.scm ships as
+# package data.
+
+[project]
+name = "rbtr-lang-c"
+version = "2026.9.0-dev1"
+description = "rbtr — C 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",
+  "c",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: C",
+  "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-c",
+]
+
+[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-c#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.
+c = "rbtr_lang_c.plugin:c"
+
+[tool.uv.sources]
+rbtr = { workspace = true }
+
+[dependency-groups]
+dev = ["rbtr[test]"]

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

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

rbtr_lang_c-2026.9.0.dev1/src/rbtr_lang_c/c.scm

@@ -0,0 +1,63 @@
+; Top-level comments (C uses one `comment` type for `//` and `/* */`).
+(comment) @comment
+
+(function_definition
+  declarator: (function_declarator
+    declarator: (identifier) @_fn_name)) @function
+
+(preproc_include
+  path: (system_lib_string) @_import_module) @import
+
+(preproc_include
+  path: (string_literal) @_import_module) @import
+
+(struct_specifier
+  name: (type_identifier) @_cls_name
+  body: (field_declaration_list)) @class
+
+(union_specifier
+  name: (type_identifier) @_cls_name
+  body: (field_declaration_list)) @class
+
+(enum_specifier
+  name: (type_identifier) @_cls_name
+  body: (enumerator_list)) @class
+
+(enumerator
+  name: (identifier) @_var_name) @variable
+
+(type_definition
+  declarator: (type_identifier) @_cls_name) @class
+
+(type_definition
+  declarator: (function_declarator
+    declarator: (parenthesized_declarator
+      (pointer_declarator
+        declarator: (type_identifier) @_cls_name)))) @class
+
+(preproc_function_def
+  name: (identifier) @_fn_name) @function
+
+(preproc_def
+  name: (identifier) @_var_name) @variable
+
+(translation_unit
+  (declaration
+    declarator: (function_declarator
+      declarator: (identifier) @_fn_name)) @function)
+
+(translation_unit
+  (declaration
+    declarator: (init_declarator
+      declarator: (identifier) @_var_name)) @variable)
+
+(translation_unit
+  (declaration
+    declarator: (pointer_declarator
+      declarator: (identifier) @_var_name)) @variable)
+
+(translation_unit
+  (declaration
+    declarator: (init_declarator
+      declarator: (pointer_declarator
+        declarator: (identifier) @_var_name))) @variable)

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

@@ -0,0 +1,41 @@
+"""C language plugin.
+
+Provides symbol extraction (functions, function prototypes, structs,
+unions, enums, typedefs, global variables, and function/object-like
+macros) and include directive capture.  Object-like macros and
+pointer-declared globals are variables; function-like macros and
+prototypes are functions.
+
+Extracted chunks::
+
+    int add(int a, int b) { ... }   → function "add", scope ""
+    struct Node { int value; };     → class "Node", scope ""
+    enum Color { RED, GREEN };      → class "Color", scope ""
+    typedef struct { ... } Point;   → class "Point", scope ""
+
+    #include <stdio.h>
+        → import, metadata {module: "stdio.h"}
+    #include "mylib.h"
+        → import, metadata {module: "mylib.h"}
+"""
+
+from __future__ import annotations
+
+from rbtr.languages.registration import LanguageRegistration, QueryExtraction, load_query
+
+# ── Query ────────────────────────────────────────────────────────────
+
+
+# ── Plugin ───────────────────────────────────────────────────────────
+
+
+c = LanguageRegistration(
+    id="c",
+    extensions=frozenset({".c", ".h"}),
+    grammar_module="tree_sitter_c",
+    extraction=QueryExtraction(
+        query=load_query(__package__, "c"),
+    ),
+    source_roots=("", "include", "src"),
+    extraction_serial=4,
+)

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

@@ -0,0 +1,7 @@
+[
+  "c.c::#include \"greeter.h\" -> greeter.h::GREETER_H [imports]",
+  "c.c::#include \"greeter.h\" -> greeter.h::Greeter [imports]",
+  "c.c::#include \"greeter.h\" -> greeter.h::Greeter [imports]",
+  "c.c::#include \"greeter.h\" -> greeter.h::MAX_NAME [imports]",
+  "util/text.c::#include \"text.h\" -> util/text.h::GREETER_UTIL_TEXT_H [imports]"
+]