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 and default 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 their flag_value
  • The default parameter can now be any type (bool, None, etc.)
  • Fixes inconsistencies reported in: #1992 #2514 #2610 #3024 #3030
  • Allow default to be set on Argument for nargs = -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]