ballpython 2.0.0__tar.gz → 2.0.3__tar.gz

ballpython-2.0.3/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: ballpython
+Version: 2.0.3
+Summary: The Ultimate Static Python Intelligence, Healing, Type Verification, and Security Suite
+Author: Developer
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: ruff>=0.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tomli>=1.1.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: isort>=5.13.0; extra == "dev"
+Provides-Extra: security
+Requires-Dist: cryptography>=41.0.0; extra == "security"
+Requires-Dist: defusedxml>=0.7.1; extra == "security"
+
+# ballpython
+
+[![PyPI version](https://img.shields.io/pypi/v/ballpython.svg)](https://pypi.org/project/ballpython/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/ballpython.svg)](https://pypi.org/project/ballpython/)
+[![CI](https://github.com/moonrox420/ball-python/actions/workflows/ci.yml/badge.svg)](https://github.com/moonrox420/ball-python/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**The zero-config Python code cleaner, syntax healer, and quality suite.**
+
+`ballpython` automatically repairs broken syntax, resolves missing imports, prunes dead code, scans for security vulnerabilities, and formats your code in a single command. Zero LLM dependencies, 100% offline, and fast.
+
+Both `ballpython` and `pycleaner` CLI commands are identical.
+
+---
+
+## Installation
+
+```bash
+pip install ballpython
+```
+
+---
+
+## Quickstart
+
+### 1. Fix and format your code
+Run `ballpython` on any file or directory. It automatically heals syntax errors, resolves missing imports, removes unused variables, and applies canonical formatting:
+
+```bash
+ballpython .
+```
+
+### 2. Check code in CI (Dry Run)
+Check for syntax errors, security vulnerabilities, dead code, and linting violations without modifying any files on disk:
+
+```bash
+ballpython check .
+```
+
+---
+
+## What It Does Automatically
+
+When you run `ballpython`, all engines run under the hood in one pass:
+
+* **Syntax Healing:** Repairs missing statement colons (`def`, `class`, `if`), accidental `=` assignments in conditionals, unclosed parentheses/brackets, tab/space mixups, and legacy Python 2 except/print statements.
+* **Smart Import Resolution:** Resolves undefined symbols to standard library modules and common aliases, inserts `TYPE_CHECKING` guards, and prunes unused imports.
+* **Formatting & Modernization:** Formats code to PEP 8 standards (powered by `ruff`), modernizes legacy type annotations (PEP 585/604), and removes redundant `object` inheritance.
+* **Dead Code Pruning:** Discovers and eliminates unreachable code, empty pass blocks, and unused private definitions.
+* **Security & Taint Audit:** Detects hardcoded API secrets, SQL/command injection patterns, and unsafe `eval`/`exec`/`pickle` calls.
+* **Type Verification:** Verifies function call signatures against bundled Typeshed stubs.
+
+---
+
+## Pre-Commit Hook
+
+Add `ballpython` to your `.pre-commit-config.yaml`:
+
+```yaml
+repos:
+  - repo: https://github.com/moonrox420/ball-python
+    rev: v2.0.3
+    hooks:
+      - id: pycleaner
+        args: ["check"]
+```
+
+---
+
+## Configuration
+
+Optional configuration can be placed in `pyproject.toml` under `[tool.pycleaner]`:
+
+```toml
+[tool.pycleaner]
+exclude = ["migrations/", "generated/"]
+line-length = 88
+```
+
+---
+
+## License
+
+MIT License.

ballpython-2.0.3/README.md

@@ -0,0 +1,84 @@
+# ballpython
+
+[![PyPI version](https://img.shields.io/pypi/v/ballpython.svg)](https://pypi.org/project/ballpython/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/ballpython.svg)](https://pypi.org/project/ballpython/)
+[![CI](https://github.com/moonrox420/ball-python/actions/workflows/ci.yml/badge.svg)](https://github.com/moonrox420/ball-python/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**The zero-config Python code cleaner, syntax healer, and quality suite.**
+
+`ballpython` automatically repairs broken syntax, resolves missing imports, prunes dead code, scans for security vulnerabilities, and formats your code in a single command. Zero LLM dependencies, 100% offline, and fast.
+
+Both `ballpython` and `pycleaner` CLI commands are identical.
+
+---
+
+## Installation
+
+```bash
+pip install ballpython
+```
+
+---
+
+## Quickstart
+
+### 1. Fix and format your code
+Run `ballpython` on any file or directory. It automatically heals syntax errors, resolves missing imports, removes unused variables, and applies canonical formatting:
+
+```bash
+ballpython .
+```
+
+### 2. Check code in CI (Dry Run)
+Check for syntax errors, security vulnerabilities, dead code, and linting violations without modifying any files on disk:
+
+```bash
+ballpython check .
+```
+
+---
+
+## What It Does Automatically
+
+When you run `ballpython`, all engines run under the hood in one pass:
+
+* **Syntax Healing:** Repairs missing statement colons (`def`, `class`, `if`), accidental `=` assignments in conditionals, unclosed parentheses/brackets, tab/space mixups, and legacy Python 2 except/print statements.
+* **Smart Import Resolution:** Resolves undefined symbols to standard library modules and common aliases, inserts `TYPE_CHECKING` guards, and prunes unused imports.
+* **Formatting & Modernization:** Formats code to PEP 8 standards (powered by `ruff`), modernizes legacy type annotations (PEP 585/604), and removes redundant `object` inheritance.
+* **Dead Code Pruning:** Discovers and eliminates unreachable code, empty pass blocks, and unused private definitions.
+* **Security & Taint Audit:** Detects hardcoded API secrets, SQL/command injection patterns, and unsafe `eval`/`exec`/`pickle` calls.
+* **Type Verification:** Verifies function call signatures against bundled Typeshed stubs.
+
+---
+
+## Pre-Commit Hook
+
+Add `ballpython` to your `.pre-commit-config.yaml`:
+
+```yaml
+repos:
+  - repo: https://github.com/moonrox420/ball-python
+    rev: v2.0.3
+    hooks:
+      - id: pycleaner
+        args: ["check"]
+```
+
+---
+
+## Configuration
+
+Optional configuration can be placed in `pyproject.toml` under `[tool.pycleaner]`:
+
+```toml
+[tool.pycleaner]
+exclude = ["migrations/", "generated/"]
+line-length = 88
+```
+
+---
+
+## License
+
+MIT License.

ballpython-2.0.3/ballpython.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: ballpython
+Version: 2.0.3
+Summary: The Ultimate Static Python Intelligence, Healing, Type Verification, and Security Suite
+Author: Developer
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: ruff>=0.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tomli>=1.1.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: isort>=5.13.0; extra == "dev"
+Provides-Extra: security
+Requires-Dist: cryptography>=41.0.0; extra == "security"
+Requires-Dist: defusedxml>=0.7.1; extra == "security"
+
+# ballpython
+
+[![PyPI version](https://img.shields.io/pypi/v/ballpython.svg)](https://pypi.org/project/ballpython/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/ballpython.svg)](https://pypi.org/project/ballpython/)
+[![CI](https://github.com/moonrox420/ball-python/actions/workflows/ci.yml/badge.svg)](https://github.com/moonrox420/ball-python/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**The zero-config Python code cleaner, syntax healer, and quality suite.**
+
+`ballpython` automatically repairs broken syntax, resolves missing imports, prunes dead code, scans for security vulnerabilities, and formats your code in a single command. Zero LLM dependencies, 100% offline, and fast.
+
+Both `ballpython` and `pycleaner` CLI commands are identical.
+
+---
+
+## Installation
+
+```bash
+pip install ballpython
+```
+
+---
+
+## Quickstart
+
+### 1. Fix and format your code
+Run `ballpython` on any file or directory. It automatically heals syntax errors, resolves missing imports, removes unused variables, and applies canonical formatting:
+
+```bash
+ballpython .
+```
+
+### 2. Check code in CI (Dry Run)
+Check for syntax errors, security vulnerabilities, dead code, and linting violations without modifying any files on disk:
+
+```bash
+ballpython check .
+```
+
+---
+
+## What It Does Automatically
+
+When you run `ballpython`, all engines run under the hood in one pass:
+
+* **Syntax Healing:** Repairs missing statement colons (`def`, `class`, `if`), accidental `=` assignments in conditionals, unclosed parentheses/brackets, tab/space mixups, and legacy Python 2 except/print statements.
+* **Smart Import Resolution:** Resolves undefined symbols to standard library modules and common aliases, inserts `TYPE_CHECKING` guards, and prunes unused imports.
+* **Formatting & Modernization:** Formats code to PEP 8 standards (powered by `ruff`), modernizes legacy type annotations (PEP 585/604), and removes redundant `object` inheritance.
+* **Dead Code Pruning:** Discovers and eliminates unreachable code, empty pass blocks, and unused private definitions.
+* **Security & Taint Audit:** Detects hardcoded API secrets, SQL/command injection patterns, and unsafe `eval`/`exec`/`pickle` calls.
+* **Type Verification:** Verifies function call signatures against bundled Typeshed stubs.
+
+---
+
+## Pre-Commit Hook
+
+Add `ballpython` to your `.pre-commit-config.yaml`:
+
+```yaml
+repos:
+  - repo: https://github.com/moonrox420/ball-python
+    rev: v2.0.3
+    hooks:
+      - id: pycleaner
+        args: ["check"]
+```
+
+---
+
+## Configuration
+
+Optional configuration can be placed in `pyproject.toml` under `[tool.pycleaner]`:
+
+```toml
+[tool.pycleaner]
+exclude = ["migrations/", "generated/"]
+line-length = 88
+```
+
+---
+
+## License
+
+MIT License.

{ballpython-2.0.0 → ballpython-2.0.3}/ballpython.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ pyproject.toml
 ballpython/__init__.py
 ballpython/__main__.py
 ballpython/cli.py
+ballpython/py.typed
 ballpython.egg-info/PKG-INFO
 ballpython.egg-info/SOURCES.txt
 ballpython.egg-info/dependency_links.txt
@@ -11,30 +12,49 @@ ballpython.egg-info/requires.txt
 ballpython.egg-info/top_level.txt
 pycleaner/__init__.py
 pycleaner/__main__.py
+pycleaner/baseline.py
+pycleaner/cache.py
 pycleaner/cli.py
 pycleaner/complexity_analyzer.py
 pycleaner/config.py
 pycleaner/dead_code_detector.py
 pycleaner/dependency_auditor.py
+pycleaner/discovery.py
+pycleaner/explanations.py
 pycleaner/import_resolver.py
 pycleaner/linter_formatter.py
+pycleaner/modernizer.py
 pycleaner/pipeline.py
+pycleaner/py.typed
 pycleaner/security_scanner.py
 pycleaner/syntax_healer.py
 pycleaner/taint_engine.py
 pycleaner/test_generator.py
 pycleaner/type_checker.py
 pycleaner/typeshed_resolver.py
+pycleaner/verifier.py
+pycleaner/frameworks/__init__.py
+pycleaner/frameworks/plugins.py
+tests/test_baseline_and_explain.py
+tests/test_cache.py
 tests/test_cli.py
+tests/test_cli_prove.py
 tests/test_complexity_analyzer.py
 tests/test_config.py
 tests/test_dead_code_detector.py
+tests/test_dead_code_fixer.py
 tests/test_dependency_auditor.py
+tests/test_discovery.py
+tests/test_frameworks.py
 tests/test_import_resolver.py
 tests/test_linter_formatter.py
+tests/test_modernizer.py
+tests/test_mutation_test_generator.py
 tests/test_pipeline.py
 tests/test_security_scanner.py
 tests/test_syntax_healer.py
 tests/test_taint_engine.py
 tests/test_test_generator.py
-tests/test_type_checker.py
+tests/test_type_checker.py
+tests/test_verifier.py
+tests/test_verifier_pipeline.py

{ballpython-2.0.0 → ballpython-2.0.3}/pycleaner/__init__.py

@@ -10,19 +10,38 @@ dataflow taint vulnerabilities, and synthesizes automated behavioral test suites
 
 from __future__ import annotations
 
-__version__ = "2.0.0"
+from pycleaner.discovery import (
+    DEFAULT_IGNORED_DIRS,
+    PROTECTED_FILE_PATTERNS,
+    collect_project_python_files,
+    is_ignored_directory,
+    is_protected_file,
+)
+
+__version__ = "2.0.3"
 __all__ = [
+    "BaselineFingerprint",
+    "BaselineManager",
     "CleanPipeline",
     "CleanResult",
     "ComplexityAnalyzer",
     "ComplexityReport",
+    "ContentAddressableCache",
+    "CounterExample",
     "DeadCodeDetector",
+    "DeadCodeFixResult",
+    "DeadCodeFixer",
     "DeadCodeReport",
     "DependencyAuditor",
     "GeneratedTestSuite",
     "ImportResolver",
+    "IsolatedDifferentialVerifier",
     "LinterFormatter",
+    "ModernizeResult",
+    "Modernizer",
+    "ProofReceipt",
     "PyCleanerConfig",
+    "RuleExplanation",
     "SecurityReport",
     "SecurityScanner",
     "SyntaxHealer",
@@ -35,15 +54,27 @@ __all__ = [
     "TypeFinding",
     "TypeReport",
     "TypeshedResolver",
+    "VerificationTier",
+    "get_explanation",
+    "list_rules",
     "load_config",
 ]
 
+from pycleaner.baseline import BaselineFingerprint, BaselineManager
+from pycleaner.cache import ContentAddressableCache
 from pycleaner.complexity_analyzer import ComplexityAnalyzer, ComplexityReport
 from pycleaner.config import PyCleanerConfig, load_config
-from pycleaner.dead_code_detector import DeadCodeDetector, DeadCodeReport
+from pycleaner.dead_code_detector import (
+    DeadCodeDetector,
+    DeadCodeFixer,
+    DeadCodeFixResult,
+    DeadCodeReport,
+)
 from pycleaner.dependency_auditor import DependencyAuditor
+from pycleaner.explanations import RuleExplanation, get_explanation, list_rules
 from pycleaner.import_resolver import ImportResolver
 from pycleaner.linter_formatter import LinterFormatter
+from pycleaner.modernizer import Modernizer, ModernizeResult
 from pycleaner.pipeline import CleanPipeline, CleanResult
 from pycleaner.security_scanner import SecurityReport, SecurityScanner
 from pycleaner.syntax_healer import SyntaxHealer
@@ -51,3 +82,9 @@ from pycleaner.taint_engine import TaintEngine, TaintFinding, TaintReport
 from pycleaner.test_generator import GeneratedTestSuite, TestCase, TestGenerator
 from pycleaner.type_checker import TypeChecker, TypeFinding, TypeReport
 from pycleaner.typeshed_resolver import TypeshedResolver
+from pycleaner.verifier import (
+    CounterExample,
+    IsolatedDifferentialVerifier,
+    ProofReceipt,
+    VerificationTier,
+)

ballpython-2.0.3/pycleaner/baseline.py

@@ -0,0 +1,127 @@
+"""
+pycleaner.baseline
+==================
+
+Technical Debt Ratchet and Baseline Management Engine.
+
+Enables incremental adoption of PyCleaner on legacy codebases by snapshotting
+existing diagnostic violations into `.pycleaner/baseline.json`. Future CI/CD
+checks ensure that existing technical debt can only decrease, never increase.
+"""
+
+from __future__ import annotations
+
+import hashlib
+import json
+import time
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any
+
+
+@dataclass(frozen=True)
+class BaselineFingerprint:
+    rule: str
+    file: str
+    line: int
+    symbol: str
+
+    def to_hash(self) -> str:
+        raw = f"{self.rule}:{self.file}:{self.line}:{self.symbol}"
+        return hashlib.sha256(raw.encode("utf-8")).hexdigest()[:16]
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "rule": self.rule,
+            "file": self.file,
+            "line": self.line,
+            "symbol": self.symbol,
+            "hash": self.to_hash(),
+        }
+
+
+class BaselineManager:
+    """Manages baseline generation, loading, and ratchet comparison."""
+
+    def __init__(self, baseline_path: Path | str = ".pycleaner/baseline.json") -> None:
+        self.baseline_path = Path(baseline_path)
+
+    def load_fingerprints(self) -> set[str]:
+        """Loads baseline issue hashes from disk."""
+        if not self.baseline_path.exists():
+            return set()
+        try:
+            data = json.loads(self.baseline_path.read_text(encoding="utf-8"))
+            fingerprints = data.get("fingerprints", [])
+            return {
+                fp.get("hash")
+                for fp in fingerprints
+                if isinstance(fp, dict) and fp.get("hash")
+            }
+        except json.JSONDecodeError:
+            return set()
+
+    def save_baseline(
+        self,
+        fingerprints: list[BaselineFingerprint],
+        root_dir: Path,
+    ) -> Path:
+        """Serializes fingerprints to the baseline JSON file."""
+        self.baseline_path.parent.mkdir(parents=True, exist_ok=True)
+        payload = {
+            "version": 1,
+            "timestamp": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
+            "root_dir": str(root_dir.resolve()),
+            "issue_count": len(fingerprints),
+            "fingerprints": [fp.to_dict() for fp in fingerprints],
+        }
+        self.baseline_path.write_text(json.dumps(payload, indent=2), encoding="utf-8")
+        return self.baseline_path
+
+    @staticmethod
+    def create_fingerprint(
+        rule: str,
+        file_path: Path | str,
+        line: int,
+        symbol: str,
+        root_dir: Path | None = None,
+    ) -> BaselineFingerprint:
+        """Constructs a deterministic fingerprint with normalized relative path."""
+        p = Path(file_path)
+        if root_dir is not None:
+            try:
+                rel = str(p.resolve().relative_to(root_dir.resolve())).replace(
+                    "\\", "/"
+                )
+            except ValueError:
+                rel = p.name
+        else:
+            rel = p.name
+
+        return BaselineFingerprint(
+            rule=rule,
+            file=rel,
+            line=line,
+            symbol=symbol,
+        )
+
+    def filter_new_issues(
+        self,
+        issues: list[BaselineFingerprint],
+    ) -> tuple[list[BaselineFingerprint], list[BaselineFingerprint]]:
+        """
+        Separates issues into (tolerated_baseline_issues, new_debt_issues).
+        Returns:
+            (tolerated, new_debt)
+        """
+        known_hashes = self.load_fingerprints()
+        tolerated: list[BaselineFingerprint] = []
+        new_debt: list[BaselineFingerprint] = []
+
+        for issue in issues:
+            if issue.to_hash() in known_hashes:
+                tolerated.append(issue)
+            else:
+                new_debt.append(issue)
+
+        return tolerated, new_debt