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
|
#!/usr/bin/python3
#
# Return DocBook markup for all the verification warnings/errors/"ok" notes of a given
# type in verify.h
from pathlib import Path
import re
import sys
import subprocess
if len(sys.argv) < 3:
print(f"Syntax: {sys.argv[0]} <path-to-libdcp-source-tree> <ERROR|BV21_ERROR|WARNING|OK>")
sys.exit(1)
libdcp = Path(sys.argv[1])
type = sys.argv[2]
header = libdcp / "src" / "verify.h"
# The types of note we have, and the strings to look for in order to recognise them
types = {
"BV21_ERROR": ("BV21_ERROR", "bv21_error("),
"ERROR": ("ERROR", "error("),
"WARNING": ("WARNING", "warning("),
"OK": ("ok(",),
}
def find_type(name):
"""
Search source code to find where a given code is used and hence find out whether
it represents an error, Bv2.1 "error", warning or "this is OK" note.
"""
previous = ''
for source in ["verify_j2k.cc", "dcp.cc", "verify.cc", "cpl.cc", "pkl.cc"]:
path = libdcp / "src" / source
with open(path) as s:
for line in s:
if line.find(name) != -1:
line_with_previous = previous + line
for type, signatures in types.items():
for s in signatures:
if line_with_previous.find(s) != -1:
return type
previous = line
assert False, f"Could not find {name}"
print('<itemizedlist>')
active = False
with open(header) as h:
for line in h:
strip = line.strip()
if strip == "enum class Code {":
active = True
elif strip == "};":
active = False
elif active:
if strip.startswith('/**'):
text = strip.replace('/**', '').replace('*/', '').strip()
elif not strip.startswith('/*') and not strip.startswith('*') and strip.endswith(','):
this_type = find_type(strip[:-1])
# print("find", strip[:-1], this_type)
if this_type == type:
text = re.sub(r"\[.*?\]", lambda m: f'(Bv2.1 {m[0][7:-1]})', text)
text = text.replace('<', '<')
text = text.replace('>', '>')
text = re.sub(r"_(.*?)_", r"<code>\1</code>", text)
print(f'<listitem>{text}.</listitem>')
print('</itemizedlist>')
|
