1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
from packaging.version import Version
import pytest
from sphinx import __version__
SPHINX_LT_17 = Version(__version__) < Version('1.7')
if SPHINX_LT_17:
from sphinx import build_main
else:
from sphinx.cmd.build import build_main
THEMES = ['bootstrap-astropy']
BASIC_CONF = """
source_suffix = '.rst'
master_doc = 'index'
html_theme = '{theme}'
"""
BASIC_INDEX = """
Title
=====
Just a test
"""
@pytest.mark.parametrize('theme', THEMES)
def test_basic(tmpdir, theme):
# Just make sure the docs build with the specified theme
# (to make sure e.g. that no templates are missing)
with open(tmpdir.join('conf.py').strpath, 'w') as f:
f.write(BASIC_CONF.format(theme=theme))
with open(tmpdir.join('index.rst').strpath, 'w') as f:
f.write(BASIC_INDEX.format(theme=theme))
src_dir = tmpdir.strpath
html_dir = tmpdir.mkdir('html').strpath
if SPHINX_LT_17:
status = build_main(argv=['sphinx-build', '-W', '-b', 'html', src_dir, html_dir])
else:
# As of Sphinx 1.7, the first argument is now no longer ignored
status = build_main(argv=['-W', '-b', 'html', src_dir, html_dir])
assert status == 0
|
