1
# Copyright (C) 2005-2013, 2016 Canonical Ltd
1
# Copyright (C) 2005, 2006 Canonical
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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 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
... path = getattr(sys.exc_value, 'path')
38
... if path is not None:
40
bzrlib.errors.NotBranchError
41
Not a branch: /foo/bar
46
* create a new exception class for any class of error that can be
47
usefully distinguished.
49
* the printable form of an exception is generated by the base class
52
Exception strings should start with a capital letter and not have a final
20
from __future__ import absolute_import
56
# based on Scott James Remnant's hct error classes
26
58
# TODO: is there any value in providing the .args field used by standard
27
# python exceptions? A list of values with no names seems less useful
59
# python exceptions? A list of values with no names seems less useful
30
# TODO: Perhaps convert the exception to a string at the moment it's
62
# TODO: Perhaps convert the exception to a string at the moment it's
31
63
# constructed to make sure it will succeed. But that says nothing about
32
64
# exceptions that are never raised.
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
66
# TODO: Convert all the other error classes here to BzrNewError, and eliminate
70
class BzrError(StandardError):
72
# XXX: Should we show the exception class in
73
# exceptions that don't provide their own message?
74
# maybe it should be done at a higher level
75
## n = self.__class__.__name__ + ': '
77
if len(self.args) == 1:
78
return str(self.args[0])
79
elif len(self.args) == 2:
80
# further explanation or suggestions
82
return n + '\n '.join([self.args[0]] + self.args[1])
84
return n + "%r" % self
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
86
return n + `self.args`
89
class BzrNewError(BzrError):
91
# base classes should override the docstring with their human-
92
# readable explanation
94
def __init__(self, **kwds):
95
for key, value in kwds.items():
96
setattr(self, key, value)
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"
100
return self.__doc__ % self.__dict__
101
except (NameError, ValueError, KeyError), e:
102
return 'Unprintable exception %s: %s' \
103
% (self.__class__.__name__, str(e))
106
class BzrCheckError(BzrNewError):
107
"""Internal check failed: %(message)s"""
109
def __init__(self, message):
110
BzrNewError.__init__(self)
111
self.message = message
114
class InvalidEntryName(BzrNewError):
115
"""Invalid entry name: %(name)s"""
189
116
def __init__(self, name):
190
BzrError.__init__(self)
117
BzrNewError.__init__(self)
194
class InvalidRevisionNumber(BzrError):
196
_fmt = "Invalid revision number %(revno)s"
121
class InvalidRevisionNumber(BzrNewError):
122
"""Invalid revision number %(revno)d"""
198
123
def __init__(self, revno):
199
BzrError.__init__(self)
124
BzrNewError.__init__(self)
200
125
self.revno = revno
203
class InvalidRevisionId(BzrError):
205
_fmt = "Invalid revision-id {%(revision_id)s} in %(branch)s"
128
class InvalidRevisionId(BzrNewError):
129
"""Invalid revision-id {%(revision_id)s} in %(branch)s"""
207
130
def __init__(self, revision_id, branch):
208
# branch can be any string or object with __str__ defined
209
BzrError.__init__(self)
131
BzrNewError.__init__(self)
210
132
self.revision_id = revision_id
211
133
self.branch = branch
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".'
136
class NoWorkingTree(BzrNewError):
137
"""No WorkingTree exists for %s(base)."""
266
139
def __init__(self, base):
267
BzrError.__init__(self)
140
BzrNewError.__init__(self)
271
class NotLocalUrl(BzrError):
273
_fmt = "%(url)s is not a local path."
144
class NotLocalUrl(BzrNewError):
145
"""%s(url) is not a local path."""
275
147
def __init__(self, url):
148
BzrNewError.__init__(self)
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>"')
294
152
class BzrCommandError(BzrError):
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.
153
# Error from malformed user command
154
# This is being misused as a generic exception
155
# pleae subclass. RBC 20051030
300
157
# I think it's a waste of effort to differentiate between errors that
301
158
# are not intended to be caught anyway. UI code need not subclass
302
159
# BzrCommandError, and non-UI code should not throw a subclass of
303
160
# 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)"
165
class BzrOptionError(BzrCommandError):
166
"""Some missing or otherwise incorrect option was supplied."""
169
class StrictCommitFailed(Exception):
170
"""Commit refused because there are unknowns in the tree."""
173
class PathError(BzrNewError):
174
"""Generic path error: %(path)r%(extra)s)"""
329
175
def __init__(self, path, extra=None):
330
BzrError.__init__(self)
176
BzrNewError.__init__(self)
333
179
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
212
class NotBranchError(BzrNewError):
213
"""Not a branch: %(path)s"""
214
def __init__(self, path):
215
BzrNewError.__init__(self)
219
class NoRepositoryPresent(BzrNewError):
220
"""Not repository present: %(path)r"""
221
def __init__(self, bzrdir):
222
BzrNewError.__init__(self)
223
self.path = bzrdir.transport.clone('..').base
226
class FileInWrongBranch(BzrNewError):
227
"""File %(path)s in not in branch %(branch_base)s."""
229
def __init__(self, branch, path):
230
BzrNewError.__init__(self)
232
self.branch_base = branch.base
589
236
class UnsupportedFormatError(BzrError):
591
_fmt = "Unsupported branch format: %(format)s\nPlease run 'brz upgrade'"
237
"""Specified path is a bzr branch that we recognize but cannot read."""
239
return 'unsupported branch format: %s' % self.args[0]
594
242
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)
243
"""Specified path is a bzr branch whose format we do not recognize."""
245
return 'unknown branch format: %s' % self.args[0]
248
class IncompatibleFormat(BzrNewError):
249
"""Format %(format)s is not compatible with .bzr version %(bzrdir)s."""
251
def __init__(self, format, bzrdir_format):
252
BzrNewError.__init__(self)
254
self.bzrdir = bzrdir_format
257
class NotVersionedError(BzrNewError):
258
"""%(path)s is not versioned"""
259
def __init__(self, path):
260
BzrNewError.__init__(self)
735
264
class BadFileKindError(BzrError):
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"
265
"""Specified file is of a kind that cannot be added.
267
(For example a symlink or device file.)"""
270
class ForbiddenFileError(BzrError):
271
"""Cannot operate on a file because it is a control file."""
274
class LockError(BzrNewError):
275
"""Lock error: %(message)s"""
763
276
# All exceptions from the lock/unlock functions should be from
764
277
# this exception class. They will be translated as necessary. The
765
278
# original exception is available as e.original_error
767
280
# 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
281
def __init__(self, message):
282
self.message = message
782
285
class CommitNotPossible(LockError):
784
_fmt = "A commit was attempted but we do not have a write lock open."
286
"""A commit was attempted but we do not have a write lock open."""
786
287
def __init__(self):
790
291
class AlreadyCommitted(LockError):
792
_fmt = "A rollback was requested, but is not able to be accomplished."
292
"""A rollback was requested, but is not able to be accomplished."""
794
293
def __init__(self):
798
297
class ReadOnlyError(LockError):
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):
298
"""A write attempt was made in a read only transaction on %(obj)s"""
299
def __init__(self, obj):
303
class BranchNotLocked(LockError):
304
"""Branch %(branch)r is not locked"""
305
def __init__(self, branch):
306
# XXX: sometimes called with a LockableFiles instance not a Branch
838
310
class ReadOnlyObjectDirtiedError(ReadOnlyError):
840
_fmt = "Cannot change object %(obj)r in read only transaction"
311
"""Cannot change object %(obj)r in read only transaction"""
842
312
def __init__(self, obj):
846
316
class UnlockableTransport(LockError):
848
internal_error = False
850
_fmt = "Cannot lock: transport is read only: %(transport)s"
317
"""Cannot lock: transport is read only: %(transport)s"""
852
318
def __init__(self, transport):
853
319
self.transport = transport
856
322
class LockContention(LockError):
858
_fmt = 'Could not acquire lock "%(lock)s": %(msg)s'
860
internal_error = False
862
def __init__(self, lock, msg=''):
323
"""Could not acquire lock %(lock)s"""
324
# TODO: show full url for lock, combining the transport and relative bits?
325
def __init__(self, lock):
867
329
class LockBroken(LockError):
869
_fmt = ("Lock was broken while still open: %(lock)s"
870
" - check storage consistency!")
872
internal_error = False
330
"""Lock was broken while still open: %(lock)s - check storage consistency!"""
874
331
def __init__(self, lock):
878
335
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
336
"""Lock was released and re-acquired before being broken: %(lock)s: held by %(holder)r, wanted to break %(target)r"""
885
337
def __init__(self, lock, holder, target):
887
339
self.holder = holder
888
340
self.target = 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
343
class LockNotHeld(LockError):
905
_fmt = "Lock not held: %(lock)s"
907
internal_error = False
344
"""Lock not held: %(lock)s"""
909
345
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."
349
class BranchNotLocked(LockError):
350
"""Branch %(branch)r not locked"""
351
def __init__(self, branch):
355
class PointlessCommit(BzrNewError):
356
"""No changes to commit"""
359
class UpgradeReadonly(BzrNewError):
360
"""Upgrade URL cannot work with readonly URL's."""
363
class UpToDateFormat(BzrNewError):
364
"""The branch format %(format)s is already at the most recent format."""
941
366
def __init__(self, format):
942
BzrError.__init__(self)
367
BzrNewError.__init__(self)
943
368
self.format = format
946
class NoSuchRevision(InternalBzrError):
948
_fmt = "%(branch)s has no revision %(revision)s"
371
class StrictCommitFailed(Exception):
372
"""Commit refused because there are unknowns in the tree."""
374
class NoSuchRevision(BzrError):
950
375
def __init__(self, branch, revision):
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)
377
self.revision = revision
378
msg = "Branch %s has no revision %s" % (branch, revision)
379
BzrError.__init__(self, msg)
382
class HistoryMissing(BzrError):
383
def __init__(self, branch, object_type, object_id):
385
BzrError.__init__(self,
386
'%s is missing %s {%s}'
387
% (branch, object_type, object_id))
1005
390
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.")
1011
391
def __init__(self, branch1, branch2):
392
BzrError.__init__(self, "These branches have diverged. Try merge.")
1012
393
self.branch1 = branch1
1013
394
self.branch2 = branch2
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'
397
class UnrelatedBranches(BzrCommandError):
399
msg = "Branches have no common ancestor, and no base revision"\
401
BzrCommandError.__init__(self, msg)
1036
404
class NoCommonAncestor(BzrError):
1038
_fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
1040
405
def __init__(self, revision_a, revision_b):
1041
self.revision_a = revision_a
1042
self.revision_b = revision_b
406
msg = "Revisions have no common ancestor: %s %s." \
407
% (revision_a, revision_b)
408
BzrError.__init__(self, msg)
1045
411
class NoCommonRoot(BzrError):
1047
_fmt = ("Revisions are not derived from the same root: "
1048
"%(revision_a)s %(revision_b)s.")
1050
412
def __init__(self, revision_a, revision_b):
1051
BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
413
msg = "Revisions are not derived from the same root: %s %s." \
414
% (revision_a, revision_b)
415
BzrError.__init__(self, msg)
1054
418
class NotAncestor(BzrError):
1056
_fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
1058
419
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."
420
msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id,
422
BzrError.__init__(self, msg)
424
self.not_ancestor_id = not_ancestor_id
427
class InstallFailed(BzrError):
428
def __init__(self, revisions):
429
msg = "Could not install revisions:\n%s" % " ,".join(revisions)
430
BzrError.__init__(self, msg)
431
self.revisions = revisions
434
class AmbiguousBase(BzrError):
435
def __init__(self, bases):
436
msg = "The correct base is unclear, becase %s are all equally close" %\
438
BzrError.__init__(self, msg)
442
class NoCommits(BzrError):
443
def __init__(self, branch):
444
msg = "Branch %s has no commits." % branch
445
BzrError.__init__(self, msg)
1068
448
class UnlistableStore(BzrError):
1070
449
def __init__(self, store):
1071
450
BzrError.__init__(self, "Store %s is not listable" % store)
1074
453
class UnlistableBranch(BzrError):
1076
454
def __init__(self, br):
1077
455
BzrError.__init__(self, "Stores for branch %s are not listable" % br)
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"
458
class WeaveError(BzrNewError):
459
"""Error in processing weave: %(message)s"""
460
def __init__(self, message=None):
461
BzrNewError.__init__(self)
462
self.message = message
465
class WeaveRevisionAlreadyPresent(WeaveError):
466
"""Revision {%(revision_id)s} already present in %(weave)s"""
467
def __init__(self, revision_id, weave):
468
WeaveError.__init__(self)
469
self.revision_id = revision_id
473
class WeaveRevisionNotPresent(WeaveError):
474
"""Revision {%(revision_id)s} not present in %(weave)s"""
475
def __init__(self, revision_id, weave):
476
WeaveError.__init__(self)
477
self.revision_id = revision_id
481
class WeaveFormatError(WeaveError):
482
"""Weave invariant violated: %(what)s"""
483
def __init__(self, what):
484
WeaveError.__init__(self)
488
class WeaveParentMismatch(WeaveError):
489
"""Parents are mismatched between two revisions."""
492
class WeaveInvalidChecksum(WeaveError):
493
"""Text did not match it's checksum: %(message)s"""
496
class WeaveTextDiffers(WeaveError):
497
"""Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
499
def __init__(self, revision_id, weave_a, weave_b):
500
WeaveError.__init__(self)
501
self.revision_id = revision_id
502
self.weave_a = weave_a
503
self.weave_b = weave_b
506
class WeaveTextDiffers(WeaveError):
507
"""Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
509
def __init__(self, revision_id, weave_a, weave_b):
510
WeaveError.__init__(self)
511
self.revision_id = revision_id
512
self.weave_a = weave_a
513
self.weave_b = weave_b
516
class NoSuchExportFormat(BzrNewError):
517
"""Export format %(format)r not supported"""
1206
518
def __init__(self, format):
1207
BzrError.__init__(self)
519
BzrNewError.__init__(self)
1208
520
self.format = format
1211
523
class TransportError(BzrError):
1213
_fmt = "Transport error: %(msg)s %(orig_error)s"
524
"""All errors thrown by Transport implementations should derive
1215
527
def __init__(self, msg=None, orig_error=None):
1216
528
if msg is None and orig_error is not None:
1217
529
msg = str(orig_error)
1218
if orig_error is None:
530
BzrError.__init__(self, msg)
1223
532
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)
1276
535
# A set of semi-meaningful errors which can be thrown
1277
536
class TransportNotPossible(TransportError):
1279
_fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
537
"""This is for transports where a specific function is explicitly not
538
possible. Such as pushing files to an HTTP server.
1282
543
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".
544
"""A connection problem prevents file retrieval.
545
This does not indicate whether the file exists or not; it indicates that a
546
precondition for requesting the file was not met.
548
def __init__(self, msg=None, orig_error=None):
549
TransportError.__init__(self, msg=msg, orig_error=orig_error)
1308
552
class ConnectionReset(TransportError):
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"
553
"""The connection has been closed."""
1393
557
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)
559
BzrError.__init__(self, "Working tree has conflicts.")
562
class ParseConfigError(BzrError):
563
def __init__(self, errors, filename):
566
message = "Error(s) parsing config file %s:\n%s" % \
567
(filename, ('\n'.join(e.message for e in errors)))
568
BzrError.__init__(self, message)
571
class SigningFailed(BzrError):
572
def __init__(self, command_line):
573
BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
1406
577
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
578
def __init__(self, tree):
1413
BzrError.__init__(self, basedir=tree.basedir)
1416
class GraphCycleError(BzrError):
1418
_fmt = "Cycle in graph %(graph)r"
579
BzrError.__init__(self, "The working tree for %s has changed since"
580
" last commit, but weave merge requires that it be"
581
" unchanged." % tree.basedir)
584
class CantReprocessAndShowBase(BzrNewError):
585
"""Can't reprocess and show base.
586
Reprocessing obscures relationship of conflicting lines to base."""
589
class GraphCycleError(BzrNewError):
590
"""Cycle in graph %(graph)r"""
1420
591
def __init__(self, graph):
1421
BzrError.__init__(self)
592
BzrNewError.__init__(self)
1422
593
self.graph = graph
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."
596
class NotConflicted(BzrNewError):
597
"""File %(filename)s is not conflicted."""
1448
599
def __init__(self, filename):
1449
BzrError.__init__(self)
600
BzrNewError.__init__(self)
1450
601
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
604
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")
605
"""A decorating function has requested its original command be used.
607
This should never escape bzr, so does not need to be printable.
611
class MissingText(BzrNewError):
612
"""Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"""
1490
614
def __init__(self, branch, text_revision, file_id):
1491
BzrError.__init__(self)
615
BzrNewError.__init__(self)
1492
616
self.branch = branch
1493
617
self.base = branch.base
1494
618
self.text_revision = text_revision
1495
619
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.
621
class DuplicateKey(BzrNewError):
622
"""Key %(key)s is already present in map"""
624
class MalformedTransform(BzrNewError):
625
"""Tree transform is malformed %(conflicts)r"""
628
class BzrBadParameter(BzrNewError):
629
"""A bad parameter : %(param)s is not usable.
631
This exception should never be thrown, but it is a base class for all
632
parameter-to-function errors.
1545
634
def __init__(self, param):
1546
BzrError.__init__(self)
635
BzrNewError.__init__(self)
1547
636
self.param = param
1550
639
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)
640
"""Parameter %(param)s is neither unicode nor utf8."""
643
class ReusingTransform(BzrNewError):
644
"""Attempt to reuse a transform that has already been applied."""
647
class CantMoveRoot(BzrNewError):
648
"""Moving the root directory is not supported at this time"""
1621
651
class BzrBadParameterNotString(BzrBadParameter):
1623
_fmt = "Parameter %(param)s is not a string or unicode string."
652
"""Parameter %(param)s is not a string or unicode string."""
1626
655
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."
656
"""Parameter $(param)s is required but not present."""
659
class DependencyNotPresent(BzrNewError):
660
"""Unable to import library: %(library)s, %(error)s"""
662
def __init__(self, library, error):
663
BzrNewError.__init__(self, library=library, error=error)
1642
666
class ParamikoNotPresent(DependencyNotPresent):
1644
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
667
"""Unable to import paramiko (required for sftp support): %(error)s"""
1646
669
def __init__(self, error):
1647
670
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"
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])
673
class UninitializableFormat(BzrNewError):
674
"""Format %(format)s cannot be initialised by this version of bzr."""
676
def __init__(self, format):
677
BzrNewError.__init__(self)
681
class NoDiff3(BzrNewError):
682
"""Diff3 is not installed on this machine."""
685
class ExistingLimbo(BzrNewError):
686
"""This tree contains left-over files from a failed operation.
687
Please examine %(limbo_dir)s to see if it contains any files you wish to
688
keep, and delete it when you are done.
690
def __init__(self, limbo_dir):
691
BzrNewError.__init__(self)
692
self.limbo_dir = limbo_dir
695
class ImmortalLimbo(BzrNewError):
696
"""Unable to delete transform temporary directory $(limbo_dir)s.
697
Please examine %(limbo_dir)s to see if it contains any files you wish to
698
keep, and delete it when you are done.
700
def __init__(self, limbo_dir):
701
BzrNewError.__init__(self)
702
self.limbo_dir = limbo_dir
705
class OutOfDateTree(BzrNewError):
706
"""Working tree is out of date, please run 'bzr update'."""
708
def __init__(self, tree):
709
BzrNewError.__init__(self)
added
removed
bzrlib/errors.py
