~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
303
class BranchNotLocked(LockError):
304
    """Branch %(branch)r is not locked"""
305
    def __init__(self, branch):
306
        # XXX: sometimes called with a LockableFiles instance not a Branch
307
        self.branch = branch
308
309
310
class ReadOnlyObjectDirtiedError(ReadOnlyError):
311
    """Cannot change object %(obj)r in read only transaction"""
312
    def __init__(self, obj):
313
        self.obj = obj
314
315
316
class UnlockableTransport(LockError):
317
    """Cannot lock: transport is read only: %(transport)s"""
318
    def __init__(self, transport):
319
        self.transport = transport
320
321
322
class LockContention(LockError):
323
    """Could not acquire lock %(lock)s"""
324
    # TODO: show full url for lock, combining the transport and relative bits?
325
    def __init__(self, lock):
326
        self.lock = lock
327
328
1553.5.23 by Martin Pool
Start LockDir.confirm method and LockBroken exception
329
class LockBroken(LockError):
1553.5.24 by Martin Pool
Warning to check storage when lock was broken
330
    """Lock was broken while still open: %(lock)s - check storage consistency!"""
1553.5.23 by Martin Pool
Start LockDir.confirm method and LockBroken exception
331
    def __init__(self, lock):
332
        self.lock = lock
333
334
1553.5.27 by Martin Pool
Confirm that only the intended holder of a lock was broken.
335
class LockBreakMismatch(LockError):
336
    """Lock was released and re-acquired before being broken: %(lock)s: held by %(holder)r, wanted to break %(target)r"""
337
    def __init__(self, lock, holder, target):
338
        self.lock = lock
339
        self.holder = holder
340
        self.target = target
341
342
1553.5.11 by Martin Pool
Change some lock and transaction related exceptions to BzrNewException style
343
class LockNotHeld(LockError):
344
    """Lock not held: %(lock)s"""
345
    def __init__(self, lock):
346
        self.lock = lock
347
348
349
class BranchNotLocked(LockError):
350
    """Branch %(branch)r not locked"""
351
    def __init__(self, branch):
352
        self.branch = branch
1417.1.8 by Robert Collins
use transactions in the weave store interface, which enables caching for log
353
354
1185.16.63 by Martin Pool
- more error conversion
355
class PointlessCommit(BzrNewError):
1185.16.64 by Martin Pool
- more error conversions
356
    """No changes to commit"""
974.1.26 by aaron.bentley at utoronto
merged mbp@sourcefrog.net-20050817233101-0939da1cf91f2472
357
1551.3.1 by Aaron Bentley
PEP8 fixes
358
1534.4.13 by Robert Collins
Give a reasonable warning on attempts to upgrade a readonly url.
359
class UpgradeReadonly(BzrNewError):
360
    """Upgrade URL cannot work with readonly URL's."""
361
362
1534.5.7 by Robert Collins
Start factoring out the upgrade policy logic.
363
class UpToDateFormat(BzrNewError):
364
    """The branch format %(format)s is already at the most recent format."""
365
366
    def __init__(self, format):
367
        BzrNewError.__init__(self)
368
        self.format = format
369
370
1185.22.1 by Michael Ellerman
Implement strict commits with --strict flag.
371
class StrictCommitFailed(Exception):
372
    """Commit refused because there are unknowns in the tree."""
974.1.26 by aaron.bentley at utoronto
merged mbp@sourcefrog.net-20050817233101-0939da1cf91f2472
373
374
class NoSuchRevision(BzrError):
375
    def __init__(self, branch, revision):
376
        self.branch = branch
377
        self.revision = revision
378
        msg = "Branch %s has no revision %s" % (branch, revision)
379
        BzrError.__init__(self, msg)
380
1034 by Martin Pool
- merge bzrlib.revision.is_ancestor from aaron
381
1192 by Martin Pool
- clean up code for retrieving stored inventories
382
class HistoryMissing(BzrError):
383
    def __init__(self, branch, object_type, object_id):
384
        self.branch = branch
385
        BzrError.__init__(self,
386
                          '%s is missing %s {%s}'
387
                          % (branch, object_type, object_id))
388
389
1185.2.1 by Lalo Martins
moving DivergedBranches from bzrlib.branch to bzrlib.errors, obeying:
390
class DivergedBranches(BzrError):
391
    def __init__(self, branch1, branch2):
1185.56.1 by Michael Ellerman
Simplify handling of DivergedBranches in cmd_pull()
392
        BzrError.__init__(self, "These branches have diverged.  Try merge.")
1185.2.1 by Lalo Martins
moving DivergedBranches from bzrlib.branch to bzrlib.errors, obeying:
393
        self.branch1 = branch1
394
        self.branch2 = branch2
395
1390 by Robert Collins
pair programming worx... merge integration and weave
396
1105 by Martin Pool
- expose 'find-merge-base' as a new expert command,
397
class UnrelatedBranches(BzrCommandError):
398
    def __init__(self):
399
        msg = "Branches have no common ancestor, and no base revision"\
400
            " specified."
401
        BzrCommandError.__init__(self, msg)
402
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
403
974.1.80 by Aaron Bentley
Improved merge error handling and testing
404
class NoCommonAncestor(BzrError):
405
    def __init__(self, revision_a, revision_b):
406
        msg = "Revisions have no common ancestor: %s %s." \
407
            % (revision_a, revision_b) 
408
        BzrError.__init__(self, msg)
409
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
410
974.1.80 by Aaron Bentley
Improved merge error handling and testing
411
class NoCommonRoot(BzrError):
412
    def __init__(self, revision_a, revision_b):
413
        msg = "Revisions are not derived from the same root: %s %s." \
414
            % (revision_a, revision_b) 
415
        BzrError.__init__(self, msg)
1105 by Martin Pool
- expose 'find-merge-base' as a new expert command,
416
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
417
974.2.7 by aaron.bentley at utoronto
Merged from bzr.24
418
class NotAncestor(BzrError):
419
    def __init__(self, rev_id, not_ancestor_id):
1185.1.14 by Robert Collins
remove more duplicate merged hunks. Bad MERGE3, BAD.
420
        msg = "Revision %s is not an ancestor of %s" % (not_ancestor_id, 
421
                                                        rev_id)
422
        BzrError.__init__(self, msg)
423
        self.rev_id = rev_id
424
        self.not_ancestor_id = not_ancestor_id
1185.1.12 by Robert Collins
merge in lsdiff/filterdiff friendliness
425
426
974.1.30 by aaron.bentley at utoronto
Changed copy_multi to permit failure and return a tuple, tested missing required revisions
427
class InstallFailed(BzrError):
428
    def __init__(self, revisions):
1185.1.14 by Robert Collins
remove more duplicate merged hunks. Bad MERGE3, BAD.
429
        msg = "Could not install revisions:\n%s" % " ,".join(revisions)
430
        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
431
        self.revisions = revisions
1154 by Martin Pool
- fix imports for moved errors
432
433
434
class AmbiguousBase(BzrError):
435
    def __init__(self, bases):
436
        msg = "The correct base is unclear, becase %s are all equally close" %\
437
            ", ".join(bases)
438
        BzrError.__init__(self, msg)
439
        self.bases = bases
440
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
441
974.1.80 by Aaron Bentley
Improved merge error handling and testing
442
class NoCommits(BzrError):
443
    def __init__(self, branch):
444
        msg = "Branch %s has no commits." % branch
445
        BzrError.__init__(self, msg)
1185.10.1 by Aaron Bentley
Added --basis option to bzr branch
446
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
447
1185.10.1 by Aaron Bentley
Added --basis option to bzr branch
448
class UnlistableStore(BzrError):
449
    def __init__(self, store):
450
        BzrError.__init__(self, "Store %s is not listable" % store)
451
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
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
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
458
class WeaveError(BzrNewError):
459
    """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.
460
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
461
    def __init__(self, message=None):
462
        BzrNewError.__init__(self)
463
        self.message = message
464
465
466
class WeaveRevisionAlreadyPresent(WeaveError):
467
    """Revision {%(revision_id)s} already present in %(weave)s"""
468
    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.
469
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
470
        WeaveError.__init__(self)
471
        self.revision_id = revision_id
472
        self.weave = weave
473
474
475
class WeaveRevisionNotPresent(WeaveError):
476
    """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.
477
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
478
    def __init__(self, revision_id, weave):
479
        WeaveError.__init__(self)
480
        self.revision_id = revision_id
481
        self.weave = weave
482
483
484
class WeaveFormatError(WeaveError):
485
    """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.
486
1185.16.116 by mbp at sourcefrog
Move weave errors into bzrlib.errors and make consistent with new system.
487
    def __init__(self, what):
488
        WeaveError.__init__(self)
489
        self.what = what
490
491
492
class WeaveParentMismatch(WeaveError):
493
    """Parents are mismatched between two revisions."""
494
    
1393.2.1 by John Arbash Meinel
Merged in split-storage-2 branch. Need to cleanup a little bit more still.
495
1185.50.23 by John Arbash Meinel
Adding sha1 check when weave extracts a text.
496
class WeaveInvalidChecksum(WeaveError):
497
    """Text did not match it's checksum: %(message)s"""
498
499
1551.3.11 by Aaron Bentley
Merge from Robert
500
class WeaveTextDiffers(WeaveError):
501
    """Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
502
503
    def __init__(self, revision_id, weave_a, weave_b):
504
        WeaveError.__init__(self)
505
        self.revision_id = revision_id
506
        self.weave_a = weave_a
507
        self.weave_b = weave_b
508
509
1534.7.158 by Aaron Bentley
Merged John Meinel's integration
510
class WeaveTextDiffers(WeaveError):
511
    """Weaves differ on text content. Revision: {%(revision_id)s}, %(weave_a)s, %(weave_b)s"""
512
513
    def __init__(self, revision_id, weave_a, weave_b):
514
        WeaveError.__init__(self)
515
        self.revision_id = revision_id
516
        self.weave_a = weave_a
517
        self.weave_b = weave_b
518
519
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
520
class VersionedFileError(BzrNewError):
521
    """Versioned file error."""
522
523
524
class RevisionNotPresent(VersionedFileError):
525
    """Revision {%(revision_id)s} not present in %(file_id)s."""
526
527
    def __init__(self, revision_id, file_id):
528
        VersionedFileError.__init__(self)
529
        self.revision_id = revision_id
530
        self.file_id = file_id
531
532
533
class RevisionAlreadyPresent(VersionedFileError):
534
    """Revision {%(revision_id)s} already present in %(file_id)s."""
535
536
    def __init__(self, revision_id, file_id):
537
        VersionedFileError.__init__(self)
538
        self.revision_id = revision_id
539
        self.file_id = file_id
540
541
542
class KnitError(BzrNewError):
543
    """Knit error"""
544
545
546
class KnitHeaderError(KnitError):
547
    """Knit header error: %(badline)r unexpected"""
548
549
    def __init__(self, badline):
550
        KnitError.__init__(self)
551
        self.badline = badline
552
553
554
class KnitCorrupt(KnitError):
555
    """Knit %(filename)s corrupt: %(how)s"""
556
557
    def __init__(self, filename, how):
558
        KnitError.__init__(self)
559
        self.filename = filename
560
        self.how = how
561
562
1185.31.12 by John Arbash Meinel
Refactored the export code to make it easier to add new export formats.
563
class NoSuchExportFormat(BzrNewError):
564
    """Export format %(format)r not supported"""
565
    def __init__(self, format):
566
        BzrNewError.__init__(self)
567
        self.format = format
568
569
1185.11.9 by John Arbash Meinel
Most tests pass, some problems with unavailable socket recv
570
class TransportError(BzrError):
571
    """All errors thrown by Transport implementations should derive
572
    from this class.
573
    """
574
    def __init__(self, msg=None, orig_error=None):
575
        if msg is None and orig_error is not None:
576
            msg = str(orig_error)
577
        BzrError.__init__(self, msg)
578
        self.msg = msg
579
        self.orig_error = orig_error
580
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
581
1185.11.9 by John Arbash Meinel
Most tests pass, some problems with unavailable socket recv
582
# A set of semi-meaningful errors which can be thrown
583
class TransportNotPossible(TransportError):
584
    """This is for transports where a specific function is explicitly not
585
    possible. Such as pushing files to an HTTP server.
586
    """
587
    pass
588
1185.31.44 by John Arbash Meinel
Cleaned up Exceptions for all transports.
589
590
class ConnectionError(TransportError):
591
    """A connection problem prevents file retrieval.
1185.35.31 by Aaron Bentley
Throw ConnectionError instead of NoSuchFile except when we get a 404
592
    This does not indicate whether the file exists or not; it indicates that a
593
    precondition for requesting the file was not met.
594
    """
1185.31.44 by John Arbash Meinel
Cleaned up Exceptions for all transports.
595
    def __init__(self, msg=None, orig_error=None):
596
        TransportError.__init__(self, msg=msg, orig_error=orig_error)
597
1185.11.9 by John Arbash Meinel
Most tests pass, some problems with unavailable socket recv
598
599
class ConnectionReset(TransportError):
600
    """The connection has been closed."""
601
    pass
602
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
603
1185.14.10 by Aaron Bentley
Commit aborts with conflicts in the tree.
604
class ConflictsInTree(BzrError):
605
    def __init__(self):
606
        BzrError.__init__(self, "Working tree has conflicts.")
1185.12.49 by Aaron Bentley
Switched to ConfigObj
607
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
608
1185.12.49 by Aaron Bentley
Switched to ConfigObj
609
class ParseConfigError(BzrError):
610
    def __init__(self, errors, filename):
611
        if filename is None:
612
            filename = ""
613
        message = "Error(s) parsing config file %s:\n%s" % \
614
            (filename, ('\n'.join(e.message for e in errors)))
615
        BzrError.__init__(self, message)
1185.12.52 by Aaron Bentley
Merged more config stuff from Robert
616
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
617
1442.1.58 by Robert Collins
gpg signing of content
618
class SigningFailed(BzrError):
619
    def __init__(self, command_line):
620
        BzrError.__init__(self, "Failed to gpg sign data with command '%s'"
621
                               % command_line)
1185.12.83 by Aaron Bentley
Preliminary weave merge support
622
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
623
1185.12.83 by Aaron Bentley
Preliminary weave merge support
624
class WorkingTreeNotRevision(BzrError):
625
    def __init__(self, tree):
626
        BzrError.__init__(self, "The working tree for %s has changed since"
627
                          " last commit, but weave merge requires that it be"
628
                          " unchanged." % tree.basedir)
1185.12.104 by Aaron Bentley
Merged Martin's latest
629
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
630
1185.24.1 by Aaron Bentley
Got reprocessing working
631
class CantReprocessAndShowBase(BzrNewError):
632
    """Can't reprocess and show base.
633
Reprocessing obscures relationship of conflicting lines to base."""
1185.24.2 by Aaron Bentley
Merge from mainline
634
1551.2.1 by Aaron Bentley
recommit 1527 PEP8 fixes
635
1185.16.114 by mbp at sourcefrog
Improved topological sort
636
class GraphCycleError(BzrNewError):
637
    """Cycle in graph %(graph)r"""
638
    def __init__(self, graph):
639
        BzrNewError.__init__(self)
640
        self.graph = graph
1185.35.1 by Aaron Bentley
Implemented conflicts.restore
641
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
642
1185.35.1 by Aaron Bentley
Implemented conflicts.restore
643
class NotConflicted(BzrNewError):
1185.35.4 by Aaron Bentley
Implemented remerge
644
    """File %(filename)s is not conflicted."""
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
645
1185.35.1 by Aaron Bentley
Implemented conflicts.restore
646
    def __init__(self, filename):
647
        BzrNewError.__init__(self)
648
        self.filename = filename
1185.35.13 by Aaron Bentley
Merged Martin
649
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
650
1492 by Robert Collins
Support decoration of commands.
651
class MustUseDecorated(Exception):
652
    """A decorating function has requested its original command be used.
653
    
654
    This should never escape bzr, so does not need to be printable.
655
    """
656
1185.65.29 by Robert Collins
Implement final review suggestions.
657
1185.35.42 by Aaron Bentley
Fixed fetch to be safer wrt ghosts and corrupt branches
658
class MissingText(BzrNewError):
659
    """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
660
1185.35.42 by Aaron Bentley
Fixed fetch to be safer wrt ghosts and corrupt branches
661
    def __init__(self, branch, text_revision, file_id):
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
662
        BzrNewError.__init__(self)
1185.35.42 by Aaron Bentley
Fixed fetch to be safer wrt ghosts and corrupt branches
663
        self.branch = branch
664
        self.base = branch.base
665
        self.text_revision = text_revision
666
        self.file_id = file_id
1534.7.5 by Aaron Bentley
Got unique_add under test
667
668
class DuplicateKey(BzrNewError):
669
    """Key %(key)s is already present in map"""
1534.7.6 by Aaron Bentley
Added conflict handling
670
671
class MalformedTransform(BzrNewError):
1534.7.49 by Aaron Bentley
Printed conflicts in MalformedTransform
672
    """Tree transform is malformed %(conflicts)r"""
1534.7.24 by Aaron Bentley
Merge from the mainline
673
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
674
675
class BzrBadParameter(BzrNewError):
1185.65.29 by Robert Collins
Implement final review suggestions.
676
    """A bad parameter : %(param)s is not usable.
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
677
    
1185.65.29 by Robert Collins
Implement final review suggestions.
678
    This exception should never be thrown, but it is a base class for all
679
    parameter-to-function errors.
680
    """
1534.3.1 by Robert Collins
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
681
    def __init__(self, param):
682
        BzrNewError.__init__(self)
683
        self.param = param
1534.7.32 by Aaron Bentley
Got conflict handling working when conflicts involve existing files
684
1534.4.3 by Robert Collins
Implement BranchTestProviderAdapter, so tests now run across all branch formats.
685
1185.65.29 by Robert Collins
Implement final review suggestions.
686
class BzrBadParameterNotUnicode(BzrBadParameter):
687
    """Parameter %(param)s is neither unicode nor utf8."""
1534.7.120 by Aaron Bentley
PEP8 fixes
688
689
1534.7.32 by Aaron Bentley
Got conflict handling working when conflicts involve existing files
690
class ReusingTransform(BzrNewError):
691
    """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
692
1534.7.120 by Aaron Bentley
PEP8 fixes
693
1534.7.66 by Aaron Bentley
Ensured we don't accidentally move the root directory
694
class CantMoveRoot(BzrNewError):
695
    """Moving the root directory is not supported at this time"""
1185.65.29 by Robert Collins
Implement final review suggestions.
696
1534.7.120 by Aaron Bentley
PEP8 fixes
697
1185.65.29 by Robert Collins
Implement final review suggestions.
698
class BzrBadParameterNotString(BzrBadParameter):
699
    """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.
700
701
1534.4.44 by Robert Collins
Make a new BzrDir format that uses a versioned branch format in a branch/ subdirectory.
702
class BzrBadParameterMissing(BzrBadParameter):
703
    """Parameter $(param)s is required but not present."""
704
705
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.
706
class DependencyNotPresent(BzrNewError):
707
    """Unable to import library: %(library)s, %(error)s"""
708
709
    def __init__(self, library, error):
710
        BzrNewError.__init__(self, library=library, error=error)
711
712
713
class ParamikoNotPresent(DependencyNotPresent):
714
    """Unable to import paramiko (required for sftp support): %(error)s"""
715
716
    def __init__(self, error):
717
        DependencyNotPresent.__init__(self, 'paramiko', error)
718
719
1534.4.3 by Robert Collins
Implement BranchTestProviderAdapter, so tests now run across all branch formats.
720
class UninitializableFormat(BzrNewError):
721
    """Format %(format)s cannot be initialised by this version of bzr."""
722
723
    def __init__(self, format):
724
        BzrNewError.__init__(self)
725
        self.format = format
1551.3.4 by Aaron Bentley
Implemented default command options
726
1534.7.156 by Aaron Bentley
PEP8 fixes
727
1534.7.130 by Aaron Bentley
More conflict handling, test porting
728
class NoDiff3(BzrNewError):
729
    """Diff3 is not installed on this machine."""
1534.7.162 by Aaron Bentley
Handle failures creating/deleting the Limbo directory
730
731
732
class ExistingLimbo(BzrNewError):
733
    """This tree contains left-over files from a failed operation.
734
    Please examine %(limbo_dir)s to see if it contains any files you wish to
735
    keep, and delete it when you are done.
736
    """
737
    def __init__(self, limbo_dir):
738
       BzrNewError.__init__(self)
739
       self.limbo_dir = limbo_dir
740
741
742
class ImmortalLimbo(BzrNewError):
743
    """Unable to delete transform temporary directory $(limbo_dir)s.
744
    Please examine %(limbo_dir)s to see if it contains any files you wish to
745
    keep, and delete it when you are done.
746
    """
747
    def __init__(self, limbo_dir):
748
       BzrNewError.__init__(self)
749
       self.limbo_dir = limbo_dir
1534.7.163 by Aaron Bentley
Merge from Robert [Fails tests]
750
751
1508.1.22 by Robert Collins
implement out of date working tree checks in commit.
752
class OutOfDateTree(BzrNewError):
753
    """Working tree is out of date, please run 'bzr update'."""
1508.1.25 by Robert Collins
Update per review comments.
754
755
    def __init__(self, tree):
756
        BzrNewError.__init__(self)
757
        self.tree = tree