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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
import copy
import os
import tempfile
import time
import pytest
from hypothesis import given, example, assume
from hypothesis.strategies import lists, text, booleans, choices, none
import pycco.main as p
PYTHON = p.languages['.py']
PYCCO_SOURCE = 'pycco/main.py'
FOO_FUNCTION = """def foo():\n return True"""
def get_language(choice):
return choice(list(p.languages.values()))
@given(lists(text()), text())
def test_shift(fragments, default):
if fragments == []:
assert p.shift(fragments, default) == default
else:
fragments2 = copy.copy(fragments)
head = p.shift(fragments, default)
assert [head] + fragments == fragments2
@given(text(), booleans(), text(min_size=1))
@example("/foo", True, "0")
def test_destination(filepath, preserve_paths, outdir):
dest = p.destination(filepath, preserve_paths=preserve_paths, outdir=outdir)
assert dest.startswith(outdir)
assert dest.endswith(".html")
@given(choices(), text())
def test_parse(choice, source):
l = get_language(choice)
parsed = p.parse(source, l)
for s in parsed:
assert {"code_text", "docs_text"} == set(s.keys())
def test_skip_coding_directive():
source = "# -*- coding: utf-8 -*-\n" + FOO_FUNCTION
parsed = p.parse(source, PYTHON)
for section in parsed:
assert "coding" not in section['code_text']
def test_multi_line_leading_spaces():
source = "# This is a\n# comment that\n# is indented\n"
source += FOO_FUNCTION
parsed = p.parse(source, PYTHON)
# The resulting comment has leading spaces stripped out.
assert parsed[0]["docs_text"] == "This is a\ncomment that\nis indented\n"
def test_comment_with_only_cross_ref():
source = '''# ==Link Target==\n\ndef test_link():\n """[[testing.py#link-target]]"""\n pass'''
sections = p.parse(source, PYTHON)
p.highlight(sections, PYTHON, outdir=tempfile.gettempdir())
assert sections[1]['docs_html'] == '<p><a href="testing.html#link-target">testing.py</a></p>'
@given(text(), text())
def test_get_language_specify_language(source, code):
assert p.get_language(source, code, language="python") == p.languages['.py']
with pytest.raises(ValueError):
p.get_language(source, code, language="non-existent")
@given(text() | none())
def test_get_language_bad_source(source):
code = "#!/usr/bin/python\n"
code += FOO_FUNCTION
assert p.get_language(source, code) == PYTHON
with pytest.raises(ValueError) as e:
assert p.get_language(source, "badlang")
msg = "Can't figure out the language!"
try:
assert e.value.message == msg
except AttributeError:
assert e.value.args[0] == msg
@given(text() | none())
def test_get_language_bad_code(code):
source = "test.py"
assert p.get_language(source, code) == PYTHON
@given(text(max_size=64))
def test_ensure_directory(dir_name):
tempdir = os.path.join(tempfile.gettempdir(), str(int(time.time())), dir_name)
# Use sanitization from function, but only for housekeeping. We
# pass in the unsanitized string to the function.
safe_name = p.remove_control_chars(dir_name)
if not os.path.isdir(safe_name) and os.access(safe_name, os.W_OK):
p.ensure_directory(tempdir)
assert os.path.isdir(safe_name)
# The following functions get good test coverage, but effort should be put into
# decomposing the functions they test and actually testing their output.
def test_generate_documentation():
p.generate_documentation(PYCCO_SOURCE, outdir=tempfile.gettempdir())
@given(booleans(), choices())
def test_process(preserve_paths, choice):
lang_name = choice([l["name"] for l in p.languages.values()])
p.process([PYCCO_SOURCE], preserve_paths=preserve_paths, outdir=tempfile.gettempdir(), language=lang_name)
def test_ensure_multiline_string_support():
code = '''x = """
how about this?
"""
y = z # is this where it should be?
# how did this get so *BIG!*
def x():
"""how would you fix?
"""'''
docs_code_tuple_list = p.parse(code,PYTHON)
assert docs_code_tuple_list[0]['docs_text'] == ''
assert "#" not in docs_code_tuple_list[1]['docs_text']
|
