Roll multiple files from depot_tools into luci.

appengine/third_party_local/depot_tools/subprocess2.py

 # coding=utf8
 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 """Collection of subprocess wrapper functions.
 
 In theory you shouldn't need anything else in subprocess, or this module failed.
 """
 
 import cStringIO
@@ skipping 16 matching lines @@
 TIMED_OUT = -2001
 
 # Globals.
 # Set to True if you somehow need to disable this hack.
 SUBPROCESS_CLEANUP_HACKED = False
 
 
 class CalledProcessError(subprocess.CalledProcessError):
   """Augment the standard exception with more data."""
   def __init__(self, returncode, cmd, cwd, stdout, stderr):
-    super(CalledProcessError, self).__init__(returncode, cmd)
-    self.stdout = stdout
+    super(CalledProcessError, self).__init__(returncode, cmd, output=stdout)
+    self.stdout = self.output  # for backward compatibility.
     self.stderr = stderr
     self.cwd = cwd
 
   def __str__(self):
     out = 'Command %s returned non-zero exit status %s' % (
         ' '.join(self.cmd), self.returncode)
     if self.cwd:
       out += ' in ' + self.cwd
     return '\n'.join(filter(None, (out, self.stdout, self.stderr)))
 
@@ skipping 191 matching lines @@
         # Convert fork() emulation failure into a CygwinRebaseError().
         raise CygwinRebaseError(
             e.errno,
             args,
             kwargs.get('cwd'),
             None,
             'Visit '
             'http://code.google.com/p/chromium/wiki/CygwinDllRemappingFailure '
             'to learn how to fix this error; you need to rebase your cygwin '
             'dlls')
-      # Popen() can throw OSError when cwd or args[0] doesn't exist. Let it go
-      # through
-      raise
+      # Popen() can throw OSError when cwd or args[0] doesn't exist.
+      raise OSError('Execution failed with error: %s.\n'
+                    'Check that %s or %s exist and have execution permission.'
+                    % (str(e), kwargs.get('cwd'), args[0]))
 
   def _tee_threads(self, input):  # pylint: disable=W0622
     """Does I/O for a process's pipes using threads.
 
     It's the simplest and slowest implementation. Expect very slow behavior.
 
     If there is a callback and it doesn't keep up with the calls, the timeout
     effectiveness will be delayed accordingly.
     """
     # Queue of either of <threadname> when done or (<threadname>, data).  In
@@ skipping 240 matching lines @@
 
   Captures stdout of a process call and returns stdout only.
 
   - Throws if return code is not 0.
   - Works even prior to python 2.7.
   - Blocks stdin by default if not specified since no output will be visible.
   - As per doc, "The stdout argument is not allowed as it is used internally."
   """
   kwargs.setdefault('stdin', VOID)
   if 'stdout' in kwargs:
-    raise ValueError('stdout argument not allowed, it will be overridden.')
+    raise ValueError('stdout argument not allowed, it would be overridden.')
   return check_call_out(args, stdout=PIPE, **kwargs)[0]