CLI Option Prompt

It's also possible to, instead of just showing an error, ask for the missing value with prompt=True:

Python 3.8+

import typer
from typing_extensions import Annotated


def main(name: str, lastname: Annotated[str, typer.Option(prompt=True)]):
    print(f"Hello {name} {lastname}")


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

🤓 Other versions and variants

Python 3.8+ - non-Annotated

Tip

Prefer to use the Annotated version if possible.

import typer


def main(name: str, lastname: str = typer.Option(..., prompt=True)):
    print(f"Hello {name} {lastname}")


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

And then your program will ask the user for it in the terminal:

fast →💬 Call it with the NAME CLI argumentpython main.py Camila
💬 It asks for the missing CLI option --lastnameGutiérrez
Hello Camila Gutiérrez

restart ↻

Customize the prompt

You can also set a custom prompt, passing the string that you want to use instead of just True:

Python 3.8+

import typer
from typing_extensions import Annotated


def main(
    name: str,
    lastname: Annotated[str, typer.Option(prompt="Please tell me your last name")],
):
    print(f"Hello {name} {lastname}")


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

🤓 Other versions and variants

Python 3.8+ - non-Annotated

Tip

Prefer to use the Annotated version if possible.

import typer


def main(
    name: str, lastname: str = typer.Option(..., prompt="Please tell me your last name")
):
    print(f"Hello {name} {lastname}")


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

And then your program will ask for it using with your custom prompt:

fast →💬 Call it with the NAME CLI argumentpython main.py Camila
💬 It uses the custom promptGutiérrez
Hello Camila Gutiérrez

restart ↻

Confirmation prompt

In some cases you could want to prompt for something and then ask the user to confirm it by typing it twice.

You can do it passing the parameter confirmation_prompt=True.

Let's say it's a CLI app to delete a project:

Python 3.8+

import typer
from typing_extensions import Annotated


def main(
    project_name: Annotated[str, typer.Option(prompt=True, confirmation_prompt=True)],
):
    print(f"Deleting project {project_name}")


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

🤓 Other versions and variants

Python 3.8+ - non-Annotated

Tip

Prefer to use the Annotated version if possible.

import typer


def main(project_name: str = typer.Option(..., prompt=True, confirmation_prompt=True)):
    print(f"Deleting project {project_name}")


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

And it will prompt the user for a value and then for the confirmation:

fast →python main.py
💬 Your app will first prompt for the project name, and then for the confirmationOld ProjectOld Project
Deleting project Old Project

💬 If the user doesn't type the same, receives an error and a new promptpython main.py
Old ProjectNew Spice
Error: The two entered values do not match

Old ProjectOld Project
Deleting project Old Project

💬 Now it works 🎉
restart ↻