13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17
17
"""Exceptions for bzr, and reporting of them.
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,
486
486
# XXX: Should be unified with TransportError; they seem to represent the
488
488
# RBC 20060929: I think that unifiying with TransportError would be a mistake
489
# - this is finer than a TransportError - and more useful as such. It
489
# - this is finer than a TransportError - and more useful as such. It
490
490
# differentiates between 'transport has failed' and 'operation on a transport
492
492
class PathError(BzrError):
494
494
_fmt = "Generic path error: %(path)r%(extra)s)"
496
496
def __init__(self, path, extra=None):
639
class UnstackableLocationError(BzrError):
641
_fmt = "The branch '%(branch_url)s' cannot be stacked on '%(target_url)s'."
643
def __init__(self, branch_url, target_url):
644
BzrError.__init__(self)
645
self.branch_url = branch_url
646
self.target_url = target_url
649
639
class UnstackableRepositoryFormat(BzrError):
651
641
_fmt = ("The repository '%(url)s'(%(format)s) is not a stackable format. "
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):
1041
1004
class LockContention(LockError):
1043
_fmt = 'Could not acquire lock "%(lock)s": %(msg)s'
1006
_fmt = 'Could not acquire lock "%(lock)s"'
1044
1007
# TODO: show full url for lock, combining the transport and relative
1047
1010
internal_error = False
1049
def __init__(self, lock, msg=''):
1012
def __init__(self, lock):
1050
1013
self.lock = lock
1054
1016
class LockBroken(LockError):
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)
1923
1890
class CantMoveRoot(BzrError):
1925
1892
_fmt = "Moving the root directory is not supported at this time"
1928
class TransformRenameFailed(BzrError):
1930
_fmt = "Failed to rename %(from_path)s to %(to_path)s: %(why)s"
1932
def __init__(self, from_path, to_path, why, errno):
1933
self.from_path = from_path
1934
self.to_path = to_path
1939
1895
class BzrMoveFailedError(BzrError):
2046
2002
class BadConversionTarget(BzrError):
2048
_fmt = "Cannot convert from format %(from_format)s to format %(format)s." \
2004
_fmt = "Cannot convert to format %(format)s. %(problem)s"
2051
def __init__(self, problem, format, from_format=None):
2006
def __init__(self, problem, format):
2052
2007
BzrError.__init__(self)
2053
2008
self.problem = problem
2054
2009
self.format = format
2055
self.from_format = from_format or '(unspecified)'
2058
2012
class NoDiffFound(BzrError):
2135
2089
class OutOfDateTree(BzrError):
2137
_fmt = "Working tree is out of date, please run 'bzr update'.%(more)s"
2091
_fmt = "Working tree is out of date, please run 'bzr update'."
2139
def __init__(self, tree, more=None):
2093
def __init__(self, tree):
2144
2094
BzrError.__init__(self)
2145
2095
self.tree = tree
2149
2098
class PublicBranchOutOfDate(BzrError):
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):
2580
2528
self.branch = branch
2583
class InvalidLineInBugsProperty(BzrError):
2585
_fmt = ("Invalid line in bugs property: '%(line)s'")
2587
def __init__(self, line):
2591
class InvalidBugStatus(BzrError):
2593
_fmt = ("Invalid bug status: '%(status)s'")
2595
def __init__(self, status):
2596
self.status = status
2599
2531
class UnexpectedSmartServerResponse(BzrError):
2601
2533
_fmt = "Could not understand response from smart server: %(response_tuple)r"
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):
2959
2879
_fmt = 'Cannot bind address "%(host)s:%(port)i": %(orig_error)s.'
2961
2881
def __init__(self, host, port, orig_error):
2962
# nb: in python2.4 socket.error doesn't have a useful repr
2963
2882
BzrError.__init__(self, host=host, port=port,
2964
orig_error=repr(orig_error.args))
2883
orig_error=orig_error[1])
2967
2886
class UnknownRules(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
3049
2954
def __init__(self, format, url):
3050
2955
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>"')