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
|
"""Data conversion helpers for the in-tree PEP 517 build backend."""
from collections.abc import Iterable, Iterator, Mapping
from itertools import chain
from re import sub as _substitute_with_regexp
from typing import Union
def _emit_opt_pairs(opt_pair: tuple[str, Union[dict[str, str], str]]) -> Iterator[str]:
flag, flag_value = opt_pair
flag_opt = f"--{flag!s}"
if isinstance(flag_value, dict):
sub_pairs: Iterable[tuple[str, ...]] = flag_value.items()
else:
sub_pairs = ((flag_value,),)
yield from ("=".join(map(str, (flag_opt,) + pair)) for pair in sub_pairs)
def get_cli_kwargs_from_config(kwargs_map: dict[str, str]) -> list[str]:
"""Make a list of options with values from config."""
return list(chain.from_iterable(map(_emit_opt_pairs, kwargs_map.items())))
def get_enabled_cli_flags_from_config(flags_map: Mapping[str, bool]) -> list[str]:
"""Make a list of enabled boolean flags from config."""
return [f"--{flag}" for flag, is_enabled in flags_map.items() if is_enabled]
def sanitize_rst_roles(rst_source_text: str) -> str:
"""Replace RST roles with inline highlighting."""
pep_role_regex = r"""(?x)
:pep:`(?P<pep_number>\d+)`
"""
pep_substitution_pattern = (
r"`PEP \g<pep_number> <https://peps.python.org/pep-\g<pep_number>>`__"
)
user_role_regex = r"""(?x)
:user:`(?P<github_username>[^`]+)(?:\s+(.*))?`
"""
user_substitution_pattern = (
r"`@\g<github_username> "
r"<https://github.com/sponsors/\g<github_username>>`__"
)
issue_role_regex = r"""(?x)
:issue:`(?P<issue_number>[^`]+)(?:\s+(.*))?`
"""
issue_substitution_pattern = (
r"`#\g<issue_number> "
r"<https://github.com/aio-libs/propcache/issues/\g<issue_number>>`__"
)
pr_role_regex = r"""(?x)
:pr:`(?P<pr_number>[^`]+)(?:\s+(.*))?`
"""
pr_substitution_pattern = (
r"`PR #\g<pr_number> "
r"<https://github.com/aio-libs/propcache/pull/\g<pr_number>>`__"
)
commit_role_regex = r"""(?x)
:commit:`(?P<commit_sha>[^`]+)(?:\s+(.*))?`
"""
commit_substitution_pattern = (
r"`\g<commit_sha> "
r"<https://github.com/aio-libs/propcache/commit/\g<commit_sha>>`__"
)
gh_role_regex = r"""(?x)
:gh:`(?P<gh_slug>[^`<]+)(?:\s+([^`]*))?`
"""
gh_substitution_pattern = r"GitHub: ``\g<gh_slug>``"
meth_role_regex = r"""(?x)
(?::py)?:meth:`~?(?P<rendered_text>[^`<]+)(?:\s+([^`]*))?`
"""
meth_substitution_pattern = r"``\g<rendered_text>()``"
role_regex = r"""(?x)
(?::\w+)?:\w+:`(?P<rendered_text>[^`<]+)(?:\s+([^`]*))?`
"""
substitution_pattern = r"``\g<rendered_text>``"
project_substitution_regex = r"\|project\|"
project_substitution_pattern = "propcache"
substitutions = (
(pep_role_regex, pep_substitution_pattern),
(user_role_regex, user_substitution_pattern),
(issue_role_regex, issue_substitution_pattern),
(pr_role_regex, pr_substitution_pattern),
(commit_role_regex, commit_substitution_pattern),
(gh_role_regex, gh_substitution_pattern),
(meth_role_regex, meth_substitution_pattern),
(role_regex, substitution_pattern),
(project_substitution_regex, project_substitution_pattern),
)
rst_source_normalized_text = rst_source_text
for regex, substitution in substitutions:
rst_source_normalized_text = _substitute_with_regexp(
regex,
substitution,
rst_source_normalized_text,
)
return rst_source_normalized_text
|
