1
# Copyright (C) 2005, 2006 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17
"""Exceptions for bzr, and reporting of them.
21
from bzrlib import symbol_versioning
22
from bzrlib.patches import (PatchSyntax,
29
# TODO: is there any value in providing the .args field used by standard
30
# python exceptions? A list of values with no names seems less useful
33
# TODO: Perhaps convert the exception to a string at the moment it's
34
# constructed to make sure it will succeed. But that says nothing about
35
# exceptions that are never raised.
37
# TODO: selftest assertRaises should probably also check that every error
38
# raised can be formatted as a string successfully, and without giving
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)
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),
124
class BzrNewError(BzrError):
125
"""Deprecated error base class."""
126
# base classes should override the docstring with their human-
127
# readable explanation
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)
139
for key, value in kwds.items():
140
setattr(self, key, value)
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
167
def __init__(self, message):
168
BzrError.__init__(self)
169
self.message = message
172
class DisabledMethod(BzrError):
174
_fmt = "The smart server method '%(class_name)s' is disabled."
176
internal_error = True
178
def __init__(self, class_name):
179
BzrError.__init__(self)
180
self.class_name = class_name
183
class InvalidEntryName(BzrError):
185
_fmt = "Invalid entry name: %(name)s"
187
internal_error = True
189
def __init__(self, name):
190
BzrError.__init__(self)
194
class InvalidRevisionNumber(BzrError):
196
_fmt = "Invalid revision number %(revno)s"
198
def __init__(self, revno):
199
BzrError.__init__(self)
203
class InvalidRevisionId(BzrError):
205
_fmt = "Invalid revision-id {%(revision_id)s} in %(branch)s"
207
def __init__(self, revision_id, branch):
208
# branch can be any string or object with __str__ defined
209
BzrError.__init__(self)
210
self.revision_id = revision_id
214
class NoSuchId(BzrError):
216
_fmt = "The file id %(file_id)s is not present in the tree %(tree)s."
218
def __init__(self, tree, file_id):
219
BzrError.__init__(self)
220
self.file_id = file_id
224
class InventoryModified(BzrError):
226
_fmt = ("The current inventory for the tree %(tree)r has been modified, "
227
"so a clean inventory cannot be read without data loss.")
229
internal_error = True
231
def __init__(self, tree):
235
class NoWorkingTree(BzrError):
237
_fmt = "No WorkingTree exists for %(base)s."
239
def __init__(self, base):
240
BzrError.__init__(self)
244
class NotBuilding(BzrError):
246
_fmt = "Not currently building a tree."
249
class NotLocalUrl(BzrError):
251
_fmt = "%(url)s is not a local path."
253
def __init__(self, url):
257
class WorkingTreeAlreadyPopulated(BzrError):
259
_fmt = """Working tree already populated in %(base)s"""
261
internal_error = True
263
def __init__(self, base):
266
class BzrCommandError(BzrError):
267
"""Error from user command"""
269
internal_error = False
271
# Error from malformed user command; please avoid raising this as a
272
# generic exception not caused by user input.
274
# I think it's a waste of effort to differentiate between errors that
275
# are not intended to be caught anyway. UI code need not subclass
276
# BzrCommandError, and non-UI code should not throw a subclass of
277
# BzrCommandError. ADHB 20051211
278
def __init__(self, msg):
279
# Object.__str__() must return a real string
280
# returning a Unicode string is a python error.
281
if isinstance(msg, unicode):
282
self.msg = msg.encode('utf8')
290
class NotWriteLocked(BzrError):
292
_fmt = """%(not_locked)r is not write locked but needs to be."""
294
def __init__(self, not_locked):
295
self.not_locked = not_locked
298
class BzrOptionError(BzrCommandError):
300
_fmt = "Error in command line options"
303
class StrictCommitFailed(BzrError):
305
_fmt = "Commit refused because there are unknown files in the tree"
308
# XXX: Should be unified with TransportError; they seem to represent the
310
class PathError(BzrError):
312
_fmt = "Generic path error: %(path)r%(extra)s)"
314
def __init__(self, path, extra=None):
315
BzrError.__init__(self)
318
self.extra = ': ' + str(extra)
323
class NoSuchFile(PathError):
325
_fmt = "No such file: %(path)r%(extra)s"
328
class FileExists(PathError):
330
_fmt = "File exists: %(path)r%(extra)s"
333
class DirectoryNotEmpty(PathError):
335
_fmt = "Directory not empty: %(path)r%(extra)s"
338
class ReadingCompleted(BzrError):
340
_fmt = ("The MediumRequest '%(request)s' has already had finish_reading "
341
"called upon it - the request has been completed and no more "
344
internal_error = True
346
def __init__(self, request):
347
self.request = request
350
class ResourceBusy(PathError):
352
_fmt = "Device or resource busy: %(path)r%(extra)s"
355
class PermissionDenied(PathError):
357
_fmt = "Permission denied: %(path)r%(extra)s"
360
class InvalidURL(PathError):
362
_fmt = "Invalid url supplied to transport: %(path)r%(extra)s"
365
class InvalidURLJoin(PathError):
367
_fmt = "Invalid URL join request: %(args)s%(extra)s"
369
def __init__(self, msg, base, args):
370
PathError.__init__(self, base, msg)
371
self.args = [base] + list(args)
374
class UnsupportedProtocol(PathError):
376
_fmt = 'Unsupported protocol for url "%(path)s"%(extra)s'
378
def __init__(self, url, extra):
379
PathError.__init__(self, url, extra=extra)
382
class ShortReadvError(PathError):
384
_fmt = "readv() read %(actual)s bytes rather than %(length)s bytes at %(offset)s for %(path)s%(extra)s"
386
internal_error = True
388
def __init__(self, path, offset, length, actual, extra=None):
389
PathError.__init__(self, path, extra=extra)
395
class PathNotChild(BzrError):
397
_fmt = "Path %(path)r is not a child of path %(base)r%(extra)s"
399
internal_error = True
401
def __init__(self, path, base, extra=None):
402
BzrError.__init__(self)
406
self.extra = ': ' + str(extra)
411
class InvalidNormalization(PathError):
413
_fmt = "Path %(path)r is not unicode normalized"
416
# TODO: This is given a URL; we try to unescape it but doing that from inside
417
# the exception object is a bit undesirable.
418
# TODO: Probably this behavior of should be a common superclass
419
class NotBranchError(PathError):
421
_fmt = "Not a branch: %(path)s"
423
def __init__(self, path):
424
import bzrlib.urlutils as urlutils
425
self.path = urlutils.unescape_for_display(path, 'ascii')
428
class AlreadyBranchError(PathError):
430
_fmt = "Already a branch: %(path)s."
433
class BranchExistsWithoutWorkingTree(PathError):
435
_fmt = "Directory contains a branch, but no working tree \
436
(use bzr checkout if you wish to build a working tree): %(path)s"
439
class AtomicFileAlreadyClosed(PathError):
441
_fmt = "'%(function)s' called on an AtomicFile after it was closed: %(path)s"
443
def __init__(self, path, function):
444
PathError.__init__(self, path=path, extra=None)
445
self.function = function
448
class InaccessibleParent(PathError):
450
_fmt = "Parent not accessible given base %(base)s and relative path %(path)s"
452
def __init__(self, path, base):
453
PathError.__init__(self, path)
457
class NoRepositoryPresent(BzrError):
459
_fmt = "No repository present: %(path)r"
460
def __init__(self, bzrdir):
461
BzrError.__init__(self)
462
self.path = bzrdir.transport.clone('..').base
465
class FileInWrongBranch(BzrError):
467
_fmt = "File %(path)s in not in branch %(branch_base)s."
469
def __init__(self, branch, path):
470
BzrError.__init__(self)
472
self.branch_base = branch.base
476
class UnsupportedFormatError(BzrError):
478
_fmt = "Unsupported branch format: %(format)s"
481
class UnknownFormatError(BzrError):
483
_fmt = "Unknown branch format: %(format)r"
486
class IncompatibleFormat(BzrError):
488
_fmt = "Format %(format)s is not compatible with .bzr version %(bzrdir)s."
490
def __init__(self, format, bzrdir_format):
491
BzrError.__init__(self)
493
self.bzrdir = bzrdir_format
496
class IncompatibleRevision(BzrError):
498
_fmt = "Revision is not compatible with %(repo_format)s"
500
def __init__(self, repo_format):
501
BzrError.__init__(self)
502
self.repo_format = repo_format
505
class NotVersionedError(BzrError):
507
_fmt = "%(path)s is not versioned"
509
def __init__(self, path):
510
BzrError.__init__(self)
514
class PathsNotVersionedError(BzrError):
515
# used when reporting several paths are not versioned
517
_fmt = "Path(s) are not versioned: %(paths_as_string)s"
519
def __init__(self, paths):
520
from bzrlib.osutils import quotefn
521
BzrError.__init__(self)
523
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
526
class PathsDoNotExist(BzrError):
528
_fmt = "Path(s) do not exist: %(paths_as_string)s"
530
# used when reporting that paths are neither versioned nor in the working
533
def __init__(self, paths):
535
from bzrlib.osutils import quotefn
536
BzrError.__init__(self)
538
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
541
class BadFileKindError(BzrError):
543
_fmt = "Cannot operate on %(filename)s of unsupported kind %(kind)s"
546
class ForbiddenControlFileError(BzrError):
548
_fmt = "Cannot operate on %(filename)s because it is a control file"
551
class LockError(BzrError):
553
_fmt = "Lock error: %(message)s"
555
# All exceptions from the lock/unlock functions should be from
556
# this exception class. They will be translated as necessary. The
557
# original exception is available as e.original_error
559
# New code should prefer to raise specific subclasses
560
def __init__(self, message):
561
self.message = message
564
class CommitNotPossible(LockError):
566
_fmt = "A commit was attempted but we do not have a write lock open."
572
class AlreadyCommitted(LockError):
574
_fmt = "A rollback was requested, but is not able to be accomplished."
580
class ReadOnlyError(LockError):
582
_fmt = "A write attempt was made in a read only transaction on %(obj)s"
584
def __init__(self, obj):
588
class OutSideTransaction(BzrError):
590
_fmt = "A transaction related operation was attempted after the transaction finished."
593
class ObjectNotLocked(LockError):
595
_fmt = "%(obj)r is not locked"
597
internal_error = True
599
# this can indicate that any particular object is not locked; see also
600
# LockNotHeld which means that a particular *lock* object is not held by
601
# the caller -- perhaps they should be unified.
602
def __init__(self, obj):
606
class ReadOnlyObjectDirtiedError(ReadOnlyError):
608
_fmt = "Cannot change object %(obj)r in read only transaction"
610
def __init__(self, obj):
614
class UnlockableTransport(LockError):
616
_fmt = "Cannot lock: transport is read only: %(transport)s"
618
def __init__(self, transport):
619
self.transport = transport
622
class LockContention(LockError):
624
_fmt = "Could not acquire lock %(lock)s"
625
# TODO: show full url for lock, combining the transport and relative bits?
627
def __init__(self, lock):
631
class LockBroken(LockError):
633
_fmt = "Lock was broken while still open: %(lock)s - check storage consistency!"
635
def __init__(self, lock):
639
class LockBreakMismatch(LockError):
641
_fmt = "Lock was released and re-acquired before being broken: %(lock)s: held by %(holder)r, wanted to break %(target)r"
643
def __init__(self, lock, holder, target):
649
class LockNotHeld(LockError):
651
_fmt = "Lock not held: %(lock)s"
653
def __init__(self, lock):
657
class PointlessCommit(BzrError):
659
_fmt = "No changes to commit"
662
class UpgradeReadonly(BzrError):
664
_fmt = "Upgrade URL cannot work with readonly URLs."
667
class UpToDateFormat(BzrError):
669
_fmt = "The branch format %(format)s is already at the most recent format."
671
def __init__(self, format):
672
BzrError.__init__(self)
676
class StrictCommitFailed(Exception):
678
_fmt = "Commit refused because there are unknowns in the tree."
681
class NoSuchRevision(BzrError):
683
_fmt = "Branch %(branch)s has no revision %(revision)s"
685
internal_error = True
687
def __init__(self, branch, revision):
688
BzrError.__init__(self, branch=branch, revision=revision)
691
class NoSuchRevisionSpec(BzrError):
693
_fmt = "No namespace registered for string: %(spec)r"
695
def __init__(self, spec):
696
BzrError.__init__(self, spec=spec)
699
class InvalidRevisionSpec(BzrError):
701
_fmt = "Requested revision: %(spec)r does not exist in branch: %(branch)s%(extra)s"
703
def __init__(self, spec, branch, extra=None):
704
BzrError.__init__(self, branch=branch, spec=spec)
706
self.extra = '\n' + str(extra)
711
class HistoryMissing(BzrError):
713
_fmt = "%(branch)s is missing %(object_type)s {%(object_id)s}"
716
class DivergedBranches(BzrError):
718
_fmt = "These branches have diverged. Use the merge command to reconcile them."""
720
internal_error = False
722
def __init__(self, branch1, branch2):
723
self.branch1 = branch1
724
self.branch2 = branch2
727
class UnrelatedBranches(BzrError):
729
_fmt = "Branches have no common ancestor, and no merge base revision was specified."
731
internal_error = False
734
class NoCommonAncestor(BzrError):
736
_fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
738
def __init__(self, revision_a, revision_b):
739
self.revision_a = revision_a
740
self.revision_b = revision_b
743
class NoCommonRoot(BzrError):
745
_fmt = "Revisions are not derived from the same root: " \
746
"%(revision_a)s %(revision_b)s."
748
def __init__(self, revision_a, revision_b):
749
BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
752
class NotAncestor(BzrError):
754
_fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
756
def __init__(self, rev_id, not_ancestor_id):
757
BzrError.__init__(self, rev_id=rev_id,
758
not_ancestor_id=not_ancestor_id)
761
class InstallFailed(BzrError):
763
def __init__(self, revisions):
764
revision_str = ", ".join(str(r) for r in revisions)
765
msg = "Could not install revisions:\n%s" % revision_str
766
BzrError.__init__(self, msg)
767
self.revisions = revisions
770
class AmbiguousBase(BzrError):
772
def __init__(self, bases):
773
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
775
msg = "The correct base is unclear, because %s are all equally close" %\
777
BzrError.__init__(self, msg)
781
class NoCommits(BzrError):
783
_fmt = "Branch %(branch)s has no commits."
785
def __init__(self, branch):
786
BzrError.__init__(self, branch=branch)
789
class UnlistableStore(BzrError):
791
def __init__(self, store):
792
BzrError.__init__(self, "Store %s is not listable" % store)
796
class UnlistableBranch(BzrError):
798
def __init__(self, br):
799
BzrError.__init__(self, "Stores for branch %s are not listable" % br)
802
class BoundBranchOutOfDate(BzrError):
804
_fmt = "Bound branch %(branch)s is out of date with master branch %(master)s."
806
def __init__(self, branch, master):
807
BzrError.__init__(self)
812
class CommitToDoubleBoundBranch(BzrError):
814
_fmt = "Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."
816
def __init__(self, branch, master, remote):
817
BzrError.__init__(self)
823
class OverwriteBoundBranch(BzrError):
825
_fmt = "Cannot pull --overwrite to a branch which is bound %(branch)s"
827
def __init__(self, branch):
828
BzrError.__init__(self)
832
class BoundBranchConnectionFailure(BzrError):
834
_fmt = "Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"
836
def __init__(self, branch, target, error):
837
BzrError.__init__(self)
843
class WeaveError(BzrError):
845
_fmt = "Error in processing weave: %(message)s"
847
def __init__(self, message=None):
848
BzrError.__init__(self)
849
self.message = message
852
class WeaveRevisionAlreadyPresent(WeaveError):
854
_fmt = "Revision {%(revision_id)s} already present in %(weave)s"
856
def __init__(self, revision_id, weave):
858
WeaveError.__init__(self)
859
self.revision_id = revision_id
863
class WeaveRevisionNotPresent(WeaveError):
865
_fmt = "Revision {%(revision_id)s} not present in %(weave)s"
867
def __init__(self, revision_id, weave):
868
WeaveError.__init__(self)
869
self.revision_id = revision_id
873
class WeaveFormatError(WeaveError):
875
_fmt = "Weave invariant violated: %(what)s"
877
def __init__(self, what):
878
WeaveError.__init__(self)
882
class WeaveParentMismatch(WeaveError):
884
_fmt = "Parents are mismatched between two revisions."
887
class WeaveInvalidChecksum(WeaveError):
889
_fmt = "Text did not match it's checksum: %(message)s"
892
class WeaveTextDiffers(WeaveError):
894
_fmt = "Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"
896
def __init__(self, revision_id, weave_a, weave_b):
897
WeaveError.__init__(self)
898
self.revision_id = revision_id
899
self.weave_a = weave_a
900
self.weave_b = weave_b
903
class WeaveTextDiffers(WeaveError):
905
_fmt = "Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"
907
def __init__(self, revision_id, weave_a, weave_b):
908
WeaveError.__init__(self)
909
self.revision_id = revision_id
910
self.weave_a = weave_a
911
self.weave_b = weave_b
914
class VersionedFileError(BzrError):
916
_fmt = "Versioned file error"
919
class RevisionNotPresent(VersionedFileError):
921
_fmt = "Revision {%(revision_id)s} not present in %(file_id)s."
923
def __init__(self, revision_id, file_id):
924
VersionedFileError.__init__(self)
925
self.revision_id = revision_id
926
self.file_id = file_id
929
class RevisionAlreadyPresent(VersionedFileError):
931
_fmt = "Revision {%(revision_id)s} already present in %(file_id)s."
933
def __init__(self, revision_id, file_id):
934
VersionedFileError.__init__(self)
935
self.revision_id = revision_id
936
self.file_id = file_id
939
class KnitError(BzrError):
944
class KnitHeaderError(KnitError):
946
_fmt = "Knit header error: %(badline)r unexpected"
948
def __init__(self, badline):
949
KnitError.__init__(self)
950
self.badline = badline
953
class KnitCorrupt(KnitError):
955
_fmt = "Knit %(filename)s corrupt: %(how)s"
957
def __init__(self, filename, how):
958
KnitError.__init__(self)
959
self.filename = filename
963
class NoSuchExportFormat(BzrError):
965
_fmt = "Export format %(format)r not supported"
967
def __init__(self, format):
968
BzrError.__init__(self)
972
class TransportError(BzrError):
974
_fmt = "Transport error: %(msg)s %(orig_error)s"
976
def __init__(self, msg=None, orig_error=None):
977
if msg is None and orig_error is not None:
978
msg = str(orig_error)
979
if orig_error is None:
984
self.orig_error = orig_error
985
BzrError.__init__(self)
988
class TooManyConcurrentRequests(BzrError):
990
_fmt = ("The medium '%(medium)s' has reached its concurrent request limit. "
991
"Be sure to finish_writing and finish_reading on the "
992
"current request that is open.")
994
internal_error = True
996
def __init__(self, medium):
1000
class SmartProtocolError(TransportError):
1002
_fmt = "Generic bzr smart protocol error: %(details)s"
1004
def __init__(self, details):
1005
self.details = details
1008
# A set of semi-meaningful errors which can be thrown
1009
class TransportNotPossible(TransportError):
1011
_fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
1014
class ConnectionError(TransportError):
1016
_fmt = "Connection error: %(msg)s %(orig_error)s"
1019
class SocketConnectionError(ConnectionError):
1021
_fmt = "%(msg)s %(host)s%(port)s%(orig_error)s"
1023
def __init__(self, host, port=None, msg=None, orig_error=None):
1025
msg = 'Failed to connect to'
1026
if orig_error is None:
1029
orig_error = '; ' + str(orig_error)
1030
ConnectionError.__init__(self, msg=msg, orig_error=orig_error)
1035
self.port = ':%s' % port
1038
class ConnectionReset(TransportError):
1040
_fmt = "Connection closed: %(msg)s %(orig_error)s"
1043
class InvalidRange(TransportError):
1045
_fmt = "Invalid range access in %(path)s at %(offset)s."
1047
def __init__(self, path, offset):
1048
TransportError.__init__(self, ("Invalid range access in %s at %d"
1051
self.offset = offset
1054
class InvalidHttpResponse(TransportError):
1056
_fmt = "Invalid http response for %(path)s: %(msg)s"
1058
def __init__(self, path, msg, orig_error=None):
1060
TransportError.__init__(self, msg, orig_error=orig_error)
1063
class InvalidHttpRange(InvalidHttpResponse):
1065
_fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
1067
def __init__(self, path, range, msg):
1069
InvalidHttpResponse.__init__(self, path, msg)
1072
class InvalidHttpContentType(InvalidHttpResponse):
1074
_fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1076
def __init__(self, path, ctype, msg):
1078
InvalidHttpResponse.__init__(self, path, msg)
1081
class ConflictsInTree(BzrError):
1083
_fmt = "Working tree has conflicts."
1086
class ParseConfigError(BzrError):
1088
def __init__(self, errors, filename):
1089
if filename is None:
1091
message = "Error(s) parsing config file %s:\n%s" % \
1092
(filename, ('\n'.join(e.message for e in errors)))
1093
BzrError.__init__(self, message)
1096
class NoEmailInUsername(BzrError):
1098
_fmt = "%(username)r does not seem to contain a reasonable email address"
1100
def __init__(self, username):
1101
BzrError.__init__(self)
1102
self.username = username
1105
class SigningFailed(BzrError):
1107
_fmt = "Failed to gpg sign data with command %(command_line)r"
1109
def __init__(self, command_line):
1110
BzrError.__init__(self, command_line=command_line)
1113
class WorkingTreeNotRevision(BzrError):
1115
_fmt = ("The working tree for %(basedir)s has changed since"
1116
" the last commit, but weave merge requires that it be"
1119
def __init__(self, tree):
1120
BzrError.__init__(self, basedir=tree.basedir)
1123
class CantReprocessAndShowBase(BzrError):
1125
_fmt = "Can't reprocess and show base, because reprocessing obscures " \
1126
"the relationship of conflicting lines to the base"
1129
class GraphCycleError(BzrError):
1131
_fmt = "Cycle in graph %(graph)r"
1133
def __init__(self, graph):
1134
BzrError.__init__(self)
1138
class WritingCompleted(BzrError):
1140
_fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
1141
"called upon it - accept bytes may not be called anymore.")
1143
internal_error = True
1145
def __init__(self, request):
1146
self.request = request
1149
class WritingNotComplete(BzrError):
1151
_fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
1152
"called upon it - until the write phase is complete no "
1153
"data may be read.")
1155
internal_error = True
1157
def __init__(self, request):
1158
self.request = request
1161
class NotConflicted(BzrError):
1163
_fmt = "File %(filename)s is not conflicted."
1165
def __init__(self, filename):
1166
BzrError.__init__(self)
1167
self.filename = filename
1170
class MediumNotConnected(BzrError):
1172
_fmt = """The medium '%(medium)s' is not connected."""
1174
internal_error = True
1176
def __init__(self, medium):
1177
self.medium = medium
1180
class MustUseDecorated(Exception):
1182
_fmt = """A decorating function has requested its original command be used."""
1185
class NoBundleFound(BzrError):
1187
_fmt = "No bundle was found in %(filename)s"
1189
def __init__(self, filename):
1190
BzrError.__init__(self)
1191
self.filename = filename
1194
class BundleNotSupported(BzrError):
1196
_fmt = "Unable to handle bundle version %(version)s: %(msg)s"
1198
def __init__(self, version, msg):
1199
BzrError.__init__(self)
1200
self.version = version
1204
class MissingText(BzrError):
1206
_fmt = "Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"
1208
def __init__(self, branch, text_revision, file_id):
1209
BzrError.__init__(self)
1210
self.branch = branch
1211
self.base = branch.base
1212
self.text_revision = text_revision
1213
self.file_id = file_id
1216
class DuplicateKey(BzrError):
1218
_fmt = "Key %(key)s is already present in map"
1221
class MalformedTransform(BzrError):
1223
_fmt = "Tree transform is malformed %(conflicts)r"
1226
class NoFinalPath(BzrError):
1228
_fmt = ("No final name for trans_id %(trans_id)r\n"
1229
"file-id: %(file_id)r\n"
1230
"root trans-id: %(root_trans_id)r\n")
1232
def __init__(self, trans_id, transform):
1233
self.trans_id = trans_id
1234
self.file_id = transform.final_file_id(trans_id)
1235
self.root_trans_id = transform.root
1238
class BzrBadParameter(BzrError):
1240
_fmt = "Bad parameter: %(param)r"
1242
# This exception should never be thrown, but it is a base class for all
1243
# parameter-to-function errors.
1245
def __init__(self, param):
1246
BzrError.__init__(self)
1250
class BzrBadParameterNotUnicode(BzrBadParameter):
1252
_fmt = "Parameter %(param)s is neither unicode nor utf8."
1255
class ReusingTransform(BzrError):
1257
_fmt = "Attempt to reuse a transform that has already been applied."
1260
class CantMoveRoot(BzrError):
1262
_fmt = "Moving the root directory is not supported at this time"
1265
class BzrBadParameterNotString(BzrBadParameter):
1267
_fmt = "Parameter %(param)s is not a string or unicode string."
1270
class BzrBadParameterMissing(BzrBadParameter):
1272
_fmt = "Parameter $(param)s is required but not present."
1275
class BzrBadParameterUnicode(BzrBadParameter):
1277
_fmt = "Parameter %(param)s is unicode but only byte-strings are permitted."
1280
class BzrBadParameterContainsNewline(BzrBadParameter):
1282
_fmt = "Parameter %(param)s contains a newline."
1285
class DependencyNotPresent(BzrError):
1287
_fmt = 'Unable to import library "%(library)s": %(error)s'
1289
def __init__(self, library, error):
1290
BzrError.__init__(self, library=library, error=error)
1293
class ParamikoNotPresent(DependencyNotPresent):
1295
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
1297
def __init__(self, error):
1298
DependencyNotPresent.__init__(self, 'paramiko', error)
1301
class PointlessMerge(BzrError):
1303
_fmt = "Nothing to merge."
1306
class UninitializableFormat(BzrError):
1308
_fmt = "Format %(format)s cannot be initialised by this version of bzr."
1310
def __init__(self, format):
1311
BzrError.__init__(self)
1312
self.format = format
1315
class BadConversionTarget(BzrError):
1317
_fmt = "Cannot convert to format %(format)s. %(problem)s"
1319
def __init__(self, problem, format):
1320
BzrError.__init__(self)
1321
self.problem = problem
1322
self.format = format
1325
class NoDiff(BzrError):
1327
_fmt = "Diff is not installed on this machine: %(msg)s"
1329
def __init__(self, msg):
1330
BzrError.__init__(self, msg=msg)
1333
class NoDiff3(BzrError):
1335
_fmt = "Diff3 is not installed on this machine."
1338
class ExistingLimbo(BzrError):
1340
_fmt = """This tree contains left-over files from a failed operation.
1341
Please examine %(limbo_dir)s to see if it contains any files you wish to
1342
keep, and delete it when you are done."""
1344
def __init__(self, limbo_dir):
1345
BzrError.__init__(self)
1346
self.limbo_dir = limbo_dir
1349
class ImmortalLimbo(BzrError):
1351
_fmt = """Unable to delete transform temporary directory $(limbo_dir)s.
1352
Please examine %(limbo_dir)s to see if it contains any files you wish to
1353
keep, and delete it when you are done."""
1355
def __init__(self, limbo_dir):
1356
BzrError.__init__(self)
1357
self.limbo_dir = limbo_dir
1360
class OutOfDateTree(BzrError):
1362
_fmt = "Working tree is out of date, please run 'bzr update'."
1364
def __init__(self, tree):
1365
BzrError.__init__(self)
1369
class MergeModifiedFormatError(BzrError):
1371
_fmt = "Error in merge modified format"
1374
class ConflictFormatError(BzrError):
1376
_fmt = "Format error in conflict listings"
1379
class CorruptRepository(BzrError):
1381
_fmt = """An error has been detected in the repository %(repo_path)s.
1382
Please run bzr reconcile on this repository."""
1384
def __init__(self, repo):
1385
BzrError.__init__(self)
1386
self.repo_path = repo.bzrdir.root_transport.base
1389
class UpgradeRequired(BzrError):
1391
_fmt = "To use this feature you must upgrade your branch at %(path)s."
1393
def __init__(self, path):
1394
BzrError.__init__(self)
1398
class LocalRequiresBoundBranch(BzrError):
1400
_fmt = "Cannot perform local-only commits on unbound branches."
1403
class MissingProgressBarFinish(BzrError):
1405
_fmt = "A nested progress bar was not 'finished' correctly."
1408
class InvalidProgressBarType(BzrError):
1410
_fmt = """Environment variable BZR_PROGRESS_BAR='%(bar_type)s is not a supported type
1411
Select one of: %(valid_types)s"""
1413
def __init__(self, bar_type, valid_types):
1414
BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1417
class UnsupportedOperation(BzrError):
1419
_fmt = "The method %(mname)s is not supported on objects of type %(tname)s."
1421
def __init__(self, method, method_self):
1422
self.method = method
1423
self.mname = method.__name__
1424
self.tname = type(method_self).__name__
1427
class BinaryFile(BzrError):
1429
_fmt = "File is binary but should be text."
1432
class IllegalPath(BzrError):
1434
_fmt = "The path %(path)s is not permitted on this platform"
1436
def __init__(self, path):
1437
BzrError.__init__(self)
1441
class TestamentMismatch(BzrError):
1443
_fmt = """Testament did not match expected value.
1444
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1447
def __init__(self, revision_id, expected, measured):
1448
self.revision_id = revision_id
1449
self.expected = expected
1450
self.measured = measured
1453
class NotABundle(BzrError):
1455
_fmt = "Not a bzr revision-bundle: %(text)r"
1457
def __init__(self, text):
1458
BzrError.__init__(self)
1462
class BadBundle(BzrError):
1464
_fmt = "Bad bzr revision-bundle: %(text)r"
1466
def __init__(self, text):
1467
BzrError.__init__(self)
1471
class MalformedHeader(BadBundle):
1473
_fmt = "Malformed bzr revision-bundle header: %(text)r"
1476
class MalformedPatches(BadBundle):
1478
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1481
class MalformedFooter(BadBundle):
1483
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1486
class UnsupportedEOLMarker(BadBundle):
1488
_fmt = "End of line marker was not \\n in bzr revision-bundle"
1491
# XXX: BadBundle's constructor assumes there's explanatory text,
1492
# but for this there is not
1493
BzrError.__init__(self)
1496
class IncompatibleBundleFormat(BzrError):
1498
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
1500
def __init__(self, bundle_format, other):
1501
BzrError.__init__(self)
1502
self.bundle_format = bundle_format
1506
class BadInventoryFormat(BzrError):
1508
_fmt = "Root class for inventory serialization errors"
1511
class UnexpectedInventoryFormat(BadInventoryFormat):
1513
_fmt = "The inventory was not in the expected format:\n %(msg)s"
1515
def __init__(self, msg):
1516
BadInventoryFormat.__init__(self, msg=msg)
1519
class NoSmartMedium(BzrError):
1521
_fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
1523
def __init__(self, transport):
1524
self.transport = transport
1527
class NoSmartServer(NotBranchError):
1529
_fmt = "No smart server available at %(url)s"
1531
def __init__(self, url):
1535
class UnknownSSH(BzrError):
1537
_fmt = "Unrecognised value for BZR_SSH environment variable: %(vendor)s"
1539
def __init__(self, vendor):
1540
BzrError.__init__(self)
1541
self.vendor = vendor
1544
class GhostRevisionUnusableHere(BzrError):
1546
_fmt = "Ghost revision {%(revision_id)s} cannot be used here."
1548
def __init__(self, revision_id):
1549
BzrError.__init__(self)
1550
self.revision_id = revision_id
1553
class IllegalUseOfScopeReplacer(BzrError):
1555
_fmt = "ScopeReplacer object %(name)r was used incorrectly: %(msg)s%(extra)s"
1557
internal_error = True
1559
def __init__(self, name, msg, extra=None):
1560
BzrError.__init__(self)
1564
self.extra = ': ' + str(extra)
1569
class InvalidImportLine(BzrError):
1571
_fmt = "Not a valid import statement: %(msg)\n%(text)s"
1573
internal_error = True
1575
def __init__(self, text, msg):
1576
BzrError.__init__(self)
1581
class ImportNameCollision(BzrError):
1583
_fmt = "Tried to import an object to the same name as an existing object. %(name)s"
1585
internal_error = True
1587
def __init__(self, name):
1588
BzrError.__init__(self)