Add annotated steps script for validating that the version on dev and stable is always increasing w…

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 string
@@ skipping 246 matching lines @@
         'win32': r'e:\b\build\site_config\.boto',
       }[utils.GuessOS()]
       env['AWS_CREDENTIAL_FILE'] = boto_config
       env['BOTO_CONFIG'] = boto_config
 
     if GSUtil.GSUTIL_IS_SHELL_SCRIPT:
       gsutil_command = [GSUtil.GSUTIL_PATH]
     else:
       gsutil_command = [sys.executable, GSUtil.GSUTIL_PATH]
 
-    run(gsutil_command + gsutil_args, env=env,
-        shell=(GSUtil.GSUTIL_IS_SHELL_SCRIPT and sys.platform == 'win32'))
+    return run(gsutil_command + gsutil_args, env=env,
+               shell=(GSUtil.GSUTIL_IS_SHELL_SCRIPT and
+                      sys.platform == 'win32'))
 
   def upload(self, local_path, remote_path, recursive=False, public=False):
     assert remote_path.startswith('gs://')
 
     args = ['cp']
     if public:
       args += ['-a', 'public-read']
     if recursive:
       args += ['-R']
     args += [local_path, remote_path]
     self.execute(args)
 
+  def cat(self, remote_path):
+    assert remote_path.startswith('gs://')
+
+    args = ['cat', remote_path]
+    (stdout, _, _) = self.execute(args)
+    return stdout
+
   def setGroupReadACL(self, remote_path, group):
     args = ['acl', 'ch', '-g', '%s:R' % group, remote_path]
     self.execute(args)
 
   def setContentType(self, remote_path, content_type):
     args = ['setmeta', '-h', 'Content-Type:%s' % content_type, remote_path]
     self.execute(args)
 
   def remove(self, remote_path, recursive=False):
     assert remote_path.startswith('gs://')
@@ skipping 30 matching lines @@
 
   return checksum_filename
 
 def GetChannelFromName(name):
   """Get the channel from the name. Bleeding edge builders don't 
       have a suffix."""
   channel_name = string.split(name, '-').pop()
   if channel_name in Channel.ALL_CHANNELS:
     return channel_name
   return Channel.BLEEDING_EDGE