bchao1/bullet

Bullet is a Python library for building interactive prompts in command-line tools. Instead of a plain text input box, you can present users with a scrollable list to pick one option, a set of checkboxes to pick multiple options, a password field that hides typed characters, a yes/no toggle, or a number input, all styled with colors and custom visual themes. The library lets you stack multiple prompts together in a sequence, so you can ask a series of questions one after another in a single flow. Each prompt type is a Python class, and you compose them by creating instances and combining them into a list. When you launch the prompts, the user navigates with arrow keys and confirms with Enter, and the answers come back as a Python dictionary you can use in the rest of your script. Styling is handled through built-in style presets with names like Ocean, Lime, Christmas, and Greece, each setting a color palette for the prompt background and selected item highlighting. You can also define custom styles with any terminal colors you want, and the library supports emoji characters in prompt text. Installation is a single pip command. The library is available on PyPI and requires Python 3.6 or newer. Currently it only supports Linux, and Windows support is listed as a planned future addition. The repository includes a documentation file and a folder of example scripts covering each prompt type. Supported prompt types include bullet-point single selection, checkbox multi-selection, free text input, number input, password input, yes/no questions, and a scrollbar for long lists.