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
|
#!/usr/bin/env python
#
# Searches through the whole source tree and updates
# the generated *.gen/*.mod files in the docs folder, keeping all
# documentation for the tools, builders and functions...
# as well as the entity declarations for them.
# Uses scons-proc.py under the hood...
#
import os
import sys
import subprocess
import SConsDoc
# Directory where all generated files are stored
gen_folder = os.path.join('doc','generated')
def argpair(key):
""" Return the argument pair *.gen,*.mod for the given key. """
arg = '%s,%s' % (os.path.join(gen_folder, '%s.gen' % key),
os.path.join(gen_folder, '%s.mod' % key))
return arg
def generate_all():
""" Scan for XML files in the src directory and call scons-proc.py
to generate the *.gen/*.mod files from it.
"""
flist = []
for path, dirs, files in os.walk('src'):
for f in files:
if f.endswith('.xml'):
fpath = os.path.join(path, f)
if SConsDoc.isSConsXml(fpath):
flist.append(fpath)
if flist:
# Does the destination folder exist
if not os.path.isdir(gen_folder):
try:
os.makedirs(gen_folder)
except:
print("Couldn't create destination folder %s! Exiting..." % gen_folder)
return
# Call scons-proc.py
cp = subprocess.run([sys.executable,
os.path.join('bin','scons-proc.py'),
'-b', argpair('builders'),
'-f', argpair('functions'),
'-t', argpair('tools'),
'-v', argpair('variables')] + flist,
shell=False)
cp.check_returncode() # bail if it failed
# lxml: fixup possibly broken tools.gen:
with open(os.path.join(gen_folder, 'tools.gen'), 'r') as f :
filedata = f.read()
filedata = filedata.replace(r'&cv-link', r'&cv-link')
with open(os.path.join(gen_folder, 'tools.gen'), 'w') as f :
f.write(filedata)
if __name__ == "__main__":
generate_all()
|
