"""Test the BuildEnvironment class.""" import os import shutil from pathlib import Path import pytest from sphinx.builders.html import StandaloneHTMLBuilder from sphinx.builders.latex import LaTeXBuilder from sphinx.environment import CONFIG_CHANGED, CONFIG_EXTENSIONS_CHANGED, CONFIG_NEW, CONFIG_OK @pytest.mark.sphinx('dummy', testroot='basic') def test_config_status(make_app, app_params): args, kwargs = app_params # clean build app1 = make_app(*args, freshenv=True, **kwargs) assert app1.env.config_status == CONFIG_NEW app1.build() assert '[new config] 1 added' in app1._status.getvalue() # incremental build (no config changed) app2 = make_app(*args, **kwargs) assert app2.env.config_status == CONFIG_OK app2.build() assert "0 added, 0 changed, 0 removed" in app2._status.getvalue() # incremental build (config entry changed) app3 = make_app(*args, confoverrides={'root_doc': 'indexx'}, **kwargs) fname = os.path.join(app3.srcdir, 'index.rst') assert os.path.isfile(fname) shutil.move(fname, fname[:-4] + 'x.rst') assert app3.env.config_status == CONFIG_CHANGED app3.build() shutil.move(fname[:-4] + 'x.rst', fname) assert "[config changed ('root_doc')] 1 added" in app3._status.getvalue() # incremental build (extension changed) app4 = make_app(*args, confoverrides={'extensions': ['sphinx.ext.autodoc']}, **kwargs) assert app4.env.config_status == CONFIG_EXTENSIONS_CHANGED app4.build() want_str = "[extensions changed ('sphinx.ext.autodoc')] 1 added" assert want_str in app4._status.getvalue() @pytest.mark.sphinx('dummy') def test_images(app): app.build() tree = app.env.get_doctree('images') htmlbuilder = StandaloneHTMLBuilder(app, app.env) htmlbuilder.init() htmlbuilder.imgpath = 'dummy' htmlbuilder.post_process_images(tree) assert set(htmlbuilder.images.keys()) == \ {'subdir/img.png', 'img.png', 'subdir/simg.png', 'svgimg.svg', 'img.foo.png'} assert set(htmlbuilder.images.values()) == \ {'img.png', 'img1.png', 'simg.png', 'svgimg.svg', 'img.foo.png'} latexbuilder = LaTeXBuilder(app, app.env) latexbuilder.init() latexbuilder.post_process_images(tree) assert set(latexbuilder.images.keys()) == \ {'subdir/img.png', 'subdir/simg.png', 'img.png', 'img.pdf', 'svgimg.pdf', 'img.foo.png'} assert set(latexbuilder.images.values()) == \ {'img.pdf', 'img.png', 'img1.png', 'simg.png', 'svgimg.pdf', 'img.foo.png'} @pytest.mark.sphinx('dummy') def test_object_inventory(app): app.build() refs = app.env.domaindata['py']['objects'] assert 'func_without_module' in refs assert refs['func_without_module'] == ('objects', 'func_without_module', 'function', False) assert 'func_without_module2' in refs assert 'mod.func_in_module' in refs assert 'mod.Cls' in refs assert 'mod.Cls.meth1' in refs assert 'mod.Cls.meth2' in refs assert 'mod.Cls.meths' in refs assert 'mod.Error' not in refs assert 'errmod.Error' in refs assert 'func_in_module' not in refs assert 'func_noindex' not in refs assert app.env.domaindata['py']['modules']['mod'] == \ ('objects', 'module-mod', 'Module synopsis.', 'UNIX', False) assert app.env.domains['py'].data is app.env.domaindata['py'] assert app.env.domains['c'].data is app.env.domaindata['c'] @pytest.mark.sphinx('dummy', testroot='basic') def test_env_relfn2path(app): # relative filename and root document relfn, absfn = app.env.relfn2path('logo.jpg', 'index') assert relfn == 'logo.jpg' assert absfn == str(app.srcdir / 'logo.jpg') # absolute filename and root document relfn, absfn = app.env.relfn2path('/logo.jpg', 'index') assert relfn == 'logo.jpg' assert absfn == str(app.srcdir / 'logo.jpg') # relative filename and a document in subdir relfn, absfn = app.env.relfn2path('logo.jpg', 'subdir/index') assert Path(relfn) == Path('subdir/logo.jpg') assert absfn == str(app.srcdir / 'subdir' / 'logo.jpg') # absolute filename and a document in subdir relfn, absfn = app.env.relfn2path('/logo.jpg', 'subdir/index') assert relfn == 'logo.jpg' assert absfn == str(app.srcdir / 'logo.jpg') # relative filename having subdir relfn, absfn = app.env.relfn2path('images/logo.jpg', 'index') assert relfn == 'images/logo.jpg' assert absfn == str(app.srcdir / 'images' / 'logo.jpg') # relative path traversal relfn, absfn = app.env.relfn2path('../logo.jpg', 'index') assert relfn == '../logo.jpg' assert absfn == str(app.srcdir.parent / 'logo.jpg') # relative path traversal relfn, absfn = app.env.relfn2path('subdir/../logo.jpg', 'index') assert relfn == 'logo.jpg' assert absfn == str(app.srcdir / 'logo.jpg') # omit docname (w/ current docname) app.env.temp_data['docname'] = 'subdir/document' relfn, absfn = app.env.relfn2path('images/logo.jpg') assert Path(relfn) == Path('subdir/images/logo.jpg') assert absfn == str(app.srcdir / 'subdir' / 'images' / 'logo.jpg') # omit docname (w/o current docname) app.env.temp_data.clear() with pytest.raises(KeyError): app.env.relfn2path('images/logo.jpg')