72
72
arguments can be given. The first is for generic "user" errors which
73
73
are not intended to be caught and so do not need a specific subclass.
74
74
The second case is for use with subclasses that provide a _fmt format
75
string to print the arguments.
75
string to print the arguments.
77
Keyword arguments are taken as parameters to the error, which can
78
be inserted into the format string template. It's recommended
79
that subclasses override the __init__ method to require specific
77
Keyword arguments are taken as parameters to the error, which can
78
be inserted into the format string template. It's recommended
79
that subclasses override the __init__ method to require specific
82
82
:param msg: If given, this is the literal complete text for the error,
700
690
# TODO: This is given a URL; we try to unescape it but doing that from inside
701
691
# the exception object is a bit undesirable.
702
# TODO: Probably this behavior of should be a common superclass
692
# TODO: Probably this behavior of should be a common superclass
703
693
class NotBranchError(PathError):
705
_fmt = 'Not a branch: "%(path)s"%(detail)s.'
695
_fmt = 'Not a branch: "%(path)s".'
707
def __init__(self, path, detail=None, bzrdir=None):
697
def __init__(self, path):
708
698
import bzrlib.urlutils as urlutils
709
path = urlutils.unescape_for_display(path, 'ascii')
710
if detail is not None:
711
detail = ': ' + detail
714
PathError.__init__(self, path=path)
717
# XXX: Ideally self.detail would be a property, but Exceptions in
718
# Python 2.4 have to be old-style classes so properties don't work.
719
# Instead we override _format.
720
if self.detail is None:
721
if self.bzrdir is not None:
723
self.bzrdir.open_repository()
724
except NoRepositoryPresent:
727
self.detail = ': location is a repository'
730
return PathError._format(self)
699
self.path = urlutils.unescape_for_display(path, 'ascii')
733
702
class NoSubmitBranch(PathError):
1265
1226
not_ancestor_id=not_ancestor_id)
1229
class InstallFailed(BzrError):
1231
def __init__(self, revisions):
1232
revision_str = ", ".join(str(r) for r in revisions)
1233
msg = "Could not install revisions:\n%s" % revision_str
1234
BzrError.__init__(self, msg)
1235
self.revisions = revisions
1268
1238
class AmbiguousBase(BzrError):
1270
1240
def __init__(self, bases):
1271
symbol_versioning.warn("BzrError AmbiguousBase has been deprecated "
1272
"as of bzrlib 0.8.", DeprecationWarning, stacklevel=2)
1241
warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
1273
1243
msg = ("The correct base is unclear, because %s are all equally close"
1274
1244
% ", ".join(bases))
1275
1245
BzrError.__init__(self, msg)
2229
2166
_fmt = "To use this feature you must upgrade your repository at %(path)s."
2232
class RichRootUpgradeRequired(UpgradeRequired):
2234
_fmt = ("To use this feature you must upgrade your branch at %(path)s to"
2235
" a format which supports rich roots.")
2238
2169
class LocalRequiresBoundBranch(BzrError):
2240
2171
_fmt = "Cannot perform local-only commits on unbound branches."
2174
class InvalidProgressBarType(BzrError):
2176
_fmt = ("Environment variable BZR_PROGRESS_BAR='%(bar_type)s"
2177
" is not a supported type Select one of: %(valid_types)s")
2179
def __init__(self, bar_type, valid_types):
2180
BzrError.__init__(self, bar_type=bar_type, valid_types=valid_types)
2243
2183
class UnsupportedOperation(BzrError):
2245
2185
_fmt = ("The method %(mname)s is not supported on"
2305
2245
self.text = text
2308
class MalformedHeader(BadBundle):
2248
class MalformedHeader(BadBundle):
2310
2250
_fmt = "Malformed bzr revision-bundle header: %(text)r"
2313
class MalformedPatches(BadBundle):
2253
class MalformedPatches(BadBundle):
2315
2255
_fmt = "Malformed patches in bzr revision-bundle: %(text)r"
2318
class MalformedFooter(BadBundle):
2258
class MalformedFooter(BadBundle):
2320
2260
_fmt = "Malformed footer in bzr revision-bundle: %(text)r"
2323
2263
class UnsupportedEOLMarker(BadBundle):
2325
_fmt = "End of line marker was not \\n in bzr revision-bundle"
2265
_fmt = "End of line marker was not \\n in bzr revision-bundle"
2327
2267
def __init__(self):
2328
# XXX: BadBundle's constructor assumes there's explanatory text,
2268
# XXX: BadBundle's constructor assumes there's explanatory text,
2329
2269
# but for this there is not
2330
2270
BzrError.__init__(self)
2333
2273
class IncompatibleBundleFormat(BzrError):
2335
2275
_fmt = "Bundle format %(bundle_format)s is incompatible with %(other)s"
2337
2277
def __init__(self, bundle_format, other):
2837
2757
class UncommittedChanges(BzrError):
2839
_fmt = ('Working tree "%(display_url)s" has uncommitted changes'
2840
' (See bzr status).%(more)s')
2759
_fmt = 'Working tree "%(display_url)s" has uncommitted changes.'
2842
def __init__(self, tree, more=None):
2761
def __init__(self, tree):
2847
2762
import bzrlib.urlutils as urlutils
2848
2763
display_url = urlutils.unescape_for_display(
2849
tree.user_url, 'ascii')
2850
BzrError.__init__(self, tree=tree, display_url=display_url, more=more)
2764
tree.bzrdir.root_transport.base, 'ascii')
2765
BzrError.__init__(self, tree=tree, display_url=display_url)
2853
2768
class MissingTemplateVariable(BzrError):
2890
2805
class CommandAvailableInPlugin(StandardError):
2892
2807
internal_error = False
2894
2809
def __init__(self, cmd_name, plugin_metadata, provider):
2896
2811
self.plugin_metadata = plugin_metadata
2897
2812
self.cmd_name = cmd_name
2898
2813
self.provider = provider
2900
2815
def __str__(self):
2902
_fmt = ('"%s" is not a standard bzr command. \n'
2817
_fmt = ('"%s" is not a standard bzr command. \n'
2903
2818
'However, the following official plugin provides this command: %s\n'
2904
2819
'You can install it by going to: %s'
2905
% (self.cmd_name, self.plugin_metadata['name'],
2820
% (self.cmd_name, self.plugin_metadata['name'],
2906
2821
self.plugin_metadata['url']))
2911
2826
class NoPluginAvailable(BzrError):
2830
class NotATerminal(BzrError):
2832
_fmt = 'Unable to ask for a password without real terminal.'
2915
2835
class UnableEncodePath(BzrError):
2975
2894
class HookFailed(BzrError):
2976
2895
"""Raised when a pre_change_branch_tip hook function fails anything other
2977
2896
than TipChangeRejected.
2979
Note that this exception is no longer raised, and the import is only left
2980
to be nice to code which might catch it in a plugin.
2983
2899
_fmt = ("Hook '%(hook_name)s' during %(hook_stage)s failed:\n"
2984
2900
"%(traceback_text)s%(exc_value)s")
2986
def __init__(self, hook_stage, hook_name, exc_info, warn=True):
2988
symbol_versioning.warn("BzrError HookFailed has been deprecated "
2989
"as of bzrlib 2.1.", DeprecationWarning, stacklevel=2)
2902
def __init__(self, hook_stage, hook_name, exc_info):
2990
2903
import traceback
2991
2904
self.hook_stage = hook_stage
2992
2905
self.hook_name = hook_name
3021
2934
BzrError.__init__(self, shelf_id=shelf_id)
3024
class InvalidShelfId(BzrError):
3026
_fmt = '"%(invalid_id)s" is not a valid shelf id, try a number instead.'
3028
def __init__(self, invalid_id):
3029
BzrError.__init__(self, invalid_id=invalid_id)
3032
class JailBreak(BzrError):
3034
_fmt = "An attempt to access a url outside the server jail was made: '%(url)s'."
3036
def __init__(self, url):
3037
BzrError.__init__(self, url=url)
3040
2937
class UserAbort(BzrError):
3042
2939
_fmt = 'The user aborted the operation.'
3045
class MustHaveWorkingTree(BzrError):
3047
_fmt = ("Branching '%(url)s'(%(format)s) must create a working tree.")
3049
def __init__(self, format, url):
3050
BzrError.__init__(self, format=format, url=url)
3053
class NoSuchView(BzrError):
3054
"""A view does not exist.
3057
_fmt = u"No such view: %(view_name)s."
3059
def __init__(self, view_name):
3060
self.view_name = view_name
3063
class ViewsNotSupported(BzrError):
3064
"""Views are not supported by a tree format.
3067
_fmt = ("Views are not supported by %(tree)s;"
3068
" use 'bzr upgrade' to change your tree to a later format.")
3070
def __init__(self, tree):
3074
class FileOutsideView(BzrError):
3076
_fmt = ('Specified file "%(file_name)s" is outside the current view: '
3079
def __init__(self, file_name, view_files):
3080
self.file_name = file_name
3081
self.view_str = ", ".join(view_files)
3084
class UnresumableWriteGroup(BzrError):
3086
_fmt = ("Repository %(repository)s cannot resume write group "
3087
"%(write_groups)r: %(reason)s")
3089
internal_error = True
3091
def __init__(self, repository, write_groups, reason):
3092
self.repository = repository
3093
self.write_groups = write_groups
3094
self.reason = reason
3097
class UnsuspendableWriteGroup(BzrError):
3099
_fmt = ("Repository %(repository)s cannot suspend a write group.")
3101
internal_error = True
3103
def __init__(self, repository):
3104
self.repository = repository
3107
class LossyPushToSameVCS(BzrError):
3109
_fmt = ("Lossy push not possible between %(source_branch)r and "
3110
"%(target_branch)r that are in the same VCS.")
3112
internal_error = True
3114
def __init__(self, source_branch, target_branch):
3115
self.source_branch = source_branch
3116
self.target_branch = target_branch
3119
class NoRoundtrippingSupport(BzrError):
3121
_fmt = ("Roundtripping is not supported between %(source_branch)r and "
3122
"%(target_branch)r.")
3124
internal_error = True
3126
def __init__(self, source_branch, target_branch):
3127
self.source_branch = source_branch
3128
self.target_branch = target_branch
3131
class FileTimestampUnavailable(BzrError):
3133
_fmt = "The filestamp for %(path)s is not available."
3135
internal_error = True
3137
def __init__(self, path):
3141
class NoColocatedBranchSupport(BzrError):
3143
_fmt = ("%(bzrdir)r does not support co-located branches.")
3145
def __init__(self, bzrdir):
3146
self.bzrdir = bzrdir
3148
class NoWhoami(BzrError):
3150
_fmt = ('Unable to determine your name.\n'
3151
"Please, set your name with the 'whoami' command.\n"
3152
'E.g. bzr whoami "Your Name <name@example.com>"')