Tests
Downloads
About
Status

Collection of common interactive command line user interfaces, based on Inquirer.js.

Goal and Philosophy

Born as a Inquirer.js clone, it shares part of the goals and philosophy.

So, Inquirer should ease the process of asking end user questions, parsing, validating answers, managing hierarchical prompts and providing error feedback.

You can download the python-inquirer code from GitHub or download the wheel from Pypi.

Platforms support

Python-inquirer supports mainly UNIX-based platforms (eq. Mac OS, Linux, etc.). Windows has experimental support, please let us know if there are any problems!

Installation

pip install inquirer

Documentation

Documentation has been moved to magmax.org/python-inquirer.

But here you have a couple of usage examples:

Text

import re

import inquirer
questions = [
  inquirer.Text('name', message="What's your name"),
  inquirer.Text('surname', message="What's your surname"),
  inquirer.Text('phone', message="What's your phone number",
                validate=lambda _, x: re.match('\+?\d[\d ]+\d', x),
                )
]
answers = inquirer.prompt(questions)

Example of Text Question

Editor

Like a Text question, but used for larger answers. It opens external text editor which is used to collect the answer.

The environment variables $VISUAL and $EDITOR, can be used to specify which editor should be used. If not present inquirer fallbacks to vim -> emacs -> nano in this order based on availability in the system.

External editor handling is done using great library python-editor.

Example:

import inquirer
questions = [
  inquirer.Editor('long_text', message="Provide long text")
]
answers = inquirer.prompt(questions)

List

Shows a list of choices, and allows the selection of one of them.

Example:

import inquirer
questions = [
  inquirer.List('size',
                message="What size do you need?",
                choices=['Jumbo', 'Large', 'Standard', 'Medium', 'Small', 'Micro'],
            ),
]
answers = inquirer.prompt(questions)

List questions can take one extra argument carousel=False. If set to true, the answers will rotate (back to first when pressing down on last choice, and down to last choice when pressing up on first choice)

Example of List Question

Checkbox

Shows a list of choices, with multiple selection.

Example:

import inquirer
questions = [
  inquirer.Checkbox('interests',
                    message="What are you interested in?",
                    choices=['Computers', 'Books', 'Science', 'Nature', 'Fantasy', 'History'],
                    ),
]
answers = inquirer.prompt(questions)

Checkbox questions can take one extra argument carousel=False. If set to true, the answers will rotate (back to first when pressing down on last choice, and down to last choice when pressing up on first choice)

Example of Checkbox Question

Path

Like Text question, but with builtin validations for working with paths.

Example:

import inquirer
questions = [
  inquirer.Path('log_file',
                 message="Where logs should be located?",
                 path_type=inquirer.Path.DIRECTORY,
                ),
]
answers = inquirer.prompt(questions)

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Licensed under the MIT license.

Release files for inquirer 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for inquirer 3.0.0
File	Size	Uploaded
inquirer-3.0.0.tar.gz	15.4 kB	Nov 21, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for inquirer 3.0.0
File	Interpreter	ABI	Platform	Reset
inquirer-3.0.0-py3-none-any.whl 18.0 kB Nov 21, 2022	Python 3	none	any	Details

Total release size: 33.4 kB

Release files / inquirer-3.0.0.tar.gz

Download URL	inquirer-3.0.0.tar.gz
Size	15.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`528725bfd7e18b063727529d2983cfa61e0e512042365a7697d89930588cb686`
BLAKE2b-256 checksum How to use checksums	`38269ad1d6c8007af64989bf45500f00e21014f04a2a6b3413c6166c07cf4e98`
Upload date	Nov 21, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.9.15`

Release files / inquirer-3.0.0-py3-none-any.whl

Download URL	inquirer-3.0.0-py3-none-any.whl
Size	18.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a16c93ded4f9ead42812067f386999aec74d10f131d9a2f7c9e5be131e9f9899`
BLAKE2b-256 checksum How to use checksums	`de1e4bd09303c14fa08cf8be4a2e183b88e60e388b0d59c517e72711bd13d0fe`
Upload date	Nov 21, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.9.15`