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
|
from typing import Union, List
from re import fullmatch
from ._utils import escape_markdown
def _is_cpython_signature_line(line: str) -> bool:
"""CPython uses signature lines in the following format:
str(bytes_or_buffer[, encoding[, errors]]) -> str
"""
return fullmatch(r'\w+\(\S*(, \S+)*(\[, \S+\])*\)\s--?>\s.+', line) is not None
def cpython_to_markdown(text: str) -> Union[str, None]:
signature_lines: List[str] = []
other_lines: List[str] = []
for line in text.splitlines():
if not other_lines and _is_cpython_signature_line(line):
signature_lines.append(line)
elif not signature_lines:
return None
elif line.startswith(' '):
signature_lines.append(line)
else:
other_lines.append(line)
return '\n'.join([
'```',
'\n'.join(signature_lines),
'```',
escape_markdown('\n'.join(other_lines))
])
def looks_like_cpython(text: str) -> bool:
return cpython_to_markdown(text) is not None
__all__ = ['looks_like_cpython', 'cpython_to_markdown']
|
