Skip to content

This is a fork of magmax/python-inquirer. This one is hopefully more responsive (Issues/PRs/...).

License

Notifications You must be signed in to change notification settings

guysalt/python-inquirer3

Repository files navigation

PyPI Downloads Read the documentation at https://python-inquirer3.readthedocs.io/

Tests Codecov Python Version License Black

python-inquirer3

This is a fork of magmax/python-inquirer. This one is hopefully more responsive (Issues/PRs/...).

Collection of common interactive command line user interfaces, based on magmax/python-inquirer.

Goal and Philosophy

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

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

Install the last released version using pip:

pip install inquirer3

Also, you can download the python-inquirer code from GitHub or download the wheel from Pypi.

Documentation

Text

import re

import inquirer3

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

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 inquirer3

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

List

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

Example:

import inquirer3

questions = [
    inquirer3.List('size',
                   message="What size do you need?",
                   choices=['Jumbo', 'Large', 'Standard', 'Medium', 'Small', 'Micro'],
                   ),
]
answers = inquirer3.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)

Checkbox

Shows a list of choices, with multiple selection.

Example:

import inquirer3

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

Checkbox questions can take 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)

Another argument that can be used is locked=<List>. The given choices in the locked argument cannot be removed. This is useful if you want to make clear that a specific option out of the choices must be chosen.

Path

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

Example:

import inquirer3

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

Contributing

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

License

Copyright (c) 2014-2023 Miguel Ángel García

Distributed under the terms of the MIT license.