assert-python-definition-is-used 20260823031322__py3-none-any.whl

assert_python_definition_is_used/__init__.py

@@ -0,0 +1 @@
+"""Assert that every public Python definition in a tree is named somewhere else."""

assert_python_definition_is_used/__main__.py

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

assert_python_definition_is_used/cli.py

@@ -0,0 +1,408 @@
+"""Command-line interface for assert-python-definition-is-used."""
+
+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 Definition, Finding, public_definitions, unused_definitions
+
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
+EXIT_SUCCESS = 0
+EXIT_FINDINGS = 1
+EXIT_ERROR = 2
+
+GLOB_CHARACTERS = ("*", "?", "[")
+
+
+@dataclass
+class ScanResult:
+    """The outcome of one run over a set of trees."""
+
+    findings: list[Finding] = field(default_factory=list)
+    definitions_read: int = 0
+    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-python-definition-is-used",
+        description=(
+            "Assert that every public top-level definition in the given trees is named "
+            "somewhere else. A definition whose last caller was deleted keeps its tests, "
+            "keeps its coverage and is never called again, so nothing else reports it."
+        ),
+    )
+
+    parser.add_argument(
+        "trees",
+        nargs="+",
+        metavar="TREE",
+        help=(
+            "One or more file paths, directory paths, or glob patterns holding the "
+            "definitions to check. Directories are read recursively for *.py files."
+        ),
+    )
+
+    parser.add_argument(
+        "--consumer",
+        action="append",
+        default=None,
+        metavar="PATH",
+        dest="consumers",
+        help=(
+            "A tree to search for uses, repeatable. Defaults to the definition trees, "
+            "so pass it for every other place a caller may live."
+        ),
+    )
+
+    parser.add_argument(
+        "--own-tests",
+        metavar="TEMPLATE",
+        help=(
+            "A path template containing {package} whose files do not count as users, "
+            "such as 'test/lib/python/test_{package}'. Without it a module held at full "
+            "coverage by its own tests always reads as used."
+        ),
+    )
+
+    parser.add_argument(
+        "--count-defining-file",
+        action="store_true",
+        help=(
+            "Count a name written elsewhere in its own defining file as a use. Off by "
+            "default, because a docstring example, an __all__ entry and a call from a "
+            "function that is itself dead all read alike."
+        ),
+    )
+
+    parser.add_argument(
+        "--exclude",
+        metavar="PATTERNS",
+        help="Comma-separated glob patterns to exclude files, from both trees.",
+    )
+
+    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 trees read, definitions found, 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 unused definition.",
+    )
+    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_python_files(directory: str) -> list[str]:
+    """Find every *.py file under a directory, ignoring hidden directories."""
+    found: list[str] = []
+    for root, directories, filenames in os.walk(directory):
+        directories[:] = [name for name in directories if not name.startswith(".")]
+        found.extend(
+            os.path.join(root, filename) for filename in filenames if filename.endswith(".py")
+        )
+    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_python_files(entry))
+        return (found, bool(matched))
+    if os.path.isfile(path):
+        return ([path], True)
+    if os.path.isdir(path):
+        return (_walk_python_files(path), True)
+    return ([], False)
+
+
+def package_of(path: str, tree: str) -> str | None:
+    """Name the package a file belongs to, relative to the tree holding it.
+
+    A file sitting directly in the tree belongs to no package, and so has no
+    test directory of its own to discount.
+
+    Args:
+        path: The file path.
+        tree: The tree the file was found under.
+
+    Returns:
+        The first path component below the tree, or None.
+    """
+    relative = os.path.relpath(os.path.normpath(path), os.path.normpath(tree))
+    parts = relative.split(os.sep)
+    if len(parts) < 2 or parts[0] in ("", os.pardir):
+        return None
+    return parts[0]
+
+
+def _tree_root(path: str) -> str:
+    """Reduce a tree argument to the directory its files hang from."""
+    if os.path.isdir(path):
+        return path
+    stripped = path.split("*")[0].split("?")[0].split("[")[0]
+    directory = os.path.dirname(stripped)
+    return directory if directory else "."
+
+
+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[dict[str, str], list[str]]:
+    """Expand paths into files, keeping the tree each file came from.
+
+    Args:
+        paths: File paths, directory paths or glob patterns.
+        exclude_patterns: Glob patterns to exclude.
+
+    Returns:
+        A mapping of normalised file path to the tree it came from, and the
+        paths that named nothing.
+    """
+    trees: dict[str, str] = {}
+    missing: list[str] = []
+    for path in paths:
+        found, matched = _expand(path)
+        if not matched:
+            missing.append(path)
+            continue
+        root = _tree_root(path)
+        for entry in found:
+            normalised = os.path.normpath(entry)
+            if normalised.endswith(".py") and not should_skip(normalised, exclude_patterns):
+                trees.setdefault(normalised, root)
+    return (trees, missing)
+
+
+def _read(path: str, result: ScanResult, verbose: bool) -> 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 as error:
+        print(f"Error reading {path}: {error}", file=sys.stderr)
+        result.had_error = True
+        if verbose:
+            print(f"Skipping (unreadable): {path}")
+        return None
+
+
+def read_sources(
+    paths: dict[str, str], result: ScanResult, verbose: bool = False
+) -> dict[str, str]:
+    """Read every file, keyed by path.
+
+    Args:
+        paths: A mapping of file path to the tree it came from.
+        result: The result to record read errors on.
+        verbose: Whether to name each file read.
+
+    Returns:
+        A mapping of file path to content, skipping the unreadable.
+    """
+    sources: dict[str, str] = {}
+    for path in sorted(paths):
+        content = _read(path, result, verbose)
+        if content is not None:
+            sources[path] = content
+    return sources
+
+
+def read_definitions(
+    paths: dict[str, str],
+    sources: dict[str, str],
+    result: ScanResult,
+    verbose: bool = False,
+) -> list[Definition]:
+    """Parse every definition file for its public top-level definitions.
+
+    Args:
+        paths: A mapping of definition file path to the tree it came from.
+        sources: Every readable file, keyed by path.
+        result: The result to record parse errors and counts on.
+        verbose: Whether to name each file scanned.
+
+    Returns:
+        Every public definition found, in path order.
+    """
+    definitions: list[Definition] = []
+    for path in sorted(paths):
+        if path not in sources:
+            continue
+        if verbose:
+            print(f"Scanning: {path}")
+        try:
+            found = public_definitions(path, sources[path], package_of(path, paths[path]))
+        except SyntaxError as error:
+            print(f"Syntax error in {path}: {error}", file=sys.stderr)
+            result.had_error = True
+            continue
+        result.files_scanned += 1
+        definitions.extend(found)
+    result.definitions_read = len(definitions)
+    return definitions
+
+
+def output_findings(findings: list[Finding], count_mode: bool = False) -> None:
+    """Print findings in the requested format.
+
+    Args:
+        findings: The findings to print.
+        count_mode: Print only how many there are.
+    """
+    if count_mode:
+        print(len(findings))
+        return
+    for finding in findings:
+        print(finding)
+
+
+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.verbose:
+        print()
+        print(f"Files scanned: {result.files_scanned}")
+        print(f"Definitions read: {result.definitions_read}")
+        print(f"Findings: {len(result.findings)}")
+        for finding in result.findings:
+            print(f"  Unused: {finding}")
+        if result.had_error:
+            print("Errors occurred during scanning.")
+        return
+    if not args.quiet:
+        output_findings(result.findings, args.count)
+
+
+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()
+
+    definition_paths, missing = _collect(args.trees, exclude_patterns)
+    consumer_paths, consumer_missing = _collect(args.consumers or args.trees, exclude_patterns)
+    missing.extend(consumer_missing)
+
+    for path in missing:
+        print(f"Error: Path not found: {path}", file=sys.stderr)
+    if not definition_paths and missing:
+        sys.exit(EXIT_ERROR)
+    if missing:
+        result.had_error = True
+
+    if args.verbose:
+        print(f"Reading {len(definition_paths)} definition file(s)...")
+        print(f"Searching {len(consumer_paths)} consumer file(s) for uses.")
+        if exclude_patterns:
+            print(f"Excluding patterns: {', '.join(exclude_patterns)}")
+        print()
+
+    sources = read_sources({**consumer_paths, **definition_paths}, result, args.verbose)
+    definitions = read_definitions(definition_paths, sources, result, args.verbose)
+    consumers = {path: content for path, content in sources.items() if path in consumer_paths}
+
+    findings = unused_definitions(
+        definitions, consumers, args.own_tests, args.count_defining_file
+    )
+    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_python_definition_is_used/scanner.py

@@ -0,0 +1,204 @@
+"""Core logic for finding public definitions that nothing else names."""
+
+from __future__ import annotations
+
+import ast
+import re
+from dataclasses import dataclass
+from functools import lru_cache
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from collections.abc import Iterator
+
+DEFINITION_NODES = (ast.AsyncFunctionDef, ast.ClassDef, ast.FunctionDef)
+
+
+@dataclass(frozen=True)
+class Definition:
+    """A public top-level definition found in a source file."""
+
+    path: str
+    line_number: int
+    name: str
+    package: str | None
+
+    def __str__(self) -> str:
+        """Format as path:line:name."""
+        return f"{self.path}:{self.line_number}:{self.name}"
+
+
+@dataclass(frozen=True)
+class Finding:
+    """A definition that nothing outside its own file and tests names."""
+
+    definition: Definition
+
+    @property
+    def path(self) -> str:
+        """The file the definition sits in."""
+        return self.definition.path
+
+    @property
+    def line_number(self) -> int:
+        """The line the definition starts on."""
+        return self.definition.line_number
+
+    @property
+    def name(self) -> str:
+        """The name of the definition."""
+        return self.definition.name
+
+    def __str__(self) -> str:
+        """Format as path:line:name."""
+        return str(self.definition)
+
+
+def is_public(name: str) -> bool:
+    """Check whether a name is public, meaning it has no leading underscore."""
+    return not name.startswith("_")
+
+
+def public_definitions(path: str, content: str, package: str | None = None) -> list[Definition]:
+    """Find every public top-level definition in a source file.
+
+    Only top-level statements are read. A method on a class and a function
+    nested inside another function are reached through the name of the thing
+    that holds them, so neither is a definition this tool can speak about.
+
+    Args:
+        path: The file path, used for reporting.
+        content: The file content to parse.
+        package: The package the file belongs to, if any.
+
+    Returns:
+        The public definitions, in the order they appear.
+
+    Raises:
+        SyntaxError: If the content cannot be parsed as Python.
+    """
+    tree = ast.parse(content, filename=path)
+    return [
+        Definition(path=path, line_number=node.lineno, name=node.name, package=package)
+        for node in tree.body
+        if isinstance(node, DEFINITION_NODES) and is_public(node.name)
+    ]
+
+
+@lru_cache(maxsize=4096)
+def _word_pattern(name: str) -> re.Pattern[str]:
+    """Compile, and remember, a whole-word pattern for a name."""
+    return re.compile(rf"\b{re.escape(name)}\b")
+
+
+def names_in_line(name: str, line: str) -> bool:
+    """Check whether a line names an identifier as a whole word."""
+    return _word_pattern(name).search(line) is not None
+
+
+def names_in_content(name: str, content: str, skipped_line: int | None = None) -> bool:
+    """Check whether content names an identifier as a whole word.
+
+    Args:
+        name: The identifier to look for.
+        content: The text to search.
+        skipped_line: A 1-indexed line to ignore, if any.
+
+    Returns:
+        True if any line other than the skipped one names the identifier.
+    """
+    if skipped_line is None:
+        return names_in_line(name, content)
+    return any(
+        names_in_line(name, line)
+        for number, line in enumerate(content.splitlines(), 1)
+        if number != skipped_line
+    )
+
+
+def own_tests_directory(template: str | None, package: str | None) -> str | None:
+    """Render the directory holding a package's own tests.
+
+    Args:
+        template: A path template containing ``{package}``, or None.
+        package: The package name to substitute, or None.
+
+    Returns:
+        The rendered directory with a trailing separator, or None when there
+        is no template or the file belongs to no package.
+    """
+    if template is None or package is None:
+        return None
+    rendered = template.format(package=package)
+    return rendered if rendered.endswith("/") else rendered + "/"
+
+
+def _searchable(
+    sources: dict[str, str],
+    definition: Definition,
+    own_tests: str | None,
+    count_defining_file: bool,
+) -> Iterator[tuple[str, int | None]]:
+    """Yield each file to search, with the line to ignore within it."""
+    for path, content in sources.items():
+        if own_tests is not None and path.startswith(own_tests):
+            continue
+        if path == definition.path:
+            if not count_defining_file:
+                continue
+            yield content, definition.line_number
+        else:
+            yield content, None
+
+
+def is_used(
+    definition: Definition,
+    sources: dict[str, str],
+    own_tests: str | None = None,
+    count_defining_file: bool = False,
+) -> bool:
+    """Check whether anything names a definition.
+
+    Args:
+        definition: The definition to look for.
+        sources: Every consumer file, keyed by path, mapped to its content.
+        own_tests: A directory whose files do not count as users, if any.
+        count_defining_file: Whether a name written elsewhere in the defining
+            file counts as a use. A docstring example, an ``__all__`` entry and
+            a call from a function that is itself dead all read alike, so this
+            is off by default.
+
+    Returns:
+        True if any file names the definition.
+    """
+    return any(
+        names_in_content(definition.name, content, skipped)
+        for content, skipped in _searchable(sources, definition, own_tests, count_defining_file)
+    )
+
+
+def unused_definitions(
+    definitions: list[Definition],
+    sources: dict[str, str],
+    own_tests_template: str | None = None,
+    count_defining_file: bool = False,
+) -> list[Finding]:
+    """Find the definitions nothing names.
+
+    Args:
+        definitions: The definitions to check.
+        sources: Every consumer file, keyed by path, mapped to its content.
+        own_tests_template: A path template containing ``{package}`` whose
+            files do not count as users, if any.
+        count_defining_file: Whether a name written elsewhere in the defining
+            file counts as a use.
+
+    Returns:
+        A finding for each definition nothing names.
+    """
+    findings = []
+    for definition in definitions:
+        own_tests = own_tests_directory(own_tests_template, definition.package)
+        if not is_used(definition, sources, own_tests, count_defining_file):
+            findings.append(Finding(definition=definition))
+    return findings

assert_python_definition_is_used-20260823031322.dist-info/METADATA

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: assert-python-definition-is-used
+Version: 20260823031322
+Summary: CLI tool to assert that every public Python definition in a tree is used somewhere else
+Author-email: 10U Labs <dev@10ulabs.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/10U-Labs/assert-python-definition-is-used
+Project-URL: Repository, https://github.com/10U-Labs/assert-python-definition-is-used
+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
+Dynamic: license-file
+
+# assert-python-definition-is-used
+
+Assert that every public Python definition in a tree is named somewhere
+else.
+
+## Why
+
+A function whose last caller is deleted does not disappear. Its tests
+still pass, the coverage gate over its module stays green, and static
+analysis keeps reading it, so the tree grows a layer of code that is
+maintained and never called. Nothing in a normal toolchain reports it:
+coverage measures whether lines run, not whether anything wants them,
+and a module held at 100% by its own tests manufactures exactly the
+evidence that makes it look used.
+
+This tool asks the other question. For every public top-level `def` and
+`class` in the trees you point it at, it asks whether anything else
+names it, and reports the ones nothing does.
+
+## Installation
+
+```bash
+pip install assert-python-definition-is-used
+```
+
+## Usage
+
+```bash
+# Every definition in lib/python must be named somewhere in the repo
+assert-python-definition-is-used lib/python \
+  --consumer lib/python --consumer scripts --consumer src --consumer test
+
+# The same, but a module's own tests no longer count as a caller
+assert-python-definition-is-used lib/python \
+  --consumer lib/python --consumer scripts --consumer src --consumer test \
+  --own-tests 'test/lib/python/test_{package}'
+```
+
+Those two runs are the pair worth having. The first is a cheap outer
+bound that catches a definition whose tests were deleted along with its
+caller. The second is the one that finds code kept alive only by the
+tests written for it, which is what a coverage gate hides.
+
+### Options
+
+| Option | Effect |
+| --- | --- |
+| `--consumer PATH` | A tree to search for uses. Repeatable. |
+| `--own-tests TEMPLATE` | Template whose files are not users. |
+| `--count-defining-file` | Count a use in the defining file. |
+| `--exclude PATTERNS` | Comma-separated globs to leave out of both trees. |
+| `--quiet` | Print nothing; report through the exit code. |
+| `--count` | Print only how many findings there were. |
+| `--verbose` | Print the trees read, each file scanned, and a summary. |
+| `--fail-fast` | Stop at the first finding. |
+| `--warn-only` | Always exit 0. |
+
+### Exit codes
+
+| Code | Meaning |
+| --- | --- |
+| 0 | Nothing unused |
+| 1 | Something unused |
+| 2 | A tree was missing, unreadable, or would not parse |
+
+## What counts as a use
+
+A use is the definition's name written as a whole word in any file the
+consumer trees reach. That is deliberately blunt, and it has two
+consequences worth knowing before you read the output.
+
+By default a name written elsewhere in its own defining file does not
+count. A docstring example, an `__all__` entry and a call from a
+sibling that is itself dead all look the same as a live caller, so
+crediting them hides real findings. Pass `--count-defining-file` for the
+looser rule. When the stricter rule reports a definition that a live
+sibling in the same file genuinely calls, the finding is that the
+definition is public and should not be: rename it with a leading
+underscore, which takes it out of scope.
+
+Matching on a bare name also means a definition reads as used when any
+other file happens to contain that word, including a file that defines
+its own unrelated function of the same name. The count is a lower bound
+rather than an exact figure.
+
+Only top-level `def` and `class` statements are read. A method and a
+nested function are reached through the name of the thing that holds
+them, so neither is something this tool can speak about. Names starting
+with an underscore are skipped.
+
+## Packages and their own tests
+
+`--own-tests` takes a path template rather than a fixed layout, because
+the convention differs between repositories. The `{package}` field is
+the first directory below the definition tree:
+
+```text
+lib/python/aws_clients/__init__.py  ->  package is "aws_clients"
+```
+
+So `--own-tests 'test/lib/python/test_{package}'` discounts uses under
+`test/lib/python/test_aws_clients/`, and
+`--own-tests 'test/lib/python/{package}'` discounts uses under
+`test/lib/python/aws_clients/`.
+
+A file sitting directly in the definition tree belongs to no package
+and so has no test directory to discount. Uses of its definitions count
+wherever they appear.
+
+## GitHub Actions
+
+```yaml
+- name: Assert every definition is used outside its own tests
+  uses: 10U-Labs/assert-python-definition-is-used@latest
+  with:
+    consumers: lib/python scripts src test
+    own-tests: test/lib/python/test_{package}
+    trees: lib/python
+    verbose: true
+```
+
+## License
+
+Apache-2.0

assert_python_definition_is_used-20260823031322.dist-info/RECORD

@@ -0,0 +1,11 @@
+assert_python_definition_is_used/__init__.py,sha256=9sLJ1H1UCMAsSDXvYdE4fhLuia4rmenVQ-ZS4_TFUq0,84
+assert_python_definition_is_used/__main__.py,sha256=WHvRaaHXV42YBDfprj8MRY9TaxRWeXTU4zWiBztAMHk,108
+assert_python_definition_is_used/cli.py,sha256=inxqRtBmHi1OnwgsAV7_aKL1lEqKITcFIPzt42C4QZ0,12889
+assert_python_definition_is_used/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+assert_python_definition_is_used/scanner.py,sha256=iw09-UtGb877djejhzih3WPeOq_nU01w7BgcjKDaqgM,6508
+assert_python_definition_is_used-20260823031322.dist-info/licenses/LICENSE.txt,sha256=7C7FkuzwSQFE_PL6st5x2YyMN1aiyjZ9ti1s5X45no8,10761
+assert_python_definition_is_used-20260823031322.dist-info/METADATA,sha256=u5RC8Nx716Vn34B1y9_LBXQ7hxHeZMSv_M7cqUmY8eg,5581
+assert_python_definition_is_used-20260823031322.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+assert_python_definition_is_used-20260823031322.dist-info/entry_points.txt,sha256=0hRlDENoZVXrGPiF4uyrOB4JczdxiKI8FjlruCVZnGs,95
+assert_python_definition_is_used-20260823031322.dist-info/top_level.txt,sha256=kUSqtiu2F8Pw2YUxnQH6dg37fioaCpUu0hlXL5m2hbg,33
+assert_python_definition_is_used-20260823031322.dist-info/RECORD,,

assert_python_definition_is_used-20260823031322.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_python_definition_is_used-20260823031322.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+assert-python-definition-is-used = assert_python_definition_is_used.cli:main

assert_python_definition_is_used-20260823031322.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_python_definition_is_used-20260823031322.dist-info/top_level.txt

@@ -0,0 +1 @@
+assert_python_definition_is_used