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

rbtr_lang_bash/__init__.py

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

rbtr_lang_bash/bash.scm

@@ -0,0 +1,34 @@
+; Top-level comments (Bash: single `comment` type).
+(comment) @comment
+
+(function_definition
+  name: (word) @_fn_name) @function
+
+(command
+  name: (command_name
+    (word) @_cmd)
+  .
+  (word) @_import_module
+  (#eq? @_cmd "source")) @import
+
+(command
+  name: (command_name
+    (word) @_cmd)
+  .
+  (word) @_import_module
+  (#eq? @_cmd ".")) @import
+
+(program
+  (variable_assignment
+    name: (variable_name) @_var_name) @variable)
+
+(program
+  (declaration_command
+    (variable_assignment
+      name: (variable_name) @_var_name)) @variable)
+
+(command
+  name: (command_name (word) @_cmd)
+  argument: (concatenation (word) @_var_name)
+  (#eq? @_cmd "alias")
+  (#match? @_var_name "=")) @variable

rbtr_lang_bash/plugin.py

@@ -0,0 +1,64 @@
+"""Bash language plugin.
+
+Provides function extraction only — Bash has no import system,
+class system, or module structure.
+
+Extracted chunks::
+
+    deploy() { echo deploying; }    → function "deploy", scope ""
+    function setup { ... }          → function "setup", scope ""
+    alias ll="ls -l"                → variable "ll", scope ""
+
+No classes or methods are extracted.
+
+An `alias` name parses as one `word` fused with its `=` (`ll=`), which no
+query can split. The `name_extractor` strips the trailing `=`; no other
+bash name ends in one.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from rbtr.languages.registration import (
+    LanguageRegistration,
+    NameResolver,
+    QueryExtraction,
+    load_query,
+)
+
+if TYPE_CHECKING:
+    from tree_sitter import Node
+
+
+# ── Query ────────────────────────────────────────────────────────────
+
+
+# ── Plugin ───────────────────────────────────────────────────────────
+
+
+bash = LanguageRegistration(
+    id="bash",
+    extensions=frozenset({".sh", ".bash", ".zsh"}),
+    filenames=frozenset(
+        {
+            "Bashrc",
+            ".bashrc",
+            ".bash_profile",
+            ".zshrc",
+        }
+    ),
+    grammar_module="tree_sitter_bash",
+    extraction=QueryExtraction(
+        query=load_query(__package__, "bash"),
+    ),
+    extraction_serial=4,
+)
+
+
+@bash.name_extractor
+def _strip_alias_eq(
+    resolver: NameResolver, capture_name: str, node: Node, captures: dict[str, list[Node]]
+) -> str:
+    """Default name, with the `=` the grammar fuses onto an alias removed."""
+    return resolver(capture_name, node, captures).rstrip("=")

rbtr_lang_bash/tests/__snapshots__/test_samples/test_edges_match_snapshot.json

@@ -0,0 +1,4 @@
+[
+  "bash.sh::source ./lib/colours.sh -> lib/colours.sh::RED [imports]",
+  "bash.sh::source ./lib/colours.sh -> lib/colours.sh::RESET [imports]"
+]

rbtr_lang_bash/tests/__snapshots__/test_samples/test_extraction_matches_snapshot.json

@@ -0,0 +1,254 @@
+[
+  {
+    "id": "d39ad69c069b6285",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "comment",
+    "name": "<anonymous>",
+    "scope": "",
+    "language": "bash",
+    "content": "#!/usr/bin/env bash\n# Greeter — print greetings for named recipients.\n#\n# Bash has no classes or methods; the plugin extracts functions,\n# top-level variable assignments (including export/declare/readonly),\n# aliases, and source/. imports.",
+    "line_start": 1,
+    "line_end": 6,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "ca906d45e5c8e1da",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "import",
+    "name": "source ./lib/colours.sh",
+    "scope": "",
+    "language": "bash",
+    "content": "source ./lib/colours.sh",
+    "line_start": 8,
+    "line_end": 8,
+    "metadata": {
+      "module": "./lib/colours.sh",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "19b95c899d99e1f5",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "import",
+    "name": ". /etc/greeter.conf",
+    "scope": "",
+    "language": "bash",
+    "content": ". /etc/greeter.conf",
+    "line_start": 9,
+    "line_end": 9,
+    "metadata": {
+      "module": "/etc/greeter.conf",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "dbf8d8210a1c9118",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "variable",
+    "name": "DEFAULT_GREETING",
+    "scope": "",
+    "language": "bash",
+    "content": "DEFAULT_GREETING=\"Hello\"",
+    "line_start": 11,
+    "line_end": 11,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "610d295f73434926",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "comment",
+    "name": "<anonymous>",
+    "scope": "",
+    "language": "bash",
+    "content": "# trailing comment: its own chunk",
+    "line_start": 11,
+    "line_end": 11,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "aa482bbea0e16ce3",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "variable",
+    "name": "LOCALE",
+    "scope": "",
+    "language": "bash",
+    "content": "# Standalone note, separated by blank lines from any definition.\n# Second line of the same block.\nLOCALE=\"${LANG:-en}\"",
+    "line_start": 13,
+    "line_end": 15,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "fd2d219510e272c5",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "variable",
+    "name": "API_URL",
+    "scope": "",
+    "language": "bash",
+    "content": "export API_URL=\"https://example.com\"",
+    "line_start": 16,
+    "line_end": 16,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "28c8e045bbc3c2fc",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "variable",
+    "name": "MAX_RETRIES",
+    "scope": "",
+    "language": "bash",
+    "content": "readonly MAX_RETRIES=3",
+    "line_start": 17,
+    "line_end": 17,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "46c076160d937a23",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "variable",
+    "name": "COUNTER",
+    "scope": "",
+    "language": "bash",
+    "content": "declare -i COUNTER=0",
+    "line_start": 18,
+    "line_end": 18,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "9be9ed61fbcec8cf",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "variable",
+    "name": "greet",
+    "scope": "",
+    "language": "bash",
+    "content": "alias greet=\"format_greeting\"",
+    "line_start": 19,
+    "line_end": 19,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "1c05f30beda1010c",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "function",
+    "name": "format_greeting",
+    "scope": "",
+    "language": "bash",
+    "content": "# Format a greeting for a single recipient.\nformat_greeting() {\n    local name=\"$1\"\n    echo \"${DEFAULT_GREETING}, ${name} (${LOCALE})\"\n}",
+    "line_start": 21,
+    "line_end": 25,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "f6bed6e22b836142",
+    "blob_sha": "sha1",
+    "file_path": "bash.sh",
+    "kind": "function",
+    "name": "greet_all",
+    "scope": "",
+    "language": "bash",
+    "content": "# Greet every argument in turn.\ngreet_all() {\n    for name in \"$@\"; do\n        format_greeting \"$name\"\n    done\n}",
+    "line_start": 27,
+    "line_end": 32,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "c01f22efbc31cfad",
+    "blob_sha": "sha1",
+    "file_path": "lib/colours.sh",
+    "kind": "variable",
+    "name": "RED",
+    "scope": "",
+    "language": "bash",
+    "content": "#!/usr/bin/env bash\n# Terminal colour codes.\nRED='\\033[0;31m'",
+    "line_start": 1,
+    "line_end": 3,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  },
+  {
+    "id": "472aaed6fa440473",
+    "blob_sha": "sha1",
+    "file_path": "lib/colours.sh",
+    "kind": "variable",
+    "name": "RESET",
+    "scope": "",
+    "language": "bash",
+    "content": "RESET='\\033[0m'",
+    "line_start": 4,
+    "line_end": 4,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    }
+  }
+]

rbtr_lang_bash/tests/cases_docstrings.py

@@ -0,0 +1,112 @@
+"""Bash docstring-extraction test cases.
+
+tree-sitter-bash uses a single `comment` node for any `#` line. Function
+docs are a `#` comment run directly above the definition; a shebang
+(`#!/bin/bash`) attaches to the first function only when no blank line
+separates them.
+
+Each `@case` returns `(lang, source, symbol_name, snippet)`; see
+`test_docstrings.py` for the assertion direction per tag.
+"""
+
+from __future__ import annotations
+
+from pytest_cases import case
+
+type DocstringCase = tuple[str, str, str, str]
+
+
+@case(tags=["documented", "canonical", "exterior_doc"])
+def case_bash_hash_doc_on_function() -> DocstringCase:
+    """Canonical `#` comment above a shell function."""
+    src = """\
+# Greet the user.
+greet() {
+  echo hello
+}
+"""
+    return "bash", src, "greet", "Greet the user"
+
+
+@case(tags=["documented", "canonical", "exterior_doc"])
+def case_bash_multi_line_hash_doc() -> DocstringCase:
+    """Multi-line `#` comment run."""
+    src = """\
+# Greet the user.
+#
+# Reads the name from $1.
+greet() {
+  echo hi $1
+}
+"""
+    return "bash", src, "greet", "Reads the name from"
+
+
+@case(tags=["documented", "edge_case", "exterior_doc"])
+def case_bash_shebang_attached_to_first_function() -> DocstringCase:
+    """When a function follows the shebang with no blank line,
+    the shebang attaches — an honest consequence of the
+    flexible attachment policy.  Recording this as a case so
+    any future tightening does not regress silently.
+    """
+    src = """\
+#!/bin/bash
+# Entry point.
+main() {
+  echo hi
+}
+"""
+    return "bash", src, "main", "#!/bin/bash"
+
+
+@case(tags=["documented", "unconventional", "exterior_doc"])
+def case_bash_comment_with_script_style_heading() -> DocstringCase:
+    """Heading-like comment above a function attaches."""
+    src = """\
+# ==== helpers ====
+# Trim whitespace from $1.
+trim() {
+  echo "$1"
+}
+"""
+    return "bash", src, "trim", "Trim whitespace"
+
+
+@case(tags=["undocumented", "no_docs"])
+def case_bash_fn_without_doc() -> DocstringCase:
+    """Undocumented shell function."""
+    src = """\
+bare() {
+  echo hi
+}
+"""
+    return "bash", src, "bare", "PHANTOM_DOC_TEXT_SHOULD_NEVER_APPEAR"
+
+
+@case(tags=["undocumented", "boundary_not_attached"])
+def case_bash_doc_detached_by_blank_line() -> DocstringCase:
+    """Blank line breaks attachment."""
+    src = """\
+# Orphan.
+
+later() {
+  echo hi
+}
+"""
+    return "bash", src, "later", "Orphan"
+
+
+@case(tags=["undocumented", "invalid"])
+def case_bash_shebang_separated_by_blank_line() -> DocstringCase:
+    """When a blank line separates the shebang from the first
+    function, the shebang stays detached — the same
+    blank-line rule applies uniformly to all comment kinds.
+    """
+    src = """\
+#!/bin/bash
+
+main() {
+  echo hi
+}
+"""
+    return "bash", src, "main", "#!/bin/bash"

rbtr_lang_bash/tests/cases_extraction.py

@@ -0,0 +1,138 @@
+"""Bash extraction test cases.
+
+Each `@case` returns test data consumed by `test_extraction.py` via
+`pytest-cases`.
+"""
+
+from __future__ import annotations
+
+from pytest_cases import case
+
+type SymbolCase = tuple[str, str, list[tuple[str, str, str]]]
+type MixedCase = tuple[str, str, set[str], list[tuple[str, str]]]
+
+
+@case(tags=["symbol"])
+def case_bash_function_keyword() -> SymbolCase:
+    """function deploy { ... }."""
+    src = """\
+function deploy {
+    echo deploying
+}
+"""
+    return "bash", src, [("function", "deploy", "")]
+
+
+@case(tags=["symbol"])
+def case_bash_function_keyword_parens() -> SymbolCase:
+    """function deploy() { ... }."""
+    src = """\
+function deploy() {
+    echo deploying
+}
+"""
+    return "bash", src, [("function", "deploy", "")]
+
+
+@case(tags=["symbol"])
+def case_bash_function_posix() -> SymbolCase:
+    """deploy() { ... } — POSIX syntax."""
+    src = """\
+deploy() {
+    echo deploying
+}
+"""
+    return "bash", src, [("function", "deploy", "")]
+
+
+@case(tags=["symbol"])
+def case_bash_multiple_functions() -> SymbolCase:
+    """Multiple shell functions."""
+    src = """\
+function setup {
+    echo setup
+}
+
+function teardown {
+    echo teardown
+}
+
+run() {
+    echo run
+}
+"""
+    return (
+        "bash",
+        src,
+        [
+            ("function", "setup", ""),
+            ("function", "teardown", ""),
+            ("function", "run", ""),
+        ],
+    )
+
+
+@case(tags=["symbol"])
+def case_bash_alias() -> SymbolCase:
+    """An alias is a variable, named without the `=` the grammar fuses on."""
+    src = """\
+alias ll="ls -l"
+"""
+    return "bash", src, [("variable", "ll", "")]
+
+
+@case(tags=["symbol"])
+def case_bash_function_local_vars() -> SymbolCase:
+    """Function with local variables."""
+    src = """\
+setup() {
+    local dir="/tmp"
+    mkdir -p "$dir"
+}
+"""
+    return "bash", src, [("function", "setup", "")]
+
+
+@case(tags=["symbol"])
+def case_bash_function_conditionals() -> SymbolCase:
+    """Function with conditionals."""
+    src = """\
+check() {
+    if [ -f /tmp/x ]; then
+        echo yes
+    fi
+}
+"""
+    return "bash", src, [("function", "check", "")]
+
+
+# ── Mixed ───────────────────────────────────────────────────────────
+
+
+@case(tags=["symbol"])
+def case_bash_assignment() -> SymbolCase:
+    """Top-level variable assignment."""
+    return "bash", "MAX=100\n", [("variable", "MAX", "")]
+
+
+@case(tags=["mixed"])
+def case_bash_full_script() -> MixedCase:
+    """Realistic shell script with doc comments on every
+    function.  Expected-kinds tuple pins symbol extraction;
+    content invariants are in `test_docstrings.py`.
+    """
+    src = """\
+#!/bin/bash
+
+# Deploy the current build to the given environment.
+deploy() {
+    local env="$1"
+    echo "deploying to $env"
+}
+
+# Roll back the last deploy.
+rollback() {
+    echo "rolling back"
+}
+"""
+    return "bash", src, {"function"}, []

rbtr_lang_bash/tests/samples/bash/bash.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# Greeter — print greetings for named recipients.
+#
+# Bash has no classes or methods; the plugin extracts functions,
+# top-level variable assignments (including export/declare/readonly),
+# aliases, and source/. imports.
+
+source ./lib/colours.sh
+. /etc/greeter.conf
+
+DEFAULT_GREETING="Hello" # trailing comment: its own chunk
+
+# Standalone note, separated by blank lines from any definition.
+# Second line of the same block.
+LOCALE="${LANG:-en}"
+export API_URL="https://example.com"
+readonly MAX_RETRIES=3
+declare -i COUNTER=0
+alias greet="format_greeting"
+
+# Format a greeting for a single recipient.
+format_greeting() {
+    local name="$1"
+    echo "${DEFAULT_GREETING}, ${name} (${LOCALE})"
+}
+
+# Greet every argument in turn.
+greet_all() {
+    for name in "$@"; do
+        format_greeting "$name"
+    done
+}
+
+greet_all "$@"

rbtr_lang_bash/tests/samples/bash/lib/colours.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+# Terminal colour codes.
+RED='\033[0;31m'
+RESET='\033[0m'

rbtr_lang_bash/tests/test_docstrings.py

@@ -0,0 +1,50 @@
+"""Bash docstring-extraction tests.
+
+Bash docs are exterior (a leading `#` comment run); there are no
+interior-doc cases, so only the documented / undocumented / exterior-doc
+checks apply.
+"""
+
+from __future__ import annotations
+
+from pytest_cases import parametrize_with_cases
+
+from rbtr.git import FileEntry
+from rbtr.languages.extract import extract_file
+
+
+@parametrize_with_cases(
+    "lang, source, name, snippet", cases=".cases_docstrings", has_tag="documented"
+)
+def test_documented_chunk_includes_doc_text(
+    lang: str, source: str, name: str, snippet: str
+) -> None:
+    """By default the chunk content carries the symbol's docs."""
+    chunks = extract_file(FileEntry("input", "sha1", source.encode()), lang)
+    chunk = next(c for c in chunks if c.name == name)
+    assert snippet in chunk.content, (
+        f"expected {snippet!r} in {lang}.{name} content; got:\n{chunk.content!r}"
+    )
+
+
+@parametrize_with_cases(
+    "lang, source, name, snippet", cases=".cases_docstrings", has_tag="undocumented"
+)
+def test_no_phantom_documentation(lang: str, source: str, name: str, snippet: str) -> None:
+    """Symbols without documentation do not gain any in content."""
+    chunks = extract_file(FileEntry("input", "sha1", source.encode()), lang)
+    chunk = next(c for c in chunks if c.name == name)
+    assert snippet not in chunk.content, (
+        f"unexpected {snippet!r} in {lang}.{name} content; got:\n{chunk.content!r}"
+    )
+
+
+@parametrize_with_cases(
+    "lang, source, name, snippet", cases=".cases_docstrings", has_tag="exterior_doc"
+)
+def test_leading_doc_folds_into_symbol(lang: str, source: str, name: str, snippet: str) -> None:
+    """A leading comment block folds into its symbol's chunk content."""
+    chunk = next(
+        c for c in extract_file(FileEntry("input", "sha1", source.encode()), lang) if c.name == name
+    )
+    assert snippet in chunk.content

rbtr_lang_bash/tests/test_extraction.py

@@ -0,0 +1,54 @@
+"""Bash extraction tests.
+
+Construct/mixed cases (`cases_extraction.py`) drive the shared checks;
+the function at the end pins bash's source/. import behaviour.
+"""
+
+from __future__ import annotations
+
+from pytest_cases import parametrize_with_cases
+
+from rbtr.git import FileEntry
+from rbtr.index.models import ChunkKind
+from rbtr.languages.extract import extract_file
+
+
+@parametrize_with_cases("lang, source, expected", cases=".cases_extraction", has_tag="symbol")
+def test_extracts_expected_symbols(lang: str, source: str, expected: list) -> None:
+    """Each expected (kind, name, scope) tuple appears in the output."""
+    chunks = extract_file(FileEntry("input", "sha1", source.encode()), lang)
+    symbols = [(c.kind, c.name, c.scope) for c in chunks]
+    for exp in expected:
+        assert exp in symbols, f"expected {exp} not found in {symbols}"
+
+
+@parametrize_with_cases(
+    "lang, source, expected_kinds, expected_methods", cases=".cases_extraction", has_tag="mixed"
+)
+def test_extracts_all_expected_kinds(
+    lang: str,
+    source: str,
+    expected_kinds: set[str],
+    expected_methods: list[tuple[str, str]],
+) -> None:
+    """Realistic source produces all expected chunk kinds and method scoping."""
+    chunks = extract_file(FileEntry("input", "sha1", source.encode()), lang)
+    kinds = {c.kind for c in chunks}
+    for kind in expected_kinds:
+        assert kind in kinds, f"expected kind {kind!r} not in {kinds}"
+    methods = [(c.name, c.scope) for c in chunks if c.kind == ChunkKind.METHOD]
+    for name, scope in expected_methods:
+        assert (name, scope) in methods, f"expected method ({name}, {scope}) not in {methods}"
+
+
+def test_bash_source_and_dot_extracted_as_imports() -> None:
+    """source/. commands are captured as imports."""
+    src = """\
+source ./env.sh
+. /etc/profile
+"""
+    chunks = extract_file(FileEntry("input", "sha1", src.encode()), "bash")
+    imports = [c for c in chunks if c.kind == ChunkKind.IMPORT]
+    assert len(imports) == 2
+    modules = {c.metadata.module for c in imports}
+    assert modules == {"./env.sh", "/etc/profile"}

rbtr_lang_bash/tests/test_samples.py

@@ -0,0 +1,82 @@
+"""Bash sample extraction: the `samples/bash/` project through the real pipeline.
+
+The snapshots are the golden record of what bash extraction produces;
+regenerate with `pytest --snapshot-update` after an intended change.
+Engine-wide invariants (determinism, line numbers, syntax-error recovery)
+are covered once in core, not re-run per language.
+"""
+
+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/bash/` project."""
+    root = Path(__file__).parent / "samples" / "bash"
+    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 "bash"
+        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()
+    return infer_import_edges(chunks, {p for p, _ in project}, build_resolution_map(manager))
+
+
+def test_emits_expected_kinds(chunks: list[Chunk]) -> None:
+    """The sample exercises bash's function, variable, and import chunks."""
+    kinds = {c.kind for c in chunks}
+    assert {
+        ChunkKind.FUNCTION,
+        ChunkKind.VARIABLE,
+        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 "bash")
+        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_bash-2026.7.0.dev0.dist-info/METADATA

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

rbtr_lang_bash-2026.7.0.dev0.dist-info/RECORD

@@ -0,0 +1,18 @@
+rbtr_lang_bash/__init__.py,sha256=gIm_kg0Z44nZ487E3GfD3rnqm01SbLASuvJz9IMeURQ,36
+rbtr_lang_bash/bash.scm,sha256=6z_T45eiyqNWD7VS42YV5zYeFGdT7TjdTuK40vjxp2Y,693
+rbtr_lang_bash/plugin.py,sha256=ERZQS7oc8yeZxA9E-3lSY3bOh4RpjkjdUn4lnI7NeZM,1883
+rbtr_lang_bash/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rbtr_lang_bash/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rbtr_lang_bash/tests/__snapshots__/test_samples/test_edges_match_snapshot.json,sha256=T2W5YHLPuKqYLJZBcLQRHRhK2yfSMn-JCkg_U8H3JSU,147
+rbtr_lang_bash/tests/__snapshots__/test_samples/test_extraction_matches_snapshot.json,sha256=MVRWRbVx4xr3GG8WANzvamnrMP2eAikAWdAbpdPVYI4,5869
+rbtr_lang_bash/tests/cases_docstrings.py,sha256=LGUR8vywW6-VZ_ggGJ_sU3cwWQFhLN1zTXwjYbYbS-E,2783
+rbtr_lang_bash/tests/cases_extraction.py,sha256=-GFzlKNMemgTCcZ6GVal05iXd1p_ppW74q9uG-pAivs,2977
+rbtr_lang_bash/tests/samples/bash/bash.sh,sha256=nNGz3bDP5J8WztL2CUOzUEZZmSofbm4NldwxRzatCSc,848
+rbtr_lang_bash/tests/samples/bash/lib/colours.sh,sha256=IA4qng78MNbspyC9-_hv1OB0uLFDqn0h4z63JhWZI7Y,78
+rbtr_lang_bash/tests/test_docstrings.py,sha256=h-KpUyUEa5mYldkaihXNMHrPcpvnfdMLbMqDIEEkKxo,1885
+rbtr_lang_bash/tests/test_extraction.py,sha256=IM6nsVCwWLr90abB2pX8gIlfumo-e2U1MNVQRtTWZwQ,2089
+rbtr_lang_bash/tests/test_samples.py,sha256=NopyYvZ-ii6HleZFbqXadw0LV406DOStB3uemYvRQCQ,2855
+rbtr_lang_bash-2026.7.0.dev0.dist-info/WHEEL,sha256=CoDSoyhtC_eO_tlxRYzsTraPv1fPJRXFx91k6ISeAvA,81
+rbtr_lang_bash-2026.7.0.dev0.dist-info/entry_points.txt,sha256=wBTXG4ULNpbpy6Ab2s3Xn3gkLpbxle5HHhP_57BwHx0,52
+rbtr_lang_bash-2026.7.0.dev0.dist-info/METADATA,sha256=yQGc4z4irpb2YCfLiYjW6IzLsgbnI_r_mNOMMBNjaR0,220
+rbtr_lang_bash-2026.7.0.dev0.dist-info/RECORD,,

rbtr_lang_bash-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_bash-2026.7.0.dev0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[rbtr.languages]
+bash = rbtr_lang_bash.plugin:bash
+