crackerjack 0.30.3__py3-none-any.whl → 0.31.4__py3-none-any.whl

crackerjack/cli/options.py

@@ -0,0 +1,401 @@
+import typing as t
+from enum import Enum
+
+import typer
+from pydantic import BaseModel, field_validator
+
+
+class BumpOption(str, Enum):
+    patch = "patch"
+    minor = "minor"
+    major = "major"
+    interactive = "interactive"
+
+    def __str__(self) -> str:
+        return self.value
+
+
+class Options(BaseModel):
+    commit: bool = False
+    interactive: bool = False
+    no_config_updates: bool = False
+    update_precommit: bool = False
+    publish: BumpOption | None = None
+    bump: BumpOption | None = None
+    verbose: bool = False
+    clean: bool = False
+    test: bool = False
+    benchmark: bool = False
+    test_workers: int = 0
+    test_timeout: int = 0
+    all: BumpOption | None = None
+    ai_agent: bool = False
+    start_mcp_server: bool = False
+    stop_mcp_server: bool = False
+    restart_mcp_server: bool = False
+    create_pr: bool = False
+    skip_hooks: bool = False
+    fast: bool = False
+    comp: bool = False
+    async_mode: bool = False
+    experimental_hooks: bool = False
+    enable_pyrefly: bool = False
+    enable_ty: bool = False
+    cleanup: t.Any | None = None
+    no_git_tags: bool = False
+    skip_version_check: bool = False
+    cleanup_pypi: bool = False
+    keep_releases: int = 10
+    track_progress: bool = False
+    orchestrated: bool = False
+    coverage: bool = False
+    orchestration_strategy: str = "adaptive"
+    orchestration_progress: str = "granular"
+    orchestration_ai_mode: str = "single-agent"
+    monitor: bool = False
+    enhanced_monitor: bool = False
+    watchdog: bool = False
+    start_websocket_server: bool = False
+    stop_websocket_server: bool = False
+    restart_websocket_server: bool = False
+    websocket_port: int | None = None
+    dev: bool = False
+    dashboard: bool = False
+    max_iterations: int = 10
+    enterprise_batch: str | None = None
+    monitor_dashboard: str | None = None
+    coverage_status: bool = False
+    coverage_goal: float | None = None
+    no_coverage_ratchet: bool = False
+
+    @classmethod
+    @field_validator("publish", "bump", mode="before")
+    def validate_bump_options(cls, value: t.Any) -> BumpOption | None:
+        if value is None:
+            return None
+        if value == "":
+            return BumpOption.interactive
+        try:
+            return BumpOption(value.lower())
+        except ValueError:
+            valid_options = ", ".join([o.value for o in BumpOption])
+            msg = f"Invalid bump option: {value}. Must be one of: {valid_options}"
+            raise ValueError(
+                msg,
+            )
+
+
+CLI_OPTIONS = {
+    "commit": typer.Option(
+        False,
+        "-c",
+        "--commit",
+        help="Commit and push changes to Git.",
+    ),
+    "interactive": typer.Option(
+        False,
+        "-i",
+        "--interactive",
+        help="Use the interactive Rich UI for a better experience.",
+    ),
+    "no_config_updates": typer.Option(
+        False,
+        "-n",
+        "--no-config-updates",
+        help="Do not update configuration files.",
+    ),
+    "update_precommit": typer.Option(
+        False,
+        "-u",
+        "--update-precommit",
+        help="Update pre-commit hooks configuration.",
+    ),
+    "verbose": typer.Option(False, "-v", "--verbose", help="Enable verbose output."),
+    "publish": typer.Option(
+        None,
+        "-p",
+        "--publish",
+        help="Bump version and publish to PyPI (patch, minor, major). Use 'interactive' to be prompted for version selection.",
+        case_sensitive=False,
+    ),
+    "bump": typer.Option(
+        None,
+        "-b",
+        "--bump",
+        help="Bump version (patch, minor, major).",
+        case_sensitive=False,
+    ),
+    "clean": typer.Option(
+        False,
+        "-x",
+        "--clean",
+        help="Remove docstrings, line comments, and unnecessary whitespace from source code (doesn't affect test files).",
+    ),
+    "test": typer.Option(False, "-t", "--test", help="Run tests."),
+    "benchmark": typer.Option(
+        False,
+        "--benchmark",
+        help="Run tests in benchmark mode (disables parallel execution).",
+    ),
+    "test_workers": typer.Option(
+        0,
+        "--test-workers",
+        help="Number of parallel workers for running tests (0 = auto-detect, 1 = disable parallelization).",
+    ),
+    "test_timeout": typer.Option(
+        0,
+        "--test-timeout",
+        help="Timeout in seconds for individual tests (0 = use default based on project size).",
+    ),
+    "skip_hooks": typer.Option(
+        False,
+        "-s",
+        "--skip-hooks",
+        help="Skip running pre-commit hooks (useful with -t).",
+    ),
+    "fast": typer.Option(
+        False,
+        "--fast",
+        help="Run only fast hooks (formatting and basic checks).",
+    ),
+    "comp": typer.Option(
+        False,
+        "--comp",
+        help="Run only comprehensive hooks (type checking, security, complexity analysis).",
+    ),
+    "all": typer.Option(
+        None,
+        "-a",
+        "--all",
+        help="Run with `-x -t -p <patch|minor|major> -c` development options).",
+        case_sensitive=False,
+    ),
+    "create_pr": typer.Option(
+        False,
+        "-r",
+        "--pr",
+        "--new-pull-request",
+        help="Create a new pull request to the upstream repository.",
+    ),
+    "ai_agent": typer.Option(
+        False,
+        "--ai-agent",
+        help="Enable AI agent mode with autonomous auto-fixing.",
+    ),
+    "start_mcp_server": typer.Option(
+        False,
+        "--start-mcp-server",
+        help="Start MCP server for AI agent integration.",
+    ),
+    "stop_mcp_server": typer.Option(
+        False,
+        "--stop-mcp-server",
+        help="Stop all running MCP servers.",
+    ),
+    "restart_mcp_server": typer.Option(
+        False,
+        "--restart-mcp-server",
+        help="Restart MCP server (stop and start again).",
+    ),
+    "async_mode": typer.Option(
+        False,
+        "--async",
+        help="Enable async mode for faster file operations (experimental).",
+        hidden=True,
+    ),
+    "experimental_hooks": typer.Option(
+        False,
+        "--experimental-hooks",
+        help="Enable experimental pre-commit hooks (includes pyrefly and ty).",
+    ),
+    "enable_pyrefly": typer.Option(
+        False,
+        "--enable-pyrefly",
+        help="Enable pyrefly experimental type checking (requires experimental hooks mode).",
+    ),
+    "enable_ty": typer.Option(
+        False,
+        "--enable-ty",
+        help="Enable ty experimental type verification (requires experimental hooks mode).",
+    ),
+    "no_git_tags": typer.Option(
+        False,
+        "--no-git-tags",
+        help="Skip creating git tags during version bumping (tags are created by default).",
+    ),
+    "skip_version_check": typer.Option(
+        False,
+        "--skip-version-check",
+        help="Skip version consistency verification between pyproject.toml and git tags.",
+    ),
+    "start_websocket_server": typer.Option(
+        False,
+        "--start-websocket-server",
+        help="Start WebSocket progress server on port 8675.",
+    ),
+    "stop_websocket_server": typer.Option(
+        False,
+        "--stop-websocket-server",
+        help="Stop all running WebSocket servers.",
+    ),
+    "restart_websocket_server": typer.Option(
+        False,
+        "--restart-websocket-server",
+        help="Restart WebSocket server (stop and start again).",
+    ),
+    "websocket_port": typer.Option(
+        None,
+        "--websocket-port",
+        help="Port for WebSocket server when using --start-mcp-server (e.g., 8675).",
+    ),
+    "watchdog": typer.Option(
+        False,
+        "--watchdog",
+        help="Start service watchdog to monitor and auto-restart MCP and WebSocket servers.",
+    ),
+    "monitor": typer.Option(
+        False,
+        "--monitor",
+        help="Start multi-project progress monitor with WebSocket polling, watchdog services, and autodiscovery.",
+    ),
+    "enhanced_monitor": typer.Option(
+        False,
+        "--enhanced-monitor",
+        help="Start enhanced progress monitor with advanced MetricCard widgets and modern web UI patterns.",
+    ),
+    "dev": typer.Option(
+        False,
+        "--dev",
+        help="Enable development mode for progress monitors (enables textual --dev mode).",
+    ),
+    "dashboard": typer.Option(
+        False,
+        "--dashboard",
+        help="Start the comprehensive dashboard with system metrics, job tracking, and performance monitoring.",
+    ),
+    "max_iterations": typer.Option(
+        10,
+        "--max-iterations",
+        help="Maximum number of iterations for AI agent auto-fixing workflows (default: 10).",
+    ),
+    "ai_debug": typer.Option(
+        False,
+        "--ai-debug",
+        help="Enable verbose debugging for AI agent mode (implies --ai-agent).",
+    ),
+    "job_id": typer.Option(
+        None,
+        "--job-id",
+        help="Job ID for WebSocket progress tracking (internal use).",
+        hidden=True,
+    ),
+    "orchestrated": typer.Option(
+        False,
+        "--orchestrated",
+        help="Enable advanced orchestrated workflow mode with intelligent execution strategies, granular progress tracking, and multi-agent AI coordination.",
+    ),
+    "orchestration_strategy": typer.Option(
+        "adaptive",
+        "--orchestration-strategy",
+        help="Execution strategy for orchestrated mode: batch, individual, adaptive, selective (default: adaptive).",
+    ),
+    "orchestration_progress": typer.Option(
+        "granular",
+        "--orchestration-progress",
+        help="Progress tracking level: basic, detailed, granular, streaming (default: granular).",
+    ),
+    "orchestration_ai_mode": typer.Option(
+        "single-agent",
+        "--orchestration-ai-mode",
+        help="AI coordination mode: single-agent, multi-agent, coordinator (default: single-agent).",
+    ),
+    "coverage_status": typer.Option(
+        False,
+        "--coverage-status",
+        help="Show current coverage ratchet status and progress toward 100%.",
+    ),
+    "coverage_goal": typer.Option(
+        None,
+        "--coverage-goal",
+        help="Set explicit coverage target for this session (e.g., 15.0).",
+    ),
+    "no_coverage_ratchet": typer.Option(
+        False,
+        "--no-coverage-ratchet",
+        help="Disable coverage ratchet system temporarily (for experiments).",
+    ),
+}
+
+
+def create_options(
+    commit: bool,
+    interactive: bool,
+    no_config_updates: bool,
+    update_precommit: bool,
+    verbose: bool,
+    publish: BumpOption | None,
+    all: BumpOption | None,
+    bump: BumpOption | None,
+    clean: bool,
+    test: bool,
+    benchmark: bool,
+    test_workers: int,
+    test_timeout: int,
+    skip_hooks: bool,
+    fast: bool,
+    comp: bool,
+    create_pr: bool,
+    ai_agent: bool,
+    async_mode: bool,
+    experimental_hooks: bool,
+    enable_pyrefly: bool,
+    enable_ty: bool,
+    no_git_tags: bool,
+    skip_version_check: bool,
+    orchestrated: bool,
+    orchestration_strategy: str,
+    orchestration_progress: str,
+    orchestration_ai_mode: str,
+    dev: bool,
+    dashboard: bool,
+    max_iterations: int,
+    coverage_status: bool,
+    coverage_goal: float | None,
+    no_coverage_ratchet: bool,
+) -> Options:
+    return Options(
+        commit=commit,
+        interactive=interactive,
+        no_config_updates=no_config_updates,
+        update_precommit=update_precommit,
+        verbose=verbose,
+        publish=publish,
+        bump=bump,
+        clean=clean,
+        test=test,
+        benchmark=benchmark,
+        test_workers=test_workers,
+        test_timeout=test_timeout,
+        skip_hooks=skip_hooks,
+        fast=fast,
+        comp=comp,
+        all=all,
+        ai_agent=ai_agent,
+        create_pr=create_pr,
+        async_mode=async_mode,
+        experimental_hooks=experimental_hooks,
+        enable_pyrefly=enable_pyrefly,
+        enable_ty=enable_ty,
+        no_git_tags=no_git_tags,
+        skip_version_check=skip_version_check,
+        orchestrated=orchestrated,
+        orchestration_strategy=orchestration_strategy,
+        orchestration_progress=orchestration_progress,
+        orchestration_ai_mode=orchestration_ai_mode,
+        dev=dev,
+        dashboard=dashboard,
+        max_iterations=max_iterations,
+        coverage_status=coverage_status,
+        coverage_goal=coverage_goal,
+        no_coverage_ratchet=no_coverage_ratchet,
+    )

crackerjack/cli/utils.py

@@ -0,0 +1,18 @@
+from pathlib import Path
+
+
+def get_package_version() -> str:
+    try:
+        from importlib.metadata import version
+
+        return version("crackerjack")
+    except (ImportError, ModuleNotFoundError):
+        try:
+            import tomllib
+
+            pyproject_path = Path(__file__).parent.parent.parent / "pyproject.toml"
+            with pyproject_path.open("rb") as f:
+                pyproject_data = tomllib.load(f)
+            return pyproject_data["project"]["version"]
+        except Exception:
+            return "unknown"