Added a uploadsdk python script.

pkg/docgen/bin/upload_docgen.py

+#!/usr/bin/python
+#
+# Copyright (c) 2012, 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.
+
+""" This file will run docgen.dart on the SDK libraries, and upload them to 
+  Google Cloud Storage for the documentation viewer. 
+"""
+
+import os
+import platform
+import subprocess
+import sys
+sys.path.append(os.path.abspath('../../../tools'))
+import utils
+from upload_sdk import ExecuteCommand
+
+
+DART = os.path.abspath('../../../%s/%s/dart-sdk/bin/dart' 
+    % (utils.BUILD_ROOT[utils.GuessOS()],
+    utils.GetBuildConf('release', utils.GuessArchitecture())))
+GSUTIL = utils.GetBuildbotGSUtilPath()
+GS_SITE = 'gs://dartlang-docgen'
+
+
+def SetGsutil():
+  """ If not on buildbots, find gsutil relative to docgen. """
+  global GSUTIL
+  if not os.path.exists(GSUTIL):
+    GSUTIL = os.path.abspath('../../../third_party/gsutil/gsutil')
+
+
+def Upload(source, target):
+  """ Upload files to Google Storage. """
+  cmd = [GSUTIL, '-m', 'cp', '-q', '-a', 'public-read', '-r', source, target]
+  (status, output) = ExecuteCommand(cmd)
+  return status
+
+
+def main():
+  SetGsutil()
+
+  # Execute Docgen.dart on the SDK.
+  ExecuteCommand([DART, 'docgen.dart', '--parse-sdk'])
+  
+  # Use SVN Revision to get the revision number.
+  revision = utils.GetSVNRevision()
+  if revision is None:
+    raise Exception("Unable to find revision. ")
+
+  # Upload the all files in Docs into a folder based off Revision number on 
+  # Cloud Storage.
+  Upload('./docs/*', GS_SITE + '/' + revision + '/')

[Emily Fortuna, 2013/07/11 20:47:33]

does docgen create the docs directory in whatever the current directory is that
you're standing in when you invoke this script? If not, we might want to switch
these to an absolute path.

+
+  # Update VERSION file in Cloud Storage. 
+  with open('VERSION', 'w') as version_file:
+    version_file.write(revision)
+  Upload('./VERSION', GS_SITE + '/VERSION')
+
+  # Clean up the files it creates. 
+  ExecuteCommand(['rm', '-rf', './docs'])
+  ExecuteCommand(['rm', '-f', './VERSION'])
+
+
+if __name__ == '__main__':
+  main()