65
39
# constructed to make sure it will succeed. But that says nothing about
66
40
# exceptions that are never raised.
68
# TODO: Convert all the other error classes here to BzrNewError, and eliminate
42
# TODO: selftest assertRaises should probably also check that every error
43
# raised can be formatted as a string successfully, and without giving
72
47
class BzrError(StandardError):
49
Base class for errors raised by bzrlib.
51
:cvar internal_error: if true (or absent) this was probably caused by a
52
bzr bug and should be displayed with a traceback; if False this was
53
probably a user or environment error and they don't need the gory details.
54
(That can be overridden by -Derror on the command line.)
56
:cvar _fmt: Format string to display the error; this is expanded
57
by the instance's dict.
60
internal_error = False
62
def __init__(self, msg=None, **kwds):
63
"""Construct a new BzrError.
65
There are two alternative forms for constructing these objects.
66
Either a preformatted string may be passed, or a set of named
67
arguments can be given. The first is for generic "user" errors which
68
are not intended to be caught and so do not need a specific subclass.
69
The second case is for use with subclasses that provide a _fmt format
70
string to print the arguments.
72
Keyword arguments are taken as parameters to the error, which can
73
be inserted into the format string template. It's recommended
74
that subclasses override the __init__ method to require specific
77
:param msg: If given, this is the literal complete text for the error,
78
not subject to expansion.
80
StandardError.__init__(self)
82
# I was going to deprecate this, but it actually turns out to be
83
# quite handy - mbp 20061103.
84
self._preformatted_string = msg
86
self._preformatted_string = None
87
for key, value in kwds.items():
88
setattr(self, key, value)
74
# XXX: Should we show the exception class in
75
# exceptions that don't provide their own message?
76
# maybe it should be done at a higher level
77
## n = self.__class__.__name__ + ': '
79
if len(self.args) == 1:
80
return str(self.args[0])
81
elif len(self.args) == 2:
82
# further explanation or suggestions
84
return n + '\n '.join([self.args[0]] + self.args[1])
86
return n + "%r" % self
88
return n + `self.args`
91
s = getattr(self, '_preformatted_string', None)
93
# contains a preformatted message; must be cast to plain str
96
fmt = self._get_format_string()
98
s = fmt % self.__dict__
99
# __str__() should always return a 'str' object
100
# never a 'unicode' object.
101
if isinstance(s, unicode):
102
return s.encode('utf8')
104
except (AttributeError, TypeError, NameError, ValueError, KeyError), e:
105
return 'Unprintable exception %s: dict=%r, fmt=%r, error=%s' \
106
% (self.__class__.__name__,
108
getattr(self, '_fmt', None),
111
def _get_format_string(self):
112
"""Return format string for this exception or None"""
113
fmt = getattr(self, '_fmt', None)
116
fmt = getattr(self, '__doc__', None)
118
symbol_versioning.warn("%s uses its docstring as a format, "
119
"it should use _fmt instead" % self.__class__.__name__,
122
return 'Unprintable exception %s: dict=%r, fmt=%r' \
123
% (self.__class__.__name__,
125
getattr(self, '_fmt', None),
91
129
class BzrNewError(BzrError):
130
"""Deprecated error base class."""
93
131
# base classes should override the docstring with their human-
94
132
# readable explanation
96
def __init__(self, **kwds):
134
def __init__(self, *args, **kwds):
135
# XXX: Use the underlying BzrError to always generate the args
136
# attribute if it doesn't exist. We can't use super here, because
137
# exceptions are old-style classes in python2.4 (but new in 2.5).
139
symbol_versioning.warn('BzrNewError was deprecated in bzr 0.13; '
140
'please convert %s to use BzrError instead'
141
% self.__class__.__name__,
144
BzrError.__init__(self, *args)
97
145
for key, value in kwds.items():
98
146
setattr(self, key, value)
100
148
def __str__(self):
102
return self.__doc__ % self.__dict__
103
except (NameError, ValueError, KeyError), e:
104
return 'Unprintable exception %s: %s' \
105
% (self.__class__.__name__, str(e))
108
class BzrCheckError(BzrNewError):
109
"""Internal check failed: %(message)s"""
150
# __str__() should always return a 'str' object
151
# never a 'unicode' object.
152
s = self.__doc__ % self.__dict__
153
if isinstance(s, unicode):
154
return s.encode('utf8')
156
except (TypeError, NameError, ValueError, KeyError), e:
157
return 'Unprintable exception %s(%r): %s' \
158
% (self.__class__.__name__,
159
self.__dict__, str(e))
162
class AlreadyBuilding(BzrError):
164
_fmt = "The tree builder is already building a tree."
167
class BzrCheckError(BzrError):
169
_fmt = "Internal check failed: %(message)s"
171
internal_error = True
111
173
def __init__(self, message):
112
BzrNewError.__init__(self)
174
BzrError.__init__(self)
113
175
self.message = message
116
class InvalidEntryName(BzrNewError):
117
"""Invalid entry name: %(name)s"""
178
class InvalidEntryName(BzrError):
180
_fmt = "Invalid entry name: %(name)s"
182
internal_error = True
118
184
def __init__(self, name):
119
BzrNewError.__init__(self)
185
BzrError.__init__(self)
123
class InvalidRevisionNumber(BzrNewError):
124
"""Invalid revision number %(revno)d"""
189
class InvalidRevisionNumber(BzrError):
191
_fmt = "Invalid revision number %(revno)s"
125
193
def __init__(self, revno):
126
BzrNewError.__init__(self)
194
BzrError.__init__(self)
127
195
self.revno = revno
130
class InvalidRevisionId(BzrNewError):
131
"""Invalid revision-id {%(revision_id)s} in %(branch)s"""
198
class InvalidRevisionId(BzrError):
200
_fmt = "Invalid revision-id {%(revision_id)s} in %(branch)s"
132
202
def __init__(self, revision_id, branch):
133
BzrNewError.__init__(self)
203
# branch can be any string or object with __str__ defined
204
BzrError.__init__(self)
134
205
self.revision_id = revision_id
135
206
self.branch = branch
138
class NoWorkingTree(BzrNewError):
139
"""No WorkingTree exists for %s(base)."""
208
class ReservedId(BzrError):
210
_fmt = "Reserved revision-id {%(revision_id)s}"
212
def __init__(self, revision_id):
213
self.revision_id = revision_id
215
class NoSuchId(BzrError):
217
_fmt = "The file id %(file_id)s is not present in the tree %(tree)s."
219
def __init__(self, tree, file_id):
220
BzrError.__init__(self)
221
self.file_id = file_id
225
class InventoryModified(BzrError):
227
_fmt = ("The current inventory for the tree %(tree)r has been modified,"
228
" so a clean inventory cannot be read without data loss.")
230
internal_error = True
232
def __init__(self, tree):
236
class NoWorkingTree(BzrError):
238
_fmt = "No WorkingTree exists for %(base)s."
141
240
def __init__(self, base):
142
BzrNewError.__init__(self)
241
BzrError.__init__(self)
146
class NotLocalUrl(BzrNewError):
147
"""%s(url) is not a local path."""
245
class NotBuilding(BzrError):
247
_fmt = "Not currently building a tree."
250
class NotLocalUrl(BzrError):
252
_fmt = "%(url)s is not a local path."
149
254
def __init__(self, url):
150
BzrNewError.__init__(self)
258
class WorkingTreeAlreadyPopulated(BzrError):
260
_fmt = """Working tree already populated in %(base)s"""
262
internal_error = True
264
def __init__(self, base):
154
267
class BzrCommandError(BzrError):
155
# Error from malformed user command
156
# This is being misused as a generic exception
157
# pleae subclass. RBC 20051030
268
"""Error from user command"""
270
internal_error = False
272
# Error from malformed user command; please avoid raising this as a
273
# generic exception not caused by user input.
159
275
# I think it's a waste of effort to differentiate between errors that
160
276
# are not intended to be caught anyway. UI code need not subclass
161
277
# BzrCommandError, and non-UI code should not throw a subclass of
162
278
# BzrCommandError. ADHB 20051211
279
def __init__(self, msg):
280
# Object.__str__() must return a real string
281
# returning a Unicode string is a python error.
282
if isinstance(msg, unicode):
283
self.msg = msg.encode('utf8')
163
287
def __str__(self):
291
class NotWriteLocked(BzrError):
293
_fmt = """%(not_locked)r is not write locked but needs to be."""
295
def __init__(self, not_locked):
296
self.not_locked = not_locked
167
299
class BzrOptionError(BzrCommandError):
168
"""Some missing or otherwise incorrect option was supplied."""
171
class StrictCommitFailed(Exception):
172
"""Commit refused because there are unknowns in the tree."""
175
class PathError(BzrNewError):
176
"""Generic path error: %(path)r%(extra)s)"""
301
_fmt = "Error in command line options"
304
class BadOptionValue(BzrError):
306
_fmt = """Bad value "%(value)s" for option "%(name)s"."""
308
def __init__(self, name, value):
309
BzrError.__init__(self, name=name, value=value)
312
class StrictCommitFailed(BzrError):
314
_fmt = "Commit refused because there are unknown files in the tree"
317
# XXX: Should be unified with TransportError; they seem to represent the
319
class PathError(BzrError):
321
_fmt = "Generic path error: %(path)r%(extra)s)"
178
323
def __init__(self, path, extra=None):
179
BzrNewError.__init__(self)
324
BzrError.__init__(self)
182
327
self.extra = ': ' + str(extra)
457
class InvalidNormalization(PathError):
459
_fmt = "Path %(path)r is not unicode normalized"
462
# TODO: This is given a URL; we try to unescape it but doing that from inside
463
# the exception object is a bit undesirable.
464
# TODO: Probably this behavior of should be a common superclass
219
465
class NotBranchError(PathError):
220
"""Not a branch: %(path)s"""
467
_fmt = "Not a branch: %(path)s"
469
def __init__(self, path):
470
import bzrlib.urlutils as urlutils
471
self.path = urlutils.unescape_for_display(path, 'ascii')
223
474
class AlreadyBranchError(PathError):
224
"""Already a branch: %(path)s. Use `bzr checkout` to build a working tree."""
227
class NoRepositoryPresent(BzrNewError):
228
"""Not repository present: %(path)r"""
476
_fmt = "Already a branch: %(path)s."
479
class BranchExistsWithoutWorkingTree(PathError):
481
_fmt = "Directory contains a branch, but no working tree \
482
(use bzr checkout if you wish to build a working tree): %(path)s"
485
class AtomicFileAlreadyClosed(PathError):
487
_fmt = ("'%(function)s' called on an AtomicFile after it was closed:"
490
def __init__(self, path, function):
491
PathError.__init__(self, path=path, extra=None)
492
self.function = function
495
class InaccessibleParent(PathError):
497
_fmt = ("Parent not accessible given base %(base)s and"
498
" relative path %(path)s")
500
def __init__(self, path, base):
501
PathError.__init__(self, path)
505
class NoRepositoryPresent(BzrError):
507
_fmt = "No repository present: %(path)r"
229
508
def __init__(self, bzrdir):
230
BzrNewError.__init__(self)
509
BzrError.__init__(self)
231
510
self.path = bzrdir.transport.clone('..').base
234
class FileInWrongBranch(BzrNewError):
235
"""File %(path)s in not in branch %(branch_base)s."""
513
class FileInWrongBranch(BzrError):
515
_fmt = "File %(path)s in not in branch %(branch_base)s."
237
517
def __init__(self, branch, path):
238
BzrNewError.__init__(self)
518
BzrError.__init__(self)
239
519
self.branch = branch
240
520
self.branch_base = branch.base
244
524
class UnsupportedFormatError(BzrError):
245
"""Specified path is a bzr branch that we recognize but cannot read."""
247
return 'unsupported branch format: %s' % self.args[0]
526
_fmt = "Unsupported branch format: %(format)s"
250
529
class UnknownFormatError(BzrError):
251
"""Specified path is a bzr branch whose format we do not recognize."""
253
return 'unknown branch format: %s' % self.args[0]
256
class IncompatibleFormat(BzrNewError):
257
"""Format %(format)s is not compatible with .bzr version %(bzrdir)s."""
531
_fmt = "Unknown branch format: %(format)r"
534
class IncompatibleFormat(BzrError):
536
_fmt = "Format %(format)s is not compatible with .bzr version %(bzrdir)s."
259
538
def __init__(self, format, bzrdir_format):
260
BzrNewError.__init__(self)
539
BzrError.__init__(self)
261
540
self.format = format
262
541
self.bzrdir = bzrdir_format
265
class NotVersionedError(BzrNewError):
266
"""%(path)s is not versioned"""
267
def __init__(self, path):
268
BzrNewError.__init__(self)
272
class PathsNotVersionedError(BzrNewError):
273
# used when reporting several paths are not versioned
274
"""Path(s) are not versioned: %(paths_as_string)s"""
544
class IncompatibleRevision(BzrError):
546
_fmt = "Revision is not compatible with %(repo_format)s"
548
def __init__(self, repo_format):
549
BzrError.__init__(self)
550
self.repo_format = repo_format
553
class AlreadyVersionedError(BzrError):
554
"""Used when a path is expected not to be versioned, but it is."""
556
_fmt = "%(context_info)s%(path)s is already versioned"
558
def __init__(self, path, context_info=None):
559
"""Construct a new AlreadyVersionedError.
561
:param path: This is the path which is versioned,
562
which should be in a user friendly form.
563
:param context_info: If given, this is information about the context,
564
which could explain why this is expected to not be versioned.
566
BzrError.__init__(self)
568
if context_info is None:
569
self.context_info = ''
571
self.context_info = context_info + ". "
574
class NotVersionedError(BzrError):
575
"""Used when a path is expected to be versioned, but it is not."""
577
_fmt = "%(context_info)s%(path)s is not versioned"
579
def __init__(self, path, context_info=None):
580
"""Construct a new NotVersionedError.
582
:param path: This is the path which is not versioned,
583
which should be in a user friendly form.
584
:param context_info: If given, this is information about the context,
585
which could explain why this is expected to be versioned.
587
BzrError.__init__(self)
589
if context_info is None:
590
self.context_info = ''
592
self.context_info = context_info + ". "
595
class PathsNotVersionedError(BzrError):
596
"""Used when reporting several paths which are not versioned"""
598
_fmt = "Path(s) are not versioned: %(paths_as_string)s"
276
600
def __init__(self, paths):
277
601
from bzrlib.osutils import quotefn
278
BzrNewError.__init__(self)
280
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
602
BzrError.__init__(self)
604
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
607
class PathsDoNotExist(BzrError):
609
_fmt = "Path(s) do not exist: %(paths_as_string)s%(extra)s"
611
# used when reporting that paths are neither versioned nor in the working
614
def __init__(self, paths, extra=None):
616
from bzrlib.osutils import quotefn
617
BzrError.__init__(self)
619
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
621
self.extra = ': ' + str(extra)
283
626
class BadFileKindError(BzrError):
284
"""Specified file is of a kind that cannot be added.
286
(For example a symlink or device file.)"""
289
class ForbiddenFileError(BzrError):
290
"""Cannot operate on a file because it is a control file."""
293
class LockError(BzrNewError):
294
"""Lock error: %(message)s"""
628
_fmt = 'Cannot operate on "%(filename)s" of unsupported kind "%(kind)s"'
630
def __init__(self, filename, kind):
631
BzrError.__init__(self, filename=filename, kind=kind)
634
class ForbiddenControlFileError(BzrError):
636
_fmt = "Cannot operate on %(filename)s because it is a control file"
639
class LockError(BzrError):
641
_fmt = "Lock error: %(message)s"
643
internal_error = True
295
645
# All exceptions from the lock/unlock functions should be from
296
646
# this exception class. They will be translated as necessary. The
297
647
# original exception is available as e.original_error
368
760
class LockNotHeld(LockError):
369
"""Lock not held: %(lock)s"""
762
_fmt = "Lock not held: %(lock)s"
764
internal_error = False
370
766
def __init__(self, lock):
374
class PointlessCommit(BzrNewError):
375
"""No changes to commit"""
378
class UpgradeReadonly(BzrNewError):
379
"""Upgrade URL cannot work with readonly URL's."""
382
class UpToDateFormat(BzrNewError):
383
"""The branch format %(format)s is already at the most recent format."""
770
class PointlessCommit(BzrError):
772
_fmt = "No changes to commit"
775
class UpgradeReadonly(BzrError):
777
_fmt = "Upgrade URL cannot work with readonly URLs."
780
class UpToDateFormat(BzrError):
782
_fmt = "The branch format %(format)s is already at the most recent format."
385
784
def __init__(self, format):
386
BzrNewError.__init__(self)
785
BzrError.__init__(self)
387
786
self.format = format
391
789
class StrictCommitFailed(Exception):
392
"""Commit refused because there are unknowns in the tree."""
791
_fmt = "Commit refused because there are unknowns in the tree."
395
794
class NoSuchRevision(BzrError):
796
_fmt = "Branch %(branch)s has no revision %(revision)s"
798
internal_error = True
396
800
def __init__(self, branch, revision):
398
self.revision = revision
399
msg = "Branch %s has no revision %s" % (branch, revision)
400
BzrError.__init__(self, msg)
801
BzrError.__init__(self, branch=branch, revision=revision)
804
class NotLeftParentDescendant(BzrError):
806
_fmt = ("Revision %(old_revision)s is not the left parent of"
807
" %(new_revision)s, but branch %(branch_location)s expects this")
809
internal_error = True
811
def __init__(self, branch, old_revision, new_revision):
812
BzrError.__init__(self, branch_location=branch.base,
813
old_revision=old_revision,
814
new_revision=new_revision)
817
class NoSuchRevisionSpec(BzrError):
819
_fmt = "No namespace registered for string: %(spec)r"
821
def __init__(self, spec):
822
BzrError.__init__(self, spec=spec)
825
class NoSuchRevisionInTree(NoSuchRevision):
826
"""When using Tree.revision_tree, and the revision is not accessible."""
828
_fmt = "The revision id %(revision_id)s is not present in the tree %(tree)s."
830
def __init__(self, tree, revision_id):
831
BzrError.__init__(self)
833
self.revision_id = revision_id
836
class InvalidRevisionSpec(BzrError):
838
_fmt = ("Requested revision: %(spec)r does not exist in branch:"
839
" %(branch)s%(extra)s")
841
def __init__(self, spec, branch, extra=None):
842
BzrError.__init__(self, branch=branch, spec=spec)
844
self.extra = '\n' + str(extra)
403
849
class HistoryMissing(BzrError):
404
def __init__(self, branch, object_type, object_id):
406
BzrError.__init__(self,
407
'%s is missing %s {%s}'
408
% (branch, object_type, object_id))
851
_fmt = "%(branch)s is missing %(object_type)s {%(object_id)s}"
854
class AppendRevisionsOnlyViolation(BzrError):
856
_fmt = ('Operation denied because it would change the main history,'
857
' which is not permitted by the append_revisions_only setting on'
858
' branch "%(location)s".')
860
def __init__(self, location):
861
import bzrlib.urlutils as urlutils
862
location = urlutils.unescape_for_display(location, 'ascii')
863
BzrError.__init__(self, location=location)
411
866
class DivergedBranches(BzrError):
868
_fmt = ("These branches have diverged."
869
" Use the merge command to reconcile them.")
871
internal_error = False
413
873
def __init__(self, branch1, branch2):
414
BzrError.__init__(self, "These branches have diverged. Try merge.")
415
874
self.branch1 = branch1
416
875
self.branch2 = branch2
419
class UnrelatedBranches(BzrCommandError):
421
msg = "Branches have no common ancestor, and no base revision"\
423
BzrCommandError.__init__(self, msg)
878
class NotLefthandHistory(BzrError):
880
_fmt = "Supplied history does not follow left-hand parents"
882
internal_error = True
884
def __init__(self, history):
885
BzrError.__init__(self, history=history)
888
class UnrelatedBranches(BzrError):
890
_fmt = ("Branches have no common ancestor, and"
891
" no merge base revision was specified.")
893
internal_error = False
426
896
class NoCommonAncestor(BzrError):
898
_fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
427
900
def __init__(self, revision_a, revision_b):
428
msg = "Revisions have no common ancestor: %s %s." \
429
% (revision_a, revision_b)
430
BzrError.__init__(self, msg)
901
self.revision_a = revision_a
902
self.revision_b = revision_b
433
905
class NoCommonRoot(BzrError):
907
_fmt = ("Revisions are not derived from the same root: "
908
"%(revision_a)s %(revision_b)s.")
434
910
def __init__(self, revision_a, revision_b):
435
msg = "Revisions are not derived from the same root: %s %s." \
436
% (revision_a, revision_b)
437
BzrError.__init__(self, msg)
911
BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
441
914
class NotAncestor(BzrError):
916
_fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
442
918
def __init__(self, rev_id, not_ancestor_id):
443
msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id,
445
BzrError.__init__(self, msg)
447
self.not_ancestor_id = not_ancestor_id
919
BzrError.__init__(self, rev_id=rev_id,
920
not_ancestor_id=not_ancestor_id)
450
923
class InstallFailed(BzrError):
451
925
def __init__(self, revisions):
452
msg = "Could not install revisions:\n%s" % " ,".join(revisions)
926
revision_str = ", ".join(str(r) for r in revisions)
927
msg = "Could not install revisions:\n%s" % revision_str
453
928
BzrError.__init__(self, msg)
454
929
self.revisions = revisions
457
932
class AmbiguousBase(BzrError):
458
934
def __init__(self, bases):
459
935
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
460
936
DeprecationWarning)
461
msg = "The correct base is unclear, becase %s are all equally close" %\
937
msg = ("The correct base is unclear, because %s are all equally close"
463
939
BzrError.__init__(self, msg)
464
940
self.bases = bases
467
943
class NoCommits(BzrError):
945
_fmt = "Branch %(branch)s has no commits."
468
947
def __init__(self, branch):
469
msg = "Branch %s has no commits." % branch
470
BzrError.__init__(self, msg)
948
BzrError.__init__(self, branch=branch)
473
951
class UnlistableStore(BzrError):
474
953
def __init__(self, store):
475
954
BzrError.__init__(self, "Store %s is not listable" % store)
479
958
class UnlistableBranch(BzrError):
480
960
def __init__(self, br):
481
961
BzrError.__init__(self, "Stores for branch %s are not listable" % br)
484
class BoundBranchOutOfDate(BzrNewError):
485
"""Bound branch %(branch)s is out of date with master branch %(master)s."""
964
class BoundBranchOutOfDate(BzrError):
966
_fmt = ("Bound branch %(branch)s is out of date"
967
" with master branch %(master)s.")
486
969
def __init__(self, branch, master):
487
BzrNewError.__init__(self)
970
BzrError.__init__(self)
488
971
self.branch = branch
489
972
self.master = master
492
class CommitToDoubleBoundBranch(BzrNewError):
493
"""Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."""
975
class CommitToDoubleBoundBranch(BzrError):
977
_fmt = ("Cannot commit to branch %(branch)s."
978
" It is bound to %(master)s, which is bound to %(remote)s.")
494
980
def __init__(self, branch, master, remote):
495
BzrNewError.__init__(self)
981
BzrError.__init__(self)
496
982
self.branch = branch
497
983
self.master = master
498
984
self.remote = remote
501
class OverwriteBoundBranch(BzrNewError):
502
"""Cannot pull --overwrite to a branch which is bound %(branch)s"""
987
class OverwriteBoundBranch(BzrError):
989
_fmt = "Cannot pull --overwrite to a branch which is bound %(branch)s"
503
991
def __init__(self, branch):
504
BzrNewError.__init__(self)
992
BzrError.__init__(self)
505
993
self.branch = branch
508
class BoundBranchConnectionFailure(BzrNewError):
509
"""Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"""
996
class BoundBranchConnectionFailure(BzrError):
998
_fmt = ("Unable to connect to target of bound branch %(branch)s"
999
" => %(target)s: %(error)s")
510
1001
def __init__(self, branch, target, error):
511
BzrNewError.__init__(self)
1002
BzrError.__init__(self)
512
1003
self.branch = branch
513
1004
self.target = target
514
1005
self.error = error
517
class WeaveError(BzrNewError):
518
"""Error in processing weave: %(message)s"""
1008
class WeaveError(BzrError):
1010
_fmt = "Error in processing weave: %(message)s"
520
1012
def __init__(self, message=None):
521
BzrNewError.__init__(self)
1013
BzrError.__init__(self)
522
1014
self.message = message
525
1017
class WeaveRevisionAlreadyPresent(WeaveError):
526
"""Revision {%(revision_id)s} already present in %(weave)s"""
1019
_fmt = "Revision {%(revision_id)s} already present in %(weave)s"
527
1021
def __init__(self, revision_id, weave):
529
1023
WeaveError.__init__(self)
622
class NoSuchExportFormat(BzrNewError):
623
"""Export format %(format)r not supported"""
1133
class KnitIndexUnknownMethod(KnitError):
1134
"""Raised when we don't understand the storage method.
1136
Currently only 'fulltext' and 'line-delta' are supported.
1139
_fmt = ("Knit index %(filename)s does not have a known method"
1140
" in options: %(options)r")
1142
def __init__(self, filename, options):
1143
KnitError.__init__(self)
1144
self.filename = filename
1145
self.options = options
1148
class NoSuchExportFormat(BzrError):
1150
_fmt = "Export format %(format)r not supported"
624
1152
def __init__(self, format):
625
BzrNewError.__init__(self)
1153
BzrError.__init__(self)
626
1154
self.format = format
629
1157
class TransportError(BzrError):
630
"""All errors thrown by Transport implementations should derive
1159
_fmt = "Transport error: %(msg)s %(orig_error)s"
633
1161
def __init__(self, msg=None, orig_error=None):
634
1162
if msg is None and orig_error is not None:
635
1163
msg = str(orig_error)
636
BzrError.__init__(self, msg)
1164
if orig_error is None:
638
1169
self.orig_error = orig_error
1170
BzrError.__init__(self)
1173
class TooManyConcurrentRequests(BzrError):
1175
_fmt = ("The medium '%(medium)s' has reached its concurrent request limit."
1176
" Be sure to finish_writing and finish_reading on the"
1177
" current request that is open.")
1179
internal_error = True
1181
def __init__(self, medium):
1182
self.medium = medium
1185
class SmartProtocolError(TransportError):
1187
_fmt = "Generic bzr smart protocol error: %(details)s"
1189
def __init__(self, details):
1190
self.details = details
641
1193
# A set of semi-meaningful errors which can be thrown
642
1194
class TransportNotPossible(TransportError):
643
"""This is for transports where a specific function is explicitly not
644
possible. Such as pushing files to an HTTP server.
1196
_fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
649
1199
class ConnectionError(TransportError):
650
"""A connection problem prevents file retrieval.
651
This does not indicate whether the file exists or not; it indicates that a
652
precondition for requesting the file was not met.
654
def __init__(self, msg=None, orig_error=None):
655
TransportError.__init__(self, msg=msg, orig_error=orig_error)
1201
_fmt = "Connection error: %(msg)s %(orig_error)s"
1204
class SocketConnectionError(ConnectionError):
1206
_fmt = "%(msg)s %(host)s%(port)s%(orig_error)s"
1208
def __init__(self, host, port=None, msg=None, orig_error=None):
1210
msg = 'Failed to connect to'
1211
if orig_error is None:
1214
orig_error = '; ' + str(orig_error)
1215
ConnectionError.__init__(self, msg=msg, orig_error=orig_error)
1220
self.port = ':%s' % port
658
1223
class ConnectionReset(TransportError):
659
"""The connection has been closed."""
1225
_fmt = "Connection closed: %(msg)s %(orig_error)s"
1228
class InvalidRange(TransportError):
1230
_fmt = "Invalid range access in %(path)s at %(offset)s."
1232
def __init__(self, path, offset):
1233
TransportError.__init__(self, ("Invalid range access in %s at %d"
1236
self.offset = offset
1239
class InvalidHttpResponse(TransportError):
1241
_fmt = "Invalid http response for %(path)s: %(msg)s"
1243
def __init__(self, path, msg, orig_error=None):
1245
TransportError.__init__(self, msg, orig_error=orig_error)
1248
class InvalidHttpRange(InvalidHttpResponse):
1250
_fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
1252
def __init__(self, path, range, msg):
1254
InvalidHttpResponse.__init__(self, path, msg)
1257
class InvalidHttpContentType(InvalidHttpResponse):
1259
_fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1261
def __init__(self, path, ctype, msg):
1263
InvalidHttpResponse.__init__(self, path, msg)
663
1266
class ConflictsInTree(BzrError):
665
BzrError.__init__(self, "Working tree has conflicts.")
1268
_fmt = "Working tree has conflicts."
668
1271
class ParseConfigError(BzrError):
669
1273
def __init__(self, errors, filename):
670
1274
if filename is None:
674
1278
BzrError.__init__(self, message)
1281
class NoEmailInUsername(BzrError):
1283
_fmt = "%(username)r does not seem to contain a reasonable email address"
1285
def __init__(self, username):
1286
BzrError.__init__(self)
1287
self.username = username
677
1290
class SigningFailed(BzrError):
1292
_fmt = "Failed to gpg sign data with command %(command_line)r"
678
1294
def __init__(self, command_line):
679
BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
1295
BzrError.__init__(self, command_line=command_line)
683
1298
class WorkingTreeNotRevision(BzrError):
1300
_fmt = ("The working tree for %(basedir)s has changed since"
1301
" the last commit, but weave merge requires that it be"
684
1304
def __init__(self, tree):
685
BzrError.__init__(self, "The working tree for %s has changed since"
686
" last commit, but weave merge requires that it be"
687
" unchanged." % tree.basedir)
690
class CantReprocessAndShowBase(BzrNewError):
691
"""Can't reprocess and show base.
692
Reprocessing obscures relationship of conflicting lines to base."""
695
class GraphCycleError(BzrNewError):
696
"""Cycle in graph %(graph)r"""
1305
BzrError.__init__(self, basedir=tree.basedir)
1308
class CantReprocessAndShowBase(BzrError):
1310
_fmt = ("Can't reprocess and show base, because reprocessing obscures "
1311
"the relationship of conflicting lines to the base")
1314
class GraphCycleError(BzrError):
1316
_fmt = "Cycle in graph %(graph)r"
697
1318
def __init__(self, graph):
698
BzrNewError.__init__(self)
1319
BzrError.__init__(self)
699
1320
self.graph = graph
702
class NotConflicted(BzrNewError):
703
"""File %(filename)s is not conflicted."""
1323
class WritingCompleted(BzrError):
1325
_fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
1326
"called upon it - accept bytes may not be called anymore.")
1328
internal_error = True
1330
def __init__(self, request):
1331
self.request = request
1334
class WritingNotComplete(BzrError):
1336
_fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
1337
"called upon it - until the write phase is complete no "
1338
"data may be read.")
1340
internal_error = True
1342
def __init__(self, request):
1343
self.request = request
1346
class NotConflicted(BzrError):
1348
_fmt = "File %(filename)s is not conflicted."
705
1350
def __init__(self, filename):
706
BzrNewError.__init__(self)
1351
BzrError.__init__(self)
707
1352
self.filename = filename
1355
class MediumNotConnected(BzrError):
1357
_fmt = """The medium '%(medium)s' is not connected."""
1359
internal_error = True
1361
def __init__(self, medium):
1362
self.medium = medium
710
1365
class MustUseDecorated(Exception):
711
"""A decorating function has requested its original command be used.
713
This should never escape bzr, so does not need to be printable.
717
class MissingText(BzrNewError):
718
"""Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"""
1367
_fmt = "A decorating function has requested its original command be used."
1370
class NoBundleFound(BzrError):
1372
_fmt = "No bundle was found in %(filename)s"
1374
def __init__(self, filename):
1375
BzrError.__init__(self)
1376
self.filename = filename
1379
class BundleNotSupported(BzrError):
1381
_fmt = "Unable to handle bundle version %(version)s: %(msg)s"
1383
def __init__(self, version, msg):
1384
BzrError.__init__(self)
1385
self.version = version
1389
class MissingText(BzrError):
1391
_fmt = ("Branch %(base)s is missing revision"
1392
" %(text_revision)s of %(file_id)s")
720
1394
def __init__(self, branch, text_revision, file_id):
721
BzrNewError.__init__(self)
1395
BzrError.__init__(self)
722
1396
self.branch = branch
723
1397
self.base = branch.base
724
1398
self.text_revision = text_revision
725
1399
self.file_id = file_id
728
class DuplicateKey(BzrNewError):
729
"""Key %(key)s is already present in map"""
732
class MalformedTransform(BzrNewError):
733
"""Tree transform is malformed %(conflicts)r"""
736
class BzrBadParameter(BzrNewError):
737
"""A bad parameter : %(param)s is not usable.
739
This exception should never be thrown, but it is a base class for all
740
parameter-to-function errors.
1402
class DuplicateFileId(BzrError):
1404
_fmt = "File id {%(file_id)s} already exists in inventory as %(entry)s"
1406
def __init__(self, file_id, entry):
1407
BzrError.__init__(self)
1408
self.file_id = file_id
1412
class DuplicateKey(BzrError):
1414
_fmt = "Key %(key)s is already present in map"
1417
class MalformedTransform(BzrError):
1419
_fmt = "Tree transform is malformed %(conflicts)r"
1422
class NoFinalPath(BzrError):
1424
_fmt = ("No final name for trans_id %(trans_id)r\n"
1425
"file-id: %(file_id)r\n"
1426
"root trans-id: %(root_trans_id)r\n")
1428
def __init__(self, trans_id, transform):
1429
self.trans_id = trans_id
1430
self.file_id = transform.final_file_id(trans_id)
1431
self.root_trans_id = transform.root
1434
class BzrBadParameter(BzrError):
1436
_fmt = "Bad parameter: %(param)r"
1438
# This exception should never be thrown, but it is a base class for all
1439
# parameter-to-function errors.
742
1441
def __init__(self, param):
743
BzrNewError.__init__(self)
1442
BzrError.__init__(self)
744
1443
self.param = param
747
1446
class BzrBadParameterNotUnicode(BzrBadParameter):
748
"""Parameter %(param)s is neither unicode nor utf8."""
751
class ReusingTransform(BzrNewError):
752
"""Attempt to reuse a transform that has already been applied."""
755
class CantMoveRoot(BzrNewError):
756
"""Moving the root directory is not supported at this time"""
1448
_fmt = "Parameter %(param)s is neither unicode nor utf8."
1451
class ReusingTransform(BzrError):
1453
_fmt = "Attempt to reuse a transform that has already been applied."
1456
class CantMoveRoot(BzrError):
1458
_fmt = "Moving the root directory is not supported at this time"
1461
class BzrMoveFailedError(BzrError):
1463
_fmt = "Could not move %(from_path)s%(operator)s %(to_path)s%(extra)s"
1465
def __init__(self, from_path='', to_path='', extra=None):
1466
BzrError.__init__(self)
1468
self.extra = ': ' + str(extra)
1472
has_from = len(from_path) > 0
1473
has_to = len(to_path) > 0
1475
self.from_path = osutils.splitpath(from_path)[-1]
1480
self.to_path = osutils.splitpath(to_path)[-1]
1485
if has_from and has_to:
1486
self.operator = " =>"
1488
self.from_path = "from " + from_path
1490
self.operator = "to"
1492
self.operator = "file"
1495
class BzrRenameFailedError(BzrMoveFailedError):
1497
_fmt = "Could not rename %(from_path)s%(operator)s %(to_path)s%(extra)s"
1499
def __init__(self, from_path, to_path, extra=None):
1500
BzrMoveFailedError.__init__(self, from_path, to_path, extra)
759
1503
class BzrBadParameterNotString(BzrBadParameter):
760
"""Parameter %(param)s is not a string or unicode string."""
1505
_fmt = "Parameter %(param)s is not a string or unicode string."
763
1508
class BzrBadParameterMissing(BzrBadParameter):
764
"""Parameter $(param)s is required but not present."""
767
class DependencyNotPresent(BzrNewError):
768
"""Unable to import library "%(library)s": %(error)s"""
1510
_fmt = "Parameter $(param)s is required but not present."
1513
class BzrBadParameterUnicode(BzrBadParameter):
1515
_fmt = ("Parameter %(param)s is unicode but"
1516
" only byte-strings are permitted.")
1519
class BzrBadParameterContainsNewline(BzrBadParameter):
1521
_fmt = "Parameter %(param)s contains a newline."
1524
class DependencyNotPresent(BzrError):
1526
_fmt = 'Unable to import library "%(library)s": %(error)s'
770
1528
def __init__(self, library, error):
771
BzrNewError.__init__(self, library=library, error=error)
1529
BzrError.__init__(self, library=library, error=error)
774
1532
class ParamikoNotPresent(DependencyNotPresent):
775
"""Unable to import paramiko (required for sftp support): %(error)s"""
1534
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
777
1536
def __init__(self, error):
778
1537
DependencyNotPresent.__init__(self, 'paramiko', error)
781
class UninitializableFormat(BzrNewError):
782
"""Format %(format)s cannot be initialised by this version of bzr."""
1540
class PointlessMerge(BzrError):
1542
_fmt = "Nothing to merge."
1545
class UninitializableFormat(BzrError):
1547
_fmt = "Format %(format)s cannot be initialised by this version of bzr."
784
1549
def __init__(self, format):
785
BzrNewError.__init__(self)
789
class NoDiff3(BzrNewError):
790
"""Diff3 is not installed on this machine."""
793
class ExistingLimbo(BzrNewError):
794
"""This tree contains left-over files from a failed operation.
795
Please examine %(limbo_dir)s to see if it contains any files you wish to
796
keep, and delete it when you are done.
798
def __init__(self, limbo_dir):
799
BzrNewError.__init__(self)
800
self.limbo_dir = limbo_dir
803
class ImmortalLimbo(BzrNewError):
804
"""Unable to delete transform temporary directory $(limbo_dir)s.
805
Please examine %(limbo_dir)s to see if it contains any files you wish to
806
keep, and delete it when you are done.
808
def __init__(self, limbo_dir):
809
BzrNewError.__init__(self)
810
self.limbo_dir = limbo_dir
813
class OutOfDateTree(BzrNewError):
814
"""Working tree is out of date, please run 'bzr update'."""
1550
BzrError.__init__(self)
1551
self.format = format
1554
class BadConversionTarget(BzrError):
1556
_fmt = "Cannot convert to format %(format)s. %(problem)s"
1558
def __init__(self, problem, format):
1559
BzrError.__init__(self)
1560
self.problem = problem
1561
self.format = format
1564
class NoDiff(BzrError):
1566
_fmt = "Diff is not installed on this machine: %(msg)s"
1568
def __init__(self, msg):
1569
BzrError.__init__(self, msg=msg)
1572
class NoDiff3(BzrError):
1574
_fmt = "Diff3 is not installed on this machine."
1577
class ExistingLimbo(BzrError):
1579
_fmt = """This tree contains left-over files from a failed operation.
1580
Please examine %(limbo_dir)s to see if it contains any files you wish to
1581
keep, and delete it when you are done."""
1583
def __init__(self, limbo_dir):
1584
BzrError.__init__(self)
1585
self.limbo_dir = limbo_dir
1588
class ImmortalLimbo(BzrError):
1590
_fmt = """Unable to delete transform temporary directory $(limbo_dir)s.
1591
Please examine %(limbo_dir)s to see if it contains any files you wish to
1592
keep, and delete it when you are done."""
1594
def __init__(self, limbo_dir):
1595
BzrError.__init__(self)
1596
self.limbo_dir = limbo_dir
1599
class OutOfDateTree(BzrError):
1601
_fmt = "Working tree is out of date, please run 'bzr update'."
816
1603
def __init__(self, tree):
817
BzrNewError.__init__(self)
1604
BzrError.__init__(self)
818
1605
self.tree = tree
821
class MergeModifiedFormatError(BzrNewError):
822
"""Error in merge modified format"""
825
class ConflictFormatError(BzrNewError):
826
"""Format error in conflict listings"""
829
class CorruptRepository(BzrNewError):
830
"""An error has been detected in the repository %(repo_path)s.
831
Please run bzr reconcile on this repository."""
1608
class MergeModifiedFormatError(BzrError):
1610
_fmt = "Error in merge modified format"
1613
class ConflictFormatError(BzrError):
1615
_fmt = "Format error in conflict listings"
1618
class CorruptRepository(BzrError):
1620
_fmt = ("An error has been detected in the repository %(repo_path)s.\n"
1621
"Please run bzr reconcile on this repository.")
833
1623
def __init__(self, repo):
834
BzrNewError.__init__(self)
1624
BzrError.__init__(self)
835
1625
self.repo_path = repo.bzrdir.root_transport.base
838
class UpgradeRequired(BzrNewError):
839
"""To use this feature you must upgrade your branch at %(path)s."""
1628
class UpgradeRequired(BzrError):
1630
_fmt = "To use this feature you must upgrade your branch at %(path)s."
841
1632
def __init__(self, path):
842
BzrNewError.__init__(self)
1633
BzrError.__init__(self)
843
1634
self.path = path
846
class LocalRequiresBoundBranch(BzrNewError):
847
"""Cannot perform local-only commits on unbound branches."""
850
class MissingProgressBarFinish(BzrNewError):
851
"""A nested progress bar was not 'finished' correctly."""
854
class UnsupportedOperation(BzrNewError):
855
"""The method %(mname)s is not supported on objects of type %(tname)s."""
1637
class LocalRequiresBoundBranch(BzrError):
1639
_fmt = "Cannot perform local-only commits on unbound branches."
1642
class MissingProgressBarFinish(BzrError):
1644
_fmt = "A nested progress bar was not 'finished' correctly."
1647
class InvalidProgressBarType(BzrError):
1649
_fmt = ("Environment variable BZR_PROGRESS_BAR='%(bar_type)s"
1650
" is not a supported type Select one of: %(valid_types)s")
1652
def __init__(self, bar_type, valid_types):
1653
BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1656
class UnsupportedOperation(BzrError):
1658
_fmt = ("The method %(mname)s is not supported on"
1659
" objects of type %(tname)s.")
856
1661
def __init__(self, method, method_self):
857
1662
self.method = method
858
1663
self.mname = method.__name__
859
1664
self.tname = type(method_self).__name__
1667
class CannotSetRevisionId(UnsupportedOperation):
1668
"""Raised when a commit is attempting to set a revision id but cant."""
1671
class NonAsciiRevisionId(UnsupportedOperation):
1672
"""Raised when a commit is attempting to set a non-ascii revision id
1677
class BinaryFile(BzrError):
1679
_fmt = "File is binary but should be text."
1682
class IllegalPath(BzrError):
1684
_fmt = "The path %(path)s is not permitted on this platform"
1686
def __init__(self, path):
1687
BzrError.__init__(self)
1691
class TestamentMismatch(BzrError):
1693
_fmt = """Testament did not match expected value.
1694
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1697
def __init__(self, revision_id, expected, measured):
1698
self.revision_id = revision_id
1699
self.expected = expected
1700
self.measured = measured
1703
class NotABundle(BzrError):
1705
_fmt = "Not a bzr revision-bundle: %(text)r"
1707
def __init__(self, text):
1708
BzrError.__init__(self)
1712
class BadBundle(BzrError):
1714
_fmt = "Bad bzr revision-bundle: %(text)r"
1716
def __init__(self, text):
1717
BzrError.__init__(self)
1721
class MalformedHeader(BadBundle):
1723
_fmt = "Malformed bzr revision-bundle header: %(text)r"
1726
class MalformedPatches(BadBundle):
1728
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1731
class MalformedFooter(BadBundle):
1733
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1736
class UnsupportedEOLMarker(BadBundle):
1738
_fmt = "End of line marker was not \\n in bzr revision-bundle"
1741
# XXX: BadBundle's constructor assumes there's explanatory text,
1742
# but for this there is not
1743
BzrError.__init__(self)
1746
class IncompatibleBundleFormat(BzrError):
1748
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
1750
def __init__(self, bundle_format, other):
1751
BzrError.__init__(self)
1752
self.bundle_format = bundle_format
1756
class BadInventoryFormat(BzrError):
1758
_fmt = "Root class for inventory serialization errors"
1761
class UnexpectedInventoryFormat(BadInventoryFormat):
1763
_fmt = "The inventory was not in the expected format:\n %(msg)s"
1765
def __init__(self, msg):
1766
BadInventoryFormat.__init__(self, msg=msg)
1769
class RootNotRich(BzrError):
1771
_fmt = """This operation requires rich root data storage"""
1774
class NoSmartMedium(BzrError):
1776
_fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
1778
internal_error = True
1780
def __init__(self, transport):
1781
self.transport = transport
1784
class NoSmartServer(NotBranchError):
1786
_fmt = "No smart server available at %(url)s"
1788
def __init__(self, url):
1792
class UnknownSSH(BzrError):
1794
_fmt = "Unrecognised value for BZR_SSH environment variable: %(vendor)s"
1796
def __init__(self, vendor):
1797
BzrError.__init__(self)
1798
self.vendor = vendor
1801
class SSHVendorNotFound(BzrError):
1803
_fmt = ("Don't know how to handle SSH connections."
1804
" Please set BZR_SSH environment variable.")
1807
class GhostRevisionUnusableHere(BzrError):
1809
_fmt = "Ghost revision {%(revision_id)s} cannot be used here."
1811
def __init__(self, revision_id):
1812
BzrError.__init__(self)
1813
self.revision_id = revision_id
1816
class IllegalUseOfScopeReplacer(BzrError):
1818
_fmt = ("ScopeReplacer object %(name)r was used incorrectly:"
1819
" %(msg)s%(extra)s")
1821
internal_error = True
1823
def __init__(self, name, msg, extra=None):
1824
BzrError.__init__(self)
1828
self.extra = ': ' + str(extra)
1833
class InvalidImportLine(BzrError):
1835
_fmt = "Not a valid import statement: %(msg)\n%(text)s"
1837
internal_error = True
1839
def __init__(self, text, msg):
1840
BzrError.__init__(self)
1845
class ImportNameCollision(BzrError):
1847
_fmt = ("Tried to import an object to the same name as"
1848
" an existing object. %(name)s")
1850
internal_error = True
1852
def __init__(self, name):
1853
BzrError.__init__(self)
1857
class UnsupportedInventoryKind(BzrError):
1859
_fmt = """Unsupported entry kind %(kind)s"""
1861
def __init__(self, kind):
1865
class BadSubsumeSource(BzrError):
1867
_fmt = """Can't subsume %(other_tree)s into %(tree)s. %(reason)s"""
1869
def __init__(self, tree, other_tree, reason):
1871
self.other_tree = other_tree
1872
self.reason = reason
1875
class SubsumeTargetNeedsUpgrade(BzrError):
1877
_fmt = """Subsume target %(other_tree)s needs to be upgraded."""
1879
def __init__(self, other_tree):
1880
self.other_tree = other_tree
1883
class BadReferenceTarget(BzrError):
1885
_fmt = "Can't add reference to %(other_tree)s into %(tree)s. %(reason)s"
1887
internal_error = True
1889
def __init__(self, tree, other_tree, reason):
1891
self.other_tree = other_tree
1892
self.reason = reason
1895
class NoSuchTag(BzrError):
1897
_fmt = "No such tag: %(tag_name)s"
1899
def __init__(self, tag_name):
1900
self.tag_name = tag_name
1903
class TagsNotSupported(BzrError):
1905
_fmt = ("Tags not supported by %(branch)s;"
1906
" you may be able to use bzr upgrade.")
1908
def __init__(self, branch):
1909
self.branch = branch
1912
class TagAlreadyExists(BzrError):
1914
_fmt = "Tag %(tag_name)s already exists."
1916
def __init__(self, tag_name):
1917
self.tag_name = tag_name
added
removed
bzrlib/errors.py
