Skip to content

Add help parameter to arguments#3473

Open
yurishevtsov wants to merge 1 commit into
pallets:mainfrom
yurishevtsov:add-help-kwarg-to-arg-params
Open

Add help parameter to arguments#3473
yurishevtsov wants to merge 1 commit into
pallets:mainfrom
yurishevtsov:add-help-kwarg-to-arg-params

Conversation

@yurishevtsov
Copy link
Copy Markdown

@yurishevtsov yurishevtsov commented May 19, 2026

Adds a help parameter to click.argument() and an Arguments section on --help when argument help is set. Commands without argument help are unchanged.

Implementation follows options: Argument.get_help_record() returns the metavar and help text for the help formatter (the base Parameter class returns None, so arguments never appeared in help tables before).

Argument.to_info_dict() now includes help, matching Option, so parameter metadata stays consistent for doc tools; this is not required for CLI help output.

Deprecated arguments without explicit help show a deprecation-only row in Arguments, matching deprecated options.

fixes #2983

@yurishevtsov yurishevtsov force-pushed the add-help-kwarg-to-arg-params branch 2 times, most recently from 79729a1 to f277ddf Compare May 19, 2026 01:47
@yurishevtsov yurishevtsov force-pushed the add-help-kwarg-to-arg-params branch from f277ddf to 73e3c13 Compare May 19, 2026 01:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add help kwarg to argument parameter

1 participant