house-lint 0.1.1__tar.gz

house_lint-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jessica
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

house_lint-0.1.1/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: house-lint
+Version: 0.1.1
+Summary: Jessica's opinionated Python house-style linter
+Keywords: lint,python,house-style,pre-commit
+Author: Jessica
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Dist: cyclopts>=3.0
+Requires-Dist: pathspec>=0.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# house-lint
+
+> Opinionated Python house-style linter for comments, imports, module layout, and deliberately configured project conventions.
+
+`house-lint` packages a specific set of checks used across a handful of Python projects. It is intentionally not a general-purpose style framework, an LLM-authorship detector, or a replacement for Ruff.
+
+## Quick start
+
+You need Python 3.11 or later.
+
+```bash
+uvx house-lint check
+```
+
+You see the selected root, configuration, enabled rules, file counts, findings, and a final summary. The default scan looks for `src`, `tests`, `scripts`, `tools`, and `examples` under the project root.
+
+Install it in a project when you want a pinned development dependency:
+
+```bash
+uv add --dev house-lint
+uv run house-lint check
+```
+
+## Rules
+
+The four default rules are `HSL001`–`HSL004`. `HSL900` always reports invalid suppressions.
+
+| ID | Default | Checks |
+| --- | --- | --- |
+| `HSL001` | On | AI-writing tells in comments and docstrings, never ordinary strings |
+| `HSL002` | On | Imports inside function or async-function bodies |
+| `HSL003` | On | Top-level `TYPE_CHECKING` guards followed by imports |
+| `HSL004` | On | Module constants after the first class/function, except derived bindings |
+| `HSL101` | Off | Configured planning/spec tokens in comments, docstrings, and filenames |
+| `HSL102` | Off | Files whose `splitlines()` count exceeds a configured limit |
+| `HSL103` | Off | Bound exception names outside the allowed policy |
+| `HSL900` | Always | Invalid, unused, conflicting, or malformed suppressions |
+
+List the installed rule metadata:
+
+```bash
+house-lint rules --format json
+```
+
+The command writes a schema-versioned JSON object containing all eight IDs and their enablement modes.
+
+See [the rule reference](docs/rules.md) for exact rule behavior.
+
+## Configuration
+
+Put configuration in your project `pyproject.toml`:
+
+```toml
+[tool.house-lint]
+include = ["src", "tests"]
+exclude = ["generated/"]
+select = ["HSL001", "HSL002", "HSL003", "HSL004", "HSL101", "HSL102", "HSL103"]
+
+[tool.house-lint.rules.HSL102]
+max_lines = 800
+
+[tool.house-lint.rules.HSL103]
+allowed = ["exc", "*_exc"]
+
+[[tool.house-lint.rules.HSL101.tokens]]
+prefixes = ["AC", "FR", "NFR", "WP"]
+hash = "optional"
+min_digits = 1
+suffix = "optional-lower-alpha"
+scopes = ["comments", "docstrings", "filenames"]
+case_sensitive = true
+```
+
+`HSL101` requires at least one token family whenever you select it. `HSL102` defaults to `800` lines and `HSL103` defaults to `exc` or `*_exc` when selected.
+
+CLI selection overrides configuration:
+
+```bash
+house-lint check --select HSL002,HSL103 --ignore HSL103
+```
+
+Each `--select` or `--ignore` occurrence accepts one comma-separated list. Selection is strict: unknown, duplicate, empty, and `HSL900` IDs are usage errors.
+
+Read [configuration](docs/configuration.md) for discovery, precedence, validation, excludes, and token-family options.
+
+## Paths, roots, and Git ignores
+
+With no paths, `check` scans configured include roots. With paths, it scans only those explicit Python files or recursively expanded explicit directories:
+
+```bash
+house-lint check src/service.py tests
+```
+
+Explicit paths are strict. Missing, out-of-root, and non-Python file arguments are errors; ignored or excluded explicit Python files are counted as skipped. `--root` fixes the project boundary and only considers `<root>/pyproject.toml`. Without `--root`, discovery starts at the current directory. `--config` selects an exact configuration file; without `--root`, its parent becomes the root.
+
+The linter loads only the selected root's `.gitignore`, plus built-in and configured excludes. It does not search nested `.gitignore` files or shell out to Git. Use `--no-gitignore` to disable only the root `.gitignore`.
+
+## Suppressions
+
+Suppress a finding only with a rule ID and a meaningful reason (at least three alphanumeric characters):
+
+```python
+def load_plugin():
+    import plugin  # house-lint: ignore[HSL002] - avoids a circular import
+
+
+# house-lint: ignore-next[HSL103] - compatibility callback signature
+try:
+    callback()
+except OSError as error:
+    raise
+
+# house-lint: ignore-file[HSL102] - generated compatibility module
+```
+
+`ignore` attaches to its containing statement. A comment-only `ignore-next` attaches to the next statement in the same suite, even across ordinary comments and blank lines. A top-of-file `ignore-file` applies to the listed enabled rules throughout the file. `HSL900` cannot be suppressed.
+
+Read [suppressions](docs/suppressions.md) before adding one; malformed, misplaced, disabled, unknown, unused, duplicate, and conflicting pragmas produce `HSL900`.
+
+## Pre-commit
+
+Run the installed CLI from a local pre-commit hook:
+
+```yaml
+repos:
+  - repo: local
+    hooks:
+      - id: house-lint
+        name: house-lint
+        entry: house-lint check
+        language: system
+        types: [python]
+        files: \.py$
+```
+
+The distributed `.pre-commit-hooks.yaml` exposes the same `house-lint` hook for a published repository. Both forms filter to existing `*.py` files before invocation. The CLI remains strict, so manual explicit paths still fail for missing or non-Python files.
+
+## Output and exits
+
+Use JSON for machine consumers:
+
+```bash
+house-lint check --format json
+```
+
+JSON stdout is always one parseable schema-version-1 object. It always includes `root`, `config`, `enabled_rules`, file counts, findings, errors, and summary counts. `root` and `config` are absolute strings when available and `null` otherwise; filename and file-level findings have all location fields set to `null`.
+
+Finding `message` values are human-readable display text, not stable machine keys. Machine consumers should use rule IDs and locations for findings, and error `code` values for operational failures.
+
+| Exit | Meaning |
+| ---: | --- |
+| 0 | Complete scan with no visible findings or errors |
+| 1 | Complete scan with lint findings, including `HSL900` |
+| 2 | CLI usage or configuration error; scanning did not start |
+| 3 | Incomplete scan: path, traversal, budget, read, decode, tokenize, or syntax error |
+| 4 | Unexpected internal error caught at the CLI boundary |
+
+Exit precedence is `4 > 3 > 2 > 1 > 0`. In JSON mode, diagnostics stay in the JSON result on stdout; `--debug` writes additional details only to stderr.
+
+`errors[*].code` is the stable machine-readable error taxonomy. `kind`, `phase`, and `operation` provide context and may gain new values without changing an existing error code.
+
+| Code | Meaning |
+| --- | --- |
+| `config-error` | CLI argument or configuration loading failure |
+| `path-error` | Invalid root, explicit path, or selected source path |
+| `traversal-error` | Discovery or root `.gitignore` filesystem failure |
+| `budget-error` | Discovery or candidate-count safety limit exceeded |
+| `source-too-large` | A selected source file exceeds the 10 MiB read limit |
+| `read-error` | A selected source file could not be read |
+| `decode-error` | A selected source file could not be decoded |
+| `tokenize-error` | A selected source file could not be tokenized |
+| `syntax-error` | A selected source file could not be parsed as Python |
+| `internal-error` | An unexpected failure crossed the CLI boundary |
+
+## Development
+
+```bash
+uv run pytest
+uv run ruff check .
+uv run pyright
+```
+
+See [the changelog](CHANGELOG.md) for compatibility notes.
+
+## Releases
+
+CI tests Python 3.11 through 3.14 and runs Ruff, Pyright, and a package build. [Release Please](https://github.com/googleapis/release-please) manages version bumps, changelog updates, and GitHub releases from Conventional Commits. Distributions are published to PyPI via Trusted Publishing.

house_lint-0.1.1/README.md

@@ -0,0 +1,187 @@
+# house-lint
+
+> Opinionated Python house-style linter for comments, imports, module layout, and deliberately configured project conventions.
+
+`house-lint` packages a specific set of checks used across a handful of Python projects. It is intentionally not a general-purpose style framework, an LLM-authorship detector, or a replacement for Ruff.
+
+## Quick start
+
+You need Python 3.11 or later.
+
+```bash
+uvx house-lint check
+```
+
+You see the selected root, configuration, enabled rules, file counts, findings, and a final summary. The default scan looks for `src`, `tests`, `scripts`, `tools`, and `examples` under the project root.
+
+Install it in a project when you want a pinned development dependency:
+
+```bash
+uv add --dev house-lint
+uv run house-lint check
+```
+
+## Rules
+
+The four default rules are `HSL001`–`HSL004`. `HSL900` always reports invalid suppressions.
+
+| ID | Default | Checks |
+| --- | --- | --- |
+| `HSL001` | On | AI-writing tells in comments and docstrings, never ordinary strings |
+| `HSL002` | On | Imports inside function or async-function bodies |
+| `HSL003` | On | Top-level `TYPE_CHECKING` guards followed by imports |
+| `HSL004` | On | Module constants after the first class/function, except derived bindings |
+| `HSL101` | Off | Configured planning/spec tokens in comments, docstrings, and filenames |
+| `HSL102` | Off | Files whose `splitlines()` count exceeds a configured limit |
+| `HSL103` | Off | Bound exception names outside the allowed policy |
+| `HSL900` | Always | Invalid, unused, conflicting, or malformed suppressions |
+
+List the installed rule metadata:
+
+```bash
+house-lint rules --format json
+```
+
+The command writes a schema-versioned JSON object containing all eight IDs and their enablement modes.
+
+See [the rule reference](docs/rules.md) for exact rule behavior.
+
+## Configuration
+
+Put configuration in your project `pyproject.toml`:
+
+```toml
+[tool.house-lint]
+include = ["src", "tests"]
+exclude = ["generated/"]
+select = ["HSL001", "HSL002", "HSL003", "HSL004", "HSL101", "HSL102", "HSL103"]
+
+[tool.house-lint.rules.HSL102]
+max_lines = 800
+
+[tool.house-lint.rules.HSL103]
+allowed = ["exc", "*_exc"]
+
+[[tool.house-lint.rules.HSL101.tokens]]
+prefixes = ["AC", "FR", "NFR", "WP"]
+hash = "optional"
+min_digits = 1
+suffix = "optional-lower-alpha"
+scopes = ["comments", "docstrings", "filenames"]
+case_sensitive = true
+```
+
+`HSL101` requires at least one token family whenever you select it. `HSL102` defaults to `800` lines and `HSL103` defaults to `exc` or `*_exc` when selected.
+
+CLI selection overrides configuration:
+
+```bash
+house-lint check --select HSL002,HSL103 --ignore HSL103
+```
+
+Each `--select` or `--ignore` occurrence accepts one comma-separated list. Selection is strict: unknown, duplicate, empty, and `HSL900` IDs are usage errors.
+
+Read [configuration](docs/configuration.md) for discovery, precedence, validation, excludes, and token-family options.
+
+## Paths, roots, and Git ignores
+
+With no paths, `check` scans configured include roots. With paths, it scans only those explicit Python files or recursively expanded explicit directories:
+
+```bash
+house-lint check src/service.py tests
+```
+
+Explicit paths are strict. Missing, out-of-root, and non-Python file arguments are errors; ignored or excluded explicit Python files are counted as skipped. `--root` fixes the project boundary and only considers `<root>/pyproject.toml`. Without `--root`, discovery starts at the current directory. `--config` selects an exact configuration file; without `--root`, its parent becomes the root.
+
+The linter loads only the selected root's `.gitignore`, plus built-in and configured excludes. It does not search nested `.gitignore` files or shell out to Git. Use `--no-gitignore` to disable only the root `.gitignore`.
+
+## Suppressions
+
+Suppress a finding only with a rule ID and a meaningful reason (at least three alphanumeric characters):
+
+```python
+def load_plugin():
+    import plugin  # house-lint: ignore[HSL002] - avoids a circular import
+
+
+# house-lint: ignore-next[HSL103] - compatibility callback signature
+try:
+    callback()
+except OSError as error:
+    raise
+
+# house-lint: ignore-file[HSL102] - generated compatibility module
+```
+
+`ignore` attaches to its containing statement. A comment-only `ignore-next` attaches to the next statement in the same suite, even across ordinary comments and blank lines. A top-of-file `ignore-file` applies to the listed enabled rules throughout the file. `HSL900` cannot be suppressed.
+
+Read [suppressions](docs/suppressions.md) before adding one; malformed, misplaced, disabled, unknown, unused, duplicate, and conflicting pragmas produce `HSL900`.
+
+## Pre-commit
+
+Run the installed CLI from a local pre-commit hook:
+
+```yaml
+repos:
+  - repo: local
+    hooks:
+      - id: house-lint
+        name: house-lint
+        entry: house-lint check
+        language: system
+        types: [python]
+        files: \.py$
+```
+
+The distributed `.pre-commit-hooks.yaml` exposes the same `house-lint` hook for a published repository. Both forms filter to existing `*.py` files before invocation. The CLI remains strict, so manual explicit paths still fail for missing or non-Python files.
+
+## Output and exits
+
+Use JSON for machine consumers:
+
+```bash
+house-lint check --format json
+```
+
+JSON stdout is always one parseable schema-version-1 object. It always includes `root`, `config`, `enabled_rules`, file counts, findings, errors, and summary counts. `root` and `config` are absolute strings when available and `null` otherwise; filename and file-level findings have all location fields set to `null`.
+
+Finding `message` values are human-readable display text, not stable machine keys. Machine consumers should use rule IDs and locations for findings, and error `code` values for operational failures.
+
+| Exit | Meaning |
+| ---: | --- |
+| 0 | Complete scan with no visible findings or errors |
+| 1 | Complete scan with lint findings, including `HSL900` |
+| 2 | CLI usage or configuration error; scanning did not start |
+| 3 | Incomplete scan: path, traversal, budget, read, decode, tokenize, or syntax error |
+| 4 | Unexpected internal error caught at the CLI boundary |
+
+Exit precedence is `4 > 3 > 2 > 1 > 0`. In JSON mode, diagnostics stay in the JSON result on stdout; `--debug` writes additional details only to stderr.
+
+`errors[*].code` is the stable machine-readable error taxonomy. `kind`, `phase`, and `operation` provide context and may gain new values without changing an existing error code.
+
+| Code | Meaning |
+| --- | --- |
+| `config-error` | CLI argument or configuration loading failure |
+| `path-error` | Invalid root, explicit path, or selected source path |
+| `traversal-error` | Discovery or root `.gitignore` filesystem failure |
+| `budget-error` | Discovery or candidate-count safety limit exceeded |
+| `source-too-large` | A selected source file exceeds the 10 MiB read limit |
+| `read-error` | A selected source file could not be read |
+| `decode-error` | A selected source file could not be decoded |
+| `tokenize-error` | A selected source file could not be tokenized |
+| `syntax-error` | A selected source file could not be parsed as Python |
+| `internal-error` | An unexpected failure crossed the CLI boundary |
+
+## Development
+
+```bash
+uv run pytest
+uv run ruff check .
+uv run pyright
+```
+
+See [the changelog](CHANGELOG.md) for compatibility notes.
+
+## Releases
+
+CI tests Python 3.11 through 3.14 and runs Ruff, Pyright, and a package build. [Release Please](https://github.com/googleapis/release-please) manages version bumps, changelog updates, and GitHub releases from Conventional Commits. Distributions are published to PyPI via Trusted Publishing.

house_lint-0.1.1/pyproject.toml

@@ -0,0 +1,60 @@
+[project]
+name = "house-lint"
+version = "0.1.1"
+description = "Jessica's opinionated Python house-style linter"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Jessica" }]
+keywords = ["lint", "python", "house-style", "pre-commit"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = ["cyclopts>=3.0", "pathspec>=0.12"]
+
+[project.scripts]
+house-lint = "house_lint.cli:main"
+
+[dependency-groups]
+dev = [
+  "pytest>=8.0",
+  "ruff>=0.9",
+  "pyright>=1.1",
+  "flake8>=7.0",
+  "flake8-async>=24.0",
+  "Flake8-pyproject>=1.2",
+  "pyyaml>=6.0",
+  "typos>=1.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.8.0,<0.9"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+exclude = ["design"]
+
+[tool.ruff.format]
+exclude = ["design"]
+
+[tool.pyright]
+include = ["src"]
+typeCheckingMode = "strict"
+
+[tool.flake8]
+exclude = [".venv", ".git"]
+max-line-length = 100

house_lint-0.1.1/src/house_lint/__init__.py

@@ -0,0 +1,9 @@
+"""Public package boundary for house-lint."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("house-lint")
+except PackageNotFoundError:
+    # Source checkouts have no installed distribution metadata.
+    __version__ = "0.1.1"

house_lint-0.1.1/src/house_lint/__main__.py

@@ -0,0 +1,6 @@
+"""Module entry point equivalent to the house-lint console script."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

house_lint-0.1.1/src/house_lint/analysis.py

@@ -0,0 +1,161 @@
+"""Private detector provenance models.
+
+These types intentionally do not form part of the reporter/configuration API.
+"""
+
+import ast
+from dataclasses import dataclass
+from enum import Enum
+
+from .source import SourceFile
+
+MAX_CANDIDATES_PER_FILE = 10_000
+
+
+class SourceKind(Enum):
+    STATEMENT = "statement"
+    FILE = "file"
+    FILENAME = "filename"
+    NO_OWNER = "no-owner"
+
+
+@dataclass(frozen=True)
+class StatementKey:
+    start_line: int
+    start_column: int
+    end_line: int
+    end_column: int
+
+
+@dataclass(frozen=True)
+class CandidateFinding:
+    rule_id: str
+    path: str
+    message: str
+    line: int | None
+    column: int | None
+    end_line: int | None
+    end_column: int | None
+    source_kind: SourceKind
+    owner: StatementKey | None = None
+
+
+class CandidateBudgetExceeded(RuntimeError):
+    """Raised when one file produces more candidates than the fixed safety limit."""
+
+    def __init__(self, path: str, *, candidates: tuple[CandidateFinding, ...] = ()) -> None:
+        self.path = path
+        self.limit = MAX_CANDIDATES_PER_FILE
+        self.candidates = candidates
+        super().__init__(f"candidate limit exceeded for {path}: {self.limit}")
+
+
+def append_candidate(
+    candidates: list[CandidateFinding],
+    candidate: CandidateFinding,
+    source: SourceFile,
+    limit: int | None,
+) -> None:
+    """Append a candidate without exceeding the per-detector capacity."""
+    if limit is not None and len(candidates) >= limit:
+        raise CandidateBudgetExceeded(source.relative_path, candidates=tuple(candidates))
+    candidates.append(candidate)
+
+
+def statement_key(statement: ast.stmt) -> StatementKey:
+    return StatementKey(
+        statement.lineno,
+        statement.col_offset + 1,
+        statement.end_lineno or statement.lineno,
+        (statement.end_col_offset or statement.col_offset) + 1,
+    )
+
+
+def candidate_for_statement(
+    source: SourceFile, rule_id: str, message: str, statement: ast.stmt
+) -> CandidateFinding:
+    """Build a candidate owned by an AST statement."""
+    owner = statement_key(statement)
+    return CandidateFinding(
+        rule_id,
+        source.relative_path,
+        message,
+        owner.start_line,
+        owner.start_column,
+        owner.end_line,
+        owner.end_column,
+        SourceKind.STATEMENT,
+        owner,
+    )
+
+
+def candidate_for_line(
+    source: SourceFile,
+    rule_id: str,
+    message: str,
+    line: int,
+    owner: ast.stmt | None = None,
+) -> CandidateFinding:
+    """Build a line candidate, retaining no-owner provenance when appropriate."""
+    statement_owner = statement_key(owner) if owner is not None else None
+    return CandidateFinding(
+        rule_id,
+        source.relative_path,
+        message,
+        line,
+        1,
+        line,
+        len(source.lines[line - 1]) + 1,
+        SourceKind.STATEMENT if statement_owner is not None else SourceKind.NO_OWNER,
+        statement_owner,
+    )
+
+
+def statement_owner_for_line(
+    source: SourceFile, line: int, column: int | None = None
+) -> ast.stmt | None:
+    """Return a comment's owner: innermost for trailing text, outermost at line ends."""
+    if column is not None and source.lines[line - 1][:column].strip():
+        candidates = [
+            statement
+            for statement in source.statements
+            if statement.lineno <= line <= (statement.end_lineno or statement.lineno)
+        ]
+    else:
+        candidates = [
+            statement
+            for statement in source.statements
+            if statement.lineno == line or (statement.end_lineno or statement.lineno) == line
+        ]
+    if not candidates:
+        return None
+    if column is not None:
+        return max(candidates, key=lambda statement: (statement.lineno, statement.col_offset))
+    return min(candidates, key=statement_span)
+
+
+def comment_owner_for_line(source: SourceFile, line: int, comment: str) -> ast.stmt | None:
+    """Return the statement syntactically attached to this comment token."""
+    return statement_owner_for_line(source, line, source.lines[line - 1].index(comment))
+
+
+def docstring_owner_for_line(source: SourceFile, line: int) -> ast.stmt:
+    """Return the string-expression statement containing a docstring line."""
+    for statement in source.statements:
+        if (
+            isinstance(statement, ast.Expr)
+            and isinstance(statement.value, ast.Constant)
+            and isinstance(statement.value.value, str)
+            and statement.lineno <= line <= (statement.end_lineno or statement.lineno)
+        ):
+            return statement
+    raise RuntimeError("docstring line has no string-expression statement")
+
+
+def statement_span(statement: ast.stmt) -> tuple[int, int, int, int]:
+    return (
+        (statement.end_lineno or statement.lineno) - statement.lineno,
+        (statement.end_col_offset or statement.col_offset) - statement.col_offset,
+        statement.lineno,
+        statement.col_offset,
+    )