Sphinx: copyright substitution and reproducibility

James Addison jay at jp-hosting.net
Mon Jul 15 01:20:44 UTC 2024


On Tue, 9 Jul 2024 at 13:14, I <jay at jp-hosting.net> wrote:
> [ ... snip ... ]
> These are up for debate and discussion, and I've opened a pair of pull
> requests in Sphinx that work towards these.

I forgot to add hyperlinks to these pull requests; they are:

  * [config] Add further preconditions before copyright notice year
substitution occurs.
    https://github.com/sphinx-doc/sphinx/pull/12516
  * [config] skip copyright substitution for copyright notices
declared as constant values.
    https://github.com/sphinx-doc/sphinx/pull/12519

(please consider their titles and contents subject to change)

In addition, since my message I've learned of the existence of PEP-675, a
Python Enhancement Proposal that adds a LiteralString type hint that could be
used by type-checking tools from Python 3.11 onwards to detect usage of
non-literal (non-constant) strings in interfaces that don't expect them.  It
could be a useful building-block somewhere in this problem space.

Ref: https://peps.python.org/pep-0675/

Regards,
James


More information about the rb-general mailing list