IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

Ref #5273: doctest: add test for skipif calling global setup/cleanup

Browse Source 
Ensure that `doctest_global_setup` and `doctest_global_cleanup` are executed
before and after evaluating each `:skipif:` option.
This commit is contained in:
Antti Kaihola 2018-08-16 17:56:29 +03:00
parent d52488f028
commit 098f37fddf
2 changed files with 30 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
tests/roots/test-ext-doctest-skipif/conf.py
View File

@ -7,4 +7,10 @@ exclude_patterns = ['_build']
doctest_global_setup = '''
from test_ext_doctest import record
record('doctest_global_setup', 'body', True)
'''
doctest_global_cleanup = '''
record('doctest_global_cleanup', 'body', True)
'''

42
tests/test_ext_doctest.py
View File

@ -9,6 +9,7 @@
:license: BSD, see LICENSE for details.
"""
import os
from collections import Counter
import pytest
from packaging.specifiers import InvalidSpecifier
@ -61,7 +62,7 @@ def cleanup_call():
cleanup_called += 1
recorded_calls = set()
recorded_calls = Counter()
@pytest.mark.sphinx('doctest', testroot='ext-doctest-skipif')
@ -76,33 +77,38 @@ def test_skipif(app, status, warning):
"""
global recorded_calls
recorded_calls = set()
recorded_calls = Counter()
app.builder.build_all()
if app.statuscode != 0:
assert False, 'failures in doctests:' + status.getvalue()
# The `:skipif:` expressions are always run.
# Actual tests and setup/cleanup code is only run if the `:skipif:`
# expression evaluates to a False value.
assert recorded_calls == {('testsetup', ':skipif:', True),
('testsetup', ':skipif:', False),
('testsetup', 'body', False),
('doctest', ':skipif:', True),
('doctest', ':skipif:', False),
('doctest', 'body', False),
('testcode', ':skipif:', True),
('testcode', ':skipif:', False),
('testcode', 'body', False),
('testoutput-1', ':skipif:', True),
('testoutput-2', ':skipif:', True),
('testoutput-2', ':skipif:', False),
('testcleanup', ':skipif:', True),
('testcleanup', ':skipif:', False),
('testcleanup', 'body', False)}
# Global setup/cleanup are run before/after evaluating the `:skipif:`
# option in each directive - thus 11 additional invocations for each on top
# of the ones made for the whole test file.
assert recorded_calls == {('doctest_global_setup', 'body', True): 13,
('testsetup', ':skipif:', True): 1,
('testsetup', ':skipif:', False): 1,
('testsetup', 'body', False): 1,
('doctest', ':skipif:', True): 1,
('doctest', ':skipif:', False): 1,
('doctest', 'body', False): 1,
('testcode', ':skipif:', True): 1,
('testcode', ':skipif:', False): 1,
('testcode', 'body', False): 1,
('testoutput-1', ':skipif:', True): 1,
('testoutput-2', ':skipif:', True): 1,
('testoutput-2', ':skipif:', False): 1,
('testcleanup', ':skipif:', True): 1,
('testcleanup', ':skipif:', False): 1,
('testcleanup', 'body', False): 1,
('doctest_global_cleanup', 'body', True): 13}
def record(directive, part, should_skip):
global recorded_calls
recorded_calls.add((directive, part, should_skip))
recorded_calls[(directive, part, should_skip)] += 1
return 'Recorded {} {} {}'.format(directive, part, should_skip)