Adding a flag to skip all LaTeX related tests

[maxschloegel]

Is your feature request related to a problem? Please describe.
When running the tests for sphinx on a clean install some tests failed due to what seems to be an outdated Tex Live install. The Tex Live requirements don't seem to be listed in the Installing Sphinx section nor the Contributing to Sphinx.

FAILED tests/test_builders/test_build_latex.py::test_build_latex_doc[lualatex-manual-None] - AssertionError: lualatex exited with return code 1
FAILED tests/test_builders/test_build_latex.py::test_build_latex_doc[lualatex-howto-None] - AssertionError: lualatex exited with return code 1

It seems my Tex Live version is too old, tlmgr --version returns:

tlmgr revision 60693 (2021-10-04 04:24:25 +0200)
tlmgr using installation: /usr/share/texlive
TeX Live (https://tug.org/texlive) version 2021

Describe the solution you'd like

One solution would be to add a flag to disable all LaTeX related tests, since they seem to be isolated from the rest and would make the requirements for testing non-LaTeX code more lightweight.

Describe alternatives you've considered

Another way of resolving this issue in the future would be to add a small section in the the documentation about the current requirements of Tex Live.

[jfbu]

Hi,

1. If you set SKIP_LATEX_BUILD in the environment, the latex tests should be skipped. Could you try this?
2. TeXLive 2021 is definitely not too old. Unfortunately I can't test on my device currently, but for example a complete TeXLive 2019 is expected to be compatible with current Sphinx. Perhaps you have only a partial installation (possibly some font missing).
3. Check here what we currently say about requirements. Please report if this looks useful enough or more precision is needed. I am not certain The testing is currently (since 5.3.0) done on Ubuntu 22.04LTS is currently accurate. It may be outdated.
4. I would be interested into the actual cause of failure. You may be able to fetch the suitable .log file in a subdirectory of the pytest temporary directory.

[jfbu]

Also the file bindep.txt is used for documenting requirements on some Linux platforms.

[jfbu]

Hi,

1. If you set SKIP_LATEX_BUILD in the environment, the latex tests should be skipped. Could you try this?

More precisely it skips all tests doing a pdf build, but this is probably what OP requested.

Apart from that I wonder if luatex is installed in the OP device. What does lualatex sample2e report?