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
|
# -*- coding: utf-8 -*-
import os, shutil, sys
puddlestuff_dir = os.path.join(
os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "source"
)
sys.path.insert(0, puddlestuff_dir)
import puddlestuff
version = puddlestuff.version_string
from glob import glob
from subprocess import call
RST_BASE = "puddletag-docs-rst-" + version
HTML_BASE = "puddletag-docs-html-" + version
def rst_docs(base=RST_BASE, outputdir=None):
images = glob("_build/puddletag-docs-html-" + version + "/_images/*.png")
basenames = set(map(os.path.basename, images))
out_dir = os.path.join("/tmp/", base)
if os.path.exists(out_dir):
shutil.rmtree(out_dir)
if not os.path.exists(out_dir):
os.makedirs(out_dir)
for fn in [
"docs.txt",
"about.txt",
"subs.txt",
"conf.py",
"Makefile",
"INSTALL",
"changelog",
]:
shutil.copy(fn, out_dir)
source_dir = os.path.join(out_dir, "source")
if not os.path.exists(source_dir):
os.makedirs(source_dir)
template_dir = os.path.join(out_dir, "_templates")
if not os.path.exists(template_dir):
os.makedirs(template_dir)
shutil.copytree("_templates/offline", os.path.join(template_dir, "offline"))
for f in glob("source/*.txt") + glob("source/*.tar.gz"):
shutil.copy(f, source_dir)
for f in glob("source/*/*.png"):
if os.path.basename(f) not in basenames:
continue
dirname = os.path.join(out_dir, os.path.dirname(f))
if not os.path.exists(dirname):
os.makedirs(dirname)
shutil.copy(f, os.path.join(dirname, os.path.basename(f)))
curdir = os.path.abspath(".")
os.chdir(os.path.dirname(out_dir))
outputdir = outputdir if outputdir else curdir
call(
[
"tar",
"--bzip2",
"-c",
"-f",
os.path.join(outputdir, base + ".tar.bz2"),
os.path.basename(out_dir),
]
)
os.chdir(curdir)
def html_docs(basename=HTML_BASE, outputdir=None):
if os.path.exists("_build"):
shutil.rmtree("_build")
call(["make", "documentation"])
shutil.rmtree("_build/documentation/_sources")
os.remove("_build/documentation/.buildinfo")
out_dir = "_build/" + basename
os.rename("_build/documentation", out_dir)
curdir = os.path.abspath(".")
if outputdir is None:
outputdir = curdir
os.chdir("_build")
call(
[
"tar",
"--bzip2",
"-c",
"-f",
os.path.join(outputdir, basename + ".tar.bz2"),
os.path.basename(out_dir),
]
)
os.chdir(curdir)
if __name__ == "__main__":
outputdir = sys.argv[1] if len(sys.argv) > 1 else None
html_docs(outputdir=outputdir)
rst_docs(outputdir=outputdir)
|
