summaryrefslogtreecommitdiffstats
path: root/testsuite/Testsrc/test_doc.py
blob: 93c8d1bb460880fa0a861538f66d7f0dfe1ccd32 (plain)
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
import os
import sys

# add all parent testsuite directories to sys.path to allow (most)
# relative imports in python 2.4
_path = os.path.dirname(__file__)
while _path != '/':
    if os.path.basename(_path).lower().startswith("test"):
        sys.path.append(_path)
    if os.path.basename(_path) == "testsuite":
        break
    _path = os.path.dirname(_path)
from common import *


try:
    from sphinx.application import Sphinx
    HAS_SPHINX = True
except ImportError:
    HAS_SPHINX = False


TEST_SPHINX = bool(os.environ.get('TEST_SPHINX', 'yes') != 'no')


class DocTest(Bcfg2TestCase):
    top = os.path.join(os.path.dirname(__file__), '..', '..')
    source_dir = os.path.join(top, 'doc/')
    doctree_dir = os.path.join(top, 'build', 'doctree')

    @skipUnless(HAS_SPHINX, 'Sphinx not found')
    @skipUnless(TEST_SPHINX, 'Documentation testing disabled')
    def test_html_documentation(self):
        output_dir = os.path.join(self.top, 'build', 'html')

        app = Sphinx(self.source_dir, self.source_dir, output_dir,
                     self.doctree_dir, buildername='html',
                     warningiserror=True)
        app.build(force_all=True)