1
# Copyright (C) 2005, 2006 Canonical
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.
19
There are 3 different classes of error:
21
* KeyboardInterrupt, and OSError with EPIPE - the program terminates
22
with an appropriate short message
24
* User errors, indicating a problem caused by the user such as a bad URL.
25
These are printed in a short form.
27
* Internal unexpected errors, including most Python builtin errors
28
and some raised from inside bzr. These are printed with a full
29
traceback and an invitation to report the bug.
31
Exceptions are caught at a high level to report errors to the user, and
32
might also be caught inside the program. Therefore it needs to be
33
possible to convert them to a meaningful string, and also for them to be
34
interrogated by the program.
36
Exceptions are defined such that the arguments given to the constructor
37
are stored in the object as properties of the same name. When the
38
object is printed as a string, the doc string of the class is used as
39
a format string with the property dictionary available to it.
41
This means that exceptions can used like this:
45
... raise NotBranchError(path='/foo/bar')
47
... print '%s.%s' % (sys.exc_type.__module__, sys.exc_type.__name__)
48
... print sys.exc_value
49
... path = getattr(sys.exc_value, 'path', None)
50
... if path is not None:
52
bzrlib.errors.NotBranchError
53
Not a branch: /foo/bar
58
* create a new exception class for any class of error that can be
59
usefully distinguished. If no callers are likely to want to catch
60
one but not another, don't worry about them.
62
* the __str__ method should generate something useful; BzrError provides
63
a good default implementation
65
Exception strings should start with a capital letter and should not have a
69
from warnings import warn
71
from bzrlib.patches import (PatchSyntax,
78
# based on Scott James Remnant's hct error classes
80
# TODO: is there any value in providing the .args field used by standard
81
# python exceptions? A list of values with no names seems less useful
84
# TODO: Perhaps convert the exception to a string at the moment it's
85
# constructed to make sure it will succeed. But that says nothing about
86
# exceptions that are never raised.
88
# TODO: Convert all the other error classes here to BzrNewError, and eliminate
91
# TODO: The pattern (from hct) of using classes docstrings as message
92
# templates is cute but maybe not such a great idea - perhaps should have a
93
# separate static message_template.
96
class BzrError(StandardError):
101
# XXX: Should we show the exception class in
102
# exceptions that don't provide their own message?
103
# maybe it should be done at a higher level
104
## n = self.__class__.__name__ + ': '
106
if len(self.args) == 1:
107
return str(self.args[0])
108
elif len(self.args) == 2:
109
# further explanation or suggestions
111
return n + '\n '.join([self.args[0]] + self.args[1])
113
return n + "%r" % self
115
return n + `self.args`
118
class BzrNewError(BzrError):
120
# base classes should override the docstring with their human-
121
# readable explanation
123
def __init__(self, **kwds):
124
for key, value in kwds.items():
125
setattr(self, key, value)
129
# __str__() should always return a 'str' object
130
# never a 'unicode' object.
131
s = self.__doc__ % self.__dict__
132
if isinstance(s, unicode):
133
return s.encode('utf8')
135
except (TypeError, NameError, ValueError, KeyError), e:
136
return 'Unprintable exception %s(%r): %s' \
137
% (self.__class__.__name__,
138
self.__dict__, str(e))
141
class AlreadyBuilding(BzrNewError):
142
"""The tree builder is already building a tree."""
145
class BzrCheckError(BzrNewError):
146
"""Internal check failed: %(message)s"""
148
is_user_error = False
150
def __init__(self, message):
151
BzrNewError.__init__(self)
152
self.message = message
155
class InvalidEntryName(BzrNewError):
156
"""Invalid entry name: %(name)s"""
158
is_user_error = False
160
def __init__(self, name):
161
BzrNewError.__init__(self)
165
class InvalidRevisionNumber(BzrNewError):
166
"""Invalid revision number %(revno)d"""
167
def __init__(self, revno):
168
BzrNewError.__init__(self)
172
class InvalidRevisionId(BzrNewError):
173
"""Invalid revision-id {%(revision_id)s} in %(branch)s"""
175
def __init__(self, revision_id, branch):
176
# branch can be any string or object with __str__ defined
177
BzrNewError.__init__(self)
178
self.revision_id = revision_id
182
class NoSuchId(BzrNewError):
183
"""The file id %(file_id)s is not present in the tree %(tree)s."""
185
def __init__(self, tree, file_id):
186
BzrNewError.__init__(self)
187
self.file_id = file_id
191
class NoWorkingTree(BzrNewError):
192
"""No WorkingTree exists for %(base)s."""
194
def __init__(self, base):
195
BzrNewError.__init__(self)
199
class NotBuilding(BzrNewError):
200
"""Not currently building a tree."""
203
class NotLocalUrl(BzrNewError):
204
"""%(url)s is not a local path."""
206
def __init__(self, url):
207
BzrNewError.__init__(self)
211
class BzrCommandError(BzrNewError):
212
"""Error from user command"""
216
# Error from malformed user command; please avoid raising this as a
217
# generic exception not caused by user input.
219
# I think it's a waste of effort to differentiate between errors that
220
# are not intended to be caught anyway. UI code need not subclass
221
# BzrCommandError, and non-UI code should not throw a subclass of
222
# BzrCommandError. ADHB 20051211
223
def __init__(self, msg):
224
# Object.__str__() must return a real string
225
# returning a Unicode string is a python error.
226
if isinstance(msg, unicode):
227
self.msg = msg.encode('utf8')
235
class BzrOptionError(BzrCommandError):
236
"""Error in command line options"""
239
class StrictCommitFailed(BzrNewError):
240
"""Commit refused because there are unknown files in the tree"""
243
# XXX: Should be unified with TransportError; they seem to represent the
245
class PathError(BzrNewError):
246
"""Generic path error: %(path)r%(extra)s)"""
248
def __init__(self, path, extra=None):
249
BzrNewError.__init__(self)
252
self.extra = ': ' + str(extra)
257
class NoSuchFile(PathError):
258
"""No such file: %(path)r%(extra)s"""
261
class FileExists(PathError):
262
"""File exists: %(path)r%(extra)s"""
265
class DirectoryNotEmpty(PathError):
266
"""Directory not empty: %(path)r%(extra)s"""
269
class ResourceBusy(PathError):
270
"""Device or resource busy: %(path)r%(extra)s"""
273
class PermissionDenied(PathError):
274
"""Permission denied: %(path)r%(extra)s"""
277
class InvalidURL(PathError):
278
"""Invalid url supplied to transport: %(path)r%(extra)s"""
281
class InvalidURLJoin(PathError):
282
"""Invalid URL join request: %(args)s%(extra)s"""
284
def __init__(self, msg, base, args):
285
PathError.__init__(self, base, msg)
286
self.args = [base] + list(args)
289
class UnsupportedProtocol(PathError):
290
"""Unsupported protocol for url "%(path)s"%(extra)s"""
292
def __init__(self, url, extra):
293
PathError.__init__(self, url, extra=extra)
296
class ShortReadvError(PathError):
297
"""readv() read %(actual)s bytes rather than %(length)s bytes at %(offset)s for %(path)s%(extra)s"""
299
is_user_error = False
301
def __init__(self, path, offset, length, actual, extra=None):
302
PathError.__init__(self, path, extra=extra)
308
class PathNotChild(BzrNewError):
309
"""Path %(path)r is not a child of path %(base)r%(extra)s"""
311
is_user_error = False
313
def __init__(self, path, base, extra=None):
314
BzrNewError.__init__(self)
318
self.extra = ': ' + str(extra)
323
class InvalidNormalization(PathError):
324
"""Path %(path)r is not unicode normalized"""
327
# TODO: This is given a URL; we try to unescape it but doing that from inside
328
# the exception object is a bit undesirable.
329
# TODO: Probably this behavior of should be a common superclass
330
class NotBranchError(PathError):
331
"""Not a branch: %(path)s"""
333
def __init__(self, path):
334
import bzrlib.urlutils as urlutils
335
self.path = urlutils.unescape_for_display(path, 'ascii')
338
class AlreadyBranchError(PathError):
339
"""Already a branch: %(path)s."""
342
class BranchExistsWithoutWorkingTree(PathError):
343
"""Directory contains a branch, but no working tree \
344
(use bzr checkout if you wish to build a working tree): %(path)s"""
347
class AtomicFileAlreadyClosed(PathError):
348
"""'%(function)s' called on an AtomicFile after it was closed: %(path)s"""
350
def __init__(self, path, function):
351
PathError.__init__(self, path=path, extra=None)
352
self.function = function
355
class InaccessibleParent(PathError):
356
"""Parent not accessible given base %(base)s and relative path %(path)s"""
358
def __init__(self, path, base):
359
PathError.__init__(self, path)
363
class NoRepositoryPresent(BzrNewError):
364
"""No repository present: %(path)r"""
365
def __init__(self, bzrdir):
366
BzrNewError.__init__(self)
367
self.path = bzrdir.transport.clone('..').base
370
class FileInWrongBranch(BzrNewError):
371
"""File %(path)s in not in branch %(branch_base)s."""
373
def __init__(self, branch, path):
374
BzrNewError.__init__(self)
376
self.branch_base = branch.base
380
class UnsupportedFormatError(BzrNewError):
381
"""Unsupported branch format: %(format)s"""
384
class UnknownFormatError(BzrNewError):
385
"""Unknown branch format: %(format)r"""
388
class IncompatibleFormat(BzrNewError):
389
"""Format %(format)s is not compatible with .bzr version %(bzrdir)s."""
391
def __init__(self, format, bzrdir_format):
392
BzrNewError.__init__(self)
394
self.bzrdir = bzrdir_format
397
class NotVersionedError(BzrNewError):
398
"""%(path)s is not versioned"""
399
def __init__(self, path):
400
BzrNewError.__init__(self)
404
class PathsNotVersionedError(BzrNewError):
405
# used when reporting several paths are not versioned
406
"""Path(s) are not versioned: %(paths_as_string)s"""
408
def __init__(self, paths):
409
from bzrlib.osutils import quotefn
410
BzrNewError.__init__(self)
412
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
415
class PathsDoNotExist(BzrNewError):
416
"""Path(s) do not exist: %(paths_as_string)s"""
418
# used when reporting that paths are neither versioned nor in the working
421
def __init__(self, paths):
423
from bzrlib.osutils import quotefn
424
BzrNewError.__init__(self)
426
self.paths_as_string = ' '.join([quotefn(p) for p in paths])
429
class BadFileKindError(BzrNewError):
430
"""Cannot operate on %(filename)s of unsupported kind %(kind)s"""
433
class ForbiddenControlFileError(BzrNewError):
434
"""Cannot operate on %(filename)s because it is a control file"""
437
class LockError(BzrNewError):
438
"""Lock error: %(message)s"""
439
# All exceptions from the lock/unlock functions should be from
440
# this exception class. They will be translated as necessary. The
441
# original exception is available as e.original_error
443
# New code should prefer to raise specific subclasses
444
def __init__(self, message):
445
self.message = message
448
class CommitNotPossible(LockError):
449
"""A commit was attempted but we do not have a write lock open."""
454
class AlreadyCommitted(LockError):
455
"""A rollback was requested, but is not able to be accomplished."""
460
class ReadOnlyError(LockError):
461
"""A write attempt was made in a read only transaction on %(obj)s"""
462
def __init__(self, obj):
466
class OutSideTransaction(BzrNewError):
467
"""A transaction related operation was attempted after the transaction finished."""
470
class ObjectNotLocked(LockError):
471
"""%(obj)r is not locked"""
473
is_user_error = False
475
# this can indicate that any particular object is not locked; see also
476
# LockNotHeld which means that a particular *lock* object is not held by
477
# the caller -- perhaps they should be unified.
478
def __init__(self, obj):
482
class ReadOnlyObjectDirtiedError(ReadOnlyError):
483
"""Cannot change object %(obj)r in read only transaction"""
484
def __init__(self, obj):
488
class UnlockableTransport(LockError):
489
"""Cannot lock: transport is read only: %(transport)s"""
490
def __init__(self, transport):
491
self.transport = transport
494
class LockContention(LockError):
495
"""Could not acquire lock %(lock)s"""
496
# TODO: show full url for lock, combining the transport and relative bits?
497
def __init__(self, lock):
501
class LockBroken(LockError):
502
"""Lock was broken while still open: %(lock)s - check storage consistency!"""
503
def __init__(self, lock):
507
class LockBreakMismatch(LockError):
508
"""Lock was released and re-acquired before being broken: %(lock)s: held by %(holder)r, wanted to break %(target)r"""
509
def __init__(self, lock, holder, target):
515
class LockNotHeld(LockError):
516
"""Lock not held: %(lock)s"""
517
def __init__(self, lock):
521
class PointlessCommit(BzrNewError):
522
"""No changes to commit"""
525
class UpgradeReadonly(BzrNewError):
526
"""Upgrade URL cannot work with readonly URL's."""
529
class UpToDateFormat(BzrNewError):
530
"""The branch format %(format)s is already at the most recent format."""
532
def __init__(self, format):
533
BzrNewError.__init__(self)
537
class StrictCommitFailed(Exception):
538
"""Commit refused because there are unknowns in the tree."""
541
class NoSuchRevision(BzrNewError):
542
"""Branch %(branch)s has no revision %(revision)s"""
544
is_user_error = False
546
def __init__(self, branch, revision):
547
BzrNewError.__init__(self, branch=branch, revision=revision)
550
class NoSuchRevisionSpec(BzrNewError):
551
"""No namespace registered for string: %(spec)r"""
553
def __init__(self, spec):
554
BzrNewError.__init__(self, spec=spec)
557
class InvalidRevisionSpec(BzrNewError):
558
"""Requested revision: '%(spec)s' does not exist in branch:
559
%(branch)s%(extra)s"""
561
def __init__(self, spec, branch, extra=None):
562
BzrNewError.__init__(self, branch=branch, spec=spec)
564
self.extra = '\n' + str(extra)
569
class HistoryMissing(BzrError):
570
def __init__(self, branch, object_type, object_id):
572
BzrError.__init__(self,
573
'%s is missing %s {%s}'
574
% (branch, object_type, object_id))
577
class DivergedBranches(BzrNewError):
578
"These branches have diverged. Use the merge command to reconcile them."""
582
def __init__(self, branch1, branch2):
583
self.branch1 = branch1
584
self.branch2 = branch2
587
class UnrelatedBranches(BzrNewError):
588
"Branches have no common ancestor, and no merge base revision was specified."
593
class NoCommonAncestor(BzrNewError):
594
"Revisions have no common ancestor: %(revision_a)s %(revision_b)s"
596
def __init__(self, revision_a, revision_b):
597
self.revision_a = revision_a
598
self.revision_b = revision_b
601
class NoCommonRoot(BzrError):
602
def __init__(self, revision_a, revision_b):
603
msg = "Revisions are not derived from the same root: %s %s." \
604
% (revision_a, revision_b)
605
BzrError.__init__(self, msg)
609
class NotAncestor(BzrError):
610
def __init__(self, rev_id, not_ancestor_id):
611
msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id,
613
BzrError.__init__(self, msg)
615
self.not_ancestor_id = not_ancestor_id
618
class InstallFailed(BzrError):
619
def __init__(self, revisions):
620
msg = "Could not install revisions:\n%s" % " ,".join(revisions)
621
BzrError.__init__(self, msg)
622
self.revisions = revisions
625
class AmbiguousBase(BzrError):
626
def __init__(self, bases):
627
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
629
msg = "The correct base is unclear, because %s are all equally close" %\
631
BzrError.__init__(self, msg)
635
class NoCommits(BzrNewError):
636
"""Branch %(branch)s has no commits."""
638
def __init__(self, branch):
639
BzrNewError.__init__(self, branch=branch)
642
class UnlistableStore(BzrError):
643
def __init__(self, store):
644
BzrError.__init__(self, "Store %s is not listable" % store)
648
class UnlistableBranch(BzrError):
649
def __init__(self, br):
650
BzrError.__init__(self, "Stores for branch %s are not listable" % br)
653
class BoundBranchOutOfDate(BzrNewError):
654
"""Bound branch %(branch)s is out of date with master branch %(master)s."""
655
def __init__(self, branch, master):
656
BzrNewError.__init__(self)
661
class CommitToDoubleBoundBranch(BzrNewError):
662
"""Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."""
663
def __init__(self, branch, master, remote):
664
BzrNewError.__init__(self)
670
class OverwriteBoundBranch(BzrNewError):
671
"""Cannot pull --overwrite to a branch which is bound %(branch)s"""
672
def __init__(self, branch):
673
BzrNewError.__init__(self)
677
class BoundBranchConnectionFailure(BzrNewError):
678
"""Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"""
679
def __init__(self, branch, target, error):
680
BzrNewError.__init__(self)
686
class WeaveError(BzrNewError):
687
"""Error in processing weave: %(message)s"""
689
def __init__(self, message=None):
690
BzrNewError.__init__(self)
691
self.message = message
694
class WeaveRevisionAlreadyPresent(WeaveError):
695
"""Revision {%(revision_id)s} already present in %(weave)s"""
696
def __init__(self, revision_id, weave):
698
WeaveError.__init__(self)
699
self.revision_id = revision_id
703
class WeaveRevisionNotPresent(WeaveError):
704
"""Revision {%(revision_id)s} not present in %(weave)s"""
706
def __init__(self, revision_id, weave):
707
WeaveError.__init__(self)
708
self.revision_id = revision_id
712
class WeaveFormatError(WeaveError):
713
"""Weave invariant violated: %(what)s"""
715
def __init__(self, what):
716
WeaveError.__init__(self)
720
class WeaveParentMismatch(WeaveError):
721
"""Parents are mismatched between two revisions."""
724
class WeaveInvalidChecksum(WeaveError):
725
"""Text did not match it's checksum: %(message)s"""
728
class WeaveTextDiffers(WeaveError):
729
"""Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
731
def __init__(self, revision_id, weave_a, weave_b):
732
WeaveError.__init__(self)
733
self.revision_id = revision_id
734
self.weave_a = weave_a
735
self.weave_b = weave_b
738
class WeaveTextDiffers(WeaveError):
739
"""Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
741
def __init__(self, revision_id, weave_a, weave_b):
742
WeaveError.__init__(self)
743
self.revision_id = revision_id
744
self.weave_a = weave_a
745
self.weave_b = weave_b
748
class VersionedFileError(BzrNewError):
749
"""Versioned file error."""
752
class RevisionNotPresent(VersionedFileError):
753
"""Revision {%(revision_id)s} not present in %(file_id)s."""
755
def __init__(self, revision_id, file_id):
756
VersionedFileError.__init__(self)
757
self.revision_id = revision_id
758
self.file_id = file_id
761
class RevisionAlreadyPresent(VersionedFileError):
762
"""Revision {%(revision_id)s} already present in %(file_id)s."""
764
def __init__(self, revision_id, file_id):
765
VersionedFileError.__init__(self)
766
self.revision_id = revision_id
767
self.file_id = file_id
770
class KnitError(BzrNewError):
774
class KnitHeaderError(KnitError):
775
"""Knit header error: %(badline)r unexpected"""
777
def __init__(self, badline):
778
KnitError.__init__(self)
779
self.badline = badline
782
class KnitCorrupt(KnitError):
783
"""Knit %(filename)s corrupt: %(how)s"""
785
def __init__(self, filename, how):
786
KnitError.__init__(self)
787
self.filename = filename
791
class NoSuchExportFormat(BzrNewError):
792
"""Export format %(format)r not supported"""
793
def __init__(self, format):
794
BzrNewError.__init__(self)
798
class TransportError(BzrNewError):
799
"""Transport error: %(msg)s %(orig_error)s"""
801
def __init__(self, msg=None, orig_error=None):
802
if msg is None and orig_error is not None:
803
msg = str(orig_error)
804
if orig_error is None:
809
self.orig_error = orig_error
810
BzrNewError.__init__(self)
813
class SmartProtocolError(TransportError):
814
"""Generic bzr smart protocol error: %(details)s"""
816
def __init__(self, details):
817
self.details = details
820
# A set of semi-meaningful errors which can be thrown
821
class TransportNotPossible(TransportError):
822
"""Transport operation not possible: %(msg)s %(orig_error)%"""
825
class ConnectionError(TransportError):
826
"""Connection error: %(msg)s %(orig_error)s"""
829
class ConnectionReset(TransportError):
830
"""Connection closed: %(msg)s %(orig_error)s"""
833
class InvalidRange(TransportError):
834
"""Invalid range access in %(path)s at %(offset)s."""
836
def __init__(self, path, offset):
837
TransportError.__init__(self, ("Invalid range access in %s at %d"
843
class InvalidHttpResponse(TransportError):
844
"""Invalid http response for %(path)s: %(msg)s"""
846
def __init__(self, path, msg, orig_error=None):
848
TransportError.__init__(self, msg, orig_error=orig_error)
851
class InvalidHttpRange(InvalidHttpResponse):
852
"""Invalid http range "%(range)s" for %(path)s: %(msg)s"""
854
def __init__(self, path, range, msg):
856
InvalidHttpResponse.__init__(self, path, msg)
859
class InvalidHttpContentType(InvalidHttpResponse):
860
"""Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s"""
862
def __init__(self, path, ctype, msg):
864
InvalidHttpResponse.__init__(self, path, msg)
867
class ConflictsInTree(BzrError):
869
BzrError.__init__(self, "Working tree has conflicts.")
872
class ParseConfigError(BzrError):
873
def __init__(self, errors, filename):
876
message = "Error(s) parsing config file %s:\n%s" % \
877
(filename, ('\n'.join(e.message for e in errors)))
878
BzrError.__init__(self, message)
881
class SigningFailed(BzrError):
882
def __init__(self, command_line):
883
BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
887
class WorkingTreeNotRevision(BzrError):
888
def __init__(self, tree):
889
BzrError.__init__(self, "The working tree for %s has changed since"
890
" last commit, but weave merge requires that it be"
891
" unchanged." % tree.basedir)
894
class CantReprocessAndShowBase(BzrNewError):
895
"""Can't reprocess and show base.
896
Reprocessing obscures relationship of conflicting lines to base."""
899
class GraphCycleError(BzrNewError):
900
"""Cycle in graph %(graph)r"""
901
def __init__(self, graph):
902
BzrNewError.__init__(self)
906
class NotConflicted(BzrNewError):
907
"""File %(filename)s is not conflicted."""
909
def __init__(self, filename):
910
BzrNewError.__init__(self)
911
self.filename = filename
914
class MustUseDecorated(Exception):
915
"""A decorating function has requested its original command be used.
917
This should never escape bzr, so does not need to be printable.
921
class NoBundleFound(BzrNewError):
922
"""No bundle was found in %(filename)s"""
923
def __init__(self, filename):
924
BzrNewError.__init__(self)
925
self.filename = filename
928
class BundleNotSupported(BzrNewError):
929
"""Unable to handle bundle version %(version)s: %(msg)s"""
930
def __init__(self, version, msg):
931
BzrNewError.__init__(self)
932
self.version = version
936
class MissingText(BzrNewError):
937
"""Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"""
939
def __init__(self, branch, text_revision, file_id):
940
BzrNewError.__init__(self)
942
self.base = branch.base
943
self.text_revision = text_revision
944
self.file_id = file_id
947
class DuplicateKey(BzrNewError):
948
"""Key %(key)s is already present in map"""
951
class MalformedTransform(BzrNewError):
952
"""Tree transform is malformed %(conflicts)r"""
955
class BzrBadParameter(BzrNewError):
956
"""A bad parameter : %(param)s is not usable.
958
This exception should never be thrown, but it is a base class for all
959
parameter-to-function errors.
961
def __init__(self, param):
962
BzrNewError.__init__(self)
966
class BzrBadParameterNotUnicode(BzrBadParameter):
967
"""Parameter %(param)s is neither unicode nor utf8."""
970
class ReusingTransform(BzrNewError):
971
"""Attempt to reuse a transform that has already been applied."""
974
class CantMoveRoot(BzrNewError):
975
"""Moving the root directory is not supported at this time"""
978
class BzrBadParameterNotString(BzrBadParameter):
979
"""Parameter %(param)s is not a string or unicode string."""
982
class BzrBadParameterMissing(BzrBadParameter):
983
"""Parameter $(param)s is required but not present."""
986
class BzrBadParameterUnicode(BzrBadParameter):
987
"""Parameter %(param)s is unicode but only byte-strings are permitted."""
990
class BzrBadParameterContainsNewline(BzrBadParameter):
991
"""Parameter %(param)s contains a newline."""
994
class DependencyNotPresent(BzrNewError):
995
"""Unable to import library "%(library)s": %(error)s"""
997
def __init__(self, library, error):
998
BzrNewError.__init__(self, library=library, error=error)
1001
class ParamikoNotPresent(DependencyNotPresent):
1002
"""Unable to import paramiko (required for sftp support): %(error)s"""
1004
def __init__(self, error):
1005
DependencyNotPresent.__init__(self, 'paramiko', error)
1008
class PointlessMerge(BzrNewError):
1009
"""Nothing to merge."""
1012
class UninitializableFormat(BzrNewError):
1013
"""Format %(format)s cannot be initialised by this version of bzr."""
1015
def __init__(self, format):
1016
BzrNewError.__init__(self)
1017
self.format = format
1020
class BadConversionTarget(BzrNewError):
1021
"""Cannot convert to format %(format)s. %(problem)s"""
1023
def __init__(self, problem, format):
1024
BzrNewError.__init__(self)
1025
self.problem = problem
1026
self.format = format
1029
class NoDiff(BzrNewError):
1030
"""Diff is not installed on this machine: %(msg)s"""
1032
def __init__(self, msg):
1033
BzrNewError.__init__(self, msg=msg)
1036
class NoDiff3(BzrNewError):
1037
"""Diff3 is not installed on this machine."""
1040
class ExistingLimbo(BzrNewError):
1041
"""This tree contains left-over files from a failed operation.
1042
Please examine %(limbo_dir)s to see if it contains any files you wish to
1043
keep, and delete it when you are done.
1045
def __init__(self, limbo_dir):
1046
BzrNewError.__init__(self)
1047
self.limbo_dir = limbo_dir
1050
class ImmortalLimbo(BzrNewError):
1051
"""Unable to delete transform temporary directory $(limbo_dir)s.
1052
Please examine %(limbo_dir)s to see if it contains any files you wish to
1053
keep, and delete it when you are done.
1055
def __init__(self, limbo_dir):
1056
BzrNewError.__init__(self)
1057
self.limbo_dir = limbo_dir
1060
class OutOfDateTree(BzrNewError):
1061
"""Working tree is out of date, please run 'bzr update'."""
1063
def __init__(self, tree):
1064
BzrNewError.__init__(self)
1068
class MergeModifiedFormatError(BzrNewError):
1069
"""Error in merge modified format"""
1072
class ConflictFormatError(BzrNewError):
1073
"""Format error in conflict listings"""
1076
class CorruptRepository(BzrNewError):
1077
"""An error has been detected in the repository %(repo_path)s.
1078
Please run bzr reconcile on this repository."""
1080
def __init__(self, repo):
1081
BzrNewError.__init__(self)
1082
self.repo_path = repo.bzrdir.root_transport.base
1085
class UpgradeRequired(BzrNewError):
1086
"""To use this feature you must upgrade your branch at %(path)s."""
1088
def __init__(self, path):
1089
BzrNewError.__init__(self)
1093
class LocalRequiresBoundBranch(BzrNewError):
1094
"""Cannot perform local-only commits on unbound branches."""
1097
class MissingProgressBarFinish(BzrNewError):
1098
"""A nested progress bar was not 'finished' correctly."""
1101
class InvalidProgressBarType(BzrNewError):
1102
"""Environment variable BZR_PROGRESS_BAR='%(bar_type)s is not a supported type
1103
Select one of: %(valid_types)s"""
1105
def __init__(self, bar_type, valid_types):
1106
BzrNewError.__init__(self, bar_type=bar_type, valid_types=valid_types)
1109
class UnsupportedOperation(BzrNewError):
1110
"""The method %(mname)s is not supported on objects of type %(tname)s."""
1111
def __init__(self, method, method_self):
1112
self.method = method
1113
self.mname = method.__name__
1114
self.tname = type(method_self).__name__
1117
class BinaryFile(BzrNewError):
1118
"""File is binary but should be text."""
1121
class IllegalPath(BzrNewError):
1122
"""The path %(path)s is not permitted on this platform"""
1124
def __init__(self, path):
1125
BzrNewError.__init__(self)
1129
class TestamentMismatch(BzrNewError):
1130
"""Testament did not match expected value.
1131
For revision_id {%(revision_id)s}, expected {%(expected)s}, measured
1134
def __init__(self, revision_id, expected, measured):
1135
self.revision_id = revision_id
1136
self.expected = expected
1137
self.measured = measured
1140
class NotABundle(BzrNewError):
1141
"""Not a bzr revision-bundle: %(text)r"""
1143
def __init__(self, text):
1144
BzrNewError.__init__(self)
1148
class BadBundle(BzrNewError):
1149
"""Bad bzr revision-bundle: %(text)r"""
1151
def __init__(self, text):
1152
BzrNewError.__init__(self)
1156
class MalformedHeader(BadBundle):
1157
"""Malformed bzr revision-bundle header: %(text)r"""
1159
def __init__(self, text):
1160
BzrNewError.__init__(self)
1164
class MalformedPatches(BadBundle):
1165
"""Malformed patches in bzr revision-bundle: %(text)r"""
1167
def __init__(self, text):
1168
BzrNewError.__init__(self)
1172
class MalformedFooter(BadBundle):
1173
"""Malformed footer in bzr revision-bundle: %(text)r"""
1175
def __init__(self, text):
1176
BzrNewError.__init__(self)
1180
class UnsupportedEOLMarker(BadBundle):
1181
"""End of line marker was not \\n in bzr revision-bundle"""
1184
BzrNewError.__init__(self)
1187
class BadInventoryFormat(BzrNewError):
1188
"""Root class for inventory serialization errors"""
1191
class UnexpectedInventoryFormat(BadInventoryFormat):
1192
"""The inventory was not in the expected format:\n %(msg)s"""
1194
def __init__(self, msg):
1195
BadInventoryFormat.__init__(self, msg=msg)
1198
class NoSmartServer(NotBranchError):
1199
"""No smart server available at %(url)s"""
1201
def __init__(self, url):
1205
class UnknownSSH(BzrNewError):
1206
"""Unrecognised value for BZR_SSH environment variable: %(vendor)s"""
1208
def __init__(self, vendor):
1209
BzrNewError.__init__(self)
1210
self.vendor = vendor
1213
class GhostRevisionUnusableHere(BzrNewError):
1214
"""Ghost revision {%(revision_id)s} cannot be used here."""
1216
def __init__(self, revision_id):
1217
BzrNewError.__init__(self)
1218
self.revision_id = revision_id
1221
class IllegalUseOfScopeReplacer(BzrNewError):
1222
"""ScopeReplacer object %(name)r was used incorrectly: %(msg)s%(extra)s"""
1224
is_user_error = False
1226
def __init__(self, name, msg, extra=None):
1227
BzrNewError.__init__(self)
1231
self.extra = ': ' + str(extra)
1236
class InvalidImportLine(BzrNewError):
1237
"""Not a valid import statement: %(msg)\n%(text)s"""
1239
is_user_error = False
1241
def __init__(self, text, msg):
1242
BzrNewError.__init__(self)
1247
class ImportNameCollision(BzrNewError):
1248
"""Tried to import an object to the same name as an existing object. %(name)s"""
1250
is_user_error = False
1252
def __init__(self, name):
1253
BzrNewError.__init__(self)
added
removed
bzrlib/errors.py
