ballpython 2.0.5__py3-none-any.whl → 2.1.0__py3-none-any.whl

ballpython/__init__.py

@@ -2,8 +2,12 @@
 
 from __future__ import annotations
 
+from typing import Any
+
 import pycleaner
-from pycleaner import *
+from pycleaner import __all__ as __all__
+from pycleaner import __version__ as __version__
+
 
-__version__ = pycleaner.__version__
-__all__ = pycleaner.__all__
+def __getattr__(name: str) -> Any:
+    return getattr(pycleaner, name)

{ballpython-2.0.5.dist-info → ballpython-2.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ballpython
-Version: 2.0.5
+Version: 2.1.0
 Summary: The Ultimate Static Python Intelligence, Healing, Type Verification, and Security Suite
 Author: Developer
 License-Expression: MIT

ballpython-2.1.0.dist-info/RECORD

@@ -0,0 +1,34 @@
+ballpython/__init__.py,sha256=GSB-LHdou1Un6DS6Zmh8tv_zrwh6HQHO3Py2z8GO39o,304
+ballpython/__main__.py,sha256=aCRr0vnZfKYHDrPHBsYSjX5xTxtFJpTTSPVUSZTBK-I,136
+ballpython/cli.py,sha256=LllCLRAQQ-fRR_lIXwmd2e3Q7DLCIvf-5jHBXsAhJWs,125
+ballpython/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pycleaner/__init__.py,sha256=VzmbjUip6i0wpKh-s6XBwgBkIeUgI1duGyKDIiv7Pls,3042
+pycleaner/__main__.py,sha256=8QBFrPyxId563F6cipPMNVEBTG8TIZUgxQfp8gk1VSI,135
+pycleaner/baseline.py,sha256=ljED3x3akie0SB3fzhVno_1UHlI2id-9vta0NIGC0mw,3857
+pycleaner/cache.py,sha256=T3JIxYg8ZezRbSpXYXPD-SyMUkjg4nfKsdO0IuNypOY,10774
+pycleaner/cli.py,sha256=NswwV_3cbHiL63Pj6qDtSpV_98zXvGo7UuBHwNAxpQ8,73752
+pycleaner/complexity_analyzer.py,sha256=j2ktzgR-isWE4xWMe56N3JFLLuYCi-S84BIlRBe0v-I,14975
+pycleaner/config.py,sha256=XhloyaY_9pdwbQuc3QaAPCerLeXz-i1da4xT50h-pjY,8514
+pycleaner/dead_code_detector.py,sha256=uufGt7EtGusQdtbX3rUCHIrF8IAu-S16jrViBJdnV-g,52092
+pycleaner/dependency_auditor.py,sha256=EmSqr_ayUqmdSZ7Nm4QAT4qfikF9VToLL8eXVecIDpw,23395
+pycleaner/discovery.py,sha256=dt3OmHg886hy_Z0p80ccMyDkITQxz4biaJY_zB3MU_g,6151
+pycleaner/explanations.py,sha256=2OOU_l3YL5o_Br_6fP6MF8HlY75-1JRmw3eTYT2lu8M,14219
+pycleaner/import_resolver.py,sha256=Wgrch335AQVsnDv5-7F0l4Zm2oQPkNebPEgTRa7ayAg,32855
+pycleaner/linter_formatter.py,sha256=wdTjwguPWzkJ9KRMcQpFHEirb3ogc9qay69yiphz16Y,21356
+pycleaner/modernizer.py,sha256=kd9_G5EzdW_O-9zm1hA6v33Sb__UbpMZzSvopF-UK5w,16820
+pycleaner/pipeline.py,sha256=ZG7_9PNz0jBadFrZoiI7juLtUJXglGQhLgQhrLJqEac,20612
+pycleaner/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pycleaner/security_scanner.py,sha256=8nyRtoCjBYAB_sI5azlNsEMm2S0s2zE7fPhc7QCHWR0,23527
+pycleaner/syntax_healer.py,sha256=5VYclqkI3WFnm6yfG0zRLMkHN4QMU4aN4ZYCcSUsmZk,27408
+pycleaner/taint_engine.py,sha256=-bBq38YoQgbO2FHCDxDctZpXWQTqwuS56CEWFNOY000,26870
+pycleaner/test_generator.py,sha256=MM3t0Dx5lyJB5s144IKXq2tXrE8ohKcSvicPR3c9MlU,19680
+pycleaner/type_checker.py,sha256=zkUqi-BNLUzJT0tIECNh7_7GP29Y7_6fMXhVuguwMKg,37881
+pycleaner/typeshed_resolver.py,sha256=N-kWU_CI5DG59lQMkt7wMW9sHYjNCBdfFS42b4y2Kr4,12742
+pycleaner/verifier.py,sha256=QlBwnsrhWWRK3LzvJjpNix474drCNp6LP7FiUgJxMsg,19333
+pycleaner/frameworks/__init__.py,sha256=SOuSRl39af86eoQx7Qm8rTJGD4jsnEvgyhhQ6cVmRVA,3462
+pycleaner/frameworks/plugins.py,sha256=qunMzS3q7xp1GEGxqkuhrnm-raiSRhYQMzmDxsEhSUg,11452
+ballpython-2.1.0.dist-info/METADATA,sha256=98OjKH0i9ih05fQ9JX2eriRljEboAEOVIgk4TwQ9hQ8,3466
+ballpython-2.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+ballpython-2.1.0.dist-info/entry_points.txt,sha256=6ux-5UxoVSmlK5p9M-GDVt24sCdwTQq9wgRDkpMIYU8,81
+ballpython-2.1.0.dist-info/top_level.txt,sha256=u6lmy8RWZ_saxCZAQTL7EijB4sunegOiVyk5fHjpwLk,21
+ballpython-2.1.0.dist-info/RECORD,,

pycleaner/__init__.py

@@ -20,6 +20,8 @@ from pycleaner.discovery import (
 
 __version__ = "2.0.5"
 __all__ = [
+    "DEFAULT_IGNORED_DIRS",
+    "PROTECTED_FILE_PATTERNS",
     "BaselineFingerprint",
     "BaselineManager",
     "CleanPipeline",
@@ -55,7 +57,10 @@ __all__ = [
     "TypeReport",
     "TypeshedResolver",
     "VerificationTier",
+    "collect_project_python_files",
     "get_explanation",
+    "is_ignored_directory",
+    "is_protected_file",
     "list_rules",
     "load_config",
 ]

pycleaner/baseline.py

@@ -54,7 +54,7 @@ class BaselineManager:
             data = json.loads(self.baseline_path.read_text(encoding="utf-8"))
             fingerprints = data.get("fingerprints", [])
             return {
-                fp.get("hash")
+                str(fp["hash"])
                 for fp in fingerprints
                 if isinstance(fp, dict) and fp.get("hash")
             }

pycleaner/cache.py

@@ -15,6 +15,7 @@ from __future__ import annotations
 import ast
 import hashlib
 import json
+import logging
 import sqlite3
 import time
 from pathlib import Path
@@ -22,6 +23,7 @@ from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
     from pycleaner.pipeline import CleanResult
+
 from pycleaner.verifier import VerificationTier
 
 
@@ -46,7 +48,7 @@ def extract_file_dependencies(source: str) -> list[str]:
             elif isinstance(node, ast.ImportFrom) and node.module:
                 deps.append(node.module.split(".")[0])
     except SyntaxError:
-        pass  # Best-effort dependency extraction; syntax errors handled downstream
+        logging.getLogger(__name__).debug("Suppressed exception", exc_info=True)
     return sorted(set(deps))
 
 

pycleaner/cli.py

@@ -40,7 +40,6 @@ from pycleaner.verifier import CounterExample, ProofReceipt, VerificationTier
 
 try:
     from rich.console import Console
-    from rich.panel import Panel
     from rich.progress import (
         BarColumn,
         Progress,
@@ -158,6 +157,11 @@ def _register_fix_subparsers(subparsers: Any) -> None:
 def _register_analysis_subparsers(subparsers: Any) -> None:
     audit_p = subparsers.add_parser("audit", help="Audit project dependencies")
     _add_common_args(audit_p)
+    audit_p.add_argument(
+        "--fix",
+        action="store_true",
+        help="Auto-fix requirements.txt and pyproject.toml and prune unused packages",
+    )
     audit_p.add_argument(
         "--fix-deps", action="store_true", help="Auto-fix requirements.txt"
     )
@@ -714,17 +718,17 @@ def _report_file_modifications(
     action = "Cleaned" if apply_changes else "Would modify"
     print_msg(f"[green]{action}:[/green] {py_file.name}")
     for repair in result.syntax_repairs:
-        print_msg(f"  • Syntax: {repair}", style="cyan")
+        print_msg(f"  - Syntax: {repair}", style="cyan")
     for mod in result.modernize_transforms:
-        print_msg(f"  • Modernize: {mod}", style="green")
+        print_msg(f"  - Modernize: {mod}", style="green")
     for dc in result.dead_code_pruned:
-        print_msg(f"  • Dead-code: {dc}", style="yellow")
+        print_msg(f"  - Dead-code: {dc}", style="yellow")
     for imp in result.resolved_imports:
-        print_msg(f"  • Import: {imp}", style="magenta")
+        print_msg(f"  - Import: {imp}", style="magenta")
     if result.lint_changed:
-        print_msg("  • Lint: fixed errors and pruned unused imports", style="blue")
+        print_msg("  - Lint: fixed errors and pruned unused imports", style="blue")
     if result.format_changed:
-        print_msg("  • Format: applied PEP 8 formatting", style="blue")
+        print_msg("  - Format: applied PEP 8 formatting", style="blue")
 
 
 def _accumulate_result(
@@ -750,11 +754,11 @@ def _accumulate_result(
     elif result.verification_tier == VerificationTier.TIER_C_REFUSED:
         if not is_json:
             print_msg(
-                f"[bold red]Refused (Tier C):[/bold red] {py_file.name} — transformation falsified by differential fuzzing; rolled back!"
+                f"[bold red]Refused (Tier C):[/bold red] {py_file.name} - transformation falsified by differential fuzzing; rolled back!"
             )
             for ce in result.refused_changes:
                 print_msg(
-                    f"  • {ce.callable_name} diverged on args={ce.arguments} kwargs={ce.keyword_arguments}"
+                    f"  - {ce.callable_name} diverged on args={ce.arguments} kwargs={ce.keyword_arguments}"
                 )
                 print_msg(
                     f"    original={ce.original_result or ce.original_error} vs transformed={ce.transformed_result or ce.transformed_error} (seed {ce.seed})"
@@ -898,15 +902,13 @@ def _render_audit_terminal_output(
             f"  [red]Missing:[/red] {', '.join(sorted(audit_report.missing_packages))}"
         )
         if not should_fix:
-            print_msg(
-                "  [dim]Tip: Run with -a/--all or --fix-deps to append them[/dim]"
-            )
+            print_msg("  [dim]Tip: Run with -a/--all or --fix to append them[/dim]")
     if audit_report.unused_packages:
         print_msg(
             f"  [yellow]Unused:[/yellow] {', '.join(sorted(audit_report.unused_packages))}"
         )
     if audit_report.fixed_requirements:
-        print_msg("  [green]requirements.txt synchronized.[/green]")
+        print_msg("  [green]Project dependencies synchronized on disk.[/green]")
 
 
 def _run_fix_audit(
@@ -919,8 +921,18 @@ def _run_fix_audit(
 ) -> DependencyAuditReport:
     exclude_patterns = config.exclude if config else ()
     auditor = DependencyAuditor(root_dir, exclude_patterns=exclude_patterns)
-    fix_any = getattr(args, "fix_deps", False) or getattr(args, "fix_all", False)
-    prune_any = getattr(args, "prune_deps", False) or getattr(args, "fix_all", False)
+    fix_any = (
+        getattr(args, "fix_deps", False)
+        or getattr(args, "fix_all", False)
+        or getattr(args, "fix", False)
+        or apply_changes
+    )
+    prune_any = (
+        getattr(args, "prune_deps", False)
+        or getattr(args, "fix_all", False)
+        or getattr(args, "fix", False)
+        or apply_changes
+    )
     should_fix = apply_changes and fix_any
     should_prune = apply_changes and prune_any
     audit_report = auditor.audit(
@@ -1010,6 +1022,12 @@ def _cmd_fix(
         config=config,
         target_files=py_files,
     )
+    if opts.apply_changes and (
+        audit_report.fixed_requirements
+        or getattr(audit_report, "fixed_pyproject", False)
+    ):
+        state.changed_count += 1
+
     print_msg(
         f"\n[bold]Summary: {len(py_files)} inspected, {state.changed_count} updated, {state.error_count} errors.[/bold]"
     )
@@ -1022,15 +1040,15 @@ def _cmd_fix(
         if not is_json:
             print_msg("\n[bold cyan]Verification Receipts (Trust Ladder):[/bold cyan]")
             print_msg(
-                f"  [bold green]• Proven (Tier A):[/bold green] {total_proven_callables} callable(s) invariant-preserving across {pipeline.proof_iterations} input(s)"
+                f"  [bold green]- Proven (Tier A):[/bold green] {total_proven_callables} callable(s) invariant-preserving across {pipeline.proof_iterations} input(s)"
             )
             if state.suggested_count > 0:
                 print_msg(
-                    f"  [yellow]• Suggested (Tier B):[/yellow] {state.suggested_count} module(s) (not isolated for dynamic fuzzing)"
+                    f"  [yellow]- Suggested (Tier B):[/yellow] {state.suggested_count} module(s) (not isolated for dynamic fuzzing)"
                 )
             if total_refused_callables > 0:
                 print_msg(
-                    f"  [bold red]• Refused (Tier C):[/bold red] {total_refused_callables} transformation(s) diverged; rolled back"
+                    f"  [bold red]- Refused (Tier C):[/bold red] {total_refused_callables} transformation(s) diverged; rolled back"
                 )
 
         output_report_path = getattr(
@@ -1098,20 +1116,20 @@ def _cmd_fix(
             )
             if tolerated:
                 print_msg(
-                    f"  • Baseline tolerated: [yellow]{len(tolerated)}[/yellow] existing issue(s)"
+                    f"  - Baseline tolerated: [yellow]{len(tolerated)}[/yellow] existing issue(s)"
                 )
             if new_debt:
                 print_msg(
-                    f"  • [bold red]Ratchet Violation:[/bold red] {len(new_debt)} new technical debt issue(s) detected!"
+                    f"  - [bold red]Ratchet Violation:[/bold red] {len(new_debt)} new technical debt issue(s) detected!"
                 )
                 for nd in new_debt:
                     print_msg(
-                        f"    [red]• [X] {nd.rule} at {nd.file}:{nd.line} ({nd.symbol})[/red]"
+                        f"    [red]- [X] {nd.rule} at {nd.file}:{nd.line} ({nd.symbol})[/red]"
                     )
                 return 1
             else:
                 print_msg(
-                    "  • [bold green]Ratchet Passed:[/bold green] 0 new technical debt issues introduced."
+                    "  - [bold green]Ratchet Passed:[/bold green] 0 new technical debt issues introduced."
                 )
         elif new_debt:
             return 1
@@ -1223,9 +1241,9 @@ def _cmd_baseline(
     manager = BaselineManager(output_path)
     saved_file = manager.save_baseline(fingerprints, root_dir)
 
-    print_msg(f"\n[bold green]Baseline successfully recorded![/bold green]")
-    print_msg(f"  • Issues snapshotted: [bold yellow]{len(fingerprints)}[/bold yellow]")
-    print_msg(f"  • Output file: [bold]{saved_file}[/bold]")
+    print_msg("\n[bold green]Baseline successfully recorded![/bold green]")
+    print_msg(f"  - Issues snapshotted: [bold yellow]{len(fingerprints)}[/bold yellow]")
+    print_msg(f"  - Output file: [bold]{saved_file}[/bold]")
     print_msg(
         "\n[dim]Ratchet Guarantee: Technical debt in this repository is now locked. Run CI with:[/dim]"
     )
@@ -1413,8 +1431,10 @@ def _render_audit_cli_output(
         )
     if not audit_report.missing_packages and not audit_report.unused_packages:
         print_msg("  [green]All dependencies clean.[/green]")
-    if audit_report.fixed_requirements:
-        print_msg("  [green]requirements.txt synchronized.[/green]")
+    if audit_report.fixed_requirements or getattr(
+        audit_report, "fixed_pyproject", False
+    ):
+        print_msg("  [green]Project dependencies synchronized on disk.[/green]")
 
     return (
         1
@@ -1428,10 +1448,12 @@ def _cmd_audit(args: argparse.Namespace, config: PyCleanerConfig, print_msg) ->
     root_dir = find_project_root(args.paths[0] if args.paths else None)
 
     is_check = getattr(args, "check", False)
+    fix_flag = getattr(args, "fix", False) or getattr(args, "fix_deps", False)
+    prune_flag = getattr(args, "fix", False) or getattr(args, "prune_deps", False)
     auditor = DependencyAuditor(root_dir, exclude_patterns=config.exclude)
     audit_report = auditor.audit(
-        fix=getattr(args, "fix_deps", False) and not is_check,
-        prune_unused=getattr(args, "prune_deps", False) and not is_check,
+        fix=fix_flag and not is_check,
+        prune_unused=prune_flag and not is_check,
     )
 
     if getattr(args, "json", False):
@@ -1501,7 +1523,7 @@ def _render_scan_cli_summary(
         print_msg(f"\n  Findings by category: {cat_summary}")
 
     print_msg(
-        f"\n  Total: {report.count} finding(s) — "
+        f"\n  Total: {report.count} finding(s) - "
         f"[red]{report.critical_count} critical[/red], [red]{report.high_count} high[/red]"
     )
     return 1 if report.critical_count > 0 else 0
@@ -1604,7 +1626,7 @@ def _render_complexity_cli_output(
     else:
         for f in violations:
             print_msg(
-                f"  {f.qualified_name} — CC:{f.cyclomatic} Cog:{f.cognitive} Ln:{f.lines} Args:{f.args}"
+                f"  {f.qualified_name} - CC:{f.cyclomatic} Cog:{f.cognitive} Ln:{f.lines} Args:{f.args}"
             )
     print_msg(f"\n  {len(violations)} function(s) exceed threshold(s).")
     return 1
@@ -1661,7 +1683,7 @@ def _render_dead_code_kind_group(
         rel_path = _try_relative(item.filepath, target_base)
         conf_tag = f" [{item.confidence}]" if item.confidence != "high" else ""
         print_msg(
-            f"    L{item.lineno} {rel_path}: {item.name} — {item.reason}{conf_tag}"
+            f"    L{item.lineno} {rel_path}: {item.name} - {item.reason}{conf_tag}"
         )
     if len(kind_items) > 20:
         print_msg(f"    ... and {len(kind_items) - 20} more")
@@ -1781,7 +1803,7 @@ def _render_types_cli_summary(
         for f in report.findings:
             rel = _try_relative(f.filepath, target_base)
             print_msg(
-                f"  [{f.severity.upper()}] {rel}:{f.lineno} — {f.message} (expected {f.expected_type}, got {f.actual_type})"
+                f"  [{f.severity.upper()}] {rel}:{f.lineno} - {f.message} (expected {f.expected_type}, got {f.actual_type})"
             )
 
     print_msg(f"\n  Total: {report.count} type finding(s) detected.")
@@ -1965,6 +1987,8 @@ def _run_ultimate_phases(
     print_msg(
         "\n[bold blue]Phase 2: Project Dependency Audit & Reconciliation[/bold blue]"
     )
+    args.fix = True
+    args.prune_deps = True
     audit_rc = _cmd_audit(args, config, print_msg)
     print_msg(
         "\n[bold blue]Phase 3: Bidirectional Type Verification & Typeshed Resolution[/bold blue]"
@@ -1982,7 +2006,7 @@ def _run_ultimate_phases(
 def _cmd_ultimate(
     args: argparse.Namespace, config: PyCleanerConfig, print_msg: Any, console: Any
 ) -> int:
-    """The Ultimate Python Tool flagship runner: executes full multi-layer analysis."""
+    """The Ultimate Python Tool flagship runner: executes full multi-layer analysis and automated healing."""
     print_msg(
         "[bold magenta]=== PyCleaner Ultimate: Full Spectrum Analysis & Healing ===[/bold magenta]\n"
     )
@@ -1990,14 +2014,15 @@ def _cmd_ultimate(
         args, config, print_msg, console
     )
     print_msg(
-        "\n[bold blue]Phase 6: Structural Complexity & Dead Code Discovery[/bold blue]"
+        "\n[bold blue]Phase 6: Structural Complexity & Dead Code Discovery & Healing[/bold blue]"
     )
     _cmd_complexity(args, config, print_msg, console)
-    _cmd_dead_code(args, config, print_msg, console)
+    args.fix = True
+    dead_rc = _cmd_dead_code(args, config, print_msg, console)
     print_msg(
         "\n[bold magenta]=== Ultimate Python Tool: Analysis Complete ===[/bold magenta]"
     )
-    return max(fix_rc, audit_rc, type_rc, taint_rc, scan_rc)
+    return max(fix_rc, audit_rc, type_rc, taint_rc, scan_rc, dead_rc)
 
 
 def _collect_file_mtimes(files: Sequence[Path]) -> dict[Path, float]:

pycleaner/complexity_analyzer.py

@@ -318,7 +318,7 @@ class _NestingDepthCounter(ast.NodeVisitor):
     def visit_FunctionDef(self, node: ast.FunctionDef | ast.AsyncFunctionDef) -> None:
         self._function_depth += 1
         if self._function_depth == 1:
-            # Entry function being scored — walk its body normally.
+            # Entry function being scored - walk its body normally.
             self.generic_visit(node)
         # A nested def starts counting from its own zero depth in its own
         # report entry; it must not extend the enclosing function's depth.