rbtr-lang-cpp 2026.9.0.dev1__tar.gz

rbtr_lang_cpp-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_cpp-2026.9.0.dev1/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: rbtr-lang-cpp
+Version: 2026.9.0.dev1
+Summary: rbtr — C++ language plugin
+Keywords: code-search,code-index,tree-sitter,static-analysis,semantic-search,developer-tools,cpp,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-cpp
+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-cpp#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-cpp
+
+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** — free functions and function templates.
+- **Classes** — classes, structs, and enums.
+- **Methods** — member functions and constructors, scoped to their class.
+- **Variables** — namespace-level and top-level variables.
+- **Imports** — `#include` headers.
+
+Scope uses `::` and includes the enclosing namespace.
+
+## Chunks produced
+
+```cpp
+int add(int a, int b) { … }        // function "add"
+namespace ui {                     //
+  class Widget { void draw(); };   //   class "Widget"; method "draw" scope "ui::Widget"
+  int count = 0;                   //   variable "count", scope "ui"
+}
+#include <vector>                  // import, metadata {module: vector}
+```
+
+## Embedded / injected chunks
+
+None. C++ does not embed other languages.
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-cpp` grammar. No dependency on other language plugins.

rbtr_lang_cpp-2026.9.0.dev1/README.md

@@ -0,0 +1,35 @@
+# rbtr-lang-cpp
+
+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** — free functions and function templates.
+- **Classes** — classes, structs, and enums.
+- **Methods** — member functions and constructors, scoped to their class.
+- **Variables** — namespace-level and top-level variables.
+- **Imports** — `#include` headers.
+
+Scope uses `::` and includes the enclosing namespace.
+
+## Chunks produced
+
+```cpp
+int add(int a, int b) { … }        // function "add"
+namespace ui {                     //
+  class Widget { void draw(); };   //   class "Widget"; method "draw" scope "ui::Widget"
+  int count = 0;                   //   variable "count", scope "ui"
+}
+#include <vector>                  // import, metadata {module: vector}
+```
+
+## Embedded / injected chunks
+
+None. C++ does not embed other languages.
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-cpp` grammar. No dependency on other language plugins.

rbtr_lang_cpp-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_cpp"
+
+[tool.uv.sources.rbtr]
+workspace = true
+
+[project]
+name = "rbtr-lang-cpp"
+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",
+    "cpp",
+    "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-cpp",
+]
+
+[[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-cpp#readme"
+Issues = "https://github.com/janrito/rbtr/issues"
+Changelog = "https://github.com/janrito/rbtr/releases"
+
+[project.entry-points."rbtr.languages"]
+cpp = "rbtr_lang_cpp.plugin:cpp"
+
+[dependency-groups]
+dev = ["rbtr[test]"]

rbtr_lang_cpp-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_cpp"
+# No source-exclude: the plugin's tests, samples, and snapshots ship with
+# the wheel (they are the language's golden record), and cpp.scm ships as
+# package data.
+
+[project]
+name = "rbtr-lang-cpp"
+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",
+  "cpp",
+  "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-cpp",
+]
+
+[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-cpp#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.
+cpp = "rbtr_lang_cpp.plugin:cpp"
+
+[tool.uv.sources]
+rbtr = { workspace = true }
+
+[dependency-groups]
+dev = ["rbtr[test]"]

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

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

rbtr_lang_cpp-2026.9.0.dev1/src/rbtr_lang_cpp/cpp.scm

@@ -0,0 +1,106 @@
+; Top-level comments (C++ uses one `comment` type for `//` and `/* */`).
+(comment) @comment
+
+(function_definition
+  declarator: (function_declarator
+    declarator: (identifier) @_fn_name)) @function
+
+(function_definition
+  declarator: (function_declarator
+    declarator: (field_identifier) @_fn_name)) @function
+
+(function_definition
+  declarator: (function_declarator
+    declarator: (operator_name) @_fn_name)) @function
+
+(field_declaration
+  declarator: (function_declarator
+    declarator: (field_identifier) @_method_name)) @method
+
+(field_declaration_list
+  (declaration
+    declarator: (function_declarator
+      declarator: (identifier) @_method_name)) @method)
+
+(preproc_include
+  path: (system_lib_string) @_import_module) @import
+
+(preproc_include
+  path: (string_literal) @_import_module) @import
+
+(preproc_function_def
+  name: (identifier) @_fn_name) @function
+
+(preproc_def
+  name: (identifier) @_var_name) @variable
+
+(class_specifier
+  name: (type_identifier) @_cls_name
+  body: (field_declaration_list)) @class
+
+(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
+
+(alias_declaration
+  name: (type_identifier) @_cls_name) @class
+
+(namespace_definition
+  name: (namespace_identifier) @_cls_name) @class
+
+(concept_definition
+  name: (identifier) @_cls_name) @class
+
+(translation_unit
+  (declaration
+    declarator: (function_declarator
+      declarator: (identifier) @_fn_name)) @function)
+
+(namespace_definition
+  body: (declaration_list
+    (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)
+
+(namespace_definition
+  body: (declaration_list
+    (declaration
+      declarator: (init_declarator
+        declarator: (identifier) @_var_name)) @variable))
+
+(namespace_definition
+  body: (declaration_list
+    (declaration
+      declarator: (pointer_declarator
+        declarator: (identifier) @_var_name)) @variable))
+
+(namespace_definition
+  body: (declaration_list
+    (declaration
+      declarator: (init_declarator
+        declarator: (pointer_declarator
+          declarator: (identifier) @_var_name))) @variable))

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

@@ -0,0 +1,43 @@
+"""C++ language plugin.
+
+Provides symbol extraction (functions, prototypes, classes, structs,
+unions, enums, type aliases, namespaces, methods including operator
+overloads, namespace/global variables, and function/object-like
+macros) and include directive capture.  Namespaces are both a symbol
+(class) and a naming scope.
+
+Extracted chunks::
+
+    void greet() {}                 → function "greet", scope ""
+    class Shape {};                 → class "Shape", scope ""
+    struct Point { ... };           → class "Point", scope ""
+    class Foo {
+      void bar() {}                 → method "bar", scope "Foo"
+    };
+
+    #include <iostream>
+        → import, metadata {module: "iostream"}
+"""
+
+from __future__ import annotations
+
+from rbtr.languages.registration import LanguageRegistration, QueryExtraction, load_query
+
+# ── Query ────────────────────────────────────────────────────────────
+
+
+# ── Plugin ───────────────────────────────────────────────────────────
+
+
+cpp = LanguageRegistration(
+    id="cpp",
+    extensions=frozenset({".cpp", ".cc", ".cxx", ".hpp", ".hxx"}),
+    grammar_module="tree_sitter_cpp",
+    extraction=QueryExtraction(
+        query=load_query(__package__, "cpp"),
+        scope_types=frozenset({"class_specifier", "struct_specifier", "namespace_definition"}),
+        class_scope_types=frozenset({"class_specifier", "struct_specifier"}),
+    ),
+    source_roots=("", "include", "src"),
+    extraction_serial=6,
+)

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

@@ -0,0 +1,9 @@
+[
+  "cpp.cpp::#include \"greeter.hpp\" -> greeter.hpp::Greeting [imports]",
+  "cpp.cpp::#include \"greeter.hpp\" -> greeter.hpp::Greeting [imports]",
+  "cpp.cpp::#include \"greeter.hpp\" -> greeter.hpp::greet [imports]",
+  "cpp.cpp::#include \"greeter.hpp\" -> greeter.hpp::render [imports]",
+  "cpp.cpp::#include \"greeter.hpp\" -> greeter.hpp::withDefault [imports]",
+  "util/text.cpp::#include \"text.hpp\" -> util/text.hpp::text_length [imports]",
+  "util/text.cpp::#include \"text.hpp\" -> util/text.hpp::util [imports]"
+]