Double dash "--" to stop options parsing

[kafeinnet]

First Check

• I added a very descriptive title here.
• I used the GitHub search to find a similar question and didn't find it.
• I searched the Typer documentation, with the integrated search.
• I already searched in Google "How to X in Typer" and didn't find any information.
• I already read and followed all the tutorials in the docs and didn't find an answer.
• I already checked if it is not related to Typer but to Click.

Commit to Help

• I commit to help with one of those options 👆

Example Code

@app.command(name="exec")
def exec_(
    ctx: typer.Context,
    cmd: Annotated[
        str,
        typer.Argument(
            metavar="COMMAND",
            help="Command to execute on the nodes",
            show_default=False,
        ),
    ],
    *,
    nodeset: Annotated[
        str | None,
        typer.Option(
            "--nodeset",
            "-n",
            help="Nodeset the command should be executed for.",
        ),
    ] = "all@",
    sudo: Annotated[
        bool,
        typer.Option(
            "--sudo",
            "-s",
            help="Execute the command with sudo",
        ),
    ] = False,
) -> None:
    """Execute a command on a list of nodes."""

Description

Is it possible to stop options parsing with a double dash like the GNU extension of getops?

For instance, I'd like typer to not process all the arguments after the double dash as options but as a simple str.

❯ uv run python -m tool nodes exec -s -n nodes@ -- systemctl --failed
Usage: python -m tool nodes exec [OPTIONS] COMMAND
Try 'python -m tool nodes exec --help' for help.
╭─ Error ─────────────────────────────────────────────────────────────────────────────────────────────╮
│ Got unexpected extra argument (--failed)                                                            │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────╯

As a workaround I can wrap the command into quotes but that's kind of annoying.

Operating System

Linux

Operating System Details

I use archlinux btw.

Typer Version

0.15.2

Python Version

Python 3.12.6

Additional Context

No response

[YuriiMotov]

It's not documented, but yes, it works this way:

import typer

app = typer.Typer()

@app.command()
def my_command(
    arg1: str,
    opt1: str = "123",
):
    typer.echo(f"{arg1=}, {opt1=}")

if __name__ == "__main__":
    app()

Try it:

$ typer main.py run -qwerty
Usage: typer [PATH_OR_MODULE] run [OPTIONS] ARG1
Try 'typer [PATH_OR_MODULE] run --help' for help.
╭─ Error ───────────────────────────────────────────────────────────────────────────╮
│ No such option: -q                                                                │
╰───────────────────────────────────────────────────────────────────────────────────╯

$ typer main.py run -- -qwerty
arg1='-qwerty', opt1='123'