rbtr-lang-less 2026.7.0.dev0__py3-none-any.whl

rbtr_lang_less/__init__.py

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

rbtr_lang_less/less.scm

@@ -0,0 +1,23 @@
+
+; Comments (Less: `/* */` is `comment`, `//` is `js_comment`).
+[(comment) (js_comment)] @comment
+
+(declaration
+  (property_name) @_var_name
+  (#match? @_var_name "^[@]")) @variable
+
+(mixin_definition
+  (class_name) @_fn_name) @function
+
+(rule_set
+  (selectors) @_cls_name) @class
+
+(media_statement) @class
+
+(charset_statement) @config_key
+
+(keyframes_statement
+  (keyframes_name) @_cls_name) @class
+
+(import_statement
+  (string_value) @_import_module) @import

rbtr_lang_less/plugin.py

@@ -0,0 +1,43 @@
+"""Less language plugin.
+
+Extends CSS extraction with the Less preprocessor constructs,
+via a tree-sitter query. Rule sets and `@media`/`@keyframes`
+blocks are captured as classes; `@charset` as a config key;
+`@`-prefixed declarations as variables; `.mixin()` definitions
+as functions;
+`@import` as imports for cross-file edges. Mixin *calls*
+(`mixin_statement`) are references, not definitions, and are
+skipped.
+
+Extracted chunks::
+
+    @primary: #333;              → variable "@primary"
+    .rounded(@r) { ... }         → function "rounded"
+    .btn { ... }                 → class ".btn"
+    @keyframes slide { ... }     → class "slide"
+    @import "reset";             → import, metadata {module: "reset"}
+"""
+
+from __future__ import annotations
+
+from rbtr.languages.registration import (
+    LanguageRegistration,
+    QueryExtraction,
+    build_quoted_import,
+    load_query,
+)
+from rbtr_lang_css.plugin import css_nesting_scope
+
+less = LanguageRegistration(
+    id="less",
+    extensions=frozenset({".less"}),
+    grammar_module="tree_sitter_less",
+    extraction=QueryExtraction(
+        query=load_query(__package__, "less"),
+    ),
+    import_targets=frozenset({"css", "scss", "less"}),
+    extraction_serial=3,
+)
+
+less.scope_extractor(css_nesting_scope)
+less.import_extractor(build_quoted_import)

rbtr_lang_less/tests/__snapshots__/test_samples/test_edges_match_snapshot.json

@@ -0,0 +1,3 @@
+[
+  "less.less::@import \"base\"; -> base.less::@bg [imports]"
+]

rbtr_lang_less/tests/__snapshots__/test_samples/test_extraction_matches_snapshot.json

@@ -0,0 +1,218 @@
+[
+  {
+    "id": "e03b0b6a01be78d0",
+    "blob_sha": "sha1",
+    "file_path": "base.less",
+    "kind": "comment",
+    "name": "<anonymous>",
+    "scope": "",
+    "language": "less",
+    "content": "// Imported by less.less via `@import \"base\"`.",
+    "line_start": 1,
+    "line_end": 1,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "8f10aa0b97fda5ea",
+    "blob_sha": "sha1",
+    "file_path": "base.less",
+    "kind": "variable",
+    "name": "@bg",
+    "scope": "",
+    "language": "less",
+    "content": "@bg: #ffffff;",
+    "line_start": 3,
+    "line_end": 3,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "214b26100f73bc2c",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "comment",
+    "name": "<anonymous>",
+    "scope": "",
+    "language": "less",
+    "content": "// Greeter theme (Less).\n//\n// The Less plugin extracts @-variables, .mixin() definitions, rule sets\n// and @media/@charset/@keyframes as doc sections, and @import as imports.\n// Mixin calls (e.g. `.rounded(8px)`) are references, not definitions.",
+    "line_start": 1,
+    "line_end": 5,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "14b448311d1139b8",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "import",
+    "name": "@import \"base\";",
+    "scope": "",
+    "language": "less",
+    "content": "@import \"base\";",
+    "line_start": 7,
+    "line_end": 7,
+    "metadata": {
+      "module": "base",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "8d9441ee2a311c25",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "variable",
+    "name": "@primary",
+    "scope": "",
+    "language": "less",
+    "content": "@primary: #333;",
+    "line_start": 9,
+    "line_end": 9,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "7c7b0d1e3f708b87",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "variable",
+    "name": "@spacing",
+    "scope": "",
+    "language": "less",
+    "content": "@spacing: 8px;",
+    "line_start": 10,
+    "line_end": 10,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "70cc768af8829886",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "function",
+    "name": "rounded",
+    "scope": "",
+    "language": "less",
+    "content": ".rounded(@radius: 4px) {\n  border-radius: @radius;\n}",
+    "line_start": 12,
+    "line_end": 14,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "787412e930624b62",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "class",
+    "name": ".greeter",
+    "scope": "",
+    "language": "less",
+    "content": ".greeter {\n  color: @primary;\n  padding: @spacing;\n  .rounded(8px);\n  .greeting-label {\n    text-transform: uppercase;\n  }\n}",
+    "line_start": 16,
+    "line_end": 23,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "a21acf50441166ff",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "class",
+    "name": ".greeting-label",
+    "scope": ".greeter",
+    "language": "less",
+    "content": ".greeting-label {\n    text-transform: uppercase;\n  }",
+    "line_start": 20,
+    "line_end": 22,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "289a7c82bd01f03c",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "class",
+    "name": "<anonymous>",
+    "scope": "",
+    "language": "less",
+    "content": "@media (max-width: 600px) {\n  .greeter {\n    font-size: 14px;\n  }\n}",
+    "line_start": 25,
+    "line_end": 29,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "a4d6c82c63beab1c",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "class",
+    "name": ".greeter",
+    "scope": "",
+    "language": "less",
+    "content": ".greeter {\n    font-size: 14px;\n  }",
+    "line_start": 26,
+    "line_end": 28,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "4d89902ee8dcd396",
+    "blob_sha": "sha1",
+    "file_path": "less.less",
+    "kind": "class",
+    "name": "greeting-fade",
+    "scope": "",
+    "language": "less",
+    "content": "@keyframes greeting-fade {\n  from {\n    opacity: 0;\n  }\n  to {\n    opacity: 1;\n  }\n}",
+    "line_start": 31,
+    "line_end": 38,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  }
+]

rbtr_lang_less/tests/samples/less/base.less

@@ -0,0 +1,3 @@
+// Imported by less.less via `@import "base"`.
+
+@bg: #ffffff;

rbtr_lang_less/tests/samples/less/less.less

@@ -0,0 +1,38 @@
+// Greeter theme (Less).
+//
+// The Less plugin extracts @-variables, .mixin() definitions, rule sets
+// and @media/@charset/@keyframes as doc sections, and @import as imports.
+// Mixin calls (e.g. `.rounded(8px)`) are references, not definitions.
+
+@import "base";
+
+@primary: #333;
+@spacing: 8px;
+
+.rounded(@radius: 4px) {
+  border-radius: @radius;
+}
+
+.greeter {
+  color: @primary;
+  padding: @spacing;
+  .rounded(8px);
+  .greeting-label {
+    text-transform: uppercase;
+  }
+}
+
+@media (max-width: 600px) {
+  .greeter {
+    font-size: 14px;
+  }
+}
+
+@keyframes greeting-fade {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}

rbtr_lang_less/tests/test_samples.py

@@ -0,0 +1,82 @@
+"""Less sample extraction: the `samples/less/` project through the real pipeline.
+
+The snapshots are the golden record of what Less extraction produces.
+Engine-wide invariants are covered once in core.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+import pytest
+from tree_sitter import Parser
+
+from rbtr.git import FileEntry
+from rbtr.index.models import Chunk, ChunkKind, Edge
+from rbtr.languages.edges import build_resolution_map, infer_import_edges
+from rbtr.languages.extract import extract_file
+from rbtr.languages.manager import get_manager
+from rbtr.testing import render_edges
+
+if TYPE_CHECKING:
+    from syrupy.assertion import SnapshotAssertion
+
+
+@pytest.fixture
+def project() -> list[tuple[str, str]]:
+    """The `(relative path, text)` files of the `samples/less/` project."""
+    root = Path(__file__).parent / "samples" / "less"
+    return [
+        (str(p.relative_to(root)), p.read_text()) for p in sorted(root.rglob("*")) if p.is_file()
+    ]
+
+
+@pytest.fixture
+def chunks(project: list[tuple[str, str]]) -> list[Chunk]:
+    """Chunks from every project file, each via the real `extract_file`."""
+    manager = get_manager()
+    out: list[Chunk] = []
+    for path, text in project:
+        lang = manager.detect_language(path) or "less"
+        out.extend(extract_file(FileEntry(path, "sha1", text.encode()), lang))
+    return out
+
+
+@pytest.fixture
+def edges(project: list[tuple[str, str]], chunks: list[Chunk]) -> list[Edge]:
+    """Import edges inferred across the project's files."""
+    manager = get_manager()
+    repo_files = {path for path, _ in project}
+    return infer_import_edges(chunks, repo_files, build_resolution_map(manager))
+
+
+def test_emits_expected_kinds(chunks: list[Chunk]) -> None:
+    """The sample exercises Less's class, variable, function, and import chunks."""
+    kinds = {c.kind for c in chunks}
+    assert {
+        ChunkKind.CLASS,
+        ChunkKind.VARIABLE,
+        ChunkKind.FUNCTION,
+        ChunkKind.IMPORT,
+        ChunkKind.COMMENT,
+    } <= kinds
+
+
+def test_parses_cleanly(project: list[tuple[str, str]]) -> None:
+    """Every project file is valid source — no tree-sitter ERROR/MISSING nodes."""
+    manager = get_manager()
+    for path, text in project:
+        grammar = manager.grammar(manager.detect_language(path) or "less")
+        assert grammar is not None
+        assert not Parser(grammar).parse(text.encode()).root_node.has_error, path
+
+
+def test_extraction_matches_snapshot(chunks: list[Chunk], snapshot_json: SnapshotAssertion) -> None:
+    assert chunks == snapshot_json
+
+
+def test_edges_match_snapshot(
+    chunks: list[Chunk], edges: list[Edge], snapshot_json: SnapshotAssertion
+) -> None:
+    assert render_edges(edges, chunks) == snapshot_json

rbtr_lang_less-2026.7.0.dev0.dist-info/METADATA

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: rbtr-lang-less
+Version: 2026.7.0.dev0
+Summary: rbtr — Less language plugin
+License-Expression: MIT
+Requires-Dist: rbtr==2026.7.0.dev0
+Requires-Dist: rbtr-lang-css==2026.7.0.dev0
+Requires-Dist: tree-sitter-less
+Requires-Python: >=3.13

rbtr_lang_less-2026.7.0.dev0.dist-info/RECORD

@@ -0,0 +1,14 @@
+rbtr_lang_less/__init__.py,sha256=E42CXBcXhyXDXketMTwv9XjpQDnhF0A2Gzi4lEYNtOU,36
+rbtr_lang_less/less.scm,sha256=2jrlfjlTSTietKO8B1gLOrIYrYYm_sUxK_MY3PN2pdM,461
+rbtr_lang_less/plugin.py,sha256=vGhVTUs-9oTMYfaMKIFF9a1Kik2jHtJERLI7XMg3zhk,1317
+rbtr_lang_less/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rbtr_lang_less/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rbtr_lang_less/tests/__snapshots__/test_samples/test_edges_match_snapshot.json,sha256=I8OT2FZ17c6YO_bW4dzC24YlLqv6wVCLAErptVE8Iho,65
+rbtr_lang_less/tests/__snapshots__/test_samples/test_extraction_matches_snapshot.json,sha256=bpzNyCSvRoH-6hZJtL238z6JuXIk7iaupsJE4k-VQeg,5005
+rbtr_lang_less/tests/samples/less/base.less,sha256=2h-NAkIQrv7wAe87uMImcEQP4DF8UzRM22UZIwjrvOc,62
+rbtr_lang_less/tests/samples/less/less.less,sha256=4chFgMXhUioo903qkgjQBfDnZqMQGNhwIZw_k162AvE,631
+rbtr_lang_less/tests/test_samples.py,sha256=8auXPA50APYzijx-1Iyy1H74tutea53O2J79QbFGeMg,2776
+rbtr_lang_less-2026.7.0.dev0.dist-info/WHEEL,sha256=CoDSoyhtC_eO_tlxRYzsTraPv1fPJRXFx91k6ISeAvA,81
+rbtr_lang_less-2026.7.0.dev0.dist-info/entry_points.txt,sha256=-Hm26DERb7xxNRI39RA4YGso21CZEVpvBFinToa-RxE,52
+rbtr_lang_less-2026.7.0.dev0.dist-info/METADATA,sha256=iRMvpHyi_3Eyq0utSdquW7FFw4mTtKASoCASeavgk3w,264
+rbtr_lang_less-2026.7.0.dev0.dist-info/RECORD,,

rbtr_lang_less-2026.7.0.dev0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.28
+Root-Is-Purelib: true
+Tag: py3-none-any

rbtr_lang_less-2026.7.0.dev0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[rbtr.languages]
+less = rbtr_lang_less.plugin:less
+