1
# -*- coding: UTF-8 -*-
1
# Copyright (C) 2005-2013, 2016 Canonical Ltd
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
5
5
# the Free Software Foundation; either version 2 of the License, or
6
6
# (at your option) any later version.
8
8
# This program is distributed in the hope that it will be useful,
9
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
11
# GNU General Public License for more details.
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
17
"""Exceptions for bzr, and reporting of them.
19
Exceptions are caught at a high level to report errors to the user, and
20
might also be caught inside the program. Therefore it needs to be
21
possible to convert them to a meaningful string, and also for them to be
22
interrogated by the program.
24
Exceptions are defined such that the arguments given to the constructor
25
are stored in the object as properties of the same name. When the
26
object is printed as a string, the doc string of the class is used as
27
a format string with the property dictionary available to it.
29
This means that exceptions can used like this:
33
... raise NotBranchError(path='/foo/bar')
35
... print sys.exc_type
36
... print sys.exc_value
37
... print sys.exc_value.path
38
bzrlib.errors.NotBranchError
39
Not a branch: /foo/bar
44
* create a new exception class for any class of error that can be
45
usefully distinguished.
47
* the printable form of an exception is generated by the base class
51
# based on Scott James Remnant's hct error classes
20
from __future__ import absolute_import
53
26
# TODO: is there any value in providing the .args field used by standard
54
# python exceptions? A list of values with no names seems less useful
27
# python exceptions? A list of values with no names seems less useful
57
# TODO: Perhaps convert the exception to a string at the moment it's
30
# TODO: Perhaps convert the exception to a string at the moment it's
58
31
# constructed to make sure it will succeed. But that says nothing about
59
32
# exceptions that are never raised.
61
# TODO: Convert all the other error classes here to BzrNewError, and eliminate
65
class BzrError(StandardError):
67
# XXX: Should we show the exception class in
68
# exceptions that don't provide their own message?
69
# maybe it should be done at a higher level
70
## n = self.__class__.__name__ + ': '
72
if len(self.args) == 1:
73
return str(self.args[0])
74
elif len(self.args) == 2:
75
# further explanation or suggestions
77
return n + '\n '.join([self.args[0]] + self.args[1])
79
return n + "%r" % self
34
# TODO: selftest assertRaises should probably also check that every error
35
# raised can be formatted as a string successfully, and without giving
39
# return codes from the brz program
42
EXIT_INTERNAL_ERROR = 4
45
class BzrError(Exception):
47
Base class for errors raised by breezy.
49
:cvar internal_error: if True this was probably caused by a brz bug and
50
should be displayed with a traceback; if False (or absent) this was
51
probably a user or environment error and they don't need the gory
52
details. (That can be overridden by -Derror on the command line.)
54
:cvar _fmt: Format string to display the error; this is expanded
55
by the instance's dict.
58
internal_error = False
60
def __init__(self, msg=None, **kwds):
61
"""Construct a new BzrError.
63
There are two alternative forms for constructing these objects.
64
Either a preformatted string may be passed, or a set of named
65
arguments can be given. The first is for generic "user" errors which
66
are not intended to be caught and so do not need a specific subclass.
67
The second case is for use with subclasses that provide a _fmt format
68
string to print the arguments.
70
Keyword arguments are taken as parameters to the error, which can
71
be inserted into the format string template. It's recommended
72
that subclasses override the __init__ method to require specific
75
:param msg: If given, this is the literal complete text for the error,
76
not subject to expansion. 'msg' is used instead of 'message' because
77
python evolved and, in 2.6, forbids the use of 'message'.
79
Exception.__init__(self)
81
# I was going to deprecate this, but it actually turns out to be
82
# quite handy - mbp 20061103.
83
self._preformatted_string = msg
81
return n + `self.args`
84
class BzrNewError(BzrError):
86
# base classes should override the docstring with their human-
87
# readable explanation
89
def __init__(self, **kwds):
90
for key, value in kwds.items():
91
setattr(self, key, value)
85
self._preformatted_string = None
86
for key, value in kwds.items():
87
setattr(self, key, value)
90
s = getattr(self, '_preformatted_string', None)
92
# contains a preformatted message
95
return self.__doc__ % self.__dict__
96
except (NameError, ValueError, KeyError), e:
97
return 'Unprintable exception %s: %s' \
98
% (self.__class__.__name__, str(e))
101
class BzrCheckError(BzrNewError):
102
"""Internal check failed: %(message)s"""
103
def __init__(self, message):
104
self.message = message
107
class InvalidEntryName(BzrNewError):
108
"""Invalid entry name: %(name)s"""
96
fmt = self._get_format_string()
98
d = dict(self.__dict__)
100
# __str__() should always return a 'str' object
101
# never a 'unicode' object.
103
except Exception as e:
105
return 'Unprintable exception %s: dict=%r, fmt=%r, error=%r' \
106
% (self.__class__.__name__,
108
getattr(self, '_fmt', None),
115
return self._format().encode('utf-8')
117
__unicode__ = _format
120
return '%s(%s)' % (self.__class__.__name__, str(self))
122
def _get_format_string(self):
123
"""Return format string for this exception or None"""
124
fmt = getattr(self, '_fmt', None)
126
from breezy.i18n import gettext
127
return gettext(fmt) # _fmt strings should be ascii
129
def __eq__(self, other):
130
if self.__class__ is not other.__class__:
131
return NotImplemented
132
return self.__dict__ == other.__dict__
138
class InternalBzrError(BzrError):
139
"""Base class for errors that are internal in nature.
141
This is a convenience class for errors that are internal. The
142
internal_error attribute can still be altered in subclasses, if needed.
143
Using this class is simply an easy way to get internal errors.
146
internal_error = True
149
class BranchError(BzrError):
150
"""Base class for concrete 'errors about a branch'."""
152
def __init__(self, branch):
153
BzrError.__init__(self, branch=branch)
156
class BzrCheckError(InternalBzrError):
158
_fmt = "Internal check failed: %(msg)s"
160
def __init__(self, msg):
161
BzrError.__init__(self)
165
class IncompatibleVersion(BzrError):
167
_fmt = 'API %(api)s is not compatible; one of versions %(wanted)r '\
168
'is required, but current version is %(current)r.'
170
def __init__(self, api, wanted, current):
173
self.current = current
176
class InProcessTransport(BzrError):
178
_fmt = "The transport '%(transport)s' is only accessible within this " \
181
def __init__(self, transport):
182
self.transport = transport
185
class InvalidEntryName(InternalBzrError):
187
_fmt = "Invalid entry name: %(name)s"
109
189
def __init__(self, name):
190
BzrError.__init__(self)
113
class InvalidRevisionNumber(BzrNewError):
114
"""Invalid revision number %(revno)d"""
194
class InvalidRevisionNumber(BzrError):
196
_fmt = "Invalid revision number %(revno)s"
115
198
def __init__(self, revno):
199
BzrError.__init__(self)
116
200
self.revno = revno
119
class InvalidRevisionId(BzrNewError):
120
"""Invalid revision-id"""
203
class InvalidRevisionId(BzrError):
205
_fmt = "Invalid revision-id {%(revision_id)s} in %(branch)s"
207
def __init__(self, revision_id, branch):
208
# branch can be any string or object with __str__ defined
209
BzrError.__init__(self)
210
self.revision_id = revision_id
214
class ReservedId(BzrError):
216
_fmt = "Reserved revision-id {%(revision_id)s}"
218
def __init__(self, revision_id):
219
self.revision_id = revision_id
222
class RootMissing(InternalBzrError):
224
_fmt = ("The root entry of a tree must be the first entry supplied to "
225
"the commit builder.")
228
class NoPublicBranch(BzrError):
230
_fmt = 'There is no public branch set for "%(branch_url)s".'
232
def __init__(self, branch):
233
from . import urlutils
234
public_location = urlutils.unescape_for_display(branch.base, 'ascii')
235
BzrError.__init__(self, branch_url=public_location)
238
class NoSuchId(BzrError):
240
_fmt = 'The file id "%(file_id)s" is not present in the tree %(tree)s.'
242
def __init__(self, tree, file_id):
243
BzrError.__init__(self)
244
self.file_id = file_id
248
class NotStacked(BranchError):
250
_fmt = "The branch '%(branch)s' is not stacked."
253
class InventoryModified(InternalBzrError):
255
_fmt = ("The current inventory for the tree %(tree)r has been modified,"
256
" so a clean inventory cannot be read without data loss.")
258
def __init__(self, tree):
262
class NoWorkingTree(BzrError):
264
_fmt = 'No WorkingTree exists for "%(base)s".'
266
def __init__(self, base):
267
BzrError.__init__(self)
271
class NotLocalUrl(BzrError):
273
_fmt = "%(url)s is not a local path."
275
def __init__(self, url):
279
class WorkingTreeAlreadyPopulated(InternalBzrError):
281
_fmt = 'Working tree already populated in "%(base)s"'
283
def __init__(self, base):
287
class NoWhoami(BzrError):
289
_fmt = ('Unable to determine your name.\n'
290
"Please, set your name with the 'whoami' command.\n"
291
'E.g. brz whoami "Your Name <name@example.com>"')
123
294
class BzrCommandError(BzrError):
124
# Error from malformed user command
128
class StrictCommitFailed(Exception):
129
"""Commit refused because there are unknowns in the tree."""
131
class NotBranchError(BzrNewError):
132
"""Not a branch: %(path)s"""
133
def __init__(self, path):
134
BzrNewError.__init__(self)
295
"""Error from user command"""
297
# Error from malformed user command; please avoid raising this as a
298
# generic exception not caused by user input.
300
# I think it's a waste of effort to differentiate between errors that
301
# are not intended to be caught anyway. UI code need not subclass
302
# BzrCommandError, and non-UI code should not throw a subclass of
303
# BzrCommandError. ADHB 20051211
306
class NotWriteLocked(BzrError):
308
_fmt = """%(not_locked)r is not write locked but needs to be."""
310
def __init__(self, not_locked):
311
self.not_locked = not_locked
314
class StrictCommitFailed(BzrError):
316
_fmt = "Commit refused because there are unknown files in the tree"
319
# XXX: Should be unified with TransportError; they seem to represent the
321
# RBC 20060929: I think that unifiying with TransportError would be a mistake
322
# - this is finer than a TransportError - and more useful as such. It
323
# differentiates between 'transport has failed' and 'operation on a transport
325
class PathError(BzrError):
327
_fmt = "Generic path error: %(path)r%(extra)s)"
329
def __init__(self, path, extra=None):
330
BzrError.__init__(self)
333
self.extra = ': ' + str(extra)
338
class NoSuchFile(PathError):
340
_fmt = "No such file: %(path)r%(extra)s"
343
class FileExists(PathError):
345
_fmt = "File exists: %(path)r%(extra)s"
348
class RenameFailedFilesExist(BzrError):
349
"""Used when renaming and both source and dest exist."""
351
_fmt = ("Could not rename %(source)s => %(dest)s because both files exist."
352
" (Use --after to tell brz about a rename that has already"
353
" happened)%(extra)s")
355
def __init__(self, source, dest, extra=None):
356
BzrError.__init__(self)
357
self.source = str(source)
358
self.dest = str(dest)
360
self.extra = ' ' + str(extra)
365
class NotADirectory(PathError):
367
_fmt = '"%(path)s" is not a directory %(extra)s'
370
class NotInWorkingDirectory(PathError):
372
_fmt = '"%(path)s" is not in the working directory %(extra)s'
375
class DirectoryNotEmpty(PathError):
377
_fmt = 'Directory not empty: "%(path)s"%(extra)s'
380
class HardLinkNotSupported(PathError):
382
_fmt = 'Hard-linking "%(path)s" is not supported'
385
class ReadingCompleted(InternalBzrError):
387
_fmt = ("The MediumRequest '%(request)s' has already had finish_reading "
388
"called upon it - the request has been completed and no more "
391
def __init__(self, request):
392
self.request = request
395
class ResourceBusy(PathError):
397
_fmt = 'Device or resource busy: "%(path)s"%(extra)s'
400
class PermissionDenied(PathError):
402
_fmt = 'Permission denied: "%(path)s"%(extra)s'
405
class UnavailableRepresentation(InternalBzrError):
407
_fmt = ("The encoding '%(wanted)s' is not available for key %(key)s which "
408
"is encoded as '%(native)s'.")
410
def __init__(self, key, wanted, native):
411
InternalBzrError.__init__(self)
417
class UnsupportedProtocol(PathError):
419
_fmt = 'Unsupported protocol for url "%(path)s"%(extra)s'
421
def __init__(self, url, extra=""):
422
PathError.__init__(self, url, extra=extra)
425
class UnstackableLocationError(BzrError):
427
_fmt = "The branch '%(branch_url)s' cannot be stacked on '%(target_url)s'."
429
def __init__(self, branch_url, target_url):
430
BzrError.__init__(self)
431
self.branch_url = branch_url
432
self.target_url = target_url
435
class UnstackableRepositoryFormat(BzrError):
437
_fmt = ("The repository '%(url)s'(%(format)s) is not a stackable format. "
438
"You will need to upgrade the repository to permit branch stacking.")
440
def __init__(self, format, url):
441
BzrError.__init__(self)
446
class ReadError(PathError):
448
_fmt = """Error reading from %(path)r."""
451
class ShortReadvError(PathError):
453
_fmt = ('readv() read %(actual)s bytes rather than %(length)s bytes'
454
' at %(offset)s for "%(path)s"%(extra)s')
456
internal_error = True
458
def __init__(self, path, offset, length, actual, extra=None):
459
PathError.__init__(self, path, extra=extra)
465
class PathNotChild(PathError):
467
_fmt = 'Path "%(path)s" is not a child of path "%(base)s"%(extra)s'
469
internal_error = False
471
def __init__(self, path, base, extra=None):
472
BzrError.__init__(self)
476
self.extra = ': ' + str(extra)
481
class InvalidNormalization(PathError):
483
_fmt = 'Path "%(path)s" is not unicode normalized'
486
# TODO: This is given a URL; we try to unescape it but doing that from inside
487
# the exception object is a bit undesirable.
488
# TODO: Probably this behavior of should be a common superclass
489
class NotBranchError(PathError):
491
_fmt = 'Not a branch: "%(path)s"%(detail)s.'
493
def __init__(self, path, detail=None, controldir=None):
494
from . import urlutils
495
path = urlutils.unescape_for_display(path, 'ascii')
496
if detail is not None:
497
detail = ': ' + detail
499
self.controldir = controldir
500
PathError.__init__(self, path=path)
503
return '<%s %r>' % (self.__class__.__name__, self.__dict__)
505
def _get_format_string(self):
506
# GZ 2017-06-08: Not the best place to lazy fill detail in.
507
if self.detail is None:
508
self.detail = self._get_detail()
509
return super(NotBranchError, self)._get_format_string()
511
def _get_detail(self):
512
if self.controldir is not None:
514
self.controldir.open_repository()
515
except NoRepositoryPresent:
517
except Exception as e:
518
# Just ignore unexpected errors. Raising arbitrary errors
519
# during str(err) can provoke strange bugs. Concretely
520
# Launchpad's codehosting managed to raise NotBranchError
521
# here, and then get stuck in an infinite loop/recursion
522
# trying to str() that error. All this error really cares
523
# about that there's no working repository there, and if
524
# open_repository() fails, there probably isn't.
525
return ': ' + e.__class__.__name__
527
return ': location is a repository'
531
class NoSubmitBranch(PathError):
533
_fmt = 'No submit branch available for branch "%(path)s"'
535
def __init__(self, branch):
536
from . import urlutils
537
self.path = urlutils.unescape_for_display(branch.base, 'ascii')
540
class AlreadyControlDirError(PathError):
542
_fmt = 'A control directory already exists: "%(path)s".'
545
class AlreadyBranchError(PathError):
547
_fmt = 'Already a branch: "%(path)s".'
550
class InvalidBranchName(PathError):
552
_fmt = "Invalid branch name: %(name)s"
554
def __init__(self, name):
555
BzrError.__init__(self)
559
class ParentBranchExists(AlreadyBranchError):
561
_fmt = 'Parent branch already exists: "%(path)s".'
564
class BranchExistsWithoutWorkingTree(PathError):
566
_fmt = 'Directory contains a branch, but no working tree \
567
(use brz checkout if you wish to build a working tree): "%(path)s"'
570
class InaccessibleParent(PathError):
572
_fmt = ('Parent not accessible given base "%(base)s" and'
573
' relative path "%(path)s"')
575
def __init__(self, path, base):
576
PathError.__init__(self, path)
580
class NoRepositoryPresent(BzrError):
582
_fmt = 'No repository present: "%(path)s"'
584
def __init__(self, controldir):
585
BzrError.__init__(self)
586
self.path = controldir.transport.clone('..').base
138
589
class UnsupportedFormatError(BzrError):
139
"""Specified path is a bzr branch that we cannot read."""
141
return 'unsupported branch format: %s' % self.args[0]
144
class NotVersionedError(BzrNewError):
145
"""%(path)s is not versioned"""
146
def __init__(self, path):
147
BzrNewError.__init__(self)
591
_fmt = "Unsupported branch format: %(format)s\nPlease run 'brz upgrade'"
594
class UnknownFormatError(BzrError):
596
_fmt = "Unknown %(kind)s format: %(format)r"
598
def __init__(self, format, kind='branch'):
603
class LineEndingError(BzrError):
605
_fmt = ("Line ending corrupted for file: %(file)s; "
606
"Maybe your files got corrupted in transport?")
608
def __init__(self, file):
612
class IncompatibleFormat(BzrError):
614
_fmt = "Format %(format)s is not compatible with .bzr version %(controldir)s."
616
def __init__(self, format, controldir_format):
617
BzrError.__init__(self)
619
self.controldir = controldir_format
622
class ParseFormatError(BzrError):
624
_fmt = "Parse error on line %(lineno)d of %(format)s format: %(line)s"
626
def __init__(self, format, lineno, line, text):
627
BzrError.__init__(self)
634
class IncompatibleRepositories(BzrError):
635
"""Report an error that two repositories are not compatible.
637
Note that the source and target repositories are permitted to be strings:
638
this exception is thrown from the smart server and may refer to a
639
repository the client hasn't opened.
642
_fmt = "%(target)s\n" \
643
"is not compatible with\n" \
647
def __init__(self, source, target, details=None):
649
details = "(no details)"
650
BzrError.__init__(self, target=target, source=source, details=details)
653
class IncompatibleRevision(BzrError):
655
_fmt = "Revision is not compatible with %(repo_format)s"
657
def __init__(self, repo_format):
658
BzrError.__init__(self)
659
self.repo_format = repo_format
662
class AlreadyVersionedError(BzrError):
663
"""Used when a path is expected not to be versioned, but it is."""
665
_fmt = "%(context_info)s%(path)s is already versioned."
667
def __init__(self, path, context_info=None):
668
"""Construct a new AlreadyVersionedError.
670
:param path: This is the path which is versioned,
671
which should be in a user friendly form.
672
:param context_info: If given, this is information about the context,
673
which could explain why this is expected to not be versioned.
675
BzrError.__init__(self)
677
if context_info is None:
678
self.context_info = ''
680
self.context_info = context_info + ". "
683
class NotVersionedError(BzrError):
684
"""Used when a path is expected to be versioned, but it is not."""
686
_fmt = "%(context_info)s%(path)s is not versioned."
688
def __init__(self, path, context_info=None):
689
"""Construct a new NotVersionedError.
691
:param path: This is the path which is not versioned,
692
which should be in a user friendly form.
693
:param context_info: If given, this is information about the context,
694
which could explain why this is expected to be versioned.
696
BzrError.__init__(self)
698
if context_info is None:
699
self.context_info = ''
701
self.context_info = context_info + ". "
704
class PathsNotVersionedError(BzrError):
705
"""Used when reporting several paths which are not versioned"""
707
_fmt = "Path(s) are not versioned: %(paths_as_string)s"
709
def __init__(self, paths):
710
from breezy.osutils import quotefn
711
BzrError.__init__(self)
713
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
716
class PathsDoNotExist(BzrError):
718
_fmt = "Path(s) do not exist: %(paths_as_string)s%(extra)s"
720
# used when reporting that paths are neither versioned nor in the working
723
def __init__(self, paths, extra=None):
725
from breezy.osutils import quotefn
726
BzrError.__init__(self)
728
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
730
self.extra = ': ' + str(extra)
151
735
class BadFileKindError(BzrError):
152
"""Specified file is of a kind that cannot be added.
154
(For example a symlink or device file.)"""
157
class ForbiddenFileError(BzrError):
158
"""Cannot operate on a file because it is a control file."""
161
class LockError(Exception):
737
_fmt = 'Cannot operate on "%(filename)s" of unsupported kind "%(kind)s"'
739
def __init__(self, filename, kind):
740
BzrError.__init__(self, filename=filename, kind=kind)
743
class BadFilenameEncoding(BzrError):
745
_fmt = ('Filename %(filename)r is not valid in your current filesystem'
746
' encoding %(fs_encoding)s')
748
def __init__(self, filename, fs_encoding):
749
BzrError.__init__(self)
750
self.filename = filename
751
self.fs_encoding = fs_encoding
754
class ForbiddenControlFileError(BzrError):
756
_fmt = 'Cannot operate on "%(filename)s" because it is a control file'
759
class LockError(InternalBzrError):
761
_fmt = "Lock error: %(msg)s"
163
763
# All exceptions from the lock/unlock functions should be from
164
764
# this exception class. They will be translated as necessary. The
165
765
# original exception is available as e.original_error
767
# New code should prefer to raise specific subclasses
768
def __init__(self, msg):
772
class LockActive(LockError):
774
_fmt = "The lock for '%(lock_description)s' is in use and cannot be broken."
776
internal_error = False
778
def __init__(self, lock_description):
779
self.lock_description = lock_description
168
782
class CommitNotPossible(LockError):
169
"""A commit was attempted but we do not have a write lock open."""
784
_fmt = "A commit was attempted but we do not have a write lock open."
172
790
class AlreadyCommitted(LockError):
173
"""A rollback was requested, but is not able to be accomplished."""
792
_fmt = "A rollback was requested, but is not able to be accomplished."
176
798
class ReadOnlyError(LockError):
177
"""A write attempt was made in a read only transaction."""
180
class PointlessCommit(BzrNewError):
181
"""No changes to commit"""
184
class NoSuchRevision(BzrError):
800
_fmt = "A write attempt was made in a read only transaction on %(obj)s"
802
# TODO: There should also be an error indicating that you need a write
803
# lock and don't have any lock at all... mbp 20070226
805
def __init__(self, obj):
809
class LockFailed(LockError):
811
internal_error = False
813
_fmt = "Cannot lock %(lock)s: %(why)s"
815
def __init__(self, lock, why):
816
LockError.__init__(self, '')
821
class OutSideTransaction(BzrError):
823
_fmt = ("A transaction related operation was attempted after"
824
" the transaction finished.")
827
class ObjectNotLocked(LockError):
829
_fmt = "%(obj)r is not locked"
831
# this can indicate that any particular object is not locked; see also
832
# LockNotHeld which means that a particular *lock* object is not held by
833
# the caller -- perhaps they should be unified.
834
def __init__(self, obj):
838
class ReadOnlyObjectDirtiedError(ReadOnlyError):
840
_fmt = "Cannot change object %(obj)r in read only transaction"
842
def __init__(self, obj):
846
class UnlockableTransport(LockError):
848
internal_error = False
850
_fmt = "Cannot lock: transport is read only: %(transport)s"
852
def __init__(self, transport):
853
self.transport = transport
856
class LockContention(LockError):
858
_fmt = 'Could not acquire lock "%(lock)s": %(msg)s'
860
internal_error = False
862
def __init__(self, lock, msg=''):
867
class LockBroken(LockError):
869
_fmt = ("Lock was broken while still open: %(lock)s"
870
" - check storage consistency!")
872
internal_error = False
874
def __init__(self, lock):
878
class LockBreakMismatch(LockError):
880
_fmt = ("Lock was released and re-acquired before being broken:"
881
" %(lock)s: held by %(holder)r, wanted to break %(target)r")
883
internal_error = False
885
def __init__(self, lock, holder, target):
891
class LockCorrupt(LockError):
893
_fmt = ("Lock is apparently held, but corrupted: %(corruption_info)s\n"
894
"Use 'brz break-lock' to clear it")
896
internal_error = False
898
def __init__(self, corruption_info, file_data=None):
899
self.corruption_info = corruption_info
900
self.file_data = file_data
903
class LockNotHeld(LockError):
905
_fmt = "Lock not held: %(lock)s"
907
internal_error = False
909
def __init__(self, lock):
913
class TokenLockingNotSupported(LockError):
915
_fmt = "The object %(obj)s does not support token specifying a token when locking."
917
def __init__(self, obj):
921
class TokenMismatch(LockBroken):
923
_fmt = "The lock token %(given_token)r does not match lock token %(lock_token)r."
925
internal_error = True
927
def __init__(self, given_token, lock_token):
928
self.given_token = given_token
929
self.lock_token = lock_token
932
class UpgradeReadonly(BzrError):
934
_fmt = "Upgrade URL cannot work with readonly URLs."
937
class UpToDateFormat(BzrError):
939
_fmt = "The branch format %(format)s is already at the most recent format."
941
def __init__(self, format):
942
BzrError.__init__(self)
946
class NoSuchRevision(InternalBzrError):
948
_fmt = "%(branch)s has no revision %(revision)s"
185
950
def __init__(self, branch, revision):
187
self.revision = revision
188
msg = "Branch %s has no revision %s" % (branch, revision)
189
BzrError.__init__(self, msg)
192
class HistoryMissing(BzrError):
193
def __init__(self, branch, object_type, object_id):
195
BzrError.__init__(self,
196
'%s is missing %s {%s}'
197
% (branch, object_type, object_id))
951
# 'branch' may sometimes be an internal object like a KnitRevisionStore
952
BzrError.__init__(self, branch=branch, revision=revision)
955
class RangeInChangeOption(BzrError):
957
_fmt = "Option --change does not accept revision ranges"
960
class NoSuchRevisionSpec(BzrError):
962
_fmt = "No namespace registered for string: %(spec)r"
964
def __init__(self, spec):
965
BzrError.__init__(self, spec=spec)
968
class NoSuchRevisionInTree(NoSuchRevision):
969
"""When using Tree.revision_tree, and the revision is not accessible."""
971
_fmt = "The revision id {%(revision_id)s} is not present in the tree %(tree)s."
973
def __init__(self, tree, revision_id):
974
BzrError.__init__(self)
976
self.revision_id = revision_id
979
class InvalidRevisionSpec(BzrError):
981
_fmt = ("Requested revision: '%(spec)s' does not exist in branch:"
982
" %(branch_url)s%(extra)s")
984
def __init__(self, spec, branch, extra=None):
985
BzrError.__init__(self, branch=branch, spec=spec)
986
self.branch_url = getattr(branch, 'user_url', str(branch))
988
self.extra = '\n' + str(extra)
993
class AppendRevisionsOnlyViolation(BzrError):
995
_fmt = ('Operation denied because it would change the main history,'
996
' which is not permitted by the append_revisions_only setting on'
997
' branch "%(location)s".')
999
def __init__(self, location):
1000
import breezy.urlutils as urlutils
1001
location = urlutils.unescape_for_display(location, 'ascii')
1002
BzrError.__init__(self, location=location)
200
1005
class DivergedBranches(BzrError):
1007
_fmt = ("These branches have diverged."
1008
" Use the missing command to see how.\n"
1009
"Use the merge command to reconcile them.")
201
1011
def __init__(self, branch1, branch2):
202
BzrError.__init__(self, "These branches have diverged.")
203
1012
self.branch1 = branch1
204
1013
self.branch2 = branch2
207
class UnrelatedBranches(BzrCommandError):
209
msg = "Branches have no common ancestor, and no base revision"\
211
BzrCommandError.__init__(self, msg)
1016
class NotLefthandHistory(InternalBzrError):
1018
_fmt = "Supplied history does not follow left-hand parents"
1020
def __init__(self, history):
1021
BzrError.__init__(self, history=history)
1024
class UnrelatedBranches(BzrError):
1026
_fmt = ("Branches have no common ancestor, and"
1027
" no merge base revision was specified.")
1030
class CannotReverseCherrypick(BzrError):
1032
_fmt = ('Selected merge cannot perform reverse cherrypicks. Try merge3'
213
1036
class NoCommonAncestor(BzrError):
1038
_fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
214
1040
def __init__(self, revision_a, revision_b):
215
msg = "Revisions have no common ancestor: %s %s." \
216
% (revision_a, revision_b)
217
BzrError.__init__(self, msg)
1041
self.revision_a = revision_a
1042
self.revision_b = revision_b
219
1045
class NoCommonRoot(BzrError):
1047
_fmt = ("Revisions are not derived from the same root: "
1048
"%(revision_a)s %(revision_b)s.")
220
1050
def __init__(self, revision_a, revision_b):
221
msg = "Revisions are not derived from the same root: %s %s." \
222
% (revision_a, revision_b)
223
BzrError.__init__(self, msg)
225
class NotAncestor(BzrError):
226
def __init__(self, rev_id, not_ancestor_id):
227
msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id,
229
BzrError.__init__(self, msg)
231
self.not_ancestor_id = not_ancestor_id
234
class NotAncestor(BzrError):
235
def __init__(self, rev_id, not_ancestor_id):
237
self.not_ancestor_id = not_ancestor_id
238
msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id,
240
BzrError.__init__(self, msg)
243
class InstallFailed(BzrError):
244
def __init__(self, revisions):
245
msg = "Could not install revisions:\n%s" % " ,".join(revisions)
246
BzrError.__init__(self, msg)
247
self.revisions = revisions
250
class AmbiguousBase(BzrError):
251
def __init__(self, bases):
252
msg = "The correct base is unclear, becase %s are all equally close" %\
254
BzrError.__init__(self, msg)
257
class NoCommits(BzrError):
258
def __init__(self, branch):
259
msg = "Branch %s has no commits." % branch
260
BzrError.__init__(self, msg)
1051
BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
1054
class NotAncestor(BzrError):
1056
_fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
1058
def __init__(self, rev_id, not_ancestor_id):
1059
BzrError.__init__(self, rev_id=rev_id,
1060
not_ancestor_id=not_ancestor_id)
1063
class NoCommits(BranchError):
1065
_fmt = "Branch %(branch)s has no commits."
262
1068
class UnlistableStore(BzrError):
263
1070
def __init__(self, store):
264
1071
BzrError.__init__(self, "Store %s is not listable" % store)
266
1074
class UnlistableBranch(BzrError):
267
1076
def __init__(self, br):
268
1077
BzrError.__init__(self, "Stores for branch %s are not listable" % br)
271
from bzrlib.weave import WeaveError, WeaveParentMismatch
1080
class BoundBranchOutOfDate(BzrError):
1082
_fmt = ("Bound branch %(branch)s is out of date with master branch"
1083
" %(master)s.%(extra_help)s")
1085
def __init__(self, branch, master):
1086
BzrError.__init__(self)
1087
self.branch = branch
1088
self.master = master
1089
self.extra_help = ''
1092
class CommitToDoubleBoundBranch(BzrError):
1094
_fmt = ("Cannot commit to branch %(branch)s."
1095
" It is bound to %(master)s, which is bound to %(remote)s.")
1097
def __init__(self, branch, master, remote):
1098
BzrError.__init__(self)
1099
self.branch = branch
1100
self.master = master
1101
self.remote = remote
1104
class OverwriteBoundBranch(BzrError):
1106
_fmt = "Cannot pull --overwrite to a branch which is bound %(branch)s"
1108
def __init__(self, branch):
1109
BzrError.__init__(self)
1110
self.branch = branch
1113
class BoundBranchConnectionFailure(BzrError):
1115
_fmt = ("Unable to connect to target of bound branch %(branch)s"
1116
" => %(target)s: %(error)s")
1118
def __init__(self, branch, target, error):
1119
BzrError.__init__(self)
1120
self.branch = branch
1121
self.target = target
1125
class VersionedFileError(BzrError):
1127
_fmt = "Versioned file error"
1130
class RevisionNotPresent(VersionedFileError):
1132
_fmt = 'Revision {%(revision_id)s} not present in "%(file_id)s".'
1134
def __init__(self, revision_id, file_id):
1135
VersionedFileError.__init__(self)
1136
self.revision_id = revision_id
1137
self.file_id = file_id
1140
class RevisionAlreadyPresent(VersionedFileError):
1142
_fmt = 'Revision {%(revision_id)s} already present in "%(file_id)s".'
1144
def __init__(self, revision_id, file_id):
1145
VersionedFileError.__init__(self)
1146
self.revision_id = revision_id
1147
self.file_id = file_id
1150
class VersionedFileInvalidChecksum(VersionedFileError):
1152
_fmt = "Text did not match its checksum: %(msg)s"
1155
class RetryWithNewPacks(BzrError):
1156
"""Raised when we realize that the packs on disk have changed.
1158
This is meant as more of a signaling exception, to trap between where a
1159
local error occurred and the code that can actually handle the error and
1160
code that can retry appropriately.
1163
internal_error = True
1165
_fmt = ("Pack files have changed, reload and retry. context: %(context)s"
1168
def __init__(self, context, reload_occurred, exc_info):
1169
"""create a new RetryWithNewPacks error.
1171
:param reload_occurred: Set to True if we know that the packs have
1172
already been reloaded, and we are failing because of an in-memory
1173
cache miss. If set to True then we will ignore if a reload says
1174
nothing has changed, because we assume it has already reloaded. If
1175
False, then a reload with nothing changed will force an error.
1176
:param exc_info: The original exception traceback, so if there is a
1177
problem we can raise the original error (value from sys.exc_info())
1179
BzrError.__init__(self)
1180
self.context = context
1181
self.reload_occurred = reload_occurred
1182
self.exc_info = exc_info
1183
self.orig_error = exc_info[1]
1184
# TODO: The global error handler should probably treat this by
1185
# raising/printing the original exception with a bit about
1186
# RetryWithNewPacks also not being caught
1189
class RetryAutopack(RetryWithNewPacks):
1190
"""Raised when we are autopacking and we find a missing file.
1192
Meant as a signaling exception, to tell the autopack code it should try
1196
internal_error = True
1198
_fmt = ("Pack files have changed, reload and try autopack again."
1199
" context: %(context)s %(orig_error)s")
1202
class NoSuchExportFormat(BzrError):
1204
_fmt = "Export format %(format)r not supported"
1206
def __init__(self, format):
1207
BzrError.__init__(self)
1208
self.format = format
273
1211
class TransportError(BzrError):
274
"""All errors thrown by Transport implementations should derive
1213
_fmt = "Transport error: %(msg)s %(orig_error)s"
277
1215
def __init__(self, msg=None, orig_error=None):
278
1216
if msg is None and orig_error is not None:
279
1217
msg = str(orig_error)
280
BzrError.__init__(self, msg)
1218
if orig_error is None:
282
1223
self.orig_error = orig_error
1224
BzrError.__init__(self)
1227
class TooManyConcurrentRequests(InternalBzrError):
1229
_fmt = ("The medium '%(medium)s' has reached its concurrent request limit."
1230
" Be sure to finish_writing and finish_reading on the"
1231
" currently open request.")
1233
def __init__(self, medium):
1234
self.medium = medium
1237
class SmartProtocolError(TransportError):
1239
_fmt = "Generic bzr smart protocol error: %(details)s"
1241
def __init__(self, details):
1242
self.details = details
1245
class UnexpectedProtocolVersionMarker(TransportError):
1247
_fmt = "Received bad protocol version marker: %(marker)r"
1249
def __init__(self, marker):
1250
self.marker = marker
1253
class UnknownSmartMethod(InternalBzrError):
1255
_fmt = "The server does not recognise the '%(verb)s' request."
1257
def __init__(self, verb):
1261
class SmartMessageHandlerError(InternalBzrError):
1263
_fmt = ("The message handler raised an exception:\n"
1264
"%(traceback_text)s")
1266
def __init__(self, exc_info):
1268
# GZ 2010-08-10: Cycle with exc_tb/exc_info affects at least one test
1269
self.exc_type, self.exc_value, self.exc_tb = exc_info
1270
self.exc_info = exc_info
1271
traceback_strings = traceback.format_exception(
1272
self.exc_type, self.exc_value, self.exc_tb)
1273
self.traceback_text = ''.join(traceback_strings)
284
1276
# A set of semi-meaningful errors which can be thrown
285
1277
class TransportNotPossible(TransportError):
286
"""This is for transports where a specific function is explicitly not
287
possible. Such as pushing files to an HTTP server.
291
class NonRelativePath(TransportError):
292
"""An absolute path was supplied, that could not be decoded into
297
class NoSuchFile(TransportError, IOError):
298
"""A get() was issued for a file that doesn't exist."""
300
# XXX: Is multiple inheritance for exceptions really needed?
303
return 'no such file: ' + self.msg
305
def __init__(self, msg=None, orig_error=None):
307
TransportError.__init__(self, msg=msg, orig_error=orig_error)
308
IOError.__init__(self, errno.ENOENT, self.msg)
310
class FileExists(TransportError, OSError):
311
"""An operation was attempted, which would overwrite an entry,
312
but overwritting is not supported.
314
mkdir() can throw this, but put() just overwites existing files.
316
# XXX: Is multiple inheritance for exceptions really needed?
317
def __init__(self, msg=None, orig_error=None):
319
TransportError.__init__(self, msg=msg, orig_error=orig_error)
320
OSError.__init__(self, errno.EEXIST, self.msg)
322
class PermissionDenied(TransportError):
323
"""An operation cannot succeed because of a lack of permissions."""
1279
_fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
1282
class ConnectionError(TransportError):
1284
_fmt = "Connection error: %(msg)s %(orig_error)s"
1287
class SocketConnectionError(ConnectionError):
1289
_fmt = "%(msg)s %(host)s%(port)s%(orig_error)s"
1291
def __init__(self, host, port=None, msg=None, orig_error=None):
1293
msg = 'Failed to connect to'
1294
if orig_error is None:
1297
orig_error = '; ' + str(orig_error)
1298
ConnectionError.__init__(self, msg=msg, orig_error=orig_error)
1303
self.port = ':%s' % port
1306
# XXX: This is also used for unexpected end of file, which is different at the
1307
# TCP level from "connection reset".
326
1308
class ConnectionReset(TransportError):
327
"""The connection has been closed."""
1310
_fmt = "Connection closed: %(msg)s %(orig_error)s"
1313
class ConnectionTimeout(ConnectionError):
1315
_fmt = "Connection Timeout: %(msg)s%(orig_error)s"
1318
class InvalidRange(TransportError):
1320
_fmt = "Invalid range access in %(path)s at %(offset)s: %(msg)s"
1322
def __init__(self, path, offset, msg=None):
1323
TransportError.__init__(self, msg)
1325
self.offset = offset
1328
class InvalidHttpResponse(TransportError):
1330
_fmt = "Invalid http response for %(path)s: %(msg)s%(orig_error)s"
1332
def __init__(self, path, msg, orig_error=None):
1334
if orig_error is None:
1337
# This is reached for obscure and unusual errors so we want to
1338
# preserve as much info as possible to ease debug.
1339
orig_error = ': %r' % (orig_error,)
1340
TransportError.__init__(self, msg, orig_error=orig_error)
1343
class InvalidHttpRange(InvalidHttpResponse):
1345
_fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
1347
def __init__(self, path, range, msg):
1349
InvalidHttpResponse.__init__(self, path, msg)
1352
class HttpBoundaryMissing(InvalidHttpResponse):
1353
"""A multipart response ends with no boundary marker.
1355
This is a special case caused by buggy proxies, described in
1356
<https://bugs.launchpad.net/bzr/+bug/198646>.
1359
_fmt = "HTTP MIME Boundary missing for %(path)s: %(msg)s"
1361
def __init__(self, path, msg):
1362
InvalidHttpResponse.__init__(self, path, msg)
1365
class InvalidHttpContentType(InvalidHttpResponse):
1367
_fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1369
def __init__(self, path, ctype, msg):
1371
InvalidHttpResponse.__init__(self, path, msg)
1374
class RedirectRequested(TransportError):
1376
_fmt = '%(source)s is%(permanently)s redirected to %(target)s'
1378
def __init__(self, source, target, is_permanent=False):
1379
self.source = source
1380
self.target = target
1382
self.permanently = ' permanently'
1384
self.permanently = ''
1385
TransportError.__init__(self)
1388
class TooManyRedirections(TransportError):
1390
_fmt = "Too many redirections"
330
1393
class ConflictsInTree(BzrError):
1395
_fmt = "Working tree has conflicts."
1398
class DependencyNotPresent(BzrError):
1400
_fmt = 'Unable to import library "%(library)s": %(error)s'
1402
def __init__(self, library, error):
1403
BzrError.__init__(self, library=library, error=error)
1406
class WorkingTreeNotRevision(BzrError):
1408
_fmt = ("The working tree for %(basedir)s has changed since"
1409
" the last commit, but weave merge requires that it be"
1412
def __init__(self, tree):
1413
BzrError.__init__(self, basedir=tree.basedir)
1416
class GraphCycleError(BzrError):
1418
_fmt = "Cycle in graph %(graph)r"
1420
def __init__(self, graph):
1421
BzrError.__init__(self)
1425
class WritingCompleted(InternalBzrError):
1427
_fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
1428
"called upon it - accept bytes may not be called anymore.")
1430
def __init__(self, request):
1431
self.request = request
1434
class WritingNotComplete(InternalBzrError):
1436
_fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
1437
"called upon it - until the write phase is complete no "
1438
"data may be read.")
1440
def __init__(self, request):
1441
self.request = request
1444
class NotConflicted(BzrError):
1446
_fmt = "File %(filename)s is not conflicted."
1448
def __init__(self, filename):
1449
BzrError.__init__(self)
1450
self.filename = filename
1453
class MediumNotConnected(InternalBzrError):
1455
_fmt = """The medium '%(medium)s' is not connected."""
1457
def __init__(self, medium):
1458
self.medium = medium
1461
class MustUseDecorated(Exception):
1463
_fmt = "A decorating function has requested its original command be used."
1466
class NoBundleFound(BzrError):
1468
_fmt = 'No bundle was found in "%(filename)s".'
1470
def __init__(self, filename):
1471
BzrError.__init__(self)
1472
self.filename = filename
1475
class BundleNotSupported(BzrError):
1477
_fmt = "Unable to handle bundle version %(version)s: %(msg)s"
1479
def __init__(self, version, msg):
1480
BzrError.__init__(self)
1481
self.version = version
1485
class MissingText(BzrError):
1487
_fmt = ("Branch %(base)s is missing revision"
1488
" %(text_revision)s of %(file_id)s")
1490
def __init__(self, branch, text_revision, file_id):
1491
BzrError.__init__(self)
1492
self.branch = branch
1493
self.base = branch.base
1494
self.text_revision = text_revision
1495
self.file_id = file_id
1498
class DuplicateFileId(BzrError):
1500
_fmt = "File id {%(file_id)s} already exists in inventory as %(entry)s"
1502
def __init__(self, file_id, entry):
1503
BzrError.__init__(self)
1504
self.file_id = file_id
1508
class DuplicateKey(BzrError):
1510
_fmt = "Key %(key)s is already present in map"
1513
class DuplicateHelpPrefix(BzrError):
1515
_fmt = "The prefix %(prefix)s is in the help search path twice."
1517
def __init__(self, prefix):
1518
self.prefix = prefix
1521
class MalformedTransform(InternalBzrError):
1523
_fmt = "Tree transform is malformed %(conflicts)r"
1526
class NoFinalPath(BzrError):
1528
_fmt = ("No final name for trans_id %(trans_id)r\n"
1529
"file-id: %(file_id)r\n"
1530
"root trans-id: %(root_trans_id)r\n")
1532
def __init__(self, trans_id, transform):
1533
self.trans_id = trans_id
1534
self.file_id = transform.final_file_id(trans_id)
1535
self.root_trans_id = transform.root
1538
class BzrBadParameter(InternalBzrError):
1540
_fmt = "Bad parameter: %(param)r"
1542
# This exception should never be thrown, but it is a base class for all
1543
# parameter-to-function errors.
1545
def __init__(self, param):
1546
BzrError.__init__(self)
1550
class BzrBadParameterNotUnicode(BzrBadParameter):
1552
_fmt = "Parameter %(param)s is neither unicode nor utf8."
1555
class ReusingTransform(BzrError):
1557
_fmt = "Attempt to reuse a transform that has already been applied."
1560
class CantMoveRoot(BzrError):
1562
_fmt = "Moving the root directory is not supported at this time"
1565
class TransformRenameFailed(BzrError):
1567
_fmt = "Failed to rename %(from_path)s to %(to_path)s: %(why)s"
1569
def __init__(self, from_path, to_path, why, errno):
1570
self.from_path = from_path
1571
self.to_path = to_path
1576
class BzrMoveFailedError(BzrError):
1578
_fmt = ("Could not move %(from_path)s%(operator)s %(to_path)s"
1579
"%(_has_extra)s%(extra)s")
1581
def __init__(self, from_path='', to_path='', extra=None):
1582
from breezy.osutils import splitpath
1583
BzrError.__init__(self)
1585
self.extra, self._has_extra = extra, ': '
1587
self.extra = self._has_extra = ''
1589
has_from = len(from_path) > 0
1590
has_to = len(to_path) > 0
1592
self.from_path = splitpath(from_path)[-1]
1597
self.to_path = splitpath(to_path)[-1]
1602
if has_from and has_to:
1603
self.operator = " =>"
1605
self.from_path = "from " + from_path
1607
self.operator = "to"
1609
self.operator = "file"
1612
class BzrRenameFailedError(BzrMoveFailedError):
1614
_fmt = ("Could not rename %(from_path)s%(operator)s %(to_path)s"
1615
"%(_has_extra)s%(extra)s")
1617
def __init__(self, from_path, to_path, extra=None):
1618
BzrMoveFailedError.__init__(self, from_path, to_path, extra)
1621
class BzrBadParameterNotString(BzrBadParameter):
1623
_fmt = "Parameter %(param)s is not a string or unicode string."
1626
class BzrBadParameterMissing(BzrBadParameter):
1628
_fmt = "Parameter %(param)s is required but not present."
1631
class BzrBadParameterUnicode(BzrBadParameter):
1633
_fmt = ("Parameter %(param)s is unicode but"
1634
" only byte-strings are permitted.")
1637
class BzrBadParameterContainsNewline(BzrBadParameter):
1639
_fmt = "Parameter %(param)s contains a newline."
1642
class ParamikoNotPresent(DependencyNotPresent):
1644
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
1646
def __init__(self, error):
1647
DependencyNotPresent.__init__(self, 'paramiko', error)
1650
class PointlessMerge(BzrError):
1652
_fmt = "Nothing to merge."
1655
class UninitializableFormat(BzrError):
1657
_fmt = "Format %(format)s cannot be initialised by this version of brz."
1659
def __init__(self, format):
1660
BzrError.__init__(self)
1661
self.format = format
1664
class BadConversionTarget(BzrError):
1666
_fmt = "Cannot convert from format %(from_format)s to format %(format)s." \
1669
def __init__(self, problem, format, from_format=None):
1670
BzrError.__init__(self)
1671
self.problem = problem
1672
self.format = format
1673
self.from_format = from_format or '(unspecified)'
1676
class NoDiffFound(BzrError):
1678
_fmt = 'Could not find an appropriate Differ for file "%(path)s"'
1680
def __init__(self, path):
1681
BzrError.__init__(self, path)
1684
class ExecutableMissing(BzrError):
1686
_fmt = "%(exe_name)s could not be found on this machine"
1688
def __init__(self, exe_name):
1689
BzrError.__init__(self, exe_name=exe_name)
1692
class NoDiff(BzrError):
1694
_fmt = "Diff is not installed on this machine: %(msg)s"
1696
def __init__(self, msg):
1697
BzrError.__init__(self, msg=msg)
1700
class NoDiff3(BzrError):
1702
_fmt = "Diff3 is not installed on this machine."
1705
class ExistingContent(BzrError):
1706
# Added in breezy 0.92, used by VersionedFile.add_lines.
1708
_fmt = "The content being inserted is already present."
1711
class ExistingLimbo(BzrError):
1713
_fmt = """This tree contains left-over files from a failed operation.
1714
Please examine %(limbo_dir)s to see if it contains any files you wish to
1715
keep, and delete it when you are done."""
1717
def __init__(self, limbo_dir):
1718
BzrError.__init__(self)
1719
self.limbo_dir = limbo_dir
1722
class ExistingPendingDeletion(BzrError):
1724
_fmt = """This tree contains left-over files from a failed operation.
1725
Please examine %(pending_deletion)s to see if it contains any files you
1726
wish to keep, and delete it when you are done."""
1728
def __init__(self, pending_deletion):
1729
BzrError.__init__(self, pending_deletion=pending_deletion)
1732
class ImmortalLimbo(BzrError):
1734
_fmt = """Unable to delete transform temporary directory %(limbo_dir)s.
1735
Please examine %(limbo_dir)s to see if it contains any files you wish to
1736
keep, and delete it when you are done."""
1738
def __init__(self, limbo_dir):
1739
BzrError.__init__(self)
1740
self.limbo_dir = limbo_dir
1743
class ImmortalPendingDeletion(BzrError):
1745
_fmt = ("Unable to delete transform temporary directory "
1746
"%(pending_deletion)s. Please examine %(pending_deletion)s to see if it "
1747
"contains any files you wish to keep, and delete it when you are done.")
1749
def __init__(self, pending_deletion):
1750
BzrError.__init__(self, pending_deletion=pending_deletion)
1753
class OutOfDateTree(BzrError):
1755
_fmt = "Working tree is out of date, please run 'brz update'.%(more)s"
1757
def __init__(self, tree, more=None):
1762
BzrError.__init__(self)
1767
class PublicBranchOutOfDate(BzrError):
1769
_fmt = 'Public branch "%(public_location)s" lacks revision '\
1772
def __init__(self, public_location, revstring):
1773
import breezy.urlutils as urlutils
1774
public_location = urlutils.unescape_for_display(public_location,
1776
BzrError.__init__(self, public_location=public_location,
1777
revstring=revstring)
1780
class MergeModifiedFormatError(BzrError):
1782
_fmt = "Error in merge modified format"
1785
class ConflictFormatError(BzrError):
1787
_fmt = "Format error in conflict listings"
1790
class CorruptRepository(BzrError):
1792
_fmt = ("An error has been detected in the repository %(repo_path)s.\n"
1793
"Please run brz reconcile on this repository.")
1795
def __init__(self, repo):
1796
BzrError.__init__(self)
1797
self.repo_path = repo.user_url
1800
class InconsistentDelta(BzrError):
1801
"""Used when we get a delta that is not valid."""
1803
_fmt = ("An inconsistent delta was supplied involving %(path)r,"
1804
" %(file_id)r\nreason: %(reason)s")
1806
def __init__(self, path, file_id, reason):
1807
BzrError.__init__(self)
1809
self.file_id = file_id
1810
self.reason = reason
1813
class InconsistentDeltaDelta(InconsistentDelta):
1814
"""Used when we get a delta that is not valid."""
1816
_fmt = ("An inconsistent delta was supplied: %(delta)r"
1817
"\nreason: %(reason)s")
1819
def __init__(self, delta, reason):
1820
BzrError.__init__(self)
1822
self.reason = reason
1825
class UpgradeRequired(BzrError):
1827
_fmt = "To use this feature you must upgrade your branch at %(path)s."
1829
def __init__(self, path):
1830
BzrError.__init__(self)
1834
class RepositoryUpgradeRequired(UpgradeRequired):
1836
_fmt = "To use this feature you must upgrade your repository at %(path)s."
1839
class RichRootUpgradeRequired(UpgradeRequired):
1841
_fmt = ("To use this feature you must upgrade your branch at %(path)s to"
1842
" a format which supports rich roots.")
1845
class LocalRequiresBoundBranch(BzrError):
1847
_fmt = "Cannot perform local-only commits on unbound branches."
1850
class UnsupportedOperation(BzrError):
1852
_fmt = ("The method %(mname)s is not supported on"
1853
" objects of type %(tname)s.")
1855
def __init__(self, method, method_self):
1856
self.method = method
1857
self.mname = method.__name__
1858
self.tname = type(method_self).__name__
1861
class FetchLimitUnsupported(UnsupportedOperation):
1863
fmt = ("InterBranch %(interbranch)r does not support fetching limits.")
1865
def __init__(self, interbranch):
1866
BzrError.__init__(self, interbranch=interbranch)
1869
class NonAsciiRevisionId(UnsupportedOperation):
1870
"""Raised when a commit is attempting to set a non-ascii revision id
1875
class SharedRepositoriesUnsupported(UnsupportedOperation):
1876
_fmt = "Shared repositories are not supported by %(format)r."
1878
def __init__(self, format):
1879
BzrError.__init__(self, format=format)
1882
class GhostTagsNotSupported(BzrError):
1884
_fmt = "Ghost tags not supported by format %(format)r."
1886
def __init__(self, format):
1887
self.format = format
1890
class BinaryFile(BzrError):
1892
_fmt = "File is binary but should be text."
1895
class IllegalPath(BzrError):
1897
_fmt = "The path %(path)s is not permitted on this platform"
1899
def __init__(self, path):
1900
BzrError.__init__(self)
1904
class TestamentMismatch(BzrError):
1906
_fmt = """Testament did not match expected value.
1907
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1910
def __init__(self, revision_id, expected, measured):
1911
self.revision_id = revision_id
1912
self.expected = expected
1913
self.measured = measured
1916
class NotABundle(BzrError):
1918
_fmt = "Not a bzr revision-bundle: %(text)r"
1920
def __init__(self, text):
1921
BzrError.__init__(self)
1925
class BadBundle(BzrError):
1927
_fmt = "Bad bzr revision-bundle: %(text)r"
1929
def __init__(self, text):
1930
BzrError.__init__(self)
1934
class MalformedHeader(BadBundle):
1936
_fmt = "Malformed bzr revision-bundle header: %(text)r"
1939
class MalformedPatches(BadBundle):
1941
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1944
class MalformedFooter(BadBundle):
1946
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1949
class UnsupportedEOLMarker(BadBundle):
1951
_fmt = "End of line marker was not \\n in bzr revision-bundle"
331
1953
def __init__(self):
332
BzrError.__init__(self, "Working tree has conflicts.")
334
class SigningFailed(BzrError):
335
def __init__(self, command_line):
336
BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
1954
# XXX: BadBundle's constructor assumes there's explanatory text,
1955
# but for this there is not
1956
BzrError.__init__(self)
1959
class IncompatibleBundleFormat(BzrError):
1961
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
1963
def __init__(self, bundle_format, other):
1964
BzrError.__init__(self)
1965
self.bundle_format = bundle_format
1969
class BadInventoryFormat(BzrError):
1971
_fmt = "Root class for inventory serialization errors"
1974
class UnexpectedInventoryFormat(BadInventoryFormat):
1976
_fmt = "The inventory was not in the expected format:\n %(msg)s"
1978
def __init__(self, msg):
1979
BadInventoryFormat.__init__(self, msg=msg)
1982
class RootNotRich(BzrError):
1984
_fmt = """This operation requires rich root data storage"""
1987
class NoSmartMedium(InternalBzrError):
1989
_fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
1991
def __init__(self, transport):
1992
self.transport = transport
1995
class UnknownSSH(BzrError):
1997
_fmt = "Unrecognised value for BRZ_SSH environment variable: %(vendor)s"
1999
def __init__(self, vendor):
2000
BzrError.__init__(self)
2001
self.vendor = vendor
2004
class SSHVendorNotFound(BzrError):
2006
_fmt = ("Don't know how to handle SSH connections."
2007
" Please set BRZ_SSH environment variable.")
2010
class GhostRevisionsHaveNoRevno(BzrError):
2011
"""When searching for revnos, if we encounter a ghost, we are stuck"""
2013
_fmt = ("Could not determine revno for {%(revision_id)s} because"
2014
" its ancestry shows a ghost at {%(ghost_revision_id)s}")
2016
def __init__(self, revision_id, ghost_revision_id):
2017
self.revision_id = revision_id
2018
self.ghost_revision_id = ghost_revision_id
2021
class GhostRevisionUnusableHere(BzrError):
2023
_fmt = "Ghost revision {%(revision_id)s} cannot be used here."
2025
def __init__(self, revision_id):
2026
BzrError.__init__(self)
2027
self.revision_id = revision_id
2030
class NotAMergeDirective(BzrError):
2031
"""File starting with %(firstline)r is not a merge directive"""
2033
def __init__(self, firstline):
2034
BzrError.__init__(self, firstline=firstline)
2037
class NoMergeSource(BzrError):
2038
"""Raise if no merge source was specified for a merge directive"""
2040
_fmt = "A merge directive must provide either a bundle or a public"\
2044
class IllegalMergeDirectivePayload(BzrError):
2045
"""A merge directive contained something other than a patch or bundle"""
2047
_fmt = "Bad merge directive payload %(start)r"
2049
def __init__(self, start):
2054
class PatchVerificationFailed(BzrError):
2055
"""A patch from a merge directive could not be verified"""
2057
_fmt = "Preview patch does not match requested changes."
2060
class PatchMissing(BzrError):
2061
"""Raise a patch type was specified but no patch supplied"""
2063
_fmt = "Patch_type was %(patch_type)s, but no patch was supplied."
2065
def __init__(self, patch_type):
2066
BzrError.__init__(self)
2067
self.patch_type = patch_type
2070
class TargetNotBranch(BzrError):
2071
"""A merge directive's target branch is required, but isn't a branch"""
2073
_fmt = ("Your branch does not have all of the revisions required in "
2074
"order to merge this merge directive and the target "
2075
"location specified in the merge directive is not a branch: "
2078
def __init__(self, location):
2079
BzrError.__init__(self)
2080
self.location = location
2083
class UnsupportedInventoryKind(BzrError):
2085
_fmt = """Unsupported entry kind %(kind)s"""
2087
def __init__(self, kind):
2091
class BadSubsumeSource(BzrError):
2093
_fmt = "Can't subsume %(other_tree)s into %(tree)s. %(reason)s"
2095
def __init__(self, tree, other_tree, reason):
2097
self.other_tree = other_tree
2098
self.reason = reason
2101
class SubsumeTargetNeedsUpgrade(BzrError):
2103
_fmt = """Subsume target %(other_tree)s needs to be upgraded."""
2105
def __init__(self, other_tree):
2106
self.other_tree = other_tree
2109
class NoSuchTag(BzrError):
2111
_fmt = "No such tag: %(tag_name)s"
2113
def __init__(self, tag_name):
2114
self.tag_name = tag_name
2117
class TagsNotSupported(BzrError):
2119
_fmt = ("Tags not supported by %(branch)s;"
2120
" you may be able to use 'brz upgrade %(branch_url)s'.")
2122
def __init__(self, branch):
2123
self.branch = branch
2124
self.branch_url = branch.user_url
2127
class TagAlreadyExists(BzrError):
2129
_fmt = "Tag %(tag_name)s already exists."
2131
def __init__(self, tag_name):
2132
self.tag_name = tag_name
2135
class UnexpectedSmartServerResponse(BzrError):
2137
_fmt = "Could not understand response from smart server: %(response_tuple)r"
2139
def __init__(self, response_tuple):
2140
self.response_tuple = response_tuple
2143
class ErrorFromSmartServer(BzrError):
2144
"""An error was received from a smart server.
2146
:seealso: UnknownErrorFromSmartServer
2149
_fmt = "Error received from smart server: %(error_tuple)r"
2151
internal_error = True
2153
def __init__(self, error_tuple):
2154
self.error_tuple = error_tuple
2156
self.error_verb = error_tuple[0]
2158
self.error_verb = None
2159
self.error_args = error_tuple[1:]
2162
class UnknownErrorFromSmartServer(BzrError):
2163
"""An ErrorFromSmartServer could not be translated into a typical breezy
2166
This is distinct from ErrorFromSmartServer so that it is possible to
2167
distinguish between the following two cases:
2169
- ErrorFromSmartServer was uncaught. This is logic error in the client
2170
and so should provoke a traceback to the user.
2171
- ErrorFromSmartServer was caught but its error_tuple could not be
2172
translated. This is probably because the server sent us garbage, and
2173
should not provoke a traceback.
2176
_fmt = "Server sent an unexpected error: %(error_tuple)r"
2178
internal_error = False
2180
def __init__(self, error_from_smart_server):
2183
:param error_from_smart_server: An ErrorFromSmartServer instance.
2185
self.error_from_smart_server = error_from_smart_server
2186
self.error_tuple = error_from_smart_server.error_tuple
2189
class ContainerError(BzrError):
2190
"""Base class of container errors."""
2193
class UnknownContainerFormatError(ContainerError):
2195
_fmt = "Unrecognised container format: %(container_format)r"
2197
def __init__(self, container_format):
2198
self.container_format = container_format
2201
class UnexpectedEndOfContainerError(ContainerError):
2203
_fmt = "Unexpected end of container stream"
2206
class UnknownRecordTypeError(ContainerError):
2208
_fmt = "Unknown record type: %(record_type)r"
2210
def __init__(self, record_type):
2211
self.record_type = record_type
2214
class InvalidRecordError(ContainerError):
2216
_fmt = "Invalid record: %(reason)s"
2218
def __init__(self, reason):
2219
self.reason = reason
2222
class ContainerHasExcessDataError(ContainerError):
2224
_fmt = "Container has data after end marker: %(excess)r"
2226
def __init__(self, excess):
2227
self.excess = excess
2230
class DuplicateRecordNameError(ContainerError):
2232
_fmt = "Container has multiple records with the same name: %(name)s"
2234
def __init__(self, name):
2235
self.name = name.decode("utf-8")
2238
class RepositoryDataStreamError(BzrError):
2240
_fmt = "Corrupt or incompatible data stream: %(reason)s"
2242
def __init__(self, reason):
2243
self.reason = reason
2246
class UncommittedChanges(BzrError):
2248
_fmt = ('Working tree "%(display_url)s" has uncommitted changes'
2249
' (See brz status).%(more)s')
2251
def __init__(self, tree, more=None):
2256
import breezy.urlutils as urlutils
2257
user_url = getattr(tree, "user_url", None)
2258
if user_url is None:
2259
display_url = str(tree)
2261
display_url = urlutils.unescape_for_display(user_url, 'ascii')
2262
BzrError.__init__(self, tree=tree, display_url=display_url, more=more)
2265
class StoringUncommittedNotSupported(BzrError):
2267
_fmt = ('Branch "%(display_url)s" does not support storing uncommitted'
2270
def __init__(self, branch):
2271
import breezy.urlutils as urlutils
2272
user_url = getattr(branch, "user_url", None)
2273
if user_url is None:
2274
display_url = str(branch)
2276
display_url = urlutils.unescape_for_display(user_url, 'ascii')
2277
BzrError.__init__(self, branch=branch, display_url=display_url)
2280
class ShelvedChanges(UncommittedChanges):
2282
_fmt = ('Working tree "%(display_url)s" has shelved changes'
2283
' (See brz shelve --list).%(more)s')
2286
class UnableEncodePath(BzrError):
2288
_fmt = ('Unable to encode %(kind)s path %(path)r in '
2289
'user encoding %(user_encoding)s')
2291
def __init__(self, path, kind):
2292
from breezy.osutils import get_user_encoding
2295
self.user_encoding = get_user_encoding()
2298
class NoSuchAlias(BzrError):
2300
_fmt = ('The alias "%(alias_name)s" does not exist.')
2302
def __init__(self, alias_name):
2303
BzrError.__init__(self, alias_name=alias_name)
2306
class CannotBindAddress(BzrError):
2308
_fmt = 'Cannot bind address "%(host)s:%(port)i": %(orig_error)s.'
2310
def __init__(self, host, port, orig_error):
2311
# nb: in python2.4 socket.error doesn't have a useful repr
2312
BzrError.__init__(self, host=host, port=port,
2313
orig_error=repr(orig_error.args))
2316
class TipChangeRejected(BzrError):
2317
"""A pre_change_branch_tip hook function may raise this to cleanly and
2318
explicitly abort a change to a branch tip.
2321
_fmt = u"Tip change rejected: %(msg)s"
2323
def __init__(self, msg):
2327
class JailBreak(BzrError):
2329
_fmt = "An attempt to access a url outside the server jail was made: '%(url)s'."
2331
def __init__(self, url):
2332
BzrError.__init__(self, url=url)
2335
class UserAbort(BzrError):
2337
_fmt = 'The user aborted the operation.'
2340
class UnresumableWriteGroup(BzrError):
2342
_fmt = ("Repository %(repository)s cannot resume write group "
2343
"%(write_groups)r: %(reason)s")
2345
internal_error = True
2347
def __init__(self, repository, write_groups, reason):
2348
self.repository = repository
2349
self.write_groups = write_groups
2350
self.reason = reason
2353
class UnsuspendableWriteGroup(BzrError):
2355
_fmt = ("Repository %(repository)s cannot suspend a write group.")
2357
internal_error = True
2359
def __init__(self, repository):
2360
self.repository = repository
2363
class LossyPushToSameVCS(BzrError):
2365
_fmt = ("Lossy push not possible between %(source_branch)r and "
2366
"%(target_branch)r that are in the same VCS.")
2368
internal_error = True
2370
def __init__(self, source_branch, target_branch):
2371
self.source_branch = source_branch
2372
self.target_branch = target_branch
2375
class NoRoundtrippingSupport(BzrError):
2377
_fmt = ("Roundtripping is not supported between %(source_branch)r and "
2378
"%(target_branch)r.")
2380
internal_error = True
2382
def __init__(self, source_branch, target_branch):
2383
self.source_branch = source_branch
2384
self.target_branch = target_branch
2387
class NoColocatedBranchSupport(BzrError):
2389
_fmt = ("%(controldir)r does not support co-located branches.")
2391
def __init__(self, controldir):
2392
self.controldir = controldir
2395
class RecursiveBind(BzrError):
2397
_fmt = ('Branch "%(branch_url)s" appears to be bound to itself. '
2398
'Please use `brz unbind` to fix.')
2400
def __init__(self, branch_url):
2401
self.branch_url = branch_url
2404
class UnsupportedKindChange(BzrError):
2406
_fmt = ("Kind change from %(from_kind)s to %(to_kind)s for "
2407
"%(path)s not supported by format %(format)r")
2409
def __init__(self, path, from_kind, to_kind, format):
2411
self.from_kind = from_kind
2412
self.to_kind = to_kind
2413
self.format = format
2416
class ChangesAlreadyStored(BzrCommandError):
2418
_fmt = ('Cannot store uncommitted changes because this branch already'
2419
' stores uncommitted changes.')
2422
class RevnoOutOfBounds(InternalBzrError):
2424
_fmt = ("The requested revision number %(revno)d is outside of the "
2425
"expected boundaries (%(minimum)d <= %(maximum)d).")
2427
def __init__(self, revno, bounds):
2428
InternalBzrError.__init__(
2429
self, revno=revno, minimum=bounds[0], maximum=bounds[1])
added
removed
breezy/errors.py
