blob: e6747b0c67cf62bb4297b00b1ce856de0a7ebe8c (
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
40
41
42
43
44
45
46
47
48
|
# -*- coding: utf-8 -*-
"""
test_coverage
~~~~~~~~~~~~~
Test the coverage builder.
:copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
"""
import pickle
from util import with_app
@with_app(buildername='coverage')
def test_build(app):
app.builder.build_all()
py_undoc = (app.outdir / 'python.txt').text()
assert py_undoc.startswith('Undocumented Python objects\n'
'===========================\n')
assert 'test_autodoc\n------------\n' in py_undoc
assert ' * Class -- missing methods:\n' in py_undoc
assert ' * process_docstring\n' in py_undoc
assert ' * function\n' not in py_undoc # these two are documented
assert ' * Class\n' not in py_undoc # in autodoc.txt
assert ' * mod -- No module named mod' # in the "failed import" section
c_undoc = (app.outdir / 'c.txt').text()
assert c_undoc.startswith('Undocumented C API elements\n'
'===========================\n')
assert 'api.h' in c_undoc
assert ' * Py_SphinxTest' in c_undoc
undoc_py, undoc_c = pickle.loads((app.outdir / 'undoc.pickle').bytes())
assert len(undoc_c) == 1
# the key is the full path to the header file, which isn't testable
assert undoc_c.values()[0] == [('function', 'Py_SphinxTest')]
assert 'test_autodoc' in undoc_py
assert 'funcs' in undoc_py['test_autodoc']
assert 'process_docstring' in undoc_py['test_autodoc']['funcs']
assert 'classes' in undoc_py['test_autodoc']
assert 'Class' in undoc_py['test_autodoc']['classes']
assert 'undocmeth' in undoc_py['test_autodoc']['classes']['Class']
|
