Приглашения для ввода данных пользователя

Click поддерживает приглашения в двух разных местах. Первое — автоматические приглашения при обработке параметров, а второе — запросы приглашений впоследствии независимо.

Это можно сделать с помощью функции prompt(), которая запрашивает допустимый ввод в соответствии с типом, или функции confirm(), которая запрашивает подтверждение (да/нет).

Приглашения к выбору

Приглашения к выбору интегрированы в интерфейс выбора. Подробнее см. Запрос. Внутренне она автоматически вызывает либо prompt(), либо confirm() по мере необходимости.

Приглашения для ввода

Чтобы вручную запросить ввод от пользователя, можно использовать функцию prompt(). По умолчанию она принимает любую строку Unicode, но вы можете запросить любой другой тип. Например, вы можете запросить целое число:

value = click.prompt('Please enter a valid integer', type=int)

Кроме того, тип будет определяться автоматически, если предоставлено значение по умолчанию. Например, следующее примет только числа с плавающей точкой:

value = click.prompt('Please enter a number', default=42.0)

Приглашения для подтверждения

Чтобы спросить, хочет ли пользователь продолжить действие, пригодится функция confirm(). По умолчанию она возвращает результат запроса в виде булевого значения:

if click.confirm('Do you want to continue?'):
    click.echo('Well done!')

Также есть возможность заставить функцию автоматически прервать выполнение программы, если она не вернёт True:

click.confirm('Do you want to continue?', abort=True)