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
Exceptions are caught at a high level to report errors to the user, and
 
 
20
might also be caught inside the program.  Therefore it needs to be
 
 
21
possible to convert them to a meaningful string, and also for them to be
 
 
22
interrogated by the program.
 
 
24
Exceptions are defined such that the arguments given to the constructor
 
 
25
are stored in the object as properties of the same name.  When the
 
 
26
object is printed as a string, the doc string of the class is used as
 
 
27
a format string with the property dictionary available to it.
 
 
29
This means that exceptions can used like this:
 
 
33
...   raise NotBranchError(path='/foo/bar')
 
 
35
...   print sys.exc_type
 
 
36
...   print sys.exc_value
 
 
37
...   path = getattr(sys.exc_value, 'path', None)
 
 
38
...   if path is not None:
 
 
40
bzrlib.errors.NotBranchError
 
 
41
Not a branch: /foo/bar
 
 
46
 * create a new exception class for any class of error that can be
 
 
47
   usefully distinguished.
 
 
49
 * the printable form of an exception is generated by the base class
 
 
52
Exception strings should start with a capital letter and not have a final
 
 
56
from warnings import warn
 
 
58
from bzrlib.patches import (PatchSyntax, 
 
 
65
# based on Scott James Remnant's hct error classes
 
 
67
# TODO: is there any value in providing the .args field used by standard
 
 
68
# python exceptions?   A list of values with no names seems less useful 
 
 
71
# TODO: Perhaps convert the exception to a string at the moment it's 
 
 
72
# constructed to make sure it will succeed.  But that says nothing about
 
 
73
# exceptions that are never raised.
 
 
75
# TODO: Convert all the other error classes here to BzrNewError, and eliminate
 
 
78
# TODO: The pattern (from hct) of using classes docstrings as message
 
 
79
# templates is cute but maybe not such a great idea - perhaps should have a
 
 
80
# separate static message_template.
 
 
83
class BzrError(StandardError):
 
 
85
        # XXX: Should we show the exception class in 
 
 
86
        # exceptions that don't provide their own message?  
 
 
87
        # maybe it should be done at a higher level
 
 
88
        ## n = self.__class__.__name__ + ': '
 
 
90
        if len(self.args) == 1:
 
 
91
            return str(self.args[0])
 
 
92
        elif len(self.args) == 2:
 
 
93
            # further explanation or suggestions
 
 
95
                return n + '\n  '.join([self.args[0]] + self.args[1])
 
 
97
                return n + "%r" % self
 
 
99
            return n + `self.args`
 
 
102
class BzrNewError(BzrError):
 
 
104
    # base classes should override the docstring with their human-
 
 
105
    # readable explanation
 
 
107
    def __init__(self, **kwds):
 
 
108
        for key, value in kwds.items():
 
 
109
            setattr(self, key, value)
 
 
113
            return self.__doc__ % self.__dict__
 
 
114
        except (NameError, ValueError, KeyError), e:
 
 
115
            return 'Unprintable exception %s: %s' \
 
 
116
                % (self.__class__.__name__, str(e))
 
 
119
class BzrCheckError(BzrNewError):
 
 
120
    """Internal check failed: %(message)s"""
 
 
122
    def __init__(self, message):
 
 
123
        BzrNewError.__init__(self)
 
 
124
        self.message = message
 
 
127
class InvalidEntryName(BzrNewError):
 
 
128
    """Invalid entry name: %(name)s"""
 
 
129
    def __init__(self, name):
 
 
130
        BzrNewError.__init__(self)
 
 
134
class InvalidRevisionNumber(BzrNewError):
 
 
135
    """Invalid revision number %(revno)d"""
 
 
136
    def __init__(self, revno):
 
 
137
        BzrNewError.__init__(self)
 
 
141
class InvalidRevisionId(BzrNewError):
 
 
142
    """Invalid revision-id {%(revision_id)s} in %(branch)s"""
 
 
143
    def __init__(self, revision_id, branch):
 
 
144
        # branch can be any string or object with __str__ defined
 
 
145
        BzrNewError.__init__(self)
 
 
146
        self.revision_id = revision_id
 
 
150
class NoWorkingTree(BzrNewError):
 
 
151
    """No WorkingTree exists for %(base)s."""
 
 
153
    def __init__(self, base):
 
 
154
        BzrNewError.__init__(self)
 
 
158
class NotLocalUrl(BzrNewError):
 
 
159
    """%(url)s is not a local path."""
 
 
161
    def __init__(self, url):
 
 
162
        BzrNewError.__init__(self)
 
 
166
class BzrCommandError(BzrError):
 
 
167
    # Error from malformed user command
 
 
168
    # This is being misused as a generic exception
 
 
169
    # please subclass. RBC 20051030
 
 
171
    # I think it's a waste of effort to differentiate between errors that
 
 
172
    # are not intended to be caught anyway.  UI code need not subclass
 
 
173
    # BzrCommandError, and non-UI code should not throw a subclass of
 
 
174
    # BzrCommandError.  ADHB 20051211
 
 
179
class BzrOptionError(BzrCommandError):
 
 
180
    """Some missing or otherwise incorrect option was supplied."""
 
 
183
class StrictCommitFailed(Exception):
 
 
184
    """Commit refused because there are unknowns in the tree."""
 
 
187
# XXX: Should be unified with TransportError; they seem to represent the
 
 
189
class PathError(BzrNewError):
 
 
190
    """Generic path error: %(path)r%(extra)s)"""
 
 
192
    def __init__(self, path, extra=None):
 
 
193
        BzrNewError.__init__(self)
 
 
196
            self.extra = ': ' + str(extra)
 
 
201
class NoSuchFile(PathError):
 
 
202
    """No such file: %(path)r%(extra)s"""
 
 
205
class FileExists(PathError):
 
 
206
    """File exists: %(path)r%(extra)s"""
 
 
209
class DirectoryNotEmpty(PathError):
 
 
210
    """Directory not empty: %(path)r%(extra)s"""
 
 
213
class ResourceBusy(PathError):
 
 
214
    """Device or resource busy: %(path)r%(extra)s"""
 
 
217
class PermissionDenied(PathError):
 
 
218
    """Permission denied: %(path)r%(extra)s"""
 
 
221
class InvalidURL(PathError):
 
 
222
    """Invalid url supplied to transport: %(path)r%(extra)s"""
 
 
225
class InvalidURLJoin(PathError):
 
 
226
    """Invalid URL join request: %(args)s%(extra)s"""
 
 
228
    def __init__(self, msg, base, args):
 
 
229
        PathError.__init__(self, base, msg)
 
 
231
        self.args.extend(args)
 
 
234
class PathNotChild(BzrNewError):
 
 
235
    """Path %(path)r is not a child of path %(base)r%(extra)s"""
 
 
236
    def __init__(self, path, base, extra=None):
 
 
237
        BzrNewError.__init__(self)
 
 
241
            self.extra = ': ' + str(extra)
 
 
246
# TODO: This is given a URL; we try to unescape it but doing that from inside
 
 
247
# the exception object is a bit undesirable.
 
 
248
# TODO: Probably this behavior of should be a common superclass 
 
 
249
class NotBranchError(PathError):
 
 
250
    """Not a branch: %(path)s"""
 
 
252
    def __init__(self, path):
 
 
253
       import bzrlib.urlutils as urlutils
 
 
254
       self.path = urlutils.unescape_for_display(path, 'ascii')
 
 
257
class AlreadyBranchError(PathError):
 
 
258
    """Already a branch: %(path)s."""
 
 
261
class BranchExistsWithoutWorkingTree(PathError):
 
 
262
    """Directory contains a branch, but no working tree \
 
 
263
(use bzr checkout if you wish to build a working tree): %(path)s"""
 
 
266
class NoRepositoryPresent(BzrNewError):
 
 
267
    """No repository present: %(path)r"""
 
 
268
    def __init__(self, bzrdir):
 
 
269
        BzrNewError.__init__(self)
 
 
270
        self.path = bzrdir.transport.clone('..').base
 
 
273
class FileInWrongBranch(BzrNewError):
 
 
274
    """File %(path)s in not in branch %(branch_base)s."""
 
 
276
    def __init__(self, branch, path):
 
 
277
        BzrNewError.__init__(self)
 
 
279
        self.branch_base = branch.base
 
 
283
class UnsupportedFormatError(BzrError):
 
 
284
    """Specified path is a bzr branch that we recognize but cannot read."""
 
 
286
        return 'unsupported branch format: %s' % self.args[0]
 
 
289
class UnknownFormatError(BzrError):
 
 
290
    """Specified path is a bzr branch whose format we do not recognize."""
 
 
292
        return 'unknown branch format: %s' % self.args[0]
 
 
295
class IncompatibleFormat(BzrNewError):
 
 
296
    """Format %(format)s is not compatible with .bzr version %(bzrdir)s."""
 
 
298
    def __init__(self, format, bzrdir_format):
 
 
299
        BzrNewError.__init__(self)
 
 
301
        self.bzrdir = bzrdir_format
 
 
304
class NotVersionedError(BzrNewError):
 
 
305
    """%(path)s is not versioned"""
 
 
306
    def __init__(self, path):
 
 
307
        BzrNewError.__init__(self)
 
 
311
class PathsNotVersionedError(BzrNewError):
 
 
312
    # used when reporting several paths are not versioned
 
 
313
    """Path(s) are not versioned: %(paths_as_string)s"""
 
 
315
    def __init__(self, paths):
 
 
316
        from bzrlib.osutils import quotefn
 
 
317
        BzrNewError.__init__(self)
 
 
319
        self.paths_as_string = ' '.join([quotefn(p) for p in paths])
 
 
322
class PathsDoNotExist(BzrNewError):
 
 
323
    """Path(s) do not exist: %(paths_as_string)s"""
 
 
325
    # used when reporting that paths are neither versioned nor in the working
 
 
328
    def __init__(self, paths):
 
 
330
        from bzrlib.osutils import quotefn
 
 
331
        BzrNewError.__init__(self)
 
 
333
        self.paths_as_string = ' '.join([quotefn(p) for p in paths])
 
 
336
class BadFileKindError(BzrError):
 
 
337
    """Specified file is of a kind that cannot be added.
 
 
339
    (For example a symlink or device file.)"""
 
 
342
class ForbiddenFileError(BzrError):
 
 
343
    """Cannot operate on a file because it is a control file."""
 
 
346
class LockError(BzrNewError):
 
 
347
    """Lock error: %(message)s"""
 
 
348
    # All exceptions from the lock/unlock functions should be from
 
 
349
    # this exception class.  They will be translated as necessary. The
 
 
350
    # original exception is available as e.original_error
 
 
352
    # New code should prefer to raise specific subclasses
 
 
353
    def __init__(self, message):
 
 
354
        self.message = message
 
 
357
class CommitNotPossible(LockError):
 
 
358
    """A commit was attempted but we do not have a write lock open."""
 
 
363
class AlreadyCommitted(LockError):
 
 
364
    """A rollback was requested, but is not able to be accomplished."""
 
 
369
class ReadOnlyError(LockError):
 
 
370
    """A write attempt was made in a read only transaction on %(obj)s"""
 
 
371
    def __init__(self, obj):
 
 
375
class OutSideTransaction(BzrNewError):
 
 
376
    """A transaction related operation was attempted after the transaction finished."""
 
 
379
class ObjectNotLocked(LockError):
 
 
380
    """%(obj)r is not locked"""
 
 
381
    # this can indicate that any particular object is not locked; see also
 
 
382
    # LockNotHeld which means that a particular *lock* object is not held by
 
 
383
    # the caller -- perhaps they should be unified.
 
 
384
    def __init__(self, obj):
 
 
388
class ReadOnlyObjectDirtiedError(ReadOnlyError):
 
 
389
    """Cannot change object %(obj)r in read only transaction"""
 
 
390
    def __init__(self, obj):
 
 
394
class UnlockableTransport(LockError):
 
 
395
    """Cannot lock: transport is read only: %(transport)s"""
 
 
396
    def __init__(self, transport):
 
 
397
        self.transport = transport
 
 
400
class LockContention(LockError):
 
 
401
    """Could not acquire lock %(lock)s"""
 
 
402
    # TODO: show full url for lock, combining the transport and relative bits?
 
 
403
    def __init__(self, lock):
 
 
407
class LockBroken(LockError):
 
 
408
    """Lock was broken while still open: %(lock)s - check storage consistency!"""
 
 
409
    def __init__(self, lock):
 
 
413
class LockBreakMismatch(LockError):
 
 
414
    """Lock was released and re-acquired before being broken: %(lock)s: held by %(holder)r, wanted to break %(target)r"""
 
 
415
    def __init__(self, lock, holder, target):
 
 
421
class LockNotHeld(LockError):
 
 
422
    """Lock not held: %(lock)s"""
 
 
423
    def __init__(self, lock):
 
 
427
class PointlessCommit(BzrNewError):
 
 
428
    """No changes to commit"""
 
 
431
class UpgradeReadonly(BzrNewError):
 
 
432
    """Upgrade URL cannot work with readonly URL's."""
 
 
435
class UpToDateFormat(BzrNewError):
 
 
436
    """The branch format %(format)s is already at the most recent format."""
 
 
438
    def __init__(self, format):
 
 
439
        BzrNewError.__init__(self)
 
 
444
class StrictCommitFailed(Exception):
 
 
445
    """Commit refused because there are unknowns in the tree."""
 
 
448
class NoSuchRevision(BzrError):
 
 
449
    def __init__(self, branch, revision):
 
 
451
        self.revision = revision
 
 
452
        msg = "Branch %s has no revision %s" % (branch, revision)
 
 
453
        BzrError.__init__(self, msg)
 
 
456
class HistoryMissing(BzrError):
 
 
457
    def __init__(self, branch, object_type, object_id):
 
 
459
        BzrError.__init__(self,
 
 
460
                          '%s is missing %s {%s}'
 
 
461
                          % (branch, object_type, object_id))
 
 
464
class DivergedBranches(BzrError):
 
 
466
    def __init__(self, branch1, branch2):
 
 
467
        BzrError.__init__(self, "These branches have diverged.  Try merge.")
 
 
468
        self.branch1 = branch1
 
 
469
        self.branch2 = branch2
 
 
472
class UnrelatedBranches(BzrCommandError):
 
 
474
        msg = "Branches have no common ancestor, and no base revision"\
 
 
476
        BzrCommandError.__init__(self, msg)
 
 
479
class NoCommonAncestor(BzrError):
 
 
480
    def __init__(self, revision_a, revision_b):
 
 
481
        msg = "Revisions have no common ancestor: %s %s." \
 
 
482
            % (revision_a, revision_b) 
 
 
483
        BzrError.__init__(self, msg)
 
 
486
class NoCommonRoot(BzrError):
 
 
487
    def __init__(self, revision_a, revision_b):
 
 
488
        msg = "Revisions are not derived from the same root: %s %s." \
 
 
489
            % (revision_a, revision_b) 
 
 
490
        BzrError.__init__(self, msg)
 
 
494
class NotAncestor(BzrError):
 
 
495
    def __init__(self, rev_id, not_ancestor_id):
 
 
496
        msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id, 
 
 
498
        BzrError.__init__(self, msg)
 
 
500
        self.not_ancestor_id = not_ancestor_id
 
 
503
class InstallFailed(BzrError):
 
 
504
    def __init__(self, revisions):
 
 
505
        msg = "Could not install revisions:\n%s" % " ,".join(revisions)
 
 
506
        BzrError.__init__(self, msg)
 
 
507
        self.revisions = revisions
 
 
510
class AmbiguousBase(BzrError):
 
 
511
    def __init__(self, bases):
 
 
512
        warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
 
 
514
        msg = "The correct base is unclear, because %s are all equally close" %\
 
 
516
        BzrError.__init__(self, msg)
 
 
520
class NoCommits(BzrError):
 
 
521
    def __init__(self, branch):
 
 
522
        msg = "Branch %s has no commits." % branch
 
 
523
        BzrError.__init__(self, msg)
 
 
526
class UnlistableStore(BzrError):
 
 
527
    def __init__(self, store):
 
 
528
        BzrError.__init__(self, "Store %s is not listable" % store)
 
 
532
class UnlistableBranch(BzrError):
 
 
533
    def __init__(self, br):
 
 
534
        BzrError.__init__(self, "Stores for branch %s are not listable" % br)
 
 
537
class BoundBranchOutOfDate(BzrNewError):
 
 
538
    """Bound branch %(branch)s is out of date with master branch %(master)s."""
 
 
539
    def __init__(self, branch, master):
 
 
540
        BzrNewError.__init__(self)
 
 
545
class CommitToDoubleBoundBranch(BzrNewError):
 
 
546
    """Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."""
 
 
547
    def __init__(self, branch, master, remote):
 
 
548
        BzrNewError.__init__(self)
 
 
554
class OverwriteBoundBranch(BzrNewError):
 
 
555
    """Cannot pull --overwrite to a branch which is bound %(branch)s"""
 
 
556
    def __init__(self, branch):
 
 
557
        BzrNewError.__init__(self)
 
 
561
class BoundBranchConnectionFailure(BzrNewError):
 
 
562
    """Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"""
 
 
563
    def __init__(self, branch, target, error):
 
 
564
        BzrNewError.__init__(self)
 
 
570
class WeaveError(BzrNewError):
 
 
571
    """Error in processing weave: %(message)s"""
 
 
573
    def __init__(self, message=None):
 
 
574
        BzrNewError.__init__(self)
 
 
575
        self.message = message
 
 
578
class WeaveRevisionAlreadyPresent(WeaveError):
 
 
579
    """Revision {%(revision_id)s} already present in %(weave)s"""
 
 
580
    def __init__(self, revision_id, weave):
 
 
582
        WeaveError.__init__(self)
 
 
583
        self.revision_id = revision_id
 
 
587
class WeaveRevisionNotPresent(WeaveError):
 
 
588
    """Revision {%(revision_id)s} not present in %(weave)s"""
 
 
590
    def __init__(self, revision_id, weave):
 
 
591
        WeaveError.__init__(self)
 
 
592
        self.revision_id = revision_id
 
 
596
class WeaveFormatError(WeaveError):
 
 
597
    """Weave invariant violated: %(what)s"""
 
 
599
    def __init__(self, what):
 
 
600
        WeaveError.__init__(self)
 
 
604
class WeaveParentMismatch(WeaveError):
 
 
605
    """Parents are mismatched between two revisions."""
 
 
608
class WeaveInvalidChecksum(WeaveError):
 
 
609
    """Text did not match it's checksum: %(message)s"""
 
 
612
class WeaveTextDiffers(WeaveError):
 
 
613
    """Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
 
 
615
    def __init__(self, revision_id, weave_a, weave_b):
 
 
616
        WeaveError.__init__(self)
 
 
617
        self.revision_id = revision_id
 
 
618
        self.weave_a = weave_a
 
 
619
        self.weave_b = weave_b
 
 
622
class WeaveTextDiffers(WeaveError):
 
 
623
    """Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
 
 
625
    def __init__(self, revision_id, weave_a, weave_b):
 
 
626
        WeaveError.__init__(self)
 
 
627
        self.revision_id = revision_id
 
 
628
        self.weave_a = weave_a
 
 
629
        self.weave_b = weave_b
 
 
632
class VersionedFileError(BzrNewError):
 
 
633
    """Versioned file error."""
 
 
636
class RevisionNotPresent(VersionedFileError):
 
 
637
    """Revision {%(revision_id)s} not present in %(file_id)s."""
 
 
639
    def __init__(self, revision_id, file_id):
 
 
640
        VersionedFileError.__init__(self)
 
 
641
        self.revision_id = revision_id
 
 
642
        self.file_id = file_id
 
 
645
class RevisionAlreadyPresent(VersionedFileError):
 
 
646
    """Revision {%(revision_id)s} already present in %(file_id)s."""
 
 
648
    def __init__(self, revision_id, file_id):
 
 
649
        VersionedFileError.__init__(self)
 
 
650
        self.revision_id = revision_id
 
 
651
        self.file_id = file_id
 
 
654
class KnitError(BzrNewError):
 
 
658
class KnitHeaderError(KnitError):
 
 
659
    """Knit header error: %(badline)r unexpected"""
 
 
661
    def __init__(self, badline):
 
 
662
        KnitError.__init__(self)
 
 
663
        self.badline = badline
 
 
666
class KnitCorrupt(KnitError):
 
 
667
    """Knit %(filename)s corrupt: %(how)s"""
 
 
669
    def __init__(self, filename, how):
 
 
670
        KnitError.__init__(self)
 
 
671
        self.filename = filename
 
 
675
class NoSuchExportFormat(BzrNewError):
 
 
676
    """Export format %(format)r not supported"""
 
 
677
    def __init__(self, format):
 
 
678
        BzrNewError.__init__(self)
 
 
682
class TransportError(BzrError):
 
 
683
    """All errors thrown by Transport implementations should derive
 
 
686
    def __init__(self, msg=None, orig_error=None):
 
 
687
        if msg is None and orig_error is not None:
 
 
688
            msg = str(orig_error)
 
 
689
        BzrError.__init__(self, msg)
 
 
691
        self.orig_error = orig_error
 
 
694
# A set of semi-meaningful errors which can be thrown
 
 
695
class TransportNotPossible(TransportError):
 
 
696
    """This is for transports where a specific function is explicitly not
 
 
697
    possible. Such as pushing files to an HTTP server.
 
 
702
class ConnectionError(TransportError):
 
 
703
    """A connection problem prevents file retrieval.
 
 
704
    This does not indicate whether the file exists or not; it indicates that a
 
 
705
    precondition for requesting the file was not met.
 
 
707
    def __init__(self, msg=None, orig_error=None):
 
 
708
        TransportError.__init__(self, msg=msg, orig_error=orig_error)
 
 
711
class ConnectionReset(TransportError):
 
 
712
    """The connection has been closed."""
 
 
716
class ConflictsInTree(BzrError):
 
 
718
        BzrError.__init__(self, "Working tree has conflicts.")
 
 
721
class ParseConfigError(BzrError):
 
 
722
    def __init__(self, errors, filename):
 
 
725
        message = "Error(s) parsing config file %s:\n%s" % \
 
 
726
            (filename, ('\n'.join(e.message for e in errors)))
 
 
727
        BzrError.__init__(self, message)
 
 
730
class SigningFailed(BzrError):
 
 
731
    def __init__(self, command_line):
 
 
732
        BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
 
 
736
class WorkingTreeNotRevision(BzrError):
 
 
737
    def __init__(self, tree):
 
 
738
        BzrError.__init__(self, "The working tree for %s has changed since"
 
 
739
                          " last commit, but weave merge requires that it be"
 
 
740
                          " unchanged." % tree.basedir)
 
 
743
class CantReprocessAndShowBase(BzrNewError):
 
 
744
    """Can't reprocess and show base.
 
 
745
Reprocessing obscures relationship of conflicting lines to base."""
 
 
748
class GraphCycleError(BzrNewError):
 
 
749
    """Cycle in graph %(graph)r"""
 
 
750
    def __init__(self, graph):
 
 
751
        BzrNewError.__init__(self)
 
 
755
class NotConflicted(BzrNewError):
 
 
756
    """File %(filename)s is not conflicted."""
 
 
758
    def __init__(self, filename):
 
 
759
        BzrNewError.__init__(self)
 
 
760
        self.filename = filename
 
 
763
class MustUseDecorated(Exception):
 
 
764
    """A decorating function has requested its original command be used.
 
 
766
    This should never escape bzr, so does not need to be printable.
 
 
770
class NoBundleFound(BzrNewError):
 
 
771
    """No bundle was found in %(filename)s"""
 
 
772
    def __init__(self, filename):
 
 
773
        BzrNewError.__init__(self)
 
 
774
        self.filename = filename
 
 
777
class BundleNotSupported(BzrNewError):
 
 
778
    """Unable to handle bundle version %(version)s: %(msg)s"""
 
 
779
    def __init__(self, version, msg):
 
 
780
        BzrNewError.__init__(self)
 
 
781
        self.version = version
 
 
785
class MissingText(BzrNewError):
 
 
786
    """Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"""
 
 
788
    def __init__(self, branch, text_revision, file_id):
 
 
789
        BzrNewError.__init__(self)
 
 
791
        self.base = branch.base
 
 
792
        self.text_revision = text_revision
 
 
793
        self.file_id = file_id
 
 
796
class DuplicateKey(BzrNewError):
 
 
797
    """Key %(key)s is already present in map"""
 
 
800
class MalformedTransform(BzrNewError):
 
 
801
    """Tree transform is malformed %(conflicts)r"""
 
 
804
class BzrBadParameter(BzrNewError):
 
 
805
    """A bad parameter : %(param)s is not usable.
 
 
807
    This exception should never be thrown, but it is a base class for all
 
 
808
    parameter-to-function errors.
 
 
810
    def __init__(self, param):
 
 
811
        BzrNewError.__init__(self)
 
 
815
class BzrBadParameterNotUnicode(BzrBadParameter):
 
 
816
    """Parameter %(param)s is neither unicode nor utf8."""
 
 
819
class ReusingTransform(BzrNewError):
 
 
820
    """Attempt to reuse a transform that has already been applied."""
 
 
823
class CantMoveRoot(BzrNewError):
 
 
824
    """Moving the root directory is not supported at this time"""
 
 
827
class BzrBadParameterNotString(BzrBadParameter):
 
 
828
    """Parameter %(param)s is not a string or unicode string."""
 
 
831
class BzrBadParameterMissing(BzrBadParameter):
 
 
832
    """Parameter $(param)s is required but not present."""
 
 
835
class BzrBadParameterUnicode(BzrBadParameter):
 
 
836
    """Parameter %(param)s is unicode but only byte-strings are permitted."""
 
 
839
class BzrBadParameterContainsNewline(BzrBadParameter):
 
 
840
    """Parameter %(param)s contains a newline."""
 
 
843
class DependencyNotPresent(BzrNewError):
 
 
844
    """Unable to import library "%(library)s": %(error)s"""
 
 
846
    def __init__(self, library, error):
 
 
847
        BzrNewError.__init__(self, library=library, error=error)
 
 
850
class ParamikoNotPresent(DependencyNotPresent):
 
 
851
    """Unable to import paramiko (required for sftp support): %(error)s"""
 
 
853
    def __init__(self, error):
 
 
854
        DependencyNotPresent.__init__(self, 'paramiko', error)
 
 
857
class UninitializableFormat(BzrNewError):
 
 
858
    """Format %(format)s cannot be initialised by this version of bzr."""
 
 
860
    def __init__(self, format):
 
 
861
        BzrNewError.__init__(self)
 
 
865
class NoDiff(BzrNewError):
 
 
866
    """Diff is not installed on this machine: %(msg)s"""
 
 
868
    def __init__(self, msg):
 
 
869
        super(NoDiff, self).__init__(msg=msg)
 
 
872
class NoDiff3(BzrNewError):
 
 
873
    """Diff3 is not installed on this machine."""
 
 
876
class ExistingLimbo(BzrNewError):
 
 
877
    """This tree contains left-over files from a failed operation.
 
 
878
    Please examine %(limbo_dir)s to see if it contains any files you wish to
 
 
879
    keep, and delete it when you are done.
 
 
881
    def __init__(self, limbo_dir):
 
 
882
       BzrNewError.__init__(self)
 
 
883
       self.limbo_dir = limbo_dir
 
 
886
class ImmortalLimbo(BzrNewError):
 
 
887
    """Unable to delete transform temporary directory $(limbo_dir)s.
 
 
888
    Please examine %(limbo_dir)s to see if it contains any files you wish to
 
 
889
    keep, and delete it when you are done.
 
 
891
    def __init__(self, limbo_dir):
 
 
892
       BzrNewError.__init__(self)
 
 
893
       self.limbo_dir = limbo_dir
 
 
896
class OutOfDateTree(BzrNewError):
 
 
897
    """Working tree is out of date, please run 'bzr update'."""
 
 
899
    def __init__(self, tree):
 
 
900
        BzrNewError.__init__(self)
 
 
904
class MergeModifiedFormatError(BzrNewError):
 
 
905
    """Error in merge modified format"""
 
 
908
class ConflictFormatError(BzrNewError):
 
 
909
    """Format error in conflict listings"""
 
 
912
class CorruptRepository(BzrNewError):
 
 
913
    """An error has been detected in the repository %(repo_path)s.
 
 
914
Please run bzr reconcile on this repository."""
 
 
916
    def __init__(self, repo):
 
 
917
        BzrNewError.__init__(self)
 
 
918
        self.repo_path = repo.bzrdir.root_transport.base
 
 
921
class UpgradeRequired(BzrNewError):
 
 
922
    """To use this feature you must upgrade your branch at %(path)s."""
 
 
924
    def __init__(self, path):
 
 
925
        BzrNewError.__init__(self)
 
 
929
class LocalRequiresBoundBranch(BzrNewError):
 
 
930
    """Cannot perform local-only commits on unbound branches."""
 
 
933
class MissingProgressBarFinish(BzrNewError):
 
 
934
    """A nested progress bar was not 'finished' correctly."""
 
 
937
class UnsupportedOperation(BzrNewError):
 
 
938
    """The method %(mname)s is not supported on objects of type %(tname)s."""
 
 
939
    def __init__(self, method, method_self):
 
 
941
        self.mname = method.__name__
 
 
942
        self.tname = type(method_self).__name__
 
 
945
class BinaryFile(BzrNewError):
 
 
946
    """File is binary but should be text."""
 
 
949
class IllegalPath(BzrNewError):
 
 
950
    """The path %(path)s is not permitted on this platform"""
 
 
952
    def __init__(self, path):
 
 
953
        BzrNewError.__init__(self)
 
 
957
class TestamentMismatch(BzrNewError):
 
 
958
    """Testament did not match expected value.  
 
 
959
       For revision_id {%(revision_id)s}, expected {%(expected)s}, measured 
 
 
962
    def __init__(self, revision_id, expected, measured):
 
 
963
        self.revision_id = revision_id
 
 
964
        self.expected = expected
 
 
965
        self.measured = measured
 
 
968
class NotABundle(BzrNewError):
 
 
969
    """Not a bzr revision-bundle: %(text)r"""
 
 
971
    def __init__(self, text):
 
 
975
class BadBundle(Exception): pass
 
 
978
class MalformedHeader(BadBundle): pass
 
 
981
class MalformedPatches(BadBundle): pass
 
 
984
class MalformedFooter(BadBundle): pass