proofctl 0.1.2__tar.gz → 0.1.3__tar.gz

{proofctl-0.1.2 → proofctl-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proofctl
-Version: 0.1.2
+Version: 0.1.3
 Summary: Zero-dependency linter for Python, Terraform, Dockerfiles, Kubernetes, and GitHub Actions — catches AI slop and security misconfigurations pre-commit
 Author-email: Kolawolu Odunola <kolawolu.o@gmail.com>
 License: MIT
@@ -491,48 +491,6 @@ Print all rule IDs, names, and severities.
 
 ---
 
-## Architecture
-
-proofctl is a pure Python AST linter with zero subprocess dependencies. It walks the repository with Python's `pathlib`, runs AST visitors for Python files, and custom regex/text parsers for Terraform HCL, Dockerfiles, and YAML. This makes it:
-
-- **Fast** — typically < 1s for a 10k-line Python repo
-- **Offline** — no network calls needed with `--no-pypi`
-- **Dependency-free** — only `typer`, `rich`, `pyyaml` are required at runtime
-
-```
-proofctl/
-├── cli.py               # typer commands: check, baseline, rules
-├── engine.py            # orchestrator: walks files, dispatches checkers
-├── config.py            # .proofctl.yaml loader
-├── models.py            # Finding dataclass + Severity enum
-├── baseline.py          # snapshot save/load/filter
-├── fixer.py             # auto-fix for Q-001
-├── checkers/
-│   ├── placeholders.py  # P family
-│   ├── quality.py       # Q family
-│   ├── security.py      # S family (S-001 to S-013)
-│   ├── leakage.py       # L family
-│   ├── imports.py       # I family
-│   ├── methods.py       # M family
-│   ├── variants.py      # V family
-│   ├── llm.py           # LLM family
-│   ├── terraform.py     # TF/TG families (T, G, A, AZ, M, V, TG)
-│   ├── dockerfile.py    # DF family
-│   └── yaml_checker.py  # YAML/K8s/GHA families
-└── reporters/
-    ├── terminal.py
-    ├── json_reporter.py
-    └── html_reporter.py
-```
-
----
-
-## Companion tool
-
-[**shieldctl**](https://pypi.org/project/shieldctl) — CI-stage scanner that wraps best-of-breed external tools (checkov, tfsec, gitleaks, shellcheck, hadolint, actionlint, pip-audit) for deeper infrastructure security scanning. Run proofctl pre-commit; run shieldctl in CI.
-
----
-
 ## License
 
 MIT

{proofctl-0.1.2 → proofctl-0.1.3}/README.md

@@ -460,48 +460,6 @@ Print all rule IDs, names, and severities.
 
 ---
 
-## Architecture
-
-proofctl is a pure Python AST linter with zero subprocess dependencies. It walks the repository with Python's `pathlib`, runs AST visitors for Python files, and custom regex/text parsers for Terraform HCL, Dockerfiles, and YAML. This makes it:
-
-- **Fast** — typically < 1s for a 10k-line Python repo
-- **Offline** — no network calls needed with `--no-pypi`
-- **Dependency-free** — only `typer`, `rich`, `pyyaml` are required at runtime
-
-```
-proofctl/
-├── cli.py               # typer commands: check, baseline, rules
-├── engine.py            # orchestrator: walks files, dispatches checkers
-├── config.py            # .proofctl.yaml loader
-├── models.py            # Finding dataclass + Severity enum
-├── baseline.py          # snapshot save/load/filter
-├── fixer.py             # auto-fix for Q-001
-├── checkers/
-│   ├── placeholders.py  # P family
-│   ├── quality.py       # Q family
-│   ├── security.py      # S family (S-001 to S-013)
-│   ├── leakage.py       # L family
-│   ├── imports.py       # I family
-│   ├── methods.py       # M family
-│   ├── variants.py      # V family
-│   ├── llm.py           # LLM family
-│   ├── terraform.py     # TF/TG families (T, G, A, AZ, M, V, TG)
-│   ├── dockerfile.py    # DF family
-│   └── yaml_checker.py  # YAML/K8s/GHA families
-└── reporters/
-    ├── terminal.py
-    ├── json_reporter.py
-    └── html_reporter.py
-```
-
----
-
-## Companion tool
-
-[**shieldctl**](https://pypi.org/project/shieldctl) — CI-stage scanner that wraps best-of-breed external tools (checkov, tfsec, gitleaks, shellcheck, hadolint, actionlint, pip-audit) for deeper infrastructure security scanning. Run proofctl pre-commit; run shieldctl in CI.
-
----
-
 ## License
 
 MIT

proofctl-0.1.3/proofctl/reporters/terminal.py

@@ -0,0 +1,88 @@
+from __future__ import annotations
+
+from collections import Counter
+
+from rich import box
+from rich.console import Console
+from rich.padding import Padding
+from rich.table import Table
+from rich.text import Text
+
+from ..models import Finding, Severity
+
+_BADGE: dict[Severity, tuple[str, str]] = {
+    Severity.ERROR:   ("bold white on red",        "ERROR"),
+    Severity.WARNING: ("bold black on yellow",      "WARNING"),
+    Severity.INFO:    ("bold white on grey50",      "INFO"),
+}
+
+_SEV_STYLE: dict[Severity, str] = {
+    Severity.ERROR:   "bold red",
+    Severity.WARNING: "bold yellow",
+    Severity.INFO:    "dim",
+}
+
+console = Console(highlight=False, width=160)
+
+
+def _location(f: Finding) -> str:
+    if f.line:
+        return f"{f.file}:{f.line}"
+    return f.file
+
+
+class TerminalReporter:
+    def render(self, findings: list[Finding]) -> str:
+        if not findings:
+            console.print(Padding("[bold green]✓  No findings.[/bold green]", (1, 2)))
+            return ""
+
+        console.print()
+
+        sorted_findings = sorted(
+            findings, key=lambda x: (-x.severity, x.file, x.line or 0)
+        )
+
+        table = Table(
+            box=box.HORIZONTALS,
+            show_header=True,
+            show_edge=True,
+            show_lines=True,
+            header_style="bold",
+            padding=(0, 1),
+        )
+        table.add_column("Severity",  no_wrap=True, min_width=10, max_width=10)
+        table.add_column("Rule",      no_wrap=True, min_width=20, max_width=28)
+        table.add_column("Family",    no_wrap=True, min_width=10, max_width=30)
+        table.add_column("Location",  no_wrap=True, min_width=24, max_width=44)
+        table.add_column("Message",   no_wrap=True, min_width=20, max_width=60)
+
+        for f in sorted_findings:
+            badge_style, badge_label = _BADGE[f.severity]
+            sev_cell = Text(f"  {badge_label}  ", style=badge_style)
+            msg = f.message if len(f.message) <= 60 else f.message[:57] + "..."
+            table.add_row(
+                sev_cell,
+                Text(f.rule_id, style="bold"),
+                Text(f.rule_name, style="dim"),
+                Text(_location(f), style=_SEV_STYLE[f.severity]),
+                Text(msg),
+            )
+
+        console.print(Padding(table, (0, 2)))
+        console.print()
+
+        # Summary bar
+        counts = Counter(f.severity for f in findings)
+        total = len(findings)
+        bar = Text(f"  {total} finding{'s' if total != 1 else ''}    ")
+        for sev in reversed(Severity):
+            if not counts[sev]:
+                continue
+            badge_style, badge_label = _BADGE[sev]
+            bar.append(f"  {badge_label}  ", style=badge_style)
+            bar.append(f"  {counts[sev]}   ", style="bold")
+        console.print(bar)
+        console.print()
+
+        return ""

{proofctl-0.1.2 → proofctl-0.1.3}/proofctl.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proofctl
-Version: 0.1.2
+Version: 0.1.3
 Summary: Zero-dependency linter for Python, Terraform, Dockerfiles, Kubernetes, and GitHub Actions — catches AI slop and security misconfigurations pre-commit
 Author-email: Kolawolu Odunola <kolawolu.o@gmail.com>
 License: MIT
@@ -491,48 +491,6 @@ Print all rule IDs, names, and severities.
 
 ---
 
-## Architecture
-
-proofctl is a pure Python AST linter with zero subprocess dependencies. It walks the repository with Python's `pathlib`, runs AST visitors for Python files, and custom regex/text parsers for Terraform HCL, Dockerfiles, and YAML. This makes it:
-
-- **Fast** — typically < 1s for a 10k-line Python repo
-- **Offline** — no network calls needed with `--no-pypi`
-- **Dependency-free** — only `typer`, `rich`, `pyyaml` are required at runtime
-
-```
-proofctl/
-├── cli.py               # typer commands: check, baseline, rules
-├── engine.py            # orchestrator: walks files, dispatches checkers
-├── config.py            # .proofctl.yaml loader
-├── models.py            # Finding dataclass + Severity enum
-├── baseline.py          # snapshot save/load/filter
-├── fixer.py             # auto-fix for Q-001
-├── checkers/
-│   ├── placeholders.py  # P family
-│   ├── quality.py       # Q family
-│   ├── security.py      # S family (S-001 to S-013)
-│   ├── leakage.py       # L family
-│   ├── imports.py       # I family
-│   ├── methods.py       # M family
-│   ├── variants.py      # V family
-│   ├── llm.py           # LLM family
-│   ├── terraform.py     # TF/TG families (T, G, A, AZ, M, V, TG)
-│   ├── dockerfile.py    # DF family
-│   └── yaml_checker.py  # YAML/K8s/GHA families
-└── reporters/
-    ├── terminal.py
-    ├── json_reporter.py
-    └── html_reporter.py
-```
-
----
-
-## Companion tool
-
-[**shieldctl**](https://pypi.org/project/shieldctl) — CI-stage scanner that wraps best-of-breed external tools (checkov, tfsec, gitleaks, shellcheck, hadolint, actionlint, pip-audit) for deeper infrastructure security scanning. Run proofctl pre-commit; run shieldctl in CI.
-
----
-
 ## License
 
 MIT

{proofctl-0.1.2 → proofctl-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "proofctl"
-version = "0.1.2"
+version = "0.1.3"
 description = "Zero-dependency linter for Python, Terraform, Dockerfiles, Kubernetes, and GitHub Actions — catches AI slop and security misconfigurations pre-commit"
 readme = "README.md"
 license = { text = "MIT" }

proofctl-0.1.2/proofctl/reporters/terminal.py

@@ -1,110 +0,0 @@
-from __future__ import annotations
-
-from collections import Counter
-
-from rich import box
-from rich.console import Console
-from rich.padding import Padding
-from rich.table import Table
-from rich.text import Text
-
-from ..models import Finding, Severity
-
-_BADGE: dict[Severity, tuple[str, str]] = {
-    Severity.ERROR:   ("bold white on red",        "ERROR"),
-    Severity.WARNING: ("bold black on yellow",      "WARNING"),
-    Severity.INFO:    ("bold white on grey50",      "INFO"),
-}
-
-_LOC_COLOUR: dict[Severity, str] = {
-    Severity.ERROR:   "red",
-    Severity.WARNING: "yellow",
-    Severity.INFO:    "dim",
-}
-
-_FAMILY_LABEL: dict[str, str] = {
-    "P": "Placeholder",
-    "L": "Leakage",
-    "Q": "Quality",
-    "I": "Import",
-    "M": "Method",
-    "V": "Variant",
-}
-
-console = Console(highlight=False)
-
-
-def _location(f: Finding) -> str:
-    if f.line:
-        return f"{f.file}:{f.line}"
-    return f.file
-
-
-class TerminalReporter:
-    def render(self, findings: list[Finding]) -> str:
-        if not findings:
-            console.print(Padding("[bold green]✓  No findings.[/bold green]", (1, 2)))
-            return ""
-
-        console.print()
-
-        by_severity: dict[Severity, list[Finding]] = {}
-        for f in findings:
-            by_severity.setdefault(f.severity, []).append(f)
-
-        for sev in reversed(Severity):
-            group = by_severity.get(sev)
-            if not group:
-                continue
-
-            badge_style, badge_label = _BADGE[sev]
-            loc_colour = _LOC_COLOUR[sev]
-            count = len(group)
-
-            header = Text("  ")
-            header.append(f"  {badge_label}  ", style=badge_style)
-            header.append(f"   {count} finding{'s' if count != 1 else ''}",
-                          style="bold")
-            console.print(header)
-            console.print()
-
-            table = Table(
-                box=box.SIMPLE_HEAD,
-                show_header=True,
-                show_edge=False,
-                header_style="dim",
-                padding=(0, 1),
-            )
-            table.add_column("Rule", no_wrap=True, min_width=20, max_width=24)
-            table.add_column("Found at", overflow="fold", ratio=1)
-
-            for f in group:
-                rule_cell = Text()
-                rule_cell.append(f.rule_id, style="bold")
-                rule_cell.append(f"\n{f.rule_name}", style="dim")
-
-                found_cell = Text()
-                found_cell.append(_location(f), style=loc_colour)
-                found_cell.append(f"\n  {f.message}", style="default")
-                if f.hint:
-                    found_cell.append(f"\n  → {f.hint}", style="dim italic")
-
-                table.add_row(rule_cell, found_cell)
-
-            console.print(Padding(table, (0, 2)))
-            console.print()
-
-        # Summary bar
-        counts = Counter(f.severity for f in findings)
-        total = len(findings)
-        bar = Text(f"  {total} finding{'s' if total != 1 else ''}    ")
-        for sev in reversed(Severity):
-            if not counts[sev]:
-                continue
-            badge_style, badge_label = _BADGE[sev]
-            bar.append(f"  {badge_label}  ", style=badge_style)
-            bar.append(f"  {counts[sev]}   ", style="bold")
-        console.print(bar)
-        console.print()
-
-        return ""