~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/errors.py

  • Committer: Robert Collins
  • Date: 2010-05-06 23:41:35 UTC
  • mto: This revision was merged to the branch mainline in revision 5223.
  • Revision ID: robertc@robertcollins.net-20100506234135-yivbzczw1sejxnxc
Lock methods on ``Tree``, ``Branch`` and ``Repository`` are now
expected to return an object which can be used to unlock them. This reduces
duplicate code when using cleanups. The previous 'tokens's returned by
``Branch.lock_write`` and ``Repository.lock_write`` are now attributes
on the result of the lock_write. ``repository.RepositoryWriteLockResult``
and ``branch.BranchWriteLockResult`` document this. (Robert Collins)

``log._get_info_for_log_files`` now takes an add_cleanup callable.
(Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006, 2007, 2008 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
702
702
# TODO: Probably this behavior of should be a common superclass
703
703
class NotBranchError(PathError):
704
704
 
705
 
    _fmt = 'Not a branch: "%(path)s".'
 
705
    _fmt = 'Not a branch: "%(path)s"%(detail)s.'
706
706
 
707
 
    def __init__(self, path):
 
707
    def __init__(self, path, detail=None, bzrdir=None):
708
708
       import bzrlib.urlutils as urlutils
709
 
       self.path = urlutils.unescape_for_display(path, 'ascii')
 
709
       path = urlutils.unescape_for_display(path, 'ascii')
 
710
       if detail is not None:
 
711
           detail = ': ' + detail
 
712
       self.detail = detail
 
713
       self.bzrdir = bzrdir
 
714
       PathError.__init__(self, path=path)
 
715
 
 
716
    def _format(self):
 
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:
 
722
                try:
 
723
                    self.bzrdir.open_repository()
 
724
                except NoRepositoryPresent:
 
725
                    self.detail = ''
 
726
                else:
 
727
                    self.detail = ': location is a repository'
 
728
            else:
 
729
                self.detail = ''
 
730
        return PathError._format(self)
710
731
 
711
732
 
712
733
class NoSubmitBranch(PathError):
793
814
 
794
815
 
795
816
class IncompatibleRepositories(BzrError):
 
817
    """Report an error that two repositories are not compatible.
 
818
 
 
819
    Note that the source and target repositories are permitted to be strings:
 
820
    this exception is thrown from the smart server and may refer to a
 
821
    repository the client hasn't opened.
 
822
    """
796
823
 
797
824
    _fmt = "%(target)s\n" \
798
825
            "is not compatible with\n" \
1152
1179
 
1153
1180
class InvalidRevisionSpec(BzrError):
1154
1181
 
1155
 
    _fmt = ("Requested revision: %(spec)r does not exist in branch:"
 
1182
    _fmt = ("Requested revision: '%(spec)s' does not exist in branch:"
1156
1183
            " %(branch)s%(extra)s")
1157
1184
 
1158
1185
    def __init__(self, spec, branch, extra=None):
1241
1268
class AmbiguousBase(BzrError):
1242
1269
 
1243
1270
    def __init__(self, bases):
1244
 
        warn("BzrError AmbiguousBase has been deprecated as of bzrlib 0.8.",
1245
 
                DeprecationWarning)
 
1271
        symbol_versioning.warn("BzrError AmbiguousBase has been deprecated "
 
1272
            "as of bzrlib 0.8.", DeprecationWarning, stacklevel=2)
1246
1273
        msg = ("The correct base is unclear, because %s are all equally close"
1247
1274
                % ", ".join(bases))
1248
1275
        BzrError.__init__(self, msg)
1270
1297
class BoundBranchOutOfDate(BzrError):
1271
1298
 
1272
1299
    _fmt = ("Bound branch %(branch)s is out of date with master branch"
1273
 
            " %(master)s.")
 
1300
            " %(master)s.%(extra_help)s")
1274
1301
 
1275
1302
    def __init__(self, branch, master):
1276
1303
        BzrError.__init__(self)
1277
1304
        self.branch = branch
1278
1305
        self.master = master
 
1306
        self.extra_help = ''
1279
1307
 
1280
1308
 
1281
1309
class CommitToDoubleBoundBranch(BzrError):
2006
2034
 
2007
2035
class BadConversionTarget(BzrError):
2008
2036
 
2009
 
    _fmt = "Cannot convert to format %(format)s.  %(problem)s"
 
2037
    _fmt = "Cannot convert from format %(from_format)s to format %(format)s." \
 
2038
            "    %(problem)s"
2010
2039
 
2011
 
    def __init__(self, problem, format):
 
2040
    def __init__(self, problem, format, from_format=None):
2012
2041
        BzrError.__init__(self)
2013
2042
        self.problem = problem
2014
2043
        self.format = format
 
2044
        self.from_format = from_format or '(unspecified)'
2015
2045
 
2016
2046
 
2017
2047
class NoDiffFound(BzrError):
2146
2176
 
2147
2177
    def __init__(self, repo):
2148
2178
        BzrError.__init__(self)
2149
 
        self.repo_path = repo.bzrdir.root_transport.base
 
2179
        self.repo_path = repo.user_url
2150
2180
 
2151
2181
 
2152
2182
class InconsistentDelta(BzrError):
2724
2754
 
2725
2755
    def __init__(self, bzrdir):
2726
2756
        import bzrlib.urlutils as urlutils
2727
 
        display_url = urlutils.unescape_for_display(bzrdir.root_transport.base,
 
2757
        display_url = urlutils.unescape_for_display(bzrdir.user_url,
2728
2758
                                                    'ascii')
2729
2759
        BzrError.__init__(self, bzrdir=bzrdir, display_url=display_url)
2730
2760
 
2805
2835
            more = ' ' + more
2806
2836
        import bzrlib.urlutils as urlutils
2807
2837
        display_url = urlutils.unescape_for_display(
2808
 
            tree.bzrdir.root_transport.base, 'ascii')
 
2838
            tree.user_url, 'ascii')
2809
2839
        BzrError.__init__(self, tree=tree, display_url=display_url, more=more)
2810
2840
 
2811
2841
 
2918
2948
    _fmt = 'Cannot bind address "%(host)s:%(port)i": %(orig_error)s.'
2919
2949
 
2920
2950
    def __init__(self, host, port, orig_error):
 
2951
        # nb: in python2.4 socket.error doesn't have a useful repr
2921
2952
        BzrError.__init__(self, host=host, port=port,
2922
 
            orig_error=orig_error[1])
 
2953
            orig_error=repr(orig_error.args))
2923
2954
 
2924
2955
 
2925
2956
class UnknownRules(BzrError):
2933
2964
class HookFailed(BzrError):
2934
2965
    """Raised when a pre_change_branch_tip hook function fails anything other
2935
2966
    than TipChangeRejected.
 
2967
 
 
2968
    Note that this exception is no longer raised, and the import is only left
 
2969
    to be nice to code which might catch it in a plugin.
2936
2970
    """
2937
2971
 
2938
2972
    _fmt = ("Hook '%(hook_name)s' during %(hook_stage)s failed:\n"
2939
2973
            "%(traceback_text)s%(exc_value)s")
2940
2974
 
2941
 
    def __init__(self, hook_stage, hook_name, exc_info):
 
2975
    def __init__(self, hook_stage, hook_name, exc_info, warn=True):
 
2976
        if warn:
 
2977
            symbol_versioning.warn("BzrError HookFailed has been deprecated "
 
2978
                "as of bzrlib 2.1.", DeprecationWarning, stacklevel=2)
2942
2979
        import traceback
2943
2980
        self.hook_stage = hook_stage
2944
2981
        self.hook_name = hook_name
3066
3103
    def __init__(self, source_branch, target_branch):
3067
3104
        self.source_branch = source_branch
3068
3105
        self.target_branch = target_branch
 
3106
 
 
3107
 
 
3108
class NoRoundtrippingSupport(BzrError):
 
3109
 
 
3110
    _fmt = ("Roundtripping is not supported between %(source_branch)r and "
 
3111
            "%(target_branch)r.")
 
3112
 
 
3113
    internal_error = True
 
3114
 
 
3115
    def __init__(self, source_branch, target_branch):
 
3116
        self.source_branch = source_branch
 
3117
        self.target_branch = target_branch
 
3118
 
 
3119
 
 
3120
class FileTimestampUnavailable(BzrError):
 
3121
 
 
3122
    _fmt = "The filestamp for %(path)s is not available."
 
3123
 
 
3124
    internal_error = True
 
3125
 
 
3126
    def __init__(self, path):
 
3127
        self.path = path
 
3128
 
 
3129
 
 
3130
class NoColocatedBranchSupport(BzrError):
 
3131
 
 
3132
    _fmt = ("%(bzrdir)r does not support co-located branches.")
 
3133
 
 
3134
    def __init__(self, bzrdir):
 
3135
        self.bzrdir = bzrdir
 
3136