Sourced from click's releases.

8.2.0

This is the Click 8.2.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.2.0/ Changes: https://click.palletsprojects.com/en/stable/changes/ Milestone https://github.com/pallets/click/milestone/15

• Drop support for Python 3.7. #2588, #2893
• Use modern packaging metadata with pyproject.toml instead of setup.cfg. #2438
• Use flit_core instead of setuptools as build backend. #2543
• Deprecate the __version__ attribute. Use feature detection, or importlib.metadata.version("click"), instead. #2598
• BaseCommand is deprecated. Command is the base class for all commands. #2589
• MultiCommand is deprecated. Group is the base class for all group commands. #2590
• The current parser and related classes and methods, are deprecated. #2205
  • OptionParser and the parser module, which is a modified copy of optparse in the standard library.
  • Context.protected_args is unneeded. Context.args contains any remaining arguments while parsing.
  • Parameter.add_to_parser (on both Argument and Option) is unneeded. Parsing works directly without building a separate parser.
  • split_arg_string is moved from parser to shell_completion.
• Enable deferred evaluation of annotations with from __future__ import annotations. #2270
• When generating a command's name from a decorated function's name, the suffixes _command, _cmd, _group, and _grp are removed. #2322
• Show the types.ParamType.name for types.Choice options within --help message if show_choices=False is specified. #2356
• Do not display default values in prompts when Option.show_default is False. #2509
• Add get_help_extra method on Option to fetch the generated extra items used in get_help_record to render help text. #2516 #2517
• Keep stdout and stderr streams independent in CliRunner. Always collect stderr output and never raise an exception. Add a new output stream to simulate what the user sees in its terminal. Removes the mix_stderr parameter in CliRunner. #2522 #2523
• Option.show_envvar now also shows environment variable in error messages. #2695 #2696
• Context.close will be called on exit. This results in all Context.call_on_close callbacks and context managers added via Context.with_resource to be closed on exit as well. #2680
• Add ProgressBar(hidden: bool) to allow hiding the progressbar. #2609
• A UserWarning will be shown when multiple parameters attempt to use the same name. #2396
• When using Option.envvar with Option.flag_value, the flag_value will always be used instead of the value of the environment variable. #2746 #2788
• Add Choice.get_invalid_choice_message method for customizing the invalid choice message. #2621 #2622
• If help is shown because no_args_is_help is enabled (defaults to True for groups, False for commands), the exit code is 2 instead of 0. #1489 #1489
• Contexts created during shell completion are closed properly, fixing a ResourceWarning when using click.File. #2644 #2800 #2767
• click.edit(filename) now supports passing an iterable of filenames in case the editor supports editing multiple files at once. Its return type is now also typed: AnyStr if text is passed, otherwise None. #2067 #2068
• Specialized typing of progressbar(length=...) as ProgressBar[int]. #2630
• Improve echo_via_pager behaviour in face of errors. #2674
  • Terminate the pager in case a generator passed to echo_via_pager raises an exception.
  • Ensure to always close the pipe to the pager process and wait for it to terminate.
  • echo_via_pager will not ignore KeyboardInterrupt anymore. This allows the user to search for future output of the generator when using less and then aborting the program using ctrl-c.
• deprecated: bool | str can now be used on options and arguments. This previously was only available for Command. The message can now also be customised by using a str instead of a bool. #2263 #2271
  • Command.deprecated formatting in --help changed from (Deprecated) help to help (DEPRECATED).
  • Parameters cannot be required nor prompted or an error is raised.
  • A warning will be printed when something deprecated is used.
• Add a catch_exceptions parameter to CliRunner. If catch_exceptions is not passed to CliRunner.invoke, the value from CliRunner is used. #2817 #2818
• Option.flag_value will no longer have a default value set based on Option.default if Option.is_flag is False. This results in Option.default not needing to implement __bool__. #2829
• Incorrect click.edit typing has been corrected. #2804

... (truncated)

Sourced from click's changelog.

Version 8.2.0

Released 2025-05-10

• Drop support for Python 3.7, 3.8, and 3.9. :pr:2588 :pr:2893

• Use modern packaging metadata with pyproject.toml instead of setup.cfg. :pr:2438

• Use flit_core instead of setuptools as build backend. :pr:2543

• Deprecate the __version__ attribute. Use feature detection, or importlib.metadata.version("click"), instead. :issue:2598

• BaseCommand is deprecated. Command is the base class for all commands. :issue:2589

• MultiCommand is deprecated. Group is the base class for all group commands. :issue:2590

• The current parser and related classes and methods, are deprecated. :issue:2205

  • OptionParser and the parser module, which is a modified copy of optparse in the standard library.
  • Context.protected_args is unneeded. Context.args contains any remaining arguments while parsing.
  • Parameter.add_to_parser (on both Argument and Option) is unneeded. Parsing works directly without building a separate parser.
  • split_arg_string is moved from parser to shell_completion.

• Enable deferred evaluation of annotations with from __future__ import annotations. :pr:2270

• When generating a command's name from a decorated function's name, the suffixes _command, _cmd, _group, and _grp are removed. :issue:2322

• Show the types.ParamType.name for types.Choice options within --help message if show_choices=False is specified. :issue:2356

• Do not display default values in prompts when Option.show_default is False. :pr:2509

• Add get_help_extra method on Option to fetch the generated extra items used in get_help_record to render help text. :issue:2516 :pr:2517

• Keep stdout and stderr streams independent in CliRunner. Always collect stderr output and never raise an exception. Add a new output stream to simulate what the user sees in its terminal. Removes the mix_stderr parameter in CliRunner. :issue:2522 :pr:2523

• Option.show_envvar now also shows environment variable in error messages. :issue:2695 :pr:2696

• Context.close will be called on exit. This results in all Context.call_on_close callbacks and context managers added via Context.with_resource to be closed on exit as well. :pr:2680

• Add ProgressBar(hidden: bool) to allow hiding the progressbar. :issue:2609

• A UserWarning will be shown when multiple parameters attempt to use the

... (truncated)

• 219206a release version 8.2.0
• 498f882 drop end of life python versions (#2893)
• ba770cb drop end of life python versions
• f14b750 update dev dependencies
• 9982fae Update CHANGES.rst
• 7318f5f Update CHANGES.rst
• b7c0ab4 Merge stable into main; Release 8.2.0 (#2873)
• c9b96fe Merge branch 'main' into main
• ab21233 Rewrite second half of options docs (#2848)
• 8c89a14 Merge branch 'main' into options_docs_2
• Additional commits viewable in compare view

Sourced from setuptools's changelog.

v80.4.0

Features

• Simplified the error reporting in editable installs. (#4984)

• a82f96d Bump version: 80.3.1 → 80.4.0
• aa4bdf8 Merge pull request #4985 from pypa/feature/user-focused-editable-installs
• af2f2ba Add news fragment.
• bcc23a2 Implement the editable debugging tips as a reference to the docs.
• aa911c6 By default, provide a much more concise error message.
• See full diff in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore <dependency name> major version will close this group update PR and stop Dependabot creating any more for the specific dependency's major version (unless you unignore this specific dependency's major version or upgrade to it yourself)
• @dependabot ignore <dependency name> minor version will close this group update PR and stop Dependabot creating any more for the specific dependency's minor version (unless you unignore this specific dependency's minor version or upgrade to it yourself)
• @dependabot ignore <dependency name> will close this group update PR and stop Dependabot creating any more for the specific dependency (unless you unignore this specific dependency or upgrade to it yourself)
• @dependabot unignore <dependency name> will remove all of the ignore conditions of the specified dependency
• @dependabot unignore <dependency name> <ignore condition> will remove the ignore condition of the specified dependency and ignore conditions