Skip to content

v7.19.0

Choose a tag to compare

@kdeldycke kdeldycke released this 12 Jun 11:28
Immutable release. Only release title and notes can be modified.
  • Add an --output-dir DIR option to the click-extra man subcommand. With it set, the command writes one .1 file per (sub)command in the resolved tree into DIR (created if missing) instead of printing a single page to stdout. Suitable for invocation from a release pipeline or a distributor's build phase (Debian's override_dh_installman, Guix' install-man-page), without a project-local wrapper script.
  • Add a click_extra_manpages Sphinx configuration value (and the matching click_extra.sphinx.manpages module) and a click-extra-manpages directive. Projects enabling click_extra.sphinx can declare one or more {"script", "prog_name", "output_dir", "render_html"} entries to emit the corresponding Click command tree(s) as roff .1 files into <outdir>/<output_dir>/ on every HTML build. Each script is resolved the same way click-extra man does (console-script entry point, module:function, .py path, or module name); only HTML-family builders trigger the hook. When mandoc or groff is on PATH, every .1 also gets a browser-viewable .html sibling. The click-extra-manpages directive renders a relative-URL bullet list of all declared pages; it works at any depth in the doc tree.
  • Fix ExtraVersionOption.package_version resolving to None when the package's top-level module name differs from its installed distribution name (PIL vs Pillow, jwt vs PyJWT). The lookup now falls back to importlib.metadata.packages_distributions() on PackageNotFoundError. Ambiguous mappings (one import name to several distributions) still return None and log a debug message; pass package_name explicitly to disambiguate. Mirrors the upstream fix in PR pallets/click#3582.

Full changelog: v7.18.0...v7.19.0


🛡️ VirusTotal scans

Binary Detections Analysis
click-extra-7.19.0-linux-arm64.bin 0 / 62 View scan
click-extra-7.19.0-linux-x64.bin 0 / 60 View scan
click-extra-7.19.0-macos-arm64.bin 0 / 46 View scan
click-extra-7.19.0-macos-x64.bin 0 / 60 View scan
click-extra-7.19.0-windows-arm64.exe 3 / 68 View scan
click-extra-7.19.0-windows-x64.exe 23 / 71 View scan