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 BadOptionValue(BzrError):
300
_fmt = """Bad value "%(value)s" for option "%(name)s"."""
302
def __init__(self, name, value):
303
BzrError.__init__(self, name=name, value=value)
306
class StrictCommitFailed(BzrError):
308
_fmt = "Commit refused because there are unknown files in the tree"
311
# XXX: Should be unified with TransportError; they seem to represent the
313
class PathError(BzrError):
315
_fmt = "Generic path error: %(path)r%(extra)s)"
317
def __init__(self, path, extra=None):
318
BzrError.__init__(self)
321
self.extra = ': ' + str(extra)
326
class NoSuchFile(PathError):
328
_fmt = "No such file: %(path)r%(extra)s"
331
class FileExists(PathError):
333
_fmt = "File exists: %(path)r%(extra)s"
336
class DirectoryNotEmpty(PathError):
338
_fmt = "Directory not empty: %(path)r%(extra)s"
341
class ReadingCompleted(BzrError):
343
_fmt = ("The MediumRequest '%(request)s' has already had finish_reading "
344
"called upon it - the request has been completed and no more "
347
internal_error = True
349
def __init__(self, request):
350
self.request = request
353
class ResourceBusy(PathError):
355
_fmt = "Device or resource busy: %(path)r%(extra)s"
358
class PermissionDenied(PathError):
360
_fmt = "Permission denied: %(path)r%(extra)s"
363
class InvalidURL(PathError):
365
_fmt = "Invalid url supplied to transport: %(path)r%(extra)s"
368
class InvalidURLJoin(PathError):
370
_fmt = "Invalid URL join request: %(args)s%(extra)s"
372
def __init__(self, msg, base, args):
373
PathError.__init__(self, base, msg)
374
self.args = [base] + list(args)
377
class UnsupportedProtocol(PathError):
379
_fmt = 'Unsupported protocol for url "%(path)s"%(extra)s'
381
def __init__(self, url, extra):
382
PathError.__init__(self, url, extra=extra)
385
class ShortReadvError(PathError):
387
_fmt = "readv() read %(actual)s bytes rather than %(length)s bytes at %(offset)s for %(path)s%(extra)s"
389
internal_error = True
391
def __init__(self, path, offset, length, actual, extra=None):
392
PathError.__init__(self, path, extra=extra)
398
class PathNotChild(BzrError):
400
_fmt = "Path %(path)r is not a child of path %(base)r%(extra)s"
402
internal_error = True
404
def __init__(self, path, base, extra=None):
405
BzrError.__init__(self)
409
self.extra = ': ' + str(extra)
414
class InvalidNormalization(PathError):
416
_fmt = "Path %(path)r is not unicode normalized"
419
# TODO: This is given a URL; we try to unescape it but doing that from inside
420
# the exception object is a bit undesirable.
421
# TODO: Probably this behavior of should be a common superclass
422
class NotBranchError(PathError):
424
_fmt = "Not a branch: %(path)s"
426
def __init__(self, path):
427
import bzrlib.urlutils as urlutils
428
self.path = urlutils.unescape_for_display(path, 'ascii')
431
class AlreadyBranchError(PathError):
433
_fmt = "Already a branch: %(path)s."
436
class BranchExistsWithoutWorkingTree(PathError):
438
_fmt = "Directory contains a branch, but no working tree \
439
(use bzr checkout if you wish to build a working tree): %(path)s"
442
class AtomicFileAlreadyClosed(PathError):
444
_fmt = "'%(function)s' called on an AtomicFile after it was closed: %(path)s"
446
def __init__(self, path, function):
447
PathError.__init__(self, path=path, extra=None)
448
self.function = function
451
class InaccessibleParent(PathError):
453
_fmt = "Parent not accessible given base %(base)s and relative path %(path)s"
455
def __init__(self, path, base):
456
PathError.__init__(self, path)
460
class NoRepositoryPresent(BzrError):
462
_fmt = "No repository present: %(path)r"
463
def __init__(self, bzrdir):
464
BzrError.__init__(self)
465
self.path = bzrdir.transport.clone('..').base
468
class FileInWrongBranch(BzrError):
470
_fmt = "File %(path)s in not in branch %(branch_base)s."
472
def __init__(self, branch, path):
473
BzrError.__init__(self)
475
self.branch_base = branch.base
479
class UnsupportedFormatError(BzrError):
481
_fmt = "Unsupported branch format: %(format)s"
484
class UnknownFormatError(BzrError):
486
_fmt = "Unknown branch format: %(format)r"
489
class IncompatibleFormat(BzrError):
491
_fmt = "Format %(format)s is not compatible with .bzr version %(bzrdir)s."
493
def __init__(self, format, bzrdir_format):
494
BzrError.__init__(self)
496
self.bzrdir = bzrdir_format
499
class IncompatibleRevision(BzrError):
501
_fmt = "Revision is not compatible with %(repo_format)s"
503
def __init__(self, repo_format):
504
BzrError.__init__(self)
505
self.repo_format = repo_format
508
class NotVersionedError(BzrError):
510
_fmt = "%(path)s is not versioned"
512
def __init__(self, path):
513
BzrError.__init__(self)
517
class PathsNotVersionedError(BzrError):
518
# used when reporting several paths are not versioned
520
_fmt = "Path(s) are not versioned: %(paths_as_string)s"
522
def __init__(self, paths):
523
from bzrlib.osutils import quotefn
524
BzrError.__init__(self)
526
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
529
class PathsDoNotExist(BzrError):
531
_fmt = "Path(s) do not exist: %(paths_as_string)s"
533
# used when reporting that paths are neither versioned nor in the working
536
def __init__(self, paths):
538
from bzrlib.osutils import quotefn
539
BzrError.__init__(self)
541
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
544
class BadFileKindError(BzrError):
546
_fmt = "Cannot operate on %(filename)s of unsupported kind %(kind)s"
549
class ForbiddenControlFileError(BzrError):
551
_fmt = "Cannot operate on %(filename)s because it is a control file"
554
class LockError(BzrError):
556
_fmt = "Lock error: %(message)s"
558
internal_error = True
560
# All exceptions from the lock/unlock functions should be from
561
# this exception class. They will be translated as necessary. The
562
# original exception is available as e.original_error
564
# New code should prefer to raise specific subclasses
565
def __init__(self, message):
566
self.message = message
569
class CommitNotPossible(LockError):
571
_fmt = "A commit was attempted but we do not have a write lock open."
577
class AlreadyCommitted(LockError):
579
_fmt = "A rollback was requested, but is not able to be accomplished."
585
class ReadOnlyError(LockError):
587
_fmt = "A write attempt was made in a read only transaction on %(obj)s"
589
def __init__(self, obj):
593
class OutSideTransaction(BzrError):
595
_fmt = "A transaction related operation was attempted after the transaction finished."
598
class ObjectNotLocked(LockError):
600
_fmt = "%(obj)r is not locked"
602
# this can indicate that any particular object is not locked; see also
603
# LockNotHeld which means that a particular *lock* object is not held by
604
# the caller -- perhaps they should be unified.
605
def __init__(self, obj):
609
class ReadOnlyObjectDirtiedError(ReadOnlyError):
611
_fmt = "Cannot change object %(obj)r in read only transaction"
613
def __init__(self, obj):
617
class UnlockableTransport(LockError):
619
_fmt = "Cannot lock: transport is read only: %(transport)s"
621
def __init__(self, transport):
622
self.transport = transport
625
class LockContention(LockError):
627
_fmt = "Could not acquire lock %(lock)s"
628
# TODO: show full url for lock, combining the transport and relative
631
internal_error = False
633
def __init__(self, lock):
637
class LockBroken(LockError):
639
_fmt = "Lock was broken while still open: %(lock)s - check storage consistency!"
641
internal_error = False
643
def __init__(self, lock):
647
class LockBreakMismatch(LockError):
649
_fmt = "Lock was released and re-acquired before being broken: %(lock)s: held by %(holder)r, wanted to break %(target)r"
651
internal_error = False
653
def __init__(self, lock, holder, target):
659
class LockNotHeld(LockError):
661
_fmt = "Lock not held: %(lock)s"
663
internal_error = False
665
def __init__(self, lock):
669
class PointlessCommit(BzrError):
671
_fmt = "No changes to commit"
674
class UpgradeReadonly(BzrError):
676
_fmt = "Upgrade URL cannot work with readonly URLs."
679
class UpToDateFormat(BzrError):
681
_fmt = "The branch format %(format)s is already at the most recent format."
683
def __init__(self, format):
684
BzrError.__init__(self)
688
class StrictCommitFailed(Exception):
690
_fmt = "Commit refused because there are unknowns in the tree."
693
class NoSuchRevision(BzrError):
695
_fmt = "Branch %(branch)s has no revision %(revision)s"
697
internal_error = True
699
def __init__(self, branch, revision):
700
BzrError.__init__(self, branch=branch, revision=revision)
703
class NoSuchRevisionSpec(BzrError):
705
_fmt = "No namespace registered for string: %(spec)r"
707
def __init__(self, spec):
708
BzrError.__init__(self, spec=spec)
711
class InvalidRevisionSpec(BzrError):
713
_fmt = "Requested revision: %(spec)r does not exist in branch: %(branch)s%(extra)s"
715
def __init__(self, spec, branch, extra=None):
716
BzrError.__init__(self, branch=branch, spec=spec)
718
self.extra = '\n' + str(extra)
723
class HistoryMissing(BzrError):
725
_fmt = "%(branch)s is missing %(object_type)s {%(object_id)s}"
728
class DivergedBranches(BzrError):
730
_fmt = "These branches have diverged. Use the merge command to reconcile them."""
732
internal_error = False
734
def __init__(self, branch1, branch2):
735
self.branch1 = branch1
736
self.branch2 = branch2
739
class UnrelatedBranches(BzrError):
741
_fmt = "Branches have no common ancestor, and no merge base revision was specified."
743
internal_error = False
746
class NoCommonAncestor(BzrError):
748
_fmt = "Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
750
def __init__(self, revision_a, revision_b):
751
self.revision_a = revision_a
752
self.revision_b = revision_b
755
class NoCommonRoot(BzrError):
757
_fmt = "Revisions are not derived from the same root: " \
758
"%(revision_a)s %(revision_b)s."
760
def __init__(self, revision_a, revision_b):
761
BzrError.__init__(self, revision_a=revision_a, revision_b=revision_b)
764
class NotAncestor(BzrError):
766
_fmt = "Revision %(rev_id)s is not an ancestor of %(not_ancestor_id)s"
768
def __init__(self, rev_id, not_ancestor_id):
769
BzrError.__init__(self, rev_id=rev_id,
770
not_ancestor_id=not_ancestor_id)
773
class InstallFailed(BzrError):
775
def __init__(self, revisions):
776
revision_str = ", ".join(str(r) for r in revisions)
777
msg = "Could not install revisions:\n%s" % revision_str
778
BzrError.__init__(self, msg)
779
self.revisions = revisions
782
class AmbiguousBase(BzrError):
784
def __init__(self, bases):
785
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
787
msg = "The correct base is unclear, because %s are all equally close" %\
789
BzrError.__init__(self, msg)
793
class NoCommits(BzrError):
795
_fmt = "Branch %(branch)s has no commits."
797
def __init__(self, branch):
798
BzrError.__init__(self, branch=branch)
801
class UnlistableStore(BzrError):
803
def __init__(self, store):
804
BzrError.__init__(self, "Store %s is not listable" % store)
808
class UnlistableBranch(BzrError):
810
def __init__(self, br):
811
BzrError.__init__(self, "Stores for branch %s are not listable" % br)
814
class BoundBranchOutOfDate(BzrError):
816
_fmt = "Bound branch %(branch)s is out of date with master branch %(master)s."
818
def __init__(self, branch, master):
819
BzrError.__init__(self)
824
class CommitToDoubleBoundBranch(BzrError):
826
_fmt = "Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."
828
def __init__(self, branch, master, remote):
829
BzrError.__init__(self)
835
class OverwriteBoundBranch(BzrError):
837
_fmt = "Cannot pull --overwrite to a branch which is bound %(branch)s"
839
def __init__(self, branch):
840
BzrError.__init__(self)
844
class BoundBranchConnectionFailure(BzrError):
846
_fmt = "Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"
848
def __init__(self, branch, target, error):
849
BzrError.__init__(self)
855
class WeaveError(BzrError):
857
_fmt = "Error in processing weave: %(message)s"
859
def __init__(self, message=None):
860
BzrError.__init__(self)
861
self.message = message
864
class WeaveRevisionAlreadyPresent(WeaveError):
866
_fmt = "Revision {%(revision_id)s} already present in %(weave)s"
868
def __init__(self, revision_id, weave):
870
WeaveError.__init__(self)
871
self.revision_id = revision_id
875
class WeaveRevisionNotPresent(WeaveError):
877
_fmt = "Revision {%(revision_id)s} not present in %(weave)s"
879
def __init__(self, revision_id, weave):
880
WeaveError.__init__(self)
881
self.revision_id = revision_id
885
class WeaveFormatError(WeaveError):
887
_fmt = "Weave invariant violated: %(what)s"
889
def __init__(self, what):
890
WeaveError.__init__(self)
894
class WeaveParentMismatch(WeaveError):
896
_fmt = "Parents are mismatched between two revisions."
899
class WeaveInvalidChecksum(WeaveError):
901
_fmt = "Text did not match it's checksum: %(message)s"
904
class WeaveTextDiffers(WeaveError):
906
_fmt = "Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"
908
def __init__(self, revision_id, weave_a, weave_b):
909
WeaveError.__init__(self)
910
self.revision_id = revision_id
911
self.weave_a = weave_a
912
self.weave_b = weave_b
915
class WeaveTextDiffers(WeaveError):
917
_fmt = "Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"
919
def __init__(self, revision_id, weave_a, weave_b):
920
WeaveError.__init__(self)
921
self.revision_id = revision_id
922
self.weave_a = weave_a
923
self.weave_b = weave_b
926
class VersionedFileError(BzrError):
928
_fmt = "Versioned file error"
931
class RevisionNotPresent(VersionedFileError):
933
_fmt = "Revision {%(revision_id)s} not present in %(file_id)s."
935
def __init__(self, revision_id, file_id):
936
VersionedFileError.__init__(self)
937
self.revision_id = revision_id
938
self.file_id = file_id
941
class RevisionAlreadyPresent(VersionedFileError):
943
_fmt = "Revision {%(revision_id)s} already present in %(file_id)s."
945
def __init__(self, revision_id, file_id):
946
VersionedFileError.__init__(self)
947
self.revision_id = revision_id
948
self.file_id = file_id
951
class KnitError(BzrError):
955
internal_error = True
958
class KnitHeaderError(KnitError):
960
_fmt = "Knit header error: %(badline)r unexpected for file %(filename)s"
962
def __init__(self, badline, filename):
963
KnitError.__init__(self)
964
self.badline = badline
965
self.filename = filename
968
class KnitCorrupt(KnitError):
970
_fmt = "Knit %(filename)s corrupt: %(how)s"
972
def __init__(self, filename, how):
973
KnitError.__init__(self)
974
self.filename = filename
978
class KnitIndexUnknownMethod(KnitError):
979
"""Raised when we don't understand the storage method.
981
Currently only 'fulltext' and 'line-delta' are supported.
984
_fmt = ("Knit index %(filename)s does not have a known method"
985
" in options: %(options)r")
987
def __init__(self, filename, options):
988
KnitError.__init__(self)
989
self.filename = filename
990
self.options = options
993
class NoSuchExportFormat(BzrError):
995
_fmt = "Export format %(format)r not supported"
997
def __init__(self, format):
998
BzrError.__init__(self)
1002
class TransportError(BzrError):
1004
_fmt = "Transport error: %(msg)s %(orig_error)s"
1006
def __init__(self, msg=None, orig_error=None):
1007
if msg is None and orig_error is not None:
1008
msg = str(orig_error)
1009
if orig_error is None:
1014
self.orig_error = orig_error
1015
BzrError.__init__(self)
1018
class TooManyConcurrentRequests(BzrError):
1020
_fmt = ("The medium '%(medium)s' has reached its concurrent request limit. "
1021
"Be sure to finish_writing and finish_reading on the "
1022
"current request that is open.")
1024
internal_error = True
1026
def __init__(self, medium):
1027
self.medium = medium
1030
class SmartProtocolError(TransportError):
1032
_fmt = "Generic bzr smart protocol error: %(details)s"
1034
def __init__(self, details):
1035
self.details = details
1038
# A set of semi-meaningful errors which can be thrown
1039
class TransportNotPossible(TransportError):
1041
_fmt = "Transport operation not possible: %(msg)s %(orig_error)s"
1044
class ConnectionError(TransportError):
1046
_fmt = "Connection error: %(msg)s %(orig_error)s"
1049
class SocketConnectionError(ConnectionError):
1051
_fmt = "%(msg)s %(host)s%(port)s%(orig_error)s"
1053
def __init__(self, host, port=None, msg=None, orig_error=None):
1055
msg = 'Failed to connect to'
1056
if orig_error is None:
1059
orig_error = '; ' + str(orig_error)
1060
ConnectionError.__init__(self, msg=msg, orig_error=orig_error)
1065
self.port = ':%s' % port
1068
class ConnectionReset(TransportError):
1070
_fmt = "Connection closed: %(msg)s %(orig_error)s"
1073
class InvalidRange(TransportError):
1075
_fmt = "Invalid range access in %(path)s at %(offset)s."
1077
def __init__(self, path, offset):
1078
TransportError.__init__(self, ("Invalid range access in %s at %d"
1081
self.offset = offset
1084
class InvalidHttpResponse(TransportError):
1086
_fmt = "Invalid http response for %(path)s: %(msg)s"
1088
def __init__(self, path, msg, orig_error=None):
1090
TransportError.__init__(self, msg, orig_error=orig_error)
1093
class InvalidHttpRange(InvalidHttpResponse):
1095
_fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
1097
def __init__(self, path, range, msg):
1099
InvalidHttpResponse.__init__(self, path, msg)
1102
class InvalidHttpContentType(InvalidHttpResponse):
1104
_fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1106
def __init__(self, path, ctype, msg):
1108
InvalidHttpResponse.__init__(self, path, msg)
1111
class ConflictsInTree(BzrError):
1113
_fmt = "Working tree has conflicts."
1116
class ParseConfigError(BzrError):
1118
def __init__(self, errors, filename):
1119
if filename is None:
1121
message = "Error(s) parsing config file %s:\n%s" % \
1122
(filename, ('\n'.join(e.message for e in errors)))
1123
BzrError.__init__(self, message)
1126
class NoEmailInUsername(BzrError):
1128
_fmt = "%(username)r does not seem to contain a reasonable email address"
1130
def __init__(self, username):
1131
BzrError.__init__(self)
1132
self.username = username
1135
class SigningFailed(BzrError):
1137
_fmt = "Failed to gpg sign data with command %(command_line)r"
1139
def __init__(self, command_line):
1140
BzrError.__init__(self, command_line=command_line)
1143
class WorkingTreeNotRevision(BzrError):
1145
_fmt = ("The working tree for %(basedir)s has changed since"
1146
" the last commit, but weave merge requires that it be"
1149
def __init__(self, tree):
1150
BzrError.__init__(self, basedir=tree.basedir)
1153
class CantReprocessAndShowBase(BzrError):
1155
_fmt = "Can't reprocess and show base, because reprocessing obscures " \
1156
"the relationship of conflicting lines to the base"
1159
class GraphCycleError(BzrError):
1161
_fmt = "Cycle in graph %(graph)r"
1163
def __init__(self, graph):
1164
BzrError.__init__(self)
1168
class WritingCompleted(BzrError):
1170
_fmt = ("The MediumRequest '%(request)s' has already had finish_writing "
1171
"called upon it - accept bytes may not be called anymore.")
1173
internal_error = True
1175
def __init__(self, request):
1176
self.request = request
1179
class WritingNotComplete(BzrError):
1181
_fmt = ("The MediumRequest '%(request)s' has not has finish_writing "
1182
"called upon it - until the write phase is complete no "
1183
"data may be read.")
1185
internal_error = True
1187
def __init__(self, request):
1188
self.request = request
1191
class NotConflicted(BzrError):
1193
_fmt = "File %(filename)s is not conflicted."
1195
def __init__(self, filename):
1196
BzrError.__init__(self)
1197
self.filename = filename
1200
class MediumNotConnected(BzrError):
1202
_fmt = """The medium '%(medium)s' is not connected."""
1204
internal_error = True
1206
def __init__(self, medium):
1207
self.medium = medium
1210
class MustUseDecorated(Exception):
1212
_fmt = """A decorating function has requested its original command be used."""
1215
class NoBundleFound(BzrError):
1217
_fmt = "No bundle was found in %(filename)s"
1219
def __init__(self, filename):
1220
BzrError.__init__(self)
1221
self.filename = filename
1224
class BundleNotSupported(BzrError):
1226
_fmt = "Unable to handle bundle version %(version)s: %(msg)s"
1228
def __init__(self, version, msg):
1229
BzrError.__init__(self)
1230
self.version = version
1234
class MissingText(BzrError):
1236
_fmt = "Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"
1238
def __init__(self, branch, text_revision, file_id):
1239
BzrError.__init__(self)
1240
self.branch = branch
1241
self.base = branch.base
1242
self.text_revision = text_revision
1243
self.file_id = file_id
1246
class DuplicateKey(BzrError):
1248
_fmt = "Key %(key)s is already present in map"
1251
class MalformedTransform(BzrError):
1253
_fmt = "Tree transform is malformed %(conflicts)r"
1256
class NoFinalPath(BzrError):
1258
_fmt = ("No final name for trans_id %(trans_id)r\n"
1259
"file-id: %(file_id)r\n"
1260
"root trans-id: %(root_trans_id)r\n")
1262
def __init__(self, trans_id, transform):
1263
self.trans_id = trans_id
1264
self.file_id = transform.final_file_id(trans_id)
1265
self.root_trans_id = transform.root
1268
class BzrBadParameter(BzrError):
1270
_fmt = "Bad parameter: %(param)r"
1272
# This exception should never be thrown, but it is a base class for all
1273
# parameter-to-function errors.
1275
def __init__(self, param):
1276
BzrError.__init__(self)
1280
class BzrBadParameterNotUnicode(BzrBadParameter):
1282
_fmt = "Parameter %(param)s is neither unicode nor utf8."
1285
class ReusingTransform(BzrError):
1287
_fmt = "Attempt to reuse a transform that has already been applied."
1290
class CantMoveRoot(BzrError):
1292
_fmt = "Moving the root directory is not supported at this time"
1295
class BzrBadParameterNotString(BzrBadParameter):
1297
_fmt = "Parameter %(param)s is not a string or unicode string."
1300
class BzrBadParameterMissing(BzrBadParameter):
1302
_fmt = "Parameter $(param)s is required but not present."
1305
class BzrBadParameterUnicode(BzrBadParameter):
1307
_fmt = "Parameter %(param)s is unicode but only byte-strings are permitted."
1310
class BzrBadParameterContainsNewline(BzrBadParameter):
1312
_fmt = "Parameter %(param)s contains a newline."
1315
class DependencyNotPresent(BzrError):
1317
_fmt = 'Unable to import library "%(library)s": %(error)s'
1319
def __init__(self, library, error):
1320
BzrError.__init__(self, library=library, error=error)
1323
class ParamikoNotPresent(DependencyNotPresent):
1325
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
1327
def __init__(self, error):
1328
DependencyNotPresent.__init__(self, 'paramiko', error)
1331
class PointlessMerge(BzrError):
1333
_fmt = "Nothing to merge."
1336
class UninitializableFormat(BzrError):
1338
_fmt = "Format %(format)s cannot be initialised by this version of bzr."
1340
def __init__(self, format):
1341
BzrError.__init__(self)
1342
self.format = format
1345
class BadConversionTarget(BzrError):
1347
_fmt = "Cannot convert to format %(format)s. %(problem)s"
1349
def __init__(self, problem, format):
1350
BzrError.__init__(self)
1351
self.problem = problem
1352
self.format = format
1355
class NoDiff(BzrError):
1357
_fmt = "Diff is not installed on this machine: %(msg)s"
1359
def __init__(self, msg):
1360
BzrError.__init__(self, msg=msg)
1363
class NoDiff3(BzrError):
1365
_fmt = "Diff3 is not installed on this machine."
1368
class ExistingLimbo(BzrError):
1370
_fmt = """This tree contains left-over files from a failed operation.
1371
Please examine %(limbo_dir)s to see if it contains any files you wish to
1372
keep, and delete it when you are done."""
1374
def __init__(self, limbo_dir):
1375
BzrError.__init__(self)
1376
self.limbo_dir = limbo_dir
1379
class ImmortalLimbo(BzrError):
1381
_fmt = """Unable to delete transform temporary directory $(limbo_dir)s.
1382
Please examine %(limbo_dir)s to see if it contains any files you wish to
1383
keep, and delete it when you are done."""
1385
def __init__(self, limbo_dir):
1386
BzrError.__init__(self)
1387
self.limbo_dir = limbo_dir
1390
class OutOfDateTree(BzrError):
1392
_fmt = "Working tree is out of date, please run 'bzr update'."
1394
def __init__(self, tree):
1395
BzrError.__init__(self)
1399
class MergeModifiedFormatError(BzrError):
1401
_fmt = "Error in merge modified format"
1404
class ConflictFormatError(BzrError):
1406
_fmt = "Format error in conflict listings"
1409
class CorruptRepository(BzrError):
1411
_fmt = """An error has been detected in the repository %(repo_path)s.
1412
Please run bzr reconcile on this repository."""
1414
def __init__(self, repo):
1415
BzrError.__init__(self)
1416
self.repo_path = repo.bzrdir.root_transport.base
1419
class UpgradeRequired(BzrError):
1421
_fmt = "To use this feature you must upgrade your branch at %(path)s."
1423
def __init__(self, path):
1424
BzrError.__init__(self)
1428
class LocalRequiresBoundBranch(BzrError):
1430
_fmt = "Cannot perform local-only commits on unbound branches."
1433
class MissingProgressBarFinish(BzrError):
1435
_fmt = "A nested progress bar was not 'finished' correctly."
1438
class InvalidProgressBarType(BzrError):
1440
_fmt = """Environment variable BZR_PROGRESS_BAR='%(bar_type)s is not a supported type
1441
Select one of: %(valid_types)s"""
1443
def __init__(self, bar_type, valid_types):
1444
BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1447
class UnsupportedOperation(BzrError):
1449
_fmt = "The method %(mname)s is not supported on objects of type %(tname)s."
1451
def __init__(self, method, method_self):
1452
self.method = method
1453
self.mname = method.__name__
1454
self.tname = type(method_self).__name__
1457
class CannotSetRevisionId(UnsupportedOperation):
1458
"""Raised when a commit is attempting to set a revision id but cant."""
1461
class NonAsciiRevisionId(UnsupportedOperation):
1462
"""Raised when a commit is attempting to set a non-ascii revision id but cant."""
1465
class BinaryFile(BzrError):
1467
_fmt = "File is binary but should be text."
1470
class IllegalPath(BzrError):
1472
_fmt = "The path %(path)s is not permitted on this platform"
1474
def __init__(self, path):
1475
BzrError.__init__(self)
1479
class TestamentMismatch(BzrError):
1481
_fmt = """Testament did not match expected value.
1482
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1485
def __init__(self, revision_id, expected, measured):
1486
self.revision_id = revision_id
1487
self.expected = expected
1488
self.measured = measured
1491
class NotABundle(BzrError):
1493
_fmt = "Not a bzr revision-bundle: %(text)r"
1495
def __init__(self, text):
1496
BzrError.__init__(self)
1500
class BadBundle(BzrError):
1502
_fmt = "Bad bzr revision-bundle: %(text)r"
1504
def __init__(self, text):
1505
BzrError.__init__(self)
1509
class MalformedHeader(BadBundle):
1511
_fmt = "Malformed bzr revision-bundle header: %(text)r"
1514
class MalformedPatches(BadBundle):
1516
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
1519
class MalformedFooter(BadBundle):
1521
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
1524
class UnsupportedEOLMarker(BadBundle):
1526
_fmt = "End of line marker was not \\n in bzr revision-bundle"
1529
# XXX: BadBundle's constructor assumes there's explanatory text,
1530
# but for this there is not
1531
BzrError.__init__(self)
1534
class IncompatibleBundleFormat(BzrError):
1536
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
1538
def __init__(self, bundle_format, other):
1539
BzrError.__init__(self)
1540
self.bundle_format = bundle_format
1544
class BadInventoryFormat(BzrError):
1546
_fmt = "Root class for inventory serialization errors"
1549
class UnexpectedInventoryFormat(BadInventoryFormat):
1551
_fmt = "The inventory was not in the expected format:\n %(msg)s"
1553
def __init__(self, msg):
1554
BadInventoryFormat.__init__(self, msg=msg)
1557
class NoSmartMedium(BzrError):
1559
_fmt = "The transport '%(transport)s' cannot tunnel the smart protocol."
1561
def __init__(self, transport):
1562
self.transport = transport
1565
class NoSmartServer(NotBranchError):
1567
_fmt = "No smart server available at %(url)s"
1569
def __init__(self, url):
1573
class UnknownSSH(BzrError):
1575
_fmt = "Unrecognised value for BZR_SSH environment variable: %(vendor)s"
1577
def __init__(self, vendor):
1578
BzrError.__init__(self)
1579
self.vendor = vendor
1582
class GhostRevisionUnusableHere(BzrError):
1584
_fmt = "Ghost revision {%(revision_id)s} cannot be used here."
1586
def __init__(self, revision_id):
1587
BzrError.__init__(self)
1588
self.revision_id = revision_id
1591
class IllegalUseOfScopeReplacer(BzrError):
1593
_fmt = "ScopeReplacer object %(name)r was used incorrectly: %(msg)s%(extra)s"
1595
internal_error = True
1597
def __init__(self, name, msg, extra=None):
1598
BzrError.__init__(self)
1602
self.extra = ': ' + str(extra)
1607
class InvalidImportLine(BzrError):
1609
_fmt = "Not a valid import statement: %(msg)\n%(text)s"
1611
internal_error = True
1613
def __init__(self, text, msg):
1614
BzrError.__init__(self)
1619
class ImportNameCollision(BzrError):
1621
_fmt = "Tried to import an object to the same name as an existing object. %(name)s"
1623
internal_error = True
1625
def __init__(self, name):
1626
BzrError.__init__(self)
added
removed
bzrlib/errors.py
