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 InvalidEntryName(BzrError):
174
_fmt = "Invalid entry name: %(name)s"
176
internal_error = True
178
def __init__(self, name):
179
BzrError.__init__(self)
183
class InvalidRevisionNumber(BzrError):
185
_fmt = "Invalid revision number %(revno)s"
187
def __init__(self, revno):
188
BzrError.__init__(self)
192
class InvalidRevisionId(BzrError):
194
_fmt = "Invalid revision-id {%(revision_id)s} in %(branch)s"
196
def __init__(self, revision_id, branch):
197
# branch can be any string or object with __str__ defined
198
BzrError.__init__(self)
199
self.revision_id = revision_id
202
class ReservedId(BzrError):
204
_fmt = "Reserved revision-id {%(revision_id)s}"
206
def __init__(self, revision_id):
207
self.revision_id = revision_id
209
class NoSuchId(BzrError):
211
_fmt = "The file id %(file_id)s is not present in the tree %(tree)s."
213
def __init__(self, tree, file_id):
214
BzrError.__init__(self)
215
self.file_id = file_id
219
class InventoryModified(BzrError):
221
_fmt = ("The current inventory for the tree %(tree)r has been modified, "
222
"so a clean inventory cannot be read without data loss.")
224
internal_error = True
226
def __init__(self, tree):
230
class NoWorkingTree(BzrError):
232
_fmt = "No WorkingTree exists for %(base)s."
234
def __init__(self, base):
235
BzrError.__init__(self)
239
class NotBuilding(BzrError):
241
_fmt = "Not currently building a tree."
244
class NotLocalUrl(BzrError):
246
_fmt = "%(url)s is not a local path."
248
def __init__(self, url):
252
class WorkingTreeAlreadyPopulated(BzrError):
254
_fmt = """Working tree already populated in %(base)s"""
256
internal_error = True
258
def __init__(self, base):
261
class BzrCommandError(BzrError):
262
"""Error from user command"""
264
internal_error = False
266
# Error from malformed user command; please avoid raising this as a
267
# generic exception not caused by user input.
269
# I think it's a waste of effort to differentiate between errors that
270
# are not intended to be caught anyway. UI code need not subclass
271
# BzrCommandError, and non-UI code should not throw a subclass of
272
# BzrCommandError. ADHB 20051211
273
def __init__(self, msg):
274
# Object.__str__() must return a real string
275
# returning a Unicode string is a python error.
276
if isinstance(msg, unicode):
277
self.msg = msg.encode('utf8')
285
class NotWriteLocked(BzrError):
287
_fmt = """%(not_locked)r is not write locked but needs to be."""
289
def __init__(self, not_locked):
290
self.not_locked = not_locked
293
class BzrOptionError(BzrCommandError):
295
_fmt = "Error in command line options"
298
class StrictCommitFailed(BzrError):
300
_fmt = "Commit refused because there are unknown files in the tree"
303
# XXX: Should be unified with TransportError; they seem to represent the
305
class PathError(BzrError):
307
_fmt = "Generic path error: %(path)r%(extra)s)"
309
def __init__(self, path, extra=None):
310
BzrError.__init__(self)
313
self.extra = ': ' + str(extra)
318
class NoSuchFile(PathError):
320
_fmt = "No such file: %(path)r%(extra)s"
323
class FileExists(PathError):
325
_fmt = "File exists: %(path)r%(extra)s"
328
class DirectoryNotEmpty(PathError):
330
_fmt = "Directory not empty: %(path)r%(extra)s"
333
class ReadingCompleted(BzrError):
335
_fmt = ("The MediumRequest '%(request)s' has already had finish_reading "
336
"called upon it - the request has been completed and no more "
339
internal_error = True
341
def __init__(self, request):
342
self.request = request
345
class ResourceBusy(PathError):
347
_fmt = "Device or resource busy: %(path)r%(extra)s"
350
class PermissionDenied(PathError):
352
_fmt = "Permission denied: %(path)r%(extra)s"
355
class InvalidURL(PathError):
357
_fmt = "Invalid url supplied to transport: %(path)r%(extra)s"
360
class InvalidURLJoin(PathError):
362
_fmt = "Invalid URL join request: %(args)s%(extra)s"
364
def __init__(self, msg, base, args):
365
PathError.__init__(self, base, msg)
366
self.args = [base] + list(args)
369
class UnsupportedProtocol(PathError):
371
_fmt = 'Unsupported protocol for url "%(path)s"%(extra)s'
373
def __init__(self, url, extra):
374
PathError.__init__(self, url, extra=extra)
377
class ShortReadvError(PathError):
379
_fmt = "readv() read %(actual)s bytes rather than %(length)s bytes at %(offset)s for %(path)s%(extra)s"
381
internal_error = True
383
def __init__(self, path, offset, length, actual, extra=None):
384
PathError.__init__(self, path, extra=extra)
390
class PathNotChild(BzrError):
392
_fmt = "Path %(path)r is not a child of path %(base)r%(extra)s"
394
internal_error = True
396
def __init__(self, path, base, extra=None):
397
BzrError.__init__(self)
401
self.extra = ': ' + str(extra)
406
class InvalidNormalization(PathError):
408
_fmt = "Path %(path)r is not unicode normalized"
411
# TODO: This is given a URL; we try to unescape it but doing that from inside
412
# the exception object is a bit undesirable.
413
# TODO: Probably this behavior of should be a common superclass
414
class NotBranchError(PathError):
416
_fmt = "Not a branch: %(path)s"
418
def __init__(self, path):
419
import bzrlib.urlutils as urlutils
420
self.path = urlutils.unescape_for_display(path, 'ascii')
423
class AlreadyBranchError(PathError):
425
_fmt = "Already a branch: %(path)s."
428
class BranchExistsWithoutWorkingTree(PathError):
430
_fmt = "Directory contains a branch, but no working tree \
431
(use bzr checkout if you wish to build a working tree): %(path)s"
434
class AtomicFileAlreadyClosed(PathError):
436
_fmt = "'%(function)s' called on an AtomicFile after it was closed: %(path)s"
438
def __init__(self, path, function):
439
PathError.__init__(self, path=path, extra=None)
440
self.function = function
443
class InaccessibleParent(PathError):
445
_fmt = "Parent not accessible given base %(base)s and relative path %(path)s"
447
def __init__(self, path, base):
448
PathError.__init__(self, path)
452
class NoRepositoryPresent(BzrError):
454
_fmt = "No repository present: %(path)r"
455
def __init__(self, bzrdir):
456
BzrError.__init__(self)
457
self.path = bzrdir.transport.clone('..').base
460
class FileInWrongBranch(BzrError):
462
_fmt = "File %(path)s in not in branch %(branch_base)s."
464
def __init__(self, branch, path):
465
BzrError.__init__(self)
467
self.branch_base = branch.base
471
class UnsupportedFormatError(BzrError):
473
_fmt = "Unsupported branch format: %(format)s"
476
class UnknownFormatError(BzrError):
478
_fmt = "Unknown branch format: %(format)r"
481
class IncompatibleFormat(BzrError):
483
_fmt = "Format %(format)s is not compatible with .bzr version %(bzrdir)s."
485
def __init__(self, format, bzrdir_format):
486
BzrError.__init__(self)
488
self.bzrdir = bzrdir_format
491
class IncompatibleRevision(BzrError):
493
_fmt = "Revision is not compatible with %(repo_format)s"
495
def __init__(self, repo_format):
496
BzrError.__init__(self)
497
self.repo_format = repo_format
500
class NotVersionedError(BzrError):
502
_fmt = "%(path)s is not versioned"
504
def __init__(self, path):
505
BzrError.__init__(self)
509
class PathsNotVersionedError(BzrError):
510
# used when reporting several paths are not versioned
512
_fmt = "Path(s) are not versioned: %(paths_as_string)s"
514
def __init__(self, paths):
515
from bzrlib.osutils import quotefn
516
BzrError.__init__(self)
518
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
521
class PathsDoNotExist(BzrError):
523
_fmt = "Path(s) do not exist: %(paths_as_string)s"
525
# used when reporting that paths are neither versioned nor in the working
528
def __init__(self, paths):
530
from bzrlib.osutils import quotefn
531
BzrError.__init__(self)
533
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
536
class BadFileKindError(BzrError):
538
_fmt = "Cannot operate on %(filename)s of unsupported kind %(kind)s"
541
class ForbiddenControlFileError(BzrError):
543
_fmt = "Cannot operate on %(filename)s because it is a control file"
546
class LockError(BzrError):
548
_fmt = "Lock error: %(message)s"
550
internal_error = True
552
# All exceptions from the lock/unlock functions should be from
553
# this exception class. They will be translated as necessary. The
554
# original exception is available as e.original_error
556
# New code should prefer to raise specific subclasses
557
def __init__(self, message):
558
self.message = message
561
class CommitNotPossible(LockError):
563
_fmt = "A commit was attempted but we do not have a write lock open."
569
class AlreadyCommitted(LockError):
571
_fmt = "A rollback was requested, but is not able to be accomplished."
577
class ReadOnlyError(LockError):
579
_fmt = "A write attempt was made in a read only transaction on %(obj)s"
581
def __init__(self, obj):
585
class OutSideTransaction(BzrError):
587
_fmt = "A transaction related operation was attempted after the transaction finished."
590
class ObjectNotLocked(LockError):
592
_fmt = "%(obj)r is not locked"
594
# this can indicate that any particular object is not locked; see also
595
# LockNotHeld which means that a particular *lock* object is not held by
596
# the caller -- perhaps they should be unified.
597
def __init__(self, obj):
601
class ReadOnlyObjectDirtiedError(ReadOnlyError):
603
_fmt = "Cannot change object %(obj)r in read only transaction"
605
def __init__(self, obj):
609
class UnlockableTransport(LockError):
611
_fmt = "Cannot lock: transport is read only: %(transport)s"
613
def __init__(self, transport):
614
self.transport = transport
617
class LockContention(LockError):
619
_fmt = "Could not acquire lock %(lock)s"
620
# TODO: show full url for lock, combining the transport and relative
623
internal_error = False
625
def __init__(self, lock):
629
class LockBroken(LockError):
631
_fmt = "Lock was broken while still open: %(lock)s - check storage consistency!"
633
internal_error = False
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
internal_error = False
645
def __init__(self, lock, holder, target):
651
class LockNotHeld(LockError):
653
_fmt = "Lock not held: %(lock)s"
655
internal_error = False
657
def __init__(self, lock):
661
class PointlessCommit(BzrError):
663
_fmt = "No changes to commit"
666
class UpgradeReadonly(BzrError):
668
_fmt = "Upgrade URL cannot work with readonly URLs."
671
class UpToDateFormat(BzrError):
673
_fmt = "The branch format %(format)s is already at the most recent format."
675
def __init__(self, format):
676
BzrError.__init__(self)
680
class StrictCommitFailed(Exception):
682
_fmt = "Commit refused because there are unknowns in the tree."
685
class NoSuchRevision(BzrError):
687
_fmt = "Branch %(branch)s has no revision %(revision)s"
689
internal_error = True
691
def __init__(self, branch, revision):
692
BzrError.__init__(self, branch=branch, revision=revision)
695
class NoSuchRevisionSpec(BzrError):
697
_fmt = "No namespace registered for string: %(spec)r"
699
def __init__(self, spec):
700
BzrError.__init__(self, spec=spec)
703
class InvalidRevisionSpec(BzrError):
705
_fmt = "Requested revision: %(spec)r does not exist in branch: %(branch)s%(extra)s"
707
def __init__(self, spec, branch, extra=None):
708
BzrError.__init__(self, branch=branch, spec=spec)
710
self.extra = '\n' + str(extra)
715
class HistoryMissing(BzrError):
717
_fmt = "%(branch)s is missing %(object_type)s {%(object_id)s}"
720
class DivergedBranches(BzrError):
722
_fmt = "These branches have diverged. Use the merge command to reconcile them."""
724
internal_error = False
726
def __init__(self, branch1, branch2):
727
self.branch1 = branch1
728
self.branch2 = branch2
731
class UnrelatedBranches(BzrError):
733
_fmt = "Branches have no common ancestor, and no merge base revision was specified."
735
internal_error = False
738
class NoCommonAncestor(BzrError):
740
_fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
742
def __init__(self, revision_a, revision_b):
743
self.revision_a = revision_a
744
self.revision_b = revision_b
747
class NoCommonRoot(BzrError):
749
_fmt = "Revisions are not derived from the same root: " \
750
"%(revision_a)s %(revision_b)s."
752
def __init__(self, revision_a, revision_b):
753
BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
756
class NotAncestor(BzrError):
758
_fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
760
def __init__(self, rev_id, not_ancestor_id):
761
BzrError.__init__(self, rev_id=rev_id,
762
not_ancestor_id=not_ancestor_id)
765
class InstallFailed(BzrError):
767
def __init__(self, revisions):
768
revision_str = ", ".join(str(r) for r in revisions)
769
msg = "Could not install revisions:\n%s" % revision_str
770
BzrError.__init__(self, msg)
771
self.revisions = revisions
774
class AmbiguousBase(BzrError):
776
def __init__(self, bases):
777
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
779
msg = "The correct base is unclear, because %s are all equally close" %\
781
BzrError.__init__(self, msg)
785
class NoCommits(BzrError):
787
_fmt = "Branch %(branch)s has no commits."
789
def __init__(self, branch):
790
BzrError.__init__(self, branch=branch)
793
class UnlistableStore(BzrError):
795
def __init__(self, store):
796
BzrError.__init__(self, "Store %s is not listable" % store)
800
class UnlistableBranch(BzrError):
802
def __init__(self, br):
803
BzrError.__init__(self, "Stores for branch %s are not listable" % br)
806
class BoundBranchOutOfDate(BzrError):
808
_fmt = "Bound branch %(branch)s is out of date with master branch %(master)s."
810
def __init__(self, branch, master):
811
BzrError.__init__(self)
816
class CommitToDoubleBoundBranch(BzrError):
818
_fmt = "Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."
820
def __init__(self, branch, master, remote):
821
BzrError.__init__(self)
827
class OverwriteBoundBranch(BzrError):
829
_fmt = "Cannot pull --overwrite to a branch which is bound %(branch)s"
831
def __init__(self, branch):
832
BzrError.__init__(self)
836
class BoundBranchConnectionFailure(BzrError):
838
_fmt = "Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"
840
def __init__(self, branch, target, error):
841
BzrError.__init__(self)
847
class WeaveError(BzrError):
849
_fmt = "Error in processing weave: %(message)s"
851
def __init__(self, message=None):
852
BzrError.__init__(self)
853
self.message = message
856
class WeaveRevisionAlreadyPresent(WeaveError):
858
_fmt = "Revision {%(revision_id)s} already present in %(weave)s"
860
def __init__(self, revision_id, weave):
862
WeaveError.__init__(self)
863
self.revision_id = revision_id
867
class WeaveRevisionNotPresent(WeaveError):
869
_fmt = "Revision {%(revision_id)s} not present in %(weave)s"
871
def __init__(self, revision_id, weave):
872
WeaveError.__init__(self)
873
self.revision_id = revision_id
877
class WeaveFormatError(WeaveError):
879
_fmt = "Weave invariant violated: %(what)s"
881
def __init__(self, what):
882
WeaveError.__init__(self)
886
class WeaveParentMismatch(WeaveError):
888
_fmt = "Parents are mismatched between two revisions."
891
class WeaveInvalidChecksum(WeaveError):
893
_fmt = "Text did not match it's checksum: %(message)s"
896
class WeaveTextDiffers(WeaveError):
898
_fmt = "Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"
900
def __init__(self, revision_id, weave_a, weave_b):
901
WeaveError.__init__(self)
902
self.revision_id = revision_id
903
self.weave_a = weave_a
904
self.weave_b = weave_b
907
class WeaveTextDiffers(WeaveError):
909
_fmt = "Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"
911
def __init__(self, revision_id, weave_a, weave_b):
912
WeaveError.__init__(self)
913
self.revision_id = revision_id
914
self.weave_a = weave_a
915
self.weave_b = weave_b
918
class VersionedFileError(BzrError):
920
_fmt = "Versioned file error"
923
class RevisionNotPresent(VersionedFileError):
925
_fmt = "Revision {%(revision_id)s} not present in %(file_id)s."
927
def __init__(self, revision_id, file_id):
928
VersionedFileError.__init__(self)
929
self.revision_id = revision_id
930
self.file_id = file_id
933
class RevisionAlreadyPresent(VersionedFileError):
935
_fmt = "Revision {%(revision_id)s} already present in %(file_id)s."
937
def __init__(self, revision_id, file_id):
938
VersionedFileError.__init__(self)
939
self.revision_id = revision_id
940
self.file_id = file_id
943
class KnitError(BzrError):
947
internal_error = True
950
class KnitHeaderError(KnitError):
952
_fmt = "Knit header error: %(badline)r unexpected for file %(filename)s"
954
def __init__(self, badline, filename):
955
KnitError.__init__(self)
956
self.badline = badline
957
self.filename = filename
960
class KnitCorrupt(KnitError):
962
_fmt = "Knit %(filename)s corrupt: %(how)s"
964
def __init__(self, filename, how):
965
KnitError.__init__(self)
966
self.filename = filename
970
class KnitIndexUnknownMethod(KnitError):
971
"""Raised when we don't understand the storage method.
973
Currently only 'fulltext' and 'line-delta' are supported.
976
_fmt = ("Knit index %(filename)s does not have a known method"
977
" in options: %(options)r")
979
def __init__(self, filename, options):
980
KnitError.__init__(self)
981
self.filename = filename
982
self.options = options
985
class NoSuchExportFormat(BzrError):
987
_fmt = "Export format %(format)r not supported"
989
def __init__(self, format):
990
BzrError.__init__(self)
994
class TransportError(BzrError):
996
_fmt = "Transport error: %(msg)s %(orig_error)s"
998
def __init__(self, msg=None, orig_error=None):
999
if msg is None and orig_error is not None:
1000
msg = str(orig_error)
1001
if orig_error is None:
1006
self.orig_error = orig_error
1007
BzrError.__init__(self)
1010
class TooManyConcurrentRequests(BzrError):
1012
_fmt = ("The medium '%(medium)s' has reached its concurrent request limit. "
1013
"Be sure to finish_writing and finish_reading on the "
1014
"current request that is open.")
1016
internal_error = True
1018
def __init__(self, medium):
1019
self.medium = medium
1022
class SmartProtocolError(TransportError):
1024
_fmt = "Generic bzr smart protocol error: %(details)s"
1026
def __init__(self, details):
1027
self.details = details
1030
# A set of semi-meaningful errors which can be thrown
1031
class TransportNotPossible(TransportError):
1033
_fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
1036
class ConnectionError(TransportError):
1038
_fmt = "Connection error: %(msg)s %(orig_error)s"
1041
class SocketConnectionError(ConnectionError):
1043
_fmt = "%(msg)s %(host)s%(port)s%(orig_error)s"
1045
def __init__(self, host, port=None, msg=None, orig_error=None):
1047
msg = 'Failed to connect to'
1048
if orig_error is None:
1051
orig_error = '; ' + str(orig_error)
1052
ConnectionError.__init__(self, msg=msg, orig_error=orig_error)
1057
self.port = ':%s' % port
1060
class ConnectionReset(TransportError):
1062
_fmt = "Connection closed: %(msg)s %(orig_error)s"
1065
class InvalidRange(TransportError):
1067
_fmt = "Invalid range access in %(path)s at %(offset)s."
1069
def __init__(self, path, offset):
1070
TransportError.__init__(self, ("Invalid range access in %s at %d"
1073
self.offset = offset
1076
class InvalidHttpResponse(TransportError):
1078
_fmt = "Invalid http response for %(path)s: %(msg)s"
1080
def __init__(self, path, msg, orig_error=None):
1082
TransportError.__init__(self, msg, orig_error=orig_error)
1085
class InvalidHttpRange(InvalidHttpResponse):
1087
_fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
1089
def __init__(self, path, range, msg):
1091
InvalidHttpResponse.__init__(self, path, msg)
1094
class InvalidHttpContentType(InvalidHttpResponse):
1096
_fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1098
def __init__(self, path, ctype, msg):
1100
InvalidHttpResponse.__init__(self, path, msg)
1103
class ConflictsInTree(BzrError):
1105
_fmt = "Working tree has conflicts."
1108
class ParseConfigError(BzrError):
1110
def __init__(self, errors, filename):
1111
if filename is None:
1113
message = "Error(s) parsing config file %s:\n%s" % \
1114
(filename, ('\n'.join(e.message for e in errors)))
1115
BzrError.__init__(self, message)
1118
class NoEmailInUsername(BzrError):
1120
_fmt = "%(username)r does not seem to contain a reasonable email address"
1122
def __init__(self, username):
1123
BzrError.__init__(self)
1124
self.username = username
1127
class SigningFailed(BzrError):
1129
_fmt = "Failed to gpg sign data with command %(command_line)r"
1131
def __init__(self, command_line):
1132
BzrError.__init__(self, command_line=command_line)
1135
class WorkingTreeNotRevision(BzrError):
1137
_fmt = ("The working tree for %(basedir)s has changed since"
1138
" the last commit, but weave merge requires that it be"
1141
def __init__(self, tree):
1142
BzrError.__init__(self, basedir=tree.basedir)
1145
class CantReprocessAndShowBase(BzrError):
1147
_fmt = "Can't reprocess and show base, because reprocessing obscures " \
1148
"the relationship of conflicting lines to the base"
1151
class GraphCycleError(BzrError):
1153
_fmt = "Cycle in graph %(graph)r"
1155
def __init__(self, graph):
1156
BzrError.__init__(self)
1160
class WritingCompleted(BzrError):
1162
_fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
1163
"called upon it - accept bytes may not be called anymore.")
1165
internal_error = True
1167
def __init__(self, request):
1168
self.request = request
1171
class WritingNotComplete(BzrError):
1173
_fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
1174
"called upon it - until the write phase is complete no "
1175
"data may be read.")
1177
internal_error = True
1179
def __init__(self, request):
1180
self.request = request
1183
class NotConflicted(BzrError):
1185
_fmt = "File %(filename)s is not conflicted."
1187
def __init__(self, filename):
1188
BzrError.__init__(self)
1189
self.filename = filename
1192
class MediumNotConnected(BzrError):
1194
_fmt = """The medium '%(medium)s' is not connected."""
1196
internal_error = True
1198
def __init__(self, medium):
1199
self.medium = medium
1202
class MustUseDecorated(Exception):
1204
_fmt = """A decorating function has requested its original command be used."""
1207
class NoBundleFound(BzrError):
1209
_fmt = "No bundle was found in %(filename)s"
1211
def __init__(self, filename):
1212
BzrError.__init__(self)
1213
self.filename = filename
1216
class BundleNotSupported(BzrError):
1218
_fmt = "Unable to handle bundle version %(version)s: %(msg)s"
1220
def __init__(self, version, msg):
1221
BzrError.__init__(self)
1222
self.version = version
1226
class MissingText(BzrError):
1228
_fmt = "Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"
1230
def __init__(self, branch, text_revision, file_id):
1231
BzrError.__init__(self)
1232
self.branch = branch
1233
self.base = branch.base
1234
self.text_revision = text_revision
1235
self.file_id = file_id
1238
class DuplicateKey(BzrError):
1240
_fmt = "Key %(key)s is already present in map"
1243
class MalformedTransform(BzrError):
1245
_fmt = "Tree transform is malformed %(conflicts)r"
1248
class NoFinalPath(BzrError):
1250
_fmt = ("No final name for trans_id %(trans_id)r\n"
1251
"file-id: %(file_id)r\n"
1252
"root trans-id: %(root_trans_id)r\n")
1254
def __init__(self, trans_id, transform):
1255
self.trans_id = trans_id
1256
self.file_id = transform.final_file_id(trans_id)
1257
self.root_trans_id = transform.root
1260
class BzrBadParameter(BzrError):
1262
_fmt = "Bad parameter: %(param)r"
1264
# This exception should never be thrown, but it is a base class for all
1265
# parameter-to-function errors.
1267
def __init__(self, param):
1268
BzrError.__init__(self)
1272
class BzrBadParameterNotUnicode(BzrBadParameter):
1274
_fmt = "Parameter %(param)s is neither unicode nor utf8."
1277
class ReusingTransform(BzrError):
1279
_fmt = "Attempt to reuse a transform that has already been applied."
1282
class CantMoveRoot(BzrError):
1284
_fmt = "Moving the root directory is not supported at this time"
1287
class BzrBadParameterNotString(BzrBadParameter):
1289
_fmt = "Parameter %(param)s is not a string or unicode string."
1292
class BzrBadParameterMissing(BzrBadParameter):
1294
_fmt = "Parameter $(param)s is required but not present."
1297
class BzrBadParameterUnicode(BzrBadParameter):
1299
_fmt = "Parameter %(param)s is unicode but only byte-strings are permitted."
1302
class BzrBadParameterContainsNewline(BzrBadParameter):
1304
_fmt = "Parameter %(param)s contains a newline."
1307
class DependencyNotPresent(BzrError):
1309
_fmt = 'Unable to import library "%(library)s": %(error)s'
1311
def __init__(self, library, error):
1312
BzrError.__init__(self, library=library, error=error)
1315
class ParamikoNotPresent(DependencyNotPresent):
1317
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
1319
def __init__(self, error):
1320
DependencyNotPresent.__init__(self, 'paramiko', error)
1323
class PointlessMerge(BzrError):
1325
_fmt = "Nothing to merge."
1328
class UninitializableFormat(BzrError):
1330
_fmt = "Format %(format)s cannot be initialised by this version of bzr."
1332
def __init__(self, format):
1333
BzrError.__init__(self)
1334
self.format = format
1337
class BadConversionTarget(BzrError):
1339
_fmt = "Cannot convert to format %(format)s. %(problem)s"
1341
def __init__(self, problem, format):
1342
BzrError.__init__(self)
1343
self.problem = problem
1344
self.format = format
1347
class NoDiff(BzrError):
1349
_fmt = "Diff is not installed on this machine: %(msg)s"
1351
def __init__(self, msg):
1352
BzrError.__init__(self, msg=msg)
1355
class NoDiff3(BzrError):
1357
_fmt = "Diff3 is not installed on this machine."
1360
class ExistingLimbo(BzrError):
1362
_fmt = """This tree contains left-over files from a failed operation.
1363
Please examine %(limbo_dir)s to see if it contains any files you wish to
1364
keep, and delete it when you are done."""
1366
def __init__(self, limbo_dir):
1367
BzrError.__init__(self)
1368
self.limbo_dir = limbo_dir
1371
class ImmortalLimbo(BzrError):
1373
_fmt = """Unable to delete transform temporary directory $(limbo_dir)s.
1374
Please examine %(limbo_dir)s to see if it contains any files you wish to
1375
keep, and delete it when you are done."""
1377
def __init__(self, limbo_dir):
1378
BzrError.__init__(self)
1379
self.limbo_dir = limbo_dir
1382
class OutOfDateTree(BzrError):
1384
_fmt = "Working tree is out of date, please run 'bzr update'."
1386
def __init__(self, tree):
1387
BzrError.__init__(self)
1391
class MergeModifiedFormatError(BzrError):
1393
_fmt = "Error in merge modified format"
1396
class ConflictFormatError(BzrError):
1398
_fmt = "Format error in conflict listings"
1401
class CorruptRepository(BzrError):
1403
_fmt = """An error has been detected in the repository %(repo_path)s.
1404
Please run bzr reconcile on this repository."""
1406
def __init__(self, repo):
1407
BzrError.__init__(self)
1408
self.repo_path = repo.bzrdir.root_transport.base
1411
class UpgradeRequired(BzrError):
1413
_fmt = "To use this feature you must upgrade your branch at %(path)s."
1415
def __init__(self, path):
1416
BzrError.__init__(self)
1420
class LocalRequiresBoundBranch(BzrError):
1422
_fmt = "Cannot perform local-only commits on unbound branches."
1425
class MissingProgressBarFinish(BzrError):
1427
_fmt = "A nested progress bar was not 'finished' correctly."
1430
class InvalidProgressBarType(BzrError):
1432
_fmt = """Environment variable BZR_PROGRESS_BAR='%(bar_type)s is not a supported type
1433
Select one of: %(valid_types)s"""
1435
def __init__(self, bar_type, valid_types):
1436
BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1439
class UnsupportedOperation(BzrError):
1441
_fmt = "The method %(mname)s is not supported on objects of type %(tname)s."
1443
def __init__(self, method, method_self):
1444
self.method = method
1445
self.mname = method.__name__
1446
self.tname = type(method_self).__name__
1449
class CannotSetRevisionId(UnsupportedOperation):
1450
"""Raised when a commit is attempting to set a revision id but cant."""
1453
class NonAsciiRevisionId(UnsupportedOperation):
1454
"""Raised when a commit is attempting to set a non-ascii revision id but cant."""
1457
class BinaryFile(BzrError):
1459
_fmt = "File is binary but should be text."
1462
class IllegalPath(BzrError):
1464
_fmt = "The path %(path)s is not permitted on this platform"
1466
def __init__(self, path):
1467
BzrError.__init__(self)
1471
class TestamentMismatch(BzrError):
1473
_fmt = """Testament did not match expected value.
1474
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1477
def __init__(self, revision_id, expected, measured):
1478
self.revision_id = revision_id
1479
self.expected = expected
1480
self.measured = measured
1483
class NotABundle(BzrError):
1485
_fmt = "Not a bzr revision-bundle: %(text)r"
1487
def __init__(self, text):
1488
BzrError.__init__(self)
1492
class BadBundle(BzrError):
1494
_fmt = "Bad bzr revision-bundle: %(text)r"
1496
def __init__(self, text):
1497
BzrError.__init__(self)
1501
class MalformedHeader(BadBundle):
1503
_fmt = "Malformed bzr revision-bundle header: %(text)r"
1506
class MalformedPatches(BadBundle):
1508
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1511
class MalformedFooter(BadBundle):
1513
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1516
class UnsupportedEOLMarker(BadBundle):
1518
_fmt = "End of line marker was not \\n in bzr revision-bundle"
1521
# XXX: BadBundle's constructor assumes there's explanatory text,
1522
# but for this there is not
1523
BzrError.__init__(self)
1526
class IncompatibleBundleFormat(BzrError):
1528
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
1530
def __init__(self, bundle_format, other):
1531
BzrError.__init__(self)
1532
self.bundle_format = bundle_format
1536
class BadInventoryFormat(BzrError):
1538
_fmt = "Root class for inventory serialization errors"
1541
class UnexpectedInventoryFormat(BadInventoryFormat):
1543
_fmt = "The inventory was not in the expected format:\n %(msg)s"
1545
def __init__(self, msg):
1546
BadInventoryFormat.__init__(self, msg=msg)
1549
class NoSmartMedium(BzrError):
1551
_fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
1553
def __init__(self, transport):
1554
self.transport = transport
1557
class NoSmartServer(NotBranchError):
1559
_fmt = "No smart server available at %(url)s"
1561
def __init__(self, url):
1565
class UnknownSSH(BzrError):
1567
_fmt = "Unrecognised value for BZR_SSH environment variable: %(vendor)s"
1569
def __init__(self, vendor):
1570
BzrError.__init__(self)
1571
self.vendor = vendor
1574
class GhostRevisionUnusableHere(BzrError):
1576
_fmt = "Ghost revision {%(revision_id)s} cannot be used here."
1578
def __init__(self, revision_id):
1579
BzrError.__init__(self)
1580
self.revision_id = revision_id
1583
class IllegalUseOfScopeReplacer(BzrError):
1585
_fmt = "ScopeReplacer object %(name)r was used incorrectly: %(msg)s%(extra)s"
1587
internal_error = True
1589
def __init__(self, name, msg, extra=None):
1590
BzrError.__init__(self)
1594
self.extra = ': ' + str(extra)
1599
class InvalidImportLine(BzrError):
1601
_fmt = "Not a valid import statement: %(msg)\n%(text)s"
1603
internal_error = True
1605
def __init__(self, text, msg):
1606
BzrError.__init__(self)
1611
class ImportNameCollision(BzrError):
1613
_fmt = "Tried to import an object to the same name as an existing object. %(name)s"
1615
internal_error = True
1617
def __init__(self, name):
1618
BzrError.__init__(self)
added
removed
bzrlib/errors.py
