enquiries 0.2.0

Multiple choice

All choices consist of letting users pick one of several items. For enquiries these can be in any iterable.

Users can pick one or many of the options offered to them.

>>> options = ['Thing 1', 'Thing 2']
>>> response = enquiries.choose('Pick a thing', options)
# interactive prompt
>>> print('You chose "{}"'.format(response))
You chose "Thing 1"
>>>

Pick a thing
> Thing 1
  Thing 2
  Thing 3

>>> options = ['Thing 1', 'Thing 2', 'Thing 3']
>>> response = enquiries.choose('Pick some things', options, multi=True)
# interactive prompt
>>> print('You chose "{}"'.format(response))
You chose "['Thing1', 'Thing 3']"
>>>

pick a thing
◉ Thing 1
◌ Thing 2
◌ Thing 3

Yes/No Confirmation

Used to get a simple boolean response from users.

>>> if enquiries.confirm('Do you really want to do the thing')
...     print('Carrying on')
... else:
...     print('Exiting')
...
# interactive prompt
Carrying on
>>>

Results in the prompt below:

Do you really want to do the thing? [y/N]

The prompt for confirmation by default accepts y/n keys to choose and return to accept the choice. Return without choosing accepts the default value (usually False). The keys used and the default can be changed as required. By default, the user should choose y/n then hit return but single_key mode can be used to remove the need to hit return.

Freetext

enquiries free text offering is offers a slightly enhanced version of the input builtin function. It adds multi line support as well as basic readline like controls (Ctrl-a, Ctrl-w etc). The text entry area is also cleared after the text is accepted keeping terminal history clean.

>>> text = enquiries.freetext('Write some stuff')
>>> print(text)
This is the text you entered
on many lines
>>>

New lines in text can be entered using Alt-Return.