Sourced from click's releases.
\n\n\n8.1.0
\nThis is a feature release, which includes new features and removes previously deprecated features. The 8.1.x branch is now the supported bugfix branch, the 8.0.x branch will become a tag marking the end of support for that branch. We encourage everyone to upgrade, and to use a tool such as pip-tools to pin all dependencies and control upgrades.
\n\n
Sourced from click's changelog.
\n\n\nVersion 8.1.0
\nReleased 2022-03-28
\n\n
\n\n- \n
\nDrop support for Python 3.6. :pr:
\n2129
- \n
\nRemove previously deprecated code. :pr:
\n2130
\n
\n- \n
Group.resultcallback
is renamed toresult_callback
.- \n
autocompletion
parameter toCommand
is renamed to\nshell_complete
.- \n
get_terminal_size
is removed, use\nshutil.get_terminal_size
instead.- \n
get_os_args
is removed, usesys.argv[1:]
instead.- \n
\nRely on :pep:
\n538
and :pep:540
to handle selecting UTF-8 encoding\ninstead of ASCII. Click's locale encoding detection is removed.\n:issue:2198
- \n
\nSingle options boolean flags with
\nshow_default=True
only show\nthe default if it isTrue
. :issue:1971
- \n
\nThe
\ncommand
andgroup
decorators can be applied with or\nwithout parentheses. :issue:1359
- \n
\nThe
\nPath
type can check whether the target is executable.\n:issue:1961
- \n
\n\n
Command.show_default
overridesContext.show_default
, instead\nof the other way around. :issue:1963
- \n
\nParameter decorators and
\n@group
handlescls=None
the same as\nnot passingcls
.@option
handleshelp=None
the same as\nnot passinghelp
. :issue:[#1959](https://github.com/pallets/click/issues/1959)
- \n
\nA flag option with
\nrequired=True
requires that the flag is\npassed instead of choosing the implicit default value. :issue:1978
- \n
\nIndentation in help text passed to
\nOption
andCommand
is\ncleaned the same as using the@option
and@command
\ndecorators does. A command'sepilog
andshort_help
are also\nprocessed. :issue:1985
- \n
\nStore unprocessed
\nCommand.help
,epilog
andshort_help
\nstrings. Processing is only done when formatting help text for\noutput. :issue:2149
- \n
\nAllow empty str input for
\nprompt()
when\nconfirmation_prompt=True
anddefault=""
. :issue:2157
- \n
\nWindows glob pattern expansion doesn't fail if a value is an invalid\npattern. :issue:
\n2195
- \n
\nIt's possible to pass a list of
\nparams
to@command
. Any\nparams defined with decorators are appended to the passed params.\n:issue:2131
.- \n
\n\n
@command
decorator is annotated as returning the correct type if\nacls
argument is used. :issue:2211
- \n
\nA
\nGroup
withinvoke_without_command=True
andchain=False
\nwill invoke its result callback with the group function's return\nvalue. :issue:2124
... (truncated)
\ne4aceee
Merge pull request #2224 from pallets/release-8.1.0f8d811e
release version 8.1.020c88f0
Merge pull request #2223 from pallets/env-var8d7f03d
treat empty auto_envvar as Noneef11be6
Merge pull request #2041 from spanglerco/shell-completion-option-valuesf2e579a
shell completion prioritizes option values over new optionsd251cb0
Merge pull request #2219 from pallets/paramtype-namee003331
fix ParamType.to_info_dict() with no name19be092
Merge pull request #2217 from pallets/group-return7d3a871
group without command passes return value to result callback