Cannot define sorting in bash autocompletion for Argument

[celynw]

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

from typing import Annotated

import typer

app = typer.Typer()


def do_complete() -> list[str]:
	return ["1 one", "2 two", "3 three", "10 ten"]


@app.command()
def _main(example: Annotated[int, typer.Argument(autocompletion=do_complete)]) -> None:
	pass


if __name__ == "__main__":
	typer.run(_main)

Description

• Create a small Typer script with autocompletions (see MWE).

• Open a bash shell.

• Trigger autocompletion hitting TAB.

• I see the results have been sorted non-naturally:

  $ typer example.py run <TAB>
  1 one
  10 ten
  2 two
  3 three
  

I would like to be able to see the results in an order of my choosing. Perhaps let me arrange the items in the completion function, and not let bash sort them in its own way afterwards.

It took me a while to find the cause, but it's due to using complete -o default:

typer/typer/_completion_shared.py

Line 33 in 0b89650

complete -o default -F %(complete_func)s %(prog_name)s

This overrides the Click equivalent, which uses complete -o nosort:

https://github.com/pallets/click/blob/934813e4d421071a1b3db3973c02fe2721359a6e/src/click/shell_completion.py#L119

This difference was mentioned in #682:

Click uses complete -o nosort, while Typer uses complete -o default

Even if there's a reason for this change, there is currently no option to, for instance, use natural sorting, aside from editing the generated .sh file in $HOME/.bash_completions, which does solve the issue for me.

Operating System

Linux

Operating System Details

I think this is not applicable, but anyway:

• OS: Ubuntu 22.04.5 LTS
  • Linux giru 5.15.167.4-microsoft-standard-WSL2 #1 SMP Tue Nov 5 00:21:55 UTC 2024 x86_64 x86_64 x86_64 GNU/Linux
• Bash version: GNU bash, version 5.1.16(1)-release (x86_64-pc-linux-gnu)

Typer Version

0.15.1

Python Version

Python 3.13.0

Additional Context

No response