assert-no-comments 20260823131905__py3-none-any.whl

assert_no_comments/__init__.py

@@ -0,0 +1 @@
+"""Assert that nothing in a tree carries a comment or a docstring."""

assert_no_comments/__main__.py

@@ -0,0 +1,5 @@
+"""Entry point for running as python -m assert_no_comments."""
+
+from .cli import main
+
+main()

assert_no_comments/cli.py

@@ -0,0 +1,333 @@
+"""Command-line interface for assert-no-comments."""
+
+from __future__ import annotations
+
+import argparse
+import fnmatch
+import glob
+import os
+import sys
+from dataclasses import dataclass, field
+from typing import TYPE_CHECKING
+
+from .scanner import Finding, Unreadable, comments_in, reader_for
+
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
+EXIT_SUCCESS = 0
+EXIT_FINDINGS = 1
+EXIT_ERROR = 2
+
+GLOB_CHARACTERS = ("*", "?", "[")
+
+SKIPPED_DIRECTORIES = (".git", "__pycache__", "node_modules")
+
+MESSAGE = "carries a comment or a docstring; delete it and let the code say what it does"
+
+
+@dataclass
+class ScanResult:
+    """The outcome of one run over a set of trees."""
+
+    findings: list[Finding] = field(default_factory=list)
+    files_scanned: int = 0
+    had_error: bool = False
+
+
+def create_parser() -> argparse.ArgumentParser:
+    """Create the argument parser for the CLI."""
+    parser = argparse.ArgumentParser(
+        prog="assert-no-comments",
+        description=(
+            "Assert that nothing in the given trees carries a comment or a docstring. "
+            "Prose beside code is never checked, so it stops being true and nothing says "
+            "when, and the reader who believes it works from a program that no longer "
+            "exists."
+        ),
+    )
+
+    parser.add_argument(
+        "trees",
+        nargs="+",
+        metavar="TREE",
+        help=(
+            "One or more file paths, directory paths, or glob patterns to read. "
+            "Directories are read recursively, and a file whose suffix names no "
+            "language this understands is left alone."
+        ),
+    )
+
+    parser.add_argument(
+        "--exclude",
+        metavar="PATTERNS",
+        help=(
+            "Comma-separated glob patterns to leave out, such as "
+            "'src/www/spa/vendor/*' for code somebody else wrote."
+        ),
+    )
+
+    parser.add_argument(
+        "--annotate",
+        action="store_true",
+        help=(
+            "Print each finding as a GitHub Actions ::error annotation, so it lands on "
+            "the line it names in the diff."
+        ),
+    )
+
+    output_group = parser.add_mutually_exclusive_group()
+    output_group.add_argument(
+        "--quiet",
+        action="store_true",
+        help="Suppress all output. Exit code indicates success (0) or findings (1).",
+    )
+    output_group.add_argument(
+        "--count",
+        action="store_true",
+        help="Output only the count of findings.",
+    )
+    output_group.add_argument(
+        "--verbose",
+        action="store_true",
+        help="Show the files read, the findings and a summary.",
+    )
+
+    behavior_group = parser.add_mutually_exclusive_group()
+    behavior_group.add_argument(
+        "--fail-fast",
+        action="store_true",
+        help="Exit immediately after finding the first comment.",
+    )
+    behavior_group.add_argument(
+        "--warn-only",
+        action="store_true",
+        help="Always exit with code 0, even if findings exist.",
+    )
+
+    return parser
+
+
+def parse_patterns(patterns_str: str | None) -> list[str]:
+    """Parse a comma-separated patterns string.
+
+    Args:
+        patterns_str: Comma-separated patterns, or None.
+
+    Returns:
+        The patterns, empty when the input is None or blank.
+    """
+    if not patterns_str:
+        return []
+    return [pattern.strip() for pattern in patterns_str.split(",") if pattern.strip()]
+
+
+def _is_glob_pattern(path: str) -> bool:
+    """Check whether a path holds glob wildcard characters."""
+    return any(character in path for character in GLOB_CHARACTERS)
+
+
+def _walk_source_files(directory: str) -> list[str]:
+    """Find every file under a directory a reader speaks the language of."""
+    found: list[str] = []
+    for root, directories, filenames in os.walk(directory):
+        directories[:] = [name for name in directories if name not in SKIPPED_DIRECTORIES]
+        found.extend(
+            os.path.join(root, filename)
+            for filename in filenames
+            if reader_for(filename) is not None
+        )
+    return found
+
+
+def _expand(path: str) -> tuple[list[str], bool]:
+    """Expand one path, directory or glob into the files it names.
+
+    Args:
+        path: A file path, directory path or glob pattern.
+
+    Returns:
+        The files it names, and whether it named anything at all.
+    """
+    if _is_glob_pattern(path):
+        matched = glob.glob(path, recursive=True, include_hidden=True)
+        found: list[str] = []
+        for entry in matched:
+            if os.path.isfile(entry):
+                found.append(entry)
+            elif os.path.isdir(entry):
+                found.extend(_walk_source_files(entry))
+        return (found, bool(matched))
+    if os.path.isfile(path):
+        return ([path], True)
+    if os.path.isdir(path):
+        return (_walk_source_files(path), True)
+    return ([], False)
+
+
+def should_skip(path: str, exclude_patterns: list[str]) -> bool:
+    """Check whether a file matches any exclude pattern.
+
+    Args:
+        path: The file path to check.
+        exclude_patterns: Glob patterns to exclude.
+
+    Returns:
+        True when the path or its basename matches a pattern.
+    """
+    return any(
+        fnmatch.fnmatch(path, pattern) or fnmatch.fnmatch(os.path.basename(path), pattern)
+        for pattern in exclude_patterns
+    )
+
+
+def collect(paths: Sequence[str], exclude_patterns: list[str]) -> tuple[list[str], list[str]]:
+    """Expand paths into the files to read.
+
+    Args:
+        paths: File paths, directory paths or glob patterns.
+        exclude_patterns: Glob patterns to exclude.
+
+    Returns:
+        The files to read, sorted and without repeats, and the paths that
+        named nothing.
+    """
+    found: set[str] = set()
+    missing: list[str] = []
+    for path in paths:
+        expanded, matched = _expand(path)
+        if not matched:
+            missing.append(path)
+            continue
+        for entry in expanded:
+            normalised = os.path.normpath(entry)
+            if reader_for(normalised) is not None and not should_skip(
+                normalised, exclude_patterns
+            ):
+                found.add(normalised)
+    return (sorted(found), missing)
+
+
+def _read(path: str, result: ScanResult) -> str | None:
+    """Read one file, recording an error on the result if it cannot be read."""
+    try:
+        with open(path, encoding="utf-8") as handle:
+            return handle.read()
+    except (OSError, UnicodeDecodeError) as error:
+        print(f"Error reading {path}: {error}", file=sys.stderr)
+        result.had_error = True
+        return None
+
+
+def read_comments(paths: Sequence[str], result: ScanResult, verbose: bool = False) -> list[Finding]:
+    """Read every file and collect the comments it carries.
+
+    Args:
+        paths: The files to read.
+        result: The result to record read errors and counts on.
+        verbose: Whether to name each file read.
+
+    Returns:
+        Every finding, in path order.
+    """
+    findings: list[Finding] = []
+    for path in paths:
+        content = _read(path, result)
+        if content is None:
+            continue
+        if verbose:
+            print(f"Reading: {path}")
+        try:
+            findings.extend(comments_in(path, content))
+        except Unreadable as error:
+            print(f"Could not parse {path}: {error}", file=sys.stderr)
+            result.had_error = True
+            continue
+        result.files_scanned += 1
+    return findings
+
+
+def output_findings(
+    findings: list[Finding], count_mode: bool = False, annotate: bool = False
+) -> None:
+    """Print findings in the requested format.
+
+    Args:
+        findings: The findings to print.
+        count_mode: Print only how many there are.
+        annotate: Print each as a GitHub Actions ::error annotation.
+    """
+    if count_mode:
+        print(len(findings))
+        return
+    for finding in findings:
+        if annotate:
+            print(
+                f"::error file={finding.path},line={finding.line_number}::"
+                f"{finding} {MESSAGE}"
+            )
+        else:
+            print(f"{finding}: {MESSAGE}")
+
+
+def determine_exit_code(result: ScanResult, warn_only: bool = False) -> int:
+    """Choose the exit code for a result.
+
+    Args:
+        result: The scan result.
+        warn_only: Always succeed when true.
+
+    Returns:
+        0 for success, 1 for findings, 2 for errors.
+    """
+    if warn_only:
+        return EXIT_SUCCESS
+    if result.findings:
+        return EXIT_FINDINGS
+    if result.had_error:
+        return EXIT_ERROR
+    return EXIT_SUCCESS
+
+
+def _report(result: ScanResult, args: argparse.Namespace) -> None:
+    """Print whatever the chosen output mode asks for."""
+    if args.quiet:
+        return
+    output_findings(result.findings, args.count, args.annotate)
+    if args.verbose:
+        print()
+        print(f"Files scanned: {result.files_scanned}")
+        print(f"Findings: {len(result.findings)}")
+        if result.had_error:
+            print("Errors occurred during scanning.")
+
+
+def main(argv: Sequence[str] | None = None) -> None:
+    """Run the CLI.
+
+    Args:
+        argv: Command-line arguments, defaulting to sys.argv[1:].
+    """
+    args = create_parser().parse_args(argv)
+    exclude_patterns = parse_patterns(args.exclude)
+    result = ScanResult()
+
+    paths, missing = collect(args.trees, exclude_patterns)
+    for path in missing:
+        print(f"Error: Path not found: {path}", file=sys.stderr)
+    if not paths and missing:
+        sys.exit(EXIT_ERROR)
+    if missing:
+        result.had_error = True
+
+    if args.verbose:
+        print(f"Reading {len(paths)} file(s)...")
+        if exclude_patterns:
+            print(f"Excluding patterns: {', '.join(exclude_patterns)}")
+        print()
+
+    findings = read_comments(paths, result, args.verbose)
+    result.findings = findings[:1] if (args.fail_fast and findings) else findings
+
+    _report(result, args)
+    sys.exit(determine_exit_code(result, args.warn_only))

assert_no_comments/scanner.py

@@ -0,0 +1,266 @@
+"""Readers that find every comment and docstring a source file carries."""
+
+from __future__ import annotations
+
+import ast
+import bisect
+import io
+import os
+import tokenize
+from dataclasses import dataclass
+from typing import TYPE_CHECKING
+
+import yaml
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+DEFINITION_NODES = (ast.AsyncFunctionDef, ast.ClassDef, ast.FunctionDef, ast.Module)
+
+OPENS_A_PATTERN = "(,=:[!&|?{};+-*%~^<>"
+
+
+class Unreadable(Exception):
+    """A file no reader could parse."""
+
+
+@dataclass(frozen=True)
+class Finding:
+    """A line carrying a comment or a docstring."""
+
+    path: str
+    line_number: int
+
+    def __str__(self) -> str:
+        """Format as path:line."""
+        return f"{self.path}:{self.line_number}"
+
+
+def _lines_of(text: str, places: list[int]) -> list[int]:
+    """Turn character offsets into the one-based lines holding them."""
+    breaks = [place for place, character in enumerate(text) if character == "\n"]
+    return sorted({bisect.bisect_right(breaks, place) + 1 for place in places})
+
+
+def _past_quoted(text: str, place: int) -> int:
+    """Step over a quoted string, honouring backslash escapes."""
+    quote = text[place]
+    place += 1
+    while place < len(text):
+        if text[place] == "\\":
+            place += 2
+        elif text[place] == quote:
+            return place + 1
+        else:
+            place += 1
+    return place
+
+
+def _past_line(text: str, place: int) -> int:
+    """Step to the end of the line an offset sits on."""
+    end = text.find("\n", place)
+    return len(text) if end < 0 else end
+
+
+def _past_block(text: str, place: int, closing: str) -> int:
+    """Step over a block comment, to the end of the file when nobody closed it."""
+    end = text.find(closing, place + len(closing))
+    return len(text) if end < 0 else end + len(closing)
+
+
+def _opens_a_pattern(text: str, place: int) -> bool:
+    """Decide whether a slash starts a regular expression rather than a division."""
+    before = text[:place].rstrip()
+    return not before or before[-1] in OPENS_A_PATTERN or before.endswith("return")
+
+
+def _past_pattern(text: str, place: int) -> int:
+    """Step over a regular expression literal, ending it at a line break."""
+    place += 1
+    inside_a_class = False
+    while place < len(text):
+        character = text[place]
+        if character == "\\":
+            place += 2
+        elif character == "\n":
+            return place
+        elif character == "[":
+            inside_a_class = True
+            place += 1
+        elif character == "]":
+            inside_a_class = False
+            place += 1
+        elif character == "/" and not inside_a_class:
+            return place + 1
+        else:
+            place += 1
+    return place
+
+
+def marked_comments(
+    text: str,
+    quotes: str,
+    line_markers: tuple[str, ...],
+    block: tuple[str, str],
+    patterns: bool,
+) -> list[int]:
+    """Find the comments in a language that marks them with fixed characters.
+
+    Args:
+        text: The file content.
+        quotes: Every character that opens a string.
+        line_markers: Every marker running a comment to the end of the line.
+        block: The opening and closing markers of a block comment.
+        patterns: Whether a slash can open a regular expression literal.
+
+    Returns:
+        The lines a comment starts on, sorted and without repeats.
+    """
+    places: list[int] = []
+    place = 0
+    while place < len(text):
+        character = text[place]
+        if character in quotes:
+            place = _past_quoted(text, place)
+        elif any(text.startswith(marker, place) for marker in line_markers):
+            places.append(place)
+            place = _past_line(text, place)
+        elif text.startswith(block[0], place):
+            places.append(place)
+            place = _past_block(text, place, block[1])
+        elif patterns and character == "/" and _opens_a_pattern(text, place):
+            place = _past_pattern(text, place)
+        else:
+            place += 1
+    return _lines_of(text, places)
+
+
+def hcl_comments(text: str) -> list[int]:
+    """Find the comments in an OpenTofu or Terraform file.
+
+    Args:
+        text: The file content.
+
+    Returns:
+        The lines a comment starts on.
+    """
+    return marked_comments(text, '"', ("#", "//"), ("/*", "*/"), False)
+
+
+def javascript_comments(text: str) -> list[int]:
+    """Find the comments in a JavaScript file.
+
+    Args:
+        text: The file content.
+
+    Returns:
+        The lines a comment starts on.
+    """
+    return marked_comments(text, "\"'`", ("//",), ("/*", "*/"), True)
+
+
+def python_comments(text: str) -> list[int]:
+    """Find the comments and docstrings in a Python file.
+
+    A docstring is the first statement of a module, class or function when it
+    is a bare string constant, which is prose beside code exactly as a comment
+    is.
+
+    Args:
+        text: The file content.
+
+    Returns:
+        The lines a comment or docstring starts on.
+    """
+    places = [
+        token.start[0]
+        for token in tokenize.generate_tokens(io.StringIO(text).readline)
+        if token.type == tokenize.COMMENT
+    ]
+    for node in ast.walk(ast.parse(text)):
+        if not isinstance(node, DEFINITION_NODES) or not node.body:
+            continue
+        opening = node.body[0]
+        if isinstance(opening, ast.Expr) and isinstance(opening.value, ast.Constant):
+            if isinstance(opening.value.value, str):
+                places.append(opening.lineno)
+    return sorted(set(places))
+
+
+def yaml_comments(text: str) -> list[int]:
+    """Find the comments in a YAML file.
+
+    The scanner reports the span of every token, so anything left over that is
+    not whitespace is a comment.
+
+    Args:
+        text: The file content.
+
+    Returns:
+        The lines a comment starts on.
+    """
+    covered = bytearray(len(text))
+    for token in yaml.scan(text):
+        for place in range(token.start_mark.index, token.end_mark.index):
+            covered[place] = 1
+    return _lines_of(
+        text,
+        [place for place, seen in enumerate(covered) if not seen and not text[place].isspace()],
+    )
+
+
+GENERATED_FILES = (".terraform.lock.hcl",)
+
+READERS: dict[str, Callable[[str], list[int]]] = {
+    ".cjs": javascript_comments,
+    ".hcl": hcl_comments,
+    ".jsx": javascript_comments,
+    ".js": javascript_comments,
+    ".mjs": javascript_comments,
+    ".py": python_comments,
+    ".tf": hcl_comments,
+    ".tfvars": hcl_comments,
+    ".yaml": yaml_comments,
+    ".yml": yaml_comments,
+}
+
+
+def reader_for(path: str) -> Callable[[str], list[int]] | None:
+    """Choose the reader for a file, by its suffix.
+
+    A generated file is nobody's source, so no reader speaks for it either:
+    a finding against a lock file is answerable by nobody.
+
+    Args:
+        path: The file path.
+
+    Returns:
+        The reader, or None when no reader speaks for that file.
+    """
+    if os.path.basename(path) in GENERATED_FILES:
+        return None
+    return READERS.get(os.path.splitext(path)[1])
+
+
+def comments_in(path: str, content: str) -> list[Finding]:
+    """Find every comment and docstring in one file.
+
+    Args:
+        path: The file path, which chooses the reader.
+        content: The file content.
+
+    Returns:
+        A finding for each line carrying a comment, empty when no reader
+        speaks the language.
+
+    Raises:
+        Unreadable: The reader could not parse the file.
+    """
+    reader = reader_for(path)
+    if reader is None:
+        return []
+    try:
+        lines = reader(content)
+    except (SyntaxError, ValueError, tokenize.TokenError, yaml.YAMLError) as error:
+        raise Unreadable(str(error)) from error
+    return [Finding(path, line) for line in lines]

assert_no_comments-20260823131905.dist-info/METADATA

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: assert-no-comments
+Version: 20260823131905
+Summary: CLI tool to assert that nothing in a tree carries a comment or a docstring
+Author-email: 10U Labs <dev@10ulabs.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/10U-Labs/assert-no-comments
+Project-URL: Repository, https://github.com/10U-Labs/assert-no-comments
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: pyyaml>=6.0
+Dynamic: license-file
+
+# assert-no-comments
+
+Assert that nothing in a tree carries a comment or a docstring.
+
+## Why
+
+Prose beside code is never checked. The compiler does not read it, the
+tests do not run it, and no linter asks whether it is still true, so it
+stops being true and nothing says when. The reader who believes it then
+works from a program that no longer exists, which is worse than having
+read nothing at all.
+
+A rename is where the cost shows up first. Change one identifier and
+every sentence naming it is now wrong, in files the change never
+touched, and the diff gives no way to find them.
+
+So this tool takes the other position: a name, a signature and the shape
+of a function are the whole of what a reader gets. When that is not
+enough to say what a thing holds or does, the thing is named or shaped
+wrong rather than under-explained. The reasoning still gets written
+down, in the commit message and the issue, each of which is dated and
+attached to a change instead of sitting beside a line claiming to
+describe it forever.
+
+## Installation
+
+```bash
+pip install assert-no-comments
+```
+
+## Usage
+
+```bash
+# Every tree this repository publishes
+assert-no-comments .github/workflows etc lib scripts src test
+
+# The same, leaving out code somebody else wrote
+assert-no-comments .github/workflows etc lib scripts src test \
+  --exclude 'src/www/spa/vendor/*'
+```
+
+### Options
+
+| Option | Effect |
+| --- | --- |
+| `--exclude PATTERNS` | Comma-separated globs to leave out. |
+| `--annotate` | Print each finding as a GitHub Actions `::error` annotation. |
+| `--quiet` | Print nothing; report through the exit code. |
+| `--count` | Print only how many findings there were. |
+| `--verbose` | Print the files read, the findings and a summary. |
+| `--fail-fast` | Stop at the first finding. |
+| `--warn-only` | Always exit 0. |
+
+### Exit codes
+
+| Code | Meaning |
+| --- | --- |
+| 0 | Nothing carries a comment |
+| 1 | Something carries a comment |
+| 2 | A tree was missing, unreadable, or would not parse |
+
+## What counts as a comment
+
+| Read as | Suffixes | Reported |
+| --- | --- | --- |
+| Python | `.py` | `#`, and any module, class or function docstring |
+| YAML | `.yml`, `.yaml` | `#` |
+| OpenTofu | `.tf`, `.tfvars`, `.hcl` | `#`, `//`, and `/* */` blocks |
+| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` | `//`, and `/* */` blocks |
+
+A file whose suffix names none of those is left alone, so a `.md` file
+is never read: prose is the content of a markdown file rather than a
+gloss on a line of code. `.terraform.lock.hcl` is left alone too,
+because OpenTofu writes its header and nobody can delete it.
+
+A docstring counts as a comment. It is the same prose in the same place,
+and the fact that a language keeps it in `__doc__` does not make it any
+more likely to still be true.
+
+Each reader knows the difference between a marker and a character that
+merely looks like one. A `#` inside a Python string, a YAML quoted
+scalar or a block scalar is content. A `//` inside a JavaScript string,
+template literal or regular expression is content, and a `/` after a
+name is division rather than the start of a pattern.
+
+Python is read with `tokenize` and `ast`, and YAML with the `yaml`
+scanner, so a file that will not parse is an error rather than a file
+with nothing in it. The marker languages are read character by character
+and never fail: an unclosed string swallows the rest of the file, and an
+unclosed block comment is still reported where it opened.
+
+## What is walked
+
+A directory argument is read recursively. Hidden directories are read,
+because `.github/workflows` is one of the trees most worth checking.
+`.git`, `__pycache__` and `node_modules` are skipped, and everything
+else you want left out goes in `--exclude`.
+
+The usual thing to exclude is code somebody else wrote:
+
+```bash
+assert-no-comments src --exclude 'src/www/spa/vendor/*'
+```
+
+Nobody here can answer for a vendored library, and a finding against one
+is answerable by nobody, so it is not worth reporting.
+
+## GitHub Actions
+
+```yaml
+- name: Assert nothing this repository publishes carries a comment
+  uses: 10U-Labs/assert-no-comments@latest
+  with:
+    exclude: src/www/spa/vendor/*
+    trees: .github/workflows etc lib scripts src test
+```
+
+`annotate` defaults to true there, so each finding lands on the line it
+names in the diff.
+
+## License
+
+Apache-2.0

assert_no_comments-20260823131905.dist-info/RECORD

@@ -0,0 +1,11 @@
+assert_no_comments/__init__.py,sha256=a8e_nW-haIHAffTgSdrjpcHv18aQ-WQ1HPp35OSO7vI,70
+assert_no_comments/__main__.py,sha256=G7OM6b3SUaXjKW8bcUMRsWATpGCQa-5DgGnAxDVN64Y,94
+assert_no_comments/cli.py,sha256=kOydsoL1-AP-uTBw6dqqRXMzC5laDbQYU_xA8VQy3Nk,9999
+assert_no_comments/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+assert_no_comments/scanner.py,sha256=g9yxOyd6Kwf-5bJFs8mjdBnaRrxbJKptYXc0Uw3WCPc,7745
+assert_no_comments-20260823131905.dist-info/licenses/LICENSE.txt,sha256=7C7FkuzwSQFE_PL6st5x2YyMN1aiyjZ9ti1s5X45no8,10761
+assert_no_comments-20260823131905.dist-info/METADATA,sha256=HVs4mBD693ctOsPV10WH06eNLB8erzH52oijsWxIzU4,5376
+assert_no_comments-20260823131905.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+assert_no_comments-20260823131905.dist-info/entry_points.txt,sha256=Wp7TJYwdpIUuX0jmPsXwgN-WabtTdW7AOi9V9bR-4U0,67
+assert_no_comments-20260823131905.dist-info/top_level.txt,sha256=LigOyDP_803WrESxkx0tVyAQKD4zDGHQohSsxVZ_Ke8,19
+assert_no_comments-20260823131905.dist-info/RECORD,,

assert_no_comments-20260823131905.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

assert_no_comments-20260823131905.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+assert-no-comments = assert_no_comments.cli:main

assert_no_comments-20260823131905.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2024 10U Labs LLC
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

assert_no_comments-20260823131905.dist-info/top_level.txt

@@ -0,0 +1 @@
+assert_no_comments