Unrecognised tokens are only passed through if a parameter is matched about cyclopts HOT 2 CLOSED

thanks for the minimal example! Initially this appears to be a bug, but upon closer inspection it's actually intended behavior.

Cyclopts parses items in order:

1. Attempts to parse all keyword/value pairs and flags.
2. Attempts to parse positional arguments from all remaining tokens.

So, in the first example, the --is-set gets assigned to the is_set python variable. --something-else doesn't have a valid keyword assignment, so it gets passed along as a positional argument. This leaves --something-else to be parsed to the next availabe positional parameter, which is tokens.

In the second example, --something-else doesn't have a valid keyword assignment, so it gets passed along as a positional argument. The first positional argument is now is_set, which has the default annotated Parameter(allow_leading_hyphen=False), leading to the UnknownOptionError .

In order to get your desired behavior, it's probably better to:

@app.default
def main(*tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)], is_set: bool = False):
    print(f"is_set = {is_set}")
    print(f"extras = {tokens}")

which then works as you'd expect.

from cyclopts.

Thanks so much for such a quick and helpful response, @BrianPugh!

I had previously thought that the *tokens field was somehow handled specially, but now I see it actually isn't - it's just a standard, required (but possibly empty) list of positional arguments. Thanks again!

Thanks for an awesome library; this is the forth I've tried (argparse, fire, pyinvoke, click) and is the first I'm really happy with!

from cyclopts.