Python library for quick CLI user prompts, input, and menus.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
examples
lib
tests
.gitignore
.travis.yml
AUTHORS.adoc
CHANGELOG.adoc
LICENSE
README.adoc
_Build.py
_Check_Dependencies.bat
_Check_Versions.py

README.adoc

Qprompt

License Build Status

Library for quick CLI user prompts, input, and menus.

Introduction

This project provides a Python 2.7/3.3+ library that allows the user to quickly create CLI prompts for user input. The main features of Qprompt are:

  • Simple multi-entry menus.

  • Prompt for typed (integer/float/string) input.

  • Optional default values and validity checks.

  • Various CLI convenience functions.

  • User input can optionally be supplied from script command-line arguments allowing for simple automation.

  • Should work on any platform without additional dependencies.

Demo

Status

Currently, this project is in the development release stage. While this project is suitable for use, please note that there may be incompatibilities in new releases.

Release notes are maintained in the project changelog.

Requirements

Qprompt should run on any Python 2.7/3.3+ interpreter and uses some third-party libraries.

Installation

Qprompt is available on PyPI here and can be installed with pip using the following command: pip install qprompt

Additionally, Qprompt can be installed from source by running: python setup.py install

Documentation

The full documentation for this project can be found here on Read the Docs.

Roadmap

The following potential updates are under consideration:

  • Accept multiple menu choices from user at once; e.g. space separated entries like 1 2 q.

  • Timeouts for prompt inputs; default value used if timed out.

Contributing

Contributions or feedback is welcome and encouraged!

A list of those who have helped with this project is available in the authors file.

Similar

The following projects are similar and may be worth checking out: