certbot/tools
Adrien Ferrand b0552e1939
Fix Sphinx builds (#8838)
Since Saturday the CI pipeline is failing due to several Sphinx errors. See https://dev.azure.com/certbot/certbot/_build/results?buildId=3928&view=logs&j=d74e04fe-9740-597d-e9fa-1d0400037dfd&t=dde413a4-f24c-59a0-9684-e33d79f9aa02

First, the build of certbot-dns-google is failing because of a particular configuration. It seems that this configuration has been written here to activate the support of the RST instruction `.. code-block:: json` in documentation. However, it does not seem to be necessary for a similar situation in certbot-dns-route53 documentation. So let's try to remove it and fix the Sphinx builds.

Second, Sphinx builds were not pinning dependencies, so Sphinx 4.x (that has been released yesterday) started to be used in the pipeline. Sadly this new version is not compatible with the plugin `repoze.sphinx.autointerface`, used to extract documentation from `zope.interface`. So I fixed the pinning and also explicitly pin Sphinx to 3.5.x for now.

Technically speaking the second action is sufficient to fix the first error, but I keep the dedicated solution because it improves the documentation in my opinion.

This situation could be fixed by not requiring `repoze.sphinx.autointerface`, but this is possible only if we remove `zope.interface` from Certbot. Luckily I started the work few days ago ;).

* Remove explicit lexer call in certbot-dns-google doc builds.

* Write a valid JSON file in the documentation

* Apply constraints to sphinx build environments

* Pin Sphinx to 3.5.4

* Update dependencies

* Pin traitlets
2021-05-10 12:11:31 -07:00
..
docker remove outdated comment (#8736) 2021-03-25 08:00:47 +11:00
pinning Fix Sphinx builds (#8838) 2021-05-10 12:11:31 -07:00
snap Improve tools/snap/build_remote.py output (#8780) 2021-04-07 14:52:15 -07:00
_changelog_top.txt Remove list of modified packages from changelog. (#7146) 2019-06-11 14:02:54 -07:00
_release.sh Make a test farm tests package (#8821) 2021-05-03 17:42:30 -07:00
deactivate.py Minor bugfixes (#7891) 2020-04-13 10:41:39 -07:00
dev_constraints.txt Upgrade to mypy 0.812 (#8748) 2021-04-02 11:54:40 -07:00
extract_changelog.py Insert new line before "More details about these changes can be found on our GitHub repo." (#8645) 2021-02-25 16:30:48 -08:00
finish_release.py Add finish_release flags and CLI parsing (#8522) 2020-12-10 15:13:48 -08:00
half-sign.c Use SHA256 openssl signatures 2016-01-11 14:22:51 -08:00
install_and_test.py Removed Python legacy __future__ imports (#8697) 2021-03-05 16:53:20 -08:00
merge_requirements.py Removed Python legacy __future__ imports (#8697) 2021-03-05 16:53:20 -08:00
oldest_constraints.txt Remove requests[security] dependency (#8626) 2021-02-05 15:33:45 -08:00
pip_install.py Redo the majority of Certbot's pinning system (#8741) 2021-03-26 07:51:59 +01:00
pip_install_editable.py Remove references to certbot-auto and letsencrypt-auto that we don't need for the final release (#8738) 2021-03-24 16:58:15 -07:00
pipstrap.py Deprecate acme.typing_magic module, stop using it in certbot (#8643) 2021-03-09 16:12:32 -08:00
pipstrap_constraints.txt Fix linux-py39-cover test (#8720) 2021-03-19 14:27:29 -07:00
readlink.py Removed Python legacy __future__ imports (#8697) 2021-03-05 16:53:20 -08:00
release.sh Release script improvements (#6337) 2018-09-05 14:10:05 -07:00
requirements.txt Fix Sphinx builds (#8838) 2021-05-10 12:11:31 -07:00
retry.sh Automatically retry test farm tests (#8325) 2020-09-30 17:05:52 -07:00
simple_http_server.py Some improvements (#8132) 2020-07-06 16:04:59 -07:00
sphinx-quickstart.sh Convert http links to https (#8287) 2020-09-23 19:36:55 +02:00
strip_hashes.py Address review comments 2019-03-04 15:52:38 +02:00
venv.py Make a test farm tests package (#8821) 2021-05-03 17:42:30 -07:00