cli_flags.py

Go to the documentation of this file.

# Copyright (c) 2025-present Aquin Labs Private Limited. All Rights Reserved.
"""Shared CLI flag helpers."""
 
from __future__ import annotations
 
import sys
 
 
def reject_legacy_output_flags(
    args: list[str],
    *,
    save_hint: str | None = "--save <path>",
    dir_hint: str | None = None,
) -> None:
    """Reject removed --output / --format flags with actionable hints."""
    for i, a in enumerate(args):
        if a not in ("--output", "--format", "--output-json"):
            continue
        print("Error: --output was removed.", file=sys.stderr)
        print("       Use --check to save JSON + PNG check artifacts in the current directory.", file=sys.stderr)
        if save_hint:
            print(f"       For a custom export path use {save_hint}.", file=sys.stderr)
        if dir_hint:
            print(f"       For capture output directory use {dir_hint}.", file=sys.stderr)
        sys.exit(1)