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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
#!/usr/bin/env python3
#
# fontconfig/doc/edit-sgml.py
#
# Copyright © 2003 Keith Packard
# Copyright © 2020 Tim-Philipp Müller
#
# Permission to use, copy, modify, distribute, and sell this software and its
# documentation for any purpose is hereby granted without fee, provided that
# the above copyright notice appear in all copies and that both that
# copyright notice and this permission notice appear in supporting
# documentation, and that the name of the author(s) not be used in
# advertising or publicity pertaining to distribution of the software without
# specific, written prior permission. The authors make no
# representations about the suitability of this software for any purpose. It
# is provided "as is" without express or implied warranty.
#
# THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
# INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
# EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
# CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
# DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
# TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
# PERFORMANCE OF THIS SOFTWARE.
import argparse
import sys
import re
parser = argparse.ArgumentParser()
parser.add_argument('template')
parser.add_argument('input')
parser.add_argument('output')
args = parser.parse_known_args()
template_fn = args[0].template
output_fn = args[0].output
input_fn = args[0].input
# -------------
# Read template
# -------------
with open(template_fn, 'r', encoding='utf8') as f:
template_text = f.read()
template_lines = template_text.strip().split('\n')
# -------------------------------------
# Read replacement sets from .fncs file
# -------------------------------------
replacement_sets = []
# TODO: also allow '-' for stdin
with open(input_fn, 'r', encoding='utf8') as f:
fncs_text = f.read()
# split into replacement sets
fncs_chunks = fncs_text.strip().split('@@')
for chunk in fncs_chunks:
# get rid of any preamble such as license and FcFreeTypeQueryAll decl in fcfreetype.fncs
start = chunk.find('@')
if start:
chunk = chunk[start:]
# split at '@' and remove empty lines (keep it simple instead of doing fancy
# things with regular expression matches, we control the input after all)
lines = [line for line in chunk.split('@') if line.strip()]
replacement_set = {}
while lines:
tag = lines.pop(0).strip()
# FIXME: this hard codes the tag used in funcs.sgml - we're lazy
if tag.startswith('PROTOTYPE'):
text = ''
else:
text = lines.pop(0).strip()
if text.endswith('%'):
text = text[:-1] + ' '
replacement_set[tag] = text
if replacement_set:
replacement_sets += [replacement_set]
# ----------------
# Open output file
# ----------------
if output_fn == '-':
fout = sys.stdout
else:
fout = open(output_fn, "w", encoding='utf8')
# ----------------
# Process template
# ----------------
def do_replace(template_lines, rep, tag_suffix=''):
skip_tag = None
skip_lines = False
loop_lines = []
loop_tag = None
for t_line in template_lines:
# This makes processing easier and is the case for our templates
if t_line.startswith('@') and not t_line.endswith('@'):
sys.exit('Template lines starting with @ are expected to end with @, please fix me!')
if loop_tag:
loop_lines += [t_line]
# Check if line starts with a directive
if t_line.startswith('@?'):
tag = t_line[2:-1] + tag_suffix
if skip_tag:
sys.exit('Recursive skipping not supported, please fix me!')
skip_tag = tag
skip_lines = tag not in rep
elif t_line.startswith('@:'):
if not skip_tag:
sys.exit('Skip else but no active skip list?!')
skip_lines = skip_tag in rep
elif t_line.startswith('@;'):
if not skip_tag:
sys.exit('Skip end but no active skip list?!')
skip_tag = None
skip_lines = False
elif t_line.startswith('@{'):
if loop_tag or tag_suffix != '':
sys.exit('Recursive looping not supported, please fix me!')
loop_tag = t_line[2:-1]
elif t_line.startswith('@}'):
tag = t_line[2:-1] + tag_suffix
if not loop_tag:
sys.exit('Loop end but no active loop?!')
if loop_tag != tag:
sys.exit(f'Loop end but loop tag mismatch: {loop_tag} != {tag}!')
loop_lines.pop() # remove loop end directive
suffix = '+'
while loop_tag + suffix in rep:
do_replace(loop_lines, rep, suffix)
suffix += '+'
loop_tag = None
loop_lines = []
else:
if not skip_lines:
# special-case inline optional substitution (hard-codes specific pattern in funcs.sgml because we're lazy)
output_line = re.sub(r'@\?(RET)@@RET@@:@(void)@;@', lambda m: rep.get(m.group(1) + tag_suffix, m.group(2)), t_line)
# replace any substitution tags with their respective substitution text
output_line = re.sub(r'@(\w+)@', lambda m: rep.get(m.group(1) + tag_suffix, ''), output_line)
print(output_line, file=fout)
# process template for each replacement set
for rep in replacement_sets:
do_replace(template_lines, rep)
|
