forked from KhronosGroup/ANARI-Docs
-
Notifications
You must be signed in to change notification settings - Fork 0
/
gen-script-docs.sh
executable file
·78 lines (68 loc) · 2.38 KB
/
gen-script-docs.sh
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
#!/bin/sh
# Copyright (c) 2019-2020 The Khronos Group Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# SPDX-License-Identifier: Apache-2.0
# Generate documentation for the python scripts in this repo, using pdoc3:
# https://pdoc3.github.io/pdoc/
#
# Output is under out/python-docs
set -e
# Pipe in some paths. We'll convert them to module names and document them.
pathsToDocs() {
grep -v "test_" | \
grep -v "__init__.py" | \
sed -e 's/[.]py//' -e 's:/:.:g' | \
xargs --verbose pdoc3 --html --force --output-dir $1
}
# Main body of script
(
cd $(dirname $0)
# Needed to complete the build - can't import genRef.py without it.
make scripts/vkapi.py
SPECDIR=$(pwd)
OUTDIR=$(pwd)/out/python-docs
INDEX=$OUTDIR/index.html
mkdir -p $OUTDIR
cp scripts/__init__.py.docs scripts/__init__.py
export PYTHONPATH=${SPECDIR}/scripts
(
# # scripts under specification
cd $SPECDIR/scripts
ls *.py
# Generate the index files
# echo "scripts"
echo "scripts.spec_tools"
) | pathsToDocs $OUTDIR
# Generate a simple index file, since generating one with pdoc3 chokes on the Retired directory.
echo "<html><body><h1>Python modules</h2><ul>" > $INDEX
(
cd $SPECDIR/scripts
ls *.py
) | while read -r fn; do
MODNAME=$(echo $fn | sed -r 's/([a-zA-Z_]+)([.]py)?/\1/')
if [ -f $OUTDIR/$MODNAME.html ]; then
# Only make non-dead links
echo "<li><a href=$MODNAME.html>$MODNAME</a></li>" >> $INDEX
fi
done
echo "<li><a href=spec_tools/index.html>spec_tools</a></li>" >> $INDEX
echo "</ul></body></html>" >> $INDEX
# Move index files to a more useful place
rm -rf $OUTDIR/spec_tools
mv $OUTDIR/scripts/spec_tools $OUTDIR/spec_tools
# delete duplicate generated files
rm -rf $OUTDIR/scripts
rm -f scripts/__init__.py
)