aprompt 3.0.0

Advanced Prompts

aprompt - Advanced Prompts

Why use input() when you can go advanced?

aprompt lets you prompt users in a neat way. It comes with a UI system and everything is customizable!

Features

• ✅ Large set of built-in prompts.
• ✅ Custom prompts
• ✅ Custom themes
• ✅ Drop-in replacement for argparse
• ✅ Test API

Available Prompts

While it is easily possible to create custom prompts. aprompt comes with a lot of useful prompts.

• Text
• Integer
• Confirmation
• PIN Code
• Sort[^1]
• Choice
• Multiple Choice
• Path
• Datetime
• Date
• Time

[^1]: This feature is unstable. Sorting upwards does not work.

Basic Usage

from aprompt import prompt
from aprompt.prompts import choice

languages: list[str] = prompt(
    "In what languages can you code in?",
    choice(
        "c",
        "c++",
        "erlang",
        "fortran",
        "haskell",
        "javascript",
        "nim",
        "python",
        "ruby",
        "rust",
        "typescript",
        multiple=True
    )
)

# ... do something with `languages` ...

Test API

aprompt provides the attribute test_with for the main prompt wrapper to test the result for a predefined sequence of keys.

def test_n() -> None:
    assert not prompt("", confirm(), test_with=iter("n\n"))

Links

• 🐍 Repo
• 📦 PyPI
• 📖 Docs (soon)

ToDo

• add path prompt as
• turn matches to if-elses
• add demo file and add a GIF of it to the README
• add GIFs to prompt engines docs
• add logo