typer autocompletion hangs indefinitely for scripts using uv package manager

[lockmeister]

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

#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.8"
# dependencies = [
#   "typer",
# ]
# ///

import typer

app = typer.Typer()

@app.command()
def example():
    print("Hello, Typer!")

if __name__ == "__main__":
    app()

Description

• save the example script above as example
• install the script sudo install -m 755 example /usr/local/bin/
• install completions example --install-completion
• restart your terminal (or source ~/.bashrc)
• test autocompletion (type example then press tab)
  Expected behaviour: autocompletion of commands
  Acutal behaviour: hangs while UV reads inline metadata
  example Reading inline script metadata from /usr/local/bin/example

why this is important:
uv is a very handy package manager with widespread adoption. It makes it much easier to write quick python scripts and yet be able to quickly install them and use them globally in your system. It would be a pity not to be able to use typer's autocomplete for scripts managed by uv.

Operating System

Linux

Operating System Details

No response

Typer Version

0.15.1

Python Version

3.12

Additional Context

No response