57
54
Base class for errors raised by bzrlib.
59
56
:cvar internal_error: if True this was probably caused by a bzr bug and
60
should be displayed with a traceback; if False (or absent) this was
61
probably a user or environment error and they don't need the gory
62
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.)
64
61
:cvar _fmt: Format string to display the error; this is expanded
65
by the instance's dict.
62
by the instance's dict.
68
65
internal_error = False
143
140
"""Return format string for this exception or None"""
144
141
fmt = getattr(self, '_fmt', None)
145
142
if fmt is not None:
147
unicode_fmt = unicode(fmt) #_fmt strings should be ascii
148
if type(fmt) == unicode:
149
trace.mutter("Unicode strings in error.fmt are deprecated")
150
return gettext(unicode_fmt)
151
144
fmt = getattr(self, '__doc__', None)
152
145
if fmt is not None:
153
146
symbol_versioning.warn("%s uses its docstring as a format, "
709
702
# TODO: Probably this behavior of should be a common superclass
710
703
class NotBranchError(PathError):
712
_fmt = 'Not a branch: "%(path)s"%(detail)s.'
705
_fmt = 'Not a branch: "%(path)s".'
714
def __init__(self, path, detail=None, bzrdir=None):
707
def __init__(self, path):
715
708
import bzrlib.urlutils as urlutils
716
path = urlutils.unescape_for_display(path, 'ascii')
717
if detail is not None:
718
detail = ': ' + detail
721
PathError.__init__(self, path=path)
724
return '<%s %r>' % (self.__class__.__name__, self.__dict__)
727
# XXX: Ideally self.detail would be a property, but Exceptions in
728
# Python 2.4 have to be old-style classes so properties don't work.
729
# Instead we override _format.
730
if self.detail is None:
731
if self.bzrdir is not None:
733
self.bzrdir.open_repository()
734
except NoRepositoryPresent:
737
# Just ignore unexpected errors. Raising arbitrary errors
738
# during str(err) can provoke strange bugs. Concretely
739
# Launchpad's codehosting managed to raise NotBranchError
740
# here, and then get stuck in an infinite loop/recursion
741
# trying to str() that error. All this error really cares
742
# about that there's no working repository there, and if
743
# open_repository() fails, there probably isn't.
746
self.detail = ': location is a repository'
749
return PathError._format(self)
709
self.path = urlutils.unescape_for_display(path, 'ascii')
752
712
class NoSubmitBranch(PathError):
871
823
"""Construct a new AlreadyVersionedError.
873
825
:param path: This is the path which is versioned,
874
which should be in a user friendly form.
826
which should be in a user friendly form.
875
827
:param context_info: If given, this is information about the context,
876
which could explain why this is expected to not be versioned.
828
which could explain why this is expected to not be versioned.
878
830
BzrError.__init__(self)
892
844
"""Construct a new NotVersionedError.
894
846
:param path: This is the path which is not versioned,
895
which should be in a user friendly form.
847
which should be in a user friendly form.
896
848
:param context_info: If given, this is information about the context,
897
which could explain why this is expected to be versioned.
849
which could explain why this is expected to be versioned.
899
851
BzrError.__init__(self)
968
920
# original exception is available as e.original_error
970
922
# New code should prefer to raise specific subclasses
971
def __init__(self, msg):
923
def __init__(self, message):
924
# Python 2.5 uses a slot for StandardError.message,
925
# so use a different variable name. We now work around this in
926
# BzrError.__str__, but this member name is kept for compatability.
975
930
class LockActive(LockError):
1091
1048
self.target = target
1094
class LockCorrupt(LockError):
1096
_fmt = ("Lock is apparently held, but corrupted: %(corruption_info)s\n"
1097
"Use 'bzr break-lock' to clear it")
1099
internal_error = False
1101
def __init__(self, corruption_info, file_data=None):
1102
self.corruption_info = corruption_info
1103
self.file_data = file_data
1106
1051
class LockNotHeld(LockError):
1108
1053
_fmt = "Lock not held: %(lock)s"
1147
1092
BzrError.__init__(self, files=files, files_str=files_str)
1150
class ExcludesUnsupported(BzrError):
1152
_fmt = ('Excluding paths during commit is not supported by '
1153
'repository at %(repository)r.')
1155
def __init__(self, repository):
1156
BzrError.__init__(self, repository=repository)
1159
1095
class BadCommitMessageEncoding(BzrError):
1161
1097
_fmt = 'The specified commit message contains characters unsupported by '\
1217
1153
class InvalidRevisionSpec(BzrError):
1219
_fmt = ("Requested revision: '%(spec)s' does not exist in branch:"
1220
" %(branch_url)s%(extra)s")
1155
_fmt = ("Requested revision: %(spec)r does not exist in branch:"
1156
" %(branch)s%(extra)s")
1222
1158
def __init__(self, spec, branch, extra=None):
1223
1159
BzrError.__init__(self, branch=branch, spec=spec)
1224
self.branch_url = getattr(branch, 'user_url', str(branch))
1226
1161
self.extra = '\n' + str(extra)
1306
1241
class AmbiguousBase(BzrError):
1308
1243
def __init__(self, bases):
1309
symbol_versioning.warn("BzrError AmbiguousBase has been deprecated "
1310
"as of bzrlib 0.8.", DeprecationWarning, stacklevel=2)
1244
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
1311
1246
msg = ("The correct base is unclear, because %s are all equally close"
1312
1247
% ", ".join(bases))
1313
1248
BzrError.__init__(self, msg)
1419
1353
class WeaveParentMismatch(WeaveError):
1421
_fmt = "Parents are mismatched between two revisions. %(msg)s"
1355
_fmt = "Parents are mismatched between two revisions. %(message)s"
1424
1358
class WeaveInvalidChecksum(WeaveError):
1426
_fmt = "Text did not match its checksum: %(msg)s"
1360
_fmt = "Text did not match it's checksum: %(message)s"
1429
1363
class WeaveTextDiffers(WeaveError):
1729
1657
class InvalidHttpResponse(TransportError):
1731
_fmt = "Invalid http response for %(path)s: %(msg)s%(orig_error)s"
1659
_fmt = "Invalid http response for %(path)s: %(msg)s"
1733
1661
def __init__(self, path, msg, orig_error=None):
1734
1662
self.path = path
1735
if orig_error is None:
1738
# This is reached for obscure and unusual errors so we want to
1739
# preserve as much info as possible to ease debug.
1740
orig_error = ': %r' % (orig_error,)
1741
1663
TransportError.__init__(self, msg, orig_error=orig_error)
1750
1672
InvalidHttpResponse.__init__(self, path, msg)
1753
class HttpBoundaryMissing(InvalidHttpResponse):
1754
"""A multipart response ends with no boundary marker.
1756
This is a special case caused by buggy proxies, described in
1757
<https://bugs.launchpad.net/bzr/+bug/198646>.
1760
_fmt = "HTTP MIME Boundary missing for %(path)s: %(msg)s"
1762
def __init__(self, path, msg):
1763
InvalidHttpResponse.__init__(self, path, msg)
1766
1675
class InvalidHttpContentType(InvalidHttpResponse):
1768
1677
_fmt = 'Invalid http Content-type "%(ctype)s" for %(path)s: %(msg)s'
1796
1705
_fmt = "Working tree has conflicts."
1799
class ConfigContentError(BzrError):
1801
_fmt = "Config file %(filename)s is not UTF-8 encoded\n"
1803
def __init__(self, filename):
1804
BzrError.__init__(self)
1805
self.filename = filename
1808
1708
class ParseConfigError(BzrError):
1810
_fmt = "Error(s) parsing config file %(filename)s:\n%(errors)s"
1812
1710
def __init__(self, errors, filename):
1813
BzrError.__init__(self)
1814
self.filename = filename
1815
self.errors = '\n'.join(e.msg for e in errors)
1818
class ConfigOptionValueError(BzrError):
1820
_fmt = """Bad value "%(value)s" for option "%(name)s"."""
1822
def __init__(self, name, value):
1823
BzrError.__init__(self, name=name, value=value)
1711
if filename is None:
1713
message = "Error(s) parsing config file %s:\n%s" % \
1714
(filename, ('\n'.join(e.msg for e in errors)))
1715
BzrError.__init__(self, message)
1826
1718
class NoEmailInUsername(BzrError):
1835
1727
class SigningFailed(BzrError):
1837
_fmt = 'Failed to GPG sign data with command "%(command_line)s"'
1729
_fmt = 'Failed to gpg sign data with command "%(command_line)s"'
1839
1731
def __init__(self, command_line):
1840
1732
BzrError.__init__(self, command_line=command_line)
1843
class SignatureVerificationFailed(BzrError):
1845
_fmt = 'Failed to verify GPG signature data with error "%(error)s"'
1847
def __init__(self, error):
1848
BzrError.__init__(self, error=error)
1851
class DependencyNotPresent(BzrError):
1853
_fmt = 'Unable to import library "%(library)s": %(error)s'
1855
def __init__(self, library, error):
1856
BzrError.__init__(self, library=library, error=error)
1859
class GpgmeNotInstalled(DependencyNotPresent):
1861
_fmt = 'python-gpgme is not installed, it is needed to verify signatures'
1863
def __init__(self, error):
1864
DependencyNotPresent.__init__(self, 'gpgme', error)
1867
1735
class WorkingTreeNotRevision(BzrError):
1869
1737
_fmt = ("The working tree for %(basedir)s has changed since"
2029
1897
_fmt = "Moving the root directory is not supported at this time"
2032
class TransformRenameFailed(BzrError):
2034
_fmt = "Failed to rename %(from_path)s to %(to_path)s: %(why)s"
2036
def __init__(self, from_path, to_path, why, errno):
2037
self.from_path = from_path
2038
self.to_path = to_path
2043
1900
class BzrMoveFailedError(BzrError):
2045
_fmt = ("Could not move %(from_path)s%(operator)s %(to_path)s"
2046
"%(_has_extra)s%(extra)s")
1902
_fmt = "Could not move %(from_path)s%(operator)s %(to_path)s%(extra)s"
2048
1904
def __init__(self, from_path='', to_path='', extra=None):
2049
1905
from bzrlib.osutils import splitpath
2050
1906
BzrError.__init__(self)
2052
self.extra, self._has_extra = extra, ': '
1908
self.extra = ': ' + str(extra)
2054
self.extra = self._has_extra = ''
2056
1912
has_from = len(from_path) > 0
2057
1913
has_to = len(to_path) > 0
2079
1935
class BzrRenameFailedError(BzrMoveFailedError):
2081
_fmt = ("Could not rename %(from_path)s%(operator)s %(to_path)s"
2082
"%(_has_extra)s%(extra)s")
1937
_fmt = "Could not rename %(from_path)s%(operator)s %(to_path)s%(extra)s"
2084
1939
def __init__(self, from_path, to_path, extra=None):
2085
1940
BzrMoveFailedError.__init__(self, from_path, to_path, extra)
2088
1942
class BzrRemoveChangedFilesError(BzrError):
2089
1943
"""Used when user is trying to remove changed files."""
2093
1947
"Use --keep to not delete them, or --force to delete them regardless.")
2095
1949
def __init__(self, tree_delta):
2096
symbol_versioning.warn(symbol_versioning.deprecated_in((2, 3, 0)) %
2097
"BzrRemoveChangedFilesError", DeprecationWarning, stacklevel=2)
2098
1950
BzrError.__init__(self)
2099
1951
self.changes_as_text = tree_delta.get_changes_as_text()
2100
1952
#self.paths_as_string = '\n'.join(changed_files)
2122
1974
_fmt = "Parameter %(param)s contains a newline."
1977
class DependencyNotPresent(BzrError):
1979
_fmt = 'Unable to import library "%(library)s": %(error)s'
1981
def __init__(self, library, error):
1982
BzrError.__init__(self, library=library, error=error)
2125
1985
class ParamikoNotPresent(DependencyNotPresent):
2127
1987
_fmt = "Unable to import paramiko (required for sftp support): %(error)s"
2147
2007
class BadConversionTarget(BzrError):
2149
_fmt = "Cannot convert from format %(from_format)s to format %(format)s." \
2009
_fmt = "Cannot convert to format %(format)s. %(problem)s"
2152
def __init__(self, problem, format, from_format=None):
2011
def __init__(self, problem, format):
2153
2012
BzrError.__init__(self)
2154
2013
self.problem = problem
2155
2014
self.format = format
2156
self.from_format = from_format or '(unspecified)'
2159
2017
class NoDiffFound(BzrError):
2739
2589
This is distinct from ErrorFromSmartServer so that it is possible to
2740
2590
distinguish between the following two cases:
2742
- ErrorFromSmartServer was uncaught. This is logic error in the client
2743
and so should provoke a traceback to the user.
2744
- ErrorFromSmartServer was caught but its error_tuple could not be
2745
translated. This is probably because the server sent us garbage, and
2746
should not provoke a traceback.
2591
- ErrorFromSmartServer was uncaught. This is logic error in the client
2592
and so should provoke a traceback to the user.
2593
- ErrorFromSmartServer was caught but its error_tuple could not be
2594
translated. This is probably because the server sent us garbage, and
2595
should not provoke a traceback.
2749
2598
_fmt = "Server sent an unexpected error: %(error_tuple)r"
2876
2725
def __init__(self, bzrdir):
2877
2726
import bzrlib.urlutils as urlutils
2878
display_url = urlutils.unescape_for_display(bzrdir.user_url,
2727
display_url = urlutils.unescape_for_display(bzrdir.root_transport.base,
2880
2729
BzrError.__init__(self, bzrdir=bzrdir, display_url=display_url)
2956
2805
more = ' ' + more
2957
2806
import bzrlib.urlutils as urlutils
2958
user_url = getattr(tree, "user_url", None)
2959
if user_url is None:
2960
display_url = str(tree)
2962
display_url = urlutils.unescape_for_display(user_url, 'ascii')
2807
display_url = urlutils.unescape_for_display(
2808
tree.bzrdir.root_transport.base, 'ascii')
2963
2809
BzrError.__init__(self, tree=tree, display_url=display_url, more=more)
2966
class ShelvedChanges(UncommittedChanges):
2968
_fmt = ('Working tree "%(display_url)s" has shelved changes'
2969
' (See bzr shelve --list).%(more)s')
2972
2812
class MissingTemplateVariable(BzrError):
2974
2814
_fmt = 'Variable {%(name)s} is not available.'
3043
2883
self.user_encoding = osutils.get_user_encoding()
3046
class NoSuchConfig(BzrError):
3048
_fmt = ('The "%(config_id)s" configuration does not exist.')
3050
def __init__(self, config_id):
3051
BzrError.__init__(self, config_id=config_id)
3054
class NoSuchConfigOption(BzrError):
3056
_fmt = ('The "%(option_name)s" configuration option does not exist.')
3058
def __init__(self, option_name):
3059
BzrError.__init__(self, option_name=option_name)
3062
2886
class NoSuchAlias(BzrError):
3064
2888
_fmt = ('The alias "%(alias_name)s" does not exist.')
3094
2918
_fmt = 'Cannot bind address "%(host)s:%(port)i": %(orig_error)s.'
3096
2920
def __init__(self, host, port, orig_error):
3097
# nb: in python2.4 socket.error doesn't have a useful repr
3098
2921
BzrError.__init__(self, host=host, port=port,
3099
orig_error=repr(orig_error.args))
2922
orig_error=orig_error[1])
3102
2925
class UnknownRules(BzrError):
3110
2933
class HookFailed(BzrError):
3111
2934
"""Raised when a pre_change_branch_tip hook function fails anything other
3112
2935
than TipChangeRejected.
3114
Note that this exception is no longer raised, and the import is only left
3115
to be nice to code which might catch it in a plugin.
3118
2938
_fmt = ("Hook '%(hook_name)s' during %(hook_stage)s failed:\n"
3119
2939
"%(traceback_text)s%(exc_value)s")
3121
def __init__(self, hook_stage, hook_name, exc_info, warn=True):
3123
symbol_versioning.warn("BzrError HookFailed has been deprecated "
3124
"as of bzrlib 2.1.", DeprecationWarning, stacklevel=2)
2941
def __init__(self, hook_stage, hook_name, exc_info):
3125
2942
import traceback
3126
2943
self.hook_stage = hook_stage
3127
2944
self.hook_name = hook_name
3148
2965
_fmt = "Shelf corrupt."
3151
class DecompressCorruption(BzrError):
3153
_fmt = "Corruption while decompressing repository file%(orig_error)s"
3155
def __init__(self, orig_error=None):
3156
if orig_error is not None:
3157
self.orig_error = ", %s" % (orig_error,)
3159
self.orig_error = ""
3160
BzrError.__init__(self)
3163
2968
class NoSuchShelfId(BzrError):
3165
2970
_fmt = 'No changes are shelved with id "%(shelf_id)d".'
3261
3066
def __init__(self, source_branch, target_branch):
3262
3067
self.source_branch = source_branch
3263
3068
self.target_branch = target_branch
3266
class NoRoundtrippingSupport(BzrError):
3268
_fmt = ("Roundtripping is not supported between %(source_branch)r and "
3269
"%(target_branch)r.")
3271
internal_error = True
3273
def __init__(self, source_branch, target_branch):
3274
self.source_branch = source_branch
3275
self.target_branch = target_branch
3278
class FileTimestampUnavailable(BzrError):
3280
_fmt = "The filestamp for %(path)s is not available."
3282
internal_error = True
3284
def __init__(self, path):
3288
class NoColocatedBranchSupport(BzrError):
3290
_fmt = ("%(bzrdir)r does not support co-located branches.")
3292
def __init__(self, bzrdir):
3293
self.bzrdir = bzrdir
3296
class NoWhoami(BzrError):
3298
_fmt = ('Unable to determine your name.\n'
3299
"Please, set your name with the 'whoami' command.\n"
3300
'E.g. bzr whoami "Your Name <name@example.com>"')
3303
class InvalidPattern(BzrError):
3305
_fmt = ('Invalid pattern(s) found. %(msg)s')
3307
def __init__(self, msg):
3311
class RecursiveBind(BzrError):
3313
_fmt = ('Branch "%(branch_url)s" appears to be bound to itself. '
3314
'Please use `bzr unbind` to fix.')
3316
def __init__(self, branch_url):
3317
self.branch_url = branch_url
3320
# FIXME: I would prefer to define the config related exception classes in
3321
# config.py but the lazy import mechanism proscribes this -- vila 20101222
3322
class OptionExpansionLoop(BzrError):
3324
_fmt = 'Loop involving %(refs)r while expanding "%(string)s".'
3326
def __init__(self, string, refs):
3327
self.string = string
3328
self.refs = '->'.join(refs)
3331
class ExpandingUnknownOption(BzrError):
3333
_fmt = 'Option %(name)s is not defined while expanding "%(string)s".'
3335
def __init__(self, name, string):
3337
self.string = string
3340
class NoCompatibleInter(BzrError):
3342
_fmt = ('No compatible object available for operations from %(source)r '
3345
def __init__(self, source, target):
3346
self.source = source
3347
self.target = target
3350
class HpssVfsRequestNotAllowed(BzrError):
3352
_fmt = ("VFS requests over the smart server are not allowed. Encountered: "
3353
"%(method)s, %(arguments)s.")
3355
def __init__(self, method, arguments):
3356
self.method = method
3357
self.arguments = arguments
added
removed
bzrlib/errors.py
