inquirer

VERSION	DOWNLOADS	TESTS	COVERAGE

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.

Documentation

Installation

pip install inquirer

Usage example:

import inquirer

questions = [
  inquirer.Text    ('name',     message="What's your name"),
  inquirer.Password('password', message="Add a password"),
  inquirer.Confirm ('correct',  message="Is correct"),
]

answers = inquirer.prompt(questions)

Examples

The examples/ directory contains several examples. Feel free to run them:

python examples/text.py

Objects

The main object is Question, but it should not be instantiated. You must use any of the subclasses, listed below. All of them have the next attributes that can be set in the initialization:

Attribute	Type	Explanation
name	String	The key in the hash of answers.
message	String	To be shown in the prompt to the user
default	Any\|Function	Default value. Functions will receive the hash with previous values.
choices	List\|Function	List of available options. Functions will receive the hash with previous values.
validate	Bool\|Function	If the value set is valid. Functions will receive the hash with previous values and the value set in this question, and should return a boolean.
ignore	Bool\|Function	If the quiestion should be shown. Functions will receive the hash with previous values and should return a boolean.

Prompt types

Text

choices argument is not used.

Example:

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+', x),
                )
]
answers = inquirer.prompt(questions)

Example of Text Question

Password

choices argument is not used.

Example:

import inquirer
questions = [
  inquirer.Password('password', message="What's your password"),
]
answers = inquirer.prompt(questions)

Confirm

choices argument is not used.

Example:

import inquirer
questions = [
  inquirer.Confirm('continue', message="Should I continue"),
  inquirer.Confirm('stop', message="Should I stop", default=True),
]
answers = inquirer.prompt(questions)

Example of Confirm Question

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)

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)

Example of Checkbox Question

Advanced usage

Some tips:

Reusing previous answers

Every String argument but name can use any previous answer just putting it in roots:

import inquirer
questions = [
  inquirer.Text('name', message="What's your name?"),
  inquirer.Text('surname', message="{name}, what's your surname?"),
  inquirer.Text('alias', message="What's your Alias"
    default="{name}"),
]
answers = inquirer.prompt(questions)

License

Licensed under the MIT license.

Release files for inquirer 0.6

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 0.6
File	Size	Uploaded
inquirer-0.6.tar.gz	12.2 kB	May 16, 2014	Details

Release files / inquirer-0.6.tar.gz

Download URL	inquirer-0.6.tar.gz
Size	12.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`0bc4501affa9940691486356620d3e2e8700b2c289f0f4657eaf83d1704f8ba8`
BLAKE2b-256 checksum How to use checksums	`2960d10eaebc3f41aae959a117b8814b7981e04f0332702a2e06b3a183143ba1`
Upload date	May 16, 2014
Uploaded using Trusted Publishing? What is trusted publishing?	No