14
13
# You should have received a copy of the GNU General Public License
15
14
# along with this program; if not, write to the Free Software
16
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18
17
"""Tests for the formatting and construction of errors."""
20
import bzrlib.bzrdir as bzrdir
21
import bzrlib.errors as errors
22
from bzrlib.tests import TestCaseWithTransport
30
from bzrlib.tests import (
32
TestCaseWithTransport,
25
37
class TestErrors(TestCaseWithTransport):
39
def test_no_arg_named_message(self):
40
"""Ensure the __init__ and _fmt in errors do not have "message" arg.
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.
47
fmt_pattern = re.compile("%\(message\)[sir]")
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.')
52
for c in errors.BzrError.__subclasses__():
53
init = getattr(c, '__init__', None)
54
fmt = getattr(c, '_fmt', None)
56
args = inspect.getargspec(init)[0]
57
self.assertFalse('message' in args,
58
('Argument name "message" not allowed for '
59
'"errors.%s.__init__"' % c.__name__))
60
if fmt and fmt_pattern.search(fmt):
61
self.assertFalse(True, ('"message" not allowed in '
62
'"errors.%s._fmt"' % c.__name__))
64
def test_bad_filename_encoding(self):
65
error = errors.BadFilenameEncoding('bad/filen\xe5me', 'UTF-8')
67
"Filename 'bad/filen\\xe5me' is not valid in your current"
68
" filesystem encoding UTF-8",
71
def test_corrupt_dirstate(self):
72
error = errors.CorruptDirstate('path/to/dirstate', 'the reason why')
74
"Inconsistency in dirstate file path/to/dirstate.\n"
75
"Error: the reason why",
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\"",
85
def test_disabled_method(self):
86
error = errors.DisabledMethod("class name")
88
"The smart server method 'class name' is disabled.", str(error))
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))
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.',
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}",
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)".',
113
def test_inconsistent_delta(self):
114
error = errors.InconsistentDelta('path', 'file-id', 'reason for foo')
115
self.assertEqualDiff(
116
"An inconsistent delta was supplied involving 'path', 'file-id'\n"
117
"reason: reason for foo",
120
def test_inconsistent_delta_delta(self):
121
error = errors.InconsistentDeltaDelta([], 'reason')
122
self.assertEqualDiff(
123
"An inconsistent delta was supplied: []\nreason: reason",
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.",
132
def test_invalid_http_range(self):
133
error = errors.InvalidHttpRange('path',
134
'Content-Range: potatoes 0-00/o0oo0',
136
self.assertEquals("Invalid http range"
137
" 'Content-Range: potatoes 0-00/o0oo0'"
138
" for path: bad range",
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",
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.",
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'.",
159
def test_lock_active(self):
160
error = errors.LockActive("lock description")
161
self.assertEqualDiff("The lock for 'lock description' is in use and "
165
def test_lock_corrupt(self):
166
error = errors.LockCorrupt("corruption info")
167
self.assertEqualDiff("Lock is apparently held, but corrupted: "
169
"Use 'bzr break-lock' to clear it",
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))
179
def test_knit_data_stream_unknown(self):
180
error = errors.KnitDataStreamUnknown(
182
self.assertEqual('Cannot parse knit data stream of format '
183
'"stream format".', str(error))
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"
188
" for file \"path/to/file\".", str(error))
190
def test_knit_index_unknown_method(self):
191
error = errors.KnitIndexUnknownMethod('http://host/foo.kndx',
193
self.assertEqual("Knit index http://host/foo.kndx does not have a"
194
" known method in options: ['bad', 'no-eol']",
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))
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))
27
209
def test_no_repo(self):
28
210
dir = bzrdir.BzrDir.create(self.get_url())
29
211
error = errors.NoRepositoryPresent(dir)
30
self.assertNotEqual(-1, str(error).find(repr(dir.transport.clone('..').base)))
31
self.assertEqual(-1, str(error).find(repr(dir.transport.base)))
212
self.assertNotEqual(-1, str(error).find((dir.transport.clone('..').base)))
213
self.assertEqual(-1, str(error).find((dir.transport.base)))
215
def test_no_smart_medium(self):
216
error = errors.NoSmartMedium("a transport")
217
self.assertEqualDiff("The transport 'a transport' cannot tunnel the "
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.",
227
def test_no_such_id(self):
228
error = errors.NoSuchId("atree", "anid")
229
self.assertEqualDiff("The file id \"anid\" is not present in the tree "
233
def test_no_such_revision_in_tree(self):
234
error = errors.NoSuchRevisionInTree("atree", "anid")
235
self.assertEqualDiff("The revision id {anid} is not present in the"
236
" tree atree.", str(error))
237
self.assertIsInstance(error, errors.NoSuchRevision)
239
def test_not_stacked(self):
240
error = errors.NotStacked('a branch')
241
self.assertEqualDiff("The branch 'a branch' is not stacked.",
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 "
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",
254
self.assertFalse(error.internal_error)
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 "
260
"the currently open request.",
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'.",
269
def test_unknown_hook(self):
270
error = errors.UnknownHook("branch", "foo")
271
self.assertEqualDiff("The branch hook 'foo' is unknown in this version"
274
error = errors.UnknownHook("tree", "bar")
275
self.assertEqualDiff("The tree hook 'bar' is unknown in this version"
279
def test_unstackable_branch_format(self):
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.",
288
def test_unstackable_location(self):
289
error = errors.UnstackableLocationError('foo', 'bar')
290
self.assertEqualDiff("The branch 'foo' cannot be stacked on 'bar'.",
293
def test_unstackable_repository_format(self):
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.",
33
302
def test_up_to_date(self):
34
error = errors.UpToDateFormat(bzrdir.BzrDirFormat4())
35
self.assertEqualDiff("The branch format Bazaar-NG branch, "
36
"format 0.0.4 is already at the most "
303
error = errors.UpToDateFormat("someformat")
304
self.assertEqualDiff(
305
"The branch format someformat is already at the most "
306
"recent format.", str(error))
40
308
def test_corrupt_repository(self):
41
309
repo = self.make_repository('.')
44
312
"Please run bzr reconcile on this repository." %
45
313
repo.bzrdir.root_transport.base,
316
def test_read_error(self):
317
# a unicode path to check that %r is being used.
319
error = errors.ReadError(path)
320
self.assertEqualDiff("Error reading from u'a path'.", str(error))
322
def test_bad_index_format_signature(self):
323
error = errors.BadIndexFormatSignature("foo", "bar")
324
self.assertEqual("foo is not an index of type bar.",
327
def test_bad_index_data(self):
328
error = errors.BadIndexData("foo")
329
self.assertEqual("Error in data for index foo.",
332
def test_bad_index_duplicate_key(self):
333
error = errors.BadIndexDuplicateKey("foo", "bar")
334
self.assertEqual("The key 'foo' is already in index 'bar'.",
337
def test_bad_index_key(self):
338
error = errors.BadIndexKey("foo")
339
self.assertEqual("The key 'foo' is not a valid key.",
342
def test_bad_index_options(self):
343
error = errors.BadIndexOptions("foo")
344
self.assertEqual("Could not parse options for index foo.",
347
def test_bad_index_value(self):
348
error = errors.BadIndexValue("foo")
349
self.assertEqual("The value 'foo' is not a valid value.",
352
def test_bzrnewerror_is_deprecated(self):
353
class DeprecatedError(errors.BzrNewError):
355
self.callDeprecated(['BzrNewError was deprecated in bzr 0.13; '
356
'please convert DeprecatedError to use BzrError instead'],
359
def test_bzrerror_from_literal_string(self):
360
# Some code constructs BzrError from a literal string, in which case
361
# no further formatting is done. (I'm not sure raising the base class
362
# is a great idea, but if the exception is not intended to be caught
363
# perhaps no more is needed.)
365
raise errors.BzrError('this is my errors; %d is not expanded')
366
except errors.BzrError, e:
367
self.assertEqual('this is my errors; %d is not expanded', str(e))
369
def test_reading_completed(self):
370
error = errors.ReadingCompleted("a request")
371
self.assertEqualDiff("The MediumRequest 'a request' has already had "
372
"finish_reading called upon it - the request has been completed and"
373
" no more data may be read.",
376
def test_writing_completed(self):
377
error = errors.WritingCompleted("a request")
378
self.assertEqualDiff("The MediumRequest 'a request' has already had "
379
"finish_writing called upon it - accept bytes may not be called "
383
def test_writing_not_completed(self):
384
error = errors.WritingNotComplete("a request")
385
self.assertEqualDiff("The MediumRequest 'a request' has not has "
386
"finish_writing called upon it - until the write phase is complete"
387
" no data may be read.",
390
def test_transport_not_possible(self):
391
error = errors.TransportNotPossible('readonly', 'original error')
392
self.assertEqualDiff('Transport operation not possible:'
393
' readonly original error', str(error))
395
def assertSocketConnectionError(self, expected, *args, **kwargs):
396
"""Check the formatting of a SocketConnectionError exception"""
397
e = errors.SocketConnectionError(*args, **kwargs)
398
self.assertEqual(expected, str(e))
400
def test_socket_connection_error(self):
401
"""Test the formatting of SocketConnectionError"""
403
# There should be a default msg about failing to connect
404
# we only require a host name.
405
self.assertSocketConnectionError(
406
'Failed to connect to ahost',
409
# If port is None, we don't put :None
410
self.assertSocketConnectionError(
411
'Failed to connect to ahost',
413
# But if port is supplied we include it
414
self.assertSocketConnectionError(
415
'Failed to connect to ahost:22',
418
# We can also supply extra information about the error
419
# with or without a port
420
self.assertSocketConnectionError(
421
'Failed to connect to ahost:22; bogus error',
422
'ahost', port=22, orig_error='bogus error')
423
self.assertSocketConnectionError(
424
'Failed to connect to ahost; bogus error',
425
'ahost', orig_error='bogus error')
426
# An exception object can be passed rather than a string
427
orig_error = ValueError('bad value')
428
self.assertSocketConnectionError(
429
'Failed to connect to ahost; %s' % (str(orig_error),),
430
host='ahost', orig_error=orig_error)
432
# And we can supply a custom failure message
433
self.assertSocketConnectionError(
434
'Unable to connect to ssh host ahost:444; my_error',
435
host='ahost', port=444, msg='Unable to connect to ssh host',
436
orig_error='my_error')
438
def test_target_not_branch(self):
439
"""Test the formatting of TargetNotBranch."""
440
error = errors.TargetNotBranch('foo')
442
"Your branch does not have all of the revisions required in "
443
"order to merge this merge directive and the target "
444
"location specified in the merge directive is not a branch: "
447
def test_malformed_bug_identifier(self):
448
"""Test the formatting of MalformedBugIdentifier."""
449
error = errors.MalformedBugIdentifier('bogus', 'reason for bogosity')
451
'Did not understand bug identifier bogus: reason for bogosity. '
452
'See "bzr help bugs" for more information on this feature.',
455
def test_unknown_bug_tracker_abbreviation(self):
456
"""Test the formatting of UnknownBugTrackerAbbreviation."""
457
branch = self.make_branch('some_branch')
458
error = errors.UnknownBugTrackerAbbreviation('xxx', branch)
460
"Cannot find registered bug tracker called xxx on %s" % branch,
463
def test_unexpected_smart_server_response(self):
464
e = errors.UnexpectedSmartServerResponse(('not yes',))
466
"Could not understand response from smart server: ('not yes',)",
469
def test_unknown_container_format(self):
470
"""Test the formatting of UnknownContainerFormatError."""
471
e = errors.UnknownContainerFormatError('bad format string')
473
"Unrecognised container format: 'bad format string'",
476
def test_unexpected_end_of_container(self):
477
"""Test the formatting of UnexpectedEndOfContainerError."""
478
e = errors.UnexpectedEndOfContainerError()
480
"Unexpected end of container stream", str(e))
482
def test_unknown_record_type(self):
483
"""Test the formatting of UnknownRecordTypeError."""
484
e = errors.UnknownRecordTypeError("X")
486
"Unknown record type: 'X'",
489
def test_invalid_record(self):
490
"""Test the formatting of InvalidRecordError."""
491
e = errors.InvalidRecordError("xxx")
493
"Invalid record: xxx",
496
def test_container_has_excess_data(self):
497
"""Test the formatting of ContainerHasExcessDataError."""
498
e = errors.ContainerHasExcessDataError("excess bytes")
500
"Container has data after end marker: 'excess bytes'",
503
def test_duplicate_record_name_error(self):
504
"""Test the formatting of DuplicateRecordNameError."""
505
e = errors.DuplicateRecordNameError(u"n\xe5me".encode('utf-8'))
507
"Container has multiple records with the same name: n\xc3\xa5me",
510
def test_check_error(self):
511
# This has a member called 'message', which is problematic in
512
# python2.5 because that is a slot on the base Exception class
513
e = errors.BzrCheckError('example check failure')
515
"Internal check failed: example check failure",
517
self.assertTrue(e.internal_error)
519
def test_repository_data_stream_error(self):
520
"""Test the formatting of RepositoryDataStreamError."""
521
e = errors.RepositoryDataStreamError(u"my reason")
523
"Corrupt or incompatible data stream: my reason", str(e))
525
def test_immortal_pending_deletion_message(self):
526
err = errors.ImmortalPendingDeletion('foo')
528
"Unable to delete transform temporary directory foo. "
529
"Please examine foo to see if it contains any files "
530
"you wish to keep, and delete it when you are done.",
533
def test_unable_create_symlink(self):
534
err = errors.UnableCreateSymlink()
536
"Unable to create symlink on this platform",
538
err = errors.UnableCreateSymlink(path=u'foo')
540
"Unable to create symlink 'foo' on this platform",
542
err = errors.UnableCreateSymlink(path=u'\xb5')
544
"Unable to create symlink u'\\xb5' on this platform",
547
def test_invalid_url_join(self):
548
"""Test the formatting of InvalidURLJoin."""
549
e = errors.InvalidURLJoin('Reason', 'base path', ('args',))
551
"Invalid URL join request: Reason: 'base path' + ('args',)",
554
def test_incorrect_url(self):
555
err = errors.InvalidBugTrackerURL('foo', 'http://bug.com/')
557
("The URL for bug tracker \"foo\" doesn't contain {id}: "
561
def test_unable_encode_path(self):
562
err = errors.UnableEncodePath('foo', 'executable')
563
self.assertEquals("Unable to encode executable path 'foo' in "
564
"user encoding " + osutils.get_user_encoding(),
567
def test_unknown_format(self):
568
err = errors.UnknownFormatError('bar', kind='foo')
569
self.assertEquals("Unknown foo format: 'bar'", str(err))
571
def test_unknown_rules(self):
572
err = errors.UnknownRules(['foo', 'bar'])
573
self.assertEquals("Unknown rules detected: foo, bar.", str(err))
575
def test_hook_failed(self):
576
# Create an exc_info tuple by raising and catching an exception.
579
except ZeroDivisionError:
580
err = errors.HookFailed('hook stage', 'hook name', sys.exc_info(),
582
# GZ 2010-11-08: Should not store exc_info in exception instances, but
583
# HookFailed is deprecated anyway and could maybe go.
585
self.assertStartsWith(
586
str(err), 'Hook \'hook name\' during hook stage failed:\n')
588
str(err), 'integer division or modulo by zero')
592
def test_tip_change_rejected(self):
593
err = errors.TipChangeRejected(u'Unicode message\N{INTERROBANG}')
595
u'Tip change rejected: Unicode message\N{INTERROBANG}',
598
'Tip change rejected: Unicode message\xe2\x80\xbd',
601
def test_error_from_smart_server(self):
602
error_tuple = ('error', 'tuple')
603
err = errors.ErrorFromSmartServer(error_tuple)
605
"Error received from smart server: ('error', 'tuple')", str(err))
607
def test_untranslateable_error_from_smart_server(self):
608
error_tuple = ('error', 'tuple')
609
orig_err = errors.ErrorFromSmartServer(error_tuple)
610
err = errors.UnknownErrorFromSmartServer(orig_err)
612
"Server sent an unexpected error: ('error', 'tuple')", str(err))
614
def test_smart_message_handler_error(self):
615
# Make an exc_info tuple.
617
raise Exception("example error")
619
err = errors.SmartMessageHandlerError(sys.exc_info())
620
# GZ 2010-11-08: Should not store exc_info in exception instances.
622
self.assertStartsWith(
623
str(err), "The message handler raised an exception:\n")
624
self.assertEndsWith(str(err), "Exception: example error\n")
628
def test_must_have_working_tree(self):
629
err = errors.MustHaveWorkingTree('foo', 'bar')
630
self.assertEqual(str(err), "Branching 'bar'(foo) must create a"
633
def test_no_such_view(self):
634
err = errors.NoSuchView('foo')
635
self.assertEquals("No such view: foo.", str(err))
637
def test_views_not_supported(self):
638
err = errors.ViewsNotSupported('atree')
640
self.assertStartsWith(err_str, "Views are not supported by ")
641
self.assertEndsWith(err_str, "; use 'bzr upgrade' to change your "
642
"tree to a later format.")
644
def test_file_outside_view(self):
645
err = errors.FileOutsideView('baz', ['foo', 'bar'])
646
self.assertEquals('Specified file "baz" is outside the current view: '
647
'foo, bar', str(err))
649
def test_invalid_shelf_id(self):
651
err = errors.InvalidShelfId(invalid_id)
652
self.assertEqual('"foo" is not a valid shelf id, '
653
'try a number instead.', str(err))
655
def test_unresumable_write_group(self):
657
wg_tokens = ['token']
659
err = errors.UnresumableWriteGroup(repo, wg_tokens, reason)
661
"Repository dummy repo cannot resume write group "
662
"['token']: a reason", str(err))
664
def test_unsuspendable_write_group(self):
666
err = errors.UnsuspendableWriteGroup(repo)
668
'Repository dummy repo cannot suspend a write group.', str(err))
670
def test_not_branch_no_args(self):
671
err = errors.NotBranchError('path')
672
self.assertEqual('Not a branch: "path".', str(err))
674
def test_not_branch_bzrdir_with_repo(self):
675
bzrdir = self.make_repository('repo').bzrdir
676
err = errors.NotBranchError('path', bzrdir=bzrdir)
678
'Not a branch: "path": location is a repository.', str(err))
680
def test_not_branch_bzrdir_without_repo(self):
681
bzrdir = self.make_bzrdir('bzrdir')
682
err = errors.NotBranchError('path', bzrdir=bzrdir)
683
self.assertEqual('Not a branch: "path".', str(err))
685
def test_not_branch_bzrdir_with_recursive_not_branch_error(self):
686
class FakeBzrDir(object):
687
def open_repository(self):
688
# str() on the NotBranchError will trigger a call to this,
689
# which in turn will another, identical NotBranchError.
690
raise errors.NotBranchError('path', bzrdir=FakeBzrDir())
691
err = errors.NotBranchError('path', bzrdir=FakeBzrDir())
692
self.assertEqual('Not a branch: "path".', str(err))
694
def test_not_branch_laziness(self):
695
real_bzrdir = self.make_bzrdir('path')
696
class FakeBzrDir(object):
699
def open_repository(self):
700
self.calls.append('open_repository')
701
raise errors.NoRepositoryPresent(real_bzrdir)
702
fake_bzrdir = FakeBzrDir()
703
err = errors.NotBranchError('path', bzrdir=fake_bzrdir)
704
self.assertEqual([], fake_bzrdir.calls)
706
self.assertEqual(['open_repository'], fake_bzrdir.calls)
707
# Stringifying twice doesn't try to open a repository twice.
709
self.assertEqual(['open_repository'], fake_bzrdir.calls)
711
def test_invalid_pattern(self):
712
error = errors.InvalidPattern('Bad pattern msg.')
713
self.assertEqualDiff("Invalid pattern(s) found. Bad pattern msg.",
716
def test_recursive_bind(self):
717
error = errors.RecursiveBind('foo_bar_branch')
718
msg = ('Branch "foo_bar_branch" appears to be bound to itself. '
719
'Please use `bzr unbind` to fix.')
720
self.assertEqualDiff(msg, str(error))
723
class PassThroughError(errors.BzrError):
725
_fmt = """Pass through %(foo)s and %(bar)s"""
727
def __init__(self, foo, bar):
728
errors.BzrError.__init__(self, foo=foo, bar=bar)
731
class ErrorWithBadFormat(errors.BzrError):
733
_fmt = """One format specifier: %(thing)s"""
736
class ErrorWithNoFormat(errors.BzrError):
737
__doc__ = """This class has a docstring but no format string."""
740
class TestErrorFormatting(TestCase):
742
def test_always_str(self):
743
e = PassThroughError(u'\xb5', 'bar')
744
self.assertIsInstance(e.__str__(), str)
745
# In Python str(foo) *must* return a real byte string
746
# not a Unicode string. The following line would raise a
747
# Unicode error, because it tries to call str() on the string
748
# returned from e.__str__(), and it has non ascii characters
750
self.assertEqual('Pass through \xc2\xb5 and bar', s)
752
def test_missing_format_string(self):
753
e = ErrorWithNoFormat(param='randomvalue')
754
s = self.callDeprecated(
755
['ErrorWithNoFormat uses its docstring as a format, it should use _fmt instead'],
759
"This class has a docstring but no format string.")
761
def test_mismatched_format_args(self):
762
# Even though ErrorWithBadFormat's format string does not match the
763
# arguments we constructing it with, we can still stringify an instance
764
# of this exception. The resulting string will say its unprintable.
765
e = ErrorWithBadFormat(not_thing='x')
766
self.assertStartsWith(
767
str(e), 'Unprintable exception ErrorWithBadFormat')
769
def test_cannot_bind_address(self):
770
# see <https://bugs.launchpad.net/bzr/+bug/286871>
771
e = errors.CannotBindAddress('example.com', 22,
772
socket.error(13, 'Permission denied'))
773
self.assertContainsRe(str(e),
774
r'Cannot bind address "example\.com:22":.*Permission denied')
776
def test_file_timestamp_unavailable(self):
777
e = errors.FileTimestampUnavailable("/path/foo")
778
self.assertEquals("The filestamp for /path/foo is not available.",
781
def test_transform_rename_failed(self):
782
e = errors.TransformRenameFailed(u"from", u"to", "readonly file", 2)
784
u"Failed to rename from to to: readonly file",