From 5bb0bb4be543fd5eca41673696a62ed80d493591 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 5 Jun 2024 18:20:58 +0200 Subject: Adding upstream version 7.3.7. Signed-off-by: Daniel Baumann --- tests/test_theming/test_theming.py | 227 +++++++++++++++++++++++++++++++++++++ 1 file changed, 227 insertions(+) create mode 100644 tests/test_theming/test_theming.py (limited to 'tests/test_theming/test_theming.py') diff --git a/tests/test_theming/test_theming.py b/tests/test_theming/test_theming.py new file mode 100644 index 0000000..867f8a0 --- /dev/null +++ b/tests/test_theming/test_theming.py @@ -0,0 +1,227 @@ +"""Test the Theme class.""" + +import os +import shutil +from pathlib import Path +from xml.etree.ElementTree import ParseError + +import pytest +from defusedxml.ElementTree import parse as xml_parse + +import sphinx.builders.html +from sphinx.errors import ThemeError +from sphinx.theming import ( + _ConfigFile, + _convert_theme_conf, + _convert_theme_toml, + _load_theme, + _load_theme_conf, + _load_theme_toml, +) + +HERE = Path(__file__).resolve().parent + + +@pytest.mark.sphinx( + testroot='theming', + confoverrides={'html_theme': 'ziptheme', 'html_theme_options.testopt': 'foo'}, +) +def test_theme_api(app, status, warning): + themes = [ + 'basic', + 'default', + 'scrolls', + 'agogo', + 'sphinxdoc', + 'haiku', + 'traditional', + 'epub', + 'nature', + 'pyramid', + 'bizstyle', + 'classic', + 'nonav', + 'test-theme', + 'ziptheme', + 'staticfiles', + 'parent', + 'child', + 'alabaster', + ] + + # test Theme class API + assert set(app.registry.html_themes.keys()) == set(themes) + assert app.registry.html_themes['test-theme'] == str( + app.srcdir / 'test_theme' / 'test-theme' + ) + assert app.registry.html_themes['ziptheme'] == str(app.srcdir / 'ziptheme.zip') + assert app.registry.html_themes['staticfiles'] == str( + app.srcdir / 'test_theme' / 'staticfiles' + ) + + # test Theme instance API + theme = app.builder.theme + assert theme.name == 'ziptheme' + assert len(theme.get_theme_dirs()) == 2 + + # direct setting + assert theme.get_config('theme', 'stylesheet') == 'custom.css' + # inherited setting + assert theme.get_config('options', 'nosidebar') == 'false' + # nonexisting setting + assert theme.get_config('theme', 'foobar', 'def') == 'def' + with pytest.raises(ThemeError): + theme.get_config('theme', 'foobar') + + # options API + + options = theme.get_options({'nonexisting': 'foo'}) + assert 'nonexisting' not in options + + options = theme.get_options(app.config.html_theme_options) + assert options['testopt'] == 'foo' + assert options['nosidebar'] == 'false' + + # cleanup temp directories + theme._cleanup() + assert not any(map(os.path.exists, theme._tmp_dirs)) + + +def test_nonexistent_theme_settings(tmp_path): + # Check that error occurs with a non-existent theme.toml or theme.conf + # (https://github.com/sphinx-doc/sphinx/issues/11668) + with pytest.raises(ThemeError): + _load_theme('', str(tmp_path)) + + +@pytest.mark.sphinx(testroot='double-inheriting-theme') +def test_double_inheriting_theme(app, status, warning): + assert app.builder.theme.name == 'base_theme2' + app.build() # => not raises TemplateNotFound + + +@pytest.mark.sphinx(testroot='theming', confoverrides={'html_theme': 'child'}) +def test_nested_zipped_theme(app, status, warning): + assert app.builder.theme.name == 'child' + app.build() # => not raises TemplateNotFound + + +@pytest.mark.sphinx(testroot='theming', confoverrides={'html_theme': 'staticfiles'}) +def test_staticfiles(app, status, warning): + app.build() + assert (app.outdir / '_static' / 'staticimg.png').exists() + assert (app.outdir / '_static' / 'statictmpl.html').exists() + assert (app.outdir / '_static' / 'statictmpl.html').read_text(encoding='utf8') == ( + '\nPython' + ) + + result = (app.outdir / 'index.html').read_text(encoding='utf8') + assert '' in result + + +@pytest.mark.sphinx(testroot='theming', confoverrides={'html_theme': 'test-theme'}) +def test_dark_style(app, monkeypatch): + monkeypatch.setattr(sphinx.builders.html, '_file_checksum', lambda o, f: '') + + style = app.builder.dark_highlighter.formatter_args.get('style') + assert style.__name__ == 'MonokaiStyle' + + app.build() + assert (app.outdir / '_static' / 'pygments_dark.css').exists() + + css_file, properties = app.registry.css_files[0] + assert css_file == 'pygments_dark.css' + assert 'media' in properties + assert properties['media'] == '(prefers-color-scheme: dark)' + + assert sorted(f.filename for f in app.builder._css_files) == [ + '_static/classic.css', + '_static/pygments.css', + '_static/pygments_dark.css', + ] + + result = (app.outdir / 'index.html').read_text(encoding='utf8') + assert '' in result + assert ( + '' + ) in result + + +@pytest.mark.sphinx(testroot='theming') +def test_theme_sidebars(app, status, warning): + app.build() + + # test-theme specifies globaltoc and searchbox as default sidebars + result = (app.outdir / 'index.html').read_text(encoding='utf8') + assert '

Table of Contents

' in result + assert '

Related Topics

' not in result + assert '

This Page

' not in result + assert '

Quick search

' in result + + +@pytest.mark.parametrize( + 'theme_name', + [ + 'alabaster', + 'agogo', + 'basic', + 'bizstyle', + 'classic', + 'default', + 'epub', + 'haiku', + 'nature', + 'nonav', + 'pyramid', + 'scrolls', + 'sphinxdoc', + 'traditional', + ], +) +def test_theme_builds(make_app, rootdir, sphinx_test_tempdir, theme_name): + """Test all the themes included with Sphinx build a simple project and produce valid XML.""" + testroot_path = rootdir / 'test-basic' + srcdir = sphinx_test_tempdir / f'test-theme-{theme_name}' + shutil.copytree(testroot_path, srcdir) + + app = make_app(srcdir=srcdir, confoverrides={'html_theme': theme_name}) + app.build() + assert not app.warning.getvalue().strip() + assert app.outdir.joinpath('index.html').exists() + + # check that the generated HTML files are well-formed (as strict XML) + for html_file in app.outdir.rglob('*.html'): + try: + xml_parse(html_file) + except ParseError as exc: + pytest.fail(f'Failed to parse {html_file.relative_to(app.outdir)}: {exc}') + + +def test_config_file_toml(): + config_path = HERE / 'theme.toml' + cfg = _load_theme_toml(str(config_path)) + config = _convert_theme_toml(cfg) + + assert config == _ConfigFile( + stylesheets=('spam.css', 'ham.css'), + sidebar_templates=None, + pygments_style_default='spam', + pygments_style_dark=None, + options={'lobster': 'thermidor'}, + ) + + +def test_config_file_conf(): + config_path = HERE / 'theme.conf' + cfg = _load_theme_conf(str(config_path)) + config = _convert_theme_conf(cfg) + + assert config == _ConfigFile( + stylesheets=('spam.css', 'ham.css'), + sidebar_templates=None, + pygments_style_default='spam', + pygments_style_dark=None, + options={'lobster': 'thermidor'}, + ) -- cgit v1.2.3