fmt/doc/build.py

59 lines
2.1 KiB
Python
Raw Normal View History

#!/usr/bin/env python
# Build the documentation.
from __future__ import print_function
import os, shutil, tempfile
2015-05-19 15:13:13 +00:00
from subprocess import check_call, check_output, Popen, PIPE
def pip_install(package, commit=None):
"Install package using pip."
if commit:
2015-05-19 15:13:13 +00:00
if check_output(['pip', 'show', package.split('/')[1]]):
return # Already installed
package = 'git+git://github.com/{0}.git@{1}'.format(package, commit)
check_call(['pip', 'install', '-q', package])
def build_docs(workdir, travis):
# Create virtualenv.
virtualenv_dir = os.path.join(workdir, 'virtualenv')
check_call(['virtualenv', virtualenv_dir])
activate_this_file = os.path.join(virtualenv_dir, 'bin', 'activate_this.py')
execfile(activate_this_file, dict(__file__=activate_this_file))
2015-05-19 15:13:13 +00:00
# Install Sphinx and Breathe.
pip_install('sphinx==1.3.1')
pip_install('michaeljones/breathe', '18bd461b4e29dde0adf5df4b3da7e5473e2c2983')
# Build docs.
2015-05-19 15:13:13 +00:00
doc_dir = os.path.dirname(os.path.realpath(__file__))
p = Popen(['doxygen', '-'], stdin=PIPE)
p.communicate(input=r'''
PROJECT_NAME = C++ Format
GENERATE_LATEX = NO
GENERATE_MAN = NO
GENERATE_RTF = NO
CASE_SENSE_NAMES = NO
INPUT = {0}/format.h
QUIET = YES
JAVADOC_AUTOBRIEF = YES
AUTOLINK_SUPPORT = NO
GENERATE_HTML = NO
GENERATE_XML = YES
XML_OUTPUT = doxyxml
ALIASES = "rst=\verbatim embed:rst"
ALIASES += "endrst=\endverbatim"
PREDEFINED = _WIN32=1 \
FMT_USE_VARIADIC_TEMPLATES=1 \
FMT_USE_RVALUE_REFERENCES=1
EXCLUDE_SYMBOLS = fmt::internal::* StringValue write_str
'''.format(os.path.dirname(doc_dir)))
if p.returncode != 0:
return p.returncode
check_call(['sphinx-build',
'-D', "breathe_projects.format=" + os.path.join(os.getcwd(), "doxyxml"),
'-b', 'html', doc_dir, 'html'])
return 0
returncode = 1
travis = 'TRAVIS' in os.environ
returncode = build_docs('', travis=travis)
exit(returncode)