/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
5557.1.15 by John Arbash Meinel
Merge bzr.dev 5597 to resolve NEWS, aka bzr-2.3.txt
1
# Copyright (C) 2006-2011 Canonical Ltd
1534.4.50 by Robert Collins
Got the bzrdir api straightened out, plenty of refactoring to use it pending, but the api is up and running.
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
4183.7.1 by Sabin Iacob
update FSF mailing address
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
1534.4.50 by Robert Collins
Got the bzrdir api straightened out, plenty of refactoring to use it pending, but the api is up and running.
16
17
"""Tests for the formatting and construction of errors."""
18
5050.8.1 by Parth Malwankar
added test to ensure that BzrError subclasses dont use "message" as a name
19
import inspect
20
import re
4634.1.2 by Martin Pool
Add test for CannotBindAddress
21
import socket
3577.1.1 by Andrew Bennetts
Cherry-pick TipChangeRejected changes from pre-branch-tip-changed-hook loom.
22
import sys
4634.1.2 by Martin Pool
Add test for CannotBindAddress
23
1948.1.6 by John Arbash Meinel
Make BzrNewError always return a str object
24
from bzrlib import (
25
    bzrdir,
26
    errors,
3234.2.6 by Alexander Belchenko
because every mail client has different rules to compose command line we should encode arguments to 8 bit string only when needed.
27
    osutils,
3200.2.1 by Robert Collins
* The ``register-branch`` command will now use the public url of the branch
28
    urlutils,
1948.1.6 by John Arbash Meinel
Make BzrNewError always return a str object
29
    )
5579.3.1 by Jelmer Vernooij
Remove unused imports.
30
from bzrlib.tests import (
31
    TestCase,
32
    TestCaseWithTransport,
33
    TestSkipped,
34
    )
1534.4.50 by Robert Collins
Got the bzrdir api straightened out, plenty of refactoring to use it pending, but the api is up and running.
35
36
37
class TestErrors(TestCaseWithTransport):
38
5050.8.1 by Parth Malwankar
added test to ensure that BzrError subclasses dont use "message" as a name
39
    def test_no_arg_named_message(self):
40
        """Ensure the __init__ and _fmt in errors do not have "message" arg.
41
42
        This test fails if __init__ or _fmt in errors has an argument
43
        named "message" as this can cause errors in some Python versions.
44
        Python 2.5 uses a slot for StandardError.message.
45
        See bug #603461
46
        """
47
        fmt_pattern = re.compile("%\(message\)[sir]")
5050.8.4 by Parth Malwankar
skip test if __subclasses__ is supported for classes.
48
        subclasses_present = getattr(errors.BzrError, '__subclasses__', None)
49
        if not subclasses_present:
50
            raise TestSkipped('__subclasses__ attribute required for classes. '
51
                'Requires Python 2.5 or later.')
5050.8.3 by Parth Malwankar
use __subclasses__
52
        for c in errors.BzrError.__subclasses__():
53
            init = getattr(c, '__init__', None)
54
            fmt = getattr(c, '_fmt', None)
5050.8.1 by Parth Malwankar
added test to ensure that BzrError subclasses dont use "message" as a name
55
            if init:
56
                args = inspect.getargspec(init)[0]
57
                self.assertFalse('message' in args,
58
                    ('Argument name "message" not allowed for '
5050.8.3 by Parth Malwankar
use __subclasses__
59
                    '"errors.%s.__init__"' % c.__name__))
5050.8.1 by Parth Malwankar
added test to ensure that BzrError subclasses dont use "message" as a name
60
            if fmt and fmt_pattern.search(fmt):
61
                self.assertFalse(True, ('"message" not allowed in '
5050.8.3 by Parth Malwankar
use __subclasses__
62
                    '"errors.%s._fmt"' % c.__name__))
5050.8.1 by Parth Malwankar
added test to ensure that BzrError subclasses dont use "message" as a name
63
3287.20.2 by John Arbash Meinel
Raise a clear error about the offending filename when there is a filename with bad characters.
64
    def test_bad_filename_encoding(self):
65
        error = errors.BadFilenameEncoding('bad/filen\xe5me', 'UTF-8')
66
        self.assertEqualDiff(
67
            "Filename 'bad/filen\\xe5me' is not valid in your current"
68
            " filesystem encoding UTF-8",
69
            str(error))
70
3207.2.1 by jameinel
Add a test that _iter_changes raises a clearer error when we encounter an invalid rename.
71
    def test_corrupt_dirstate(self):
72
        error = errors.CorruptDirstate('path/to/dirstate', 'the reason why')
3221.1.3 by Martin Pool
Review cleanups for CorruptDirstate: use the path everywhere rather than the object, and use more standard phrasing.
73
        self.assertEqualDiff(
74
            "Inconsistency in dirstate file path/to/dirstate.\n"
75
            "Error: the reason why",
76
            str(error))
3207.2.1 by jameinel
Add a test that _iter_changes raises a clearer error when we encounter an invalid rename.
77
3640.2.5 by John Arbash Meinel
Change from using AssertionError to using DirstateCorrupt in a few places
78
    def test_dirstate_corrupt(self):
79
        error = errors.DirstateCorrupt('.bzr/checkout/dirstate',
80
                                       'trailing garbage: "x"')
81
        self.assertEqualDiff("The dirstate file (.bzr/checkout/dirstate)"
82
            " appears to be corrupt: trailing garbage: \"x\"",
83
            str(error))
84
2018.5.24 by Andrew Bennetts
Setting NO_SMART_VFS in environment will disable VFS methods in the smart server. (Robert Collins, John Arbash Meinel, Andrew Bennetts)
85
    def test_disabled_method(self):
86
        error = errors.DisabledMethod("class name")
87
        self.assertEqualDiff(
88
            "The smart server method 'class name' is disabled.", str(error))
89
2255.7.16 by John Arbash Meinel
Make sure adding a duplicate file_id raises DuplicateFileId.
90
    def test_duplicate_file_id(self):
91
        error = errors.DuplicateFileId('a_file_id', 'foo')
92
        self.assertEqualDiff('File id {a_file_id} already exists in inventory'
93
                             ' as foo', str(error))
94
2432.1.19 by Robert Collins
Ensure each HelpIndex has a unique prefix.
95
    def test_duplicate_help_prefix(self):
96
        error = errors.DuplicateHelpPrefix('foo')
97
        self.assertEqualDiff('The prefix foo is in the help search path twice.',
98
            str(error))
99
3445.1.1 by John Arbash Meinel
Start working on a new Graph api to make finding revision numbers faster.
100
    def test_ghost_revisions_have_no_revno(self):
101
        error = errors.GhostRevisionsHaveNoRevno('target', 'ghost_rev')
102
        self.assertEqualDiff("Could not determine revno for {target} because"
103
                             " its ancestry shows a ghost at {ghost_rev}",
104
                             str(error))
105
2550.2.3 by Robert Collins
Add require_api API.
106
    def test_incompatibleAPI(self):
107
        error = errors.IncompatibleAPI("module", (1, 2, 3), (4, 5, 6), (7, 8, 9))
108
        self.assertEqualDiff(
109
            'The API for "module" is not compatible with "(1, 2, 3)". '
110
            'It supports versions "(4, 5, 6)" to "(7, 8, 9)".',
111
            str(error))
112
3207.2.2 by John Arbash Meinel
Fix bug #187169, when an invalid delta is supplied to update_basis_by_delta
113
    def test_inconsistent_delta(self):
114
        error = errors.InconsistentDelta('path', 'file-id', 'reason for foo')
115
        self.assertEqualDiff(
3221.1.8 by Martin Pool
Update error format in test_inconsistent_delta
116
            "An inconsistent delta was supplied involving 'path', 'file-id'\n"
3207.2.2 by John Arbash Meinel
Fix bug #187169, when an invalid delta is supplied to update_basis_by_delta
117
            "reason: reason for foo",
118
            str(error))
119
4505.5.1 by Robert Collins
Add more generic InconsistentDeltaDelta error class for use when the exact cause of an inconsistent delta isn't trivially accessible.
120
    def test_inconsistent_delta_delta(self):
121
        error = errors.InconsistentDeltaDelta([], 'reason')
122
        self.assertEqualDiff(
123
            "An inconsistent delta was supplied: []\nreason: reason",
124
            str(error))
125
2634.1.1 by Robert Collins
(robertc) Reinstate the accidentally backed out external_url patch.
126
    def test_in_process_transport(self):
127
        error = errors.InProcessTransport('fpp')
128
        self.assertEqualDiff(
129
            "The transport 'fpp' is only accessible within this process.",
130
            str(error))
131
3059.2.12 by Vincent Ladeuil
Spiv review feedback.
132
    def test_invalid_http_range(self):
133
        error = errors.InvalidHttpRange('path',
134
                                        'Content-Range: potatoes 0-00/o0oo0',
135
                                        'bad range')
136
        self.assertEquals("Invalid http range"
137
                          " 'Content-Range: potatoes 0-00/o0oo0'"
138
                          " for path: bad range",
139
                          str(error))
140
141
    def test_invalid_range(self):
142
        error = errors.InvalidRange('path', 12, 'bad range')
143
        self.assertEquals("Invalid range access in path at 12: bad range",
144
                          str(error))
145
1986.5.3 by Robert Collins
New method ``WorkingTree.flush()`` which will write the current memory
146
    def test_inventory_modified(self):
147
        error = errors.InventoryModified("a tree to be repred")
148
        self.assertEqualDiff("The current inventory for the tree 'a tree to "
149
            "be repred' has been modified, so a clean inventory cannot be "
150
            "read without data loss.",
151
            str(error))
152
4294.2.8 by Robert Collins
Reduce round trips pushing new branches substantially.
153
    def test_jail_break(self):
154
        error = errors.JailBreak("some url")
155
        self.assertEqualDiff("An attempt to access a url outside the server"
156
            " jail was made: 'some url'.",
157
            str(error))
158
2255.2.145 by Robert Collins
Support unbreakable locks for trees.
159
    def test_lock_active(self):
160
        error = errors.LockActive("lock description")
161
        self.assertEqualDiff("The lock for 'lock description' is in use and "
162
            "cannot be broken.",
163
            str(error))
164
4634.161.1 by Andrew Bennetts
Add LockCorrupt error, and use it to provide nicer handling of unparseable lock/held/info files.
165
    def test_lock_corrupt(self):
166
        error = errors.LockCorrupt("corruption info")
167
        self.assertEqualDiff("Lock is apparently held, but corrupted: "
168
            "corruption info\n"
169
            "Use 'bzr break-lock' to clear it",
170
            str(error))
171
2535.3.4 by Andrew Bennetts
Simple implementation of Knit.insert_data_stream.
172
    def test_knit_data_stream_incompatible(self):
173
        error = errors.KnitDataStreamIncompatible(
174
            'stream format', 'target format')
175
        self.assertEqual('Cannot insert knit data stream of format '
176
                         '"stream format" into knit of format '
177
                         '"target format".', str(error))
178
3052.2.1 by Robert Collins
Add a new KnitDataStreamUnknown error class for showing formats we can't understand.
179
    def test_knit_data_stream_unknown(self):
180
        error = errors.KnitDataStreamUnknown(
181
            'stream format')
182
        self.assertEqual('Cannot parse knit data stream of format '
183
                         '"stream format".', str(error))
184
2171.1.1 by John Arbash Meinel
Knit index files should ignore empty indexes rather than consider them corrupt.
185
    def test_knit_header_error(self):
186
        error = errors.KnitHeaderError('line foo\n', 'path/to/file')
187
        self.assertEqual("Knit header error: 'line foo\\n' unexpected"
2745.3.2 by Daniel Watkins
Updated tests to reflect new error text.
188
                         " for file \"path/to/file\".", str(error))
2171.1.1 by John Arbash Meinel
Knit index files should ignore empty indexes rather than consider them corrupt.
189
2196.2.5 by John Arbash Meinel
Add an exception class when the knit index storage method is unknown, and properly test for it
190
    def test_knit_index_unknown_method(self):
191
        error = errors.KnitIndexUnknownMethod('http://host/foo.kndx',
192
                                              ['bad', 'no-eol'])
193
        self.assertEqual("Knit index http://host/foo.kndx does not have a"
194
                         " known method in options: ['bad', 'no-eol']",
195
                         str(error))
196
2018.2.3 by Andrew Bennetts
Starting factoring out the smart server client "medium" from the protocol.
197
    def test_medium_not_connected(self):
198
        error = errors.MediumNotConnected("a medium")
199
        self.assertEqualDiff(
200
            "The medium 'a medium' is not connected.", str(error))
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
201
3200.2.1 by Robert Collins
* The ``register-branch`` command will now use the public url of the branch
202
    def test_no_public_branch(self):
203
        b = self.make_branch('.')
204
        error = errors.NoPublicBranch(b)
205
        url = urlutils.unescape_for_display(b.base, 'ascii')
206
        self.assertEqualDiff(
207
            'There is no public branch set for "%s".' % url, str(error))
208
1534.4.50 by Robert Collins
Got the bzrdir api straightened out, plenty of refactoring to use it pending, but the api is up and running.
209
    def test_no_repo(self):
210
        dir = bzrdir.BzrDir.create(self.get_url())
211
        error = errors.NoRepositoryPresent(dir)
1740.5.6 by Martin Pool
Clean up many exception classes.
212
        self.assertNotEqual(-1, str(error).find((dir.transport.clone('..').base)))
213
        self.assertEqual(-1, str(error).find((dir.transport.base)))
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
214
2018.2.3 by Andrew Bennetts
Starting factoring out the smart server client "medium" from the protocol.
215
    def test_no_smart_medium(self):
216
        error = errors.NoSmartMedium("a transport")
217
        self.assertEqualDiff("The transport 'a transport' cannot tunnel the "
218
            "smart protocol.",
219
            str(error))
220
2432.1.4 by Robert Collins
Add an explicit error for missing help topics.
221
    def test_no_help_topic(self):
222
        error = errors.NoHelpTopic("topic")
223
        self.assertEqualDiff("No help could be found for 'topic'. "
224
            "Please use 'bzr help topics' to obtain a list of topics.",
225
            str(error))
226
1988.2.1 by Robert Collins
WorkingTree has a new api ``unversion`` which allow the unversioning of
227
    def test_no_such_id(self):
228
        error = errors.NoSuchId("atree", "anid")
2745.3.2 by Daniel Watkins
Updated tests to reflect new error text.
229
        self.assertEqualDiff("The file id \"anid\" is not present in the tree "
2745.3.3 by Daniel Watkins
Changed to remove need for escaping of quotes.
230
            "atree.",
1988.2.1 by Robert Collins
WorkingTree has a new api ``unversion`` which allow the unversioning of
231
            str(error))
1534.5.7 by Robert Collins
Start factoring out the upgrade policy logic.
232
1908.11.1 by Robert Collins
Add a new method ``Tree.revision_tree`` which allows access to cached
233
    def test_no_such_revision_in_tree(self):
234
        error = errors.NoSuchRevisionInTree("atree", "anid")
2745.3.3 by Daniel Watkins
Changed to remove need for escaping of quotes.
235
        self.assertEqualDiff("The revision id {anid} is not present in the"
236
                             " tree atree.", str(error))
1908.11.1 by Robert Collins
Add a new method ``Tree.revision_tree`` which allows access to cached
237
        self.assertIsInstance(error, errors.NoSuchRevision)
238
3221.11.2 by Robert Collins
Create basic stackable branch facility.
239
    def test_not_stacked(self):
240
        error = errors.NotStacked('a branch')
241
        self.assertEqualDiff("The branch 'a branch' is not stacked.",
242
            str(error))
243
1986.5.3 by Robert Collins
New method ``WorkingTree.flush()`` which will write the current memory
244
    def test_not_write_locked(self):
245
        error = errors.NotWriteLocked('a thing to repr')
246
        self.assertEqualDiff("'a thing to repr' is not write locked but needs "
247
            "to be.",
248
            str(error))
249
2872.5.1 by Martin Pool
Avoid internal error tracebacks on failure to lock on readonly transport (#129701).
250
    def test_lock_failed(self):
251
        error = errors.LockFailed('http://canonical.com/', 'readonly transport')
252
        self.assertEqualDiff("Cannot lock http://canonical.com/: readonly transport",
253
            str(error))
254
        self.assertFalse(error.internal_error)
255
2018.2.4 by Robert Collins
separate out the client medium from the client encoding protocol for the smart server.
256
    def test_too_many_concurrent_requests(self):
257
        error = errors.TooManyConcurrentRequests("a medium")
258
        self.assertEqualDiff("The medium 'a medium' has reached its concurrent "
259
            "request limit. Be sure to finish_writing and finish_reading on "
2018.5.134 by Andrew Bennetts
Fix the TooManyConcurrentRequests error message.
260
            "the currently open request.",
2018.2.4 by Robert Collins
separate out the client medium from the client encoding protocol for the smart server.
261
            str(error))
262
3350.3.3 by Robert Collins
Functional get_record_stream interface tests covering full interface.
263
    def test_unavailable_representation(self):
264
        error = errors.UnavailableRepresentation(('key',), "mpdiff", "fulltext")
265
        self.assertEqualDiff("The encoding 'mpdiff' is not available for key "
266
            "('key',) which is encoded as 'fulltext'.",
267
            str(error))
268
2245.1.3 by Robert Collins
Add install_hook to the BranchHooks class as the official means for installing a hook.
269
    def test_unknown_hook(self):
270
        error = errors.UnknownHook("branch", "foo")
271
        self.assertEqualDiff("The branch hook 'foo' is unknown in this version"
272
            " of bzrlib.",
273
            str(error))
274
        error = errors.UnknownHook("tree", "bar")
275
        self.assertEqualDiff("The tree hook 'bar' is unknown in this version"
276
            " of bzrlib.",
277
            str(error))
278
3221.11.2 by Robert Collins
Create basic stackable branch facility.
279
    def test_unstackable_branch_format(self):
280
        format = u'foo'
281
        url = "/foo"
282
        error = errors.UnstackableBranchFormat(format, url)
283
        self.assertEqualDiff(
284
            "The branch '/foo'(foo) is not a stackable format. "
285
            "You will need to upgrade the branch to permit branch stacking.",
286
            str(error))
287
4462.3.2 by Robert Collins
Do not stack on the same branch/repository anymore. This was never supported and would generally result in infinite recursion. Fixes bug 376243.
288
    def test_unstackable_location(self):
289
        error = errors.UnstackableLocationError('foo', 'bar')
290
        self.assertEqualDiff("The branch 'foo' cannot be stacked on 'bar'.",
291
            str(error))
292
3221.11.2 by Robert Collins
Create basic stackable branch facility.
293
    def test_unstackable_repository_format(self):
294
        format = u'foo'
295
        url = "/foo"
296
        error = errors.UnstackableRepositoryFormat(format, url)
297
        self.assertEqualDiff(
298
            "The repository '/foo'(foo) is not a stackable format. "
299
            "You will need to upgrade the repository to permit branch stacking.",
300
            str(error))
301
1534.5.7 by Robert Collins
Start factoring out the upgrade policy logic.
302
    def test_up_to_date(self):
5582.10.4 by Jelmer Vernooij
Fix a bunch of tests.
303
        from bzrlib.plugins.weave_fmt.bzrdir import BzrDirFormat4
304
        error = errors.UpToDateFormat(BzrDirFormat4())
4032.3.2 by Robert Collins
Create and use a RPC call to create branches on bzr servers rather than using VFS calls.
305
        self.assertEqualDiff("The branch format All-in-one "
306
                             "format 4 is already at the most "
1534.5.9 by Robert Collins
Advise users running upgrade on a checkout to also run it on the branch.
307
                             "recent format.",
308
                             str(error))
1570.1.13 by Robert Collins
Check for incorrect revision parentage in the weave during revision access.
309
310
    def test_corrupt_repository(self):
311
        repo = self.make_repository('.')
312
        error = errors.CorruptRepository(repo)
313
        self.assertEqualDiff("An error has been detected in the repository %s.\n"
314
                             "Please run bzr reconcile on this repository." %
315
                             repo.bzrdir.root_transport.base,
316
                             str(error))
1948.1.6 by John Arbash Meinel
Make BzrNewError always return a str object
317
2052.6.1 by Robert Collins
``Transport.get`` has had its interface made more clear for ease of use.
318
    def test_read_error(self):
319
        # a unicode path to check that %r is being used.
320
        path = u'a path'
321
        error = errors.ReadError(path)
322
        self.assertEqualDiff("Error reading from u'a path'.", str(error))
323
2592.1.7 by Robert Collins
A validate that goes boom.
324
    def test_bad_index_format_signature(self):
325
        error = errors.BadIndexFormatSignature("foo", "bar")
326
        self.assertEqual("foo is not an index of type bar.",
327
            str(error))
2052.6.2 by Robert Collins
Merge bzr.dev.
328
2592.1.11 by Robert Collins
Detect truncated indices.
329
    def test_bad_index_data(self):
330
        error = errors.BadIndexData("foo")
331
        self.assertEqual("Error in data for index foo.",
332
            str(error))
333
2592.1.15 by Robert Collins
Detect duplicate key insertion.
334
    def test_bad_index_duplicate_key(self):
335
        error = errors.BadIndexDuplicateKey("foo", "bar")
336
        self.assertEqual("The key 'foo' is already in index 'bar'.",
337
            str(error))
338
2592.1.12 by Robert Collins
Handle basic node adds.
339
    def test_bad_index_key(self):
340
        error = errors.BadIndexKey("foo")
341
        self.assertEqual("The key 'foo' is not a valid key.",
342
            str(error))
343
2592.1.10 by Robert Collins
Make validate detect node reference parsing errors.
344
    def test_bad_index_options(self):
345
        error = errors.BadIndexOptions("foo")
346
        self.assertEqual("Could not parse options for index foo.",
347
            str(error))
348
2592.1.12 by Robert Collins
Handle basic node adds.
349
    def test_bad_index_value(self):
350
        error = errors.BadIndexValue("foo")
351
        self.assertEqual("The value 'foo' is not a valid value.",
352
            str(error))
353
2067.3.1 by Martin Pool
Clean up BzrNewError, other exception classes and users.
354
    def test_bzrnewerror_is_deprecated(self):
355
        class DeprecatedError(errors.BzrNewError):
356
            pass
2067.3.6 by Martin Pool
Update deprecation version
357
        self.callDeprecated(['BzrNewError was deprecated in bzr 0.13; '
2067.3.1 by Martin Pool
Clean up BzrNewError, other exception classes and users.
358
             'please convert DeprecatedError to use BzrError instead'],
359
            DeprecatedError)
360
361
    def test_bzrerror_from_literal_string(self):
362
        # Some code constructs BzrError from a literal string, in which case
363
        # no further formatting is done.  (I'm not sure raising the base class
364
        # is a great idea, but if the exception is not intended to be caught
365
        # perhaps no more is needed.)
366
        try:
367
            raise errors.BzrError('this is my errors; %d is not expanded')
368
        except errors.BzrError, e:
369
            self.assertEqual('this is my errors; %d is not expanded', str(e))
370
2018.2.4 by Robert Collins
separate out the client medium from the client encoding protocol for the smart server.
371
    def test_reading_completed(self):
372
        error = errors.ReadingCompleted("a request")
373
        self.assertEqualDiff("The MediumRequest 'a request' has already had "
374
            "finish_reading called upon it - the request has been completed and"
375
            " no more data may be read.",
376
            str(error))
377
378
    def test_writing_completed(self):
379
        error = errors.WritingCompleted("a request")
380
        self.assertEqualDiff("The MediumRequest 'a request' has already had "
381
            "finish_writing called upon it - accept bytes may not be called "
382
            "anymore.",
383
            str(error))
384
385
    def test_writing_not_completed(self):
386
        error = errors.WritingNotComplete("a request")
387
        self.assertEqualDiff("The MediumRequest 'a request' has not has "
388
            "finish_writing called upon it - until the write phase is complete"
389
            " no data may be read.",
390
            str(error))
391
2052.6.1 by Robert Collins
``Transport.get`` has had its interface made more clear for ease of use.
392
    def test_transport_not_possible(self):
393
        error = errors.TransportNotPossible('readonly', 'original error')
394
        self.assertEqualDiff('Transport operation not possible:'
395
                         ' readonly original error', str(error))
2052.4.4 by John Arbash Meinel
Create a SocketConnectionError to make creating nice errors easier
396
397
    def assertSocketConnectionError(self, expected, *args, **kwargs):
398
        """Check the formatting of a SocketConnectionError exception"""
399
        e = errors.SocketConnectionError(*args, **kwargs)
400
        self.assertEqual(expected, str(e))
401
402
    def test_socket_connection_error(self):
403
        """Test the formatting of SocketConnectionError"""
404
405
        # There should be a default msg about failing to connect
406
        # we only require a host name.
407
        self.assertSocketConnectionError(
408
            'Failed to connect to ahost',
409
            'ahost')
410
411
        # If port is None, we don't put :None
412
        self.assertSocketConnectionError(
413
            'Failed to connect to ahost',
414
            'ahost', port=None)
415
        # But if port is supplied we include it
416
        self.assertSocketConnectionError(
417
            'Failed to connect to ahost:22',
418
            'ahost', port=22)
419
420
        # We can also supply extra information about the error
421
        # with or without a port
422
        self.assertSocketConnectionError(
423
            'Failed to connect to ahost:22; bogus error',
424
            'ahost', port=22, orig_error='bogus error')
425
        self.assertSocketConnectionError(
426
            'Failed to connect to ahost; bogus error',
427
            'ahost', orig_error='bogus error')
428
        # An exception object can be passed rather than a string
429
        orig_error = ValueError('bad value')
430
        self.assertSocketConnectionError(
431
            'Failed to connect to ahost; %s' % (str(orig_error),),
432
            host='ahost', orig_error=orig_error)
433
434
        # And we can supply a custom failure message
435
        self.assertSocketConnectionError(
436
            'Unable to connect to ssh host ahost:444; my_error',
437
            host='ahost', port=444, msg='Unable to connect to ssh host',
438
            orig_error='my_error')
439
3535.8.2 by James Westby
Incorporate spiv's feedback.
440
    def test_target_not_branch(self):
441
        """Test the formatting of TargetNotBranch."""
442
        error = errors.TargetNotBranch('foo')
443
        self.assertEqual(
444
            "Your branch does not have all of the revisions required in "
3535.8.4 by James Westby
Replace "however" with "and" at John's request.
445
            "order to merge this merge directive and the target "
3535.8.3 by James Westby
Use location instead of branch as suggested by Robert.
446
            "location specified in the merge directive is not a branch: "
3535.8.2 by James Westby
Incorporate spiv's feedback.
447
            "foo.", str(error))
448
2376.4.26 by Jonathan Lange
Tests for MalformedBugIdentifier and new error UnknownBugTrackerAbbreviation.
449
    def test_malformed_bug_identifier(self):
450
        """Test the formatting of MalformedBugIdentifier."""
451
        error = errors.MalformedBugIdentifier('bogus', 'reason for bogosity')
452
        self.assertEqual(
3535.10.1 by James Westby
Point to "bzr help bugs" from MalformedBugIdentifier.
453
            'Did not understand bug identifier bogus: reason for bogosity. '
3535.10.11 by James Westby
Fix test for change in error message.
454
            'See "bzr help bugs" for more information on this feature.',
2376.4.26 by Jonathan Lange
Tests for MalformedBugIdentifier and new error UnknownBugTrackerAbbreviation.
455
            str(error))
456
457
    def test_unknown_bug_tracker_abbreviation(self):
458
        """Test the formatting of UnknownBugTrackerAbbreviation."""
2376.4.27 by Jonathan Lange
Include branch information in UnknownBugTrackerAbbreviation
459
        branch = self.make_branch('some_branch')
460
        error = errors.UnknownBugTrackerAbbreviation('xxx', branch)
2376.4.26 by Jonathan Lange
Tests for MalformedBugIdentifier and new error UnknownBugTrackerAbbreviation.
461
        self.assertEqual(
2376.4.27 by Jonathan Lange
Include branch information in UnknownBugTrackerAbbreviation
462
            "Cannot find registered bug tracker called xxx on %s" % branch,
2376.4.26 by Jonathan Lange
Tests for MalformedBugIdentifier and new error UnknownBugTrackerAbbreviation.
463
            str(error))
2052.4.4 by John Arbash Meinel
Create a SocketConnectionError to make creating nice errors easier
464
2018.5.163 by Andrew Bennetts
Deal with various review comments from Robert.
465
    def test_unexpected_smart_server_response(self):
466
        e = errors.UnexpectedSmartServerResponse(('not yes',))
467
        self.assertEqual(
468
            "Could not understand response from smart server: ('not yes',)",
469
            str(e))
2052.4.4 by John Arbash Meinel
Create a SocketConnectionError to make creating nice errors easier
470
2506.2.1 by Andrew Bennetts
Start implementing container format reading and writing.
471
    def test_unknown_container_format(self):
472
        """Test the formatting of UnknownContainerFormatError."""
473
        e = errors.UnknownContainerFormatError('bad format string')
474
        self.assertEqual(
475
            "Unrecognised container format: 'bad format string'",
476
            str(e))
477
478
    def test_unexpected_end_of_container(self):
479
        """Test the formatting of UnexpectedEndOfContainerError."""
480
        e = errors.UnexpectedEndOfContainerError()
481
        self.assertEqual(
482
            "Unexpected end of container stream", str(e))
483
484
    def test_unknown_record_type(self):
485
        """Test the formatting of UnknownRecordTypeError."""
486
        e = errors.UnknownRecordTypeError("X")
487
        self.assertEqual(
488
            "Unknown record type: 'X'",
489
            str(e))
490
2506.3.1 by Andrew Bennetts
More progress:
491
    def test_invalid_record(self):
492
        """Test the formatting of InvalidRecordError."""
493
        e = errors.InvalidRecordError("xxx")
494
        self.assertEqual(
495
            "Invalid record: xxx",
496
            str(e))
497
2506.2.6 by Andrew Bennetts
Add validate method to ContainerReader and BytesRecordReader.
498
    def test_container_has_excess_data(self):
499
        """Test the formatting of ContainerHasExcessDataError."""
500
        e = errors.ContainerHasExcessDataError("excess bytes")
501
        self.assertEqual(
502
            "Container has data after end marker: 'excess bytes'",
503
            str(e))
504
2506.6.1 by Andrew Bennetts
Return a callable instead of a str from read, and add more validation.
505
    def test_duplicate_record_name_error(self):
506
        """Test the formatting of DuplicateRecordNameError."""
507
        e = errors.DuplicateRecordNameError(u"n\xe5me".encode('utf-8'))
508
        self.assertEqual(
2745.3.3 by Daniel Watkins
Changed to remove need for escaping of quotes.
509
            "Container has multiple records with the same name: n\xc3\xa5me",
2506.6.1 by Andrew Bennetts
Return a callable instead of a str from read, and add more validation.
510
            str(e))
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
511
2854.1.1 by Martin Pool
Fix "unprintable error" message for BzrCheckError and others
512
    def test_check_error(self):
513
        # This has a member called 'message', which is problematic in
514
        # python2.5 because that is a slot on the base Exception class
515
        e = errors.BzrCheckError('example check failure')
516
        self.assertEqual(
517
            "Internal check failed: example check failure",
518
            str(e))
519
        self.assertTrue(e.internal_error)
2506.6.1 by Andrew Bennetts
Return a callable instead of a str from read, and add more validation.
520
2535.3.40 by Andrew Bennetts
Tidy up more XXXs.
521
    def test_repository_data_stream_error(self):
522
        """Test the formatting of RepositoryDataStreamError."""
523
        e = errors.RepositoryDataStreamError(u"my reason")
524
        self.assertEqual(
525
            "Corrupt or incompatible data stream: my reason", str(e))
526
2978.2.1 by Alexander Belchenko
fix formatting of ImmortalPendingDeletion error message.
527
    def test_immortal_pending_deletion_message(self):
528
        err = errors.ImmortalPendingDeletion('foo')
529
        self.assertEquals(
530
            "Unable to delete transform temporary directory foo.  "
531
            "Please examine foo to see if it contains any files "
532
            "you wish to keep, and delete it when you are done.",
533
            str(err))
534
3006.2.2 by Alexander Belchenko
tests added.
535
    def test_unable_create_symlink(self):
536
        err = errors.UnableCreateSymlink()
537
        self.assertEquals(
538
            "Unable to create symlink on this platform",
539
            str(err))
540
        err = errors.UnableCreateSymlink(path=u'foo')
541
        self.assertEquals(
542
            "Unable to create symlink 'foo' on this platform",
543
            str(err))
544
        err = errors.UnableCreateSymlink(path=u'\xb5')
545
        self.assertEquals(
546
            "Unable to create symlink u'\\xb5' on this platform",
547
            str(err))
548
2692.1.1 by Andrew Bennetts
Add translate_client_path method to SmartServerRequest.
549
    def test_invalid_url_join(self):
550
        """Test the formatting of InvalidURLJoin."""
551
        e = errors.InvalidURLJoin('Reason', 'base path', ('args',))
552
        self.assertEqual(
553
            "Invalid URL join request: Reason: 'base path' + ('args',)",
554
            str(e))
555
3035.3.2 by Lukáš Lalinský
Add tests for InvalidBugTrackerURL.
556
    def test_incorrect_url(self):
557
        err = errors.InvalidBugTrackerURL('foo', 'http://bug.com/')
558
        self.assertEquals(
559
            ("The URL for bug tracker \"foo\" doesn't contain {id}: "
560
             "http://bug.com/"),
561
            str(err))
562
3234.2.6 by Alexander Belchenko
because every mail client has different rules to compose command line we should encode arguments to 8 bit string only when needed.
563
    def test_unable_encode_path(self):
564
        err = errors.UnableEncodePath('foo', 'executable')
3234.2.8 by Alexander Belchenko
fix grammar in formatting string of UnableEncodePath error.
565
        self.assertEquals("Unable to encode executable path 'foo' in "
3234.2.6 by Alexander Belchenko
because every mail client has different rules to compose command line we should encode arguments to 8 bit string only when needed.
566
            "user encoding " + osutils.get_user_encoding(),
567
            str(err))
568
3246.3.4 by Daniel Watkins
Added test.
569
    def test_unknown_format(self):
570
        err = errors.UnknownFormatError('bar', kind='foo')
571
        self.assertEquals("Unknown foo format: 'bar'", str(err))
572
3398.1.29 by Ian Clatworthy
add UnknownRules class & test
573
    def test_unknown_rules(self):
574
        err = errors.UnknownRules(['foo', 'bar'])
575
        self.assertEquals("Unknown rules detected: foo, bar.", str(err))
576
3577.1.1 by Andrew Bennetts
Cherry-pick TipChangeRejected changes from pre-branch-tip-changed-hook loom.
577
    def test_hook_failed(self):
578
        # Create an exc_info tuple by raising and catching an exception.
579
        try:
580
            1/0
581
        except ZeroDivisionError:
582
            exc_info = sys.exc_info()
4943.1.2 by Robert Collins
Adjust errors.py to fix missing references to 'warn'.
583
        err = errors.HookFailed('hook stage', 'hook name', exc_info, warn=False)
3577.1.1 by Andrew Bennetts
Cherry-pick TipChangeRejected changes from pre-branch-tip-changed-hook loom.
584
        self.assertStartsWith(
585
            str(err), 'Hook \'hook name\' during hook stage failed:\n')
586
        self.assertEndsWith(
587
            str(err), 'integer division or modulo by zero')
588
589
    def test_tip_change_rejected(self):
590
        err = errors.TipChangeRejected(u'Unicode message\N{INTERROBANG}')
591
        self.assertEquals(
592
            u'Tip change rejected: Unicode message\N{INTERROBANG}',
593
            unicode(err))
594
        self.assertEquals(
595
            'Tip change rejected: Unicode message\xe2\x80\xbd',
596
            str(err))
597
3690.1.1 by Andrew Bennetts
Unexpected error responses from a smart server no longer cause the client to traceback.
598
    def test_error_from_smart_server(self):
599
        error_tuple = ('error', 'tuple')
600
        err = errors.ErrorFromSmartServer(error_tuple)
601
        self.assertEquals(
602
            "Error received from smart server: ('error', 'tuple')", str(err))
603
604
    def test_untranslateable_error_from_smart_server(self):
605
        error_tuple = ('error', 'tuple')
606
        orig_err = errors.ErrorFromSmartServer(error_tuple)
3690.1.2 by Andrew Bennetts
Rename UntranslateableErrorFromSmartServer -> UnknownErrorFromSmartServer.
607
        err = errors.UnknownErrorFromSmartServer(orig_err)
3690.1.1 by Andrew Bennetts
Unexpected error responses from a smart server no longer cause the client to traceback.
608
        self.assertEquals(
609
            "Server sent an unexpected error: ('error', 'tuple')", str(err))
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
610
3883.2.3 by Andrew Bennetts
Add test, tweak traceback formatting.
611
    def test_smart_message_handler_error(self):
612
        # Make an exc_info tuple.
613
        try:
614
            raise Exception("example error")
615
        except Exception:
616
            exc_info = sys.exc_info()
617
        err = errors.SmartMessageHandlerError(exc_info)
618
        self.assertStartsWith(
619
            str(err), "The message handler raised an exception:\n")
620
        self.assertEndsWith(str(err), "Exception: example error\n")
3690.1.1 by Andrew Bennetts
Unexpected error responses from a smart server no longer cause the client to traceback.
621
3983.1.8 by Daniel Watkins
Added MustHaveWorkingTree error and accompanying test.
622
    def test_must_have_working_tree(self):
623
        err = errors.MustHaveWorkingTree('foo', 'bar')
3983.1.10 by Daniel Watkins
Made exception message slightly better.
624
        self.assertEqual(str(err), "Branching 'bar'(foo) must create a"
625
                                   " working tree.")
3983.1.8 by Daniel Watkins
Added MustHaveWorkingTree error and accompanying test.
626
3586.1.1 by Ian Clatworthy
add view-related errors and tests
627
    def test_no_such_view(self):
628
        err = errors.NoSuchView('foo')
629
        self.assertEquals("No such view: foo.", str(err))
630
631
    def test_views_not_supported(self):
632
        err = errors.ViewsNotSupported('atree')
633
        err_str = str(err)
634
        self.assertStartsWith(err_str, "Views are not supported by ")
635
        self.assertEndsWith(err_str, "; use 'bzr upgrade' to change your "
636
            "tree to a later format.")
637
3586.1.9 by Ian Clatworthy
first cut at view command
638
    def test_file_outside_view(self):
639
        err = errors.FileOutsideView('baz', ['foo', 'bar'])
640
        self.assertEquals('Specified file "baz" is outside the current view: '
641
            'foo, bar', str(err))
642
3990.2.2 by Daniel Watkins
Added InvalidShelfId error and accompanying test.
643
    def test_invalid_shelf_id(self):
644
        invalid_id = "foo"
645
        err = errors.InvalidShelfId(invalid_id)
3999.1.1 by Ian Clatworthy
Improve shelf documentation & fix backtrace (Daniel Watkins)
646
        self.assertEqual('"foo" is not a valid shelf id, '
647
            'try a number instead.', str(err))
3990.2.2 by Daniel Watkins
Added InvalidShelfId error and accompanying test.
648
4002.1.7 by Andrew Bennetts
Rename UnresumableWriteGroups to UnresumableWriteGroup.
649
    def test_unresumable_write_group(self):
4002.1.1 by Andrew Bennetts
Implement suspend_write_group/resume_write_group.
650
        repo = "dummy repo"
651
        wg_tokens = ['token']
652
        reason = "a reason"
4002.1.7 by Andrew Bennetts
Rename UnresumableWriteGroups to UnresumableWriteGroup.
653
        err = errors.UnresumableWriteGroup(repo, wg_tokens, reason)
4002.1.1 by Andrew Bennetts
Implement suspend_write_group/resume_write_group.
654
        self.assertEqual(
4002.1.7 by Andrew Bennetts
Rename UnresumableWriteGroups to UnresumableWriteGroup.
655
            "Repository dummy repo cannot resume write group "
4002.1.1 by Andrew Bennetts
Implement suspend_write_group/resume_write_group.
656
            "['token']: a reason", str(err))
657
658
    def test_unsuspendable_write_group(self):
659
        repo = "dummy repo"
660
        err = errors.UnsuspendableWriteGroup(repo)
661
        self.assertEqual(
662
            'Repository dummy repo cannot suspend a write group.', str(err))
663
4734.4.9 by Andrew Bennetts
More tests and comments.
664
    def test_not_branch_no_args(self):
665
        err = errors.NotBranchError('path')
666
        self.assertEqual('Not a branch: "path".', str(err))
667
668
    def test_not_branch_bzrdir_with_repo(self):
669
        bzrdir = self.make_repository('repo').bzrdir
670
        err = errors.NotBranchError('path', bzrdir=bzrdir)
671
        self.assertEqual(
672
            'Not a branch: "path": location is a repository.', str(err))
673
674
    def test_not_branch_bzrdir_without_repo(self):
675
        bzrdir = self.make_bzrdir('bzrdir')
676
        err = errors.NotBranchError('path', bzrdir=bzrdir)
677
        self.assertEqual('Not a branch: "path".', str(err))
678
5050.46.1 by Andrew Bennetts
Suppress unexpected errors during NotBranchError's call to open_repository.
679
    def test_not_branch_bzrdir_with_recursive_not_branch_error(self):
680
        class FakeBzrDir(object):
681
            def open_repository(self):
682
                # str() on the NotBranchError will trigger a call to this,
683
                # which in turn will another, identical NotBranchError.
684
                raise errors.NotBranchError('path', bzrdir=FakeBzrDir())
685
        err = errors.NotBranchError('path', bzrdir=FakeBzrDir())
686
        self.assertEqual('Not a branch: "path".', str(err))
687
4734.4.9 by Andrew Bennetts
More tests and comments.
688
    def test_not_branch_laziness(self):
689
        real_bzrdir = self.make_bzrdir('path')
690
        class FakeBzrDir(object):
691
            def __init__(self):
692
                self.calls = []
693
            def open_repository(self):
694
                self.calls.append('open_repository')
695
                raise errors.NoRepositoryPresent(real_bzrdir)
696
        fake_bzrdir = FakeBzrDir()
697
        err = errors.NotBranchError('path', bzrdir=fake_bzrdir)
698
        self.assertEqual([], fake_bzrdir.calls)
699
        str(err)
700
        self.assertEqual(['open_repository'], fake_bzrdir.calls)
701
        # Stringifying twice doesn't try to open a repository twice.
702
        str(err)
703
        self.assertEqual(['open_repository'], fake_bzrdir.calls)
704
5339.1.1 by Parth Malwankar
fixes errors.InvalidPattern to work on Python2.5
705
    def test_invalid_pattern(self):
706
        error = errors.InvalidPattern('Bad pattern msg.')
707
        self.assertEqualDiff("Invalid pattern(s) found. Bad pattern msg.",
708
            str(error))
709
5050.7.6 by Parth Malwankar
fixed test name
710
    def test_recursive_bind(self):
5050.7.5 by Parth Malwankar
better error message for RecursiveBind
711
        error = errors.RecursiveBind('foo_bar_branch')
712
        msg = ('Branch "foo_bar_branch" appears to be bound to itself. '
713
            'Please use `bzr unbind` to fix.')
714
        self.assertEqualDiff(msg, str(error))
715
2116.3.1 by John Arbash Meinel
Cleanup error tests
716
2067.3.1 by Martin Pool
Clean up BzrNewError, other exception classes and users.
717
class PassThroughError(errors.BzrError):
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
718
2067.3.1 by Martin Pool
Clean up BzrNewError, other exception classes and users.
719
    _fmt = """Pass through %(foo)s and %(bar)s"""
2116.3.1 by John Arbash Meinel
Cleanup error tests
720
721
    def __init__(self, foo, bar):
2067.3.1 by Martin Pool
Clean up BzrNewError, other exception classes and users.
722
        errors.BzrError.__init__(self, foo=foo, bar=bar)
723
724
725
class ErrorWithBadFormat(errors.BzrError):
726
727
    _fmt = """One format specifier: %(thing)s"""
728
729
730
class ErrorWithNoFormat(errors.BzrError):
5131.2.6 by Martin
Fix more tests which were failing under -OO that had been missed earlier
731
    __doc__ = """This class has a docstring but no format string."""
2116.3.1 by John Arbash Meinel
Cleanup error tests
732
733
734
class TestErrorFormatting(TestCase):
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
735
2116.3.1 by John Arbash Meinel
Cleanup error tests
736
    def test_always_str(self):
737
        e = PassThroughError(u'\xb5', 'bar')
738
        self.assertIsInstance(e.__str__(), str)
739
        # In Python str(foo) *must* return a real byte string
740
        # not a Unicode string. The following line would raise a
741
        # Unicode error, because it tries to call str() on the string
742
        # returned from e.__str__(), and it has non ascii characters
743
        s = str(e)
744
        self.assertEqual('Pass through \xc2\xb5 and bar', s)
745
2067.3.1 by Martin Pool
Clean up BzrNewError, other exception classes and users.
746
    def test_missing_format_string(self):
747
        e = ErrorWithNoFormat(param='randomvalue')
2067.3.3 by Martin Pool
merge bzr.dev and reconcile several changes, also some test fixes
748
        s = self.callDeprecated(
749
                ['ErrorWithNoFormat uses its docstring as a format, it should use _fmt instead'],
750
                lambda x: str(x), e)
751
        ## s = str(e)
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
752
        self.assertEqual(s,
2067.3.3 by Martin Pool
merge bzr.dev and reconcile several changes, also some test fixes
753
                "This class has a docstring but no format string.")
2067.3.1 by Martin Pool
Clean up BzrNewError, other exception classes and users.
754
2116.3.1 by John Arbash Meinel
Cleanup error tests
755
    def test_mismatched_format_args(self):
756
        # Even though ErrorWithBadFormat's format string does not match the
757
        # arguments we constructing it with, we can still stringify an instance
758
        # of this exception. The resulting string will say its unprintable.
759
        e = ErrorWithBadFormat(not_thing='x')
760
        self.assertStartsWith(
2067.3.1 by Martin Pool
Clean up BzrNewError, other exception classes and users.
761
            str(e), 'Unprintable exception ErrorWithBadFormat')
4634.1.2 by Martin Pool
Add test for CannotBindAddress
762
763
    def test_cannot_bind_address(self):
5243.1.2 by Martin
Point launchpad links in comments at production server rather than edge
764
        # see <https://bugs.launchpad.net/bzr/+bug/286871>
4634.1.2 by Martin Pool
Add test for CannotBindAddress
765
        e = errors.CannotBindAddress('example.com', 22,
766
            socket.error(13, 'Permission denied'))
767
        self.assertContainsRe(str(e),
768
            r'Cannot bind address "example\.com:22":.*Permission denied')
4976.1.1 by Jelmer Vernooij
Add FileTimestampUnavailable exception.
769
770
    def test_file_timestamp_unavailable(self):            
771
        e = errors.FileTimestampUnavailable("/path/foo")
772
        self.assertEquals("The filestamp for /path/foo is not available.",
773
            str(e))
5186.2.6 by Martin Pool
Add formatting test for TransformRenameFailed
774
            
775
    def test_transform_rename_failed(self):
5186.2.7 by Martin Pool
Update other cases where transform detects failure to rename
776
        e = errors.TransformRenameFailed(u"from", u"to", "readonly file", 2)
5186.2.6 by Martin Pool
Add formatting test for TransformRenameFailed
777
        self.assertEquals(
778
            u"Failed to rename from to to: readonly file",
779
            str(e))