Added gsutil to depot tools

third_party/gsutil/gslib/exception.py

+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish, dis-
+# tribute, sublicense, and/or sell copies of the Software, and to permit
+# persons to whom the Software is furnished to do so, subject to the fol-
+# lowing conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
+# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+# IN THE SOFTWARE.
+
+"""gsutil exceptions."""
+
+
+class AbortException(StandardError):
+  """Exception raised when a user aborts a command that needs to do cleanup."""
+
+  def __init__(self, reason):
+    StandardError.__init__(self)
+    self.reason = reason
+
+  def __repr__(self):
+    return 'AbortException: %s' % self.reason
+
+  def __str__(self):
+    return 'AbortException: %s' % self.reason
+
+
+class CommandException(StandardError):
+  """Exception raised when a problem is encountered running a gsutil command.
+
+  This exception should be used to signal user errors or system failures
+  (like timeouts), not bugs (like an incorrect param value). For the
+  latter you should raise Exception so we can see where/how it happened
+  via gsutil -D (which will include a stack trace for raised Exceptions).
+  """
+
+  def __init__(self, reason, informational=False):
+    """Instantiate a CommandException.
+
+    Args:
+      reason: Text describing the problem.
+      informational: Indicates reason should be printed as FYI, not a failure.
+    """
+    StandardError.__init__(self)
+    self.reason = reason
+    self.informational = informational
+
+  def __repr__(self):
+    return 'CommandException: %s' % self.reason
+
+  def __str__(self):
+    return 'CommandException: %s' % self.reason
+
+
+class ProjectIdException(StandardError):
+
+  def __init__(self, reason):
+    StandardError.__init__(self)
+    self.reason = reason
+
+  def __repr__(self):
+    return 'ProjectIdException: %s' % self.reason
+
+  def __str__(self):
+    return 'ProjectIdException: %s' % self.reason