From 8650c57ccd6146971d1ee8a68ca8d8f881cfafef Mon Sep 17 00:00:00 2001
From: Victor Zverovich <victor.zverovich@gmail.com>
Date: Thu, 26 May 2016 08:00:41 -0700
Subject: [PATCH] Reuse virtualenv to speed up builds

---
 doc/build.py              |  9 ++++-----
 support/update-website.py | 15 +++++++++------
 2 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/doc/build.py b/doc/build.py
index 40956571..dfa124f1 100755
--- a/doc/build.py
+++ b/doc/build.py
@@ -15,11 +15,11 @@ def pip_install(package, commit=None, **kwargs):
 
 def create_build_env(dirname='virtualenv'):
   # Create virtualenv.
-  check_call(['virtualenv', dirname])
+  if not os.path.exists(dirname):
+    check_call(['virtualenv', dirname])
   import sysconfig
   scripts_dir = os.path.basename(sysconfig.get_path('scripts'))
-  activate_this_file = os.path.join(dirname, scripts_dir,
-                                    'activate_this.py')
+  activate_this_file = os.path.join(dirname, scripts_dir, 'activate_this.py')
   with open(activate_this_file) as f:
     exec(f.read(), dict(__file__=activate_this_file))
   # Upgrade pip because installation of sphinx with pip 1.1 available on Travis
@@ -39,8 +39,7 @@ def create_build_env(dirname='virtualenv'):
   except DistributionNotFound:
     pass
   # Install Sphinx and Breathe.
-  pip_install('sphinx-doc/sphinx',
-              '12b83372ac9316e8cbe86e7fed889296a4cc29ee',
+  pip_install('sphinx-doc/sphinx', '12b83372ac9316e8cbe86e7fed889296a4cc29ee',
               check_version='1.4.1.dev20160525')
   pip_install('michaeljones/breathe',
               '6b1c5bb7a1866f15fc328b8716258354b10c1daa')
diff --git a/support/update-website.py b/support/update-website.py
index da90dea4..416f49be 100755
--- a/support/update-website.py
+++ b/support/update-website.py
@@ -26,12 +26,15 @@ class Git:
 fmt_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
 sys.path.insert(0, os.path.join(fmt_dir, 'doc'))
 
-workdir = tempfile.mkdtemp('fmt')
+work_dir = tempfile.mkdtemp('fmt')
 try:
   import build
-  build.create_build_env(os.path.join(workdir, 'virtualenv'))
+  # The virtualenv is stored in ~/.cache/fmt/virtualenv and reused to speed
+  # up builds.
+  build.create_build_env(os.path.join(
+    os.path.expanduser('~'), '.cache', 'fmt', 'virtualenv'))
 
-  fmt_repo = Git(os.path.join(workdir, 'fmt'))
+  fmt_repo = Git(os.path.join(work_dir, 'fmt'))
   fmt_repo.clone('git@github.com:fmtlib/fmt')
   doc_repo = Git('fmtlib.github.io')
   doc_repo.clone('git@github.com:fmtlib/fmtlib.github.io')
@@ -68,7 +71,8 @@ try:
       with open(reference, 'w') as f:
         f.write(data)
     # Build the docs.
-    build.build_docs(version, doc_dir=target_doc_dir, include_dir=fmt_repo.dir)
+    build.build_docs(version, doc_dir=target_doc_dir, include_dir=fmt_repo.dir,
+                     work_dir=work_dir)
     # Create symlinks for older versions.
     for link, target in {'index': 'contents', 'api': 'reference'}.items():
       os.symlink(target + '.html', os.path.join('html', link) + '.html')
@@ -76,8 +80,7 @@ try:
     version_doc_dir = os.path.join(doc_repo.dir, version)
     shutil.rmtree(version_doc_dir)
     shutil.move('html', version_doc_dir)
-    # TODO: generate 'html' in temp dir
     # TODO: update links in navbar
     # TODO: remove doc repo
 except:
-  shutil.rmtree(workdir)
+  shutil.rmtree(work_dir)