Notable changes are documented in this file.
New Documentation: inquirerpy.readthedocs.io
Added optional spinner to display while loading choices for list prompts.- Added parameter
border
for list prompts to display a border around the choices. - Added parameter
long_instruction
to display longer instructions such as keybinding instructions at the bottom #7. - Added parameter
expand_help
forexpand
prompt to customise the help message and expansion key.help_msg
parameter is deprecated and should useexpand_help
.
- Added alternate way of creating choices. Introduced a new class
Choice
as an alternate option for dictionary choice.- Added
ExpandChoice
forexpand
prompt as well,
- Added
- Added
raise_keyboard_interrupt
option to all prompt initialisation options.- The
raise_keyboard_interrupt
in execute function will be deprecated in future releases.
- The
- Added parameter
mandatory
andmandatory_message
to indicate if a prompt can be skipped. - Added ability to skip prompt #10
- Fixed fuzzy prompt cannot type space #20.
- Fixed multiselect malfunction #25
- Fixed fuzzy prompt toggle_all #14
- Changed fuzzy prompt
border
default toFalse
.- It was
True
by default, changing this to keep it consistent with other prompts.
- It was
- Changed style
fuzzy_info
andinstruction
default color to#abb2bf
. - Automatic spacing added for checkbox prompt, if you have customised the prompt using
enabled_symbol
anddisabled_symbol
, you may need to remove the extra space you have previously added. The change here is to align with other prompts current behavior. - Checkbox prompt default value for
enabled_symbol
anddisabled_symbol
is changed from hex symbol to circle #22. - Behavior of
raise_keyboard_interrupt
is changed. Checkout the documentation for more info.
- Fixed fuzzy prompt choices are centered.
- Added option
wrap_lines
to all prompts to configure line wrapping. - Added option
instruction
for non-list type prompts. This is already supported in all list type prompts previously. - Added option
confirm_letter
andreject_letter
to confirm prompts. Use the 2 value to change from the default "y/n".- For updating the result value, please use the
transformer
parameter. By default, no matter what confirm_letter or reject letter you set, it will always be Yes or No.
- For updating the result value, please use the
from InquirerPy import inquirer
inquirer.confirm(
message="Proceed?",
default=True,
confirm_letter="s",
reject_letter="n",
transformer=lambda result: "SIm" if result else "Não",
).execute()
- Line wrapping #11.
- Answered question prefix spacing now depends on
amark
parameter instead ofqmark
.- If you previously disable the
qmark
by setting it to empty string, please also setamark
to empty string.
- If you previously disable the
N/A
- Added option to disable cycle behavior in list type prompts #9.
- Added parameter
amark
. You can use this value to change theqmark
after the question is answered. - Added some more style customisation option.
answermark
: Used to change the color and style ofamark
.answered_question
: Used to change the color and style ofquestion
message once the question is answered.
- Defaults for multi-select list #2.
- Disable qmark #3.
- Configure
marker_pl
.- This value exists in all list type prompts which by default is an empty space. This space is replaced when the choice is selected in multiselect scenario.
- Spacing in
checkbox
promptenabled_symbol
anddisabled_symbol
.- If you have customised these values, add an empty space at the end.
- Spacing in
expand
promptseparator
.- If you have customised these values, add an empty space at the end.
- Spacing in
rawlist
promptseparator
.- If you have customised these values, add an empty space at the end.
# v0.1.1
regions = inquirer.checkbox(
message="Select regions:",
choices=["us-east-1", "us-east-2"],
enabled_symbol=">",
disabled_symbol="<"
).execute()
# v0.2.0
regions = inquirer.checkbox(
message="Select regions:",
choices=["us-east-1", "us-east-2"],
enabled_symbol="> ", # add a space
disabled_symbol="< " # add a space
).execute()
- Height and visual glitch on smaller data sets for fuzzy prompt.