~bzr-pqm/bzr/bzr.dev

1553.5.24 by Martin Pool
Warning to check storage when lock was broken
1
# Copyright (C) 2005, 2006 Canonical
1 by mbp at sourcefrog
import from baz patch-364
2
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
7
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
# GNU General Public License for more details.
12
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
1185.16.61 by mbp at sourcefrog
- start introducing hct error classes
17
"""Exceptions for bzr, and reporting of them.
18
19
Exceptions are caught at a high level to report errors to the user, and
20
might also be caught inside the program.  Therefore it needs to be
21
possible to convert them to a meaningful string, and also for them to be
22
interrogated by the program.
23
24
Exceptions are defined such that the arguments given to the constructor
25
are stored in the object as properties of the same name.  When the
26
object is printed as a string, the doc string of the class is used as
27
a format string with the property dictionary available to it.
28
29
This means that exceptions can used like this:
30
31
>>> import sys
32
>>> try:
33
...   raise NotBranchError(path='/foo/bar')
34
... except:
35
...   print sys.exc_type
36
...   print sys.exc_value
1185.50.38 by John Arbash Meinel
Changed exception traceback route to not use hasattr, which generates its own exception.
37
...   path = getattr(sys.exc_value, 'path')
38
...   if path is not None:
39
...     print path
1185.16.61 by mbp at sourcefrog
- start introducing hct error classes
40
bzrlib.errors.NotBranchError
41
Not a branch: /foo/bar
42
/foo/bar
43
44
Therefore:
45
46
 * create a new exception class for any class of error that can be
47
   usefully distinguished.
48
49
 * the printable form of an exception is generated by the base class
50
   __str__ method
1185.33.7 by Martin Pool
Better formatting of builtin errors
51
52
Exception strings should start with a capital letter and not have a final
53
fullstop.
1185.16.61 by mbp at sourcefrog
- start introducing hct error classes
54
"""
55
56
# based on Scott James Remnant's hct error classes
57
1185.16.62 by mbp at sourcefrog
- convert NotBranchError to new exception base
58
# TODO: is there any value in providing the .args field used by standard
59
# python exceptions?   A list of values with no names seems less useful 
60
# to me.
61
1185.16.63 by Martin Pool
- more error conversion
62
# TODO: Perhaps convert the exception to a string at the moment it's 
63
# constructed to make sure it will succeed.  But that says nothing about
64
# exceptions that are never raised.
65
66
# TODO: Convert all the other error classes here to BzrNewError, and eliminate
67
# the old one.
1185.16.62 by mbp at sourcefrog
- convert NotBranchError to new exception base
68
1185.16.61 by mbp at sourcefrog
- start introducing hct error classes
69
1 by mbp at sourcefrog
import from baz patch-364
70
class BzrError(StandardError):
1193 by Martin Pool
- better string formatting of BzrErrors with explanation
71
    def __str__(self):
1393.1.64 by Martin Pool
- improved display of some errors, including NotBranchError
72
        # XXX: Should we show the exception class in 
73
        # exceptions that don't provide their own message?  
74
        # maybe it should be done at a higher level
75
        ## n = self.__class__.__name__ + ': '
76
        n = ''
1195 by Martin Pool
- better error display
77
        if len(self.args) == 1:
1449 by Robert Collins
teach check about ghosts
78
            return str(self.args[0])
1195 by Martin Pool
- better error display
79
        elif len(self.args) == 2:
1193 by Martin Pool
- better string formatting of BzrErrors with explanation
80
            # further explanation or suggestions
1405 by Robert Collins
remove some of the upgrade code that was duplicated with inventory_entry, and give all inventory entries a weave
81
            try:
1393.1.64 by Martin Pool
- improved display of some errors, including NotBranchError
82
                return n + '\n  '.join([self.args[0]] + self.args[1])
1405 by Robert Collins
remove some of the upgrade code that was duplicated with inventory_entry, and give all inventory entries a weave
83
            except TypeError:
1393.1.64 by Martin Pool
- improved display of some errors, including NotBranchError
84
                return n + "%r" % self
1193 by Martin Pool
- better string formatting of BzrErrors with explanation
85
        else:
1393.1.64 by Martin Pool
- improved display of some errors, including NotBranchError
86
            return n + `self.args`
1193 by Martin Pool
- better string formatting of BzrErrors with explanation
87
1185.1.14 by Robert Collins
remove more duplicate merged hunks. Bad MERGE3, BAD.
88
1185.16.62 by mbp at sourcefrog
- convert NotBranchError to new exception base
89
class BzrNewError(BzrError):
1185.16.61 by mbp at sourcefrog
- start introducing hct error classes
90
    """bzr error"""
91
    # base classes should override the docstring with their human-
92
    # readable explanation
93
94
    def __init__(self, **kwds):
95
        for key, value in kwds.items():
96
            setattr(self, key, value)
97
98
    def __str__(self):
99
        try:
100
            return self.__doc__ % self.__dict__
101
        except (NameError, ValueError, KeyError), e:
102
            return 'Unprintable exception %s: %s' \
103
                % (self.__class__.__name__, str(e))
104
105
1185.16.63 by Martin Pool
- more error conversion
106
class BzrCheckError(BzrNewError):
107
    """Internal check failed: %(message)s"""
1508.1.22 by Robert Collins
implement out of date working tree checks in commit.
108
1185.16.63 by Martin Pool
- more error conversion
109
    def __init__(self, message):
1185.16.103 by mbp at sourcefrog
Fix up all calls to InvalidRevisionId() to specify parameters.
110
        BzrNewError.__init__(self)
1185.16.63 by Martin Pool
- more error conversion
111
        self.message = message
112
113
114
class InvalidEntryName(BzrNewError):
115
    """Invalid entry name: %(name)s"""
116
    def __init__(self, name):
1185.16.103 by mbp at sourcefrog
Fix up all calls to InvalidRevisionId() to specify parameters.
117
        BzrNewError.__init__(self)
1185.16.63 by Martin Pool
- more error conversion
118
        self.name = name
119
120
121
class InvalidRevisionNumber(BzrNewError):
122
    """Invalid revision number %(revno)d"""
123
    def __init__(self, revno):
1185.16.103 by mbp at sourcefrog
Fix up all calls to InvalidRevisionId() to specify parameters.
124
        BzrNewError.__init__(self)
1185.16.63 by Martin Pool
- more error conversion
125
        self.revno = revno
126
127
128
class InvalidRevisionId(BzrNewError):
1185.16.103 by mbp at sourcefrog
Fix up all calls to InvalidRevisionId() to specify parameters.
129
    """Invalid revision-id {%(revision_id)s} in %(branch)s"""
130
    def __init__(self, revision_id, branch):
131
        BzrNewError.__init__(self)
1185.12.90 by Aaron Bentley
Fixed InvalidRevisionID handling in Branch.get_revision_xml
132
        self.revision_id = revision_id
1185.16.103 by mbp at sourcefrog
Fix up all calls to InvalidRevisionId() to specify parameters.
133
        self.branch = branch
974.1.26 by aaron.bentley at utoronto
merged mbp@sourcefrog.net-20050817233101-0939da1cf91f2472
134
135
1497 by Robert Collins
Move Branch.read_working_inventory to WorkingTree.
136
class NoWorkingTree(BzrNewError):
137
    """No WorkingTree exists for %s(base)."""
138
    
139
    def __init__(self, base):
140
        BzrNewError.__init__(self)
141
        self.base = base
1506 by Robert Collins
Merge Johns current integration work.
142
143
1534.4.42 by Robert Collins
add working tree to the BzrDir facilities.
144
class NotLocalUrl(BzrNewError):
145
    """%s(url) is not a local path."""
146
    
147
    def __init__(self, url):
148
        BzrNewError.__init__(self)
149
        self.url = url
150
151
329 by Martin Pool
- refactor command functions into command classes
152
class BzrCommandError(BzrError):
153
    # Error from malformed user command
1495 by Robert Collins
Add a --create-prefix to the new push command.
154
    # This is being misused as a generic exception
155
    # pleae subclass. RBC 20051030
1185.54.18 by Aaron Bentley
Noted difference of opinion wrt BzrCommandError
156
    #
157
    # I think it's a waste of effort to differentiate between errors that
158
    # are not intended to be caught anyway.  UI code need not subclass
159
    # BzrCommandError, and non-UI code should not throw a subclass of
160
    # BzrCommandError.  ADHB 20051211
1393.1.64 by Martin Pool
- improved display of some errors, including NotBranchError
161
    def __str__(self):
162
        return self.args[0]
1 by mbp at sourcefrog
import from baz patch-364
163
1495 by Robert Collins
Add a --create-prefix to the new push command.
164
165
class BzrOptionError(BzrCommandError):
166
    """Some missing or otherwise incorrect option was supplied."""
167
168
    
1185.16.65 by mbp at sourcefrog
- new commit --strict option
169
class StrictCommitFailed(Exception):
170
    """Commit refused because there are unknowns in the tree."""
1 by mbp at sourcefrog
import from baz patch-364
171
1185.31.41 by John Arbash Meinel
Creating a PathNotChild exception, and using relpath in HTTPTestUtil
172
1185.31.44 by John Arbash Meinel
Cleaned up Exceptions for all transports.
173
class PathError(BzrNewError):
174
    """Generic path error: %(path)r%(extra)s)"""
175
    def __init__(self, path, extra=None):
176
        BzrNewError.__init__(self)
177
        self.path = path
178
        if extra:
179
            self.extra = ': ' + str(extra)
180
        else:
181
            self.extra = ''
182
183
184
class NoSuchFile(PathError):
185
    """No such file: %(path)r%(extra)s"""
186
187
188
class FileExists(PathError):
189
    """File exists: %(path)r%(extra)s"""
190
191
1553.5.10 by Martin Pool
New DirectoryNotEmpty exception, and raise this from local and memory
192
class DirectoryNotEmpty(PathError):
193
    """Directory not empty: %(path)r%(extra)s"""
194
195
1185.31.44 by John Arbash Meinel
Cleaned up Exceptions for all transports.
196
class PermissionDenied(PathError):
197
    """Permission denied: %(path)r%(extra)s"""
198
199
1185.31.41 by John Arbash Meinel
Creating a PathNotChild exception, and using relpath in HTTPTestUtil
200
class PathNotChild(BzrNewError):
1185.31.44 by John Arbash Meinel
Cleaned up Exceptions for all transports.
201
    """Path %(path)r is not a child of path %(base)r%(extra)s"""
202
    def __init__(self, path, base, extra=None):
1185.31.41 by John Arbash Meinel
Creating a PathNotChild exception, and using relpath in HTTPTestUtil
203
        BzrNewError.__init__(self)
204
        self.path = path
205
        self.base = base
1185.31.44 by John Arbash Meinel
Cleaned up Exceptions for all transports.
206
        if extra:
207
            self.extra = ': ' + str(extra)
208
        else:
209
            self.extra = ''
1185.31.41 by John Arbash Meinel
Creating a PathNotChild exception, and using relpath in HTTPTestUtil
210
211
1185.16.62 by mbp at sourcefrog
- convert NotBranchError to new exception base
212
class NotBranchError(BzrNewError):
213
    """Not a branch: %(path)s"""
1185.16.61 by mbp at sourcefrog
- start introducing hct error classes
214
    def __init__(self, path):
1185.16.62 by mbp at sourcefrog
- convert NotBranchError to new exception base
215
        BzrNewError.__init__(self)
216
        self.path = path
217
573 by Martin Pool
- new exception NotBranchError
218
1534.4.47 by Robert Collins
Split out repository into .bzr/repository
219
class NoRepositoryPresent(BzrNewError):
220
    """Not repository present: %(path)r"""
221
    def __init__(self, bzrdir):
222
        BzrNewError.__init__(self)
223
        self.path = bzrdir.transport.clone('..').base
224
225
1185.35.32 by Aaron Bentley
Fixed handling of files in mixed branches
226
class FileInWrongBranch(BzrNewError):
227
    """File %(path)s in not in branch %(branch_base)s."""
1534.4.44 by Robert Collins
Make a new BzrDir format that uses a versioned branch format in a branch/ subdirectory.
228
1185.35.32 by Aaron Bentley
Fixed handling of files in mixed branches
229
    def __init__(self, branch, path):
230
        BzrNewError.__init__(self)
231
        self.branch = branch
232
        self.branch_base = branch.base
233
        self.path = path
234
235
1185.1.53 by Robert Collins
raise a specific error on unsupported branches so that they can be distinguished from generic errors
236
class UnsupportedFormatError(BzrError):
1534.4.7 by Robert Collins
Move downlevel check up to the Branch.open logic, removing it from the Branch constructor and deprecating relax_version_check to the same.
237
    """Specified path is a bzr branch that we recognize but cannot read."""
1185.1.53 by Robert Collins
raise a specific error on unsupported branches so that they can be distinguished from generic errors
238
    def __str__(self):
239
        return 'unsupported branch format: %s' % self.args[0]
240
241
1534.4.7 by Robert Collins
Move downlevel check up to the Branch.open logic, removing it from the Branch constructor and deprecating relax_version_check to the same.
242
class UnknownFormatError(BzrError):
243
    """Specified path is a bzr branch whose format we do not recognize."""
244
    def __str__(self):
245
        return 'unknown branch format: %s' % self.args[0]
246
247
1534.4.44 by Robert Collins
Make a new BzrDir format that uses a versioned branch format in a branch/ subdirectory.
248
class IncompatibleFormat(BzrNewError):
249
    """Format %(format)s is not compatible with .bzr version %(bzrdir)s."""
250
251
    def __init__(self, format, bzrdir_format):
252
        BzrNewError.__init__(self)
253
        self.format = format
254
        self.bzrdir = bzrdir_format
255
256
1185.16.72 by Martin Pool
[merge] from robert and fix up tests
257
class NotVersionedError(BzrNewError):
258
    """%(path)s is not versioned"""
259
    def __init__(self, path):
260
        BzrNewError.__init__(self)
261
        self.path = path
753 by Martin Pool
- new exception NotVersionedError
262
263
599 by Martin Pool
- better error reporting from smart_add
264
class BadFileKindError(BzrError):
265
    """Specified file is of a kind that cannot be added.
266
267
    (For example a symlink or device file.)"""
268
269
270
class ForbiddenFileError(BzrError):
271
    """Cannot operate on a file because it is a control file."""
272
273
1553.5.11 by Martin Pool
Change some lock and transaction related exceptions to BzrNewException style
274
class LockError(BzrNewError):
275
    """Lock error: %(message)s"""
1185.16.63 by Martin Pool
- more error conversion
276
    # All exceptions from the lock/unlock functions should be from
277
    # this exception class.  They will be translated as necessary. The
278
    # original exception is available as e.original_error
1553.5.11 by Martin Pool
Change some lock and transaction related exceptions to BzrNewException style
279
    #
280
    # New code should prefer to raise specific subclasses
281
    def __init__(self, message):
282
        self.message = message
882 by Martin Pool
- Optionally raise EmptyCommit if there are no changes. Test for this.
283
284
1417.1.6 by Robert Collins
introduce transactions for grouping actions done to and with branches
285
class CommitNotPossible(LockError):
286
    """A commit was attempted but we do not have a write lock open."""
1553.5.11 by Martin Pool
Change some lock and transaction related exceptions to BzrNewException style
287
    def __init__(self):
288
        pass
1417.1.6 by Robert Collins
introduce transactions for grouping actions done to and with branches
289
290
291
class AlreadyCommitted(LockError):
292
    """A rollback was requested, but is not able to be accomplished."""
1553.5.11 by Martin Pool
Change some lock and transaction related exceptions to BzrNewException style
293
    def __init__(self):
294
        pass
1417.1.6 by Robert Collins
introduce transactions for grouping actions done to and with branches
295
296
1417.1.8 by Robert Collins
use transactions in the weave store interface, which enables caching for log
297
class ReadOnlyError(LockError):
1553.5.33 by Martin Pool
LockDir review comment fixes
298
    """A write attempt was made in a read only transaction on %(obj)s"""
299
    def __init__(self, obj):
300
        self.obj = obj
1553.5.11 by Martin Pool
Change some lock and transaction related exceptions to BzrNewException style
301
302
1553.5.36 by Martin Pool
Clean up duplicate BranchNotLocked error and rename to ObjectNotLocked
303
class ObjectNotLocked(LockError):
304
    """%(obj)r is not locked"""
305
    # this can indicate that any particular object is not locked; see also
306
    # LockNotHeld which means that a particular *lock* object is not held by
307
    # the caller -- perhaps they should be unified.
308
    def __init__(self, obj):
309
        self.obj = obj
1553.5.11 by Martin Pool
Change some lock and transaction related exceptions to BzrNewException style
310
311
312
class ReadOnlyObjectDirtiedError(ReadOnlyError):
313
    """Cannot change object %(obj)r in read only transaction"""
314
    def __init__(self, obj):
315
        self.obj = obj
316
317
318
class UnlockableTransport(LockError):
319
    """Cannot lock: transport is read only: %(transport)s"""
320
    def __init__(self, transport):
321
        self.transport = transport
322
323
324
class LockContention(LockError):
325
    """Could not acquire lock %(lock)s"""
326
    # TODO: show full url for lock, combining the transport and relative bits?
327
    def __init__(self, lock):
328
        self.lock = lock
329
330
1553.5.23 by Martin Pool
Start LockDir.confirm method and LockBroken exception
331
class LockBroken(LockError):
1553.5.24 by Martin Pool
Warning to check storage when lock was broken
332
    """Lock was broken while still open: %(lock)s - check storage consistency!"""
1553.5.23 by Martin Pool
Start LockDir.confirm method and LockBroken exception
333
    def __init__(self, lock):
334
        self.lock = lock
335
336
1553.5.27 by Martin Pool
Confirm that only the intended holder of a lock was broken.
337
class LockBreakMismatch(LockError):
338
    """Lock was released and re-acquired before being broken: %(lock)s: held by %(holder)r, wanted to break %(target)r"""
339
    def __init__(self, lock, holder, target):
340
        self.lock = lock
341
        self.holder = holder
342
        self.target = target
343
344
1553.5.11 by Martin Pool
Change some lock and transaction related exceptions to BzrNewException style
345
class LockNotHeld(LockError):
346
    """Lock not held: %(lock)s"""
347
    def __init__(self, lock):
348
        self.lock = lock
349
350
1185.16.63 by Martin Pool
- more error conversion
351
class PointlessCommit(BzrNewError):
1185.16.64 by Martin Pool
- more error conversions
352
    """No changes to commit"""
974.1.26 by aaron.bentley at utoronto
merged mbp@sourcefrog.net-20050817233101-0939da1cf91f2472
353
1551.3.1 by Aaron Bentley
PEP8 fixes
354
1534.4.13 by Robert Collins
Give a reasonable warning on attempts to upgrade a readonly url.
355
class UpgradeReadonly(BzrNewError):
356
    """Upgrade URL cannot work with readonly URL's."""
357
358
1534.5.7 by Robert Collins
Start factoring out the upgrade policy logic.
359
class UpToDateFormat(BzrNewError):
360
    """The branch format %(format)s is already at the most recent format."""
361
362
    def __init__(self, format):
363
        BzrNewError.__init__(self)
364
        self.format = format
365
366
1587.1.6 by Robert Collins
Update bound branch implementation to 0.8.
367
1185.22.1 by Michael Ellerman
Implement strict commits with --strict flag.
368
class StrictCommitFailed(Exception):
369
    """Commit refused because there are unknowns in the tree."""
974.1.26 by aaron.bentley at utoronto
merged mbp@sourcefrog.net-20050817233101-0939da1cf91f2472
370
1505.1.2 by John Arbash Meinel
(broken) working on implementing bound branches.
371
974.1.26 by aaron.bentley at utoronto
merged mbp@sourcefrog.net-20050817233101-0939da1cf91f2472
372
class NoSuchRevision(BzrError):
373
    def __init__(self, branch, revision):
374
        self.branch = branch
375
        self.revision = revision
376
        msg = "Branch %s has no revision %s" % (branch, revision)
377
        BzrError.__init__(self, msg)
378
1034 by Martin Pool
- merge bzrlib.revision.is_ancestor from aaron
379
1192 by Martin Pool
- clean up code for retrieving stored inventories
380
class HistoryMissing(BzrError):
381
    def __init__(self, branch, object_type, object_id):
382
        self.branch = branch
383
        BzrError.__init__(self,
384
                          '%s is missing %s {%s}'
385
                          % (branch, object_type, object_id))
386
387
1185.2.1 by Lalo Martins
moving DivergedBranches from bzrlib.branch to bzrlib.errors, obeying:
388
class DivergedBranches(BzrError):
389
    def __init__(self, branch1, branch2):
1185.56.1 by Michael Ellerman
Simplify handling of DivergedBranches in cmd_pull()
390
        BzrError.__init__(self, "These branches have diverged.  Try merge.")
1185.2.1 by Lalo Martins
moving DivergedBranches from bzrlib.branch to bzrlib.errors, obeying:
391
        self.branch1 = branch1
392
        self.branch2 = branch2
393
1390 by Robert Collins
pair programming worx... merge integration and weave
394
1105 by Martin Pool
- expose 'find-merge-base' as a new expert command,
395
class UnrelatedBranches(BzrCommandError):
396
    def __init__(self):
397
        msg = "Branches have no common ancestor, and no base revision"\
398
            " specified."
399
        BzrCommandError.__init__(self, msg)
400
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
401
974.1.80 by Aaron Bentley
Improved merge error handling and testing
402
class NoCommonAncestor(BzrError):
403
    def __init__(self, revision_a, revision_b):
404
        msg = "Revisions have no common ancestor: %s %s." \
405
            % (revision_a, revision_b) 
406
        BzrError.__init__(self, msg)
407
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
408
974.1.80 by Aaron Bentley
Improved merge error handling and testing
409
class NoCommonRoot(BzrError):
410
    def __init__(self, revision_a, revision_b):
411
        msg = "Revisions are not derived from the same root: %s %s." \
412
            % (revision_a, revision_b) 
413
        BzrError.__init__(self, msg)
1105 by Martin Pool
- expose 'find-merge-base' as a new expert command,
414
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
415
1587.1.6 by Robert Collins
Update bound branch implementation to 0.8.
416
974.2.7 by aaron.bentley at utoronto
Merged from bzr.24
417
class NotAncestor(BzrError):
418
    def __init__(self, rev_id, not_ancestor_id):
1185.1.14 by Robert Collins
remove more duplicate merged hunks. Bad MERGE3, BAD.
419
        msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id, 
420
                                                        rev_id)
421
        BzrError.__init__(self, msg)
422
        self.rev_id = rev_id
423
        self.not_ancestor_id = not_ancestor_id
1185.1.12 by Robert Collins
merge in lsdiff/filterdiff friendliness
424
425
974.1.30 by aaron.bentley at utoronto
Changed copy_multi to permit failure and return a tuple, tested missing required revisions
426
class InstallFailed(BzrError):
427
    def __init__(self, revisions):
1185.1.14 by Robert Collins
remove more duplicate merged hunks. Bad MERGE3, BAD.
428
        msg = "Could not install revisions:\n%s" % " ,".join(revisions)
429
        BzrError.__init__(self, msg)
974.1.30 by aaron.bentley at utoronto
Changed copy_multi to permit failure and return a tuple, tested missing required revisions
430
        self.revisions = revisions
1154 by Martin Pool
- fix imports for moved errors
431
432
433
class AmbiguousBase(BzrError):
434
    def __init__(self, bases):
435
        msg = "The correct base is unclear, becase %s are all equally close" %\
436
            ", ".join(bases)
437
        BzrError.__init__(self, msg)
438
        self.bases = bases
439
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
440
974.1.80 by Aaron Bentley
Improved merge error handling and testing
441
class NoCommits(BzrError):
442
    def __init__(self, branch):
443
        msg = "Branch %s has no commits." % branch
444
        BzrError.__init__(self, msg)
1185.10.1 by Aaron Bentley
Added --basis option to bzr branch
445
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
446
1185.10.1 by Aaron Bentley
Added --basis option to bzr branch
447
class UnlistableStore(BzrError):
448
    def __init__(self, store):
449
        BzrError.__init__(self, "Store %s is not listable" % store)
450
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
451
1587.1.6 by Robert Collins
Update bound branch implementation to 0.8.
452
1185.10.1 by Aaron Bentley
Added --basis option to bzr branch
453
class UnlistableBranch(BzrError):
454
    def __init__(self, br):
455
        BzrError.__init__(self, "Stores for branch %s are not listable" % br)
1392 by Robert Collins
reinstate testfetch test case
456
457
1505.1.24 by John Arbash Meinel
Updated commit to handle bound branches. Included test to handle commit after merge
458
class BoundBranchOutOfDate(BzrNewError):
459
    """Bound branch %(branch)s is out of date with master branch %(master)s."""
460
    def __init__(self, branch, master):
461
        BzrNewError.__init__(self)
462
        self.branch = branch
463
        self.master = master
464
465
        
466
class CommitToDoubleBoundBranch(BzrNewError):
467
    """Cannot commit to branch %(branch)s. It is bound to %(master)s, which is bound to %(remote)s."""
468
    def __init__(self, branch, master, remote):
469
        BzrNewError.__init__(self)
470
        self.branch = branch
471
        self.master = master
472
        self.remote = remote
473
1505.1.25 by John Arbash Meinel
Updated pull. Now all paths which call set_revision_history maintain the branch invariant. All tests pass.
474
475
class OverwriteBoundBranch(BzrNewError):
476
    """Cannot pull --overwrite to a branch which is bound %(branch)s"""
477
    def __init__(self, branch):
478
        BzrNewError.__init__(self)
479
        self.branch = branch
480
1505.1.29 by John Arbash Meinel
Added special exceptions when unable to contact parent branch. Added tests for failure. bind() no longer updates the remote working tree
481
482
class BoundBranchConnectionFailure(BzrNewError):
483
    """Unable to connect to target of bound branch %(branch)s => %(target)s: %(error)s"""
484
    def __init__(self, branch, target, error):
485
        BzrNewError.__init__(self)
486
        self.branch = branch
487
        self.target = target
488
        self.error = error
489
490
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
491
class WeaveError(BzrNewError):
492
    """Error in processing weave: %(message)s"""
1563.2.10 by Robert Collins
Change weave store to be a versioned store, using WeaveFiles which maintain integrity without needing explicit 'put' operations.
493
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
494
    def __init__(self, message=None):
495
        BzrNewError.__init__(self)
496
        self.message = message
497
498
499
class WeaveRevisionAlreadyPresent(WeaveError):
500
    """Revision {%(revision_id)s} already present in %(weave)s"""
501
    def __init__(self, revision_id, weave):
1563.2.10 by Robert Collins
Change weave store to be a versioned store, using WeaveFiles which maintain integrity without needing explicit 'put' operations.
502
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
503
        WeaveError.__init__(self)
504
        self.revision_id = revision_id
505
        self.weave = weave
506
507
508
class WeaveRevisionNotPresent(WeaveError):
509
    """Revision {%(revision_id)s} not present in %(weave)s"""
1563.2.10 by Robert Collins
Change weave store to be a versioned store, using WeaveFiles which maintain integrity without needing explicit 'put' operations.
510
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
511
    def __init__(self, revision_id, weave):
512
        WeaveError.__init__(self)
513
        self.revision_id = revision_id
514
        self.weave = weave
515
516
517
class WeaveFormatError(WeaveError):
518
    """Weave invariant violated: %(what)s"""
1563.2.10 by Robert Collins
Change weave store to be a versioned store, using WeaveFiles which maintain integrity without needing explicit 'put' operations.
519
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
520
    def __init__(self, what):
521
        WeaveError.__init__(self)
522
        self.what = what
523
524
525
class WeaveParentMismatch(WeaveError):
526
    """Parents are mismatched between two revisions."""
527
    
1393.2.1 by John Arbash Meinel
Merged in split-storage-2 branch. Need to cleanup a little bit more still.
528
1185.50.23 by John Arbash Meinel
Adding sha1 check when weave extracts a text.
529
class WeaveInvalidChecksum(WeaveError):
530
    """Text did not match it's checksum: %(message)s"""
531
532
1551.3.11 by Aaron Bentley
Merge from Robert
533
class WeaveTextDiffers(WeaveError):
534
    """Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
535
536
    def __init__(self, revision_id, weave_a, weave_b):
537
        WeaveError.__init__(self)
538
        self.revision_id = revision_id
539
        self.weave_a = weave_a
540
        self.weave_b = weave_b
541
542
1534.7.158 by Aaron Bentley
Merged John Meinel's integration
543
class WeaveTextDiffers(WeaveError):
544
    """Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
545
546
    def __init__(self, revision_id, weave_a, weave_b):
547
        WeaveError.__init__(self)
548
        self.revision_id = revision_id
549
        self.weave_a = weave_a
550
        self.weave_b = weave_b
551
552
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
553
class VersionedFileError(BzrNewError):
554
    """Versioned file error."""
555
556
557
class RevisionNotPresent(VersionedFileError):
558
    """Revision {%(revision_id)s} not present in %(file_id)s."""
559
560
    def __init__(self, revision_id, file_id):
561
        VersionedFileError.__init__(self)
562
        self.revision_id = revision_id
563
        self.file_id = file_id
564
565
566
class RevisionAlreadyPresent(VersionedFileError):
567
    """Revision {%(revision_id)s} already present in %(file_id)s."""
568
569
    def __init__(self, revision_id, file_id):
570
        VersionedFileError.__init__(self)
571
        self.revision_id = revision_id
572
        self.file_id = file_id
573
574
575
class KnitError(BzrNewError):
576
    """Knit error"""
577
578
579
class KnitHeaderError(KnitError):
580
    """Knit header error: %(badline)r unexpected"""
581
582
    def __init__(self, badline):
583
        KnitError.__init__(self)
584
        self.badline = badline
585
586
587
class KnitCorrupt(KnitError):
588
    """Knit %(filename)s corrupt: %(how)s"""
589
590
    def __init__(self, filename, how):
591
        KnitError.__init__(self)
592
        self.filename = filename
593
        self.how = how
594
595
1185.31.12 by John Arbash Meinel
Refactored the export code to make it easier to add new export formats.
596
class NoSuchExportFormat(BzrNewError):
597
    """Export format %(format)r not supported"""
598
    def __init__(self, format):
599
        BzrNewError.__init__(self)
600
        self.format = format
601
602
1185.11.9 by John Arbash Meinel
Most tests pass, some problems with unavailable socket recv
603
class TransportError(BzrError):
604
    """All errors thrown by Transport implementations should derive
605
    from this class.
606
    """
607
    def __init__(self, msg=None, orig_error=None):
608
        if msg is None and orig_error is not None:
609
            msg = str(orig_error)
610
        BzrError.__init__(self, msg)
611
        self.msg = msg
612
        self.orig_error = orig_error
613
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
614
1185.11.9 by John Arbash Meinel
Most tests pass, some problems with unavailable socket recv
615
# A set of semi-meaningful errors which can be thrown
616
class TransportNotPossible(TransportError):
617
    """This is for transports where a specific function is explicitly not
618
    possible. Such as pushing files to an HTTP server.
619
    """
620
    pass
621
1185.31.44 by John Arbash Meinel
Cleaned up Exceptions for all transports.
622
623
class ConnectionError(TransportError):
624
    """A connection problem prevents file retrieval.
1185.35.31 by Aaron Bentley
Throw ConnectionError instead of NoSuchFile except when we get a 404
625
    This does not indicate whether the file exists or not; it indicates that a
626
    precondition for requesting the file was not met.
627
    """
1185.31.44 by John Arbash Meinel
Cleaned up Exceptions for all transports.
628
    def __init__(self, msg=None, orig_error=None):
629
        TransportError.__init__(self, msg=msg, orig_error=orig_error)
630
1185.11.9 by John Arbash Meinel
Most tests pass, some problems with unavailable socket recv
631
632
class ConnectionReset(TransportError):
633
    """The connection has been closed."""
634
    pass
635
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
636
1185.14.10 by Aaron Bentley
Commit aborts with conflicts in the tree.
637
class ConflictsInTree(BzrError):
638
    def __init__(self):
639
        BzrError.__init__(self, "Working tree has conflicts.")
1185.12.49 by Aaron Bentley
Switched to ConfigObj
640
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
641
1185.12.49 by Aaron Bentley
Switched to ConfigObj
642
class ParseConfigError(BzrError):
643
    def __init__(self, errors, filename):
644
        if filename is None:
645
            filename = ""
646
        message = "Error(s) parsing config file %s:\n%s" % \
647
            (filename, ('\n'.join(e.message for e in errors)))
648
        BzrError.__init__(self, message)
1185.12.52 by Aaron Bentley
Merged more config stuff from Robert
649
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
650
1442.1.58 by Robert Collins
gpg signing of content
651
class SigningFailed(BzrError):
652
    def __init__(self, command_line):
653
        BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
654
                               % command_line)
1185.12.83 by Aaron Bentley
Preliminary weave merge support
655
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
656
1185.12.83 by Aaron Bentley
Preliminary weave merge support
657
class WorkingTreeNotRevision(BzrError):
658
    def __init__(self, tree):
659
        BzrError.__init__(self, "The working tree for %s has changed since"
660
                          " last commit, but weave merge requires that it be"
661
                          " unchanged." % tree.basedir)
1185.12.104 by Aaron Bentley
Merged Martin's latest
662
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
663
1185.24.1 by Aaron Bentley
Got reprocessing working
664
class CantReprocessAndShowBase(BzrNewError):
665
    """Can't reprocess and show base.
666
Reprocessing obscures relationship of conflicting lines to base."""
1185.24.2 by Aaron Bentley
Merge from mainline
667
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
668
1185.16.114 by mbp at sourcefrog
Improved topological sort
669
class GraphCycleError(BzrNewError):
670
    """Cycle in graph %(graph)r"""
671
    def __init__(self, graph):
672
        BzrNewError.__init__(self)
673
        self.graph = graph
1185.35.1 by Aaron Bentley
Implemented conflicts.restore
674
1505.1.23 by John Arbash Meinel
Whitespace cleanup of bzrlib.errors
675
1185.35.1 by Aaron Bentley
Implemented conflicts.restore
676
class NotConflicted(BzrNewError):
1185.35.4 by Aaron Bentley
Implemented remerge
677
    """File %(filename)s is not conflicted."""
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
678
1185.35.1 by Aaron Bentley
Implemented conflicts.restore
679
    def __init__(self, filename):
680
        BzrNewError.__init__(self)
681
        self.filename = filename
1185.35.13 by Aaron Bentley
Merged Martin
682
1505.1.23 by John Arbash Meinel
Whitespace cleanup of bzrlib.errors
683
1492 by Robert Collins
Support decoration of commands.
684
class MustUseDecorated(Exception):
685
    """A decorating function has requested its original command be used.
686
    
687
    This should never escape bzr, so does not need to be printable.
688
    """
689
1505.1.23 by John Arbash Meinel
Whitespace cleanup of bzrlib.errors
690
1185.35.42 by Aaron Bentley
Fixed fetch to be safer wrt ghosts and corrupt branches
691
class MissingText(BzrNewError):
692
    """Branch %(base)s is missing revision %(text_revision)s of %(file_id)s"""
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
693
1185.35.42 by Aaron Bentley
Fixed fetch to be safer wrt ghosts and corrupt branches
694
    def __init__(self, branch, text_revision, file_id):
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
695
        BzrNewError.__init__(self)
1185.35.42 by Aaron Bentley
Fixed fetch to be safer wrt ghosts and corrupt branches
696
        self.branch = branch
697
        self.base = branch.base
698
        self.text_revision = text_revision
699
        self.file_id = file_id
1534.7.5 by Aaron Bentley
Got unique_add under test
700
1505.1.23 by John Arbash Meinel
Whitespace cleanup of bzrlib.errors
701
1534.7.5 by Aaron Bentley
Got unique_add under test
702
class DuplicateKey(BzrNewError):
703
    """Key %(key)s is already present in map"""
1534.7.6 by Aaron Bentley
Added conflict handling
704
1587.1.6 by Robert Collins
Update bound branch implementation to 0.8.
705
1534.7.6 by Aaron Bentley
Added conflict handling
706
class MalformedTransform(BzrNewError):
1534.7.49 by Aaron Bentley
Printed conflicts in MalformedTransform
707
    """Tree transform is malformed %(conflicts)r"""
1534.7.24 by Aaron Bentley
Merge from the mainline
708
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
709
710
class BzrBadParameter(BzrNewError):
1185.65.29 by Robert Collins
Implement final review suggestions.
711
    """A bad parameter : %(param)s is not usable.
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
712
    
1185.65.29 by Robert Collins
Implement final review suggestions.
713
    This exception should never be thrown, but it is a base class for all
714
    parameter-to-function errors.
715
    """
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
716
    def __init__(self, param):
717
        BzrNewError.__init__(self)
718
        self.param = param
1534.7.32 by Aaron Bentley
Got conflict handling working when conflicts involve existing files
719
1534.4.3 by Robert Collins
Implement BranchTestProviderAdapter, so tests now run across all branch formats.
720
1185.65.29 by Robert Collins
Implement final review suggestions.
721
class BzrBadParameterNotUnicode(BzrBadParameter):
722
    """Parameter %(param)s is neither unicode nor utf8."""
1534.7.120 by Aaron Bentley
PEP8 fixes
723
724
1534.7.32 by Aaron Bentley
Got conflict handling working when conflicts involve existing files
725
class ReusingTransform(BzrNewError):
726
    """Attempt to reuse a transform that has already been applied."""
1534.7.66 by Aaron Bentley
Ensured we don't accidentally move the root directory
727
1534.7.120 by Aaron Bentley
PEP8 fixes
728
1534.7.66 by Aaron Bentley
Ensured we don't accidentally move the root directory
729
class CantMoveRoot(BzrNewError):
730
    """Moving the root directory is not supported at this time"""
1185.65.29 by Robert Collins
Implement final review suggestions.
731
1534.7.120 by Aaron Bentley
PEP8 fixes
732
1185.65.29 by Robert Collins
Implement final review suggestions.
733
class BzrBadParameterNotString(BzrBadParameter):
734
    """Parameter %(param)s is not a string or unicode string."""
1185.62.24 by John Arbash Meinel
Changing the exception that sftp.py throws when it can't find paramiko, so that the test suite can handle it.
735
736
1534.4.44 by Robert Collins
Make a new BzrDir format that uses a versioned branch format in a branch/ subdirectory.
737
class BzrBadParameterMissing(BzrBadParameter):
738
    """Parameter $(param)s is required but not present."""
739
740
1185.62.24 by John Arbash Meinel
Changing the exception that sftp.py throws when it can't find paramiko, so that the test suite can handle it.
741
class DependencyNotPresent(BzrNewError):
742
    """Unable to import library: %(library)s, %(error)s"""
743
744
    def __init__(self, library, error):
745
        BzrNewError.__init__(self, library=library, error=error)
746
747
748
class ParamikoNotPresent(DependencyNotPresent):
749
    """Unable to import paramiko (required for sftp support): %(error)s"""
750
751
    def __init__(self, error):
752
        DependencyNotPresent.__init__(self, 'paramiko', error)
753
754
1534.4.3 by Robert Collins
Implement BranchTestProviderAdapter, so tests now run across all branch formats.
755
class UninitializableFormat(BzrNewError):
756
    """Format %(format)s cannot be initialised by this version of bzr."""
757
758
    def __init__(self, format):
759
        BzrNewError.__init__(self)
760
        self.format = format
1551.3.4 by Aaron Bentley
Implemented default command options
761
1534.7.156 by Aaron Bentley
PEP8 fixes
762
1534.7.130 by Aaron Bentley
More conflict handling, test porting
763
class NoDiff3(BzrNewError):
764
    """Diff3 is not installed on this machine."""
1534.7.162 by Aaron Bentley
Handle failures creating/deleting the Limbo directory
765
766
767
class ExistingLimbo(BzrNewError):
768
    """This tree contains left-over files from a failed operation.
769
    Please examine %(limbo_dir)s to see if it contains any files you wish to
770
    keep, and delete it when you are done.
771
    """
772
    def __init__(self, limbo_dir):
773
       BzrNewError.__init__(self)
774
       self.limbo_dir = limbo_dir
775
776
777
class ImmortalLimbo(BzrNewError):
778
    """Unable to delete transform temporary directory $(limbo_dir)s.
779
    Please examine %(limbo_dir)s to see if it contains any files you wish to
780
    keep, and delete it when you are done.
781
    """
782
    def __init__(self, limbo_dir):
783
       BzrNewError.__init__(self)
784
       self.limbo_dir = limbo_dir
1534.7.163 by Aaron Bentley
Merge from Robert [Fails tests]
785
786
1508.1.22 by Robert Collins
implement out of date working tree checks in commit.
787
class OutOfDateTree(BzrNewError):
788
    """Working tree is out of date, please run 'bzr update'."""
1508.1.25 by Robert Collins
Update per review comments.
789
790
    def __init__(self, tree):
791
        BzrNewError.__init__(self)
792
        self.tree = tree
1570.1.13 by Robert Collins
Check for incorrect revision parentage in the weave during revision access.
793
1563.2.22 by Robert Collins
Move responsibility for repository.has_revision into RevisionStore
794
1570.1.13 by Robert Collins
Check for incorrect revision parentage in the weave during revision access.
795
class CorruptRepository(BzrNewError):
796
    """An error has been detected in the repository %(repo_path)s.
797
Please run bzr reconcile on this repository."""
798
799
    def __init__(self, repo):
800
        BzrNewError.__init__(self)
801
        self.repo_path = repo.bzrdir.root_transport.base
1587.1.6 by Robert Collins
Update bound branch implementation to 0.8.
802
803
804
class UpgradeRequired(BzrNewError):
805
    """To use this feature you must upgrade your branch at %(path)s."""
806
807
    def __init__(self, path):
808
        BzrNewError.__init__(self)
809
        self.path = path
810
1587.1.8 by Robert Collins
Local commits on unbound branches fail.
811
812
class LocalRequiresBoundBranch(BzrNewError):
813
    """Cannot perform local-only commits on unbound branches."""
1594.1.1 by Robert Collins
Introduce new bzr progress bar api. ui_factory.nested_progress_bar.
814
815
816
class MissingProgressBarFinish(BzrNewError):
817
    """A nested progress bar was not 'finished' correctly."""