Pin Jinja2 to fix docs build

[hugovk]

BPO	47138
Nosy	@ned-deily, @ambv, @zooba, @hugovk, @miss-islington, @m-aciek
PRs	[3.7] bpo-47138: Fix documentation build by pinning Jinja version to 3.0.3 #32111 [3.8] bpo-47138: Fix documentation build by pinning Jinja version to 3.0.3 #32109 [3.9] bpo-47138: Fix documentation build by pinning Jinja version to 3.0.3 #32153 [3.10] bpo-47138: Fix documentation build by pinning Jinja version to 3.0.3 #32154 bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms #32161 [3.10] bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms (GH-32161) #32163 [3.8] bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms (GH-32161) #32167 [3.7] bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms (GH-32161) #32168 [3.9] bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms (GH-32161) #32169 [3.7] bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms #32182 [3.8] bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms (GH-32161) #32183

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2022-03-28.08:17:25.467>
labels = ['3.7', '3.8', '3.9', '3.10', 'docs']
title = 'Pin Jinja2 to fix docs build'
updated_at = <Date 2022-04-08.13:06:24.310>
user = 'https://github.com/hugovk'

bugs.python.org fields:

activity = <Date 2022-04-08.13:06:24.310>
actor = 'lukasz.langa'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2022-03-28.08:17:25.467>
creator = 'hugovk'
dependencies = []
files = []
hgrepos = []
issue_num = 47138
keywords = ['patch']
message_count = 14.0
messages = ['416149', '416151', '416158', '416167', '416171', '416194', '416195', '416196', '416197', '416209', '416233', '416235', '416285', '416983']
nosy_count = 7.0
nosy_names = ['ned.deily', 'docs@python', 'lukasz.langa', 'steve.dower', 'hugovk', 'miss-islington', 'Maciej Olko']
pr_nums = ['32111', '32109', '32153', '32154', '32161', '32163', '32167', '32168', '32169', '32182', '32183']
priority = 'normal'
resolution = 'fixed'
stage = 'patch review'
status = 'open'
superseder = None
type = None
url = 'https://bugs.python.org/issue47138'
versions = ['Python 3.7', 'Python 3.8', 'Python 3.9', 'Python 3.10']

[hugovk]

The docs build on GitHub Actions is passing on main but has started failing for the 3.7 - 3.10 branches:

Missing the required blurb or sphinx-build tools.
Please run 'make venv' to install local copies.

make[1]: *** [Makefile:50: build] Error 1

https://github.com/python/cpython/actions/workflows/doc.yml
https://github.com/python/cpython/runs/5714593700?check_suite_focus=true

This is because the PATH=./venv/bin:$PATH sphinx-build --version check is failing:

/home/runner/work/cpython/cpython/Doc/venv/lib/python3.10/site-packages/sphinx/util/docutils.py:45: DeprecationWarning: distutils Version classes are deprecated. Use packaging.version instead.
  __version_info__ = tuple(LooseVersion(docutils.__version__).version)
Traceback (most recent call last):
  File "/home/runner/work/cpython/cpython/Doc/./venv/bin/sphinx-build", line 5, in <module>
    from sphinx.cmd.build import main
  File "/home/runner/work/cpython/cpython/Doc/venv/lib/python3.10/site-packages/sphinx/cmd/build.py", line 25, in <module>
    from sphinx.application import Sphinx
  File "/home/runner/work/cpython/cpython/Doc/venv/lib/python3.10/site-packages/sphinx/application.py", line 42, in <module>
    from sphinx.registry import SphinxComponentRegistry
  File "/home/runner/work/cpython/cpython/Doc/venv/lib/python3.10/site-packages/sphinx/registry.py", line 24, in <module>
    from sphinx.builders import Builder
  File "/home/runner/work/cpython/cpython/Doc/venv/lib/python3.10/site-packages/sphinx/builders/__init__.py", line 26, in <module>
    from sphinx.util import import_object, logging, rst, progress_message, status_iterator
  File "/home/runner/work/cpython/cpython/Doc/venv/lib/python3.10/site-packages/sphinx/util/rst.py", line 22, in <module>
    from jinja2 import environmentfilter
ImportError: cannot import name 'environmentfilter' from 'jinja2' (/home/runner/work/cpython/cpython/Doc/venv/lib/python3.10/site-packages/jinja2/__init__.py)

This is because 3.10 and 3.9 are still using old versions of Sphinx (3.2.1 and 2.4.4 respectively) which is incompatible with the newest Jinja2:

pallets/jinja#1630

main is using a newer Sphinx (4.2.0), so it passes.

Bumping to Sphinx 4.5.0 will fix both 3.9 and 3.10. 3.7 and 3.8 are affected too. We can bump main to use 4.5.0 as well.