/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/errors.py

First attempt to merge .dev and resolve the conflicts (but tests are 
failing)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006 Canonical
 
1
# Copyright (C) 2005, 2006, 2007, 2008 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
"""Exceptions for bzr, and reporting of them.
18
 
 
19
 
There are 3 different classes of error:
20
 
 
21
 
 * KeyboardInterrupt, and OSError with EPIPE - the program terminates 
22
 
   with an appropriate short message
23
 
 
24
 
 * User errors, indicating a problem caused by the user such as a bad URL.
25
 
   These are printed in a short form.
26
 
 
27
 
 * Internal unexpected errors, including most Python builtin errors
28
 
   and some raised from inside bzr.  These are printed with a full 
29
 
   traceback and an invitation to report the bug.
30
 
 
31
 
Exceptions are caught at a high level to report errors to the user, and
32
 
might also be caught inside the program.  Therefore it needs to be
33
 
possible to convert them to a meaningful string, and also for them to be
34
 
interrogated by the program.
35
 
 
36
 
Exceptions are defined such that the arguments given to the constructor
37
 
are stored in the object as properties of the same name.  When the
38
 
object is printed as a string, the doc string of the class is used as
39
 
a format string with the property dictionary available to it.
40
 
 
41
 
This means that exceptions can used like this:
42
 
 
43
 
>>> import sys
44
 
>>> try:
45
 
...   raise NotBranchError(path='/foo/bar')
46
 
... except:
47
 
...   print sys.exc_type
48
 
...   print sys.exc_value
49
 
...   path = getattr(sys.exc_value, 'path', None)
50
 
...   if path is not None:
51
 
...     print path
52
 
bzrlib.errors.NotBranchError
53
 
Not a branch: /foo/bar
54
 
/foo/bar
55
 
 
56
 
Therefore:
57
 
 
58
 
 * create a new exception class for any class of error that can be
59
 
   usefully distinguished.  If no callers are likely to want to catch
60
 
   one but not another, don't worry about them.
61
 
 
62
 
 * the __str__ method should generate something useful; BzrError provides
63
 
   a good default implementation
64
 
 
65
 
Exception strings should start with a capital letter and should not have a
66
 
final fullstop.
67
18
"""
68
19
 
69
 
from warnings import warn
70
 
 
71
 
from bzrlib.patches import (PatchSyntax, 
72
 
                            PatchConflict, 
73
 
                            MalformedPatchHeader,
74
 
                            MalformedHunkHeader,
75
 
                            MalformedLine,)
76
 
 
77
 
 
78
 
# based on Scott James Remnant's hct error classes
 
20
 
 
21
from bzrlib import (
 
22
    osutils,
 
23
    symbol_versioning,
 
24
    )
 
25
from bzrlib.patches import (
 
26
    MalformedHunkHeader,
 
27
    MalformedLine,
 
28
    MalformedPatchHeader,
 
29
    PatchConflict,
 
30
    PatchSyntax,
 
31
    )
 
32
 
79
33
 
80
34
# TODO: is there any value in providing the .args field used by standard
81
35
# python exceptions?   A list of values with no names seems less useful 
85
39
# constructed to make sure it will succeed.  But that says nothing about
86
40
# exceptions that are never raised.
87
41
 
88
 
# TODO: Convert all the other error classes here to BzrNewError, and eliminate
89
 
# the old one.
90
 
 
91
 
# TODO: The pattern (from hct) of using classes docstrings as message
92
 
# templates is cute but maybe not such a great idea - perhaps should have a
93
 
# separate static message_template.
 
42
# TODO: selftest assertRaises should probably also check that every error
 
43
# raised can be formatted as a string successfully, and without giving
 
44
# 'unprintable'.
 
45
 
 
46
 
 
47
# return codes from the bzr program
 
48
EXIT_OK = 0
 
49
EXIT_ERROR = 3
 
50
EXIT_INTERNAL_ERROR = 4
94
51
 
95
52
 
96
53
class BzrError(StandardError):
 
54
    """
 
55
    Base class for errors raised by bzrlib.
 
56
 
 
57
    :cvar internal_error: if True this was probably caused by a bzr bug and
 
58
    should be displayed with a traceback; if False (or absent) this was
 
59
    probably a user or environment error and they don't need the gory details.
 
60
    (That can be overridden by -Derror on the command line.)
 
61
 
 
62
    :cvar _fmt: Format string to display the error; this is expanded
 
63
    by the instance's dict.
 
64
    """
97
65
    
98
 
    is_user_error = True
 
66
    internal_error = False
 
67
 
 
68
    def __init__(self, msg=None, **kwds):
 
69
        """Construct a new BzrError.
 
70
 
 
71
        There are two alternative forms for constructing these objects.
 
72
        Either a preformatted string may be passed, or a set of named
 
73
        arguments can be given.  The first is for generic "user" errors which
 
74
        are not intended to be caught and so do not need a specific subclass.
 
75
        The second case is for use with subclasses that provide a _fmt format
 
76
        string to print the arguments.  
 
77
 
 
78
        Keyword arguments are taken as parameters to the error, which can 
 
79
        be inserted into the format string template.  It's recommended 
 
80
        that subclasses override the __init__ method to require specific 
 
81
        parameters.
 
82
 
 
83
        :param msg: If given, this is the literal complete text for the error,
 
84
        not subject to expansion.
 
85
        """
 
86
        StandardError.__init__(self)
 
87
        if msg is not None:
 
88
            # I was going to deprecate this, but it actually turns out to be
 
89
            # quite handy - mbp 20061103.
 
90
            self._preformatted_string = msg
 
91
        else:
 
92
            self._preformatted_string = None
 
93
            for key, value in kwds.items():
 
94
                setattr(self, key, value)
 
95
 
 
96
    def _format(self):
 
97
        s = getattr(self, '_preformatted_string', None)
 
98
        if s is not None:
 
99
            # contains a preformatted message
 
100
            return s
 
101
        try:
 
102
            fmt = self._get_format_string()
 
103
            if fmt:
 
104
                d = dict(self.__dict__)
 
105
                # special case: python2.5 puts the 'message' attribute in a
 
106
                # slot, so it isn't seen in __dict__
 
107
                d['message'] = getattr(self, 'message', 'no message')
 
108
                s = fmt % d
 
109
                # __str__() should always return a 'str' object
 
110
                # never a 'unicode' object.
 
111
                return s
 
112
        except (AttributeError, TypeError, NameError, ValueError, KeyError), e:
 
113
            return 'Unprintable exception %s: dict=%r, fmt=%r, error=%r' \
 
114
                % (self.__class__.__name__,
 
115
                   self.__dict__,
 
116
                   getattr(self, '_fmt', None),
 
117
                   e)
 
118
 
 
119
    def __unicode__(self):
 
120
        u = self._format()
 
121
        if isinstance(u, str):
 
122
            # Try decoding the str using the default encoding.
 
123
            u = unicode(u)
 
124
        elif not isinstance(u, unicode):
 
125
            # Try to make a unicode object from it, because __unicode__ must
 
126
            # return a unicode object.
 
127
            u = unicode(u)
 
128
        return u
99
129
    
100
130
    def __str__(self):
101
 
        # XXX: Should we show the exception class in 
102
 
        # exceptions that don't provide their own message?  
103
 
        # maybe it should be done at a higher level
104
 
        ## n = self.__class__.__name__ + ': '
105
 
        n = ''
106
 
        if len(self.args) == 1:
107
 
            return str(self.args[0])
108
 
        elif len(self.args) == 2:
109
 
            # further explanation or suggestions
110
 
            try:
111
 
                return n + '\n  '.join([self.args[0]] + self.args[1])
112
 
            except TypeError:
113
 
                return n + "%r" % self
 
131
        s = self._format()
 
132
        if isinstance(s, unicode):
 
133
            s = s.encode('utf8')
114
134
        else:
115
 
            return n + `self.args`
 
135
            # __str__ must return a str.
 
136
            s = str(s)
 
137
        return s
 
138
 
 
139
    def _get_format_string(self):
 
140
        """Return format string for this exception or None"""
 
141
        fmt = getattr(self, '_fmt', None)
 
142
        if fmt is not None:
 
143
            return fmt
 
144
        fmt = getattr(self, '__doc__', None)
 
145
        if fmt is not None:
 
146
            symbol_versioning.warn("%s uses its docstring as a format, "
 
147
                    "it should use _fmt instead" % self.__class__.__name__,
 
148
                    DeprecationWarning)
 
149
            return fmt
 
150
        return 'Unprintable exception %s: dict=%r, fmt=%r' \
 
151
            % (self.__class__.__name__,
 
152
               self.__dict__,
 
153
               getattr(self, '_fmt', None),
 
154
               )
 
155
 
 
156
    def __eq__(self, other):
 
157
        if self.__class__ != other.__class__:
 
158
            return NotImplemented
 
159
        return self.__dict__ == other.__dict__
 
160
 
 
161
 
 
162
class InternalBzrError(BzrError):
 
163
    """Base class for errors that are internal in nature.
 
164
 
 
165
    This is a convenience class for errors that are internal. The
 
166
    internal_error attribute can still be altered in subclasses, if needed.
 
167
    Using this class is simply an easy way to get internal errors.
 
168
    """
 
169
 
 
170
    internal_error = True
116
171
 
117
172
 
118
173
class BzrNewError(BzrError):
119
 
    """bzr error"""
 
174
    """Deprecated error base class."""
120
175
    # base classes should override the docstring with their human-
121
176
    # readable explanation
122
177
 
123
 
    def __init__(self, **kwds):
 
178
    def __init__(self, *args, **kwds):
 
179
        # XXX: Use the underlying BzrError to always generate the args
 
180
        # attribute if it doesn't exist.  We can't use super here, because
 
181
        # exceptions are old-style classes in python2.4 (but new in 2.5).
 
182
        # --bmc, 20060426
 
183
        symbol_versioning.warn('BzrNewError was deprecated in bzr 0.13; '
 
184
             'please convert %s to use BzrError instead'
 
185
             % self.__class__.__name__,
 
186
             DeprecationWarning,
 
187
             stacklevel=2)
 
188
        BzrError.__init__(self, *args)
124
189
        for key, value in kwds.items():
125
190
            setattr(self, key, value)
126
191
 
133
198
                return s.encode('utf8')
134
199
            return s
135
200
        except (TypeError, NameError, ValueError, KeyError), e:
136
 
            return 'Unprintable exception %s(%r): %s' \
 
201
            return 'Unprintable exception %s(%r): %r' \
137
202
                % (self.__class__.__name__,
138
 
                   self.__dict__, str(e))
139
 
 
140
 
 
141
 
class BzrCheckError(BzrNewError):
142
 
    """Internal check failed: %(message)s"""
143
 
 
144
 
    is_user_error = False
 
203
                   self.__dict__, e)
 
204
 
 
205
 
 
206
class AlreadyBuilding(BzrError):
 
207
    
 
208
    _fmt = "The tree builder is already building a tree."
 
209
 
 
210
 
 
211
class BranchError(BzrError):
 
212
    """Base class for concrete 'errors about a branch'."""
 
213
 
 
214
    def __init__(self, branch):
 
215
        BzrError.__init__(self, branch=branch)
 
216
 
 
217
 
 
218
class BzrCheckError(InternalBzrError):
 
219
    
 
220
    _fmt = "Internal check failed: %(message)s"
145
221
 
146
222
    def __init__(self, message):
147
 
        BzrNewError.__init__(self)
 
223
        BzrError.__init__(self)
148
224
        self.message = message
149
225
 
150
226
 
151
 
class InvalidEntryName(BzrNewError):
152
 
    """Invalid entry name: %(name)s"""
153
 
 
154
 
    is_user_error = False
 
227
class DisabledMethod(InternalBzrError):
 
228
 
 
229
    _fmt = "The smart server method '%(class_name)s' is disabled."
 
230
 
 
231
    def __init__(self, class_name):
 
232
        BzrError.__init__(self)
 
233
        self.class_name = class_name
 
234
 
 
235
 
 
236
class IncompatibleAPI(BzrError):
 
237
 
 
238
    _fmt = 'The API for "%(api)s" is not compatible with "%(wanted)s". '\
 
239
        'It supports versions "%(minimum)s" to "%(current)s".'
 
240
 
 
241
    def __init__(self, api, wanted, minimum, current):
 
242
        self.api = api
 
243
        self.wanted = wanted
 
244
        self.minimum = minimum
 
245
        self.current = current
 
246
 
 
247
 
 
248
class InProcessTransport(BzrError):
 
249
 
 
250
    _fmt = "The transport '%(transport)s' is only accessible within this " \
 
251
        "process."
 
252
 
 
253
    def __init__(self, transport):
 
254
        self.transport = transport
 
255
 
 
256
 
 
257
class InvalidEntryName(InternalBzrError):
 
258
    
 
259
    _fmt = "Invalid entry name: %(name)s"
155
260
 
156
261
    def __init__(self, name):
157
 
        BzrNewError.__init__(self)
 
262
        BzrError.__init__(self)
158
263
        self.name = name
159
264
 
160
265
 
161
 
class InvalidRevisionNumber(BzrNewError):
162
 
    """Invalid revision number %(revno)d"""
 
266
class InvalidRevisionNumber(BzrError):
 
267
    
 
268
    _fmt = "Invalid revision number %(revno)s"
 
269
 
163
270
    def __init__(self, revno):
164
 
        BzrNewError.__init__(self)
 
271
        BzrError.__init__(self)
165
272
        self.revno = revno
166
273
 
167
274
 
168
 
class InvalidRevisionId(BzrNewError):
169
 
    """Invalid revision-id {%(revision_id)s} in %(branch)s"""
 
275
class InvalidRevisionId(BzrError):
 
276
 
 
277
    _fmt = "Invalid revision-id {%(revision_id)s} in %(branch)s"
170
278
 
171
279
    def __init__(self, revision_id, branch):
172
280
        # branch can be any string or object with __str__ defined
173
 
        BzrNewError.__init__(self)
 
281
        BzrError.__init__(self)
174
282
        self.revision_id = revision_id
175
283
        self.branch = branch
176
284
 
177
285
 
178
 
class NoSuchId(BzrNewError):
179
 
    """The file id %(file_id)s is not present in the tree %(tree)s."""
 
286
class ReservedId(BzrError):
 
287
 
 
288
    _fmt = "Reserved revision-id {%(revision_id)s}"
 
289
 
 
290
    def __init__(self, revision_id):
 
291
        self.revision_id = revision_id
 
292
 
 
293
 
 
294
class RootMissing(InternalBzrError):
 
295
 
 
296
    _fmt = ("The root entry of a tree must be the first entry supplied to "
 
297
        "record_entry_contents.")
 
298
 
 
299
 
 
300
class NoPublicBranch(BzrError):
 
301
 
 
302
    _fmt = 'There is no public branch set for "%(branch_url)s".'
 
303
 
 
304
    def __init__(self, branch):
 
305
        import bzrlib.urlutils as urlutils
 
306
        public_location = urlutils.unescape_for_display(branch.base, 'ascii')
 
307
        BzrError.__init__(self, branch_url=public_location)
 
308
 
 
309
 
 
310
class NoHelpTopic(BzrError):
 
311
 
 
312
    _fmt = ("No help could be found for '%(topic)s'. "
 
313
        "Please use 'bzr help topics' to obtain a list of topics.")
 
314
 
 
315
    def __init__(self, topic):
 
316
        self.topic = topic
 
317
 
 
318
 
 
319
class NoSuchId(BzrError):
 
320
 
 
321
    _fmt = 'The file id "%(file_id)s" is not present in the tree %(tree)s.'
180
322
    
181
323
    def __init__(self, tree, file_id):
182
 
        BzrNewError.__init__(self)
 
324
        BzrError.__init__(self)
183
325
        self.file_id = file_id
184
326
        self.tree = tree
185
327
 
186
328
 
187
 
class NoWorkingTree(BzrNewError):
188
 
    """No WorkingTree exists for %(base)s."""
 
329
class NoSuchIdInRepository(NoSuchId):
 
330
 
 
331
    _fmt = ('The file id "%(file_id)s" is not present in the repository'
 
332
            ' %(repository)r')
 
333
 
 
334
    def __init__(self, repository, file_id):
 
335
        BzrError.__init__(self, repository=repository, file_id=file_id)
 
336
 
 
337
 
 
338
class NotStacked(BranchError):
 
339
 
 
340
    _fmt = "The branch '%(branch)s' is not stacked."
 
341
 
 
342
 
 
343
class InventoryModified(InternalBzrError):
 
344
 
 
345
    _fmt = ("The current inventory for the tree %(tree)r has been modified,"
 
346
            " so a clean inventory cannot be read without data loss.")
 
347
 
 
348
    def __init__(self, tree):
 
349
        self.tree = tree
 
350
 
 
351
 
 
352
class NoWorkingTree(BzrError):
 
353
 
 
354
    _fmt = 'No WorkingTree exists for "%(base)s".'
189
355
    
190
356
    def __init__(self, base):
191
 
        BzrNewError.__init__(self)
 
357
        BzrError.__init__(self)
192
358
        self.base = base
193
359
 
194
360
 
195
 
class NotLocalUrl(BzrNewError):
196
 
    """%(url)s is not a local path."""
197
 
    
 
361
class NotBuilding(BzrError):
 
362
 
 
363
    _fmt = "Not currently building a tree."
 
364
 
 
365
 
 
366
class NotLocalUrl(BzrError):
 
367
 
 
368
    _fmt = "%(url)s is not a local path."
 
369
 
198
370
    def __init__(self, url):
199
 
        BzrNewError.__init__(self)
200
371
        self.url = url
201
372
 
202
373
 
203
 
class BzrCommandError(BzrNewError):
 
374
class WorkingTreeAlreadyPopulated(InternalBzrError):
 
375
 
 
376
    _fmt = 'Working tree already populated in "%(base)s"'
 
377
 
 
378
    def __init__(self, base):
 
379
        self.base = base
 
380
 
 
381
 
 
382
class BzrCommandError(BzrError):
204
383
    """Error from user command"""
205
384
 
206
 
    is_user_error = True
207
 
 
208
385
    # Error from malformed user command; please avoid raising this as a
209
386
    # generic exception not caused by user input.
210
387
    #
212
389
    # are not intended to be caught anyway.  UI code need not subclass
213
390
    # BzrCommandError, and non-UI code should not throw a subclass of
214
391
    # BzrCommandError.  ADHB 20051211
215
 
    def __init__(self, msg):
216
 
        # Object.__str__() must return a real string
217
 
        # returning a Unicode string is a python error.
218
 
        if isinstance(msg, unicode):
219
 
            self.msg = msg.encode('utf8')
220
 
        else:
221
 
            self.msg = msg
222
 
 
223
 
    def __str__(self):
224
 
        return self.msg
 
392
 
 
393
 
 
394
class NotWriteLocked(BzrError):
 
395
 
 
396
    _fmt = """%(not_locked)r is not write locked but needs to be."""
 
397
 
 
398
    def __init__(self, not_locked):
 
399
        self.not_locked = not_locked
225
400
 
226
401
 
227
402
class BzrOptionError(BzrCommandError):
228
 
    """Error in command line options"""
 
403
 
 
404
    _fmt = "Error in command line options"
 
405
 
 
406
 
 
407
class BadIndexFormatSignature(BzrError):
 
408
 
 
409
    _fmt = "%(value)s is not an index of type %(_type)s."
 
410
 
 
411
    def __init__(self, value, _type):
 
412
        BzrError.__init__(self)
 
413
        self.value = value
 
414
        self._type = _type
 
415
 
 
416
 
 
417
class BadIndexData(BzrError):
 
418
 
 
419
    _fmt = "Error in data for index %(value)s."
 
420
 
 
421
    def __init__(self, value):
 
422
        BzrError.__init__(self)
 
423
        self.value = value
 
424
 
 
425
 
 
426
class BadIndexDuplicateKey(BzrError):
 
427
 
 
428
    _fmt = "The key '%(key)s' is already in index '%(index)s'."
 
429
 
 
430
    def __init__(self, key, index):
 
431
        BzrError.__init__(self)
 
432
        self.key = key
 
433
        self.index = index
 
434
 
 
435
 
 
436
class BadIndexKey(BzrError):
 
437
 
 
438
    _fmt = "The key '%(key)s' is not a valid key."
 
439
 
 
440
    def __init__(self, key):
 
441
        BzrError.__init__(self)
 
442
        self.key = key
 
443
 
 
444
 
 
445
class BadIndexOptions(BzrError):
 
446
 
 
447
    _fmt = "Could not parse options for index %(value)s."
 
448
 
 
449
    def __init__(self, value):
 
450
        BzrError.__init__(self)
 
451
        self.value = value
 
452
 
 
453
 
 
454
class BadIndexValue(BzrError):
 
455
 
 
456
    _fmt = "The value '%(value)s' is not a valid value."
 
457
 
 
458
    def __init__(self, value):
 
459
        BzrError.__init__(self)
 
460
        self.value = value
 
461
 
 
462
 
 
463
class BadOptionValue(BzrError):
 
464
 
 
465
    _fmt = """Bad value "%(value)s" for option "%(name)s"."""
 
466
 
 
467
    def __init__(self, name, value):
 
468
        BzrError.__init__(self, name=name, value=value)
229
469
 
230
470
    
231
 
class StrictCommitFailed(BzrNewError):
232
 
    """Commit refused because there are unknown files in the tree"""
 
471
class StrictCommitFailed(BzrError):
 
472
 
 
473
    _fmt = "Commit refused because there are unknown files in the tree"
233
474
 
234
475
 
235
476
# XXX: Should be unified with TransportError; they seem to represent the
236
477
# same thing
237
 
class PathError(BzrNewError):
238
 
    """Generic path error: %(path)r%(extra)s)"""
 
478
# RBC 20060929: I think that unifiying with TransportError would be a mistake
 
479
# - this is finer than a TransportError - and more useful as such. It 
 
480
# differentiates between 'transport has failed' and 'operation on a transport
 
481
# has failed.'
 
482
class PathError(BzrError):
 
483
    
 
484
    _fmt = "Generic path error: %(path)r%(extra)s)"
239
485
 
240
486
    def __init__(self, path, extra=None):
241
 
        BzrNewError.__init__(self)
 
487
        BzrError.__init__(self)
242
488
        self.path = path
243
489
        if extra:
244
490
            self.extra = ': ' + str(extra)
247
493
 
248
494
 
249
495
class NoSuchFile(PathError):
250
 
    """No such file: %(path)r%(extra)s"""
 
496
 
 
497
    _fmt = "No such file: %(path)r%(extra)s"
251
498
 
252
499
 
253
500
class FileExists(PathError):
254
 
    """File exists: %(path)r%(extra)s"""
 
501
 
 
502
    _fmt = "File exists: %(path)r%(extra)s"
 
503
 
 
504
 
 
505
class RenameFailedFilesExist(BzrError):
 
506
    """Used when renaming and both source and dest exist."""
 
507
 
 
508
    _fmt = ("Could not rename %(source)s => %(dest)s because both files exist."
 
509
            " (Use --after to tell bzr about a rename that has already"
 
510
            " happened)%(extra)s")
 
511
 
 
512
    def __init__(self, source, dest, extra=None):
 
513
        BzrError.__init__(self)
 
514
        self.source = str(source)
 
515
        self.dest = str(dest)
 
516
        if extra:
 
517
            self.extra = ' ' + str(extra)
 
518
        else:
 
519
            self.extra = ''
 
520
 
 
521
 
 
522
class NotADirectory(PathError):
 
523
 
 
524
    _fmt = '"%(path)s" is not a directory %(extra)s'
 
525
 
 
526
 
 
527
class NotInWorkingDirectory(PathError):
 
528
 
 
529
    _fmt = '"%(path)s" is not in the working directory %(extra)s'
255
530
 
256
531
 
257
532
class DirectoryNotEmpty(PathError):
258
 
    """Directory not empty: %(path)r%(extra)s"""
 
533
 
 
534
    _fmt = 'Directory not empty: "%(path)s"%(extra)s'
 
535
 
 
536
 
 
537
class HardLinkNotSupported(PathError):
 
538
 
 
539
    _fmt = 'Hard-linking "%(path)s" is not supported'
 
540
 
 
541
 
 
542
class ReadingCompleted(InternalBzrError):
 
543
    
 
544
    _fmt = ("The MediumRequest '%(request)s' has already had finish_reading "
 
545
            "called upon it - the request has been completed and no more "
 
546
            "data may be read.")
 
547
 
 
548
    def __init__(self, request):
 
549
        self.request = request
259
550
 
260
551
 
261
552
class ResourceBusy(PathError):
262
 
    """Device or resource busy: %(path)r%(extra)s"""
 
553
 
 
554
    _fmt = 'Device or resource busy: "%(path)s"%(extra)s'
263
555
 
264
556
 
265
557
class PermissionDenied(PathError):
266
 
    """Permission denied: %(path)r%(extra)s"""
 
558
 
 
559
    _fmt = 'Permission denied: "%(path)s"%(extra)s'
267
560
 
268
561
 
269
562
class InvalidURL(PathError):
270
 
    """Invalid url supplied to transport: %(path)r%(extra)s"""
 
563
 
 
564
    _fmt = 'Invalid url supplied to transport: "%(path)s"%(extra)s'
271
565
 
272
566
 
273
567
class InvalidURLJoin(PathError):
274
 
    """Invalid URL join request: %(args)s%(extra)s"""
275
 
 
276
 
    def __init__(self, msg, base, args):
277
 
        PathError.__init__(self, base, msg)
278
 
        self.args = [base]
279
 
        self.args.extend(args)
 
568
 
 
569
    _fmt = "Invalid URL join request: %(reason)s: %(base)r + %(join_args)r"
 
570
 
 
571
    def __init__(self, reason, base, join_args):
 
572
        self.reason = reason
 
573
        self.base = base
 
574
        self.join_args = join_args
 
575
        PathError.__init__(self, base, reason)
 
576
 
 
577
 
 
578
class InvalidRebaseURLs(PathError):
 
579
 
 
580
    _fmt = "URLs differ by more than path: %(from_)r and %(to)r"
 
581
 
 
582
    def __init__(self, from_, to):
 
583
        self.from_ = from_
 
584
        self.to = to
 
585
        PathError.__init__(self, from_, 'URLs differ by more than path.')
 
586
 
 
587
 
 
588
class UnavailableRepresentation(InternalBzrError):
 
589
 
 
590
    _fmt = ("The encoding '%(wanted)s' is not available for key %(key)s which "
 
591
        "is encoded as '%(native)s'.")
 
592
 
 
593
    def __init__(self, key, wanted, native):
 
594
        InternalBzrError.__init__(self)
 
595
        self.wanted = wanted
 
596
        self.native = native
 
597
        self.key = key
 
598
 
 
599
 
 
600
class UnknownHook(BzrError):
 
601
 
 
602
    _fmt = "The %(type)s hook '%(hook)s' is unknown in this version of bzrlib."
 
603
 
 
604
    def __init__(self, hook_type, hook_name):
 
605
        BzrError.__init__(self)
 
606
        self.type = hook_type
 
607
        self.hook = hook_name
280
608
 
281
609
 
282
610
class UnsupportedProtocol(PathError):
283
 
    """Unsupported protocol for url "%(path)s"%(extra)s"""
 
611
 
 
612
    _fmt = 'Unsupported protocol for url "%(path)s"%(extra)s'
284
613
 
285
614
    def __init__(self, url, extra):
286
615
        PathError.__init__(self, url, extra=extra)
287
616
 
288
617
 
289
 
class PathNotChild(BzrNewError):
290
 
    """Path %(path)r is not a child of path %(base)r%(extra)s"""
291
 
 
292
 
    is_user_error = False
 
618
class UnstackableBranchFormat(BzrError):
 
619
 
 
620
    _fmt = ("The branch '%(url)s'(%(format)s) is not a stackable format. "
 
621
        "You will need to upgrade the branch to permit branch stacking.")
 
622
 
 
623
    def __init__(self, format, url):
 
624
        BzrError.__init__(self)
 
625
        self.format = format
 
626
        self.url = url
 
627
 
 
628
 
 
629
class UnstackableRepositoryFormat(BzrError):
 
630
 
 
631
    _fmt = ("The repository '%(url)s'(%(format)s) is not a stackable format. "
 
632
        "You will need to upgrade the repository to permit branch stacking.")
 
633
 
 
634
    def __init__(self, format, url):
 
635
        BzrError.__init__(self)
 
636
        self.format = format
 
637
        self.url = url
 
638
 
 
639
 
 
640
class ReadError(PathError):
 
641
    
 
642
    _fmt = """Error reading from %(path)r."""
 
643
 
 
644
 
 
645
class ShortReadvError(PathError):
 
646
 
 
647
    _fmt = ('readv() read %(actual)s bytes rather than %(length)s bytes'
 
648
            ' at %(offset)s for "%(path)s"%(extra)s')
 
649
 
 
650
    internal_error = True
 
651
 
 
652
    def __init__(self, path, offset, length, actual, extra=None):
 
653
        PathError.__init__(self, path, extra=extra)
 
654
        self.offset = offset
 
655
        self.length = length
 
656
        self.actual = actual
 
657
 
 
658
 
 
659
class PathNotChild(PathError):
 
660
 
 
661
    _fmt = 'Path "%(path)s" is not a child of path "%(base)s"%(extra)s'
 
662
 
 
663
    internal_error = True
293
664
 
294
665
    def __init__(self, path, base, extra=None):
295
 
        BzrNewError.__init__(self)
 
666
        BzrError.__init__(self)
296
667
        self.path = path
297
668
        self.base = base
298
669
        if extra:
302
673
 
303
674
 
304
675
class InvalidNormalization(PathError):
305
 
    """Path %(path)r is not unicode normalized"""
 
676
 
 
677
    _fmt = 'Path "%(path)s" is not unicode normalized'
306
678
 
307
679
 
308
680
# TODO: This is given a URL; we try to unescape it but doing that from inside
309
681
# the exception object is a bit undesirable.
310
682
# TODO: Probably this behavior of should be a common superclass 
311
683
class NotBranchError(PathError):
312
 
    """Not a branch: %(path)s"""
 
684
 
 
685
    _fmt = 'Not a branch: "%(path)s".'
313
686
 
314
687
    def __init__(self, path):
315
688
       import bzrlib.urlutils as urlutils
316
689
       self.path = urlutils.unescape_for_display(path, 'ascii')
317
690
 
318
691
 
 
692
class NoSubmitBranch(PathError):
 
693
 
 
694
    _fmt = 'No submit branch available for branch "%(path)s"'
 
695
 
 
696
    def __init__(self, branch):
 
697
       import bzrlib.urlutils as urlutils
 
698
       self.path = urlutils.unescape_for_display(branch.base, 'ascii')
 
699
 
 
700
 
319
701
class AlreadyBranchError(PathError):
320
 
    """Already a branch: %(path)s."""
 
702
 
 
703
    _fmt = 'Already a branch: "%(path)s".'
321
704
 
322
705
 
323
706
class BranchExistsWithoutWorkingTree(PathError):
324
 
    """Directory contains a branch, but no working tree \
325
 
(use bzr checkout if you wish to build a working tree): %(path)s"""
 
707
 
 
708
    _fmt = 'Directory contains a branch, but no working tree \
 
709
(use bzr checkout if you wish to build a working tree): "%(path)s"'
326
710
 
327
711
 
328
712
class AtomicFileAlreadyClosed(PathError):
329
 
    """'%(function)s' called on an AtomicFile after it was closed: %(path)s"""
 
713
 
 
714
    _fmt = ('"%(function)s" called on an AtomicFile after it was closed:'
 
715
            ' "%(path)s"')
330
716
 
331
717
    def __init__(self, path, function):
332
718
        PathError.__init__(self, path=path, extra=None)
334
720
 
335
721
 
336
722
class InaccessibleParent(PathError):
337
 
    """Parent not accessible given base %(base)s and relative path %(path)s"""
 
723
 
 
724
    _fmt = ('Parent not accessible given base "%(base)s" and'
 
725
            ' relative path "%(path)s"')
338
726
 
339
727
    def __init__(self, path, base):
340
728
        PathError.__init__(self, path)
341
729
        self.base = base
342
730
 
343
731
 
344
 
class NoRepositoryPresent(BzrNewError):
345
 
    """No repository present: %(path)r"""
 
732
class NoRepositoryPresent(BzrError):
 
733
 
 
734
    _fmt = 'No repository present: "%(path)s"'
346
735
    def __init__(self, bzrdir):
347
 
        BzrNewError.__init__(self)
 
736
        BzrError.__init__(self)
348
737
        self.path = bzrdir.transport.clone('..').base
349
738
 
350
739
 
351
 
class FileInWrongBranch(BzrNewError):
352
 
    """File %(path)s in not in branch %(branch_base)s."""
 
740
class FileInWrongBranch(BzrError):
 
741
 
 
742
    _fmt = 'File "%(path)s" is not in branch %(branch_base)s.'
353
743
 
354
744
    def __init__(self, branch, path):
355
 
        BzrNewError.__init__(self)
 
745
        BzrError.__init__(self)
356
746
        self.branch = branch
357
747
        self.branch_base = branch.base
358
748
        self.path = path
359
749
 
360
750
 
361
 
class UnsupportedFormatError(BzrNewError):
362
 
    """Unsupported branch format: %(format)s"""
363
 
 
364
 
 
365
 
class UnknownFormatError(BzrNewError):
366
 
    """Unknown branch format: %(format)r"""
367
 
 
368
 
 
369
 
class IncompatibleFormat(BzrNewError):
370
 
    """Format %(format)s is not compatible with .bzr version %(bzrdir)s."""
 
751
class UnsupportedFormatError(BzrError):
 
752
 
 
753
    _fmt = "Unsupported branch format: %(format)s\nPlease run 'bzr upgrade'"
 
754
 
 
755
 
 
756
class UnknownFormatError(BzrError):
 
757
    
 
758
    _fmt = "Unknown %(kind)s format: %(format)r"
 
759
 
 
760
    def __init__(self, format, kind='branch'):
 
761
        self.kind = kind
 
762
        self.format = format
 
763
 
 
764
 
 
765
class IncompatibleFormat(BzrError):
 
766
    
 
767
    _fmt = "Format %(format)s is not compatible with .bzr version %(bzrdir)s."
371
768
 
372
769
    def __init__(self, format, bzrdir_format):
373
 
        BzrNewError.__init__(self)
 
770
        BzrError.__init__(self)
374
771
        self.format = format
375
772
        self.bzrdir = bzrdir_format
376
773
 
377
774
 
378
 
class NotVersionedError(BzrNewError):
379
 
    """%(path)s is not versioned"""
380
 
    def __init__(self, path):
381
 
        BzrNewError.__init__(self)
382
 
        self.path = path
383
 
 
384
 
 
385
 
class PathsNotVersionedError(BzrNewError):
386
 
    # used when reporting several paths are not versioned
387
 
    """Path(s) are not versioned: %(paths_as_string)s"""
 
775
class IncompatibleRepositories(BzrError):
 
776
 
 
777
    _fmt = "%(target)s\n" \
 
778
            "is not compatible with\n" \
 
779
            "%(source)s\n" \
 
780
            "%(details)s"
 
781
 
 
782
    def __init__(self, source, target, details=None):
 
783
        if details is None:
 
784
            details = "(no details)"
 
785
        BzrError.__init__(self, target=target, source=source, details=details)
 
786
 
 
787
 
 
788
class IncompatibleRevision(BzrError):
 
789
    
 
790
    _fmt = "Revision is not compatible with %(repo_format)s"
 
791
 
 
792
    def __init__(self, repo_format):
 
793
        BzrError.__init__(self)
 
794
        self.repo_format = repo_format
 
795
 
 
796
 
 
797
class AlreadyVersionedError(BzrError):
 
798
    """Used when a path is expected not to be versioned, but it is."""
 
799
 
 
800
    _fmt = "%(context_info)s%(path)s is already versioned."
 
801
 
 
802
    def __init__(self, path, context_info=None):
 
803
        """Construct a new AlreadyVersionedError.
 
804
 
 
805
        :param path: This is the path which is versioned,
 
806
        which should be in a user friendly form.
 
807
        :param context_info: If given, this is information about the context,
 
808
        which could explain why this is expected to not be versioned.
 
809
        """
 
810
        BzrError.__init__(self)
 
811
        self.path = path
 
812
        if context_info is None:
 
813
            self.context_info = ''
 
814
        else:
 
815
            self.context_info = context_info + ". "
 
816
 
 
817
 
 
818
class NotVersionedError(BzrError):
 
819
    """Used when a path is expected to be versioned, but it is not."""
 
820
 
 
821
    _fmt = "%(context_info)s%(path)s is not versioned."
 
822
 
 
823
    def __init__(self, path, context_info=None):
 
824
        """Construct a new NotVersionedError.
 
825
 
 
826
        :param path: This is the path which is not versioned,
 
827
        which should be in a user friendly form.
 
828
        :param context_info: If given, this is information about the context,
 
829
        which could explain why this is expected to be versioned.
 
830
        """
 
831
        BzrError.__init__(self)
 
832
        self.path = path
 
833
        if context_info is None:
 
834
            self.context_info = ''
 
835
        else:
 
836
            self.context_info = context_info + ". "
 
837
 
 
838
 
 
839
class PathsNotVersionedError(BzrError):
 
840
    """Used when reporting several paths which are not versioned"""
 
841
 
 
842
    _fmt = "Path(s) are not versioned: %(paths_as_string)s"
388
843
 
389
844
    def __init__(self, paths):
390
845
        from bzrlib.osutils import quotefn
391
 
        BzrNewError.__init__(self)
 
846
        BzrError.__init__(self)
392
847
        self.paths = paths
393
848
        self.paths_as_string = ' '.join([quotefn(p) for p in paths])
394
849
 
395
850
 
396
 
class PathsDoNotExist(BzrNewError):
397
 
    """Path(s) do not exist: %(paths_as_string)s"""
 
851
class PathsDoNotExist(BzrError):
 
852
 
 
853
    _fmt = "Path(s) do not exist: %(paths_as_string)s%(extra)s"
398
854
 
399
855
    # used when reporting that paths are neither versioned nor in the working
400
856
    # tree
401
857
 
402
 
    def __init__(self, paths):
 
858
    def __init__(self, paths, extra=None):
403
859
        # circular import
404
860
        from bzrlib.osutils import quotefn
405
 
        BzrNewError.__init__(self)
 
861
        BzrError.__init__(self)
406
862
        self.paths = paths
407
863
        self.paths_as_string = ' '.join([quotefn(p) for p in paths])
408
 
 
409
 
 
410
 
class BadFileKindError(BzrNewError):
411
 
    """Cannot operate on %(filename)s of unsupported kind %(kind)s"""
412
 
 
413
 
 
414
 
class ForbiddenControlFileError(BzrNewError):
415
 
    """Cannot operate on %(filename)s because it is a control file"""
416
 
 
417
 
 
418
 
class LockError(BzrNewError):
419
 
    """Lock error: %(message)s"""
 
864
        if extra:
 
865
            self.extra = ': ' + str(extra)
 
866
        else:
 
867
            self.extra = ''
 
868
 
 
869
 
 
870
class BadFileKindError(BzrError):
 
871
 
 
872
    _fmt = 'Cannot operate on "%(filename)s" of unsupported kind "%(kind)s"'
 
873
 
 
874
    def __init__(self, filename, kind):
 
875
        BzrError.__init__(self, filename=filename, kind=kind)
 
876
 
 
877
 
 
878
class BadFilenameEncoding(BzrError):
 
879
 
 
880
    _fmt = ('Filename %(filename)r is not valid in your current filesystem'
 
881
            ' encoding %(fs_encoding)s')
 
882
 
 
883
    def __init__(self, filename, fs_encoding):
 
884
        BzrError.__init__(self)
 
885
        self.filename = filename
 
886
        self.fs_encoding = fs_encoding
 
887
 
 
888
 
 
889
class ForbiddenControlFileError(BzrError):
 
890
 
 
891
    _fmt = 'Cannot operate on "%(filename)s" because it is a control file'
 
892
 
 
893
 
 
894
class LockError(InternalBzrError):
 
895
 
 
896
    _fmt = "Lock error: %(msg)s"
 
897
 
420
898
    # All exceptions from the lock/unlock functions should be from
421
899
    # this exception class.  They will be translated as necessary. The
422
900
    # original exception is available as e.original_error
423
901
    #
424
902
    # New code should prefer to raise specific subclasses
425
903
    def __init__(self, message):
426
 
        self.message = message
 
904
        # Python 2.5 uses a slot for StandardError.message,
 
905
        # so use a different variable name.  We now work around this in
 
906
        # BzrError.__str__, but this member name is kept for compatability.
 
907
        self.msg = message
 
908
 
 
909
 
 
910
class LockActive(LockError):
 
911
 
 
912
    _fmt = "The lock for '%(lock_description)s' is in use and cannot be broken."
 
913
 
 
914
    internal_error = False
 
915
 
 
916
    def __init__(self, lock_description):
 
917
        self.lock_description = lock_description
427
918
 
428
919
 
429
920
class CommitNotPossible(LockError):
430
 
    """A commit was attempted but we do not have a write lock open."""
 
921
 
 
922
    _fmt = "A commit was attempted but we do not have a write lock open."
 
923
 
431
924
    def __init__(self):
432
925
        pass
433
926
 
434
927
 
435
928
class AlreadyCommitted(LockError):
436
 
    """A rollback was requested, but is not able to be accomplished."""
 
929
 
 
930
    _fmt = "A rollback was requested, but is not able to be accomplished."
 
931
 
437
932
    def __init__(self):
438
933
        pass
439
934
 
440
935
 
441
936
class ReadOnlyError(LockError):
442
 
    """A write attempt was made in a read only transaction on %(obj)s"""
 
937
 
 
938
    _fmt = "A write attempt was made in a read only transaction on %(obj)s"
 
939
 
 
940
    # TODO: There should also be an error indicating that you need a write
 
941
    # lock and don't have any lock at all... mbp 20070226
 
942
 
443
943
    def __init__(self, obj):
444
944
        self.obj = obj
445
945
 
446
946
 
447
 
class OutSideTransaction(BzrNewError):
448
 
    """A transaction related operation was attempted after the transaction finished."""
 
947
class LockFailed(LockError):
 
948
 
 
949
    internal_error = False
 
950
 
 
951
    _fmt = "Cannot lock %(lock)s: %(why)s"
 
952
 
 
953
    def __init__(self, lock, why):
 
954
        LockError.__init__(self, '')
 
955
        self.lock = lock
 
956
        self.why = why
 
957
 
 
958
 
 
959
class OutSideTransaction(BzrError):
 
960
 
 
961
    _fmt = ("A transaction related operation was attempted after"
 
962
            " the transaction finished.")
449
963
 
450
964
 
451
965
class ObjectNotLocked(LockError):
452
 
    """%(obj)r is not locked"""
453
966
 
454
 
    is_user_error = False
 
967
    _fmt = "%(obj)r is not locked"
455
968
 
456
969
    # this can indicate that any particular object is not locked; see also
457
970
    # LockNotHeld which means that a particular *lock* object is not held by
461
974
 
462
975
 
463
976
class ReadOnlyObjectDirtiedError(ReadOnlyError):
464
 
    """Cannot change object %(obj)r in read only transaction"""
 
977
 
 
978
    _fmt = "Cannot change object %(obj)r in read only transaction"
 
979
 
465
980
    def __init__(self, obj):
466
981
        self.obj = obj
467
982
 
468
983
 
469
984
class UnlockableTransport(LockError):
470
 
    """Cannot lock: transport is read only: %(transport)s"""
 
985
 
 
986
    internal_error = False
 
987
 
 
988
    _fmt = "Cannot lock: transport is read only: %(transport)s"
 
989
 
471
990
    def __init__(self, transport):
472
991
        self.transport = transport
473
992
 
474
993
 
475
994
class LockContention(LockError):
476
 
    """Could not acquire lock %(lock)s"""
477
 
    # TODO: show full url for lock, combining the transport and relative bits?
 
995
 
 
996
    _fmt = 'Could not acquire lock "%(lock)s"'
 
997
    # TODO: show full url for lock, combining the transport and relative
 
998
    # bits?
 
999
 
 
1000
    internal_error = False
 
1001
 
478
1002
    def __init__(self, lock):
479
1003
        self.lock = lock
480
1004
 
481
1005
 
482
1006
class LockBroken(LockError):
483
 
    """Lock was broken while still open: %(lock)s - check storage consistency!"""
 
1007
 
 
1008
    _fmt = ("Lock was broken while still open: %(lock)s"
 
1009
            " - check storage consistency!")
 
1010
 
 
1011
    internal_error = False
 
1012
 
484
1013
    def __init__(self, lock):
485
1014
        self.lock = lock
486
1015
 
487
1016
 
488
1017
class LockBreakMismatch(LockError):
489
 
    """Lock was released and re-acquired before being broken: %(lock)s: held by %(holder)r, wanted to break %(target)r"""
 
1018
 
 
1019
    _fmt = ("Lock was released and re-acquired before being broken:"
 
1020
            " %(lock)s: held by %(holder)r, wanted to break %(target)r")
 
1021
 
 
1022
    internal_error = False
 
1023
 
490
1024
    def __init__(self, lock, holder, target):
491
1025
        self.lock = lock
492
1026
        self.holder = holder
494
1028
 
495
1029
 
496
1030
class LockNotHeld(LockError):
497
 
    """Lock not held: %(lock)s"""
 
1031
 
 
1032
    _fmt = "Lock not held: %(lock)s"
 
1033
 
 
1034
    internal_error = False
 
1035
 
498
1036
    def __init__(self, lock):
499
1037
        self.lock = lock
500
1038
 
501
1039
 
502
 
class PointlessCommit(BzrNewError):
503
 
    """No changes to commit"""
504
 
 
505
 
 
506
 
class UpgradeReadonly(BzrNewError):
507
 
    """Upgrade URL cannot work with readonly URL's."""
508
 
 
509
 
 
510
 
class UpToDateFormat(BzrNewError):
511
 
    """The branch format %(format)s is already at the most recent format."""
 
1040
class TokenLockingNotSupported(LockError):
 
1041
 
 
1042
    _fmt = "The object %(obj)s does not support token specifying a token when locking."
 
1043
 
 
1044
    def __init__(self, obj):
 
1045
        self.obj = obj
 
1046
 
 
1047
 
 
1048
class TokenMismatch(LockBroken):
 
1049
 
 
1050
    _fmt = "The lock token %(given_token)r does not match lock token %(lock_token)r."
 
1051
 
 
1052
    internal_error = True
 
1053
 
 
1054
    def __init__(self, given_token, lock_token):
 
1055
        self.given_token = given_token
 
1056
        self.lock_token = lock_token
 
1057
 
 
1058
 
 
1059
class PointlessCommit(BzrError):
 
1060
 
 
1061
    _fmt = "No changes to commit"
 
1062
 
 
1063
 
 
1064
class CannotCommitSelectedFileMerge(BzrError):
 
1065
 
 
1066
    _fmt = 'Selected-file commit of merges is not supported yet:'\
 
1067
        ' files %(files_str)s'
 
1068
 
 
1069
    def __init__(self, files):
 
1070
        files_str = ', '.join(files)
 
1071
        BzrError.__init__(self, files=files, files_str=files_str)
 
1072
 
 
1073
 
 
1074
class BadCommitMessageEncoding(BzrError):
 
1075
 
 
1076
    _fmt = 'The specified commit message contains characters unsupported by '\
 
1077
        'the current encoding.'
 
1078
 
 
1079
 
 
1080
class UpgradeReadonly(BzrError):
 
1081
 
 
1082
    _fmt = "Upgrade URL cannot work with readonly URLs."
 
1083
 
 
1084
 
 
1085
class UpToDateFormat(BzrError):
 
1086
 
 
1087
    _fmt = "The branch format %(format)s is already at the most recent format."
512
1088
 
513
1089
    def __init__(self, format):
514
 
        BzrNewError.__init__(self)
 
1090
        BzrError.__init__(self)
515
1091
        self.format = format
516
1092
 
517
1093
 
518
1094
class StrictCommitFailed(Exception):
519
 
    """Commit refused because there are unknowns in the tree."""
520
 
 
521
 
 
522
 
class NoSuchRevision(BzrNewError):
523
 
    """Branch %(branch)s has no revision %(revision)s"""
524
 
 
525
 
    is_user_error = False
 
1095
 
 
1096
    _fmt = "Commit refused because there are unknowns in the tree."
 
1097
 
 
1098
 
 
1099
class NoSuchRevision(InternalBzrError):
 
1100
 
 
1101
    _fmt = "%(branch)s has no revision %(revision)s"
526
1102
 
527
1103
    def __init__(self, branch, revision):
528
 
        BzrNewError.__init__(self, branch=branch, revision=revision)
529
 
 
530
 
 
531
 
class NoSuchRevisionSpec(BzrNewError):
532
 
    """No namespace registered for string: %(spec)r"""
 
1104
        # 'branch' may sometimes be an internal object like a KnitRevisionStore
 
1105
        BzrError.__init__(self, branch=branch, revision=revision)
 
1106
 
 
1107
 
 
1108
class RangeInChangeOption(BzrError):
 
1109
 
 
1110
    _fmt = "Option --change does not accept revision ranges"
 
1111
 
 
1112
 
 
1113
class NoSuchRevisionSpec(BzrError):
 
1114
 
 
1115
    _fmt = "No namespace registered for string: %(spec)r"
533
1116
 
534
1117
    def __init__(self, spec):
535
 
        BzrNewError.__init__(self, spec=spec)
536
 
 
537
 
 
538
 
class InvalidRevisionSpec(BzrNewError):
539
 
    """Requested revision: '%(spec)s' does not exist in branch:
540
 
%(branch)s%(extra)s"""
 
1118
        BzrError.__init__(self, spec=spec)
 
1119
 
 
1120
 
 
1121
class NoSuchRevisionInTree(NoSuchRevision):
 
1122
    """When using Tree.revision_tree, and the revision is not accessible."""
 
1123
    
 
1124
    _fmt = "The revision id {%(revision_id)s} is not present in the tree %(tree)s."
 
1125
 
 
1126
    def __init__(self, tree, revision_id):
 
1127
        BzrError.__init__(self)
 
1128
        self.tree = tree
 
1129
        self.revision_id = revision_id
 
1130
 
 
1131
 
 
1132
class InvalidRevisionSpec(BzrError):
 
1133
 
 
1134
    _fmt = ("Requested revision: %(spec)r does not exist in branch:"
 
1135
            " %(branch)s%(extra)s")
541
1136
 
542
1137
    def __init__(self, spec, branch, extra=None):
543
 
        BzrNewError.__init__(self, branch=branch, spec=spec)
 
1138
        BzrError.__init__(self, branch=branch, spec=spec)
544
1139
        if extra:
545
1140
            self.extra = '\n' + str(extra)
546
1141
        else:
548
1143
 
549
1144
 
550
1145
class HistoryMissing(BzrError):
551
 
    def __init__(self, branch, object_type, object_id):
552
 
        self.branch = branch
553
 
        BzrError.__init__(self,
554
 
                          '%s is missing %s {%s}'
555
 
                          % (branch, object_type, object_id))
556
 
 
557
 
 
558
 
class DivergedBranches(BzrNewError):
559
 
    "These branches have diverged.  Use the merge command to reconcile them."""
560
 
 
561
 
    is_user_error = True
 
1146
 
 
1147
    _fmt = "%(branch)s is missing %(object_type)s {%(object_id)s}"
 
1148
 
 
1149
 
 
1150
class AppendRevisionsOnlyViolation(BzrError):
 
1151
 
 
1152
    _fmt = ('Operation denied because it would change the main history,'
 
1153
           ' which is not permitted by the append_revisions_only setting on'
 
1154
           ' branch "%(location)s".')
 
1155
 
 
1156
    def __init__(self, location):
 
1157
       import bzrlib.urlutils as urlutils
 
1158
       location = urlutils.unescape_for_display(location, 'ascii')
 
1159
       BzrError.__init__(self, location=location)
 
1160
 
 
1161
 
 
1162
class DivergedBranches(BzrError):
 
1163
 
 
1164
    _fmt = ("These branches have diverged."
 
1165
            " Use the merge command to reconcile them.")
562
1166
 
563
1167
    def __init__(self, branch1, branch2):
564
1168
        self.branch1 = branch1
565
1169
        self.branch2 = branch2
566
1170
 
567
1171
 
568
 
class UnrelatedBranches(BzrNewError):
569
 
    "Branches have no common ancestor, and no merge base revision was specified."
570
 
 
571
 
    is_user_error = True
572
 
 
573
 
 
574
 
class NoCommonAncestor(BzrNewError):
575
 
    "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
 
1172
class NotLefthandHistory(InternalBzrError):
 
1173
 
 
1174
    _fmt = "Supplied history does not follow left-hand parents"
 
1175
 
 
1176
    def __init__(self, history):
 
1177
        BzrError.__init__(self, history=history)
 
1178
 
 
1179
 
 
1180
class UnrelatedBranches(BzrError):
 
1181
 
 
1182
    _fmt = ("Branches have no common ancestor, and"
 
1183
            " no merge base revision was specified.")
 
1184
 
 
1185
 
 
1186
class CannotReverseCherrypick(BzrError):
 
1187
 
 
1188
    _fmt = ('Selected merge cannot perform reverse cherrypicks.  Try merge3'
 
1189
            ' or diff3.')
 
1190
 
 
1191
 
 
1192
class NoCommonAncestor(BzrError):
 
1193
    
 
1194
    _fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
576
1195
 
577
1196
    def __init__(self, revision_a, revision_b):
578
1197
        self.revision_a = revision_a
580
1199
 
581
1200
 
582
1201
class NoCommonRoot(BzrError):
 
1202
 
 
1203
    _fmt = ("Revisions are not derived from the same root: "
 
1204
           "%(revision_a)s %(revision_b)s.")
 
1205
 
583
1206
    def __init__(self, revision_a, revision_b):
584
 
        msg = "Revisions are not derived from the same root: %s %s." \
585
 
            % (revision_a, revision_b) 
586
 
        BzrError.__init__(self, msg)
587
 
 
 
1207
        BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
588
1208
 
589
1209
 
590
1210
class NotAncestor(BzrError):
 
1211
 
 
1212
    _fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
 
1213
 
591
1214
    def __init__(self, rev_id, not_ancestor_id):
592
 
        msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id, 
593
 
                                                        rev_id)
594
 
        BzrError.__init__(self, msg)
595
 
        self.rev_id = rev_id
596
 
        self.not_ancestor_id = not_ancestor_id
 
1215
        BzrError.__init__(self, rev_id=rev_id,
 
1216
            not_ancestor_id=not_ancestor_id)
597
1217
 
598
1218
 
599
1219
class InstallFailed(BzrError):
 
1220
 
600
1221
    def __init__(self, revisions):
601
 
        msg = "Could not install revisions:\n%s" % " ,".join(revisions)
 
1222
        revision_str = ", ".join(str(r) for r in revisions)
 
1223
        msg = "Could not install revisions:\n%s" % revision_str
602
1224
        BzrError.__init__(self, msg)
603
1225
        self.revisions = revisions
604
1226
 
605
1227
 
606
1228
class AmbiguousBase(BzrError):
 
1229
 
607
1230
    def __init__(self, bases):
608
1231
        warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
609
1232
                DeprecationWarning)
610
 
        msg = "The correct base is unclear, because %s are all equally close" %\
611
 
            ", ".join(bases)
 
1233
        msg = ("The correct base is unclear, because %s are all equally close"
 
1234
                % ", ".join(bases))
612
1235
        BzrError.__init__(self, msg)
613
1236
        self.bases = bases
614
1237
 
615
1238
 
616
 
class NoCommits(BzrNewError):
617
 
    """Branch %(branch)s has no commits."""
 
1239
class NoCommits(BranchError):
618
1240
 
619
 
    def __init__(self, branch):
620
 
        BzrNewError.__init__(self, branch=branch)
 
1241
    _fmt = "Branch %(branch)s has no commits."
621
1242
 
622
1243
 
623
1244
class UnlistableStore(BzrError):
 
1245
 
624
1246
    def __init__(self, store):
625
1247
        BzrError.__init__(self, "Store %s is not listable" % store)
626
1248
 
627
1249
 
628
1250
 
629
1251
class UnlistableBranch(BzrError):
 
1252
 
630
1253
    def __init__(self, br):
631
1254
        BzrError.__init__(self, "Stores for branch %s are not listable" % br)
632
1255
 
633
1256
 
634
 
class BoundBranchOutOfDate(BzrNewError):
635
 
    """Bound branch %(branch)s is out of date with master branch %(master)s."""
 
1257
class BoundBranchOutOfDate(BzrError):
 
1258
 
 
1259
    _fmt = ("Bound branch %(branch)s is out of date with master branch"
 
1260
            " %(master)s.")
 
1261
 
636
1262
    def __init__(self, branch, master):
637
 
        BzrNewError.__init__(self)
 
1263
        BzrError.__init__(self)
638
1264
        self.branch = branch
639
1265
        self.master = master
640
1266
 
641
1267
        
642
 
class CommitToDoubleBoundBranch(BzrNewError):
643
 
    """Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."""
 
1268
class CommitToDoubleBoundBranch(BzrError):
 
1269
 
 
1270
    _fmt = ("Cannot commit to branch %(branch)s."
 
1271
            " It is bound to %(master)s, which is bound to %(remote)s.")
 
1272
 
644
1273
    def __init__(self, branch, master, remote):
645
 
        BzrNewError.__init__(self)
 
1274
        BzrError.__init__(self)
646
1275
        self.branch = branch
647
1276
        self.master = master
648
1277
        self.remote = remote
649
1278
 
650
1279
 
651
 
class OverwriteBoundBranch(BzrNewError):
652
 
    """Cannot pull --overwrite to a branch which is bound %(branch)s"""
 
1280
class OverwriteBoundBranch(BzrError):
 
1281
 
 
1282
    _fmt = "Cannot pull --overwrite to a branch which is bound %(branch)s"
 
1283
 
653
1284
    def __init__(self, branch):
654
 
        BzrNewError.__init__(self)
 
1285
        BzrError.__init__(self)
655
1286
        self.branch = branch
656
1287
 
657
1288
 
658
 
class BoundBranchConnectionFailure(BzrNewError):
659
 
    """Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"""
 
1289
class BoundBranchConnectionFailure(BzrError):
 
1290
 
 
1291
    _fmt = ("Unable to connect to target of bound branch %(branch)s"
 
1292
            " => %(target)s: %(error)s")
 
1293
 
660
1294
    def __init__(self, branch, target, error):
661
 
        BzrNewError.__init__(self)
 
1295
        BzrError.__init__(self)
662
1296
        self.branch = branch
663
1297
        self.target = target
664
1298
        self.error = error
665
1299
 
666
1300
 
667
 
class WeaveError(BzrNewError):
668
 
    """Error in processing weave: %(message)s"""
 
1301
class WeaveError(BzrError):
 
1302
 
 
1303
    _fmt = "Error in processing weave: %(message)s"
669
1304
 
670
1305
    def __init__(self, message=None):
671
 
        BzrNewError.__init__(self)
 
1306
        BzrError.__init__(self)
672
1307
        self.message = message
673
1308
 
674
1309
 
675
1310
class WeaveRevisionAlreadyPresent(WeaveError):
676
 
    """Revision {%(revision_id)s} already present in %(weave)s"""
 
1311
 
 
1312
    _fmt = "Revision {%(revision_id)s} already present in %(weave)s"
 
1313
 
677
1314
    def __init__(self, revision_id, weave):
678
1315
 
679
1316
        WeaveError.__init__(self)
682
1319
 
683
1320
 
684
1321
class WeaveRevisionNotPresent(WeaveError):
685
 
    """Revision {%(revision_id)s} not present in %(weave)s"""
 
1322
 
 
1323
    _fmt = "Revision {%(revision_id)s} not present in %(weave)s"
686
1324
 
687
1325
    def __init__(self, revision_id, weave):
688
1326
        WeaveError.__init__(self)
691
1329
 
692
1330
 
693
1331
class WeaveFormatError(WeaveError):
694
 
    """Weave invariant violated: %(what)s"""
 
1332
 
 
1333
    _fmt = "Weave invariant violated: %(what)s"
695
1334
 
696
1335
    def __init__(self, what):
697
1336
        WeaveError.__init__(self)
699
1338
 
700
1339
 
701
1340
class WeaveParentMismatch(WeaveError):
702
 
    """Parents are mismatched between two revisions."""
 
1341
 
 
1342
    _fmt = "Parents are mismatched between two revisions. %(message)s"
703
1343
    
704
1344
 
705
1345
class WeaveInvalidChecksum(WeaveError):
706
 
    """Text did not match it's checksum: %(message)s"""
707
 
 
708
 
 
709
 
class WeaveTextDiffers(WeaveError):
710
 
    """Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
711
 
 
712
 
    def __init__(self, revision_id, weave_a, weave_b):
713
 
        WeaveError.__init__(self)
714
 
        self.revision_id = revision_id
715
 
        self.weave_a = weave_a
716
 
        self.weave_b = weave_b
717
 
 
718
 
 
719
 
class WeaveTextDiffers(WeaveError):
720
 
    """Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
721
 
 
722
 
    def __init__(self, revision_id, weave_a, weave_b):
723
 
        WeaveError.__init__(self)
724
 
        self.revision_id = revision_id
725
 
        self.weave_a = weave_a
726
 
        self.weave_b = weave_b
727
 
 
728
 
 
729
 
class VersionedFileError(BzrNewError):
730
 
    """Versioned file error."""
 
1346
 
 
1347
    _fmt = "Text did not match it's checksum: %(message)s"
 
1348
 
 
1349
 
 
1350
class WeaveTextDiffers(WeaveError):
 
1351
 
 
1352
    _fmt = ("Weaves differ on text content. Revision:"
 
1353
            " {%(revision_id)s}, %(weave_a)s, %(weave_b)s")
 
1354
 
 
1355
    def __init__(self, revision_id, weave_a, weave_b):
 
1356
        WeaveError.__init__(self)
 
1357
        self.revision_id = revision_id
 
1358
        self.weave_a = weave_a
 
1359
        self.weave_b = weave_b
 
1360
 
 
1361
 
 
1362
class WeaveTextDiffers(WeaveError):
 
1363
 
 
1364
    _fmt = ("Weaves differ on text content. Revision:"
 
1365
            " {%(revision_id)s}, %(weave_a)s, %(weave_b)s")
 
1366
 
 
1367
    def __init__(self, revision_id, weave_a, weave_b):
 
1368
        WeaveError.__init__(self)
 
1369
        self.revision_id = revision_id
 
1370
        self.weave_a = weave_a
 
1371
        self.weave_b = weave_b
 
1372
 
 
1373
 
 
1374
class VersionedFileError(BzrError):
 
1375
    
 
1376
    _fmt = "Versioned file error"
731
1377
 
732
1378
 
733
1379
class RevisionNotPresent(VersionedFileError):
734
 
    """Revision {%(revision_id)s} not present in %(file_id)s."""
 
1380
    
 
1381
    _fmt = 'Revision {%(revision_id)s} not present in "%(file_id)s".'
735
1382
 
736
1383
    def __init__(self, revision_id, file_id):
737
1384
        VersionedFileError.__init__(self)
740
1387
 
741
1388
 
742
1389
class RevisionAlreadyPresent(VersionedFileError):
743
 
    """Revision {%(revision_id)s} already present in %(file_id)s."""
 
1390
    
 
1391
    _fmt = 'Revision {%(revision_id)s} already present in "%(file_id)s".'
744
1392
 
745
1393
    def __init__(self, revision_id, file_id):
746
1394
        VersionedFileError.__init__(self)
748
1396
        self.file_id = file_id
749
1397
 
750
1398
 
751
 
class KnitError(BzrNewError):
752
 
    """Knit error"""
753
 
 
754
 
 
755
 
class KnitHeaderError(KnitError):
756
 
    """Knit header error: %(badline)r unexpected"""
757
 
 
758
 
    def __init__(self, badline):
759
 
        KnitError.__init__(self)
760
 
        self.badline = badline
 
1399
class VersionedFileInvalidChecksum(VersionedFileError):
 
1400
 
 
1401
    _fmt = "Text did not match its checksum: %(message)s"
 
1402
 
 
1403
 
 
1404
class KnitError(InternalBzrError):
 
1405
    
 
1406
    _fmt = "Knit error"
761
1407
 
762
1408
 
763
1409
class KnitCorrupt(KnitError):
764
 
    """Knit %(filename)s corrupt: %(how)s"""
 
1410
 
 
1411
    _fmt = "Knit %(filename)s corrupt: %(how)s"
765
1412
 
766
1413
    def __init__(self, filename, how):
767
1414
        KnitError.__init__(self)
769
1416
        self.how = how
770
1417
 
771
1418
 
772
 
class NoSuchExportFormat(BzrNewError):
773
 
    """Export format %(format)r not supported"""
 
1419
class KnitDataStreamIncompatible(KnitError):
 
1420
    # Not raised anymore, as we can convert data streams.  In future we may
 
1421
    # need it again for more exotic cases, so we're keeping it around for now.
 
1422
 
 
1423
    _fmt = "Cannot insert knit data stream of format \"%(stream_format)s\" into knit of format \"%(target_format)s\"."
 
1424
 
 
1425
    def __init__(self, stream_format, target_format):
 
1426
        self.stream_format = stream_format
 
1427
        self.target_format = target_format
 
1428
        
 
1429
 
 
1430
class KnitDataStreamUnknown(KnitError):
 
1431
    # Indicates a data stream we don't know how to handle.
 
1432
 
 
1433
    _fmt = "Cannot parse knit data stream of format \"%(stream_format)s\"."
 
1434
 
 
1435
    def __init__(self, stream_format):
 
1436
        self.stream_format = stream_format
 
1437
        
 
1438
 
 
1439
class KnitHeaderError(KnitError):
 
1440
 
 
1441
    _fmt = 'Knit header error: %(badline)r unexpected for file "%(filename)s".'
 
1442
 
 
1443
    def __init__(self, badline, filename):
 
1444
        KnitError.__init__(self)
 
1445
        self.badline = badline
 
1446
        self.filename = filename
 
1447
 
 
1448
class KnitIndexUnknownMethod(KnitError):
 
1449
    """Raised when we don't understand the storage method.
 
1450
 
 
1451
    Currently only 'fulltext' and 'line-delta' are supported.
 
1452
    """
 
1453
    
 
1454
    _fmt = ("Knit index %(filename)s does not have a known method"
 
1455
            " in options: %(options)r")
 
1456
 
 
1457
    def __init__(self, filename, options):
 
1458
        KnitError.__init__(self)
 
1459
        self.filename = filename
 
1460
        self.options = options
 
1461
 
 
1462
 
 
1463
class NoSuchExportFormat(BzrError):
 
1464
    
 
1465
    _fmt = "Export format %(format)r not supported"
 
1466
 
774
1467
    def __init__(self, format):
775
 
        BzrNewError.__init__(self)
 
1468
        BzrError.__init__(self)
776
1469
        self.format = format
777
1470
 
778
1471
 
779
 
class TransportError(BzrNewError):
780
 
    """Transport error: %(msg)s %(orig_error)s"""
 
1472
class TransportError(BzrError):
 
1473
    
 
1474
    _fmt = "Transport error: %(msg)s %(orig_error)s"
781
1475
 
782
1476
    def __init__(self, msg=None, orig_error=None):
783
1477
        if msg is None and orig_error is not None:
788
1482
            msg =  ''
789
1483
        self.msg = msg
790
1484
        self.orig_error = orig_error
791
 
        BzrNewError.__init__(self)
792
 
 
 
1485
        BzrError.__init__(self)
 
1486
 
 
1487
 
 
1488
class TooManyConcurrentRequests(InternalBzrError):
 
1489
 
 
1490
    _fmt = ("The medium '%(medium)s' has reached its concurrent request limit."
 
1491
            " Be sure to finish_writing and finish_reading on the"
 
1492
            " currently open request.")
 
1493
 
 
1494
    def __init__(self, medium):
 
1495
        self.medium = medium
 
1496
 
 
1497
 
 
1498
class SmartProtocolError(TransportError):
 
1499
 
 
1500
    _fmt = "Generic bzr smart protocol error: %(details)s"
 
1501
 
 
1502
    def __init__(self, details):
 
1503
        self.details = details
 
1504
 
 
1505
 
 
1506
class UnexpectedProtocolVersionMarker(TransportError):
 
1507
 
 
1508
    _fmt = "Received bad protocol version marker: %(marker)r"
 
1509
 
 
1510
    def __init__(self, marker):
 
1511
        self.marker = marker
 
1512
 
 
1513
 
 
1514
class UnknownSmartMethod(InternalBzrError):
 
1515
 
 
1516
    _fmt = "The server does not recognise the '%(verb)s' request."
 
1517
 
 
1518
    def __init__(self, verb):
 
1519
        self.verb = verb
 
1520
 
 
1521
 
 
1522
class SmartMessageHandlerError(InternalBzrError):
 
1523
 
 
1524
    _fmt = "The message handler raised an exception: %(exc_value)s."
 
1525
 
 
1526
    def __init__(self, exc_info):
 
1527
        self.exc_type, self.exc_value, self.tb = exc_info
 
1528
        
793
1529
 
794
1530
# A set of semi-meaningful errors which can be thrown
795
1531
class TransportNotPossible(TransportError):
796
 
    """Transport operation not possible: %(msg)s %(orig_error)%"""
 
1532
 
 
1533
    _fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
797
1534
 
798
1535
 
799
1536
class ConnectionError(TransportError):
800
 
    """Connection error: %(msg)s %(orig_error)s"""
 
1537
 
 
1538
    _fmt = "Connection error: %(msg)s %(orig_error)s"
 
1539
 
 
1540
 
 
1541
class SocketConnectionError(ConnectionError):
 
1542
 
 
1543
    _fmt = "%(msg)s %(host)s%(port)s%(orig_error)s"
 
1544
 
 
1545
    def __init__(self, host, port=None, msg=None, orig_error=None):
 
1546
        if msg is None:
 
1547
            msg = 'Failed to connect to'
 
1548
        if orig_error is None:
 
1549
            orig_error = ''
 
1550
        else:
 
1551
            orig_error = '; ' + str(orig_error)
 
1552
        ConnectionError.__init__(self, msg=msg, orig_error=orig_error)
 
1553
        self.host = host
 
1554
        if port is None:
 
1555
            self.port = ''
 
1556
        else:
 
1557
            self.port = ':%s' % port
801
1558
 
802
1559
 
803
1560
class ConnectionReset(TransportError):
804
 
    """Connection closed: %(msg)s %(orig_error)s"""
 
1561
 
 
1562
    _fmt = "Connection closed: %(msg)s %(orig_error)s"
805
1563
 
806
1564
 
807
1565
class InvalidRange(TransportError):
808
 
    """Invalid range access in %(path)s at %(offset)s."""
809
 
    
810
 
    def __init__(self, path, offset):
811
 
        TransportError.__init__(self, ("Invalid range access in %s at %d"
812
 
                                       % (path, offset)))
 
1566
 
 
1567
    _fmt = "Invalid range access in %(path)s at %(offset)s: %(msg)s"
 
1568
 
 
1569
    def __init__(self, path, offset, msg=None):
 
1570
        TransportError.__init__(self, msg)
813
1571
        self.path = path
814
1572
        self.offset = offset
815
1573
 
816
1574
 
817
1575
class InvalidHttpResponse(TransportError):
818
 
    """Invalid http response for %(path)s: %(msg)s"""
 
1576
 
 
1577
    _fmt = "Invalid http response for %(path)s: %(msg)s"
819
1578
 
820
1579
    def __init__(self, path, msg, orig_error=None):
821
1580
        self.path = path
823
1582
 
824
1583
 
825
1584
class InvalidHttpRange(InvalidHttpResponse):
826
 
    """Invalid http range "%(range)s" for %(path)s: %(msg)s"""
827
 
    
 
1585
 
 
1586
    _fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
 
1587
 
828
1588
    def __init__(self, path, range, msg):
829
1589
        self.range = range
830
1590
        InvalidHttpResponse.__init__(self, path, msg)
831
1591
 
832
1592
 
833
1593
class InvalidHttpContentType(InvalidHttpResponse):
834
 
    """Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s"""
835
 
    
 
1594
 
 
1595
    _fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
 
1596
 
836
1597
    def __init__(self, path, ctype, msg):
837
1598
        self.ctype = ctype
838
1599
        InvalidHttpResponse.__init__(self, path, msg)
839
1600
 
840
1601
 
 
1602
class RedirectRequested(TransportError):
 
1603
 
 
1604
    _fmt = '%(source)s is%(permanently)s redirected to %(target)s'
 
1605
 
 
1606
    def __init__(self, source, target, is_permanent=False, qual_proto=None):
 
1607
        self.source = source
 
1608
        self.target = target
 
1609
        if is_permanent:
 
1610
            self.permanently = ' permanently'
 
1611
        else:
 
1612
            self.permanently = ''
 
1613
        self._qualified_proto = qual_proto
 
1614
        TransportError.__init__(self)
 
1615
 
 
1616
    def _requalify_url(self, url):
 
1617
        """Restore the qualified proto in front of the url"""
 
1618
        # When this exception is raised, source and target are in
 
1619
        # user readable format. But some transports may use a
 
1620
        # different proto (http+urllib:// will present http:// to
 
1621
        # the user. If a qualified proto is specified, the code
 
1622
        # trapping the exception can get the qualified urls to
 
1623
        # properly handle the redirection themself (creating a
 
1624
        # new transport object from the target url for example).
 
1625
        # But checking that the scheme of the original and
 
1626
        # redirected urls are the same can be tricky. (see the
 
1627
        # FIXME in BzrDir.open_from_transport for the unique use
 
1628
        # case so far).
 
1629
        if self._qualified_proto is None:
 
1630
            return url
 
1631
 
 
1632
        # The TODO related to NotBranchError mention that doing
 
1633
        # that kind of manipulation on the urls may not be the
 
1634
        # exception object job. On the other hand, this object is
 
1635
        # the interface between the code and the user so
 
1636
        # presenting the urls in different ways is indeed its
 
1637
        # job...
 
1638
        import urlparse
 
1639
        proto, netloc, path, query, fragment = urlparse.urlsplit(url)
 
1640
        return urlparse.urlunsplit((self._qualified_proto, netloc, path,
 
1641
                                   query, fragment))
 
1642
 
 
1643
    def get_source_url(self):
 
1644
        return self._requalify_url(self.source)
 
1645
 
 
1646
    def get_target_url(self):
 
1647
        return self._requalify_url(self.target)
 
1648
 
 
1649
 
 
1650
class TooManyRedirections(TransportError):
 
1651
 
 
1652
    _fmt = "Too many redirections"
 
1653
 
 
1654
 
841
1655
class ConflictsInTree(BzrError):
842
 
    def __init__(self):
843
 
        BzrError.__init__(self, "Working tree has conflicts.")
 
1656
 
 
1657
    _fmt = "Working tree has conflicts."
844
1658
 
845
1659
 
846
1660
class ParseConfigError(BzrError):
 
1661
 
847
1662
    def __init__(self, errors, filename):
848
1663
        if filename is None:
849
1664
            filename = ""
852
1667
        BzrError.__init__(self, message)
853
1668
 
854
1669
 
 
1670
class NoEmailInUsername(BzrError):
 
1671
 
 
1672
    _fmt = "%(username)r does not seem to contain a reasonable email address"
 
1673
 
 
1674
    def __init__(self, username):
 
1675
        BzrError.__init__(self)
 
1676
        self.username = username
 
1677
 
 
1678
 
855
1679
class SigningFailed(BzrError):
 
1680
 
 
1681
    _fmt = 'Failed to gpg sign data with command "%(command_line)s"'
 
1682
 
856
1683
    def __init__(self, command_line):
857
 
        BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
858
 
                               % command_line)
 
1684
        BzrError.__init__(self, command_line=command_line)
859
1685
 
860
1686
 
861
1687
class WorkingTreeNotRevision(BzrError):
 
1688
 
 
1689
    _fmt = ("The working tree for %(basedir)s has changed since" 
 
1690
            " the last commit, but weave merge requires that it be"
 
1691
            " unchanged")
 
1692
 
862
1693
    def __init__(self, tree):
863
 
        BzrError.__init__(self, "The working tree for %s has changed since"
864
 
                          " last commit, but weave merge requires that it be"
865
 
                          " unchanged." % tree.basedir)
866
 
 
867
 
 
868
 
class CantReprocessAndShowBase(BzrNewError):
869
 
    """Can't reprocess and show base.
870
 
Reprocessing obscures relationship of conflicting lines to base."""
871
 
 
872
 
 
873
 
class GraphCycleError(BzrNewError):
874
 
    """Cycle in graph %(graph)r"""
 
1694
        BzrError.__init__(self, basedir=tree.basedir)
 
1695
 
 
1696
 
 
1697
class CantReprocessAndShowBase(BzrError):
 
1698
 
 
1699
    _fmt = ("Can't reprocess and show base, because reprocessing obscures "
 
1700
           "the relationship of conflicting lines to the base")
 
1701
 
 
1702
 
 
1703
class GraphCycleError(BzrError):
 
1704
 
 
1705
    _fmt = "Cycle in graph %(graph)r"
 
1706
 
875
1707
    def __init__(self, graph):
876
 
        BzrNewError.__init__(self)
 
1708
        BzrError.__init__(self)
877
1709
        self.graph = graph
878
1710
 
879
1711
 
880
 
class NotConflicted(BzrNewError):
881
 
    """File %(filename)s is not conflicted."""
 
1712
class WritingCompleted(InternalBzrError):
 
1713
 
 
1714
    _fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
 
1715
            "called upon it - accept bytes may not be called anymore.")
 
1716
 
 
1717
    def __init__(self, request):
 
1718
        self.request = request
 
1719
 
 
1720
 
 
1721
class WritingNotComplete(InternalBzrError):
 
1722
 
 
1723
    _fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
 
1724
            "called upon it - until the write phase is complete no "
 
1725
            "data may be read.")
 
1726
 
 
1727
    def __init__(self, request):
 
1728
        self.request = request
 
1729
 
 
1730
 
 
1731
class NotConflicted(BzrError):
 
1732
 
 
1733
    _fmt = "File %(filename)s is not conflicted."
882
1734
 
883
1735
    def __init__(self, filename):
884
 
        BzrNewError.__init__(self)
 
1736
        BzrError.__init__(self)
885
1737
        self.filename = filename
886
1738
 
887
1739
 
 
1740
class MediumNotConnected(InternalBzrError):
 
1741
 
 
1742
    _fmt = """The medium '%(medium)s' is not connected."""
 
1743
 
 
1744
    def __init__(self, medium):
 
1745
        self.medium = medium
 
1746
 
 
1747
 
888
1748
class MustUseDecorated(Exception):
889
 
    """A decorating function has requested its original command be used.
890
 
    
891
 
    This should never escape bzr, so does not need to be printable.
892
 
    """
893
 
 
894
 
 
895
 
class NoBundleFound(BzrNewError):
896
 
    """No bundle was found in %(filename)s"""
 
1749
 
 
1750
    _fmt = "A decorating function has requested its original command be used."
 
1751
 
 
1752
 
 
1753
class NoBundleFound(BzrError):
 
1754
 
 
1755
    _fmt = 'No bundle was found in "%(filename)s".'
 
1756
 
897
1757
    def __init__(self, filename):
898
 
        BzrNewError.__init__(self)
 
1758
        BzrError.__init__(self)
899
1759
        self.filename = filename
900
1760
 
901
1761
 
902
 
class BundleNotSupported(BzrNewError):
903
 
    """Unable to handle bundle version %(version)s: %(msg)s"""
 
1762
class BundleNotSupported(BzrError):
 
1763
 
 
1764
    _fmt = "Unable to handle bundle version %(version)s: %(msg)s"
 
1765
 
904
1766
    def __init__(self, version, msg):
905
 
        BzrNewError.__init__(self)
 
1767
        BzrError.__init__(self)
906
1768
        self.version = version
907
1769
        self.msg = msg
908
1770
 
909
1771
 
910
 
class MissingText(BzrNewError):
911
 
    """Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"""
 
1772
class MissingText(BzrError):
 
1773
 
 
1774
    _fmt = ("Branch %(base)s is missing revision"
 
1775
            " %(text_revision)s of %(file_id)s")
912
1776
 
913
1777
    def __init__(self, branch, text_revision, file_id):
914
 
        BzrNewError.__init__(self)
 
1778
        BzrError.__init__(self)
915
1779
        self.branch = branch
916
1780
        self.base = branch.base
917
1781
        self.text_revision = text_revision
918
1782
        self.file_id = file_id
919
1783
 
920
1784
 
921
 
class DuplicateKey(BzrNewError):
922
 
    """Key %(key)s is already present in map"""
923
 
 
924
 
 
925
 
class MalformedTransform(BzrNewError):
926
 
    """Tree transform is malformed %(conflicts)r"""
927
 
 
928
 
 
929
 
class BzrBadParameter(BzrNewError):
930
 
    """A bad parameter : %(param)s is not usable.
931
 
    
932
 
    This exception should never be thrown, but it is a base class for all
933
 
    parameter-to-function errors.
934
 
    """
 
1785
class DuplicateFileId(BzrError):
 
1786
 
 
1787
    _fmt = "File id {%(file_id)s} already exists in inventory as %(entry)s"
 
1788
 
 
1789
    def __init__(self, file_id, entry):
 
1790
        BzrError.__init__(self)
 
1791
        self.file_id = file_id
 
1792
        self.entry = entry
 
1793
 
 
1794
 
 
1795
class DuplicateKey(BzrError):
 
1796
 
 
1797
    _fmt = "Key %(key)s is already present in map"
 
1798
 
 
1799
 
 
1800
class DuplicateHelpPrefix(BzrError):
 
1801
 
 
1802
    _fmt = "The prefix %(prefix)s is in the help search path twice."
 
1803
 
 
1804
    def __init__(self, prefix):
 
1805
        self.prefix = prefix
 
1806
 
 
1807
 
 
1808
class MalformedTransform(BzrError):
 
1809
 
 
1810
    _fmt = "Tree transform is malformed %(conflicts)r"
 
1811
 
 
1812
 
 
1813
class NoFinalPath(BzrError):
 
1814
 
 
1815
    _fmt = ("No final name for trans_id %(trans_id)r\n"
 
1816
            "file-id: %(file_id)r\n"
 
1817
            "root trans-id: %(root_trans_id)r\n")
 
1818
 
 
1819
    def __init__(self, trans_id, transform):
 
1820
        self.trans_id = trans_id
 
1821
        self.file_id = transform.final_file_id(trans_id)
 
1822
        self.root_trans_id = transform.root
 
1823
 
 
1824
 
 
1825
class BzrBadParameter(InternalBzrError):
 
1826
 
 
1827
    _fmt = "Bad parameter: %(param)r"
 
1828
 
 
1829
    # This exception should never be thrown, but it is a base class for all
 
1830
    # parameter-to-function errors.
 
1831
 
935
1832
    def __init__(self, param):
936
 
        BzrNewError.__init__(self)
 
1833
        BzrError.__init__(self)
937
1834
        self.param = param
938
1835
 
939
1836
 
940
1837
class BzrBadParameterNotUnicode(BzrBadParameter):
941
 
    """Parameter %(param)s is neither unicode nor utf8."""
942
 
 
943
 
 
944
 
class ReusingTransform(BzrNewError):
945
 
    """Attempt to reuse a transform that has already been applied."""
946
 
 
947
 
 
948
 
class CantMoveRoot(BzrNewError):
949
 
    """Moving the root directory is not supported at this time"""
 
1838
 
 
1839
    _fmt = "Parameter %(param)s is neither unicode nor utf8."
 
1840
 
 
1841
 
 
1842
class ReusingTransform(BzrError):
 
1843
 
 
1844
    _fmt = "Attempt to reuse a transform that has already been applied."
 
1845
 
 
1846
 
 
1847
class CantMoveRoot(BzrError):
 
1848
 
 
1849
    _fmt = "Moving the root directory is not supported at this time"
 
1850
 
 
1851
 
 
1852
class BzrMoveFailedError(BzrError):
 
1853
 
 
1854
    _fmt = "Could not move %(from_path)s%(operator)s %(to_path)s%(extra)s"
 
1855
 
 
1856
    def __init__(self, from_path='', to_path='', extra=None):
 
1857
        BzrError.__init__(self)
 
1858
        if extra:
 
1859
            self.extra = ': ' + str(extra)
 
1860
        else:
 
1861
            self.extra = ''
 
1862
 
 
1863
        has_from = len(from_path) > 0
 
1864
        has_to = len(to_path) > 0
 
1865
        if has_from:
 
1866
            self.from_path = osutils.splitpath(from_path)[-1]
 
1867
        else:
 
1868
            self.from_path = ''
 
1869
 
 
1870
        if has_to:
 
1871
            self.to_path = osutils.splitpath(to_path)[-1]
 
1872
        else:
 
1873
            self.to_path = ''
 
1874
 
 
1875
        self.operator = ""
 
1876
        if has_from and has_to:
 
1877
            self.operator = " =>"
 
1878
        elif has_from:
 
1879
            self.from_path = "from " + from_path
 
1880
        elif has_to:
 
1881
            self.operator = "to"
 
1882
        else:
 
1883
            self.operator = "file"
 
1884
 
 
1885
 
 
1886
class BzrRenameFailedError(BzrMoveFailedError):
 
1887
 
 
1888
    _fmt = "Could not rename %(from_path)s%(operator)s %(to_path)s%(extra)s"
 
1889
 
 
1890
    def __init__(self, from_path, to_path, extra=None):
 
1891
        BzrMoveFailedError.__init__(self, from_path, to_path, extra)
 
1892
 
 
1893
class BzrRemoveChangedFilesError(BzrError):
 
1894
    """Used when user is trying to remove changed files."""
 
1895
 
 
1896
    _fmt = ("Can't safely remove modified or unknown files:\n"
 
1897
        "%(changes_as_text)s"
 
1898
        "Use --keep to not delete them, or --force to delete them regardless.")
 
1899
 
 
1900
    def __init__(self, tree_delta):
 
1901
        BzrError.__init__(self)
 
1902
        self.changes_as_text = tree_delta.get_changes_as_text()
 
1903
        #self.paths_as_string = '\n'.join(changed_files)
 
1904
        #self.paths_as_string = '\n'.join([quotefn(p) for p in changed_files])
950
1905
 
951
1906
 
952
1907
class BzrBadParameterNotString(BzrBadParameter):
953
 
    """Parameter %(param)s is not a string or unicode string."""
 
1908
 
 
1909
    _fmt = "Parameter %(param)s is not a string or unicode string."
954
1910
 
955
1911
 
956
1912
class BzrBadParameterMissing(BzrBadParameter):
957
 
    """Parameter $(param)s is required but not present."""
 
1913
 
 
1914
    _fmt = "Parameter $(param)s is required but not present."
958
1915
 
959
1916
 
960
1917
class BzrBadParameterUnicode(BzrBadParameter):
961
 
    """Parameter %(param)s is unicode but only byte-strings are permitted."""
 
1918
 
 
1919
    _fmt = ("Parameter %(param)s is unicode but"
 
1920
            " only byte-strings are permitted.")
962
1921
 
963
1922
 
964
1923
class BzrBadParameterContainsNewline(BzrBadParameter):
965
 
    """Parameter %(param)s contains a newline."""
966
 
 
967
 
 
968
 
class DependencyNotPresent(BzrNewError):
969
 
    """Unable to import library "%(library)s": %(error)s"""
 
1924
 
 
1925
    _fmt = "Parameter %(param)s contains a newline."
 
1926
 
 
1927
 
 
1928
class DependencyNotPresent(BzrError):
 
1929
 
 
1930
    _fmt = 'Unable to import library "%(library)s": %(error)s'
970
1931
 
971
1932
    def __init__(self, library, error):
972
 
        BzrNewError.__init__(self, library=library, error=error)
 
1933
        BzrError.__init__(self, library=library, error=error)
973
1934
 
974
1935
 
975
1936
class ParamikoNotPresent(DependencyNotPresent):
976
 
    """Unable to import paramiko (required for sftp support): %(error)s"""
 
1937
 
 
1938
    _fmt = "Unable to import paramiko (required for sftp support): %(error)s"
977
1939
 
978
1940
    def __init__(self, error):
979
1941
        DependencyNotPresent.__init__(self, 'paramiko', error)
980
1942
 
981
1943
 
982
 
class PointlessMerge(BzrNewError):
983
 
    """Nothing to merge."""
984
 
 
985
 
 
986
 
class UninitializableFormat(BzrNewError):
987
 
    """Format %(format)s cannot be initialised by this version of bzr."""
 
1944
class PointlessMerge(BzrError):
 
1945
 
 
1946
    _fmt = "Nothing to merge."
 
1947
 
 
1948
 
 
1949
class UninitializableFormat(BzrError):
 
1950
 
 
1951
    _fmt = "Format %(format)s cannot be initialised by this version of bzr."
988
1952
 
989
1953
    def __init__(self, format):
990
 
        BzrNewError.__init__(self)
 
1954
        BzrError.__init__(self)
991
1955
        self.format = format
992
1956
 
993
1957
 
994
 
class BadConversionTarget(BzrNewError):
995
 
    """Cannot convert to format %(format)s.  %(problem)s"""
 
1958
class BadConversionTarget(BzrError):
 
1959
 
 
1960
    _fmt = "Cannot convert to format %(format)s.  %(problem)s"
996
1961
 
997
1962
    def __init__(self, problem, format):
998
 
        BzrNewError.__init__(self)
 
1963
        BzrError.__init__(self)
999
1964
        self.problem = problem
1000
1965
        self.format = format
1001
1966
 
1002
1967
 
1003
 
class NoDiff(BzrNewError):
1004
 
    """Diff is not installed on this machine: %(msg)s"""
 
1968
class NoDiffFound(BzrError):
 
1969
 
 
1970
    _fmt = 'Could not find an appropriate Differ for file "%(path)s"'
 
1971
 
 
1972
    def __init__(self, path):
 
1973
        BzrError.__init__(self, path)
 
1974
 
 
1975
 
 
1976
class ExecutableMissing(BzrError):
 
1977
 
 
1978
    _fmt = "%(exe_name)s could not be found on this machine"
 
1979
 
 
1980
    def __init__(self, exe_name):
 
1981
        BzrError.__init__(self, exe_name=exe_name)
 
1982
 
 
1983
 
 
1984
class NoDiff(BzrError):
 
1985
 
 
1986
    _fmt = "Diff is not installed on this machine: %(msg)s"
1005
1987
 
1006
1988
    def __init__(self, msg):
1007
 
        BzrNewError.__init__(self, msg=msg)
1008
 
 
1009
 
 
1010
 
class NoDiff3(BzrNewError):
1011
 
    """Diff3 is not installed on this machine."""
1012
 
 
1013
 
 
1014
 
class ExistingLimbo(BzrNewError):
1015
 
    """This tree contains left-over files from a failed operation.
1016
 
    Please examine %(limbo_dir)s to see if it contains any files you wish to
1017
 
    keep, and delete it when you are done.
1018
 
    """
1019
 
    def __init__(self, limbo_dir):
1020
 
       BzrNewError.__init__(self)
1021
 
       self.limbo_dir = limbo_dir
1022
 
 
1023
 
 
1024
 
class ImmortalLimbo(BzrNewError):
1025
 
    """Unable to delete transform temporary directory $(limbo_dir)s.
1026
 
    Please examine %(limbo_dir)s to see if it contains any files you wish to
1027
 
    keep, and delete it when you are done.
1028
 
    """
1029
 
    def __init__(self, limbo_dir):
1030
 
       BzrNewError.__init__(self)
1031
 
       self.limbo_dir = limbo_dir
1032
 
 
1033
 
 
1034
 
class OutOfDateTree(BzrNewError):
1035
 
    """Working tree is out of date, please run 'bzr update'."""
 
1989
        BzrError.__init__(self, msg=msg)
 
1990
 
 
1991
 
 
1992
class NoDiff3(BzrError):
 
1993
 
 
1994
    _fmt = "Diff3 is not installed on this machine."
 
1995
 
 
1996
 
 
1997
class ExistingContent(BzrError):
 
1998
    # Added in bzrlib 0.92, used by VersionedFile.add_lines.
 
1999
 
 
2000
    _fmt = "The content being inserted is already present."
 
2001
 
 
2002
 
 
2003
class ExistingLimbo(BzrError):
 
2004
 
 
2005
    _fmt = """This tree contains left-over files from a failed operation.
 
2006
    Please examine %(limbo_dir)s to see if it contains any files you wish to
 
2007
    keep, and delete it when you are done."""
 
2008
    
 
2009
    def __init__(self, limbo_dir):
 
2010
       BzrError.__init__(self)
 
2011
       self.limbo_dir = limbo_dir
 
2012
 
 
2013
 
 
2014
class ExistingPendingDeletion(BzrError):
 
2015
 
 
2016
    _fmt = """This tree contains left-over files from a failed operation.
 
2017
    Please examine %(pending_deletion)s to see if it contains any files you
 
2018
    wish to keep, and delete it when you are done."""
 
2019
 
 
2020
    def __init__(self, pending_deletion):
 
2021
       BzrError.__init__(self, pending_deletion=pending_deletion)
 
2022
 
 
2023
 
 
2024
class ImmortalLimbo(BzrError):
 
2025
 
 
2026
    _fmt = """Unable to delete transform temporary directory %(limbo_dir)s.
 
2027
    Please examine %(limbo_dir)s to see if it contains any files you wish to
 
2028
    keep, and delete it when you are done."""
 
2029
 
 
2030
    def __init__(self, limbo_dir):
 
2031
       BzrError.__init__(self)
 
2032
       self.limbo_dir = limbo_dir
 
2033
 
 
2034
 
 
2035
class ImmortalPendingDeletion(BzrError):
 
2036
 
 
2037
    _fmt = ("Unable to delete transform temporary directory "
 
2038
    "%(pending_deletion)s.  Please examine %(pending_deletion)s to see if it "
 
2039
    "contains any files you wish to keep, and delete it when you are done.")
 
2040
 
 
2041
    def __init__(self, pending_deletion):
 
2042
       BzrError.__init__(self, pending_deletion=pending_deletion)
 
2043
 
 
2044
 
 
2045
class OutOfDateTree(BzrError):
 
2046
 
 
2047
    _fmt = "Working tree is out of date, please run 'bzr update'."
1036
2048
 
1037
2049
    def __init__(self, tree):
1038
 
        BzrNewError.__init__(self)
 
2050
        BzrError.__init__(self)
1039
2051
        self.tree = tree
1040
2052
 
1041
2053
 
1042
 
class MergeModifiedFormatError(BzrNewError):
1043
 
    """Error in merge modified format"""
1044
 
 
1045
 
 
1046
 
class ConflictFormatError(BzrNewError):
1047
 
    """Format error in conflict listings"""
1048
 
 
1049
 
 
1050
 
class CorruptRepository(BzrNewError):
1051
 
    """An error has been detected in the repository %(repo_path)s.
1052
 
Please run bzr reconcile on this repository."""
 
2054
class PublicBranchOutOfDate(BzrError):
 
2055
 
 
2056
    _fmt = 'Public branch "%(public_location)s" lacks revision '\
 
2057
        '"%(revstring)s".'
 
2058
 
 
2059
    def __init__(self, public_location, revstring):
 
2060
        import bzrlib.urlutils as urlutils
 
2061
        public_location = urlutils.unescape_for_display(public_location,
 
2062
                                                        'ascii')
 
2063
        BzrError.__init__(self, public_location=public_location,
 
2064
                          revstring=revstring)
 
2065
 
 
2066
 
 
2067
class MergeModifiedFormatError(BzrError):
 
2068
 
 
2069
    _fmt = "Error in merge modified format"
 
2070
 
 
2071
 
 
2072
class ConflictFormatError(BzrError):
 
2073
 
 
2074
    _fmt = "Format error in conflict listings"
 
2075
 
 
2076
 
 
2077
class CorruptDirstate(BzrError):
 
2078
 
 
2079
    _fmt = ("Inconsistency in dirstate file %(dirstate_path)s.\n"
 
2080
            "Error: %(description)s")
 
2081
 
 
2082
    def __init__(self, dirstate_path, description):
 
2083
        BzrError.__init__(self)
 
2084
        self.dirstate_path = dirstate_path
 
2085
        self.description = description
 
2086
 
 
2087
 
 
2088
class CorruptRepository(BzrError):
 
2089
 
 
2090
    _fmt = ("An error has been detected in the repository %(repo_path)s.\n"
 
2091
            "Please run bzr reconcile on this repository.")
1053
2092
 
1054
2093
    def __init__(self, repo):
1055
 
        BzrNewError.__init__(self)
 
2094
        BzrError.__init__(self)
1056
2095
        self.repo_path = repo.bzrdir.root_transport.base
1057
2096
 
1058
2097
 
1059
 
class UpgradeRequired(BzrNewError):
1060
 
    """To use this feature you must upgrade your branch at %(path)s."""
 
2098
class InconsistentDelta(BzrError):
 
2099
    """Used when we get a delta that is not valid."""
 
2100
 
 
2101
    _fmt = ("An inconsistent delta was supplied involving %(path)r,"
 
2102
            " %(file_id)r\nreason: %(reason)s")
 
2103
 
 
2104
    def __init__(self, path, file_id, reason):
 
2105
        BzrError.__init__(self)
 
2106
        self.path = path
 
2107
        self.file_id = file_id
 
2108
        self.reason = reason
 
2109
 
 
2110
 
 
2111
class UpgradeRequired(BzrError):
 
2112
 
 
2113
    _fmt = "To use this feature you must upgrade your branch at %(path)s."
1061
2114
 
1062
2115
    def __init__(self, path):
1063
 
        BzrNewError.__init__(self)
 
2116
        BzrError.__init__(self)
1064
2117
        self.path = path
1065
2118
 
1066
2119
 
1067
 
class LocalRequiresBoundBranch(BzrNewError):
1068
 
    """Cannot perform local-only commits on unbound branches."""
1069
 
 
1070
 
 
1071
 
class MissingProgressBarFinish(BzrNewError):
1072
 
    """A nested progress bar was not 'finished' correctly."""
1073
 
 
1074
 
 
1075
 
class InvalidProgressBarType(BzrNewError):
1076
 
    """Environment variable BZR_PROGRESS_BAR='%(bar_type)s is not a supported type
1077
 
Select one of: %(valid_types)s"""
 
2120
class RepositoryUpgradeRequired(UpgradeRequired):
 
2121
 
 
2122
    _fmt = "To use this feature you must upgrade your repository at %(path)s."
 
2123
 
 
2124
 
 
2125
class LocalRequiresBoundBranch(BzrError):
 
2126
 
 
2127
    _fmt = "Cannot perform local-only commits on unbound branches."
 
2128
 
 
2129
 
 
2130
class MissingProgressBarFinish(BzrError):
 
2131
 
 
2132
    _fmt = "A nested progress bar was not 'finished' correctly."
 
2133
 
 
2134
 
 
2135
class InvalidProgressBarType(BzrError):
 
2136
 
 
2137
    _fmt = ("Environment variable BZR_PROGRESS_BAR='%(bar_type)s"
 
2138
            " is not a supported type Select one of: %(valid_types)s")
1078
2139
 
1079
2140
    def __init__(self, bar_type, valid_types):
1080
 
        BzrNewError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1081
 
 
1082
 
 
1083
 
class UnsupportedOperation(BzrNewError):
1084
 
    """The method %(mname)s is not supported on objects of type %(tname)s."""
 
2141
        BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
 
2142
 
 
2143
 
 
2144
class UnsupportedOperation(BzrError):
 
2145
 
 
2146
    _fmt = ("The method %(mname)s is not supported on"
 
2147
            " objects of type %(tname)s.")
 
2148
 
1085
2149
    def __init__(self, method, method_self):
1086
2150
        self.method = method
1087
2151
        self.mname = method.__name__
1088
2152
        self.tname = type(method_self).__name__
1089
2153
 
1090
2154
 
1091
 
class BinaryFile(BzrNewError):
1092
 
    """File is binary but should be text."""
1093
 
 
1094
 
 
1095
 
class IllegalPath(BzrNewError):
1096
 
    """The path %(path)s is not permitted on this platform"""
 
2155
class CannotSetRevisionId(UnsupportedOperation):
 
2156
    """Raised when a commit is attempting to set a revision id but cant."""
 
2157
 
 
2158
 
 
2159
class NonAsciiRevisionId(UnsupportedOperation):
 
2160
    """Raised when a commit is attempting to set a non-ascii revision id
 
2161
       but cant.
 
2162
    """
 
2163
 
 
2164
 
 
2165
class BinaryFile(BzrError):
 
2166
    
 
2167
    _fmt = "File is binary but should be text."
 
2168
 
 
2169
 
 
2170
class IllegalPath(BzrError):
 
2171
 
 
2172
    _fmt = "The path %(path)s is not permitted on this platform"
1097
2173
 
1098
2174
    def __init__(self, path):
1099
 
        BzrNewError.__init__(self)
 
2175
        BzrError.__init__(self)
1100
2176
        self.path = path
1101
2177
 
1102
2178
 
1103
 
class TestamentMismatch(BzrNewError):
1104
 
    """Testament did not match expected value.  
1105
 
       For revision_id {%(revision_id)s}, expected {%(expected)s}, measured 
1106
 
       {%(measured)s}
1107
 
    """
 
2179
class TestamentMismatch(BzrError):
 
2180
 
 
2181
    _fmt = """Testament did not match expected value.
 
2182
       For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
 
2183
       {%(measured)s}"""
 
2184
 
1108
2185
    def __init__(self, revision_id, expected, measured):
1109
2186
        self.revision_id = revision_id
1110
2187
        self.expected = expected
1111
2188
        self.measured = measured
1112
2189
 
1113
2190
 
1114
 
class NotABundle(BzrNewError):
1115
 
    """Not a bzr revision-bundle: %(text)r"""
 
2191
class NotABundle(BzrError):
 
2192
    
 
2193
    _fmt = "Not a bzr revision-bundle: %(text)r"
1116
2194
 
1117
2195
    def __init__(self, text):
1118
 
        BzrNewError.__init__(self)
 
2196
        BzrError.__init__(self)
1119
2197
        self.text = text
1120
2198
 
1121
2199
 
1122
 
class BadBundle(BzrNewError): 
1123
 
    """Bad bzr revision-bundle: %(text)r"""
 
2200
class BadBundle(BzrError): 
 
2201
    
 
2202
    _fmt = "Bad bzr revision-bundle: %(text)r"
1124
2203
 
1125
2204
    def __init__(self, text):
1126
 
        BzrNewError.__init__(self)
 
2205
        BzrError.__init__(self)
1127
2206
        self.text = text
1128
2207
 
1129
2208
 
1130
2209
class MalformedHeader(BadBundle): 
1131
 
    """Malformed bzr revision-bundle header: %(text)r"""
1132
 
 
1133
 
    def __init__(self, text):
1134
 
        BzrNewError.__init__(self)
1135
 
        self.text = text
 
2210
    
 
2211
    _fmt = "Malformed bzr revision-bundle header: %(text)r"
1136
2212
 
1137
2213
 
1138
2214
class MalformedPatches(BadBundle): 
1139
 
    """Malformed patches in bzr revision-bundle: %(text)r"""
1140
 
 
1141
 
    def __init__(self, text):
1142
 
        BzrNewError.__init__(self)
1143
 
        self.text = text
 
2215
    
 
2216
    _fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1144
2217
 
1145
2218
 
1146
2219
class MalformedFooter(BadBundle): 
1147
 
    """Malformed footer in bzr revision-bundle: %(text)r"""
1148
 
 
1149
 
    def __init__(self, text):
1150
 
        BzrNewError.__init__(self)
1151
 
        self.text = text
 
2220
    
 
2221
    _fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1152
2222
 
1153
2223
 
1154
2224
class UnsupportedEOLMarker(BadBundle):
1155
 
    """End of line marker was not \\n in bzr revision-bundle"""    
 
2225
    
 
2226
    _fmt = "End of line marker was not \\n in bzr revision-bundle"    
1156
2227
 
1157
2228
    def __init__(self):
1158
 
        BzrNewError.__init__(self)
1159
 
 
1160
 
 
1161
 
class BadInventoryFormat(BzrNewError):
1162
 
    """Root class for inventory serialization errors"""
 
2229
        # XXX: BadBundle's constructor assumes there's explanatory text, 
 
2230
        # but for this there is not
 
2231
        BzrError.__init__(self)
 
2232
 
 
2233
 
 
2234
class IncompatibleBundleFormat(BzrError):
 
2235
    
 
2236
    _fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
 
2237
 
 
2238
    def __init__(self, bundle_format, other):
 
2239
        BzrError.__init__(self)
 
2240
        self.bundle_format = bundle_format
 
2241
        self.other = other
 
2242
 
 
2243
 
 
2244
class BadInventoryFormat(BzrError):
 
2245
    
 
2246
    _fmt = "Root class for inventory serialization errors"
1163
2247
 
1164
2248
 
1165
2249
class UnexpectedInventoryFormat(BadInventoryFormat):
1166
 
    """The inventory was not in the expected format:\n %(msg)s"""
 
2250
 
 
2251
    _fmt = "The inventory was not in the expected format:\n %(msg)s"
1167
2252
 
1168
2253
    def __init__(self, msg):
1169
2254
        BadInventoryFormat.__init__(self, msg=msg)
1170
2255
 
1171
2256
 
1172
 
class UnknownSSH(BzrNewError):
1173
 
    """Unrecognised value for BZR_SSH environment variable: %(vendor)s"""
 
2257
class RootNotRich(BzrError):
 
2258
 
 
2259
    _fmt = """This operation requires rich root data storage"""
 
2260
 
 
2261
 
 
2262
class NoSmartMedium(InternalBzrError):
 
2263
 
 
2264
    _fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
 
2265
 
 
2266
    def __init__(self, transport):
 
2267
        self.transport = transport
 
2268
 
 
2269
 
 
2270
class NoSmartServer(NotBranchError):
 
2271
 
 
2272
    _fmt = "No smart server available at %(url)s"
 
2273
 
 
2274
    @symbol_versioning.deprecated_method(symbol_versioning.one_four)
 
2275
    def __init__(self, url):
 
2276
        self.url = url
 
2277
 
 
2278
 
 
2279
class UnknownSSH(BzrError):
 
2280
 
 
2281
    _fmt = "Unrecognised value for BZR_SSH environment variable: %(vendor)s"
1174
2282
 
1175
2283
    def __init__(self, vendor):
1176
 
        BzrNewError.__init__(self)
 
2284
        BzrError.__init__(self)
1177
2285
        self.vendor = vendor
1178
2286
 
1179
2287
 
1180
 
class GhostRevisionUnusableHere(BzrNewError):
1181
 
    """Ghost revision {%(revision_id)s} cannot be used here."""
 
2288
class SSHVendorNotFound(BzrError):
 
2289
 
 
2290
    _fmt = ("Don't know how to handle SSH connections."
 
2291
            " Please set BZR_SSH environment variable.")
 
2292
 
 
2293
 
 
2294
class GhostRevisionsHaveNoRevno(BzrError):
 
2295
    """When searching for revnos, if we encounter a ghost, we are stuck"""
 
2296
 
 
2297
    _fmt = ("Could not determine revno for {%(revision_id)s} because"
 
2298
            " its ancestry shows a ghost at {%(ghost_revision_id)s}")
 
2299
 
 
2300
    def __init__(self, revision_id, ghost_revision_id):
 
2301
        self.revision_id = revision_id
 
2302
        self.ghost_revision_id = ghost_revision_id
 
2303
 
 
2304
        
 
2305
class GhostRevisionUnusableHere(BzrError):
 
2306
 
 
2307
    _fmt = "Ghost revision {%(revision_id)s} cannot be used here."
1182
2308
 
1183
2309
    def __init__(self, revision_id):
1184
 
        BzrNewError.__init__(self)
 
2310
        BzrError.__init__(self)
1185
2311
        self.revision_id = revision_id
1186
2312
 
1187
2313
 
1188
 
class IllegalUseOfScopeReplacer(BzrNewError):
1189
 
    """ScopeReplacer object %(name)r was used incorrectly: %(msg)s%(extra)s"""
 
2314
class IllegalUseOfScopeReplacer(InternalBzrError):
1190
2315
 
1191
 
    is_user_error = False
 
2316
    _fmt = ("ScopeReplacer object %(name)r was used incorrectly:"
 
2317
            " %(msg)s%(extra)s")
1192
2318
 
1193
2319
    def __init__(self, name, msg, extra=None):
1194
 
        BzrNewError.__init__(self)
 
2320
        BzrError.__init__(self)
1195
2321
        self.name = name
1196
2322
        self.msg = msg
1197
2323
        if extra:
1200
2326
            self.extra = ''
1201
2327
 
1202
2328
 
1203
 
class InvalidImportLine(BzrNewError):
1204
 
    """Not a valid import statement: %(msg)\n%(text)s"""
 
2329
class InvalidImportLine(InternalBzrError):
1205
2330
 
1206
 
    is_user_error = False
 
2331
    _fmt = "Not a valid import statement: %(msg)\n%(text)s"
1207
2332
 
1208
2333
    def __init__(self, text, msg):
1209
 
        BzrNewError.__init__(self)
 
2334
        BzrError.__init__(self)
1210
2335
        self.text = text
1211
2336
        self.msg = msg
1212
2337
 
1213
2338
 
1214
 
class ImportNameCollision(BzrNewError):
1215
 
    """Tried to import an object to the same name as an existing object. %(name)s"""
1216
 
 
1217
 
    is_user_error = False
1218
 
 
1219
 
    def __init__(self, name):
1220
 
        BzrNewError.__init__(self)
1221
 
        self.name = name
 
2339
class ImportNameCollision(InternalBzrError):
 
2340
 
 
2341
    _fmt = ("Tried to import an object to the same name as"
 
2342
            " an existing object. %(name)s")
 
2343
 
 
2344
    def __init__(self, name):
 
2345
        BzrError.__init__(self)
 
2346
        self.name = name
 
2347
 
 
2348
 
 
2349
class NotAMergeDirective(BzrError):
 
2350
    """File starting with %(firstline)r is not a merge directive"""
 
2351
    def __init__(self, firstline):
 
2352
        BzrError.__init__(self, firstline=firstline)
 
2353
 
 
2354
 
 
2355
class NoMergeSource(BzrError):
 
2356
    """Raise if no merge source was specified for a merge directive"""
 
2357
 
 
2358
    _fmt = "A merge directive must provide either a bundle or a public"\
 
2359
        " branch location."
 
2360
 
 
2361
 
 
2362
class IllegalMergeDirectivePayload(BzrError):
 
2363
    """A merge directive contained something other than a patch or bundle"""
 
2364
 
 
2365
    _fmt = "Bad merge directive payload %(start)r"
 
2366
 
 
2367
    def __init__(self, start):
 
2368
        BzrError(self)
 
2369
        self.start = start
 
2370
 
 
2371
 
 
2372
class PatchVerificationFailed(BzrError):
 
2373
    """A patch from a merge directive could not be verified"""
 
2374
 
 
2375
    _fmt = "Preview patch does not match requested changes."
 
2376
 
 
2377
 
 
2378
class PatchMissing(BzrError):
 
2379
    """Raise a patch type was specified but no patch supplied"""
 
2380
 
 
2381
    _fmt = "Patch_type was %(patch_type)s, but no patch was supplied."
 
2382
 
 
2383
    def __init__(self, patch_type):
 
2384
        BzrError.__init__(self)
 
2385
        self.patch_type = patch_type
 
2386
 
 
2387
 
 
2388
class TargetNotBranch(BzrError):
 
2389
    """A merge directive's target branch is required, but isn't a branch"""
 
2390
 
 
2391
    _fmt = ("Your branch does not have all of the revisions required in "
 
2392
            "order to merge this merge directive and the target "
 
2393
            "location specified in the merge directive is not a branch: "
 
2394
            "%(location)s.")
 
2395
 
 
2396
    def __init__(self, location):
 
2397
        BzrError.__init__(self)
 
2398
        self.location = location
 
2399
 
 
2400
 
 
2401
class UnsupportedInventoryKind(BzrError):
 
2402
    
 
2403
    _fmt = """Unsupported entry kind %(kind)s"""
 
2404
 
 
2405
    def __init__(self, kind):
 
2406
        self.kind = kind
 
2407
 
 
2408
 
 
2409
class BadSubsumeSource(BzrError):
 
2410
 
 
2411
    _fmt = "Can't subsume %(other_tree)s into %(tree)s. %(reason)s"
 
2412
 
 
2413
    def __init__(self, tree, other_tree, reason):
 
2414
        self.tree = tree
 
2415
        self.other_tree = other_tree
 
2416
        self.reason = reason
 
2417
 
 
2418
 
 
2419
class SubsumeTargetNeedsUpgrade(BzrError):
 
2420
    
 
2421
    _fmt = """Subsume target %(other_tree)s needs to be upgraded."""
 
2422
 
 
2423
    def __init__(self, other_tree):
 
2424
        self.other_tree = other_tree
 
2425
 
 
2426
 
 
2427
class BadReferenceTarget(InternalBzrError):
 
2428
 
 
2429
    _fmt = "Can't add reference to %(other_tree)s into %(tree)s." \
 
2430
           "%(reason)s"
 
2431
 
 
2432
    def __init__(self, tree, other_tree, reason):
 
2433
        self.tree = tree
 
2434
        self.other_tree = other_tree
 
2435
        self.reason = reason
 
2436
 
 
2437
 
 
2438
class NoSuchTag(BzrError):
 
2439
 
 
2440
    _fmt = "No such tag: %(tag_name)s"
 
2441
 
 
2442
    def __init__(self, tag_name):
 
2443
        self.tag_name = tag_name
 
2444
 
 
2445
 
 
2446
class TagsNotSupported(BzrError):
 
2447
 
 
2448
    _fmt = ("Tags not supported by %(branch)s;"
 
2449
            " you may be able to use bzr upgrade.")
 
2450
 
 
2451
    def __init__(self, branch):
 
2452
        self.branch = branch
 
2453
 
 
2454
        
 
2455
class TagAlreadyExists(BzrError):
 
2456
 
 
2457
    _fmt = "Tag %(tag_name)s already exists."
 
2458
 
 
2459
    def __init__(self, tag_name):
 
2460
        self.tag_name = tag_name
 
2461
 
 
2462
 
 
2463
class MalformedBugIdentifier(BzrError):
 
2464
 
 
2465
    _fmt = "Did not understand bug identifier %(bug_id)s: %(reason)s"
 
2466
 
 
2467
    def __init__(self, bug_id, reason):
 
2468
        self.bug_id = bug_id
 
2469
        self.reason = reason
 
2470
 
 
2471
 
 
2472
class InvalidBugTrackerURL(BzrError):
 
2473
 
 
2474
    _fmt = ("The URL for bug tracker \"%(abbreviation)s\" doesn't "
 
2475
            "contain {id}: %(url)s")
 
2476
 
 
2477
    def __init__(self, abbreviation, url):
 
2478
        self.abbreviation = abbreviation
 
2479
        self.url = url
 
2480
 
 
2481
 
 
2482
class UnknownBugTrackerAbbreviation(BzrError):
 
2483
 
 
2484
    _fmt = ("Cannot find registered bug tracker called %(abbreviation)s "
 
2485
            "on %(branch)s")
 
2486
 
 
2487
    def __init__(self, abbreviation, branch):
 
2488
        self.abbreviation = abbreviation
 
2489
        self.branch = branch
 
2490
 
 
2491
 
 
2492
class UnexpectedSmartServerResponse(BzrError):
 
2493
 
 
2494
    _fmt = "Could not understand response from smart server: %(response_tuple)r"
 
2495
 
 
2496
    def __init__(self, response_tuple):
 
2497
        self.response_tuple = response_tuple
 
2498
 
 
2499
 
 
2500
class ErrorFromSmartServer(BzrError):
 
2501
 
 
2502
    _fmt = "Error received from smart server: %(error_tuple)r"
 
2503
 
 
2504
    internal_error = True
 
2505
 
 
2506
    def __init__(self, error_tuple):
 
2507
        self.error_tuple = error_tuple
 
2508
        try:
 
2509
            self.error_verb = error_tuple[0]
 
2510
        except IndexError:
 
2511
            self.error_verb = None
 
2512
        self.error_args = error_tuple[1:]
 
2513
 
 
2514
 
 
2515
class ContainerError(BzrError):
 
2516
    """Base class of container errors."""
 
2517
 
 
2518
 
 
2519
class UnknownContainerFormatError(ContainerError):
 
2520
 
 
2521
    _fmt = "Unrecognised container format: %(container_format)r"
 
2522
    
 
2523
    def __init__(self, container_format):
 
2524
        self.container_format = container_format
 
2525
 
 
2526
 
 
2527
class UnexpectedEndOfContainerError(ContainerError):
 
2528
 
 
2529
    _fmt = "Unexpected end of container stream"
 
2530
 
 
2531
 
 
2532
class UnknownRecordTypeError(ContainerError):
 
2533
 
 
2534
    _fmt = "Unknown record type: %(record_type)r"
 
2535
 
 
2536
    def __init__(self, record_type):
 
2537
        self.record_type = record_type
 
2538
 
 
2539
 
 
2540
class InvalidRecordError(ContainerError):
 
2541
 
 
2542
    _fmt = "Invalid record: %(reason)s"
 
2543
 
 
2544
    def __init__(self, reason):
 
2545
        self.reason = reason
 
2546
 
 
2547
 
 
2548
class ContainerHasExcessDataError(ContainerError):
 
2549
 
 
2550
    _fmt = "Container has data after end marker: %(excess)r"
 
2551
 
 
2552
    def __init__(self, excess):
 
2553
        self.excess = excess
 
2554
 
 
2555
 
 
2556
class DuplicateRecordNameError(ContainerError):
 
2557
 
 
2558
    _fmt = "Container has multiple records with the same name: %(name)s"
 
2559
 
 
2560
    def __init__(self, name):
 
2561
        self.name = name
 
2562
 
 
2563
 
 
2564
class NoDestinationAddress(InternalBzrError):
 
2565
 
 
2566
    _fmt = "Message does not have a destination address."
 
2567
 
 
2568
 
 
2569
class RepositoryDataStreamError(BzrError):
 
2570
 
 
2571
    _fmt = "Corrupt or incompatible data stream: %(reason)s"
 
2572
 
 
2573
    def __init__(self, reason):
 
2574
        self.reason = reason
 
2575
 
 
2576
 
 
2577
class SMTPError(BzrError):
 
2578
 
 
2579
    _fmt = "SMTP error: %(error)s"
 
2580
 
 
2581
    def __init__(self, error):
 
2582
        self.error = error
 
2583
 
 
2584
 
 
2585
class NoMessageSupplied(BzrError):
 
2586
 
 
2587
    _fmt = "No message supplied."
 
2588
 
 
2589
 
 
2590
class NoMailAddressSpecified(BzrError):
 
2591
 
 
2592
    _fmt = "No mail-to address specified."
 
2593
 
 
2594
 
 
2595
class UnknownMailClient(BzrError):
 
2596
 
 
2597
    _fmt = "Unknown mail client: %(mail_client)s"
 
2598
 
 
2599
    def __init__(self, mail_client):
 
2600
        BzrError.__init__(self, mail_client=mail_client)
 
2601
 
 
2602
 
 
2603
class MailClientNotFound(BzrError):
 
2604
 
 
2605
    _fmt = "Unable to find mail client with the following names:"\
 
2606
        " %(mail_command_list_string)s"
 
2607
 
 
2608
    def __init__(self, mail_command_list):
 
2609
        mail_command_list_string = ', '.join(mail_command_list)
 
2610
        BzrError.__init__(self, mail_command_list=mail_command_list,
 
2611
                          mail_command_list_string=mail_command_list_string)
 
2612
 
 
2613
class SMTPConnectionRefused(SMTPError):
 
2614
 
 
2615
    _fmt = "SMTP connection to %(host)s refused"
 
2616
 
 
2617
    def __init__(self, error, host):
 
2618
        self.error = error
 
2619
        self.host = host
 
2620
 
 
2621
 
 
2622
class DefaultSMTPConnectionRefused(SMTPConnectionRefused):
 
2623
 
 
2624
    _fmt = "Please specify smtp_server.  No server at default %(host)s."
 
2625
 
 
2626
 
 
2627
class BzrDirError(BzrError):
 
2628
 
 
2629
    def __init__(self, bzrdir):
 
2630
        import bzrlib.urlutils as urlutils
 
2631
        display_url = urlutils.unescape_for_display(bzrdir.root_transport.base,
 
2632
                                                    'ascii')
 
2633
        BzrError.__init__(self, bzrdir=bzrdir, display_url=display_url)
 
2634
 
 
2635
 
 
2636
class UnsyncedBranches(BzrDirError):
 
2637
 
 
2638
    _fmt = ("'%(display_url)s' is not in sync with %(target_url)s.  See"
 
2639
            " bzr help sync-for-reconfigure.")
 
2640
 
 
2641
    def __init__(self, bzrdir, target_branch):
 
2642
        BzrDirError.__init__(self, bzrdir)
 
2643
        import bzrlib.urlutils as urlutils
 
2644
        self.target_url = urlutils.unescape_for_display(target_branch.base,
 
2645
                                                        'ascii')
 
2646
 
 
2647
 
 
2648
class AlreadyBranch(BzrDirError):
 
2649
 
 
2650
    _fmt = "'%(display_url)s' is already a branch."
 
2651
 
 
2652
 
 
2653
class AlreadyTree(BzrDirError):
 
2654
 
 
2655
    _fmt = "'%(display_url)s' is already a tree."
 
2656
 
 
2657
 
 
2658
class AlreadyCheckout(BzrDirError):
 
2659
 
 
2660
    _fmt = "'%(display_url)s' is already a checkout."
 
2661
 
 
2662
 
 
2663
class AlreadyLightweightCheckout(BzrDirError):
 
2664
 
 
2665
    _fmt = "'%(display_url)s' is already a lightweight checkout."
 
2666
 
 
2667
 
 
2668
class AlreadyUsingShared(BzrDirError):
 
2669
 
 
2670
    _fmt = "'%(display_url)s' is already using a shared repository."
 
2671
 
 
2672
 
 
2673
class AlreadyStandalone(BzrDirError):
 
2674
 
 
2675
    _fmt = "'%(display_url)s' is already standalone."
 
2676
 
 
2677
 
 
2678
class ReconfigurationNotSupported(BzrDirError):
 
2679
 
 
2680
    _fmt = "Requested reconfiguration of '%(display_url)s' is not supported."
 
2681
 
 
2682
 
 
2683
class NoBindLocation(BzrDirError):
 
2684
 
 
2685
    _fmt = "No location could be found to bind to at %(display_url)s."
 
2686
 
 
2687
 
 
2688
class UncommittedChanges(BzrError):
 
2689
 
 
2690
    _fmt = 'Working tree "%(display_url)s" has uncommitted changes.'
 
2691
 
 
2692
    def __init__(self, tree):
 
2693
        import bzrlib.urlutils as urlutils
 
2694
        display_url = urlutils.unescape_for_display(
 
2695
            tree.bzrdir.root_transport.base, 'ascii')
 
2696
        BzrError.__init__(self, tree=tree, display_url=display_url)
 
2697
 
 
2698
 
 
2699
class MissingTemplateVariable(BzrError):
 
2700
 
 
2701
    _fmt = 'Variable {%(name)s} is not available.'
 
2702
 
 
2703
    def __init__(self, name):
 
2704
        self.name = name
 
2705
 
 
2706
 
 
2707
class NoTemplate(BzrError):
 
2708
 
 
2709
    _fmt = 'No template specified.'
 
2710
 
 
2711
 
 
2712
class UnableCreateSymlink(BzrError):
 
2713
 
 
2714
    _fmt = 'Unable to create symlink %(path_str)son this platform'
 
2715
 
 
2716
    def __init__(self, path=None):
 
2717
        path_str = ''
 
2718
        if path:
 
2719
            try:
 
2720
                path_str = repr(str(path))
 
2721
            except UnicodeEncodeError:
 
2722
                path_str = repr(path)
 
2723
            path_str += ' '
 
2724
        self.path_str = path_str
 
2725
 
 
2726
 
 
2727
class UnsupportedTimezoneFormat(BzrError):
 
2728
 
 
2729
    _fmt = ('Unsupported timezone format "%(timezone)s", '
 
2730
            'options are "utc", "original", "local".')
 
2731
 
 
2732
    def __init__(self, timezone):
 
2733
        self.timezone = timezone
 
2734
 
 
2735
 
 
2736
class CommandAvailableInPlugin(StandardError):
 
2737
    
 
2738
    internal_error = False
 
2739
 
 
2740
    def __init__(self, cmd_name, plugin_metadata, provider):
 
2741
        
 
2742
        self.plugin_metadata = plugin_metadata
 
2743
        self.cmd_name = cmd_name
 
2744
        self.provider = provider
 
2745
 
 
2746
    def __str__(self):
 
2747
 
 
2748
        _fmt = ('"%s" is not a standard bzr command. \n' 
 
2749
                'However, the following official plugin provides this command: %s\n'
 
2750
                'You can install it by going to: %s'
 
2751
                % (self.cmd_name, self.plugin_metadata['name'], 
 
2752
                    self.plugin_metadata['url']))
 
2753
 
 
2754
        return _fmt
 
2755
 
 
2756
 
 
2757
class NoPluginAvailable(BzrError):
 
2758
    pass    
 
2759
 
 
2760
 
 
2761
class NotATerminal(BzrError):
 
2762
 
 
2763
    _fmt = 'Unable to ask for a password without real terminal.'
 
2764
 
 
2765
 
 
2766
class UnableEncodePath(BzrError):
 
2767
 
 
2768
    _fmt = ('Unable to encode %(kind)s path %(path)r in '
 
2769
            'user encoding %(user_encoding)s')
 
2770
 
 
2771
    def __init__(self, path, kind):
 
2772
        self.path = path
 
2773
        self.kind = kind
 
2774
        self.user_encoding = osutils.get_user_encoding()
 
2775
 
 
2776
 
 
2777
class NoSuchAlias(BzrError):
 
2778
 
 
2779
    _fmt = ('The alias "%(alias_name)s" does not exist.')
 
2780
 
 
2781
    def __init__(self, alias_name):
 
2782
        BzrError.__init__(self, alias_name=alias_name)
 
2783
 
 
2784
 
 
2785
class DirectoryLookupFailure(BzrError):
 
2786
    """Base type for lookup errors."""
 
2787
 
 
2788
    pass
 
2789
 
 
2790
 
 
2791
class InvalidLocationAlias(DirectoryLookupFailure):
 
2792
 
 
2793
    _fmt = '"%(alias_name)s" is not a valid location alias.'
 
2794
 
 
2795
    def __init__(self, alias_name):
 
2796
        DirectoryLookupFailure.__init__(self, alias_name=alias_name)
 
2797
 
 
2798
 
 
2799
class UnsetLocationAlias(DirectoryLookupFailure):
 
2800
 
 
2801
    _fmt = 'No %(alias_name)s location assigned.'
 
2802
 
 
2803
    def __init__(self, alias_name):
 
2804
        DirectoryLookupFailure.__init__(self, alias_name=alias_name[1:])
 
2805
 
 
2806
 
 
2807
class CannotBindAddress(BzrError):
 
2808
 
 
2809
    _fmt = 'Cannot bind address "%(host)s:%(port)i": %(orig_error)s.'
 
2810
 
 
2811
    def __init__(self, host, port, orig_error):
 
2812
        BzrError.__init__(self, host=host, port=port,
 
2813
            orig_error=orig_error[1])
 
2814
 
 
2815
 
 
2816
class UnknownRules(BzrError):
 
2817
 
 
2818
    _fmt = ('Unknown rules detected: %(unknowns_str)s.')
 
2819
 
 
2820
    def __init__(self, unknowns):
 
2821
        BzrError.__init__(self, unknowns_str=", ".join(unknowns))
 
2822
 
 
2823
 
 
2824
class HookFailed(BzrError):
 
2825
    """Raised when a pre_change_branch_tip hook function fails anything other
 
2826
    than TipChangeRejected.
 
2827
    """
 
2828
 
 
2829
    _fmt = ("Hook '%(hook_name)s' during %(hook_stage)s failed:\n"
 
2830
            "%(traceback_text)s%(exc_value)s")
 
2831
 
 
2832
    def __init__(self, hook_stage, hook_name, exc_info):
 
2833
        import traceback
 
2834
        self.hook_stage = hook_stage
 
2835
        self.hook_name = hook_name
 
2836
        self.exc_info = exc_info
 
2837
        self.exc_type = exc_info[0]
 
2838
        self.exc_value = exc_info[1]
 
2839
        self.exc_tb = exc_info[2]
 
2840
        self.traceback_text = ''.join(traceback.format_tb(self.exc_tb))
 
2841
 
 
2842
 
 
2843
class TipChangeRejected(BzrError):
 
2844
    """A pre_change_branch_tip hook function may raise this to cleanly and
 
2845
    explicitly abort a change to a branch tip.
 
2846
    """
 
2847
    
 
2848
    _fmt = u"Tip change rejected: %(msg)s"
 
2849
 
 
2850
    def __init__(self, msg):
 
2851
        self.msg = msg
 
2852