-
Notifications
You must be signed in to change notification settings - Fork 3
/
build_docs.py
86 lines (75 loc) · 1.77 KB
/
build_docs.py
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
# coding: utf-8
"""Get all tagged releases and build the documentation.
"""
import subprocess
import json
import os
import glob
git_tag = subprocess.run(
" ".join(["git", "tag", "--list", "v*.*.*", "--sort=version:refname"]),
capture_output=True,
text=True,
shell=True,
)
my_env = os.environ.copy()
tags = git_tag.stdout.splitlines()
versions = [
{
"name": "latest",
"version": "latest",
"url": "https://sandialabs.github.io/sansmic/",
"preferred": True,
}
]
for tag in tags:
versions.append(
dict(
name=tag,
version=tag,
url="https://sandialabs.github.io/sansmic/" + tag + "/",
preferred=False,
)
)
with open(
os.path.abspath(os.path.join(".", "docs", "_static", "switcher.json")), "w"
) as fswitch:
json.dump(versions, fswitch)
my_env["SANSMIC_SPHINX_VERSION"] = "latest"
subprocess.run(
" ".join(
[
"sphinx-build",
"-b",
"html",
"docs/",
"docs/_build/html",
]
),
shell=True,
env=my_env,
)
os.remove(os.path.abspath(os.path.join(".", "docs", "_static", "switcher.json")))
for tag in tags:
os.environ["VERSION_INFO"] = repr(tag)
my_env["SANSMIC_SPHINX_VERSION"] = tag
subprocess.run("git checkout " + tag, shell=True)
subprocess.run(
"git checkout main -- docs/conf.py",
shell=True,
)
files = glob.glob("./docs/apidocs/*.rst")
for f in files:
os.remove(f)
subprocess.run(
" ".join(
[
"sphinx-build",
"-b",
"html",
"docs/",
"docs/_build/html/" + tag,
]
),
shell=True,
env=my_env,
)