65
34
# constructed to make sure it will succeed. But that says nothing about
66
35
# exceptions that are never raised.
68
# TODO: Convert all the other error classes here to BzrNewError, and eliminate
37
# TODO: selftest assertRaises should probably also check that every error
38
# raised can be formatted as a string successfully, and without giving
72
42
class BzrError(StandardError):
44
Base class for errors raised by bzrlib.
46
:cvar internal_error: if true (or absent) this was probably caused by a
47
bzr bug and should be displayed with a traceback; if False this was
48
probably a user or environment error and they don't need the gory details.
49
(That can be overridden by -Derror on the command line.)
51
:cvar _fmt: Format string to display the error; this is expanded
52
by the instance's dict.
55
internal_error = False
57
def __init__(self, msg=None, **kwds):
58
"""Construct a new BzrError.
60
There are two alternative forms for constructing these objects.
61
Either a preformatted string may be passed, or a set of named
62
arguments can be given. The first is for generic "user" errors which
63
are not intended to be caught and so do not need a specific subclass.
64
The second case is for use with subclasses that provide a _fmt format
65
string to print the arguments.
67
Keyword arguments are taken as parameters to the error, which can
68
be inserted into the format string template. It's recommended
69
that subclasses override the __init__ method to require specific
72
:param msg: If given, this is the literal complete text for the error,
73
not subject to expansion.
75
StandardError.__init__(self)
77
# I was going to deprecate this, but it actually turns out to be
78
# quite handy - mbp 20061103.
79
self._preformatted_string = msg
81
self._preformatted_string = None
82
for key, value in kwds.items():
83
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`
86
s = getattr(self, '_preformatted_string', None)
88
# contains a preformatted message; must be cast to plain str
91
fmt = self._get_format_string()
93
s = fmt % self.__dict__
94
# __str__() should always return a 'str' object
95
# never a 'unicode' object.
96
if isinstance(s, unicode):
97
return s.encode('utf8')
99
except (AttributeError, TypeError, NameError, ValueError, KeyError), e:
100
return 'Unprintable exception %s: dict=%r, fmt=%r, error=%s' \
101
% (self.__class__.__name__,
103
getattr(self, '_fmt', None),
106
def _get_format_string(self):
107
"""Return format string for this exception or None"""
108
fmt = getattr(self, '_fmt', None)
111
fmt = getattr(self, '__doc__', None)
113
symbol_versioning.warn("%s uses its docstring as a format, "
114
"it should use _fmt instead" % self.__class__.__name__,
117
return 'Unprintable exception %s: dict=%r, fmt=%r' \
118
% (self.__class__.__name__,
120
getattr(self, '_fmt', None),
91
124
class BzrNewError(BzrError):
125
"""Deprecated error base class."""
93
126
# base classes should override the docstring with their human-
94
127
# readable explanation
96
def __init__(self, **kwds):
129
def __init__(self, *args, **kwds):
130
# XXX: Use the underlying BzrError to always generate the args attribute
131
# if it doesn't exist. We can't use super here, because exceptions are
132
# old-style classes in python2.4 (but new in 2.5). --bmc, 20060426
133
symbol_versioning.warn('BzrNewError was deprecated in bzr 0.13; '
134
'please convert %s to use BzrError instead'
135
% self.__class__.__name__,
138
BzrError.__init__(self, *args)
97
139
for key, value in kwds.items():
98
140
setattr(self, key, value)
100
142
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"""
144
# __str__() should always return a 'str' object
145
# never a 'unicode' object.
146
s = self.__doc__ % self.__dict__
147
if isinstance(s, unicode):
148
return s.encode('utf8')
150
except (TypeError, NameError, ValueError, KeyError), e:
151
return 'Unprintable exception %s(%r): %s' \
152
% (self.__class__.__name__,
153
self.__dict__, str(e))
156
class AlreadyBuilding(BzrError):
158
_fmt = "The tree builder is already building a tree."
161
class BzrCheckError(BzrError):
163
_fmt = "Internal check failed: %(message)s"
165
internal_error = True
111
167
def __init__(self, message):
112
BzrNewError.__init__(self)
168
BzrError.__init__(self)
113
169
self.message = message
116
class InvalidEntryName(BzrNewError):
117
"""Invalid entry name: %(name)s"""
172
class InvalidEntryName(BzrError):
174
_fmt = "Invalid entry name: %(name)s"
176
internal_error = True
118
178
def __init__(self, name):
119
BzrNewError.__init__(self)
179
BzrError.__init__(self)
123
class InvalidRevisionNumber(BzrNewError):
124
"""Invalid revision number %(revno)d"""
183
class InvalidRevisionNumber(BzrError):
185
_fmt = "Invalid revision number %(revno)s"
125
187
def __init__(self, revno):
126
BzrNewError.__init__(self)
188
BzrError.__init__(self)
127
189
self.revno = revno
130
class InvalidRevisionId(BzrNewError):
131
"""Invalid revision-id {%(revision_id)s} in %(branch)s"""
192
class InvalidRevisionId(BzrError):
194
_fmt = "Invalid revision-id {%(revision_id)s} in %(branch)s"
132
196
def __init__(self, revision_id, branch):
133
BzrNewError.__init__(self)
197
# branch can be any string or object with __str__ defined
198
BzrError.__init__(self)
134
199
self.revision_id = revision_id
135
200
self.branch = branch
138
class NoWorkingTree(BzrNewError):
139
"""No WorkingTree exists for %s(base)."""
202
class ReservedId(BzrError):
204
_fmt = "Reserved revision-id {%(revision_id)s}"
206
def __init__(self, revision_id):
207
self.revision_id = revision_id
209
class NoSuchId(BzrError):
211
_fmt = "The file id %(file_id)s is not present in the tree %(tree)s."
213
def __init__(self, tree, file_id):
214
BzrError.__init__(self)
215
self.file_id = file_id
219
class InventoryModified(BzrError):
221
_fmt = ("The current inventory for the tree %(tree)r has been modified, "
222
"so a clean inventory cannot be read without data loss.")
224
internal_error = True
226
def __init__(self, tree):
230
class NoWorkingTree(BzrError):
232
_fmt = "No WorkingTree exists for %(base)s."
141
234
def __init__(self, base):
142
BzrNewError.__init__(self)
235
BzrError.__init__(self)
146
class NotLocalUrl(BzrNewError):
147
"""%s(url) is not a local path."""
239
class NotBuilding(BzrError):
241
_fmt = "Not currently building a tree."
244
class NotLocalUrl(BzrError):
246
_fmt = "%(url)s is not a local path."
149
248
def __init__(self, url):
150
BzrNewError.__init__(self)
252
class WorkingTreeAlreadyPopulated(BzrError):
254
_fmt = """Working tree already populated in %(base)s"""
256
internal_error = True
258
def __init__(self, base):
154
261
class BzrCommandError(BzrError):
155
# Error from malformed user command
156
# This is being misused as a generic exception
157
# pleae subclass. RBC 20051030
262
"""Error from user command"""
264
internal_error = False
266
# Error from malformed user command; please avoid raising this as a
267
# generic exception not caused by user input.
159
269
# I think it's a waste of effort to differentiate between errors that
160
270
# are not intended to be caught anyway. UI code need not subclass
161
271
# BzrCommandError, and non-UI code should not throw a subclass of
162
272
# BzrCommandError. ADHB 20051211
273
def __init__(self, msg):
274
# Object.__str__() must return a real string
275
# returning a Unicode string is a python error.
276
if isinstance(msg, unicode):
277
self.msg = msg.encode('utf8')
163
281
def __str__(self):
285
class NotWriteLocked(BzrError):
287
_fmt = """%(not_locked)r is not write locked but needs to be."""
289
def __init__(self, not_locked):
290
self.not_locked = not_locked
167
293
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)"""
295
_fmt = "Error in command line options"
298
class BadOptionValue(BzrError):
300
_fmt = """Bad value "%(value)s" for option "%(name)s"."""
302
def __init__(self, name, value):
303
BzrError.__init__(self, name=name, value=value)
306
class StrictCommitFailed(BzrError):
308
_fmt = "Commit refused because there are unknown files in the tree"
311
# XXX: Should be unified with TransportError; they seem to represent the
313
class PathError(BzrError):
315
_fmt = "Generic path error: %(path)r%(extra)s)"
178
317
def __init__(self, path, extra=None):
179
BzrNewError.__init__(self)
318
BzrError.__init__(self)
182
321
self.extra = ': ' + str(extra)
414
class InvalidNormalization(PathError):
416
_fmt = "Path %(path)r is not unicode normalized"
419
# TODO: This is given a URL; we try to unescape it but doing that from inside
420
# the exception object is a bit undesirable.
421
# TODO: Probably this behavior of should be a common superclass
219
422
class NotBranchError(PathError):
220
"""Not a branch: %(path)s"""
424
_fmt = "Not a branch: %(path)s"
426
def __init__(self, path):
427
import bzrlib.urlutils as urlutils
428
self.path = urlutils.unescape_for_display(path, 'ascii')
223
431
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"""
433
_fmt = "Already a branch: %(path)s."
436
class BranchExistsWithoutWorkingTree(PathError):
438
_fmt = "Directory contains a branch, but no working tree \
439
(use bzr checkout if you wish to build a working tree): %(path)s"
442
class AtomicFileAlreadyClosed(PathError):
444
_fmt = "'%(function)s' called on an AtomicFile after it was closed: %(path)s"
446
def __init__(self, path, function):
447
PathError.__init__(self, path=path, extra=None)
448
self.function = function
451
class InaccessibleParent(PathError):
453
_fmt = "Parent not accessible given base %(base)s and relative path %(path)s"
455
def __init__(self, path, base):
456
PathError.__init__(self, path)
460
class NoRepositoryPresent(BzrError):
462
_fmt = "No repository present: %(path)r"
229
463
def __init__(self, bzrdir):
230
BzrNewError.__init__(self)
464
BzrError.__init__(self)
231
465
self.path = bzrdir.transport.clone('..').base
234
class FileInWrongBranch(BzrNewError):
235
"""File %(path)s in not in branch %(branch_base)s."""
468
class FileInWrongBranch(BzrError):
470
_fmt = "File %(path)s in not in branch %(branch_base)s."
237
472
def __init__(self, branch, path):
238
BzrNewError.__init__(self)
473
BzrError.__init__(self)
239
474
self.branch = branch
240
475
self.branch_base = branch.base
244
479
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]
481
_fmt = "Unsupported branch format: %(format)s"
250
484
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."""
486
_fmt = "Unknown branch format: %(format)r"
489
class IncompatibleFormat(BzrError):
491
_fmt = "Format %(format)s is not compatible with .bzr version %(bzrdir)s."
259
493
def __init__(self, format, bzrdir_format):
260
BzrNewError.__init__(self)
494
BzrError.__init__(self)
261
495
self.format = format
262
496
self.bzrdir = bzrdir_format
265
class NotVersionedError(BzrNewError):
266
"""%(path)s is not versioned"""
499
class IncompatibleRevision(BzrError):
501
_fmt = "Revision is not compatible with %(repo_format)s"
503
def __init__(self, repo_format):
504
BzrError.__init__(self)
505
self.repo_format = repo_format
508
class NotVersionedError(BzrError):
510
_fmt = "%(path)s is not versioned"
267
512
def __init__(self, path):
268
BzrNewError.__init__(self)
513
BzrError.__init__(self)
272
class PathsNotVersionedError(BzrNewError):
517
class PathsNotVersionedError(BzrError):
273
518
# used when reporting several paths are not versioned
274
"""Path(s) are not versioned: %(paths_as_string)s"""
276
def __init__(self, paths):
277
from bzrlib.osutils import quotefn
278
BzrNewError.__init__(self)
520
_fmt = "Path(s) are not versioned: %(paths_as_string)s"
522
def __init__(self, paths):
523
from bzrlib.osutils import quotefn
524
BzrError.__init__(self)
526
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
529
class PathsDoNotExist(BzrError):
531
_fmt = "Path(s) do not exist: %(paths_as_string)s"
533
# used when reporting that paths are neither versioned nor in the working
536
def __init__(self, paths):
538
from bzrlib.osutils import quotefn
539
BzrError.__init__(self)
279
540
self.paths = paths
280
541
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
283
544
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"""
546
_fmt = "Cannot operate on %(filename)s of unsupported kind %(kind)s"
549
class ForbiddenControlFileError(BzrError):
551
_fmt = "Cannot operate on %(filename)s because it is a control file"
554
class LockError(BzrError):
556
_fmt = "Lock error: %(message)s"
558
internal_error = True
295
560
# All exceptions from the lock/unlock functions should be from
296
561
# this exception class. They will be translated as necessary. The
297
562
# original exception is available as e.original_error
368
659
class LockNotHeld(LockError):
369
"""Lock not held: %(lock)s"""
661
_fmt = "Lock not held: %(lock)s"
663
internal_error = False
370
665
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."""
669
class PointlessCommit(BzrError):
671
_fmt = "No changes to commit"
674
class UpgradeReadonly(BzrError):
676
_fmt = "Upgrade URL cannot work with readonly URLs."
679
class UpToDateFormat(BzrError):
681
_fmt = "The branch format %(format)s is already at the most recent format."
385
683
def __init__(self, format):
386
BzrNewError.__init__(self)
684
BzrError.__init__(self)
387
685
self.format = format
391
688
class StrictCommitFailed(Exception):
392
"""Commit refused because there are unknowns in the tree."""
690
_fmt = "Commit refused because there are unknowns in the tree."
395
693
class NoSuchRevision(BzrError):
695
_fmt = "Branch %(branch)s has no revision %(revision)s"
697
internal_error = True
396
699
def __init__(self, branch, revision):
398
self.revision = revision
399
msg = "Branch %s has no revision %s" % (branch, revision)
400
BzrError.__init__(self, msg)
700
BzrError.__init__(self, branch=branch, revision=revision)
703
class NoSuchRevisionSpec(BzrError):
705
_fmt = "No namespace registered for string: %(spec)r"
707
def __init__(self, spec):
708
BzrError.__init__(self, spec=spec)
711
class NoSuchRevisionInTree(NoSuchRevision):
712
"""When using Tree.revision_tree, and the revision is not accessible."""
714
_fmt = "The revision id %(revision_id)s is not present in the tree %(tree)s."
716
def __init__(self, tree, revision_id):
717
BzrError.__init__(self)
719
self.revision_id = revision_id
722
class InvalidRevisionSpec(BzrError):
724
_fmt = "Requested revision: %(spec)r does not exist in branch: %(branch)s%(extra)s"
726
def __init__(self, spec, branch, extra=None):
727
BzrError.__init__(self, branch=branch, spec=spec)
729
self.extra = '\n' + str(extra)
403
734
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))
736
_fmt = "%(branch)s is missing %(object_type)s {%(object_id)s}"
411
739
class DivergedBranches(BzrError):
741
_fmt = "These branches have diverged. Use the merge command to reconcile them."""
743
internal_error = False
413
745
def __init__(self, branch1, branch2):
414
BzrError.__init__(self, "These branches have diverged. Try merge.")
415
746
self.branch1 = branch1
416
747
self.branch2 = branch2
419
class UnrelatedBranches(BzrCommandError):
421
msg = "Branches have no common ancestor, and no base revision"\
423
BzrCommandError.__init__(self, msg)
750
class UnrelatedBranches(BzrError):
752
_fmt = "Branches have no common ancestor, and no merge base revision was specified."
754
internal_error = False
426
757
class NoCommonAncestor(BzrError):
759
_fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
427
761
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)
762
self.revision_a = revision_a
763
self.revision_b = revision_b
433
766
class NoCommonRoot(BzrError):
768
_fmt = "Revisions are not derived from the same root: " \
769
"%(revision_a)s %(revision_b)s."
434
771
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)
772
BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
441
775
class NotAncestor(BzrError):
777
_fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
442
779
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
780
BzrError.__init__(self, rev_id=rev_id,
781
not_ancestor_id=not_ancestor_id)
450
784
class InstallFailed(BzrError):
451
786
def __init__(self, revisions):
452
msg = "Could not install revisions:\n%s" % " ,".join(revisions)
787
revision_str = ", ".join(str(r) for r in revisions)
788
msg = "Could not install revisions:\n%s" % revision_str
453
789
BzrError.__init__(self, msg)
454
790
self.revisions = revisions
457
793
class AmbiguousBase(BzrError):
458
795
def __init__(self, bases):
459
796
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
460
797
DeprecationWarning)
461
msg = "The correct base is unclear, becase %s are all equally close" %\
798
msg = "The correct base is unclear, because %s are all equally close" %\
463
800
BzrError.__init__(self, msg)
464
801
self.bases = bases
467
804
class NoCommits(BzrError):
806
_fmt = "Branch %(branch)s has no commits."
468
808
def __init__(self, branch):
469
msg = "Branch %s has no commits." % branch
470
BzrError.__init__(self, msg)
809
BzrError.__init__(self, branch=branch)
473
812
class UnlistableStore(BzrError):
474
814
def __init__(self, store):
475
815
BzrError.__init__(self, "Store %s is not listable" % store)
479
819
class UnlistableBranch(BzrError):
480
821
def __init__(self, br):
481
822
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."""
825
class BoundBranchOutOfDate(BzrError):
827
_fmt = "Bound branch %(branch)s is out of date with master branch %(master)s."
486
829
def __init__(self, branch, master):
487
BzrNewError.__init__(self)
830
BzrError.__init__(self)
488
831
self.branch = branch
489
832
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."""
835
class CommitToDoubleBoundBranch(BzrError):
837
_fmt = "Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."
494
839
def __init__(self, branch, master, remote):
495
BzrNewError.__init__(self)
840
BzrError.__init__(self)
496
841
self.branch = branch
497
842
self.master = master
498
843
self.remote = remote
501
class OverwriteBoundBranch(BzrNewError):
502
"""Cannot pull --overwrite to a branch which is bound %(branch)s"""
846
class OverwriteBoundBranch(BzrError):
848
_fmt = "Cannot pull --overwrite to a branch which is bound %(branch)s"
503
850
def __init__(self, branch):
504
BzrNewError.__init__(self)
851
BzrError.__init__(self)
505
852
self.branch = branch
508
class BoundBranchConnectionFailure(BzrNewError):
509
"""Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"""
855
class BoundBranchConnectionFailure(BzrError):
857
_fmt = "Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"
510
859
def __init__(self, branch, target, error):
511
BzrNewError.__init__(self)
860
BzrError.__init__(self)
512
861
self.branch = branch
513
862
self.target = target
514
863
self.error = error
517
class WeaveError(BzrNewError):
518
"""Error in processing weave: %(message)s"""
866
class WeaveError(BzrError):
868
_fmt = "Error in processing weave: %(message)s"
520
870
def __init__(self, message=None):
521
BzrNewError.__init__(self)
871
BzrError.__init__(self)
522
872
self.message = message
525
875
class WeaveRevisionAlreadyPresent(WeaveError):
526
"""Revision {%(revision_id)s} already present in %(weave)s"""
877
_fmt = "Revision {%(revision_id)s} already present in %(weave)s"
527
879
def __init__(self, revision_id, weave):
529
881
WeaveError.__init__(self)
622
class NoSuchExportFormat(BzrNewError):
623
"""Export format %(format)r not supported"""
989
class KnitIndexUnknownMethod(KnitError):
990
"""Raised when we don't understand the storage method.
992
Currently only 'fulltext' and 'line-delta' are supported.
995
_fmt = ("Knit index %(filename)s does not have a known method"
996
" in options: %(options)r")
998
def __init__(self, filename, options):
999
KnitError.__init__(self)
1000
self.filename = filename
1001
self.options = options
1004
class NoSuchExportFormat(BzrError):
1006
_fmt = "Export format %(format)r not supported"
624
1008
def __init__(self, format):
625
BzrNewError.__init__(self)
1009
BzrError.__init__(self)
626
1010
self.format = format
629
1013
class TransportError(BzrError):
630
"""All errors thrown by Transport implementations should derive
1015
_fmt = "Transport error: %(msg)s %(orig_error)s"
633
1017
def __init__(self, msg=None, orig_error=None):
634
1018
if msg is None and orig_error is not None:
635
1019
msg = str(orig_error)
636
BzrError.__init__(self, msg)
1020
if orig_error is None:
638
1025
self.orig_error = orig_error
1026
BzrError.__init__(self)
1029
class TooManyConcurrentRequests(BzrError):
1031
_fmt = ("The medium '%(medium)s' has reached its concurrent request limit. "
1032
"Be sure to finish_writing and finish_reading on the "
1033
"current request that is open.")
1035
internal_error = True
1037
def __init__(self, medium):
1038
self.medium = medium
1041
class SmartProtocolError(TransportError):
1043
_fmt = "Generic bzr smart protocol error: %(details)s"
1045
def __init__(self, details):
1046
self.details = details
641
1049
# A set of semi-meaningful errors which can be thrown
642
1050
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.
1052
_fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
649
1055
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)
1057
_fmt = "Connection error: %(msg)s %(orig_error)s"
1060
class SocketConnectionError(ConnectionError):
1062
_fmt = "%(msg)s %(host)s%(port)s%(orig_error)s"
1064
def __init__(self, host, port=None, msg=None, orig_error=None):
1066
msg = 'Failed to connect to'
1067
if orig_error is None:
1070
orig_error = '; ' + str(orig_error)
1071
ConnectionError.__init__(self, msg=msg, orig_error=orig_error)
1076
self.port = ':%s' % port
658
1079
class ConnectionReset(TransportError):
659
"""The connection has been closed."""
1081
_fmt = "Connection closed: %(msg)s %(orig_error)s"
1084
class InvalidRange(TransportError):
1086
_fmt = "Invalid range access in %(path)s at %(offset)s."
1088
def __init__(self, path, offset):
1089
TransportError.__init__(self, ("Invalid range access in %s at %d"
1092
self.offset = offset
1095
class InvalidHttpResponse(TransportError):
1097
_fmt = "Invalid http response for %(path)s: %(msg)s"
1099
def __init__(self, path, msg, orig_error=None):
1101
TransportError.__init__(self, msg, orig_error=orig_error)
1104
class InvalidHttpRange(InvalidHttpResponse):
1106
_fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
1108
def __init__(self, path, range, msg):
1110
InvalidHttpResponse.__init__(self, path, msg)
1113
class InvalidHttpContentType(InvalidHttpResponse):
1115
_fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1117
def __init__(self, path, ctype, msg):
1119
InvalidHttpResponse.__init__(self, path, msg)
663
1122
class ConflictsInTree(BzrError):
665
BzrError.__init__(self, "Working tree has conflicts.")
1124
_fmt = "Working tree has conflicts."
668
1127
class ParseConfigError(BzrError):
669
1129
def __init__(self, errors, filename):
670
1130
if filename is None:
674
1134
BzrError.__init__(self, message)
1137
class NoEmailInUsername(BzrError):
1139
_fmt = "%(username)r does not seem to contain a reasonable email address"
1141
def __init__(self, username):
1142
BzrError.__init__(self)
1143
self.username = username
677
1146
class SigningFailed(BzrError):
1148
_fmt = "Failed to gpg sign data with command %(command_line)r"
678
1150
def __init__(self, command_line):
679
BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
1151
BzrError.__init__(self, command_line=command_line)
683
1154
class WorkingTreeNotRevision(BzrError):
1156
_fmt = ("The working tree for %(basedir)s has changed since"
1157
" the last commit, but weave merge requires that it be"
684
1160
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"""
1161
BzrError.__init__(self, basedir=tree.basedir)
1164
class CantReprocessAndShowBase(BzrError):
1166
_fmt = "Can't reprocess and show base, because reprocessing obscures " \
1167
"the relationship of conflicting lines to the base"
1170
class GraphCycleError(BzrError):
1172
_fmt = "Cycle in graph %(graph)r"
697
1174
def __init__(self, graph):
698
BzrNewError.__init__(self)
1175
BzrError.__init__(self)
699
1176
self.graph = graph
702
class NotConflicted(BzrNewError):
703
"""File %(filename)s is not conflicted."""
1179
class WritingCompleted(BzrError):
1181
_fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
1182
"called upon it - accept bytes may not be called anymore.")
1184
internal_error = True
1186
def __init__(self, request):
1187
self.request = request
1190
class WritingNotComplete(BzrError):
1192
_fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
1193
"called upon it - until the write phase is complete no "
1194
"data may be read.")
1196
internal_error = True
1198
def __init__(self, request):
1199
self.request = request
1202
class NotConflicted(BzrError):
1204
_fmt = "File %(filename)s is not conflicted."
705
1206
def __init__(self, filename):
706
BzrNewError.__init__(self)
1207
BzrError.__init__(self)
707
1208
self.filename = filename
1211
class MediumNotConnected(BzrError):
1213
_fmt = """The medium '%(medium)s' is not connected."""
1215
internal_error = True
1217
def __init__(self, medium):
1218
self.medium = medium
710
1221
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"""
1223
_fmt = """A decorating function has requested its original command be used."""
1226
class NoBundleFound(BzrError):
1228
_fmt = "No bundle was found in %(filename)s"
1230
def __init__(self, filename):
1231
BzrError.__init__(self)
1232
self.filename = filename
1235
class BundleNotSupported(BzrError):
1237
_fmt = "Unable to handle bundle version %(version)s: %(msg)s"
1239
def __init__(self, version, msg):
1240
BzrError.__init__(self)
1241
self.version = version
1245
class MissingText(BzrError):
1247
_fmt = "Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"
720
1249
def __init__(self, branch, text_revision, file_id):
721
BzrNewError.__init__(self)
1250
BzrError.__init__(self)
722
1251
self.branch = branch
723
1252
self.base = branch.base
724
1253
self.text_revision = text_revision
725
1254
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.
1257
class DuplicateKey(BzrError):
1259
_fmt = "Key %(key)s is already present in map"
1262
class MalformedTransform(BzrError):
1264
_fmt = "Tree transform is malformed %(conflicts)r"
1267
class NoFinalPath(BzrError):
1269
_fmt = ("No final name for trans_id %(trans_id)r\n"
1270
"file-id: %(file_id)r\n"
1271
"root trans-id: %(root_trans_id)r\n")
1273
def __init__(self, trans_id, transform):
1274
self.trans_id = trans_id
1275
self.file_id = transform.final_file_id(trans_id)
1276
self.root_trans_id = transform.root
1279
class BzrBadParameter(BzrError):
1281
_fmt = "Bad parameter: %(param)r"
1283
# This exception should never be thrown, but it is a base class for all
1284
# parameter-to-function errors.
742
1286
def __init__(self, param):
743
BzrNewError.__init__(self)
1287
BzrError.__init__(self)
744
1288
self.param = param
747
1291
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"""
1293
_fmt = "Parameter %(param)s is neither unicode nor utf8."
1296
class ReusingTransform(BzrError):
1298
_fmt = "Attempt to reuse a transform that has already been applied."
1301
class CantMoveRoot(BzrError):
1303
_fmt = "Moving the root directory is not supported at this time"
759
1306
class BzrBadParameterNotString(BzrBadParameter):
760
"""Parameter %(param)s is not a string or unicode string."""
1308
_fmt = "Parameter %(param)s is not a string or unicode string."
763
1311
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"""
1313
_fmt = "Parameter $(param)s is required but not present."
1316
class BzrBadParameterUnicode(BzrBadParameter):
1318
_fmt = "Parameter %(param)s is unicode but only byte-strings are permitted."
1321
class BzrBadParameterContainsNewline(BzrBadParameter):
1323
_fmt = "Parameter %(param)s contains a newline."
1326
class DependencyNotPresent(BzrError):
1328
_fmt = 'Unable to import library "%(library)s": %(error)s'
770
1330
def __init__(self, library, error):
771
BzrNewError.__init__(self, library=library, error=error)
1331
BzrError.__init__(self, library=library, error=error)
774
1334
class ParamikoNotPresent(DependencyNotPresent):
775
"""Unable to import paramiko (required for sftp support): %(error)s"""
1336
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
777
1338
def __init__(self, error):
778
1339
DependencyNotPresent.__init__(self, 'paramiko', error)
781
class UninitializableFormat(BzrNewError):
782
"""Format %(format)s cannot be initialised by this version of bzr."""
1342
class PointlessMerge(BzrError):
1344
_fmt = "Nothing to merge."
1347
class UninitializableFormat(BzrError):
1349
_fmt = "Format %(format)s cannot be initialised by this version of bzr."
784
1351
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'."""
1352
BzrError.__init__(self)
1353
self.format = format
1356
class BadConversionTarget(BzrError):
1358
_fmt = "Cannot convert to format %(format)s. %(problem)s"
1360
def __init__(self, problem, format):
1361
BzrError.__init__(self)
1362
self.problem = problem
1363
self.format = format
1366
class NoDiff(BzrError):
1368
_fmt = "Diff is not installed on this machine: %(msg)s"
1370
def __init__(self, msg):
1371
BzrError.__init__(self, msg=msg)
1374
class NoDiff3(BzrError):
1376
_fmt = "Diff3 is not installed on this machine."
1379
class ExistingLimbo(BzrError):
1381
_fmt = """This tree contains left-over files from a failed operation.
1382
Please examine %(limbo_dir)s to see if it contains any files you wish to
1383
keep, and delete it when you are done."""
1385
def __init__(self, limbo_dir):
1386
BzrError.__init__(self)
1387
self.limbo_dir = limbo_dir
1390
class ImmortalLimbo(BzrError):
1392
_fmt = """Unable to delete transform temporary directory $(limbo_dir)s.
1393
Please examine %(limbo_dir)s to see if it contains any files you wish to
1394
keep, and delete it when you are done."""
1396
def __init__(self, limbo_dir):
1397
BzrError.__init__(self)
1398
self.limbo_dir = limbo_dir
1401
class OutOfDateTree(BzrError):
1403
_fmt = "Working tree is out of date, please run 'bzr update'."
816
1405
def __init__(self, tree):
817
BzrNewError.__init__(self)
1406
BzrError.__init__(self)
818
1407
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.
1410
class MergeModifiedFormatError(BzrError):
1412
_fmt = "Error in merge modified format"
1415
class ConflictFormatError(BzrError):
1417
_fmt = "Format error in conflict listings"
1420
class CorruptRepository(BzrError):
1422
_fmt = """An error has been detected in the repository %(repo_path)s.
831
1423
Please run bzr reconcile on this repository."""
833
1425
def __init__(self, repo):
834
BzrNewError.__init__(self)
1426
BzrError.__init__(self)
835
1427
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."""
1430
class UpgradeRequired(BzrError):
1432
_fmt = "To use this feature you must upgrade your branch at %(path)s."
841
1434
def __init__(self, path):
842
BzrNewError.__init__(self)
1435
BzrError.__init__(self)
843
1436
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."""
1439
class LocalRequiresBoundBranch(BzrError):
1441
_fmt = "Cannot perform local-only commits on unbound branches."
1444
class MissingProgressBarFinish(BzrError):
1446
_fmt = "A nested progress bar was not 'finished' correctly."
1449
class InvalidProgressBarType(BzrError):
1451
_fmt = """Environment variable BZR_PROGRESS_BAR='%(bar_type)s is not a supported type
1452
Select one of: %(valid_types)s"""
1454
def __init__(self, bar_type, valid_types):
1455
BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1458
class UnsupportedOperation(BzrError):
1460
_fmt = "The method %(mname)s is not supported on objects of type %(tname)s."
856
1462
def __init__(self, method, method_self):
857
1463
self.method = method
858
1464
self.mname = method.__name__
859
1465
self.tname = type(method_self).__name__
1468
class CannotSetRevisionId(UnsupportedOperation):
1469
"""Raised when a commit is attempting to set a revision id but cant."""
1472
class NonAsciiRevisionId(UnsupportedOperation):
1473
"""Raised when a commit is attempting to set a non-ascii revision id but cant."""
1476
class BinaryFile(BzrError):
1478
_fmt = "File is binary but should be text."
1481
class IllegalPath(BzrError):
1483
_fmt = "The path %(path)s is not permitted on this platform"
1485
def __init__(self, path):
1486
BzrError.__init__(self)
1490
class TestamentMismatch(BzrError):
1492
_fmt = """Testament did not match expected value.
1493
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1496
def __init__(self, revision_id, expected, measured):
1497
self.revision_id = revision_id
1498
self.expected = expected
1499
self.measured = measured
1502
class NotABundle(BzrError):
1504
_fmt = "Not a bzr revision-bundle: %(text)r"
1506
def __init__(self, text):
1507
BzrError.__init__(self)
1511
class BadBundle(BzrError):
1513
_fmt = "Bad bzr revision-bundle: %(text)r"
1515
def __init__(self, text):
1516
BzrError.__init__(self)
1520
class MalformedHeader(BadBundle):
1522
_fmt = "Malformed bzr revision-bundle header: %(text)r"
1525
class MalformedPatches(BadBundle):
1527
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1530
class MalformedFooter(BadBundle):
1532
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1535
class UnsupportedEOLMarker(BadBundle):
1537
_fmt = "End of line marker was not \\n in bzr revision-bundle"
1540
# XXX: BadBundle's constructor assumes there's explanatory text,
1541
# but for this there is not
1542
BzrError.__init__(self)
1545
class IncompatibleBundleFormat(BzrError):
1547
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
1549
def __init__(self, bundle_format, other):
1550
BzrError.__init__(self)
1551
self.bundle_format = bundle_format
1555
class BadInventoryFormat(BzrError):
1557
_fmt = "Root class for inventory serialization errors"
1560
class UnexpectedInventoryFormat(BadInventoryFormat):
1562
_fmt = "The inventory was not in the expected format:\n %(msg)s"
1564
def __init__(self, msg):
1565
BadInventoryFormat.__init__(self, msg=msg)
1568
class NoSmartMedium(BzrError):
1570
_fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
1572
def __init__(self, transport):
1573
self.transport = transport
1576
class NoSmartServer(NotBranchError):
1578
_fmt = "No smart server available at %(url)s"
1580
def __init__(self, url):
1584
class UnknownSSH(BzrError):
1586
_fmt = "Unrecognised value for BZR_SSH environment variable: %(vendor)s"
1588
def __init__(self, vendor):
1589
BzrError.__init__(self)
1590
self.vendor = vendor
1593
class GhostRevisionUnusableHere(BzrError):
1595
_fmt = "Ghost revision {%(revision_id)s} cannot be used here."
1597
def __init__(self, revision_id):
1598
BzrError.__init__(self)
1599
self.revision_id = revision_id
1602
class IllegalUseOfScopeReplacer(BzrError):
1604
_fmt = "ScopeReplacer object %(name)r was used incorrectly: %(msg)s%(extra)s"
1606
internal_error = True
1608
def __init__(self, name, msg, extra=None):
1609
BzrError.__init__(self)
1613
self.extra = ': ' + str(extra)
1618
class InvalidImportLine(BzrError):
1620
_fmt = "Not a valid import statement: %(msg)\n%(text)s"
1622
internal_error = True
1624
def __init__(self, text, msg):
1625
BzrError.__init__(self)
1630
class ImportNameCollision(BzrError):
1632
_fmt = "Tried to import an object to the same name as an existing object. %(name)s"
1634
internal_error = True
1636
def __init__(self, name):
1637
BzrError.__init__(self)
added
removed
bzrlib/errors.py
