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.
25
from bzrlib.patches import (
34
# TODO: is there any value in providing the .args field used by standard
35
# python exceptions? A list of values with no names seems less useful
38
# TODO: Perhaps convert the exception to a string at the moment it's
39
# constructed to make sure it will succeed. But that says nothing about
40
# exceptions that are never raised.
42
# TODO: selftest assertRaises should probably also check that every error
43
# raised can be formatted as a string successfully, and without giving
47
class BzrError(StandardError):
49
Base class for errors raised by bzrlib.
51
:cvar internal_error: if true (or absent) this was probably caused by a
52
bzr bug and should be displayed with a traceback; if False this was
53
probably a user or environment error and they don't need the gory details.
54
(That can be overridden by -Derror on the command line.)
56
:cvar _fmt: Format string to display the error; this is expanded
57
by the instance's dict.
60
internal_error = False
62
def __init__(self, msg=None, **kwds):
63
"""Construct a new BzrError.
65
There are two alternative forms for constructing these objects.
66
Either a preformatted string may be passed, or a set of named
67
arguments can be given. The first is for generic "user" errors which
68
are not intended to be caught and so do not need a specific subclass.
69
The second case is for use with subclasses that provide a _fmt format
70
string to print the arguments.
72
Keyword arguments are taken as parameters to the error, which can
73
be inserted into the format string template. It's recommended
74
that subclasses override the __init__ method to require specific
77
:param msg: If given, this is the literal complete text for the error,
78
not subject to expansion.
80
StandardError.__init__(self)
82
# I was going to deprecate this, but it actually turns out to be
83
# quite handy - mbp 20061103.
84
self._preformatted_string = msg
86
self._preformatted_string = None
87
for key, value in kwds.items():
88
setattr(self, key, value)
91
s = getattr(self, '_preformatted_string', None)
93
# contains a preformatted message; must be cast to plain str
96
fmt = self._get_format_string()
98
s = fmt % self.__dict__
99
# __str__() should always return a 'str' object
100
# never a 'unicode' object.
101
if isinstance(s, unicode):
102
return s.encode('utf8')
104
except (AttributeError, TypeError, NameError, ValueError, KeyError), e:
105
return 'Unprintable exception %s: dict=%r, fmt=%r, error=%s' \
106
% (self.__class__.__name__,
108
getattr(self, '_fmt', None),
111
def _get_format_string(self):
112
"""Return format string for this exception or None"""
113
fmt = getattr(self, '_fmt', None)
116
fmt = getattr(self, '__doc__', None)
118
symbol_versioning.warn("%s uses its docstring as a format, "
119
"it should use _fmt instead" % self.__class__.__name__,
122
return 'Unprintable exception %s: dict=%r, fmt=%r' \
123
% (self.__class__.__name__,
125
getattr(self, '_fmt', None),
129
class BzrNewError(BzrError):
130
"""Deprecated error base class."""
131
# base classes should override the docstring with their human-
132
# readable explanation
134
def __init__(self, *args, **kwds):
135
# XXX: Use the underlying BzrError to always generate the args attribute
136
# if it doesn't exist. We can't use super here, because exceptions are
137
# old-style classes in python2.4 (but new in 2.5). --bmc, 20060426
138
symbol_versioning.warn('BzrNewError was deprecated in bzr 0.13; '
139
'please convert %s to use BzrError instead'
140
% self.__class__.__name__,
143
BzrError.__init__(self, *args)
144
for key, value in kwds.items():
145
setattr(self, key, value)
149
# __str__() should always return a 'str' object
150
# never a 'unicode' object.
151
s = self.__doc__ % self.__dict__
152
if isinstance(s, unicode):
153
return s.encode('utf8')
155
except (TypeError, NameError, ValueError, KeyError), e:
156
return 'Unprintable exception %s(%r): %s' \
157
% (self.__class__.__name__,
158
self.__dict__, str(e))
161
class AlreadyBuilding(BzrError):
163
_fmt = "The tree builder is already building a tree."
166
class BzrCheckError(BzrError):
168
_fmt = "Internal check failed: %(message)s"
170
internal_error = True
172
def __init__(self, message):
173
BzrError.__init__(self)
174
self.message = message
177
class InvalidEntryName(BzrError):
179
_fmt = "Invalid entry name: %(name)s"
181
internal_error = True
183
def __init__(self, name):
184
BzrError.__init__(self)
188
class InvalidRevisionNumber(BzrError):
190
_fmt = "Invalid revision number %(revno)s"
192
def __init__(self, revno):
193
BzrError.__init__(self)
197
class InvalidRevisionId(BzrError):
199
_fmt = "Invalid revision-id {%(revision_id)s} in %(branch)s"
201
def __init__(self, revision_id, branch):
202
# branch can be any string or object with __str__ defined
203
BzrError.__init__(self)
204
self.revision_id = revision_id
207
class ReservedId(BzrError):
209
_fmt = "Reserved revision-id {%(revision_id)s}"
211
def __init__(self, revision_id):
212
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 BadOptionValue(BzrError):
305
_fmt = """Bad value "%(value)s" for option "%(name)s"."""
307
def __init__(self, name, value):
308
BzrError.__init__(self, name=name, value=value)
311
class StrictCommitFailed(BzrError):
313
_fmt = "Commit refused because there are unknown files in the tree"
316
# XXX: Should be unified with TransportError; they seem to represent the
318
class PathError(BzrError):
320
_fmt = "Generic path error: %(path)r%(extra)s)"
322
def __init__(self, path, extra=None):
323
BzrError.__init__(self)
326
self.extra = ': ' + str(extra)
331
class NoSuchFile(PathError):
333
_fmt = "No such file: %(path)r%(extra)s"
336
class FileExists(PathError):
338
_fmt = "File exists: %(path)r%(extra)s"
341
class RenameFailedFilesExist(BzrError):
342
"""Used when renaming and both source and dest exist."""
344
_fmt = ("Could not rename %(source)s => %(dest)s because both files exist."
347
def __init__(self, source, dest, extra=None):
348
BzrError.__init__(self)
349
self.source = str(source)
350
self.dest = str(dest)
352
self.extra = ' ' + str(extra)
357
class NotADirectory(PathError):
359
_fmt = "%(path)r is not a directory %(extra)s"
362
class NotInWorkingDirectory(PathError):
364
_fmt = "%(path)r is not in the working directory %(extra)s"
367
class DirectoryNotEmpty(PathError):
369
_fmt = "Directory not empty: %(path)r%(extra)s"
372
class ReadingCompleted(BzrError):
374
_fmt = ("The MediumRequest '%(request)s' has already had finish_reading "
375
"called upon it - the request has been completed and no more "
378
internal_error = True
380
def __init__(self, request):
381
self.request = request
384
class ResourceBusy(PathError):
386
_fmt = "Device or resource busy: %(path)r%(extra)s"
389
class PermissionDenied(PathError):
391
_fmt = "Permission denied: %(path)r%(extra)s"
394
class InvalidURL(PathError):
396
_fmt = "Invalid url supplied to transport: %(path)r%(extra)s"
399
class InvalidURLJoin(PathError):
401
_fmt = "Invalid URL join request: %(args)s%(extra)s"
403
def __init__(self, msg, base, args):
404
PathError.__init__(self, base, msg)
405
self.args = [base] + list(args)
408
class UnsupportedProtocol(PathError):
410
_fmt = 'Unsupported protocol for url "%(path)s"%(extra)s'
412
def __init__(self, url, extra):
413
PathError.__init__(self, url, extra=extra)
416
class ShortReadvError(PathError):
418
_fmt = "readv() read %(actual)s bytes rather than %(length)s bytes at %(offset)s for %(path)s%(extra)s"
420
internal_error = True
422
def __init__(self, path, offset, length, actual, extra=None):
423
PathError.__init__(self, path, extra=extra)
429
class PathNotChild(BzrError):
431
_fmt = "Path %(path)r is not a child of path %(base)r%(extra)s"
433
internal_error = True
435
def __init__(self, path, base, extra=None):
436
BzrError.__init__(self)
440
self.extra = ': ' + str(extra)
445
class InvalidNormalization(PathError):
447
_fmt = "Path %(path)r is not unicode normalized"
450
# TODO: This is given a URL; we try to unescape it but doing that from inside
451
# the exception object is a bit undesirable.
452
# TODO: Probably this behavior of should be a common superclass
453
class NotBranchError(PathError):
455
_fmt = "Not a branch: %(path)s"
457
def __init__(self, path):
458
import bzrlib.urlutils as urlutils
459
self.path = urlutils.unescape_for_display(path, 'ascii')
462
class AlreadyBranchError(PathError):
464
_fmt = "Already a branch: %(path)s."
467
class BranchExistsWithoutWorkingTree(PathError):
469
_fmt = "Directory contains a branch, but no working tree \
470
(use bzr checkout if you wish to build a working tree): %(path)s"
473
class AtomicFileAlreadyClosed(PathError):
475
_fmt = "'%(function)s' called on an AtomicFile after it was closed: %(path)s"
477
def __init__(self, path, function):
478
PathError.__init__(self, path=path, extra=None)
479
self.function = function
482
class InaccessibleParent(PathError):
484
_fmt = "Parent not accessible given base %(base)s and relative path %(path)s"
486
def __init__(self, path, base):
487
PathError.__init__(self, path)
491
class NoRepositoryPresent(BzrError):
493
_fmt = "No repository present: %(path)r"
494
def __init__(self, bzrdir):
495
BzrError.__init__(self)
496
self.path = bzrdir.transport.clone('..').base
499
class FileInWrongBranch(BzrError):
501
_fmt = "File %(path)s in not in branch %(branch_base)s."
503
def __init__(self, branch, path):
504
BzrError.__init__(self)
506
self.branch_base = branch.base
510
class UnsupportedFormatError(BzrError):
512
_fmt = "Unsupported branch format: %(format)s"
515
class UnknownFormatError(BzrError):
517
_fmt = "Unknown branch format: %(format)r"
520
class IncompatibleFormat(BzrError):
522
_fmt = "Format %(format)s is not compatible with .bzr version %(bzrdir)s."
524
def __init__(self, format, bzrdir_format):
525
BzrError.__init__(self)
527
self.bzrdir = bzrdir_format
530
class IncompatibleRevision(BzrError):
532
_fmt = "Revision is not compatible with %(repo_format)s"
534
def __init__(self, repo_format):
535
BzrError.__init__(self)
536
self.repo_format = repo_format
539
class AlreadyVersionedError(BzrError):
540
"""Used when a path is expected not to be versioned, but it is."""
542
_fmt = "%(context_info)s%(path)s is already versioned"
544
def __init__(self, path, context_info=None):
545
"""Construct a new NotVersionedError.
547
:param path: This is the path which is versioned,
548
which should be in a user friendly form.
549
:param context_info: If given, this is information about the context,
550
which could explain why this is expected to not be versioned.
552
BzrError.__init__(self)
554
if context_info is None:
555
self.context_info = ''
557
self.context_info = context_info + ". "
560
class NotVersionedError(BzrError):
561
"""Used when a path is expected to be versioned, but it is not."""
563
_fmt = "%(context_info)s%(path)s is not versioned"
565
def __init__(self, path, context_info=None):
566
"""Construct a new NotVersionedError.
568
:param path: This is the path which is not versioned,
569
which should be in a user friendly form.
570
:param context_info: If given, this is information about the context,
571
which could explain why this is expected to be versioned.
573
BzrError.__init__(self)
575
if context_info is None:
576
self.context_info = ''
578
self.context_info = context_info + ". "
581
class PathsNotVersionedError(BzrError):
582
"""Used when reporting several paths which are not versioned"""
584
_fmt = "Path(s) are not versioned: %(paths_as_string)s"
586
def __init__(self, paths):
587
from bzrlib.osutils import quotefn
588
BzrError.__init__(self)
590
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
593
class PathsDoNotExist(BzrError):
595
_fmt = "Path(s) do not exist: %(paths_as_string)s%(extra)s"
597
# used when reporting that paths are neither versioned nor in the working
600
def __init__(self, paths, extra=None):
602
from bzrlib.osutils import quotefn
603
BzrError.__init__(self)
605
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
607
self.extra = ': ' + str(extra)
612
class BadFileKindError(BzrError):
614
_fmt = "Cannot operate on %(filename)s of unsupported kind %(kind)s"
617
class ForbiddenControlFileError(BzrError):
619
_fmt = "Cannot operate on %(filename)s because it is a control file"
622
class LockError(BzrError):
624
_fmt = "Lock error: %(message)s"
626
internal_error = True
628
# All exceptions from the lock/unlock functions should be from
629
# this exception class. They will be translated as necessary. The
630
# original exception is available as e.original_error
632
# New code should prefer to raise specific subclasses
633
def __init__(self, message):
634
self.message = message
637
class CommitNotPossible(LockError):
639
_fmt = "A commit was attempted but we do not have a write lock open."
645
class AlreadyCommitted(LockError):
647
_fmt = "A rollback was requested, but is not able to be accomplished."
653
class ReadOnlyError(LockError):
655
_fmt = "A write attempt was made in a read only transaction on %(obj)s"
657
def __init__(self, obj):
661
class OutSideTransaction(BzrError):
663
_fmt = "A transaction related operation was attempted after the transaction finished."
666
class ObjectNotLocked(LockError):
668
_fmt = "%(obj)r is not locked"
670
# this can indicate that any particular object is not locked; see also
671
# LockNotHeld which means that a particular *lock* object is not held by
672
# the caller -- perhaps they should be unified.
673
def __init__(self, obj):
677
class ReadOnlyObjectDirtiedError(ReadOnlyError):
679
_fmt = "Cannot change object %(obj)r in read only transaction"
681
def __init__(self, obj):
685
class UnlockableTransport(LockError):
687
_fmt = "Cannot lock: transport is read only: %(transport)s"
689
def __init__(self, transport):
690
self.transport = transport
693
class LockContention(LockError):
695
_fmt = "Could not acquire lock %(lock)s"
696
# TODO: show full url for lock, combining the transport and relative
699
internal_error = False
701
def __init__(self, lock):
705
class LockBroken(LockError):
707
_fmt = "Lock was broken while still open: %(lock)s - check storage consistency!"
709
internal_error = False
711
def __init__(self, lock):
715
class LockBreakMismatch(LockError):
717
_fmt = "Lock was released and re-acquired before being broken: %(lock)s: held by %(holder)r, wanted to break %(target)r"
719
internal_error = False
721
def __init__(self, lock, holder, target):
727
class LockNotHeld(LockError):
729
_fmt = "Lock not held: %(lock)s"
731
internal_error = False
733
def __init__(self, lock):
737
class PointlessCommit(BzrError):
739
_fmt = "No changes to commit"
742
class UpgradeReadonly(BzrError):
744
_fmt = "Upgrade URL cannot work with readonly URLs."
747
class UpToDateFormat(BzrError):
749
_fmt = "The branch format %(format)s is already at the most recent format."
751
def __init__(self, format):
752
BzrError.__init__(self)
756
class StrictCommitFailed(Exception):
758
_fmt = "Commit refused because there are unknowns in the tree."
761
class NoSuchRevision(BzrError):
763
_fmt = "Branch %(branch)s has no revision %(revision)s"
765
internal_error = True
767
def __init__(self, branch, revision):
768
BzrError.__init__(self, branch=branch, revision=revision)
771
class NoSuchRevisionSpec(BzrError):
773
_fmt = "No namespace registered for string: %(spec)r"
775
def __init__(self, spec):
776
BzrError.__init__(self, spec=spec)
779
class InvalidRevisionSpec(BzrError):
781
_fmt = "Requested revision: %(spec)r does not exist in branch: %(branch)s%(extra)s"
783
def __init__(self, spec, branch, extra=None):
784
BzrError.__init__(self, branch=branch, spec=spec)
786
self.extra = '\n' + str(extra)
791
class HistoryMissing(BzrError):
793
_fmt = "%(branch)s is missing %(object_type)s {%(object_id)s}"
796
class DivergedBranches(BzrError):
798
_fmt = "These branches have diverged. Use the merge command to reconcile them."""
800
internal_error = False
802
def __init__(self, branch1, branch2):
803
self.branch1 = branch1
804
self.branch2 = branch2
807
class UnrelatedBranches(BzrError):
809
_fmt = "Branches have no common ancestor, and no merge base revision was specified."
811
internal_error = False
814
class NoCommonAncestor(BzrError):
816
_fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
818
def __init__(self, revision_a, revision_b):
819
self.revision_a = revision_a
820
self.revision_b = revision_b
823
class NoCommonRoot(BzrError):
825
_fmt = "Revisions are not derived from the same root: " \
826
"%(revision_a)s %(revision_b)s."
828
def __init__(self, revision_a, revision_b):
829
BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
832
class NotAncestor(BzrError):
834
_fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
836
def __init__(self, rev_id, not_ancestor_id):
837
BzrError.__init__(self, rev_id=rev_id,
838
not_ancestor_id=not_ancestor_id)
841
class InstallFailed(BzrError):
843
def __init__(self, revisions):
844
revision_str = ", ".join(str(r) for r in revisions)
845
msg = "Could not install revisions:\n%s" % revision_str
846
BzrError.__init__(self, msg)
847
self.revisions = revisions
850
class AmbiguousBase(BzrError):
852
def __init__(self, bases):
853
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
855
msg = "The correct base is unclear, because %s are all equally close" %\
857
BzrError.__init__(self, msg)
861
class NoCommits(BzrError):
863
_fmt = "Branch %(branch)s has no commits."
865
def __init__(self, branch):
866
BzrError.__init__(self, branch=branch)
869
class UnlistableStore(BzrError):
871
def __init__(self, store):
872
BzrError.__init__(self, "Store %s is not listable" % store)
876
class UnlistableBranch(BzrError):
878
def __init__(self, br):
879
BzrError.__init__(self, "Stores for branch %s are not listable" % br)
882
class BoundBranchOutOfDate(BzrError):
884
_fmt = "Bound branch %(branch)s is out of date with master branch %(master)s."
886
def __init__(self, branch, master):
887
BzrError.__init__(self)
892
class CommitToDoubleBoundBranch(BzrError):
894
_fmt = "Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."
896
def __init__(self, branch, master, remote):
897
BzrError.__init__(self)
903
class OverwriteBoundBranch(BzrError):
905
_fmt = "Cannot pull --overwrite to a branch which is bound %(branch)s"
907
def __init__(self, branch):
908
BzrError.__init__(self)
912
class BoundBranchConnectionFailure(BzrError):
914
_fmt = "Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"
916
def __init__(self, branch, target, error):
917
BzrError.__init__(self)
923
class WeaveError(BzrError):
925
_fmt = "Error in processing weave: %(message)s"
927
def __init__(self, message=None):
928
BzrError.__init__(self)
929
self.message = message
932
class WeaveRevisionAlreadyPresent(WeaveError):
934
_fmt = "Revision {%(revision_id)s} already present in %(weave)s"
936
def __init__(self, revision_id, weave):
938
WeaveError.__init__(self)
939
self.revision_id = revision_id
943
class WeaveRevisionNotPresent(WeaveError):
945
_fmt = "Revision {%(revision_id)s} not present in %(weave)s"
947
def __init__(self, revision_id, weave):
948
WeaveError.__init__(self)
949
self.revision_id = revision_id
953
class WeaveFormatError(WeaveError):
955
_fmt = "Weave invariant violated: %(what)s"
957
def __init__(self, what):
958
WeaveError.__init__(self)
962
class WeaveParentMismatch(WeaveError):
964
_fmt = "Parents are mismatched between two revisions."
967
class WeaveInvalidChecksum(WeaveError):
969
_fmt = "Text did not match it's checksum: %(message)s"
972
class WeaveTextDiffers(WeaveError):
974
_fmt = "Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"
976
def __init__(self, revision_id, weave_a, weave_b):
977
WeaveError.__init__(self)
978
self.revision_id = revision_id
979
self.weave_a = weave_a
980
self.weave_b = weave_b
983
class WeaveTextDiffers(WeaveError):
985
_fmt = "Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"
987
def __init__(self, revision_id, weave_a, weave_b):
988
WeaveError.__init__(self)
989
self.revision_id = revision_id
990
self.weave_a = weave_a
991
self.weave_b = weave_b
994
class VersionedFileError(BzrError):
996
_fmt = "Versioned file error"
999
class RevisionNotPresent(VersionedFileError):
1001
_fmt = "Revision {%(revision_id)s} not present in %(file_id)s."
1003
def __init__(self, revision_id, file_id):
1004
VersionedFileError.__init__(self)
1005
self.revision_id = revision_id
1006
self.file_id = file_id
1009
class RevisionAlreadyPresent(VersionedFileError):
1011
_fmt = "Revision {%(revision_id)s} already present in %(file_id)s."
1013
def __init__(self, revision_id, file_id):
1014
VersionedFileError.__init__(self)
1015
self.revision_id = revision_id
1016
self.file_id = file_id
1019
class KnitError(BzrError):
1023
internal_error = True
1026
class KnitHeaderError(KnitError):
1028
_fmt = "Knit header error: %(badline)r unexpected for file %(filename)s"
1030
def __init__(self, badline, filename):
1031
KnitError.__init__(self)
1032
self.badline = badline
1033
self.filename = filename
1036
class KnitCorrupt(KnitError):
1038
_fmt = "Knit %(filename)s corrupt: %(how)s"
1040
def __init__(self, filename, how):
1041
KnitError.__init__(self)
1042
self.filename = filename
1046
class KnitIndexUnknownMethod(KnitError):
1047
"""Raised when we don't understand the storage method.
1049
Currently only 'fulltext' and 'line-delta' are supported.
1052
_fmt = ("Knit index %(filename)s does not have a known method"
1053
" in options: %(options)r")
1055
def __init__(self, filename, options):
1056
KnitError.__init__(self)
1057
self.filename = filename
1058
self.options = options
1061
class NoSuchExportFormat(BzrError):
1063
_fmt = "Export format %(format)r not supported"
1065
def __init__(self, format):
1066
BzrError.__init__(self)
1067
self.format = format
1070
class TransportError(BzrError):
1072
_fmt = "Transport error: %(msg)s %(orig_error)s"
1074
def __init__(self, msg=None, orig_error=None):
1075
if msg is None and orig_error is not None:
1076
msg = str(orig_error)
1077
if orig_error is None:
1082
self.orig_error = orig_error
1083
BzrError.__init__(self)
1086
class TooManyConcurrentRequests(BzrError):
1088
_fmt = ("The medium '%(medium)s' has reached its concurrent request limit. "
1089
"Be sure to finish_writing and finish_reading on the "
1090
"current request that is open.")
1092
internal_error = True
1094
def __init__(self, medium):
1095
self.medium = medium
1098
class SmartProtocolError(TransportError):
1100
_fmt = "Generic bzr smart protocol error: %(details)s"
1102
def __init__(self, details):
1103
self.details = details
1106
# A set of semi-meaningful errors which can be thrown
1107
class TransportNotPossible(TransportError):
1109
_fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
1112
class ConnectionError(TransportError):
1114
_fmt = "Connection error: %(msg)s %(orig_error)s"
1117
class SocketConnectionError(ConnectionError):
1119
_fmt = "%(msg)s %(host)s%(port)s%(orig_error)s"
1121
def __init__(self, host, port=None, msg=None, orig_error=None):
1123
msg = 'Failed to connect to'
1124
if orig_error is None:
1127
orig_error = '; ' + str(orig_error)
1128
ConnectionError.__init__(self, msg=msg, orig_error=orig_error)
1133
self.port = ':%s' % port
1136
class ConnectionReset(TransportError):
1138
_fmt = "Connection closed: %(msg)s %(orig_error)s"
1141
class InvalidRange(TransportError):
1143
_fmt = "Invalid range access in %(path)s at %(offset)s."
1145
def __init__(self, path, offset):
1146
TransportError.__init__(self, ("Invalid range access in %s at %d"
1149
self.offset = offset
1152
class InvalidHttpResponse(TransportError):
1154
_fmt = "Invalid http response for %(path)s: %(msg)s"
1156
def __init__(self, path, msg, orig_error=None):
1158
TransportError.__init__(self, msg, orig_error=orig_error)
1161
class InvalidHttpRange(InvalidHttpResponse):
1163
_fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
1165
def __init__(self, path, range, msg):
1167
InvalidHttpResponse.__init__(self, path, msg)
1170
class InvalidHttpContentType(InvalidHttpResponse):
1172
_fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1174
def __init__(self, path, ctype, msg):
1176
InvalidHttpResponse.__init__(self, path, msg)
1179
class RedirectRequested(TransportError):
1181
_fmt = '%(source)s is%(permanently)s redirected to %(target)s'
1183
def __init__(self, source, target, is_permament=False, qual_proto=None):
1184
self.source = source
1185
self.target = target
1187
self.permanently = ' permanently'
1189
self.permanently = ''
1190
self.is_permament = is_permament
1191
self._qualified_proto = qual_proto
1192
TransportError.__init__(self)
1194
def _requalify_url(self, url):
1195
"""Restore the qualified proto in front of the url"""
1196
# When this exception is raised, source and target are in
1197
# user readable format. But some transports mau use a
1198
# different proto (http+urllib:// will present http:// to
1199
# the user. If a qualified proto is specified, the code
1200
# trapping the exeception can get the qualified urls to
1201
# properly handle the redirection themself (creating a
1202
# new transport object from the target url for example).
1203
if self._qualified_proto is None:
1206
# The TODO related to NotBranchError mention that doing
1207
# that kind of manipulation on the urls may not be the
1208
# exception object job. On the other hand, this object is
1209
# the interface between the code and the user so
1210
# presenting the urls in different ways is indeed its
1213
proto, netloc, path, query, fragment = urlparse.urlsplit(url)
1214
return urlparse.urlunsplit((self._qualified_proto, netloc, path,
1217
def get_source_url(self):
1218
return self._requalify_url(self.source)
1220
def get_target_url(self):
1221
return self._requalify_url(self.source)
1224
class UnknownHint(TransportError):
1226
_fmt = '%(hint) is not known'
1228
def __init_(self, source, hint):
1232
class ConflictsInTree(BzrError):
1234
_fmt = "Working tree has conflicts."
1237
class ParseConfigError(BzrError):
1239
def __init__(self, errors, filename):
1240
if filename is None:
1242
message = "Error(s) parsing config file %s:\n%s" % \
1243
(filename, ('\n'.join(e.message for e in errors)))
1244
BzrError.__init__(self, message)
1247
class NoEmailInUsername(BzrError):
1249
_fmt = "%(username)r does not seem to contain a reasonable email address"
1251
def __init__(self, username):
1252
BzrError.__init__(self)
1253
self.username = username
1256
class SigningFailed(BzrError):
1258
_fmt = "Failed to gpg sign data with command %(command_line)r"
1260
def __init__(self, command_line):
1261
BzrError.__init__(self, command_line=command_line)
1264
class WorkingTreeNotRevision(BzrError):
1266
_fmt = ("The working tree for %(basedir)s has changed since"
1267
" the last commit, but weave merge requires that it be"
1270
def __init__(self, tree):
1271
BzrError.__init__(self, basedir=tree.basedir)
1274
class CantReprocessAndShowBase(BzrError):
1276
_fmt = "Can't reprocess and show base, because reprocessing obscures " \
1277
"the relationship of conflicting lines to the base"
1280
class GraphCycleError(BzrError):
1282
_fmt = "Cycle in graph %(graph)r"
1284
def __init__(self, graph):
1285
BzrError.__init__(self)
1289
class WritingCompleted(BzrError):
1291
_fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
1292
"called upon it - accept bytes may not be called anymore.")
1294
internal_error = True
1296
def __init__(self, request):
1297
self.request = request
1300
class WritingNotComplete(BzrError):
1302
_fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
1303
"called upon it - until the write phase is complete no "
1304
"data may be read.")
1306
internal_error = True
1308
def __init__(self, request):
1309
self.request = request
1312
class NotConflicted(BzrError):
1314
_fmt = "File %(filename)s is not conflicted."
1316
def __init__(self, filename):
1317
BzrError.__init__(self)
1318
self.filename = filename
1321
class MediumNotConnected(BzrError):
1323
_fmt = """The medium '%(medium)s' is not connected."""
1325
internal_error = True
1327
def __init__(self, medium):
1328
self.medium = medium
1331
class MustUseDecorated(Exception):
1333
_fmt = """A decorating function has requested its original command be used."""
1336
class NoBundleFound(BzrError):
1338
_fmt = "No bundle was found in %(filename)s"
1340
def __init__(self, filename):
1341
BzrError.__init__(self)
1342
self.filename = filename
1345
class BundleNotSupported(BzrError):
1347
_fmt = "Unable to handle bundle version %(version)s: %(msg)s"
1349
def __init__(self, version, msg):
1350
BzrError.__init__(self)
1351
self.version = version
1355
class MissingText(BzrError):
1357
_fmt = "Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"
1359
def __init__(self, branch, text_revision, file_id):
1360
BzrError.__init__(self)
1361
self.branch = branch
1362
self.base = branch.base
1363
self.text_revision = text_revision
1364
self.file_id = file_id
1367
class DuplicateKey(BzrError):
1369
_fmt = "Key %(key)s is already present in map"
1372
class MalformedTransform(BzrError):
1374
_fmt = "Tree transform is malformed %(conflicts)r"
1377
class NoFinalPath(BzrError):
1379
_fmt = ("No final name for trans_id %(trans_id)r\n"
1380
"file-id: %(file_id)r\n"
1381
"root trans-id: %(root_trans_id)r\n")
1383
def __init__(self, trans_id, transform):
1384
self.trans_id = trans_id
1385
self.file_id = transform.final_file_id(trans_id)
1386
self.root_trans_id = transform.root
1389
class BzrBadParameter(BzrError):
1391
_fmt = "Bad parameter: %(param)r"
1393
# This exception should never be thrown, but it is a base class for all
1394
# parameter-to-function errors.
1396
def __init__(self, param):
1397
BzrError.__init__(self)
1401
class BzrBadParameterNotUnicode(BzrBadParameter):
1403
_fmt = "Parameter %(param)s is neither unicode nor utf8."
1406
class ReusingTransform(BzrError):
1408
_fmt = "Attempt to reuse a transform that has already been applied."
1411
class CantMoveRoot(BzrError):
1413
_fmt = "Moving the root directory is not supported at this time"
1416
class BzrMoveFailedError(BzrError):
1418
_fmt = "Could not move %(from_path)s%(operator)s %(to_path)s%(extra)s"
1420
def __init__(self, from_path='', to_path='', extra=None):
1421
BzrError.__init__(self)
1423
self.extra = ': ' + str(extra)
1427
has_from = len(from_path) > 0
1428
has_to = len(to_path) > 0
1430
self.from_path = osutils.splitpath(from_path)[-1]
1435
self.to_path = osutils.splitpath(to_path)[-1]
1440
if has_from and has_to:
1441
self.operator = " =>"
1443
self.from_path = "from " + from_path
1445
self.operator = "to"
1447
self.operator = "file"
1450
class BzrRenameFailedError(BzrMoveFailedError):
1452
_fmt = "Could not rename %(from_path)s%(operator)s %(to_path)s%(extra)s"
1454
def __init__(self, from_path, to_path, extra=None):
1455
BzrMoveFailedError.__init__(self, from_path, to_path, extra)
1458
class BzrBadParameterNotString(BzrBadParameter):
1460
_fmt = "Parameter %(param)s is not a string or unicode string."
1463
class BzrBadParameterMissing(BzrBadParameter):
1465
_fmt = "Parameter $(param)s is required but not present."
1468
class BzrBadParameterUnicode(BzrBadParameter):
1470
_fmt = "Parameter %(param)s is unicode but only byte-strings are permitted."
1473
class BzrBadParameterContainsNewline(BzrBadParameter):
1475
_fmt = "Parameter %(param)s contains a newline."
1478
class DependencyNotPresent(BzrError):
1480
_fmt = 'Unable to import library "%(library)s": %(error)s'
1482
def __init__(self, library, error):
1483
BzrError.__init__(self, library=library, error=error)
1486
class ParamikoNotPresent(DependencyNotPresent):
1488
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
1490
def __init__(self, error):
1491
DependencyNotPresent.__init__(self, 'paramiko', error)
1494
class PointlessMerge(BzrError):
1496
_fmt = "Nothing to merge."
1499
class UninitializableFormat(BzrError):
1501
_fmt = "Format %(format)s cannot be initialised by this version of bzr."
1503
def __init__(self, format):
1504
BzrError.__init__(self)
1505
self.format = format
1508
class BadConversionTarget(BzrError):
1510
_fmt = "Cannot convert to format %(format)s. %(problem)s"
1512
def __init__(self, problem, format):
1513
BzrError.__init__(self)
1514
self.problem = problem
1515
self.format = format
1518
class NoDiff(BzrError):
1520
_fmt = "Diff is not installed on this machine: %(msg)s"
1522
def __init__(self, msg):
1523
BzrError.__init__(self, msg=msg)
1526
class NoDiff3(BzrError):
1528
_fmt = "Diff3 is not installed on this machine."
1531
class ExistingLimbo(BzrError):
1533
_fmt = """This tree contains left-over files from a failed operation.
1534
Please examine %(limbo_dir)s to see if it contains any files you wish to
1535
keep, and delete it when you are done."""
1537
def __init__(self, limbo_dir):
1538
BzrError.__init__(self)
1539
self.limbo_dir = limbo_dir
1542
class ImmortalLimbo(BzrError):
1544
_fmt = """Unable to delete transform temporary directory $(limbo_dir)s.
1545
Please examine %(limbo_dir)s to see if it contains any files you wish to
1546
keep, and delete it when you are done."""
1548
def __init__(self, limbo_dir):
1549
BzrError.__init__(self)
1550
self.limbo_dir = limbo_dir
1553
class OutOfDateTree(BzrError):
1555
_fmt = "Working tree is out of date, please run 'bzr update'."
1557
def __init__(self, tree):
1558
BzrError.__init__(self)
1562
class MergeModifiedFormatError(BzrError):
1564
_fmt = "Error in merge modified format"
1567
class ConflictFormatError(BzrError):
1569
_fmt = "Format error in conflict listings"
1572
class CorruptRepository(BzrError):
1574
_fmt = """An error has been detected in the repository %(repo_path)s.
1575
Please run bzr reconcile on this repository."""
1577
def __init__(self, repo):
1578
BzrError.__init__(self)
1579
self.repo_path = repo.bzrdir.root_transport.base
1582
class UpgradeRequired(BzrError):
1584
_fmt = "To use this feature you must upgrade your branch at %(path)s."
1586
def __init__(self, path):
1587
BzrError.__init__(self)
1591
class LocalRequiresBoundBranch(BzrError):
1593
_fmt = "Cannot perform local-only commits on unbound branches."
1596
class MissingProgressBarFinish(BzrError):
1598
_fmt = "A nested progress bar was not 'finished' correctly."
1601
class InvalidProgressBarType(BzrError):
1603
_fmt = """Environment variable BZR_PROGRESS_BAR='%(bar_type)s is not a supported type
1604
Select one of: %(valid_types)s"""
1606
def __init__(self, bar_type, valid_types):
1607
BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1610
class UnsupportedOperation(BzrError):
1612
_fmt = "The method %(mname)s is not supported on objects of type %(tname)s."
1614
def __init__(self, method, method_self):
1615
self.method = method
1616
self.mname = method.__name__
1617
self.tname = type(method_self).__name__
1620
class CannotSetRevisionId(UnsupportedOperation):
1621
"""Raised when a commit is attempting to set a revision id but cant."""
1624
class NonAsciiRevisionId(UnsupportedOperation):
1625
"""Raised when a commit is attempting to set a non-ascii revision id but cant."""
1628
class BinaryFile(BzrError):
1630
_fmt = "File is binary but should be text."
1633
class IllegalPath(BzrError):
1635
_fmt = "The path %(path)s is not permitted on this platform"
1637
def __init__(self, path):
1638
BzrError.__init__(self)
1642
class TestamentMismatch(BzrError):
1644
_fmt = """Testament did not match expected value.
1645
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1648
def __init__(self, revision_id, expected, measured):
1649
self.revision_id = revision_id
1650
self.expected = expected
1651
self.measured = measured
1654
class NotABundle(BzrError):
1656
_fmt = "Not a bzr revision-bundle: %(text)r"
1658
def __init__(self, text):
1659
BzrError.__init__(self)
1663
class BadBundle(BzrError):
1665
_fmt = "Bad bzr revision-bundle: %(text)r"
1667
def __init__(self, text):
1668
BzrError.__init__(self)
1672
class MalformedHeader(BadBundle):
1674
_fmt = "Malformed bzr revision-bundle header: %(text)r"
1677
class MalformedPatches(BadBundle):
1679
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1682
class MalformedFooter(BadBundle):
1684
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1687
class UnsupportedEOLMarker(BadBundle):
1689
_fmt = "End of line marker was not \\n in bzr revision-bundle"
1692
# XXX: BadBundle's constructor assumes there's explanatory text,
1693
# but for this there is not
1694
BzrError.__init__(self)
1697
class IncompatibleBundleFormat(BzrError):
1699
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
1701
def __init__(self, bundle_format, other):
1702
BzrError.__init__(self)
1703
self.bundle_format = bundle_format
1707
class BadInventoryFormat(BzrError):
1709
_fmt = "Root class for inventory serialization errors"
1712
class UnexpectedInventoryFormat(BadInventoryFormat):
1714
_fmt = "The inventory was not in the expected format:\n %(msg)s"
1716
def __init__(self, msg):
1717
BadInventoryFormat.__init__(self, msg=msg)
1720
class NoSmartMedium(BzrError):
1722
_fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
1724
def __init__(self, transport):
1725
self.transport = transport
1728
class NoSmartServer(NotBranchError):
1730
_fmt = "No smart server available at %(url)s"
1732
def __init__(self, url):
1736
class UnknownSSH(BzrError):
1738
_fmt = "Unrecognised value for BZR_SSH environment variable: %(vendor)s"
1740
def __init__(self, vendor):
1741
BzrError.__init__(self)
1742
self.vendor = vendor
1745
class GhostRevisionUnusableHere(BzrError):
1747
_fmt = "Ghost revision {%(revision_id)s} cannot be used here."
1749
def __init__(self, revision_id):
1750
BzrError.__init__(self)
1751
self.revision_id = revision_id
1754
class IllegalUseOfScopeReplacer(BzrError):
1756
_fmt = "ScopeReplacer object %(name)r was used incorrectly: %(msg)s%(extra)s"
1758
internal_error = True
1760
def __init__(self, name, msg, extra=None):
1761
BzrError.__init__(self)
1765
self.extra = ': ' + str(extra)
1770
class InvalidImportLine(BzrError):
1772
_fmt = "Not a valid import statement: %(msg)\n%(text)s"
1774
internal_error = True
1776
def __init__(self, text, msg):
1777
BzrError.__init__(self)
1782
class ImportNameCollision(BzrError):
1784
_fmt = "Tried to import an object to the same name as an existing object. %(name)s"
1786
internal_error = True
1788
def __init__(self, name):
1789
BzrError.__init__(self)
added
removed
bzrlib/errors.py
