v7.19.0
- Add an
--output-dir DIRoption to theclick-extra mansubcommand. With it set, the command writes one.1file per (sub)command in the resolved tree intoDIR(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'soverride_dh_installman, Guix'install-man-page), without a project-local wrapper script. - Add a
click_extra_manpagesSphinx configuration value (and the matchingclick_extra.sphinx.manpagesmodule) and aclick-extra-manpagesdirective. Projects enablingclick_extra.sphinxcan declare one or more{"script", "prog_name", "output_dir", "render_html"}entries to emit the corresponding Click command tree(s) as roff.1files into<outdir>/<output_dir>/on every HTML build. Eachscriptis resolved the same wayclick-extra mandoes (console-script entry point,module:function,.pypath, or module name); only HTML-family builders trigger the hook. Whenmandocorgroffis onPATH, every.1also gets a browser-viewable.htmlsibling. Theclick-extra-manpagesdirective renders a relative-URL bullet list of all declared pages; it works at any depth in the doc tree. - Fix
ExtraVersionOption.package_versionresolving toNonewhen the package's top-level module name differs from its installed distribution name (PILvsPillow,jwtvsPyJWT). The lookup now falls back toimportlib.metadata.packages_distributions()onPackageNotFoundError. Ambiguous mappings (one import name to several distributions) still returnNoneand log a debug message; passpackage_nameexplicitly 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 |