Implemented archiving of apidocs for all channels

editor/build/build.py

 #!/usr/bin/env python
 #
 # Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 # for details. All rights reserved. Use of this source code is governed by a
 # BSD-style license that can be found in the LICENSE file.
 
 import glob
 import gsutil
 import imp
 import optparse
 import os
 import re
 import shutil
 import stat
 import subprocess
 import sys
 import tempfile
 import zipfile
 import ziputils
 
 from os.path import join
 
 BUILD_OS = None
 DART_PATH = None
 TOOLS_PATH = None
 
-GSU_API_DOCS_PATH = None
-GSU_API_DOCS_BUCKET = 'gs://dartlang-api-docs'
-
 CHANNEL = None
 PLUGINS_BUILD = None
 REVISION = None
 SYSTEM = None
 
 NO_UPLOAD = None
 
 DART_DIR = os.path.abspath(os.path.join(__file__, '..', '..', '..'))
 utils = imp.load_source('utils', os.path.join(DART_DIR, 'tools', 'utils.py'))
 bot_utils = imp.load_source('bot_utils',
@@ skipping 1141 matching lines @@
 def CreateZipWindows(directory, targetFile):
   """zip the given directory into the file - win32 specific"""
   EnsureDirectoryExists(targetFile)
   FileDelete(targetFile)
   ExecuteCommand([join(DART_PATH, 'third_party', '7zip', '7za'), 'a', '-tzip',
                   targetFile,
                   os.path.basename(directory)],
                  os.path.dirname(directory))
 
 
-def UploadDirectory(filesToUpload, gs_dir):
-  Gsutil(['-m', 'cp', '-a', 'public-read', '-r'] + filesToUpload + [gs_dir])
+def UploadApiDocs(dirName):
+  apidocs_namer = bot_utils.GCSNamerApiDocs(CHANNEL)
+  apidocs_destination_gcsdir = apidocs_namer.docs_dirpath(REVISION)
+  apidocs_destination_latestfile = apidocs_namer.docs_latestpath(REVISION)
 
+  # Delete the old revision specific apidocs directory if present.
+  Gsutil(['-m', 'rm', '-R', '-f', apidocs_destination_gcsdir])
 
-def UploadApiDocs(dirName):
-  # create file in dartlang-api-docs/REVISION/index.html
-  # this lets us do the recursive copy in the next step
+  # Upload everything inside the built apidocs directory.
+  Gsutil(['-m', 'cp', '-R', '-a', 'public-read', dirName,
+          apidocs_destination_gcsdir])
 
-  localIndexFile = join(dirName, 'index.html')
-  destIndexFile = GSU_API_DOCS_PATH + '/index.html'
+  # Update latest.txt to contain the newest revision.
+  with utils.TempDir('latest_file') as temp_dir:
+    latest_file = join(temp_dir, 'latest.txt')
+    with open(latest_file, 'w') as f:
+      f.write('%s' % REVISION)
 
-  Gsutil(['cp', '-a', 'public-read', localIndexFile, destIndexFile])
-
-  # copy -R api_docs into dartlang-api-docs/REVISION
-  filesToUpload = glob.glob(join(dirName, '*'))
-  Gsutil(['-m', 'cp', '-q', '-a', 'public-read', '-r'] +
-          filesToUpload + [GSU_API_DOCS_PATH])
-
-  destLatestRevFile = GSU_API_DOCS_BUCKET + '/latest.txt'
-  localLatestRevFilename = join(dirName, 'latest.txt')
-  with open(localLatestRevFilename, 'w+') as f:
-    f.write(REVISION)
-
-  # overwrite dartlang-api-docs/latest.txt to contain REVISION
-  Gsutil(['cp', '-a', 'public-read', localLatestRevFilename,
-          destLatestRevFile])
+    Gsutil(['cp', '-a', 'public-read', latest_file,
+            apidocs_destination_latestfile])
 
 
 def Gsutil(cmd):
   gsutilTool = join(DART_PATH, 'third_party', 'gsutil', 'gsutil')
   ExecuteCommand([sys.executable, gsutilTool] + cmd)
 
 
 def EnsureDirectoryExists(f):
   d = os.path.dirname(f)
   if not os.path.exists(d):
@@ skipping 14 matching lines @@
   """delete the given file - do not re-throw any exceptions that occur"""
   if os.path.exists(f):
     try:
       os.remove(f)
     except OSError:
       print 'error deleting %s' % f
 
 
 if __name__ == '__main__':
   sys.exit(main())