Adding upstream version 1:115.7.0.upstream/1%115.7.0upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 166 insertions, 0 deletions

diff --git a/comm/third_party/botan/src/scripts/website.py b/comm/third_party/botan/src/scripts/website.py
new file mode 100755
index 0000000000..e28909531f
--- /dev/null
+++ b/comm/third_party/botan/src/scripts/website.py
@@ -0,0 +1,166 @@
+#!/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(cmd_line, cwd=None):
+    print("Executing %s ..." % (' '.join(cmd_line)))
+
+    proc = subprocess.Popen(cmd_line,
+                            cwd=cwd,
+                            close_fds=True,
+                            stdin=subprocess.PIPE,
+                            stdout=subprocess.PIPE,
+                            stderr=subprocess.PIPE)
+
+    (stdout, stderr) = proc.communicate()
+
+    if proc.returncode != 0:
+        print("Error running %s" % (' '.join(cmd_line)))
+        print(stdout)
+        print(stderr)
+        sys.exit(1)
+
+def rmtree_ignore_missing(path):
+    try:
+        shutil.rmtree(path)
+    except OSError:
+        # check errno?
+        pass
+
+def configure_build(botan_dir, build_dir):
+
+    run_and_check([os.path.join(botan_dir, 'configure.py'),
+                   '--with-doxygen', '--with-sphinx',
+                   '--with-build-dir=%s' % (build_dir)])
+
+def run_doxygen(tmp_dir, output_dir):
+    run_and_check(['doxygen', os.path.join(tmp_dir, 'build/botan.doxy')])
+    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
+   User Guide <https://botan.randombit.net/handbook>
+   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']
+
+    handbook_dir = os.path.join(botan_dir, 'doc')
+
+    run_and_check(sphinx_invoke + [sphinx_dir, output_dir])
+    run_and_check(sphinx_invoke + [handbook_dir, os.path.join(output_dir, 'handbook')])
+
+    rmtree_ignore_missing(os.path.join(output_dir, '.doctrees'))
+    rmtree_ignore_missing(os.path.join(output_dir, 'handbook', '.doctrees'))
+    os.remove(os.path.join(output_dir, '.buildinfo'))
+    os.remove(os.path.join(output_dir, 'handbook', '.buildinfo'))
+
+    # share _static subdirs
+    shutil.rmtree(os.path.join(output_dir, 'handbook', '_static'))
+    os.symlink('../_static', os.path.join(output_dir, 'handbook', '_static'))
+
+    # Build PDF
+    latex_output = os.path.join(tmp_dir, 'latex')
+    run_and_check(['sphinx-build', '-c', sphinx_config, '-b', 'latex', handbook_dir, latex_output])
+
+    # Have to run twice because TeX
+    run_and_check(['pdflatex', 'botan.tex'], cwd=latex_output)
+    run_and_check(['pdflatex', 'botan.tex'], cwd=latex_output)
+
+    shutil.copy(os.path.join(latex_output, 'botan.pdf'),
+                os.path.join(output_dir, 'handbook'))
+
+
+def main(args):
+    parser = optparse.OptionParser()
+
+    parser.add_option('-o', '--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)
+        return 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', 'handbook']:
+        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)
+                return 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)
+
+    favicon = open(os.path.join(output_dir, 'favicon.ico'), 'w')
+    # Create an empty favicon.ico file so it gets cached by browsers
+    favicon.close()
+
+    shutil.rmtree(tmp_dir)
+
+    return 0
+
+if __name__ == '__main__':
+    sys.exit(main(sys.argv))