85
39
# constructed to make sure it will succeed. But that says nothing about
86
40
# exceptions that are never raised.
88
# TODO: Convert all the other error classes here to BzrNewError, and eliminate
91
# TODO: The pattern (from hct) of using classes docstrings as message
92
# templates is cute but maybe not such a great idea - perhaps should have a
93
# separate static message_template.
42
# TODO: selftest assertRaises should probably also check that every error
43
# raised can be formatted as a string successfully, and without giving
96
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)
100
90
def __str__(self):
101
# XXX: Should we show the exception class in
102
# exceptions that don't provide their own message?
103
# maybe it should be done at a higher level
104
## n = self.__class__.__name__ + ': '
106
if len(self.args) == 1:
107
return str(self.args[0])
108
elif len(self.args) == 2:
109
# further explanation or suggestions
111
return n + '\n '.join([self.args[0]] + self.args[1])
113
return n + "%r" % self
115
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),
118
129
class BzrNewError(BzrError):
130
"""Deprecated error base class."""
120
131
# base classes should override the docstring with their human-
121
132
# readable explanation
123
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)
124
145
for key, value in kwds.items():
125
146
setattr(self, key, value)
127
148
def __str__(self):
129
return self.__doc__ % self.__dict__
130
except (NameError, ValueError, KeyError), e:
131
return 'Unprintable exception %s: %s' \
132
% (self.__class__.__name__, str(e))
135
class BzrCheckError(BzrNewError):
136
"""Internal check failed: %(message)s"""
138
is_user_error = False
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
140
173
def __init__(self, message):
141
BzrNewError.__init__(self)
174
BzrError.__init__(self)
142
175
self.message = message
145
class InvalidEntryName(BzrNewError):
146
"""Invalid entry name: %(name)s"""
148
is_user_error = False
178
class DisabledMethod(BzrError):
180
_fmt = "The smart server method '%(class_name)s' is disabled."
182
internal_error = True
184
def __init__(self, class_name):
185
BzrError.__init__(self)
186
self.class_name = class_name
189
class InvalidEntryName(BzrError):
191
_fmt = "Invalid entry name: %(name)s"
193
internal_error = True
150
195
def __init__(self, name):
151
BzrNewError.__init__(self)
196
BzrError.__init__(self)
155
class InvalidRevisionNumber(BzrNewError):
156
"""Invalid revision number %(revno)d"""
200
class InvalidRevisionNumber(BzrError):
202
_fmt = "Invalid revision number %(revno)s"
157
204
def __init__(self, revno):
158
BzrNewError.__init__(self)
205
BzrError.__init__(self)
159
206
self.revno = revno
162
class InvalidRevisionId(BzrNewError):
163
"""Invalid revision-id {%(revision_id)s} in %(branch)s"""
209
class InvalidRevisionId(BzrError):
211
_fmt = "Invalid revision-id {%(revision_id)s} in %(branch)s"
164
213
def __init__(self, revision_id, branch):
165
214
# branch can be any string or object with __str__ defined
166
BzrNewError.__init__(self)
215
BzrError.__init__(self)
167
216
self.revision_id = revision_id
168
217
self.branch = branch
171
class NoWorkingTree(BzrNewError):
172
"""No WorkingTree exists for %(base)s."""
219
class ReservedId(BzrError):
221
_fmt = "Reserved revision-id {%(revision_id)s}"
223
def __init__(self, revision_id):
224
self.revision_id = revision_id
226
class NoSuchId(BzrError):
228
_fmt = "The file id %(file_id)s is not present in the tree %(tree)s."
230
def __init__(self, tree, file_id):
231
BzrError.__init__(self)
232
self.file_id = file_id
236
class InventoryModified(BzrError):
238
_fmt = ("The current inventory for the tree %(tree)r has been modified,"
239
" so a clean inventory cannot be read without data loss.")
241
internal_error = True
243
def __init__(self, tree):
247
class NoWorkingTree(BzrError):
249
_fmt = "No WorkingTree exists for %(base)s."
174
251
def __init__(self, base):
175
BzrNewError.__init__(self)
252
BzrError.__init__(self)
179
class NotLocalUrl(BzrNewError):
180
"""%(url)s is not a local path."""
256
class NotBuilding(BzrError):
258
_fmt = "Not currently building a tree."
261
class NotLocalUrl(BzrError):
263
_fmt = "%(url)s is not a local path."
182
265
def __init__(self, url):
183
BzrNewError.__init__(self)
187
class BzrCommandError(BzrNewError):
269
class WorkingTreeAlreadyPopulated(BzrError):
271
_fmt = """Working tree already populated in %(base)s"""
273
internal_error = True
275
def __init__(self, base):
278
class BzrCommandError(BzrError):
188
279
"""Error from user command"""
281
internal_error = False
192
283
# Error from malformed user command; please avoid raising this as a
193
284
# generic exception not caused by user input.
315
515
class InaccessibleParent(PathError):
316
"""Parent not accessible given base %(base)s and relative path %(path)s"""
517
_fmt = ("Parent not accessible given base %(base)s and"
518
" relative path %(path)s")
318
520
def __init__(self, path, base):
319
521
PathError.__init__(self, path)
323
class NoRepositoryPresent(BzrNewError):
324
"""No repository present: %(path)r"""
525
class NoRepositoryPresent(BzrError):
527
_fmt = "No repository present: %(path)r"
325
528
def __init__(self, bzrdir):
326
BzrNewError.__init__(self)
529
BzrError.__init__(self)
327
530
self.path = bzrdir.transport.clone('..').base
330
class FileInWrongBranch(BzrNewError):
331
"""File %(path)s in not in branch %(branch_base)s."""
533
class FileInWrongBranch(BzrError):
535
_fmt = "File %(path)s in not in branch %(branch_base)s."
333
537
def __init__(self, branch, path):
334
BzrNewError.__init__(self)
538
BzrError.__init__(self)
335
539
self.branch = branch
336
540
self.branch_base = branch.base
340
class UnsupportedFormatError(BzrNewError):
341
"""Unsupported branch format: %(format)s"""
344
class UnknownFormatError(BzrNewError):
345
"""Unknown branch format: %(format)r"""
348
class IncompatibleFormat(BzrNewError):
349
"""Format %(format)s is not compatible with .bzr version %(bzrdir)s."""
544
class UnsupportedFormatError(BzrError):
546
_fmt = "Unsupported branch format: %(format)s\nPlease run 'bzr upgrade'"
549
class UnknownFormatError(BzrError):
551
_fmt = "Unknown branch format: %(format)r"
554
class IncompatibleFormat(BzrError):
556
_fmt = "Format %(format)s is not compatible with .bzr version %(bzrdir)s."
351
558
def __init__(self, format, bzrdir_format):
352
BzrNewError.__init__(self)
559
BzrError.__init__(self)
353
560
self.format = format
354
561
self.bzrdir = bzrdir_format
357
class NotVersionedError(BzrNewError):
358
"""%(path)s is not versioned"""
359
def __init__(self, path):
360
BzrNewError.__init__(self)
364
class PathsNotVersionedError(BzrNewError):
365
# used when reporting several paths are not versioned
366
"""Path(s) are not versioned: %(paths_as_string)s"""
564
class IncompatibleRepositories(BzrError):
566
_fmt = "Repository %(target)s is not compatible with repository"\
569
def __init__(self, source, target):
570
BzrError.__init__(self, target=target, source=source)
573
class IncompatibleRevision(BzrError):
575
_fmt = "Revision is not compatible with %(repo_format)s"
577
def __init__(self, repo_format):
578
BzrError.__init__(self)
579
self.repo_format = repo_format
582
class AlreadyVersionedError(BzrError):
583
"""Used when a path is expected not to be versioned, but it is."""
585
_fmt = "%(context_info)s%(path)s is already versioned"
587
def __init__(self, path, context_info=None):
588
"""Construct a new AlreadyVersionedError.
590
:param path: This is the path which is versioned,
591
which should be in a user friendly form.
592
:param context_info: If given, this is information about the context,
593
which could explain why this is expected to not be versioned.
595
BzrError.__init__(self)
597
if context_info is None:
598
self.context_info = ''
600
self.context_info = context_info + ". "
603
class NotVersionedError(BzrError):
604
"""Used when a path is expected to be versioned, but it is not."""
606
_fmt = "%(context_info)s%(path)s is not versioned"
608
def __init__(self, path, context_info=None):
609
"""Construct a new NotVersionedError.
611
:param path: This is the path which is not versioned,
612
which should be in a user friendly form.
613
:param context_info: If given, this is information about the context,
614
which could explain why this is expected to be versioned.
616
BzrError.__init__(self)
618
if context_info is None:
619
self.context_info = ''
621
self.context_info = context_info + ". "
624
class PathsNotVersionedError(BzrError):
625
"""Used when reporting several paths which are not versioned"""
627
_fmt = "Path(s) are not versioned: %(paths_as_string)s"
368
629
def __init__(self, paths):
369
630
from bzrlib.osutils import quotefn
370
BzrNewError.__init__(self)
631
BzrError.__init__(self)
371
632
self.paths = paths
372
633
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
375
class PathsDoNotExist(BzrNewError):
376
"""Path(s) do not exist: %(paths_as_string)s"""
636
class PathsDoNotExist(BzrError):
638
_fmt = "Path(s) do not exist: %(paths_as_string)s%(extra)s"
378
640
# used when reporting that paths are neither versioned nor in the working
381
def __init__(self, paths):
643
def __init__(self, paths, extra=None):
382
644
# circular import
383
645
from bzrlib.osutils import quotefn
384
BzrNewError.__init__(self)
646
BzrError.__init__(self)
385
647
self.paths = paths
386
648
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
389
class BadFileKindError(BzrNewError):
390
"""Cannot operate on %(filename)s of unsupported kind %(kind)s"""
393
class ForbiddenControlFileError(BzrNewError):
394
"""Cannot operate on %(filename)s because it is a control file"""
397
class LockError(BzrNewError):
398
"""Lock error: %(message)s"""
650
self.extra = ': ' + str(extra)
655
class BadFileKindError(BzrError):
657
_fmt = 'Cannot operate on "%(filename)s" of unsupported kind "%(kind)s"'
659
def __init__(self, filename, kind):
660
BzrError.__init__(self, filename=filename, kind=kind)
663
class ForbiddenControlFileError(BzrError):
665
_fmt = "Cannot operate on %(filename)s because it is a control file"
668
class LockError(BzrError):
670
_fmt = "Lock error: %(msg)s"
672
internal_error = True
399
674
# All exceptions from the lock/unlock functions should be from
400
675
# this exception class. They will be translated as necessary. The
401
676
# original exception is available as e.original_error
403
678
# New code should prefer to raise specific subclasses
404
679
def __init__(self, message):
405
self.message = message
680
# Python 2.5 uses a slot for StandardError.message,
681
# so use a different variable name
682
# so it is exposed in self.__dict__
686
class LockActive(LockError):
688
_fmt = "The lock for '%(lock_description)s' is in use and cannot be broken."
690
internal_error = False
692
def __init__(self, lock_description):
693
self.lock_description = lock_description
408
696
class CommitNotPossible(LockError):
409
"""A commit was attempted but we do not have a write lock open."""
698
_fmt = "A commit was attempted but we do not have a write lock open."
410
700
def __init__(self):
414
704
class AlreadyCommitted(LockError):
415
"""A rollback was requested, but is not able to be accomplished."""
706
_fmt = "A rollback was requested, but is not able to be accomplished."
416
708
def __init__(self):
420
712
class ReadOnlyError(LockError):
421
"""A write attempt was made in a read only transaction on %(obj)s"""
714
_fmt = "A write attempt was made in a read only transaction on %(obj)s"
716
# TODO: There should also be an error indicating that you need a write
717
# lock and don't have any lock at all... mbp 20070226
422
719
def __init__(self, obj):
426
class OutSideTransaction(BzrNewError):
427
"""A transaction related operation was attempted after the transaction finished."""
723
class ReadOnlyLockError(LockError):
725
_fmt = "Cannot acquire write lock on %(fname)s. %(msg)s"
727
def __init__(self, fname, msg):
728
LockError.__init__(self, '')
733
class OutSideTransaction(BzrError):
735
_fmt = ("A transaction related operation was attempted after"
736
" the transaction finished.")
430
739
class ObjectNotLocked(LockError):
431
"""%(obj)r is not locked"""
433
is_user_error = False
741
_fmt = "%(obj)r is not locked"
435
743
# this can indicate that any particular object is not locked; see also
436
744
# LockNotHeld which means that a particular *lock* object is not held by
475
802
class LockNotHeld(LockError):
476
"""Lock not held: %(lock)s"""
804
_fmt = "Lock not held: %(lock)s"
806
internal_error = False
477
808
def __init__(self, lock):
481
class PointlessCommit(BzrNewError):
482
"""No changes to commit"""
485
class UpgradeReadonly(BzrNewError):
486
"""Upgrade URL cannot work with readonly URL's."""
489
class UpToDateFormat(BzrNewError):
490
"""The branch format %(format)s is already at the most recent format."""
812
class TokenLockingNotSupported(LockError):
814
_fmt = "The object %(obj)s does not support token specifying a token when locking."
816
internal_error = True
818
def __init__(self, obj):
822
class TokenMismatch(LockBroken):
824
_fmt = "The lock token %(given_token)r does not match lock token %(lock_token)r."
826
internal_error = True
828
def __init__(self, given_token, lock_token):
829
self.given_token = given_token
830
self.lock_token = lock_token
833
class PointlessCommit(BzrError):
835
_fmt = "No changes to commit"
838
class UpgradeReadonly(BzrError):
840
_fmt = "Upgrade URL cannot work with readonly URLs."
843
class UpToDateFormat(BzrError):
845
_fmt = "The branch format %(format)s is already at the most recent format."
492
847
def __init__(self, format):
493
BzrNewError.__init__(self)
848
BzrError.__init__(self)
494
849
self.format = format
498
852
class StrictCommitFailed(Exception):
499
"""Commit refused because there are unknowns in the tree."""
502
class NoSuchRevision(BzrNewError):
503
"""Branch %(branch)s has no revision %(revision)s"""
505
is_user_error = False
854
_fmt = "Commit refused because there are unknowns in the tree."
857
class NoSuchRevision(BzrError):
859
_fmt = "Branch %(branch)s has no revision %(revision)s"
861
internal_error = True
507
863
def __init__(self, branch, revision):
509
self.revision = revision
864
BzrError.__init__(self, branch=branch, revision=revision)
867
class NotLeftParentDescendant(BzrError):
869
_fmt = ("Revision %(old_revision)s is not the left parent of"
870
" %(new_revision)s, but branch %(branch_location)s expects this")
872
internal_error = True
874
def __init__(self, branch, old_revision, new_revision):
875
BzrError.__init__(self, branch_location=branch.base,
876
old_revision=old_revision,
877
new_revision=new_revision)
880
class NoSuchRevisionSpec(BzrError):
882
_fmt = "No namespace registered for string: %(spec)r"
884
def __init__(self, spec):
885
BzrError.__init__(self, spec=spec)
888
class NoSuchRevisionInTree(NoSuchRevision):
889
"""When using Tree.revision_tree, and the revision is not accessible."""
891
_fmt = "The revision id %(revision_id)s is not present in the tree %(tree)s."
893
def __init__(self, tree, revision_id):
894
BzrError.__init__(self)
896
self.revision_id = revision_id
899
class InvalidRevisionSpec(BzrError):
901
_fmt = ("Requested revision: %(spec)r does not exist in branch:"
902
" %(branch)s%(extra)s")
904
def __init__(self, spec, branch, extra=None):
905
BzrError.__init__(self, branch=branch, spec=spec)
907
self.extra = '\n' + str(extra)
512
912
class HistoryMissing(BzrError):
513
def __init__(self, branch, object_type, object_id):
515
BzrError.__init__(self,
516
'%s is missing %s {%s}'
517
% (branch, object_type, object_id))
520
class DivergedBranches(BzrNewError):
521
"These branches have diverged. Use the merge command to reconcile them."""
914
_fmt = "%(branch)s is missing %(object_type)s {%(object_id)s}"
917
class AppendRevisionsOnlyViolation(BzrError):
919
_fmt = ('Operation denied because it would change the main history,'
920
' which is not permitted by the append_revisions_only setting on'
921
' branch "%(location)s".')
923
def __init__(self, location):
924
import bzrlib.urlutils as urlutils
925
location = urlutils.unescape_for_display(location, 'ascii')
926
BzrError.__init__(self, location=location)
929
class DivergedBranches(BzrError):
931
_fmt = ("These branches have diverged."
932
" Use the merge command to reconcile them.")
934
internal_error = False
525
936
def __init__(self, branch1, branch2):
526
937
self.branch1 = branch1
527
938
self.branch2 = branch2
530
class UnrelatedBranches(BzrNewError):
531
"Branches have no common ancestor, and no merge base revision was specified."
536
class NoCommonAncestor(BzrNewError):
537
"Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
941
class NotLefthandHistory(BzrError):
943
_fmt = "Supplied history does not follow left-hand parents"
945
internal_error = True
947
def __init__(self, history):
948
BzrError.__init__(self, history=history)
951
class UnrelatedBranches(BzrError):
953
_fmt = ("Branches have no common ancestor, and"
954
" no merge base revision was specified.")
956
internal_error = False
959
class NoCommonAncestor(BzrError):
961
_fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
539
963
def __init__(self, revision_a, revision_b):
540
964
self.revision_a = revision_a
544
968
class NoCommonRoot(BzrError):
970
_fmt = ("Revisions are not derived from the same root: "
971
"%(revision_a)s %(revision_b)s.")
545
973
def __init__(self, revision_a, revision_b):
546
msg = "Revisions are not derived from the same root: %s %s." \
547
% (revision_a, revision_b)
548
BzrError.__init__(self, msg)
974
BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
552
977
class NotAncestor(BzrError):
979
_fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
553
981
def __init__(self, rev_id, not_ancestor_id):
554
msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id,
556
BzrError.__init__(self, msg)
558
self.not_ancestor_id = not_ancestor_id
982
BzrError.__init__(self, rev_id=rev_id,
983
not_ancestor_id=not_ancestor_id)
561
986
class InstallFailed(BzrError):
562
988
def __init__(self, revisions):
563
msg = "Could not install revisions:\n%s" % " ,".join(revisions)
989
revision_str = ", ".join(str(r) for r in revisions)
990
msg = "Could not install revisions:\n%s" % revision_str
564
991
BzrError.__init__(self, msg)
565
992
self.revisions = revisions
568
995
class AmbiguousBase(BzrError):
569
997
def __init__(self, bases):
570
998
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
571
999
DeprecationWarning)
572
msg = "The correct base is unclear, because %s are all equally close" %\
1000
msg = ("The correct base is unclear, because %s are all equally close"
574
1002
BzrError.__init__(self, msg)
575
1003
self.bases = bases
578
1006
class NoCommits(BzrError):
1008
_fmt = "Branch %(branch)s has no commits."
579
1010
def __init__(self, branch):
580
msg = "Branch %s has no commits." % branch
581
BzrError.__init__(self, msg)
1011
BzrError.__init__(self, branch=branch)
584
1014
class UnlistableStore(BzrError):
585
1016
def __init__(self, store):
586
1017
BzrError.__init__(self, "Store %s is not listable" % store)
590
1021
class UnlistableBranch(BzrError):
591
1023
def __init__(self, br):
592
1024
BzrError.__init__(self, "Stores for branch %s are not listable" % br)
595
class BoundBranchOutOfDate(BzrNewError):
596
"""Bound branch %(branch)s is out of date with master branch %(master)s."""
1027
class BoundBranchOutOfDate(BzrError):
1029
_fmt = ("Bound branch %(branch)s is out of date"
1030
" with master branch %(master)s.")
597
1032
def __init__(self, branch, master):
598
BzrNewError.__init__(self)
1033
BzrError.__init__(self)
599
1034
self.branch = branch
600
1035
self.master = master
603
class CommitToDoubleBoundBranch(BzrNewError):
604
"""Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."""
1038
class CommitToDoubleBoundBranch(BzrError):
1040
_fmt = ("Cannot commit to branch %(branch)s."
1041
" It is bound to %(master)s, which is bound to %(remote)s.")
605
1043
def __init__(self, branch, master, remote):
606
BzrNewError.__init__(self)
1044
BzrError.__init__(self)
607
1045
self.branch = branch
608
1046
self.master = master
609
1047
self.remote = remote
612
class OverwriteBoundBranch(BzrNewError):
613
"""Cannot pull --overwrite to a branch which is bound %(branch)s"""
1050
class OverwriteBoundBranch(BzrError):
1052
_fmt = "Cannot pull --overwrite to a branch which is bound %(branch)s"
614
1054
def __init__(self, branch):
615
BzrNewError.__init__(self)
1055
BzrError.__init__(self)
616
1056
self.branch = branch
619
class BoundBranchConnectionFailure(BzrNewError):
620
"""Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"""
1059
class BoundBranchConnectionFailure(BzrError):
1061
_fmt = ("Unable to connect to target of bound branch %(branch)s"
1062
" => %(target)s: %(error)s")
621
1064
def __init__(self, branch, target, error):
622
BzrNewError.__init__(self)
1065
BzrError.__init__(self)
623
1066
self.branch = branch
624
1067
self.target = target
625
1068
self.error = error
628
class WeaveError(BzrNewError):
629
"""Error in processing weave: %(message)s"""
1071
class WeaveError(BzrError):
1073
_fmt = "Error in processing weave: %(message)s"
631
1075
def __init__(self, message=None):
632
BzrNewError.__init__(self)
1076
BzrError.__init__(self)
633
1077
self.message = message
636
1080
class WeaveRevisionAlreadyPresent(WeaveError):
637
"""Revision {%(revision_id)s} already present in %(weave)s"""
1082
_fmt = "Revision {%(revision_id)s} already present in %(weave)s"
638
1084
def __init__(self, revision_id, weave):
640
1086
WeaveError.__init__(self)
811
1394
BzrError.__init__(self, message)
1397
class NoEmailInUsername(BzrError):
1399
_fmt = "%(username)r does not seem to contain a reasonable email address"
1401
def __init__(self, username):
1402
BzrError.__init__(self)
1403
self.username = username
814
1406
class SigningFailed(BzrError):
1408
_fmt = "Failed to gpg sign data with command %(command_line)r"
815
1410
def __init__(self, command_line):
816
BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
1411
BzrError.__init__(self, command_line=command_line)
820
1414
class WorkingTreeNotRevision(BzrError):
1416
_fmt = ("The working tree for %(basedir)s has changed since"
1417
" the last commit, but weave merge requires that it be"
821
1420
def __init__(self, tree):
822
BzrError.__init__(self, "The working tree for %s has changed since"
823
" last commit, but weave merge requires that it be"
824
" unchanged." % tree.basedir)
827
class CantReprocessAndShowBase(BzrNewError):
828
"""Can't reprocess and show base.
829
Reprocessing obscures relationship of conflicting lines to base."""
832
class GraphCycleError(BzrNewError):
833
"""Cycle in graph %(graph)r"""
1421
BzrError.__init__(self, basedir=tree.basedir)
1424
class CantReprocessAndShowBase(BzrError):
1426
_fmt = ("Can't reprocess and show base, because reprocessing obscures "
1427
"the relationship of conflicting lines to the base")
1430
class GraphCycleError(BzrError):
1432
_fmt = "Cycle in graph %(graph)r"
834
1434
def __init__(self, graph):
835
BzrNewError.__init__(self)
1435
BzrError.__init__(self)
836
1436
self.graph = graph
839
class NotConflicted(BzrNewError):
840
"""File %(filename)s is not conflicted."""
1439
class WritingCompleted(BzrError):
1441
_fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
1442
"called upon it - accept bytes may not be called anymore.")
1444
internal_error = True
1446
def __init__(self, request):
1447
self.request = request
1450
class WritingNotComplete(BzrError):
1452
_fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
1453
"called upon it - until the write phase is complete no "
1454
"data may be read.")
1456
internal_error = True
1458
def __init__(self, request):
1459
self.request = request
1462
class NotConflicted(BzrError):
1464
_fmt = "File %(filename)s is not conflicted."
842
1466
def __init__(self, filename):
843
BzrNewError.__init__(self)
1467
BzrError.__init__(self)
844
1468
self.filename = filename
1471
class MediumNotConnected(BzrError):
1473
_fmt = """The medium '%(medium)s' is not connected."""
1475
internal_error = True
1477
def __init__(self, medium):
1478
self.medium = medium
847
1481
class MustUseDecorated(Exception):
848
"""A decorating function has requested its original command be used.
850
This should never escape bzr, so does not need to be printable.
854
class NoBundleFound(BzrNewError):
855
"""No bundle was found in %(filename)s"""
1483
_fmt = "A decorating function has requested its original command be used."
1486
class NoBundleFound(BzrError):
1488
_fmt = "No bundle was found in %(filename)s"
856
1490
def __init__(self, filename):
857
BzrNewError.__init__(self)
1491
BzrError.__init__(self)
858
1492
self.filename = filename
861
class BundleNotSupported(BzrNewError):
862
"""Unable to handle bundle version %(version)s: %(msg)s"""
1495
class BundleNotSupported(BzrError):
1497
_fmt = "Unable to handle bundle version %(version)s: %(msg)s"
863
1499
def __init__(self, version, msg):
864
BzrNewError.__init__(self)
1500
BzrError.__init__(self)
865
1501
self.version = version
869
class MissingText(BzrNewError):
870
"""Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"""
1505
class MissingText(BzrError):
1507
_fmt = ("Branch %(base)s is missing revision"
1508
" %(text_revision)s of %(file_id)s")
872
1510
def __init__(self, branch, text_revision, file_id):
873
BzrNewError.__init__(self)
1511
BzrError.__init__(self)
874
1512
self.branch = branch
875
1513
self.base = branch.base
876
1514
self.text_revision = text_revision
877
1515
self.file_id = file_id
880
class DuplicateKey(BzrNewError):
881
"""Key %(key)s is already present in map"""
884
class MalformedTransform(BzrNewError):
885
"""Tree transform is malformed %(conflicts)r"""
888
class BzrBadParameter(BzrNewError):
889
"""A bad parameter : %(param)s is not usable.
891
This exception should never be thrown, but it is a base class for all
892
parameter-to-function errors.
1518
class DuplicateFileId(BzrError):
1520
_fmt = "File id {%(file_id)s} already exists in inventory as %(entry)s"
1522
def __init__(self, file_id, entry):
1523
BzrError.__init__(self)
1524
self.file_id = file_id
1528
class DuplicateKey(BzrError):
1530
_fmt = "Key %(key)s is already present in map"
1533
class MalformedTransform(BzrError):
1535
_fmt = "Tree transform is malformed %(conflicts)r"
1538
class NoFinalPath(BzrError):
1540
_fmt = ("No final name for trans_id %(trans_id)r\n"
1541
"file-id: %(file_id)r\n"
1542
"root trans-id: %(root_trans_id)r\n")
1544
def __init__(self, trans_id, transform):
1545
self.trans_id = trans_id
1546
self.file_id = transform.final_file_id(trans_id)
1547
self.root_trans_id = transform.root
1550
class BzrBadParameter(BzrError):
1552
_fmt = "Bad parameter: %(param)r"
1554
# This exception should never be thrown, but it is a base class for all
1555
# parameter-to-function errors.
894
1557
def __init__(self, param):
895
BzrNewError.__init__(self)
1558
BzrError.__init__(self)
896
1559
self.param = param
899
1562
class BzrBadParameterNotUnicode(BzrBadParameter):
900
"""Parameter %(param)s is neither unicode nor utf8."""
903
class ReusingTransform(BzrNewError):
904
"""Attempt to reuse a transform that has already been applied."""
907
class CantMoveRoot(BzrNewError):
908
"""Moving the root directory is not supported at this time"""
1564
_fmt = "Parameter %(param)s is neither unicode nor utf8."
1567
class ReusingTransform(BzrError):
1569
_fmt = "Attempt to reuse a transform that has already been applied."
1572
class CantMoveRoot(BzrError):
1574
_fmt = "Moving the root directory is not supported at this time"
1577
class BzrMoveFailedError(BzrError):
1579
_fmt = "Could not move %(from_path)s%(operator)s %(to_path)s%(extra)s"
1581
def __init__(self, from_path='', to_path='', extra=None):
1582
BzrError.__init__(self)
1584
self.extra = ': ' + str(extra)
1588
has_from = len(from_path) > 0
1589
has_to = len(to_path) > 0
1591
self.from_path = osutils.splitpath(from_path)[-1]
1596
self.to_path = osutils.splitpath(to_path)[-1]
1601
if has_from and has_to:
1602
self.operator = " =>"
1604
self.from_path = "from " + from_path
1606
self.operator = "to"
1608
self.operator = "file"
1611
class BzrRenameFailedError(BzrMoveFailedError):
1613
_fmt = "Could not rename %(from_path)s%(operator)s %(to_path)s%(extra)s"
1615
def __init__(self, from_path, to_path, extra=None):
1616
BzrMoveFailedError.__init__(self, from_path, to_path, extra)
911
1619
class BzrBadParameterNotString(BzrBadParameter):
912
"""Parameter %(param)s is not a string or unicode string."""
1621
_fmt = "Parameter %(param)s is not a string or unicode string."
915
1624
class BzrBadParameterMissing(BzrBadParameter):
916
"""Parameter $(param)s is required but not present."""
1626
_fmt = "Parameter $(param)s is required but not present."
919
1629
class BzrBadParameterUnicode(BzrBadParameter):
920
"""Parameter %(param)s is unicode but only byte-strings are permitted."""
1631
_fmt = ("Parameter %(param)s is unicode but"
1632
" only byte-strings are permitted.")
923
1635
class BzrBadParameterContainsNewline(BzrBadParameter):
924
"""Parameter %(param)s contains a newline."""
927
class DependencyNotPresent(BzrNewError):
928
"""Unable to import library "%(library)s": %(error)s"""
1637
_fmt = "Parameter %(param)s contains a newline."
1640
class DependencyNotPresent(BzrError):
1642
_fmt = 'Unable to import library "%(library)s": %(error)s'
930
1644
def __init__(self, library, error):
931
BzrNewError.__init__(self, library=library, error=error)
1645
BzrError.__init__(self, library=library, error=error)
934
1648
class ParamikoNotPresent(DependencyNotPresent):
935
"""Unable to import paramiko (required for sftp support): %(error)s"""
1650
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
937
1652
def __init__(self, error):
938
1653
DependencyNotPresent.__init__(self, 'paramiko', error)
941
class UninitializableFormat(BzrNewError):
942
"""Format %(format)s cannot be initialised by this version of bzr."""
1656
class PointlessMerge(BzrError):
1658
_fmt = "Nothing to merge."
1661
class UninitializableFormat(BzrError):
1663
_fmt = "Format %(format)s cannot be initialised by this version of bzr."
944
1665
def __init__(self, format):
945
BzrNewError.__init__(self)
949
class NoDiff(BzrNewError):
950
"""Diff is not installed on this machine: %(msg)s"""
1666
BzrError.__init__(self)
1667
self.format = format
1670
class BadConversionTarget(BzrError):
1672
_fmt = "Cannot convert to format %(format)s. %(problem)s"
1674
def __init__(self, problem, format):
1675
BzrError.__init__(self)
1676
self.problem = problem
1677
self.format = format
1680
class NoDiff(BzrError):
1682
_fmt = "Diff is not installed on this machine: %(msg)s"
952
1684
def __init__(self, msg):
953
BzrNewError.__init__(self, msg=msg)
956
class NoDiff3(BzrNewError):
957
"""Diff3 is not installed on this machine."""
960
class ExistingLimbo(BzrNewError):
961
"""This tree contains left-over files from a failed operation.
962
Please examine %(limbo_dir)s to see if it contains any files you wish to
963
keep, and delete it when you are done.
965
def __init__(self, limbo_dir):
966
BzrNewError.__init__(self)
967
self.limbo_dir = limbo_dir
970
class ImmortalLimbo(BzrNewError):
971
"""Unable to delete transform temporary directory $(limbo_dir)s.
972
Please examine %(limbo_dir)s to see if it contains any files you wish to
973
keep, and delete it when you are done.
975
def __init__(self, limbo_dir):
976
BzrNewError.__init__(self)
977
self.limbo_dir = limbo_dir
980
class OutOfDateTree(BzrNewError):
981
"""Working tree is out of date, please run 'bzr update'."""
1685
BzrError.__init__(self, msg=msg)
1688
class NoDiff3(BzrError):
1690
_fmt = "Diff3 is not installed on this machine."
1693
class ExistingLimbo(BzrError):
1695
_fmt = """This tree contains left-over files from a failed operation.
1696
Please examine %(limbo_dir)s to see if it contains any files you wish to
1697
keep, and delete it when you are done."""
1699
def __init__(self, limbo_dir):
1700
BzrError.__init__(self)
1701
self.limbo_dir = limbo_dir
1704
class ImmortalLimbo(BzrError):
1706
_fmt = """Unable to delete transform temporary directory $(limbo_dir)s.
1707
Please examine %(limbo_dir)s to see if it contains any files you wish to
1708
keep, and delete it when you are done."""
1710
def __init__(self, limbo_dir):
1711
BzrError.__init__(self)
1712
self.limbo_dir = limbo_dir
1715
class OutOfDateTree(BzrError):
1717
_fmt = "Working tree is out of date, please run 'bzr update'."
983
1719
def __init__(self, tree):
984
BzrNewError.__init__(self)
1720
BzrError.__init__(self)
985
1721
self.tree = tree
988
class MergeModifiedFormatError(BzrNewError):
989
"""Error in merge modified format"""
992
class ConflictFormatError(BzrNewError):
993
"""Format error in conflict listings"""
996
class CorruptRepository(BzrNewError):
997
"""An error has been detected in the repository %(repo_path)s.
998
Please run bzr reconcile on this repository."""
1724
class PublicBranchOutOfDate(BzrError):
1726
_fmt = 'Public branch "%(public_location)s" lacks revision '\
1729
def __init__(self, public_location, revstring):
1730
import bzrlib.urlutils as urlutils
1731
public_location = urlutils.unescape_for_display(public_location,
1733
BzrError.__init__(self, public_location=public_location,
1734
revstring=revstring)
1737
class MergeModifiedFormatError(BzrError):
1739
_fmt = "Error in merge modified format"
1742
class ConflictFormatError(BzrError):
1744
_fmt = "Format error in conflict listings"
1747
class CorruptRepository(BzrError):
1749
_fmt = ("An error has been detected in the repository %(repo_path)s.\n"
1750
"Please run bzr reconcile on this repository.")
1000
1752
def __init__(self, repo):
1001
BzrNewError.__init__(self)
1753
BzrError.__init__(self)
1002
1754
self.repo_path = repo.bzrdir.root_transport.base
1005
class UpgradeRequired(BzrNewError):
1006
"""To use this feature you must upgrade your branch at %(path)s."""
1757
class UpgradeRequired(BzrError):
1759
_fmt = "To use this feature you must upgrade your branch at %(path)s."
1008
1761
def __init__(self, path):
1009
BzrNewError.__init__(self)
1762
BzrError.__init__(self)
1010
1763
self.path = path
1013
class LocalRequiresBoundBranch(BzrNewError):
1014
"""Cannot perform local-only commits on unbound branches."""
1017
class MissingProgressBarFinish(BzrNewError):
1018
"""A nested progress bar was not 'finished' correctly."""
1021
class InvalidProgressBarType(BzrNewError):
1022
"""Environment variable BZR_PROGRESS_BAR='%(bar_type)s is not a supported type
1023
Select one of: %(valid_types)s"""
1766
class LocalRequiresBoundBranch(BzrError):
1768
_fmt = "Cannot perform local-only commits on unbound branches."
1771
class MissingProgressBarFinish(BzrError):
1773
_fmt = "A nested progress bar was not 'finished' correctly."
1776
class InvalidProgressBarType(BzrError):
1778
_fmt = ("Environment variable BZR_PROGRESS_BAR='%(bar_type)s"
1779
" is not a supported type Select one of: %(valid_types)s")
1025
1781
def __init__(self, bar_type, valid_types):
1026
BzrNewError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1029
class UnsupportedOperation(BzrNewError):
1030
"""The method %(mname)s is not supported on objects of type %(tname)s."""
1782
BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1785
class UnsupportedOperation(BzrError):
1787
_fmt = ("The method %(mname)s is not supported on"
1788
" objects of type %(tname)s.")
1031
1790
def __init__(self, method, method_self):
1032
1791
self.method = method
1033
1792
self.mname = method.__name__
1034
1793
self.tname = type(method_self).__name__
1037
class BinaryFile(BzrNewError):
1038
"""File is binary but should be text."""
1041
class IllegalPath(BzrNewError):
1042
"""The path %(path)s is not permitted on this platform"""
1796
class CannotSetRevisionId(UnsupportedOperation):
1797
"""Raised when a commit is attempting to set a revision id but cant."""
1800
class NonAsciiRevisionId(UnsupportedOperation):
1801
"""Raised when a commit is attempting to set a non-ascii revision id
1806
class BinaryFile(BzrError):
1808
_fmt = "File is binary but should be text."
1811
class IllegalPath(BzrError):
1813
_fmt = "The path %(path)s is not permitted on this platform"
1044
1815
def __init__(self, path):
1045
BzrNewError.__init__(self)
1816
BzrError.__init__(self)
1046
1817
self.path = path
1049
class TestamentMismatch(BzrNewError):
1050
"""Testament did not match expected value.
1051
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1820
class TestamentMismatch(BzrError):
1822
_fmt = """Testament did not match expected value.
1823
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1054
1826
def __init__(self, revision_id, expected, measured):
1055
1827
self.revision_id = revision_id
1056
1828
self.expected = expected
1057
1829
self.measured = measured
1060
class NotABundle(BzrNewError):
1061
"""Not a bzr revision-bundle: %(text)r"""
1063
def __init__(self, text):
1067
class BadBundle(Exception): pass
1070
class MalformedHeader(BadBundle): pass
1073
class MalformedPatches(BadBundle): pass
1076
class MalformedFooter(BadBundle): pass
1832
class NotABundle(BzrError):
1834
_fmt = "Not a bzr revision-bundle: %(text)r"
1836
def __init__(self, text):
1837
BzrError.__init__(self)
1841
class BadBundle(BzrError):
1843
_fmt = "Bad bzr revision-bundle: %(text)r"
1845
def __init__(self, text):
1846
BzrError.__init__(self)
1850
class MalformedHeader(BadBundle):
1852
_fmt = "Malformed bzr revision-bundle header: %(text)r"
1855
class MalformedPatches(BadBundle):
1857
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1860
class MalformedFooter(BadBundle):
1862
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1865
class UnsupportedEOLMarker(BadBundle):
1867
_fmt = "End of line marker was not \\n in bzr revision-bundle"
1870
# XXX: BadBundle's constructor assumes there's explanatory text,
1871
# but for this there is not
1872
BzrError.__init__(self)
1875
class IncompatibleBundleFormat(BzrError):
1877
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
1879
def __init__(self, bundle_format, other):
1880
BzrError.__init__(self)
1881
self.bundle_format = bundle_format
1885
class BadInventoryFormat(BzrError):
1887
_fmt = "Root class for inventory serialization errors"
1890
class UnexpectedInventoryFormat(BadInventoryFormat):
1892
_fmt = "The inventory was not in the expected format:\n %(msg)s"
1894
def __init__(self, msg):
1895
BadInventoryFormat.__init__(self, msg=msg)
1898
class RootNotRich(BzrError):
1900
_fmt = """This operation requires rich root data storage"""
1903
class NoSmartMedium(BzrError):
1905
_fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
1907
internal_error = True
1909
def __init__(self, transport):
1910
self.transport = transport
1913
class NoSmartServer(NotBranchError):
1915
_fmt = "No smart server available at %(url)s"
1917
def __init__(self, url):
1921
class UnknownSSH(BzrError):
1923
_fmt = "Unrecognised value for BZR_SSH environment variable: %(vendor)s"
1925
def __init__(self, vendor):
1926
BzrError.__init__(self)
1927
self.vendor = vendor
1930
class SSHVendorNotFound(BzrError):
1932
_fmt = ("Don't know how to handle SSH connections."
1933
" Please set BZR_SSH environment variable.")
1936
class GhostRevisionUnusableHere(BzrError):
1938
_fmt = "Ghost revision {%(revision_id)s} cannot be used here."
1940
def __init__(self, revision_id):
1941
BzrError.__init__(self)
1942
self.revision_id = revision_id
1945
class IllegalUseOfScopeReplacer(BzrError):
1947
_fmt = ("ScopeReplacer object %(name)r was used incorrectly:"
1948
" %(msg)s%(extra)s")
1950
internal_error = True
1952
def __init__(self, name, msg, extra=None):
1953
BzrError.__init__(self)
1957
self.extra = ': ' + str(extra)
1962
class InvalidImportLine(BzrError):
1964
_fmt = "Not a valid import statement: %(msg)\n%(text)s"
1966
internal_error = True
1968
def __init__(self, text, msg):
1969
BzrError.__init__(self)
1974
class ImportNameCollision(BzrError):
1976
_fmt = ("Tried to import an object to the same name as"
1977
" an existing object. %(name)s")
1979
internal_error = True
1981
def __init__(self, name):
1982
BzrError.__init__(self)
1986
class NotAMergeDirective(BzrError):
1987
"""File starting with %(firstline)r is not a merge directive"""
1988
def __init__(self, firstline):
1989
BzrError.__init__(self, firstline=firstline)
1992
class NoMergeSource(BzrError):
1993
"""Raise if no merge source was specified for a merge directive"""
1995
_fmt = "A merge directive must provide either a bundle or a public"\
1999
class PatchMissing(BzrError):
2000
"""Raise a patch type was specified but no patch supplied"""
2002
_fmt = "patch_type was %(patch_type)s, but no patch was supplied."
2004
def __init__(self, patch_type):
2005
BzrError.__init__(self)
2006
self.patch_type = patch_type
2009
class UnsupportedInventoryKind(BzrError):
2011
_fmt = """Unsupported entry kind %(kind)s"""
2013
def __init__(self, kind):
2017
class BadSubsumeSource(BzrError):
2019
_fmt = """Can't subsume %(other_tree)s into %(tree)s. %(reason)s"""
2021
def __init__(self, tree, other_tree, reason):
2023
self.other_tree = other_tree
2024
self.reason = reason
2027
class SubsumeTargetNeedsUpgrade(BzrError):
2029
_fmt = """Subsume target %(other_tree)s needs to be upgraded."""
2031
def __init__(self, other_tree):
2032
self.other_tree = other_tree
2035
class BadReferenceTarget(BzrError):
2037
_fmt = "Can't add reference to %(other_tree)s into %(tree)s. %(reason)s"
2039
internal_error = True
2041
def __init__(self, tree, other_tree, reason):
2043
self.other_tree = other_tree
2044
self.reason = reason
2047
class NoSuchTag(BzrError):
2049
_fmt = "No such tag: %(tag_name)s"
2051
def __init__(self, tag_name):
2052
self.tag_name = tag_name
2055
class TagsNotSupported(BzrError):
2057
_fmt = ("Tags not supported by %(branch)s;"
2058
" you may be able to use bzr upgrade --dirstate-tags.")
2060
def __init__(self, branch):
2061
self.branch = branch
2064
class TagAlreadyExists(BzrError):
2066
_fmt = "Tag %(tag_name)s already exists."
2068
def __init__(self, tag_name):
2069
self.tag_name = tag_name
added
removed
bzrlib/errors.py
