v8.7.0
- Add a
<!-- mirror-src -->comment form ofpython:render:mirror:: the generator Python lives inside an HTML comment, so its output renders on GitHub and PyPI while the generator stays invisible. - Export
update_blocks,marker_res, and a newreplace_regionhelper fromclick_extra.sphinxfor downstream self-updating documentation scripts. - Accept kebab-case keys in configuration files:
dummy-flaganddummy_flagboth address the--dummy-flagoption, the last spelling winning on collision with a warning. - Scope the configuration strict check and merge to the app's own section, ignoring other tools' sections in shared files like
pyproject.toml. - Honor legacy
fallback_sectionswhen merging configuration values intodefault_map, not only in the schema path. - Forward
config_strictand additiveexcluded_paramsfrom@command/@groupto the default--configoption. - Load the configuration file before
--paramsand--export-configrender, so both reflect it whatever the order of the flags. - Export parameters without a value in
--export-config: empty lists for multi-value options,nullin YAML and JSON, commented-out keys in TOML. - Render
--export-configkeys in kebab-case, the canonical spelling for configuration files, matching the CLI flags. - Exclude
--validate-configfrom configuration files, like the other self-referential config options. - Reword the unknown-configuration-key error, and report parameters blocked from configuration files as not allowed instead of unknown.
- Fix
DO_NOT_TRACKhandling: a truthy value now forces--telemetryoff; it previously fed the boolean flag verbatim and enabled telemetry. - Add an executables download table and a release-verification section to the installation guide.
- Render the demo CLI help screen live in the installation guide, replacing captured output stuck on
7.2.0. - Add a CLI reference page rendering the command tree and the
[tool.click-extra]configuration schema live. - Add cross-reference render tests asserting anchors and intersphinx links in the built documentation.
Full changelog: v8.6.3...v8.7.0