This is the Click 8.3.0 feature release. A feature release may include new features, remove previously deprecated code, add new deprecation, or introduce potentially breaking changes.
We encourage everyone to upgrade. You can read more about our Version Support Policy on our website.
PyPI: https://pypi.org/project/click/8.3.0/
Changes: https://click.palletsprojects.com/page/changes/#version-8-3-0
Milestone https://github.com/pallets/click/milestone/27
-
Improved flag option handling: Reworked the relationship between
flag_value
anddefault
parameters for better consistency:- The
default
parameter value is now preserved as-is and passed directly
to CLI functions (no more unexpected transformations) - Exception: flag options with
default=True
maintain backward compatibility
by defaulting to theirflag_value
- The
default
parameter can now be any type (bool
,None
, etc.) - Fixes inconsistencies reported in: #1992 #2514 #2610
#3024 #3030
- The
-
Allow
default
to be set onArgument
fornargs = -1
. #2164
#3030 -
Show correct auto complete value for
nargs
option in combination with flag
option #2813 -
Show correct auto complete value for nargs option in combination with flag option #2813
-
Fix handling of quoted and escaped parameters in Fish autocompletion. #2995 #3013
-
Lazily import
shutil
. #3023 -
Properly forward exception information to resources registered with
click.core.Context.with_resource()
. #2447 #3058 -
Fix regression related to EOF handling in CliRunner. #2939 #2940