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
|
#!/usr/bin/env python3
#
# Copyright (C) 2024-2025 Matthias Klumpp <matthias@tenstral.net>
#
# Licensed under the GNU Lesser General Public License Version 2.1
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation, either version 2.1 of the license, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
# This is a helper script for Meson and intended to be called by the
# AppStream buildsystem. You do not want to run this manually.
#
import os
import argparse
import subprocess
import shutil
def run_gidocgen_generate(gidocgen_exe, output_dir, namespace, extra_args):
"""Work around a quirk in gi-docgen that results in misnamed devhelp files."""
cmd = [
gidocgen_exe,
'generate',
'--quiet',
'--no-namespace-dir',
]
post_rename = False
if namespace and output_dir:
post_rename = True
cmd.extend(['--output-dir', namespace])
elif output_dir:
cmd.extend(['--output-dir', output_dir])
cmd.extend(extra_args)
ret = subprocess.call(cmd)
if post_rename:
# unfortunately for some reason, gi-docgen takes the output directory
# name as namespace name, resulting in misnamed devhelp files.
# We work around this here.
if os.path.isdir(output_dir):
shutil.rmtree(output_dir)
shutil.move(namespace, output_dir)
return ret == 0
def main(args):
parser = argparse.ArgumentParser()
parser.add_argument('--gidocgen', action='store', default='gi-docgen')
parser.add_argument('--output-dir', action='store')
parser.add_argument('--namespace', action='store')
options, extra_args = parser.parse_known_args(args)
ret = run_gidocgen_generate(options.gidocgen, options.output_dir, options.namespace, extra_args)
if not ret:
sys.exit(1)
return 0
if __name__ == '__main__':
import sys
sys.exit(main(sys.argv[1:]))
|
