1 # Copyright 2013 GRNET S.A. All rights reserved.
3 # Redistribution and use in source and binary forms, with or
4 # without modification, are permitted provided that the following
7 # 1. Redistributions of source code must retain the above
8 # copyright notice, this list of conditions and the following
11 # 2. Redistributions in binary form must reproduce the above
12 # copyright notice, this list of conditions and the following
13 # disclaimer in the documentation and/or other materials
14 # provided with the distribution.
16 # THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
17 # OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18 # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19 # PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
20 # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
23 # USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
24 # AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
26 # ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27 # POSSIBILITY OF SUCH DAMAGE.
29 # The views and conclusions contained in the software and
30 # documentation are those of the authors and should not be
31 # interpreted as representing official policies, either expressed
32 # or implied, of GRNET S.A.
34 from kamaki.cli.logger import get_logger
36 log = get_logger('kamaki.cli')
39 class CLIError(Exception):
41 def __init__(self, message, details=[], importance=0):
43 @message is the main message of the Error
44 @detauls is a list of previous errors
45 @importance of the output for the user
46 Suggested values: 0, 1, 2, 3
48 message += '' if message and message[-1] == '\n' else '\n'
49 super(CLIError, self).__init__(message)
50 self.details = list(details) if isinstance(details, list)\
51 else [] if details is None else ['%s' % details]
53 self.importance = int(importance)
58 class CLIUnimplemented(CLIError):
61 message='I \'M SORRY, DAVE.\nI \'M AFRAID I CAN\'T DO THAT.',
71 super(CLIUnimplemented, self).__init__(message, details, importance)
74 class CLIBaseUrlError(CLIError):
75 def __init__(self, message='', details=[], importance=2, service=None):
76 message = message or 'No URL for %s' % service.lower()
77 details = details or [
78 'Two options to resolve this:',
79 '(Use the correct cloud name, instead of "default")',
80 'A. (recommended) Let kamaki discover the endpoint URLs for all',
81 'services by setting a single Authentication URL and token:',
82 ' /config set cloud.default.url <AUTH_URL>',
83 ' /config set cloud.default.token <t0k3n>',
84 'B. (advanced users) Explicitly set a valid %s endpoint URL' % (
86 'Note: URL option has a higher priority, so delete it to',
88 ' /config delete cloud.default.url',
89 ' /config set cloud.%s.url <%s_URL>' % (
90 service, service.upper())]
91 super(CLIBaseUrlError, self).__init__(message, details, importance)
94 class CLISyntaxError(CLIError):
95 def __init__(self, message='Syntax Error', details=[], importance=1):
96 super(CLISyntaxError, self).__init__(message, details, importance)
99 class CLIUnknownCommand(CLIError):
100 def __init__(self, message='Unknown Command', details=[], importance=1):
101 super(CLIUnknownCommand, self).__init__(message, details, importance)
104 class CLICmdSpecError(CLIError):
106 self, message='Command Specification Error',
107 details=[], importance=0):
108 super(CLICmdSpecError, self).__init__(message, details, importance)
111 class CLICmdIncompleteError(CLICmdSpecError):
113 self, message='Incomplete Command Error',
114 details=[], importance=1):
115 super(CLICmdSpecError, self).__init__(message, details, importance)
118 def raiseCLIError(err, message='', importance=0, details=[]):
120 :param err: (Exception) the original error message, if None, a new
121 CLIError is born which is conceptually bind to raiser
123 :param message: (str) a custom error message that overrides err's
125 :param importance: (int) instruction to called application (e.g. for
126 coloring printed error messages)
128 :param details: (list) various information on the error
130 :raises CLIError: it is the purpose of this method
132 from traceback import format_stack
134 stack = ['%s' % type(err)] if err else ['<kamaki.cli.errors.CLIError>']
135 stack += format_stack()
137 stack = [e for e in stack if e != stack[1]]
139 log.debug('\n < '.join(stack))
141 details = ['%s' % details] if not isinstance(details, list)\
143 details += getattr(err, 'details', [])
147 origerr = origerr if origerr else '%s' % type(err)
151 message = '%s' % (message if message else origerr)
154 status = err.status or err.errno
155 except AttributeError:
158 if origerr not in details + [message]:
159 details.append(origerr)
161 message += '' if message and message[-1] == '\n' else '\n'
163 message = '(%s) %s' % (err.status, message)
165 status = int(err.status)
167 raise CLIError(message, details, importance)
168 importance = importance if importance else status // 100
169 importance = getattr(err, 'importance', importance)
170 raise CLIError(message, details, importance)