aboutsummaryrefslogtreecommitdiffstats
path: root/src/scripts/website.py
diff options
context:
space:
mode:
authorJack Lloyd <[email protected]>2017-09-28 12:26:25 -0400
committerJack Lloyd <[email protected]>2017-09-28 12:26:25 -0400
commita5449f0bc63c96ab6d3c7692bd49a685d2cc36f4 (patch)
treeeae595820fbc48d6b4370b34c05ae523feacfe55 /src/scripts/website.py
parentd848d6ffbaf715c752da93312f2fce395ffc03b3 (diff)
Rewrite website generator script in Python
Diffstat (limited to 'src/scripts/website.py')
-rwxr-xr-xsrc/scripts/website.py141
1 files changed, 141 insertions, 0 deletions
diff --git a/src/scripts/website.py b/src/scripts/website.py
new file mode 100755
index 000000000..cffa570c3
--- /dev/null
+++ b/src/scripts/website.py
@@ -0,0 +1,141 @@
+#!/usr/bin/python
+
+"""
+Generate the Botan website
+
+(C) 2017 Jack Lloyd
+"""
+
+import optparse # pylint: disable=deprecated-module
+import subprocess
+import sys
+import errno
+import shutil
+import tempfile
+import os
+
+def run_and_check(proc, proc_name):
+ (stdout, stderr) = proc.communicate()
+
+ if proc.returncode != 0:
+ print("Error running ", proc_name)
+ print(stdout)
+ print(stderr)
+ sys.exit(1)
+
+def configure_build(botan_dir, build_dir):
+
+ configure = subprocess.Popen([os.path.join(botan_dir, 'configure.py'),
+ '--with-doxygen', '--with-sphinx',
+ '--with-build-dir=%s' % (build_dir)],
+ stdout=subprocess.PIPE,
+ stderr=subprocess.PIPE)
+ run_and_check(configure, 'configure.py')
+
+def run_doxygen(tmp_dir, output_dir):
+ doxygen = subprocess.Popen(['doxygen', os.path.join(tmp_dir, 'build/botan.doxy')],
+ stdout=subprocess.PIPE,
+ stderr=subprocess.PIPE)
+ run_and_check(doxygen, 'doxygen')
+ shutil.move(os.path.join(tmp_dir, 'build/docs/doxygen'), output_dir)
+
+def run_sphinx(botan_dir, tmp_dir, output_dir):
+
+ sphinx_config = os.path.join(botan_dir, 'src/configs/sphinx')
+ sphinx_dir = os.path.join(tmp_dir, 'sphinx')
+ os.mkdir(sphinx_dir)
+
+ shutil.copyfile(os.path.join(botan_dir, 'readme.rst'),
+ os.path.join(sphinx_dir, 'index.rst'))
+
+ for f in ['news.rst', os.path.join('doc', 'security.rst')]:
+ shutil.copy(os.path.join(botan_dir, f), sphinx_dir)
+
+ toc = """.. toctree::
+
+ index
+ news
+ security
+ Users Manual <https://botan.randombit.net/manual>
+ API Reference <https://botan.randombit.net/doxygen>
+"""
+
+ contents_rst = open(os.path.join(sphinx_dir, 'contents.rst'), 'w')
+ contents_rst.write(toc)
+ contents_rst.close()
+
+ sphinx_invoke = ['sphinx-build', '-t', 'website', '-c', sphinx_config, '-b', 'html']
+ sphinx_website = subprocess.Popen(sphinx_invoke + [sphinx_dir, output_dir],
+ stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+ run_and_check(sphinx_website, 'sphinx-build website')
+
+ sphinx_manual = subprocess.Popen(sphinx_invoke + [os.path.join(botan_dir, 'doc/manual'),
+ os.path.join(output_dir, 'manual')],
+ stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+ run_and_check(sphinx_manual, 'sphinx-build manual')
+
+ shutil.rmtree(os.path.join(output_dir, '.doctrees'))
+ shutil.rmtree(os.path.join(output_dir, 'manual', '.doctrees'))
+ os.remove(os.path.join(output_dir, '.buildinfo'))
+ os.remove(os.path.join(output_dir, 'manual', '.buildinfo'))
+
+ # share _static subdirs
+ shutil.rmtree(os.path.join(output_dir, 'manual', '_static'))
+ os.symlink('../_static', os.path.join(output_dir, 'manual', '_static'))
+
+def main(args):
+ parser = optparse.OptionParser()
+
+ parser.add_option('--output-dir', default=None,
+ help="Where to write output")
+
+ (options, args) = parser.parse_args(args)
+
+ output_dir = options.output_dir
+ tmp_dir = tempfile.mkdtemp(prefix='botan_website_')
+
+ # assumes we live in src/scripts
+ botan_dir = os.path.normpath(os.path.join(os.path.dirname(__file__),
+ "..", ".."))
+
+ if os.access(os.path.join(botan_dir, 'configure.py'), os.X_OK) is False:
+ print("Can't find configure.py in %s", botan_dir)
+ sys.exit(1)
+
+ if output_dir is None:
+ cwd = os.getcwd()
+
+ if os.path.basename(cwd) == 'botan-website':
+ output_dir = '.'
+ else:
+ output_dir = os.path.join(cwd, 'botan-website')
+
+ try:
+ os.mkdir(output_dir)
+ except OSError as e:
+ if e.errno == errno.EEXIST:
+ pass
+ else:
+ raise e
+
+ for subdir in ['_static', '_sources', 'doxygen', 'manual']:
+ try:
+ shutil.rmtree(os.path.join(output_dir, subdir))
+ except OSError as e:
+ if e.errno == errno.ENOENT:
+ pass
+ else:
+ print("Error removing dir", e)
+ sys.exit(1)
+
+ configure_build(botan_dir, tmp_dir)
+ run_doxygen(tmp_dir, output_dir)
+ run_sphinx(botan_dir, tmp_dir, output_dir)
+
+ for f in ['doc/pgpkey.txt', 'license.txt']:
+ shutil.copy(os.path.join(botan_dir, f), output_dir)
+
+ shutil.rmtree(tmp_dir)
+
+if __name__ == '__main__':
+ sys.exit(main(sys.argv))