click-contrib / sphinx-click

A Sphinx plugin to automatically document click-based applications
MIT License
212 stars 57 forks source link

Support typer arguments #134

Closed aeisenbarth closed 3 months ago

aeisenbarth commented 3 months ago

Summary

This is a proposal for consistency of the help attribute in options and arguments. Options can have help text, but arguments (currently) not. While click does not provide the help attribute for arguments, it allows subclasses to add it (and provide the custom subclass to @click.argument(…, cls=…)).

With a tiny change this greatly improves support for the popular typer package.

If the help attribute is detected on an argument, it is interpreted just like for options. Otherwise the behavior is as before.

Tasks

Further details

Solves #132

stephenfin commented 3 months ago

Thanks :pray: