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 for file %(filename)s"
948
def __init__(self, badline, filename):
949
KnitError.__init__(self)
950
self.badline = badline
951
self.filename = filename
954
class KnitCorrupt(KnitError):
956
_fmt = "Knit %(filename)s corrupt: %(how)s"
958
def __init__(self, filename, how):
959
KnitError.__init__(self)
960
self.filename = filename
964
class NoSuchExportFormat(BzrError):
966
_fmt = "Export format %(format)r not supported"
968
def __init__(self, format):
969
BzrError.__init__(self)
973
class TransportError(BzrError):
975
_fmt = "Transport error: %(msg)s %(orig_error)s"
977
def __init__(self, msg=None, orig_error=None):
978
if msg is None and orig_error is not None:
979
msg = str(orig_error)
980
if orig_error is None:
985
self.orig_error = orig_error
986
BzrError.__init__(self)
989
class TooManyConcurrentRequests(BzrError):
991
_fmt = ("The medium '%(medium)s' has reached its concurrent request limit. "
992
"Be sure to finish_writing and finish_reading on the "
993
"current request that is open.")
995
internal_error = True
997
def __init__(self, medium):
1001
class SmartProtocolError(TransportError):
1003
_fmt = "Generic bzr smart protocol error: %(details)s"
1005
def __init__(self, details):
1006
self.details = details
1009
# A set of semi-meaningful errors which can be thrown
1010
class TransportNotPossible(TransportError):
1012
_fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
1015
class ConnectionError(TransportError):
1017
_fmt = "Connection error: %(msg)s %(orig_error)s"
1020
class SocketConnectionError(ConnectionError):
1022
_fmt = "%(msg)s %(host)s%(port)s%(orig_error)s"
1024
def __init__(self, host, port=None, msg=None, orig_error=None):
1026
msg = 'Failed to connect to'
1027
if orig_error is None:
1030
orig_error = '; ' + str(orig_error)
1031
ConnectionError.__init__(self, msg=msg, orig_error=orig_error)
1036
self.port = ':%s' % port
1039
class ConnectionReset(TransportError):
1041
_fmt = "Connection closed: %(msg)s %(orig_error)s"
1044
class InvalidRange(TransportError):
1046
_fmt = "Invalid range access in %(path)s at %(offset)s."
1048
def __init__(self, path, offset):
1049
TransportError.__init__(self, ("Invalid range access in %s at %d"
1052
self.offset = offset
1055
class InvalidHttpResponse(TransportError):
1057
_fmt = "Invalid http response for %(path)s: %(msg)s"
1059
def __init__(self, path, msg, orig_error=None):
1061
TransportError.__init__(self, msg, orig_error=orig_error)
1064
class InvalidHttpRange(InvalidHttpResponse):
1066
_fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
1068
def __init__(self, path, range, msg):
1070
InvalidHttpResponse.__init__(self, path, msg)
1073
class InvalidHttpContentType(InvalidHttpResponse):
1075
_fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1077
def __init__(self, path, ctype, msg):
1079
InvalidHttpResponse.__init__(self, path, msg)
1082
class ConflictsInTree(BzrError):
1084
_fmt = "Working tree has conflicts."
1087
class ParseConfigError(BzrError):
1089
def __init__(self, errors, filename):
1090
if filename is None:
1092
message = "Error(s) parsing config file %s:\n%s" % \
1093
(filename, ('\n'.join(e.message for e in errors)))
1094
BzrError.__init__(self, message)
1097
class NoEmailInUsername(BzrError):
1099
_fmt = "%(username)r does not seem to contain a reasonable email address"
1101
def __init__(self, username):
1102
BzrError.__init__(self)
1103
self.username = username
1106
class SigningFailed(BzrError):
1108
_fmt = "Failed to gpg sign data with command %(command_line)r"
1110
def __init__(self, command_line):
1111
BzrError.__init__(self, command_line=command_line)
1114
class WorkingTreeNotRevision(BzrError):
1116
_fmt = ("The working tree for %(basedir)s has changed since"
1117
" the last commit, but weave merge requires that it be"
1120
def __init__(self, tree):
1121
BzrError.__init__(self, basedir=tree.basedir)
1124
class CantReprocessAndShowBase(BzrError):
1126
_fmt = "Can't reprocess and show base, because reprocessing obscures " \
1127
"the relationship of conflicting lines to the base"
1130
class GraphCycleError(BzrError):
1132
_fmt = "Cycle in graph %(graph)r"
1134
def __init__(self, graph):
1135
BzrError.__init__(self)
1139
class WritingCompleted(BzrError):
1141
_fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
1142
"called upon it - accept bytes may not be called anymore.")
1144
internal_error = True
1146
def __init__(self, request):
1147
self.request = request
1150
class WritingNotComplete(BzrError):
1152
_fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
1153
"called upon it - until the write phase is complete no "
1154
"data may be read.")
1156
internal_error = True
1158
def __init__(self, request):
1159
self.request = request
1162
class NotConflicted(BzrError):
1164
_fmt = "File %(filename)s is not conflicted."
1166
def __init__(self, filename):
1167
BzrError.__init__(self)
1168
self.filename = filename
1171
class MediumNotConnected(BzrError):
1173
_fmt = """The medium '%(medium)s' is not connected."""
1175
internal_error = True
1177
def __init__(self, medium):
1178
self.medium = medium
1181
class MustUseDecorated(Exception):
1183
_fmt = """A decorating function has requested its original command be used."""
1186
class NoBundleFound(BzrError):
1188
_fmt = "No bundle was found in %(filename)s"
1190
def __init__(self, filename):
1191
BzrError.__init__(self)
1192
self.filename = filename
1195
class BundleNotSupported(BzrError):
1197
_fmt = "Unable to handle bundle version %(version)s: %(msg)s"
1199
def __init__(self, version, msg):
1200
BzrError.__init__(self)
1201
self.version = version
1205
class MissingText(BzrError):
1207
_fmt = "Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"
1209
def __init__(self, branch, text_revision, file_id):
1210
BzrError.__init__(self)
1211
self.branch = branch
1212
self.base = branch.base
1213
self.text_revision = text_revision
1214
self.file_id = file_id
1217
class DuplicateKey(BzrError):
1219
_fmt = "Key %(key)s is already present in map"
1222
class MalformedTransform(BzrError):
1224
_fmt = "Tree transform is malformed %(conflicts)r"
1227
class NoFinalPath(BzrError):
1229
_fmt = ("No final name for trans_id %(trans_id)r\n"
1230
"file-id: %(file_id)r\n"
1231
"root trans-id: %(root_trans_id)r\n")
1233
def __init__(self, trans_id, transform):
1234
self.trans_id = trans_id
1235
self.file_id = transform.final_file_id(trans_id)
1236
self.root_trans_id = transform.root
1239
class BzrBadParameter(BzrError):
1241
_fmt = "Bad parameter: %(param)r"
1243
# This exception should never be thrown, but it is a base class for all
1244
# parameter-to-function errors.
1246
def __init__(self, param):
1247
BzrError.__init__(self)
1251
class BzrBadParameterNotUnicode(BzrBadParameter):
1253
_fmt = "Parameter %(param)s is neither unicode nor utf8."
1256
class ReusingTransform(BzrError):
1258
_fmt = "Attempt to reuse a transform that has already been applied."
1261
class CantMoveRoot(BzrError):
1263
_fmt = "Moving the root directory is not supported at this time"
1266
class BzrBadParameterNotString(BzrBadParameter):
1268
_fmt = "Parameter %(param)s is not a string or unicode string."
1271
class BzrBadParameterMissing(BzrBadParameter):
1273
_fmt = "Parameter $(param)s is required but not present."
1276
class BzrBadParameterUnicode(BzrBadParameter):
1278
_fmt = "Parameter %(param)s is unicode but only byte-strings are permitted."
1281
class BzrBadParameterContainsNewline(BzrBadParameter):
1283
_fmt = "Parameter %(param)s contains a newline."
1286
class DependencyNotPresent(BzrError):
1288
_fmt = 'Unable to import library "%(library)s": %(error)s'
1290
def __init__(self, library, error):
1291
BzrError.__init__(self, library=library, error=error)
1294
class ParamikoNotPresent(DependencyNotPresent):
1296
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
1298
def __init__(self, error):
1299
DependencyNotPresent.__init__(self, 'paramiko', error)
1302
class PointlessMerge(BzrError):
1304
_fmt = "Nothing to merge."
1307
class UninitializableFormat(BzrError):
1309
_fmt = "Format %(format)s cannot be initialised by this version of bzr."
1311
def __init__(self, format):
1312
BzrError.__init__(self)
1313
self.format = format
1316
class BadConversionTarget(BzrError):
1318
_fmt = "Cannot convert to format %(format)s. %(problem)s"
1320
def __init__(self, problem, format):
1321
BzrError.__init__(self)
1322
self.problem = problem
1323
self.format = format
1326
class NoDiff(BzrError):
1328
_fmt = "Diff is not installed on this machine: %(msg)s"
1330
def __init__(self, msg):
1331
BzrError.__init__(self, msg=msg)
1334
class NoDiff3(BzrError):
1336
_fmt = "Diff3 is not installed on this machine."
1339
class ExistingLimbo(BzrError):
1341
_fmt = """This tree contains left-over files from a failed operation.
1342
Please examine %(limbo_dir)s to see if it contains any files you wish to
1343
keep, and delete it when you are done."""
1345
def __init__(self, limbo_dir):
1346
BzrError.__init__(self)
1347
self.limbo_dir = limbo_dir
1350
class ImmortalLimbo(BzrError):
1352
_fmt = """Unable to delete transform temporary directory $(limbo_dir)s.
1353
Please examine %(limbo_dir)s to see if it contains any files you wish to
1354
keep, and delete it when you are done."""
1356
def __init__(self, limbo_dir):
1357
BzrError.__init__(self)
1358
self.limbo_dir = limbo_dir
1361
class OutOfDateTree(BzrError):
1363
_fmt = "Working tree is out of date, please run 'bzr update'."
1365
def __init__(self, tree):
1366
BzrError.__init__(self)
1370
class MergeModifiedFormatError(BzrError):
1372
_fmt = "Error in merge modified format"
1375
class ConflictFormatError(BzrError):
1377
_fmt = "Format error in conflict listings"
1380
class CorruptRepository(BzrError):
1382
_fmt = """An error has been detected in the repository %(repo_path)s.
1383
Please run bzr reconcile on this repository."""
1385
def __init__(self, repo):
1386
BzrError.__init__(self)
1387
self.repo_path = repo.bzrdir.root_transport.base
1390
class UpgradeRequired(BzrError):
1392
_fmt = "To use this feature you must upgrade your branch at %(path)s."
1394
def __init__(self, path):
1395
BzrError.__init__(self)
1399
class LocalRequiresBoundBranch(BzrError):
1401
_fmt = "Cannot perform local-only commits on unbound branches."
1404
class MissingProgressBarFinish(BzrError):
1406
_fmt = "A nested progress bar was not 'finished' correctly."
1409
class InvalidProgressBarType(BzrError):
1411
_fmt = """Environment variable BZR_PROGRESS_BAR='%(bar_type)s is not a supported type
1412
Select one of: %(valid_types)s"""
1414
def __init__(self, bar_type, valid_types):
1415
BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1418
class UnsupportedOperation(BzrError):
1420
_fmt = "The method %(mname)s is not supported on objects of type %(tname)s."
1422
def __init__(self, method, method_self):
1423
self.method = method
1424
self.mname = method.__name__
1425
self.tname = type(method_self).__name__
1428
class CannotSetRevisionId(UnsupportedOperation):
1429
"""Raised when a commit is attempting to set a revision id but cant."""
1432
class NonAsciiRevisionId(UnsupportedOperation):
1433
"""Raised when a commit is attempting to set a non-ascii revision id but cant."""
1436
class BinaryFile(BzrError):
1438
_fmt = "File is binary but should be text."
1441
class IllegalPath(BzrError):
1443
_fmt = "The path %(path)s is not permitted on this platform"
1445
def __init__(self, path):
1446
BzrError.__init__(self)
1450
class TestamentMismatch(BzrError):
1452
_fmt = """Testament did not match expected value.
1453
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1456
def __init__(self, revision_id, expected, measured):
1457
self.revision_id = revision_id
1458
self.expected = expected
1459
self.measured = measured
1462
class NotABundle(BzrError):
1464
_fmt = "Not a bzr revision-bundle: %(text)r"
1466
def __init__(self, text):
1467
BzrError.__init__(self)
1471
class BadBundle(BzrError):
1473
_fmt = "Bad bzr revision-bundle: %(text)r"
1475
def __init__(self, text):
1476
BzrError.__init__(self)
1480
class MalformedHeader(BadBundle):
1482
_fmt = "Malformed bzr revision-bundle header: %(text)r"
1485
class MalformedPatches(BadBundle):
1487
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1490
class MalformedFooter(BadBundle):
1492
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1495
class UnsupportedEOLMarker(BadBundle):
1497
_fmt = "End of line marker was not \\n in bzr revision-bundle"
1500
# XXX: BadBundle's constructor assumes there's explanatory text,
1501
# but for this there is not
1502
BzrError.__init__(self)
1505
class IncompatibleBundleFormat(BzrError):
1507
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
1509
def __init__(self, bundle_format, other):
1510
BzrError.__init__(self)
1511
self.bundle_format = bundle_format
1515
class BadInventoryFormat(BzrError):
1517
_fmt = "Root class for inventory serialization errors"
1520
class UnexpectedInventoryFormat(BadInventoryFormat):
1522
_fmt = "The inventory was not in the expected format:\n %(msg)s"
1524
def __init__(self, msg):
1525
BadInventoryFormat.__init__(self, msg=msg)
1528
class NoSmartMedium(BzrError):
1530
_fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
1532
def __init__(self, transport):
1533
self.transport = transport
1536
class NoSmartServer(NotBranchError):
1538
_fmt = "No smart server available at %(url)s"
1540
def __init__(self, url):
1544
class UnknownSSH(BzrError):
1546
_fmt = "Unrecognised value for BZR_SSH environment variable: %(vendor)s"
1548
def __init__(self, vendor):
1549
BzrError.__init__(self)
1550
self.vendor = vendor
1553
class GhostRevisionUnusableHere(BzrError):
1555
_fmt = "Ghost revision {%(revision_id)s} cannot be used here."
1557
def __init__(self, revision_id):
1558
BzrError.__init__(self)
1559
self.revision_id = revision_id
1562
class IllegalUseOfScopeReplacer(BzrError):
1564
_fmt = "ScopeReplacer object %(name)r was used incorrectly: %(msg)s%(extra)s"
1566
internal_error = True
1568
def __init__(self, name, msg, extra=None):
1569
BzrError.__init__(self)
1573
self.extra = ': ' + str(extra)
1578
class InvalidImportLine(BzrError):
1580
_fmt = "Not a valid import statement: %(msg)\n%(text)s"
1582
internal_error = True
1584
def __init__(self, text, msg):
1585
BzrError.__init__(self)
1590
class ImportNameCollision(BzrError):
1592
_fmt = "Tried to import an object to the same name as an existing object. %(name)s"
1594
internal_error = True
1596
def __init__(self, name):
1597
BzrError.__init__(self)