← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/errors.py

  • Committer: John Arbash Meinel
  • Date: 2010-02-17 17:11:16 UTC
  • mfrom: (4797.2.17 2.1)
  • mto: (4797.2.18 2.1)
  • mto: This revision was merged to the branch mainline in revision 5055.
  • Revision ID: john@arbash-meinel.com-20100217171116-h7t9223ystbnx5h8
merge bzr.2.1 in preparation for NEWS entry.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/errors.py
1
 
# Copyright (C) 2005-2011 Canonical Ltd
 
1
# Copyright (C) 2005-2010 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
17
17
"""Exceptions for bzr, and reporting of them.
18
18
"""
19
19
 
20
 
from __future__ import absolute_import
 
20
from bzrlib import (
 
21
    osutils,
 
22
    symbol_versioning,
 
23
    )
 
24
from bzrlib.patches import (
 
25
    MalformedHunkHeader,
 
26
    MalformedLine,
 
27
    MalformedPatchHeader,
 
28
    PatchConflict,
 
29
    PatchSyntax,
 
30
    )
 
31
 
21
32
 
22
33
# TODO: is there any value in providing the .args field used by standard
23
34
# python exceptions?   A list of values with no names seems less useful
43
54
    Base class for errors raised by bzrlib.
44
55
 
45
56
    :cvar internal_error: if True this was probably caused by a bzr bug and
46
 
        should be displayed with a traceback; if False (or absent) this was
47
 
        probably a user or environment error and they don't need the gory
48
 
        details.  (That can be overridden by -Derror on the command line.)
 
57
    should be displayed with a traceback; if False (or absent) this was
 
58
    probably a user or environment error and they don't need the gory details.
 
59
    (That can be overridden by -Derror on the command line.)
49
60
 
50
61
    :cvar _fmt: Format string to display the error; this is expanded
51
 
        by the instance's dict.
 
62
    by the instance's dict.
52
63
    """
53
64
 
54
65
    internal_error = False
95
106
                # __str__() should always return a 'str' object
96
107
                # never a 'unicode' object.
97
108
                return s
98
 
        except Exception, e:
99
 
            pass # just bind to 'e' for formatting below
100
 
        else:
101
 
            e = None
102
 
        return 'Unprintable exception %s: dict=%r, fmt=%r, error=%r' \
103
 
            % (self.__class__.__name__,
104
 
               self.__dict__,
105
 
               getattr(self, '_fmt', None),
106
 
               e)
 
109
        except (AttributeError, TypeError, NameError, ValueError, KeyError), e:
 
110
            return 'Unprintable exception %s: dict=%r, fmt=%r, error=%r' \
 
111
                % (self.__class__.__name__,
 
112
                   self.__dict__,
 
113
                   getattr(self, '_fmt', None),
 
114
                   e)
107
115
 
108
116
    def __unicode__(self):
109
117
        u = self._format()
132
140
        """Return format string for this exception or None"""
133
141
        fmt = getattr(self, '_fmt', None)
134
142
        if fmt is not None:
135
 
            from bzrlib.i18n import gettext
136
 
            return gettext(unicode(fmt)) # _fmt strings should be ascii
 
143
            return fmt
 
144
        fmt = getattr(self, '__doc__', None)
 
145
        if fmt is not None:
 
146
            symbol_versioning.warn("%s uses its docstring as a format, "
 
147
                    "it should use _fmt instead" % self.__class__.__name__,
 
148
                    DeprecationWarning)
 
149
            return fmt
 
150
        return 'Unprintable exception %s: dict=%r, fmt=%r' \
 
151
            % (self.__class__.__name__,
 
152
               self.__dict__,
 
153
               getattr(self, '_fmt', None),
 
154
               )
137
155
 
138
156
    def __eq__(self, other):
139
157
        if self.__class__ is not other.__class__:
152
170
    internal_error = True
153
171
 
154
172
 
 
173
class BzrNewError(BzrError):
 
174
    """Deprecated error base class."""
 
175
    # base classes should override the docstring with their human-
 
176
    # readable explanation
 
177
 
 
178
    def __init__(self, *args, **kwds):
 
179
        # XXX: Use the underlying BzrError to always generate the args
 
180
        # attribute if it doesn't exist.  We can't use super here, because
 
181
        # exceptions are old-style classes in python2.4 (but new in 2.5).
 
182
        # --bmc, 20060426
 
183
        symbol_versioning.warn('BzrNewError was deprecated in bzr 0.13; '
 
184
             'please convert %s to use BzrError instead'
 
185
             % self.__class__.__name__,
 
186
             DeprecationWarning,
 
187
             stacklevel=2)
 
188
        BzrError.__init__(self, *args)
 
189
        for key, value in kwds.items():
 
190
            setattr(self, key, value)
 
191
 
 
192
    def __str__(self):
 
193
        try:
 
194
            # __str__() should always return a 'str' object
 
195
            # never a 'unicode' object.
 
196
            s = self.__doc__ % self.__dict__
 
197
            if isinstance(s, unicode):
 
198
                return s.encode('utf8')
 
199
            return s
 
200
        except (TypeError, NameError, ValueError, KeyError), e:
 
201
            return 'Unprintable exception %s(%r): %r' \
 
202
                % (self.__class__.__name__,
 
203
                   self.__dict__, e)
 
204
 
 
205
 
155
206
class AlreadyBuilding(BzrError):
156
207
 
157
208
    _fmt = "The tree builder is already building a tree."
253
304
class RootMissing(InternalBzrError):
254
305
 
255
306
    _fmt = ("The root entry of a tree must be the first entry supplied to "
256
 
        "the commit builder.")
 
307
        "record_entry_contents.")
257
308
 
258
309
 
259
310
class NoPublicBranch(BzrError):
570
621
 
571
622
    _fmt = 'Unsupported protocol for url "%(path)s"%(extra)s'
572
623
 
573
 
    def __init__(self, url, extra=""):
 
624
    def __init__(self, url, extra):
574
625
        PathError.__init__(self, url, extra=extra)
575
626
 
576
627
 
629
680
 
630
681
    _fmt = 'Path "%(path)s" is not a child of path "%(base)s"%(extra)s'
631
682
 
632
 
    internal_error = False
 
683
    internal_error = True
633
684
 
634
685
    def __init__(self, path, base, extra=None):
635
686
        BzrError.__init__(self)
662
713
       self.bzrdir = bzrdir
663
714
       PathError.__init__(self, path=path)
664
715
 
665
 
    def __repr__(self):
666
 
        return '<%s %r>' % (self.__class__.__name__, self.__dict__)
667
 
 
668
716
    def _format(self):
669
717
        # XXX: Ideally self.detail would be a property, but Exceptions in
670
718
        # Python 2.4 have to be old-style classes so properties don't work.
675
723
                    self.bzrdir.open_repository()
676
724
                except NoRepositoryPresent:
677
725
                    self.detail = ''
678
 
                except Exception:
679
 
                    # Just ignore unexpected errors.  Raising arbitrary errors
680
 
                    # during str(err) can provoke strange bugs.  Concretely
681
 
                    # Launchpad's codehosting managed to raise NotBranchError
682
 
                    # here, and then get stuck in an infinite loop/recursion
683
 
                    # trying to str() that error.  All this error really cares
684
 
                    # about that there's no working repository there, and if
685
 
                    # open_repository() fails, there probably isn't.
686
 
                    self.detail = ''
687
726
                else:
688
727
                    self.detail = ': location is a repository'
689
728
            else:
700
739
       self.path = urlutils.unescape_for_display(branch.base, 'ascii')
701
740
 
702
741
 
703
 
class AlreadyControlDirError(PathError):
704
 
 
705
 
    _fmt = 'A control directory already exists: "%(path)s".'
706
 
 
707
 
 
708
742
class AlreadyBranchError(PathError):
709
743
 
710
744
    _fmt = 'Already a branch: "%(path)s".'
711
745
 
712
746
 
713
 
class InvalidBranchName(PathError):
714
 
 
715
 
    _fmt = "Invalid branch name: %(name)s"
716
 
 
717
 
    def __init__(self, name):
718
 
        BzrError.__init__(self)
719
 
        self.name = name
720
 
 
721
 
 
722
 
class ParentBranchExists(AlreadyBranchError):
723
 
 
724
 
    _fmt = 'Parent branch already exists: "%(path)s".'
725
 
 
726
 
 
727
747
class BranchExistsWithoutWorkingTree(PathError):
728
748
 
729
749
    _fmt = 'Directory contains a branch, but no working tree \
758
778
        self.path = bzrdir.transport.clone('..').base
759
779
 
760
780
 
 
781
class FileInWrongBranch(BzrError):
 
782
 
 
783
    _fmt = 'File "%(path)s" is not in branch %(branch_base)s.'
 
784
 
 
785
    def __init__(self, branch, path):
 
786
        BzrError.__init__(self)
 
787
        self.branch = branch
 
788
        self.branch_base = branch.base
 
789
        self.path = path
 
790
 
 
791
 
761
792
class UnsupportedFormatError(BzrError):
762
793
 
763
794
    _fmt = "Unsupported branch format: %(format)s\nPlease run 'bzr upgrade'"
782
813
        self.bzrdir = bzrdir_format
783
814
 
784
815
 
785
 
class ParseFormatError(BzrError):
786
 
 
787
 
    _fmt = "Parse error on line %(lineno)d of %(format)s format: %(line)s"
788
 
 
789
 
    def __init__(self, format, lineno, line, text):
790
 
        BzrError.__init__(self)
791
 
        self.format = format
792
 
        self.lineno = lineno
793
 
        self.line = line
794
 
        self.text = text
795
 
 
796
 
 
797
816
class IncompatibleRepositories(BzrError):
798
817
    """Report an error that two repositories are not compatible.
799
818
 
831
850
        """Construct a new AlreadyVersionedError.
832
851
 
833
852
        :param path: This is the path which is versioned,
834
 
            which should be in a user friendly form.
 
853
        which should be in a user friendly form.
835
854
        :param context_info: If given, this is information about the context,
836
 
            which could explain why this is expected to not be versioned.
 
855
        which could explain why this is expected to not be versioned.
837
856
        """
838
857
        BzrError.__init__(self)
839
858
        self.path = path
852
871
        """Construct a new NotVersionedError.
853
872
 
854
873
        :param path: This is the path which is not versioned,
855
 
            which should be in a user friendly form.
 
874
        which should be in a user friendly form.
856
875
        :param context_info: If given, this is information about the context,
857
 
            which could explain why this is expected to be versioned.
 
876
        which could explain why this is expected to be versioned.
858
877
        """
859
878
        BzrError.__init__(self)
860
879
        self.path = path
928
947
    # original exception is available as e.original_error
929
948
    #
930
949
    # New code should prefer to raise specific subclasses
931
 
    def __init__(self, msg):
932
 
        self.msg = msg
 
950
    def __init__(self, message):
 
951
        # Python 2.5 uses a slot for StandardError.message,
 
952
        # so use a different variable name.  We now work around this in
 
953
        # BzrError.__str__, but this member name is kept for compatability.
 
954
        self.msg = message
933
955
 
934
956
 
935
957
class LockActive(LockError):
1019
1041
class LockContention(LockError):
1020
1042
 
1021
1043
    _fmt = 'Could not acquire lock "%(lock)s": %(msg)s'
 
1044
    # TODO: show full url for lock, combining the transport and relative
 
1045
    # bits?
1022
1046
 
1023
1047
    internal_error = False
1024
1048
 
1051
1075
        self.target = target
1052
1076
 
1053
1077
 
1054
 
class LockCorrupt(LockError):
1055
 
 
1056
 
    _fmt = ("Lock is apparently held, but corrupted: %(corruption_info)s\n"
1057
 
            "Use 'bzr break-lock' to clear it")
1058
 
 
1059
 
    internal_error = False
1060
 
 
1061
 
    def __init__(self, corruption_info, file_data=None):
1062
 
        self.corruption_info = corruption_info
1063
 
        self.file_data = file_data
1064
 
 
1065
 
 
1066
1078
class LockNotHeld(LockError):
1067
1079
 
1068
1080
    _fmt = "Lock not held: %(lock)s"
1107
1119
        BzrError.__init__(self, files=files, files_str=files_str)
1108
1120
 
1109
1121
 
1110
 
class ExcludesUnsupported(BzrError):
1111
 
 
1112
 
    _fmt = ('Excluding paths during commit is not supported by '
1113
 
            'repository at %(repository)r.')
1114
 
 
1115
 
    def __init__(self, repository):
1116
 
        BzrError.__init__(self, repository=repository)
1117
 
 
1118
 
 
1119
1122
class BadCommitMessageEncoding(BzrError):
1120
1123
 
1121
1124
    _fmt = 'The specified commit message contains characters unsupported by '\
1176
1179
 
1177
1180
class InvalidRevisionSpec(BzrError):
1178
1181
 
1179
 
    _fmt = ("Requested revision: '%(spec)s' does not exist in branch:"
1180
 
            " %(branch_url)s%(extra)s")
 
1182
    _fmt = ("Requested revision: %(spec)r does not exist in branch:"
 
1183
            " %(branch)s%(extra)s")
1181
1184
 
1182
1185
    def __init__(self, spec, branch, extra=None):
1183
1186
        BzrError.__init__(self, branch=branch, spec=spec)
1184
 
        self.branch_url = getattr(branch, 'user_url', str(branch))
1185
1187
        if extra:
1186
1188
            self.extra = '\n' + str(extra)
1187
1189
        else:
1188
1190
            self.extra = ''
1189
1191
 
1190
1192
 
 
1193
class HistoryMissing(BzrError):
 
1194
 
 
1195
    _fmt = "%(branch)s is missing %(object_type)s {%(object_id)s}"
 
1196
 
 
1197
 
1191
1198
class AppendRevisionsOnlyViolation(BzrError):
1192
1199
 
1193
1200
    _fmt = ('Operation denied because it would change the main history,'
1258
1265
            not_ancestor_id=not_ancestor_id)
1259
1266
 
1260
1267
 
 
1268
class AmbiguousBase(BzrError):
 
1269
 
 
1270
    def __init__(self, bases):
 
1271
        symbol_versioning.warn("BzrError AmbiguousBase has been deprecated "
 
1272
            "as of bzrlib 0.8.", DeprecationWarning, stacklevel=2)
 
1273
        msg = ("The correct base is unclear, because %s are all equally close"
 
1274
                % ", ".join(bases))
 
1275
        BzrError.__init__(self, msg)
 
1276
        self.bases = bases
 
1277
 
 
1278
 
1261
1279
class NoCommits(BranchError):
1262
1280
 
1263
1281
    _fmt = "Branch %(branch)s has no commits."
1279
1297
class BoundBranchOutOfDate(BzrError):
1280
1298
 
1281
1299
    _fmt = ("Bound branch %(branch)s is out of date with master branch"
1282
 
            " %(master)s.%(extra_help)s")
 
1300
            " %(master)s.")
1283
1301
 
1284
1302
    def __init__(self, branch, master):
1285
1303
        BzrError.__init__(self)
1286
1304
        self.branch = branch
1287
1305
        self.master = master
1288
 
        self.extra_help = ''
1289
1306
 
1290
1307
 
1291
1308
class CommitToDoubleBoundBranch(BzrError):
1362
1379
 
1363
1380
class WeaveParentMismatch(WeaveError):
1364
1381
 
1365
 
    _fmt = "Parents are mismatched between two revisions. %(msg)s"
 
1382
    _fmt = "Parents are mismatched between two revisions. %(message)s"
1366
1383
 
1367
1384
 
1368
1385
class WeaveInvalidChecksum(WeaveError):
1369
1386
 
1370
 
    _fmt = "Text did not match its checksum: %(msg)s"
 
1387
    _fmt = "Text did not match it's checksum: %(message)s"
1371
1388
 
1372
1389
 
1373
1390
class WeaveTextDiffers(WeaveError):
1421
1438
 
1422
1439
class VersionedFileInvalidChecksum(VersionedFileError):
1423
1440
 
1424
 
    _fmt = "Text did not match its checksum: %(msg)s"
 
1441
    _fmt = "Text did not match its checksum: %(message)s"
1425
1442
 
1426
1443
 
1427
1444
class KnitError(InternalBzrError):
1523
1540
            problem we can raise the original error (value from sys.exc_info())
1524
1541
        """
1525
1542
        BzrError.__init__(self)
1526
 
        self.context = context
1527
1543
        self.reload_occurred = reload_occurred
1528
1544
        self.exc_info = exc_info
1529
1545
        self.orig_error = exc_info[1]
1611
1627
 
1612
1628
    def __init__(self, exc_info):
1613
1629
        import traceback
1614
 
        # GZ 2010-08-10: Cycle with exc_tb/exc_info affects at least one test
1615
1630
        self.exc_type, self.exc_value, self.exc_tb = exc_info
1616
1631
        self.exc_info = exc_info
1617
1632
        traceback_strings = traceback.format_exception(
1656
1671
    _fmt = "Connection closed: %(msg)s %(orig_error)s"
1657
1672
 
1658
1673
 
1659
 
class ConnectionTimeout(ConnectionError):
1660
 
 
1661
 
    _fmt = "Connection Timeout: %(msg)s%(orig_error)s"
1662
 
 
1663
 
 
1664
1674
class InvalidRange(TransportError):
1665
1675
 
1666
1676
    _fmt = "Invalid range access in %(path)s at %(offset)s: %(msg)s"
1673
1683
 
1674
1684
class InvalidHttpResponse(TransportError):
1675
1685
 
1676
 
    _fmt = "Invalid http response for %(path)s: %(msg)s%(orig_error)s"
 
1686
    _fmt = "Invalid http response for %(path)s: %(msg)s"
1677
1687
 
1678
1688
    def __init__(self, path, msg, orig_error=None):
1679
1689
        self.path = path
1680
 
        if orig_error is None:
1681
 
            orig_error = ''
1682
 
        else:
1683
 
            # This is reached for obscure and unusual errors so we want to
1684
 
            # preserve as much info as possible to ease debug.
1685
 
            orig_error = ': %r' % (orig_error,)
1686
1690
        TransportError.__init__(self, msg, orig_error=orig_error)
1687
1691
 
1688
1692
 
1689
 
class CertificateError(TransportError):
1690
 
 
1691
 
    _fmt = "Certificate error: %(error)s"
1692
 
 
1693
 
    def __init__(self, error):
1694
 
        self.error = error
1695
 
 
1696
 
 
1697
1693
class InvalidHttpRange(InvalidHttpResponse):
1698
1694
 
1699
1695
    _fmt = "Invalid http range %(range)r for %(path)s: %(msg)s"
1703
1699
        InvalidHttpResponse.__init__(self, path, msg)
1704
1700
 
1705
1701
 
1706
 
class HttpBoundaryMissing(InvalidHttpResponse):
1707
 
    """A multipart response ends with no boundary marker.
1708
 
 
1709
 
    This is a special case caused by buggy proxies, described in
1710
 
    <https://bugs.launchpad.net/bzr/+bug/198646>.
1711
 
    """
1712
 
 
1713
 
    _fmt = "HTTP MIME Boundary missing for %(path)s: %(msg)s"
1714
 
 
1715
 
    def __init__(self, path, msg):
1716
 
        InvalidHttpResponse.__init__(self, path, msg)
1717
 
 
1718
 
 
1719
1702
class InvalidHttpContentType(InvalidHttpResponse):
1720
1703
 
1721
1704
    _fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1749
1732
    _fmt = "Working tree has conflicts."
1750
1733
 
1751
1734
 
1752
 
class ConfigContentError(BzrError):
1753
 
 
1754
 
    _fmt = "Config file %(filename)s is not UTF-8 encoded\n"
1755
 
 
1756
 
    def __init__(self, filename):
1757
 
        BzrError.__init__(self)
1758
 
        self.filename = filename
1759
 
 
1760
 
 
1761
1735
class ParseConfigError(BzrError):
1762
1736
 
1763
 
    _fmt = "Error(s) parsing config file %(filename)s:\n%(errors)s"
1764
 
 
1765
1737
    def __init__(self, errors, filename):
1766
 
        BzrError.__init__(self)
1767
 
        self.filename = filename
1768
 
        self.errors = '\n'.join(e.msg for e in errors)
1769
 
 
1770
 
 
1771
 
class ConfigOptionValueError(BzrError):
1772
 
 
1773
 
    _fmt = ('Bad value "%(value)s" for option "%(name)s".\n'
1774
 
            'See ``bzr help %(name)s``')
1775
 
 
1776
 
    def __init__(self, name, value):
1777
 
        BzrError.__init__(self, name=name, value=value)
 
1738
        if filename is None:
 
1739
            filename = ""
 
1740
        message = "Error(s) parsing config file %s:\n%s" % \
 
1741
            (filename, ('\n'.join(e.msg for e in errors)))
 
1742
        BzrError.__init__(self, message)
1778
1743
 
1779
1744
 
1780
1745
class NoEmailInUsername(BzrError):
1788
1753
 
1789
1754
class SigningFailed(BzrError):
1790
1755
 
1791
 
    _fmt = 'Failed to GPG sign data with command "%(command_line)s"'
 
1756
    _fmt = 'Failed to gpg sign data with command "%(command_line)s"'
1792
1757
 
1793
1758
    def __init__(self, command_line):
1794
1759
        BzrError.__init__(self, command_line=command_line)
1795
1760
 
1796
1761
 
1797
 
class SignatureVerificationFailed(BzrError):
1798
 
 
1799
 
    _fmt = 'Failed to verify GPG signature data with error "%(error)s"'
1800
 
 
1801
 
    def __init__(self, error):
1802
 
        BzrError.__init__(self, error=error)
1803
 
 
1804
 
 
1805
 
class DependencyNotPresent(BzrError):
1806
 
 
1807
 
    _fmt = 'Unable to import library "%(library)s": %(error)s'
1808
 
 
1809
 
    def __init__(self, library, error):
1810
 
        BzrError.__init__(self, library=library, error=error)
1811
 
 
1812
 
 
1813
 
class GpgmeNotInstalled(DependencyNotPresent):
1814
 
 
1815
 
    _fmt = 'python-gpgme is not installed, it is needed to verify signatures'
1816
 
 
1817
 
    def __init__(self, error):
1818
 
        DependencyNotPresent.__init__(self, 'gpgme', error)
1819
 
 
1820
 
 
1821
1762
class WorkingTreeNotRevision(BzrError):
1822
1763
 
1823
1764
    _fmt = ("The working tree for %(basedir)s has changed since"
1939
1880
        self.prefix = prefix
1940
1881
 
1941
1882
 
1942
 
class MalformedTransform(InternalBzrError):
 
1883
class MalformedTransform(BzrError):
1943
1884
 
1944
1885
    _fmt = "Tree transform is malformed %(conflicts)r"
1945
1886
 
1983
1924
    _fmt = "Moving the root directory is not supported at this time"
1984
1925
 
1985
1926
 
1986
 
class TransformRenameFailed(BzrError):
1987
 
 
1988
 
    _fmt = "Failed to rename %(from_path)s to %(to_path)s: %(why)s"
1989
 
 
1990
 
    def __init__(self, from_path, to_path, why, errno):
1991
 
        self.from_path = from_path
1992
 
        self.to_path = to_path
1993
 
        self.why = why
1994
 
        self.errno = errno
1995
 
 
1996
 
 
1997
1927
class BzrMoveFailedError(BzrError):
1998
1928
 
1999
 
    _fmt = ("Could not move %(from_path)s%(operator)s %(to_path)s"
2000
 
        "%(_has_extra)s%(extra)s")
 
1929
    _fmt = "Could not move %(from_path)s%(operator)s %(to_path)s%(extra)s"
2001
1930
 
2002
1931
    def __init__(self, from_path='', to_path='', extra=None):
2003
1932
        from bzrlib.osutils import splitpath
2004
1933
        BzrError.__init__(self)
2005
1934
        if extra:
2006
 
            self.extra, self._has_extra = extra, ': '
 
1935
            self.extra = ': ' + str(extra)
2007
1936
        else:
2008
 
            self.extra = self._has_extra = ''
 
1937
            self.extra = ''
2009
1938
 
2010
1939
        has_from = len(from_path) > 0
2011
1940
        has_to = len(to_path) > 0
2032
1961
 
2033
1962
class BzrRenameFailedError(BzrMoveFailedError):
2034
1963
 
2035
 
    _fmt = ("Could not rename %(from_path)s%(operator)s %(to_path)s"
2036
 
        "%(_has_extra)s%(extra)s")
 
1964
    _fmt = "Could not rename %(from_path)s%(operator)s %(to_path)s%(extra)s"
2037
1965
 
2038
1966
    def __init__(self, from_path, to_path, extra=None):
2039
1967
        BzrMoveFailedError.__init__(self, from_path, to_path, extra)
2040
1968
 
 
1969
class BzrRemoveChangedFilesError(BzrError):
 
1970
    """Used when user is trying to remove changed files."""
 
1971
 
 
1972
    _fmt = ("Can't safely remove modified or unknown files:\n"
 
1973
        "%(changes_as_text)s"
 
1974
        "Use --keep to not delete them, or --force to delete them regardless.")
 
1975
 
 
1976
    def __init__(self, tree_delta):
 
1977
        BzrError.__init__(self)
 
1978
        self.changes_as_text = tree_delta.get_changes_as_text()
 
1979
        #self.paths_as_string = '\n'.join(changed_files)
 
1980
        #self.paths_as_string = '\n'.join([quotefn(p) for p in changed_files])
 
1981
 
2041
1982
 
2042
1983
class BzrBadParameterNotString(BzrBadParameter):
2043
1984
 
2046
1987
 
2047
1988
class BzrBadParameterMissing(BzrBadParameter):
2048
1989
 
2049
 
    _fmt = "Parameter %(param)s is required but not present."
 
1990
    _fmt = "Parameter $(param)s is required but not present."
2050
1991
 
2051
1992
 
2052
1993
class BzrBadParameterUnicode(BzrBadParameter):
2060
2001
    _fmt = "Parameter %(param)s contains a newline."
2061
2002
 
2062
2003
 
 
2004
class DependencyNotPresent(BzrError):
 
2005
 
 
2006
    _fmt = 'Unable to import library "%(library)s": %(error)s'
 
2007
 
 
2008
    def __init__(self, library, error):
 
2009
        BzrError.__init__(self, library=library, error=error)
 
2010
 
 
2011
 
2063
2012
class ParamikoNotPresent(DependencyNotPresent):
2064
2013
 
2065
2014
    _fmt = "Unable to import paramiko (required for sftp support): %(error)s"
2226
2175
 
2227
2176
    def __init__(self, repo):
2228
2177
        BzrError.__init__(self)
2229
 
        self.repo_path = repo.user_url
 
2178
        self.repo_path = repo.bzrdir.root_transport.base
2230
2179
 
2231
2180
 
2232
2181
class InconsistentDelta(BzrError):
2300
2249
    """
2301
2250
 
2302
2251
 
2303
 
class GhostTagsNotSupported(BzrError):
2304
 
 
2305
 
    _fmt = "Ghost tags not supported by format %(format)r."
2306
 
 
2307
 
    def __init__(self, format):
2308
 
        self.format = format
2309
 
 
2310
 
 
2311
2252
class BinaryFile(BzrError):
2312
2253
 
2313
2254
    _fmt = "File is binary but should be text."
2676
2617
 
2677
2618
    This is distinct from ErrorFromSmartServer so that it is possible to
2678
2619
    distinguish between the following two cases:
2679
 
 
2680
 
    - ErrorFromSmartServer was uncaught.  This is logic error in the client
2681
 
      and so should provoke a traceback to the user.
2682
 
    - ErrorFromSmartServer was caught but its error_tuple could not be
2683
 
      translated.  This is probably because the server sent us garbage, and
2684
 
      should not provoke a traceback.
 
2620
      - ErrorFromSmartServer was uncaught.  This is logic error in the client
 
2621
        and so should provoke a traceback to the user.
 
2622
      - ErrorFromSmartServer was caught but its error_tuple could not be
 
2623
        translated.  This is probably because the server sent us garbage, and
 
2624
        should not provoke a traceback.
2685
2625
    """
2686
2626
 
2687
2627
    _fmt = "Server sent an unexpected error: %(error_tuple)r"
2743
2683
    _fmt = "Container has multiple records with the same name: %(name)s"
2744
2684
 
2745
2685
    def __init__(self, name):
2746
 
        self.name = name.decode("utf-8")
 
2686
        self.name = name
2747
2687
 
2748
2688
 
2749
2689
class NoDestinationAddress(InternalBzrError):
2777
2717
    _fmt = "No mail-to address (--mail-to) or output (-o) specified."
2778
2718
 
2779
2719
 
 
2720
class UnknownMailClient(BzrError):
 
2721
 
 
2722
    _fmt = "Unknown mail client: %(mail_client)s"
 
2723
 
 
2724
    def __init__(self, mail_client):
 
2725
        BzrError.__init__(self, mail_client=mail_client)
 
2726
 
 
2727
 
2780
2728
class MailClientNotFound(BzrError):
2781
2729
 
2782
2730
    _fmt = "Unable to find mail client with the following names:"\
2805
2753
 
2806
2754
    def __init__(self, bzrdir):
2807
2755
        import bzrlib.urlutils as urlutils
2808
 
        display_url = urlutils.unescape_for_display(bzrdir.user_url,
 
2756
        display_url = urlutils.unescape_for_display(bzrdir.root_transport.base,
2809
2757
                                                    'ascii')
2810
2758
        BzrError.__init__(self, bzrdir=bzrdir, display_url=display_url)
2811
2759
 
2885
2833
        else:
2886
2834
            more = ' ' + more
2887
2835
        import bzrlib.urlutils as urlutils
2888
 
        user_url = getattr(tree, "user_url", None)
2889
 
        if user_url is None:
2890
 
            display_url = str(tree)
2891
 
        else:
2892
 
            display_url = urlutils.unescape_for_display(user_url, 'ascii')
 
2836
        display_url = urlutils.unescape_for_display(
 
2837
            tree.bzrdir.root_transport.base, 'ascii')
2893
2838
        BzrError.__init__(self, tree=tree, display_url=display_url, more=more)
2894
2839
 
2895
2840
 
2896
 
class ShelvedChanges(UncommittedChanges):
2897
 
 
2898
 
    _fmt = ('Working tree "%(display_url)s" has shelved changes'
2899
 
            ' (See bzr shelve --list).%(more)s')
2900
 
 
2901
 
 
2902
2841
class MissingTemplateVariable(BzrError):
2903
2842
 
2904
2843
    _fmt = 'Variable {%(name)s} is not available.'
2970
2909
        from bzrlib.osutils import get_user_encoding
2971
2910
        self.path = path
2972
2911
        self.kind = kind
2973
 
        self.user_encoding = get_user_encoding()
2974
 
 
2975
 
 
2976
 
class NoSuchConfig(BzrError):
2977
 
 
2978
 
    _fmt = ('The "%(config_id)s" configuration does not exist.')
2979
 
 
2980
 
    def __init__(self, config_id):
2981
 
        BzrError.__init__(self, config_id=config_id)
2982
 
 
2983
 
 
2984
 
class NoSuchConfigOption(BzrError):
2985
 
 
2986
 
    _fmt = ('The "%(option_name)s" configuration option does not exist.')
2987
 
 
2988
 
    def __init__(self, option_name):
2989
 
        BzrError.__init__(self, option_name=option_name)
 
2912
        self.user_encoding = osutils.get_user_encoding()
2990
2913
 
2991
2914
 
2992
2915
class NoSuchAlias(BzrError):
3037
2960
        BzrError.__init__(self, unknowns_str=", ".join(unknowns))
3038
2961
 
3039
2962
 
 
2963
class HookFailed(BzrError):
 
2964
    """Raised when a pre_change_branch_tip hook function fails anything other
 
2965
    than TipChangeRejected.
 
2966
 
 
2967
    Note that this exception is no longer raised, and the import is only left
 
2968
    to be nice to code which might catch it in a plugin.
 
2969
    """
 
2970
 
 
2971
    _fmt = ("Hook '%(hook_name)s' during %(hook_stage)s failed:\n"
 
2972
            "%(traceback_text)s%(exc_value)s")
 
2973
 
 
2974
    def __init__(self, hook_stage, hook_name, exc_info, warn=True):
 
2975
        if warn:
 
2976
            symbol_versioning.warn("BzrError HookFailed has been deprecated "
 
2977
                "as of bzrlib 2.1.", DeprecationWarning, stacklevel=2)
 
2978
        import traceback
 
2979
        self.hook_stage = hook_stage
 
2980
        self.hook_name = hook_name
 
2981
        self.exc_info = exc_info
 
2982
        self.exc_type = exc_info[0]
 
2983
        self.exc_value = exc_info[1]
 
2984
        self.exc_tb = exc_info[2]
 
2985
        self.traceback_text = ''.join(traceback.format_tb(self.exc_tb))
 
2986
 
 
2987
 
3040
2988
class TipChangeRejected(BzrError):
3041
2989
    """A pre_change_branch_tip hook function may raise this to cleanly and
3042
2990
    explicitly abort a change to a branch tip.
3053
3001
    _fmt = "Shelf corrupt."
3054
3002
 
3055
3003
 
3056
 
class DecompressCorruption(BzrError):
3057
 
 
3058
 
    _fmt = "Corruption while decompressing repository file%(orig_error)s"
3059
 
 
3060
 
    def __init__(self, orig_error=None):
3061
 
        if orig_error is not None:
3062
 
            self.orig_error = ", %s" % (orig_error,)
3063
 
        else:
3064
 
            self.orig_error = ""
3065
 
        BzrError.__init__(self)
3066
 
 
3067
 
 
3068
3004
class NoSuchShelfId(BzrError):
3069
3005
 
3070
3006
    _fmt = 'No changes are shelved with id "%(shelf_id)d".'
3188
3124
 
3189
3125
    def __init__(self, path):
3190
3126
        self.path = path
3191
 
 
3192
 
 
3193
 
class NoColocatedBranchSupport(BzrError):
3194
 
 
3195
 
    _fmt = ("%(bzrdir)r does not support co-located branches.")
3196
 
 
3197
 
    def __init__(self, bzrdir):
3198
 
        self.bzrdir = bzrdir
3199
 
 
3200
 
 
3201
 
class NoWhoami(BzrError):
3202
 
 
3203
 
    _fmt = ('Unable to determine your name.\n'
3204
 
        "Please, set your name with the 'whoami' command.\n"
3205
 
        'E.g. bzr whoami "Your Name <name@example.com>"')
3206
 
 
3207
 
 
3208
 
class InvalidPattern(BzrError):
3209
 
 
3210
 
    _fmt = ('Invalid pattern(s) found. %(msg)s')
3211
 
 
3212
 
    def __init__(self, msg):
3213
 
        self.msg = msg
3214
 
 
3215
 
 
3216
 
class RecursiveBind(BzrError):
3217
 
 
3218
 
    _fmt = ('Branch "%(branch_url)s" appears to be bound to itself. '
3219
 
        'Please use `bzr unbind` to fix.')
3220
 
 
3221
 
    def __init__(self, branch_url):
3222
 
        self.branch_url = branch_url
3223
 
 
3224
 
 
3225
 
# FIXME: I would prefer to define the config related exception classes in
3226
 
# config.py but the lazy import mechanism proscribes this -- vila 20101222
3227
 
class OptionExpansionLoop(BzrError):
3228
 
 
3229
 
    _fmt = 'Loop involving %(refs)r while expanding "%(string)s".'
3230
 
 
3231
 
    def __init__(self, string, refs):
3232
 
        self.string = string
3233
 
        self.refs = '->'.join(refs)
3234
 
 
3235
 
 
3236
 
class ExpandingUnknownOption(BzrError):
3237
 
 
3238
 
    _fmt = 'Option %(name)s is not defined while expanding "%(string)s".'
3239
 
 
3240
 
    def __init__(self, name, string):
3241
 
        self.name = name
3242
 
        self.string = string
3243
 
 
3244
 
 
3245
 
class NoCompatibleInter(BzrError):
3246
 
 
3247
 
    _fmt = ('No compatible object available for operations from %(source)r '
3248
 
            'to %(target)r.')
3249
 
 
3250
 
    def __init__(self, source, target):
3251
 
        self.source = source
3252
 
        self.target = target
3253
 
 
3254
 
 
3255
 
class HpssVfsRequestNotAllowed(BzrError):
3256
 
 
3257
 
    _fmt = ("VFS requests over the smart server are not allowed. Encountered: "
3258
 
            "%(method)s, %(arguments)s.")
3259
 
 
3260
 
    def __init__(self, method, arguments):
3261
 
        self.method = method
3262
 
        self.arguments = arguments
3263
 
 
3264
 
 
3265
 
class UnsupportedKindChange(BzrError):
3266
 
 
3267
 
    _fmt = ("Kind change from %(from_kind)s to %(to_kind)s for "
3268
 
            "%(path)s not supported by format %(format)r")
3269
 
 
3270
 
    def __init__(self, path, from_kind, to_kind, format):
3271
 
        self.path = path
3272
 
        self.from_kind = from_kind
3273
 
        self.to_kind = to_kind
3274
 
        self.format = format
3275
 
 
3276
 
 
3277
 
class MissingFeature(BzrError):
3278
 
 
3279
 
    _fmt = ("Missing feature %(feature)s not provided by this "
3280
 
            "version of Bazaar or any plugin.")
3281
 
 
3282
 
    def __init__(self, feature):
3283
 
        self.feature = feature
3284
 
 
3285
 
 
3286
 
class PatchSyntax(BzrError):
3287
 
    """Base class for patch syntax errors."""
3288
 
 
3289
 
 
3290
 
class BinaryFiles(BzrError):
3291
 
 
3292
 
    _fmt = 'Binary files section encountered.'
3293
 
 
3294
 
    def __init__(self, orig_name, mod_name):
3295
 
        self.orig_name = orig_name
3296
 
        self.mod_name = mod_name
3297
 
 
3298
 
 
3299
 
class MalformedPatchHeader(PatchSyntax):
3300
 
 
3301
 
    _fmt = "Malformed patch header.  %(desc)s\n%(line)r"
3302
 
 
3303
 
    def __init__(self, desc, line):
3304
 
        self.desc = desc
3305
 
        self.line = line
3306
 
 
3307
 
 
3308
 
class MalformedHunkHeader(PatchSyntax):
3309
 
 
3310
 
    _fmt = "Malformed hunk header.  %(desc)s\n%(line)r"
3311
 
 
3312
 
    def __init__(self, desc, line):
3313
 
        self.desc = desc
3314
 
        self.line = line
3315
 
 
3316
 
 
3317
 
class MalformedLine(PatchSyntax):
3318
 
 
3319
 
    _fmt = "Malformed line.  %(desc)s\n%(line)r"
3320
 
 
3321
 
    def __init__(self, desc, line):
3322
 
        self.desc = desc
3323
 
        self.line = line
3324
 
 
3325
 
 
3326
 
class PatchConflict(BzrError):
3327
 
 
3328
 
    _fmt = ('Text contents mismatch at line %(line_no)d.  Original has '
3329
 
            '"%(orig_line)s", but patch says it should be "%(patch_line)s"')
3330
 
 
3331
 
    def __init__(self, line_no, orig_line, patch_line):
3332
 
        self.line_no = line_no
3333
 
        self.orig_line = orig_line.rstrip('\n')
3334
 
        self.patch_line = patch_line.rstrip('\n')
3335
 
 
3336
 
 
3337
 
class FeatureAlreadyRegistered(BzrError):
3338
 
 
3339
 
    _fmt = 'The feature %(feature)s has already been registered.'
3340
 
 
3341
 
    def __init__(self, feature):
3342
 
        self.feature = feature