Function parse_export_args

src/utils/export_formats.py:160–215

Parse ``/export`` command arguments. Supported flags: ``--format `` or ``-f ``. Returns parsed filename, format, and optional error string.

(args: str)

def parse_export_args(args: str) -> ParsedExportArgs:
    """Parse ``/export`` command arguments.

    Supported flags: ``--format <value>`` or ``-f <value>``.

    Returns parsed filename, format, and optional error string.
    """
    tokens, tok_error = _tokenize_export_args(args)
    if tok_error:
        return ParsedExportArgs(error=tok_error)

    if len(tokens) == 0:
        return ParsedExportArgs()

    fmt: Optional[ExportFormat] = None
    error: Optional[str] = None
    filename_tokens: List[str] = []

    i = 0
    n = len(tokens)
    while i < n:
        token = tokens[i]
        if not token.quoted and token.value == "--":
            filename_tokens.extend(t.value for t in tokens[i + 1 :])
            break
        if not token.quoted and token.value in ("--format", "-f"):
            i += 1
            value = tokens[i].value if i < n else None
            if not value:
                error = f"Missing value for {token.value}. {SUPPORTED_FORMATS}"
                break
            normalized = normalize_export_format(value)
            if not normalized:
                error = f"Unsupported export format: {value}. {SUPPORTED_FORMATS}"
                break
            fmt = normalized
        elif (
            not token.quoted
            and token.value.startswith("-")
            and token.value != "-"
        ):
            error = (
                f"Unsupported export option: {token.value}. "
                "Supported options: --format, -f."
            )
            break
        else:
            filename_tokens.append(token.value)
        i += 1

    filename = " ".join(filename_tokens) if filename_tokens else None

    if error:
        return ParsedExportArgs(filename=filename, format=fmt, error=error)

    return ParsedExportArgs(filename=filename, format=fmt)