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
51
52
53
54
55
56
57
58
59
60
61
|
from pathlib import Path
import pytest
from docutils.core import publish_doctree
ROOT_DIR = Path(__file__).parents[1]
def is_code_block(node):
return node.tagname == "literal_block" and "code" in node.attributes["classes"]
def get_code_blocks(file_path):
with file_path.open() as file_handle:
content = file_handle.read()
code_blocks = publish_doctree(content).findall(condition=is_code_block)
return [block.astext() for block in code_blocks]
@pytest.mark.parametrize("rst_file", ("docs/index.rst", "README.rst"))
def test_documentation(testdir, rst_file):
imports = "\n".join(
[
"import asyncio",
"import os",
"import sys",
"",
"import pytest",
"import pytest_subprocess",
"import subprocess",
]
)
setup_fixture = (
"\n\n"
"@pytest.fixture(autouse=True)\n"
"def setup():\n"
" os.chdir(os.path.dirname(__file__))\n\n"
)
event_loop_fixture = (
"\n\n"
"@pytest.fixture(autouse=True)\n"
"def event_loop(request):\n"
" policy = asyncio.get_event_loop_policy()\n"
' if sys.platform == "win32":\n'
" loop = asyncio.ProactorEventLoop()\n"
" else:\n"
" loop = policy.get_event_loop()\n"
" yield loop\n"
" loop.close()\n"
)
code_blocks = "\n".join(get_code_blocks(ROOT_DIR / rst_file))
testdir.makepyfile(
imports + setup_fixture + event_loop_fixture + "\n" + code_blocks
)
result = testdir.inline_run()
assert result.ret == 0
|
