Missing typing_extensions when building docs on Python 3.8

[jugmac00]

Issue

tox -e docs

causes the following warning

WARNING: Failed guarded type import with ModuleNotFoundError("No module named 'typing_extensions'")
WARNING: Cannot resolve forward reference in type annotations of "tox.config.loader.section.Section.from_key": name 'Self' is not defined
WARNING: Failed guarded type import with ModuleNotFoundError("No module named 'typing_extensions'")

Environment

Provide at least:

• OS:

Ubuntu 20.04
Python 3.8

[jugmac00]

A couple of thoughts... either we require typing-extensions for building docs, or we need to set a basepython for the docs env which does not require the typing-extensions any more.

[gaborbernat]

The docs are meant to be build on latest (currently 3.11) Python. Anything else is just not supported.

[jugmac00]

tox has no concept of latest, so do you mind setting basepython = python3.11, at least once pradyunsg/furo#693 has been fixed?

[gaborbernat]

Well hopefully you're installing tox into latest Python, that way you do get latest...

[jugmac00]

Actually, I dit not until now. Usually I use the Python version which comes along with the Ubuntu LTS I am using for all the tools.

While I just re-installed tox with Python 3.11, I do not think it is a pleasant experience for people contributing to our documentation to encounter various error messages, and only then be told to use the latest Python version.

Read the Docs defaults to Python 3.11 ( https://blog.readthedocs.com/migrate-configuration-v2/#additional-help ), so imho it makes a lot of sense to also use basepython = python3.11 for the docs env.