Function watch_command

src/pyspector/cli.py:973–1129

Continuous watch mode: re-scan on every .py file change.

(
    path:           Path,
    severity_level: str,
    ai_scan:        bool,
    config_path:    Optional[Path],
    debounce:       float,
    debug:          bool,
)

@click.option(
    "-s", "--severity", "severity_level",
    type=click.Choice(["LOW", "MEDIUM", "HIGH", "CRITICAL"]),
    default="LOW", show_default=True,
    help="Minimum severity level to report.",
)
@click.option(
    "--ai", "ai_scan", is_flag=True, default=False,
    help="Enable specialized scanning for AI/LLM vulnerabilities.",
)
@click.option(
    "-c", "--config", "config_path",
    type=click.Path(exists=True, path_type=Path),
    help="Path to a pyspector.toml config file.",
)
@click.option(
    "--debounce", default=1.0, show_default=True, metavar="SECONDS",
    help="Wait this many seconds after the last change before re-scanning.",
)
@click.option(
    "--debug", is_flag=True, default=False,
    help="Show verbose progress output.",
)
@click.option(
    "--msg", "show_msg", type=bool, default=None,
    help="Enable or disable the rotating contact message shown below the "
         "banner (--msg=True / --msg=False). The setting persists across "
         "future runs until changed again, so it only needs to be set once.",
)
def watch_command(
    path:           Path,
    severity_level: str,
    ai_scan:        bool,
    config_path:    Optional[Path],
    debounce:       float,
    debug:          bool,
    show_msg:       Optional[bool],
) -> None:
    """Continuous watch mode: re-scan on every .py file change."""
    try:
        from watchdog.observers import Observer
        from watchdog.events import FileSystemEventHandler
    except ImportError:
        click.echo(
            "Error: 'watchdog' is required for watch mode.\n"
            "Install it with:  pip install 'watchdog>=3.0'"
        )
        sys.exit(1)

    _print_banner()
    handle_msg_flag(show_msg)
    click.echo(f"[*] Watch mode  —  " + click.style(str(path), bold=True))
    click.echo(
        f"    Severity : {severity_level}"
        f"  |  AI rules : {'on' if ai_scan else 'off'}"
        f"  |  Debounce : {debounce}s"
        f"  |  Ctrl+C to stop\n"
    )

    _DIVIDER      = "─" * 62