| # 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 |