crackerjack 0.20.3__py3-none-any.whl → 0.20.10__py3-none-any.whl

crackerjack/errors.py

@@ -1,15 +1,7 @@
-"""Error handling module for Crackerjack.
-
-This module defines a structured error system with error codes, detailed error messages,
-and recovery suggestions. It provides a consistent way to handle errors throughout
-the application.
-"""
-
 import sys
 import typing as t
 from enum import Enum
 from pathlib import Path
-
 from rich.console import Console
 from rich.panel import Panel
 
@@ -19,34 +11,27 @@ class ErrorCode(Enum):
     CONFIG_PARSE_ERROR = 1002
     INVALID_CONFIG = 1003
     MISSING_CONFIG_FIELD = 1004
-
     COMMAND_EXECUTION_ERROR = 2001
     COMMAND_TIMEOUT = 2002
     EXTERNAL_TOOL_ERROR = 2003
     PDM_INSTALL_ERROR = 2004
     PRE_COMMIT_ERROR = 2005
-
     TEST_EXECUTION_ERROR = 3001
     TEST_FAILURE = 3002
     BENCHMARK_REGRESSION = 3003
-
     BUILD_ERROR = 4001
     PUBLISH_ERROR = 4002
     VERSION_BUMP_ERROR = 4003
     AUTHENTICATION_ERROR = 4004
-
     GIT_COMMAND_ERROR = 5001
     PULL_REQUEST_ERROR = 5002
     COMMIT_ERROR = 5003
-
     FILE_NOT_FOUND = 6001
     PERMISSION_ERROR = 6002
     FILE_READ_ERROR = 6003
     FILE_WRITE_ERROR = 6004
-
     CODE_CLEANING_ERROR = 7001
     FORMATTING_ERROR = 7002
-
     UNKNOWN_ERROR = 9001
     NOT_IMPLEMENTED = 9002
     UNEXPECTED_ERROR = 9999
@@ -122,15 +107,12 @@ def handle_error(
     else:
         title = f"❌ Error {error.error_code.value}: {error.error_code.name}"
         content = [error.message]
-
         if verbose and error.details:
             content.extend(("\n[bold]Details:[/bold]", str(error.details)))
-
         if error.recovery:
             content.extend(
                 ("\n[bold green]Recovery suggestion:[/bold green]", str(error.recovery))
             )
-
         console.print(
             Panel(
                 "\n".join(content),
@@ -140,7 +122,6 @@ def handle_error(
                 expand=False,
             )
         )
-
     if exit_on_error:
         sys.exit(error.exit_code)
 
@@ -167,7 +148,6 @@ def check_command_result(
         details = f"Command '{command}' failed with return code {result.returncode}."
         if stderr:
             details += f"\nStandard error output:\n{stderr}"
-
         raise ExecutionError(
             message=error_message,
             error_code=error_code,

crackerjack/interactive.py

@@ -1,14 +1,7 @@
-"""Interactive CLI module using Rich for enhanced user experience.
-
-This module provides an enhanced interactive CLI experience using Rich library components.
-It includes progress tracking, interactive prompts, and detailed error reporting.
-"""
-
 import time
 import typing as t
 from enum import Enum, auto
 from pathlib import Path
-
 from rich.box import ROUNDED
 from rich.console import Console
 from rich.layout import Layout
@@ -25,7 +18,6 @@ from rich.prompt import Confirm, Prompt
 from rich.table import Table
 from rich.text import Text
 from rich.tree import Tree
-
 from .errors import CrackerjackError, ErrorCode, handle_error
 
 
@@ -39,10 +31,7 @@ class TaskStatus(Enum):
 
 class Task:
     def __init__(
-        self,
-        name: str,
-        description: str,
-        dependencies: list["Task"] | None = None,
+        self, name: str, description: str, dependencies: list["Task"] | None = None
     ) -> None:
         self.name = name
         self.description = description
@@ -77,8 +66,10 @@ class Task:
 
     def can_run(self) -> bool:
         return all(
-            dep.status in (TaskStatus.SUCCESS, TaskStatus.SKIPPED)
-            for dep in self.dependencies
+            (
+                dep.status in (TaskStatus.SUCCESS, TaskStatus.SKIPPED)
+                for dep in self.dependencies
+            )
         )
 
     def __str__(self) -> str:
@@ -92,10 +83,7 @@ class WorkflowManager:
         self.current_task: Task | None = None
 
     def add_task(
-        self,
-        name: str,
-        description: str,
-        dependencies: list[str] | None = None,
+        self, name: str, description: str, dependencies: list[str] | None = None
     ) -> Task:
         dep_tasks = []
         if dependencies:
@@ -103,7 +91,6 @@ class WorkflowManager:
                 if dep_name not in self.tasks:
                     raise ValueError(f"Dependency task '{dep_name}' not found")
                 dep_tasks.append(self.tasks[dep_name])
-
         task = Task(name, description, dep_tasks)
         self.tasks[name] = task
         return task
@@ -113,21 +100,23 @@ class WorkflowManager:
             if (
                 task.status == TaskStatus.PENDING
                 and task.can_run()
-                and task != self.current_task
+                and (task != self.current_task)
             ):
                 return task
         return None
 
     def all_tasks_completed(self) -> bool:
         return all(
-            task.status in (TaskStatus.SUCCESS, TaskStatus.FAILED, TaskStatus.SKIPPED)
-            for task in self.tasks.values()
+            (
+                task.status
+                in (TaskStatus.SUCCESS, TaskStatus.FAILED, TaskStatus.SKIPPED)
+                for task in self.tasks.values()
+            )
         )
 
     def run_task(self, task: Task, func: t.Callable[[], t.Any]) -> bool:
         self.current_task = task
         task.start()
-
         try:
             func()
             task.complete()
@@ -151,11 +140,9 @@ class WorkflowManager:
 
     def display_task_tree(self) -> None:
         tree = Tree("Workflow")
-
         for task in self.tasks.values():
             if not task.dependencies:
                 self._add_task_to_tree(task, tree)
-
         self.console.print(tree)
 
     def _add_task_to_tree(self, task: Task, parent: Tree) -> None:
@@ -169,9 +156,7 @@ class WorkflowManager:
             status = "[blue]⏩[/blue]"
         else:
             status = "[grey]⏸️[/grey]"
-
         branch = parent.add(f"{status} {task.name} - {task.description}")
-
         for dependent in self.tasks.values():
             if task in dependent.dependencies:
                 self._add_task_to_tree(dependent, branch)
@@ -186,14 +171,12 @@ class InteractiveCLI:
         title = Text("Crackerjack", style="bold cyan")
         version_text = Text(f"v{version}", style="dim cyan")
         subtitle = Text("Your Python project management toolkit", style="italic")
-
         panel = Panel(
             f"{title} {version_text}\n{subtitle}",
             box=ROUNDED,
             border_style="cyan",
             expand=False,
         )
-
         self.console.print(panel)
         self.console.print()
 
@@ -213,18 +196,14 @@ class InteractiveCLI:
 
     def setup_layout(self) -> Layout:
         layout = Layout()
-
         layout.split(
             Layout(name="header", size=3),
             Layout(name="main"),
             Layout(name="footer", size=3),
         )
-
         layout["main"].split_row(
-            Layout(name="tasks", ratio=1),
-            Layout(name="details", ratio=2),
+            Layout(name="tasks", ratio=1), Layout(name="details", ratio=2)
         )
-
         return layout
 
     def show_task_status(self, task: Task) -> Panel:
@@ -243,25 +222,16 @@ class InteractiveCLI:
         else:
             status = "[grey]⏸️ Pending[/grey]"
             style = "dim"
-
         duration = task.duration
         duration_text = f"Duration: {duration:.2f}s" if duration else ""
-
         content = f"{task.name}: {task.description}\nStatus: {status}\n{duration_text}"
-
         if task.error:
             content += f"\n[red]Error: {task.error.message}[/red]"
             if task.error.details:
                 content += f"\n[dim red]Details: {task.error.details}[/dim red]"
             if task.error.recovery:
                 content += f"\n[yellow]Recovery: {task.error.recovery}[/yellow]"
-
-        return Panel(
-            content,
-            title=task.name,
-            border_style=style,
-            expand=False,
-        )
+        return Panel(content, title=task.name, border_style=style, expand=False)
 
     def show_task_table(self) -> Table:
         table = Table(
@@ -270,12 +240,10 @@ class InteractiveCLI:
             show_header=True,
             header_style="bold cyan",
         )
-
         table.add_column("Task", style="cyan")
         table.add_column("Status")
         table.add_column("Duration")
         table.add_column("Dependencies")
-
         for task in self.workflow.tasks.values():
             if task.status == TaskStatus.RUNNING:
                 status = "[yellow]⏳ Running[/yellow]"
@@ -287,36 +255,19 @@ class InteractiveCLI:
                 status = "[blue]⏩ Skipped[/blue]"
             else:
                 status = "[grey]⏸️ Pending[/grey]"
-
             duration = task.duration
             duration_text = f"{duration:.2f}s" if duration else "-"
-
-            deps = ", ".join(dep.name for dep in task.dependencies) or "-"
-
+            deps = ", ".join((dep.name for dep in task.dependencies)) or "-"
             table.add_row(task.name, status, duration_text, deps)
-
         return table
 
     def run_interactive(self) -> None:
         self.console.clear()
         layout = self.setup_layout()
-
         layout["header"].update(
-            Panel(
-                "Crackerjack Interactive Mode",
-                style="bold cyan",
-                box=ROUNDED,
-            )
-        )
-
-        layout["footer"].update(
-            Panel(
-                "Press Ctrl+C to exit",
-                style="dim",
-                box=ROUNDED,
-            )
+            Panel("Crackerjack Interactive Mode", style="bold cyan", box=ROUNDED)
         )
-
+        layout["footer"].update(Panel("Press Ctrl+C to exit", style="dim", box=ROUNDED))
         progress = Progress(
             SpinnerColumn(),
             TextColumn("[bold blue]{task.description}"),
@@ -324,41 +275,31 @@ class InteractiveCLI:
             TextColumn("[progress.percentage]{task.percentage:>3.0f}%"),
             TimeElapsedColumn(),
         )
-
         total_tasks = len(self.workflow.tasks)
         progress_task = progress.add_task("Running workflow", total=total_tasks)
         completed_tasks = 0
-
         with Live(layout, refresh_per_second=4, screen=True) as live:
             try:
                 while not self.workflow.all_tasks_completed():
                     layout["tasks"].update(self.show_task_table())
-
                     next_task = self.workflow.get_next_task()
                     if not next_task:
                         break
-
                     layout["details"].update(self.show_task_status(next_task))
-
                     live.stop()
                     should_run = Confirm.ask(
-                        f"Run task '{next_task.name}'?",
-                        default=True,
+                        f"Run task '{next_task.name}'?", default=True
                     )
                     live.start()
-
                     if not should_run:
                         next_task.skip()
                         continue
-
                     next_task.start()
                     layout["details"].update(self.show_task_status(next_task))
                     time.sleep(1)
-
                     import random
 
                     success = random.choice([True, True, True, False])
-
                     if success:
                         next_task.complete(True)
                         completed_tasks += 1
@@ -372,48 +313,40 @@ class InteractiveCLI:
                             recovery=f"Retry the '{next_task.name}' task.",
                         )
                         next_task.fail(error)
-
                     progress.update(progress_task, completed=completed_tasks)
-
                     layout["details"].update(self.show_task_status(next_task))
-
                 layout["tasks"].update(self.show_task_table())
-
                 successful = sum(
-                    1
-                    for task in self.workflow.tasks.values()
-                    if task.status == TaskStatus.SUCCESS
+                    (
+                        1
+                        for task in self.workflow.tasks.values()
+                        if task.status == TaskStatus.SUCCESS
+                    )
                 )
                 failed = sum(
-                    1
-                    for task in self.workflow.tasks.values()
-                    if task.status == TaskStatus.FAILED
+                    (
+                        1
+                        for task in self.workflow.tasks.values()
+                        if task.status == TaskStatus.FAILED
+                    )
                 )
                 skipped = sum(
-                    1
-                    for task in self.workflow.tasks.values()
-                    if task.status == TaskStatus.SKIPPED
+                    (
+                        1
+                        for task in self.workflow.tasks.values()
+                        if task.status == TaskStatus.SKIPPED
+                    )
                 )
-
                 summary = Panel(
-                    f"Workflow completed!\n\n"
-                    f"[green]✅ Successful tasks: {successful}[/green]\n"
-                    f"[red]❌ Failed tasks: {failed}[/red]\n"
-                    f"[blue]⏩ Skipped tasks: {skipped}[/blue]",
+                    f"Workflow completed!\n\n[green]✅ Successful tasks: {successful}[/green]\n[red]❌ Failed tasks: {failed}[/red]\n[blue]⏩ Skipped tasks: {skipped}[/blue]",
                     title="Summary",
                     border_style="cyan",
                 )
                 layout["details"].update(summary)
-
             except KeyboardInterrupt:
                 layout["footer"].update(
-                    Panel(
-                        "Interrupted by user",
-                        style="yellow",
-                        box=ROUNDED,
-                    )
+                    Panel("Interrupted by user", style="yellow", box=ROUNDED)
                 )
-
         self.console.print("\nWorkflow Status:")
         self.workflow.display_task_tree()
 
@@ -421,53 +354,38 @@ class InteractiveCLI:
         self, prompt: str, directory: Path, default: str | None = None
     ) -> Path:
         self.console.print(f"\n[bold]{prompt}[/bold]")
-
         files = list(directory.iterdir())
         files.sort()
-
         table = Table(title=f"Files in {directory}", box=ROUNDED)
         table.add_column("#", style="cyan")
         table.add_column("Filename", style="green")
         table.add_column("Size", style="blue")
         table.add_column("Modified", style="yellow")
-
         for i, file in enumerate(files, 1):
             if file.is_file():
                 size = f"{file.stat().st_size / 1024:.1f} KB"
                 mtime = time.strftime(
-                    "%Y-%m-%d %H:%M:%S",
-                    time.localtime(file.stat().st_mtime),
+                    "%Y-%m-%d %H:%M:%S", time.localtime(file.stat().st_mtime)
                 )
                 table.add_row(str(i), file.name, size, mtime)
-
         self.console.print(table)
-
-        selection = Prompt.ask(
-            "Enter file number or name",
-            default=default or "",
-        )
-
+        selection = Prompt.ask("Enter file number or name", default=default or "")
         if selection.isdigit() and 1 <= int(selection) <= len(files):
             return files[int(selection) - 1]
         else:
             for file in files:
                 if file.name == selection:
                     return file
-
             return directory / selection
 
     def confirm_dangerous_action(self, action: str, details: str) -> bool:
         panel = Panel(
-            f"[bold red]WARNING: {action}[/bold red]\n\n{details}\n\n"
-            "This action cannot be undone. Please type the action name to confirm.",
+            f"[bold red]WARNING: {action}[/bold red]\n\n{details}\n\nThis action cannot be undone. Please type the action name to confirm.",
             title="Confirmation Required",
             border_style="red",
         )
-
         self.console.print(panel)
-
         confirmation = Prompt.ask("Type the action name to confirm")
-
         return confirmation.lower() == action.lower()
 
     def show_error(self, error: CrackerjackError, verbose: bool = False) -> None:
@@ -477,7 +395,6 @@ class InteractiveCLI:
 def launch_interactive_cli(version: str) -> None:
     console = Console()
     cli = InteractiveCLI(console)
-
     cli.show_banner(version)
     cli.create_standard_workflow()
     cli.run_interactive()

crackerjack/py313.py

@@ -1,13 +1,3 @@
-"""Python 3.13+ specific features and enhancements.
-
-This module contains implementations that leverage the latest Python 3.13+ features.
-It serves as a showcase for modern Python capabilities including:
-- Pattern matching
-- PEP 695 type parameter syntax
-- Self type annotations
-- More precise type hints
-"""
-
 import subprocess
 import typing
 from enum import Enum, auto
@@ -31,21 +21,16 @@ class CommandResult(TypedDict):
 def process_command_output(result: CommandResult) -> tuple[bool, str]:
     match result:
         case {"success": True, "stdout": stdout} if stdout.strip():
-            return True, stdout
-
+            return (True, stdout)
         case {"success": True}:
-            return True, "Command completed successfully with no output"
-
+            return (True, "Command completed successfully with no output")
         case {"success": False, "exit_code": code, "stderr": stderr} if code == 127:
-            return False, f"Command not found: {stderr}"
-
+            return (False, f"Command not found: {stderr}")
         case {"success": False, "exit_code": code} if code > 0:
-            return False, f"Command failed with exit code {code}: {result['stderr']}"
-
+            return (False, f"Command failed with exit code {code}: {result['stderr']}")
         case _:
             pass
-
-    return False, "Unknown command result pattern"
+    return (False, "Unknown command result pattern")
 
 
 class HookStatus(Enum):
@@ -66,24 +51,18 @@ def analyze_hook_result(result: HookResult) -> str:
     match result:
         case {"status": HookStatus.SUCCESS, "hook_id": hook_id}:
             return f"✅ Hook {hook_id} passed successfully"
-
         case {"status": HookStatus.FAILURE, "hook_id": hook_id, "output": output} if (
             "fixable" in output
         ):
             return f"🔧 Hook {hook_id} failed with fixable issues"
-
         case {"status": HookStatus.FAILURE, "hook_id": hook_id}:
             return f"❌ Hook {hook_id} failed"
-
         case {"status": HookStatus.SKIPPED, "hook_id": hook_id}:
             return f"⏩ Hook {hook_id} was skipped"
-
         case {"status": HookStatus.ERROR, "hook_id": hook_id, "output": output}:
             return f"💥 Hook {hook_id} encountered an error: {output}"
-
         case _:
             pass
-
     return "Unknown hook result pattern"
 
 
@@ -106,29 +85,22 @@ class ModernConfigManager:
 def categorize_file(file_path: Path) -> str:
     path_str = str(file_path)
     name = file_path
-
     match path_str:
         case s if name.suffix == ".py" and "/tests/" in s:
             return "Python Test File"
-
         case s if name.suffix == ".py" and "__init__.py" in name.name:
             return "Python Module Init"
-
         case s if name.suffix == ".py":
             return "Python Source File"
-
         case s if name.suffix in {".md", ".rst", ".txt"}:
             return "Documentation File"
-
         case s if name.stem.startswith(".") or name.name in {
             ".gitignore",
             ".pre-commit-config.yaml",
         }:
             return "Configuration File"
-
         case _:
             pass
-
     return "Unknown File Type"
 
 
@@ -138,13 +110,11 @@ def process_hook_results[T, R](
     failure_handler: typing.Callable[[T], R],
 ) -> list[R]:
     processed_results = []
-
     for result in results:
         if isinstance(result, dict) and result.get("status") == HookStatus.SUCCESS:
             processed_results.append(success_handler(result))
         else:
             processed_results.append(failure_handler(result))
-
     return processed_results
 
 
@@ -156,26 +126,21 @@ class EnhancedCommandRunner:
         import time
 
         start_time = time.time()
-
         try:
             process = subprocess.run(
                 cmd, capture_output=True, text=True, cwd=self.working_dir, **kwargs
             )
-
             duration_ms = (time.time() - start_time) * 1000
-
             return CommandResult(
-                success=(process.returncode == 0),
+                success=process.returncode == 0,
                 exit_code=process.returncode,
                 stdout=process.stdout,
                 stderr=process.stderr,
                 command=cmd,
                 duration_ms=duration_ms,
             )
-
         except subprocess.SubprocessError as e:
             duration_ms = (time.time() - start_time) * 1000
-
             return CommandResult(
                 success=False,
                 exit_code=-1,
@@ -192,30 +157,25 @@ class EnhancedCommandRunner:
 def clean_python_code(code: str) -> str:
     lines = code.splitlines()
     cleaned_lines = []
-
     for line in lines:
         match line.strip():
             case "":
                 if not cleaned_lines or cleaned_lines[-1].strip():
                     cleaned_lines.append("")
-
             case s if s.startswith(("import ", "from ")):
                 cleaned_lines.append(line)
-
             case s if s.startswith("#"):
                 continue
-
-            case s if "#" in s and not any(
-                skip in s for skip in ("# noqa", "# type:", "# pragma", "# skip")
+            case s if "#" in s and (
+                not any(
+                    (skip in s for skip in ("# noqa", "# type:", "# pragma", "# skip"))
+                )
             ):
                 code_part = line.split("#", 1)[0].rstrip()
                 if code_part:
                     cleaned_lines.append(code_part)
-
             case s if s.startswith('"""') or s.startswith("'''"):
                 continue
-
             case _:
                 cleaned_lines.append(line)
-
     return "\n".join(cleaned_lines)

crackerjack/pyproject.toml

@@ -4,7 +4,7 @@ requires = [ "pdm-backend" ]
 
 [project]
 name = "crackerjack"
-version = "0.20.2"
+version = "0.20.9"
 description = "Crackerjack: code quality toolkit"
 readme = "README.md"
 keywords = [
@@ -42,6 +42,7 @@ classifiers = [
 ]
 dependencies = [
     "autotyping>=24.9",
+    "keyring>=25.6",
     "pdm>=2.24.2",
     "pdm-bump>=0.9.12",
     "pre-commit>=4.2",
@@ -216,6 +217,7 @@ exclude-deps = [
     "tomli-w",
     "google-crc32c",
     "pytest-timeout",
+    "keyring",
 ]
 
 [tool.refurb]

{crackerjack-0.20.3.dist-info → crackerjack-0.20.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crackerjack
-Version: 0.20.3
+Version: 0.20.10
 Summary: Crackerjack: code quality toolkit
 Keywords: bandit,black,creosote,mypy,pyright,pytest,refurb,ruff
 Author-Email: lesleslie <les@wedgwoodwebworks.com>
@@ -23,6 +23,7 @@ Project-URL: homepage, https://github.com/lesleslie/crackerjack
 Project-URL: repository, https://github.com/lesleslie/crackerjack
 Requires-Python: >=3.13
 Requires-Dist: autotyping>=24.9
+Requires-Dist: keyring>=25.6
 Requires-Dist: pdm>=2.24.2
 Requires-Dist: pdm-bump>=0.9.12
 Requires-Dist: pre-commit>=4.2