Change promote script to be able to archive to the new gs://dart-archive/ location

tools/bots/bot_utils.py

 #!/usr/bin/env 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.
 
 import hashlib
 import imp
 import os
 import subprocess
@@ skipping 42 matching lines @@
   SIGNED = 'signed'
   RELEASE = 'release'
   ALL_TYPES = [RAW, SIGNED, RELEASE]
 
 class Mode(object):
   RELEASE = 'release'
   DEBUG = 'debug'
   ALL_MODES = [RELEASE, DEBUG]
 
 class GCSNamer(object):
+  """
+  This class is used for naming objects in our "gs://dart-archive/"
+  GoogleCloudStorage bucket. It's structure is as follows:
+
+  For every (channel,revision,release-type) tuple we have a base path:
+
+    gs://dart-archive/channels/{be,dev,stable}
+                     /{raw,signed,release}/{revision,latest}/
+
+  Under every base path, the following structure is used:
+    - /VERSION
+    - /api-docs/dart-api-docs.zip
+    - /dartium/{chromedriver,content_shell,dartium}
+         -{linux,macos,windows}-{ia32,x64}-release.zip
+    - /sdk/dartsdk-{linux,macos,windows}-{ia32,x64}-release.zip
+    - /editor/darteditor-{linux,macos,windows}-{ia32,x64}.zip
+    - /editor-eclipse-update
+         /{index.html,features/,plugins/,artifacts.jar,content.jar}
+  """
   def __init__(self, channel=Channel.BLEEDING_EDGE,
       release_type=ReleaseType.RAW):
-    assert channel in Channel.ALL_CHANNELS 
+    assert channel in Channel.ALL_CHANNELS
     assert release_type in ReleaseType.ALL_TYPES
 
     self.channel = channel
     self.release_type = release_type
     self.bucket = 'gs://dart-archive'
 
   # Functions for quering complete gs:// filepaths
 
   def version_filepath(self, revision):
     return '%s/channels/%s/%s/%s/VERSION' % (self.bucket, self.channel,
@@ skipping 150 matching lines @@
   if not mangled_filename:
     mangled_filename = os.path.basename(filename)
 
   checksum = CalculateChecksum(filename)
   checksum_filename = '%s.md5sum' % filename
 
   with open(checksum_filename, 'w') as f:
     f.write('%s *%s' % (checksum, mangled_filename))
 
   return checksum_filename