Function diff_extractors_cmd

explainshell/manager.py:987–1039

Compare two extractors head-to-head. SPEC is A..B format (e.g. llm:openai/gpt-5-mini..llm:openai/gpt-5).

(
    ctx: click.Context,
    batch: int | None,
    spec: str,
    files: tuple[str, ...],
)

@click.argument("files", nargs=-1, required=True)
@click.pass_context
def diff_extractors_cmd(
    ctx: click.Context,
    batch: int | None,
    spec: str,
    files: tuple[str, ...],
) -> None:
    """Compare two extractors head-to-head.

    SPEC is A..B format (e.g. llm:openai/gpt-5-mini..llm:openai/gpt-5).
    """
    if ".." not in spec:
        raise click.UsageError(
            f"invalid spec: {spec!r} "
            "(expected A..B, e.g. llm:openai/gpt-5-mini..llm:openai/gpt-5)"
        )
    parts = spec.split("..", 1)
    try:
        left = _parse_mode(parts[0])
        right = _parse_mode(parts[1])
    except ValueError as e:
        raise click.UsageError(str(e))

    if batch is not None:
        if batch < 1:
            raise click.UsageError("--batch must be >= 1")
        _, left_model = left
        _, right_model = right
        has_batch_side = any(
            m is not None and m.startswith(_BATCH_MODEL_PREFIXES)
            for m in (left_model, right_model)
        )
        if not has_batch_side:
            raise click.UsageError(
                "--batch requires at least one side with a batch-capable model "
                "(gemini/, openai/, or azure/)"
            )

    try:
        gz_files = util.collect_gz_files(list(files))
    except ValueError as e:
        raise click.UsageError(str(e))
    if not gz_files:
        raise click.UsageError("No .gz files found.")

    run_dir: str = _ensure_run_dir(ctx)
    t0 = time.monotonic()
    batch_result = _run_diff_extractors(
        gz_files, left, right, run_dir, batch_size=batch
    )
    elapsed = time.monotonic() - t0
    rc = _log_summary(batch_result, 0, elapsed)
    if rc != 0:
        sys.exit(rc)


# ---------------------------------------------------------------------------