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
|
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
import re
from docutils.nodes import Text, paragraph, reference
from sphinx.transforms import SphinxTransform
class ConvertBugsToLinks(SphinxTransform):
# Convert text entries in paragraphs that are in the style of "bug xxxxx"
# to a hyperlink that leads to the appropriate bugzilla bug link.
default_priority = 400
bz_url = "https://bugzilla.mozilla.org/show_bug.cgi?id={0}"
bz_reg = r"bug[' '][0-9]\d*"
def apply(self):
def check_if_paragraph(o):
return isinstance(o, paragraph)
def check_if_text(o):
return (
not isinstance(o.parent, reference)
and isinstance(o, Text)
and re.search(self.bz_reg, o, re.IGNORECASE)
)
changed = True
while changed:
changed = self.textToReferences(check_if_paragraph, check_if_text)
return
def textToReferences(self, check_if_paragraph, check_if_text):
# Analyses the document and replaces from the paragraph nodes
# the Text element(s) that contain bz_reg matching strings.
# Whevever the matching strings are more than one and
# a correction is made, the function returns True.
for node in self.document.traverse(check_if_paragraph):
for text in node.traverse(check_if_text):
bugs = re.findall(self.bz_reg, text, re.IGNORECASE)
if len(bugs) == 0:
continue
bug = bugs[0]
txtparts = text.split(bug, 1)
new_ref = reference(
bug,
bug,
refuri=self.bz_url.format(bug.split()[1]),
)
txt_0 = Text(txtparts[0])
txt_1 = Text(txtparts[1])
text.parent.replace(text, [txt_0, new_ref, txt_1])
if len(bugs) > 1:
return True
return False
def setup(app):
app.add_transform(ConvertBugsToLinks)
return
|
