Added a uploadsdk python script.

pkg/docgen/bin/uploadsdk.py

+#!/usr/bin/python

[Emily Fortuna, 2013/07/11 18:40:37]

nit: can we call this file something like upload_docgen.py or something a little
bit more specific?

[janicejl, 2013/07/11 20:44:28]

Done.

+#
+# 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 os.path

[Emily Fortuna, 2013/07/11 18:40:37]

this line is unnecessary. since you already import os, and you always call
os.path.foo

[janicejl, 2013/07/11 20:44:28]

Done.

+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():
+  global GSUTIL

[Emily Fortuna, 2013/07/11 18:40:37]

I'd but the global declaration below the doc comment string.

[janicejl, 2013/07/11 20:44:28]

Done.

+  """ If not on buildbots, find gsutil relative to docgen. """
+  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. """

[Emily Fortuna, 2013/07/11 18:40:37]

For just regular line comments, use the #. the triple quote is the equivalent of
/// or /** */ in Dart

[janicejl, 2013/07/11 20:44:28]

Done.

+  ExecuteCommand([DART, 'docgen.dart', '--include-private', '--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 + '/')
+
+  """ Update VERSION file in Cloud Storage. """ 
+  with open('VERSION', 'w') as version_file:
+    version_file.write(revision)
+  Upload('./VERSION', GS_SITE + '/VERSION')
+
+
+if __name__ == '__main__':
+  main()