17
17
"""Tests for the Branch facility that are not interface tests.
19
For interface tests see tests/per_branch/*.py.
19
For interface tests see `tests/per_branch/*.py`.
21
21
For concrete class tests see this file, and for meta-branch tests
22
22
also see this file.
25
from StringIO import StringIO
25
from cStringIO import StringIO
27
27
from bzrlib import (
28
28
branch as _mod_branch,
35
from bzrlib.branch import (
39
BranchReferenceFormat,
44
_run_with_write_locked_target,
46
from bzrlib.bzrdir import (BzrDirMetaFormat1, BzrDirMeta1,
48
from bzrlib.errors import (NotBranchError,
51
UnsupportedFormatError,
54
from bzrlib.tests import TestCase, TestCaseWithTransport
55
from bzrlib.transport import get_transport
58
class TestDefaultFormat(TestCase):
39
class TestDefaultFormat(tests.TestCase):
60
41
def test_default_format(self):
61
42
# update this if you change the default branch format
62
self.assertIsInstance(BranchFormat.get_default_format(),
43
self.assertIsInstance(_mod_branch.format_registry.get_default(),
44
_mod_branch.BzrBranchFormat7)
65
46
def test_default_format_is_same_as_bzrdir_default(self):
66
47
# XXX: it might be nice if there was only one place the default was
67
48
# set, but at the moment that's not true -- mbp 20070814 --
68
49
# https://bugs.launchpad.net/bzr/+bug/132376
69
self.assertEqual(BranchFormat.get_default_format(),
70
BzrDirFormat.get_default_format().get_branch_format())
51
_mod_branch.format_registry.get_default(),
52
bzrdir.BzrDirFormat.get_default_format().get_branch_format())
72
54
def test_get_set_default_format(self):
73
55
# set the format and then set it back again
74
old_format = BranchFormat.get_default_format()
75
BranchFormat.set_default_format(SampleBranchFormat())
56
old_format = _mod_branch.format_registry.get_default()
57
_mod_branch.format_registry.set_default(SampleBranchFormat())
77
59
# the default branch format is used by the meta dir format
78
60
# which is not the default bzrdir format at this point
79
dir = BzrDirMetaFormat1().initialize('memory:///')
61
dir = bzrdir.BzrDirMetaFormat1().initialize('memory:///')
80
62
result = dir.create_branch()
81
63
self.assertEqual(result, 'A branch')
83
BranchFormat.set_default_format(old_format)
84
self.assertEqual(old_format, BranchFormat.get_default_format())
87
class TestBranchFormat5(TestCaseWithTransport):
65
_mod_branch.format_registry.set_default(old_format)
66
self.assertEqual(old_format,
67
_mod_branch.format_registry.get_default())
70
class TestBranchFormat5(tests.TestCaseWithTransport):
88
71
"""Tests specific to branch format 5"""
90
73
def test_branch_format_5_uses_lockdir(self):
91
74
url = self.get_url()
92
bzrdir = BzrDirMetaFormat1().initialize(url)
93
bzrdir.create_repository()
94
branch = bzrdir.create_branch()
75
bdir = bzrdir.BzrDirMetaFormat1().initialize(url)
76
bdir.create_repository()
77
branch = _mod_branch.BzrBranchFormat5().initialize(bdir)
95
78
t = self.get_transport()
96
79
self.log("branch instance is %r" % branch)
97
self.assert_(isinstance(branch, BzrBranch5))
80
self.assert_(isinstance(branch, _mod_branch.BzrBranch5))
98
81
self.assertIsDirectory('.', t)
99
82
self.assertIsDirectory('.bzr/branch', t)
100
83
self.assertIsDirectory('.bzr/branch/lock', t)
101
84
branch.lock_write()
103
self.assertIsDirectory('.bzr/branch/lock/held', t)
85
self.addCleanup(branch.unlock)
86
self.assertIsDirectory('.bzr/branch/lock/held', t)
107
88
def test_set_push_location(self):
108
from bzrlib.config import (locations_config_filename,
109
ensure_config_dir_exists)
110
ensure_config_dir_exists()
111
fn = locations_config_filename()
112
# write correct newlines to locations.conf
113
# by default ConfigObj uses native line-endings for new files
114
# but uses already existing line-endings if file is not empty
117
f.write('# comment\n')
89
conf = config.LocationConfig.from_string('# comment\n', '.', save=True)
121
91
branch = self.make_branch('.', format='knit')
122
92
branch.set_push_location('foo')
142
112
"""See BzrBranchFormat.get_format_string()."""
143
113
return "Sample branch format."
145
def initialize(self, a_bzrdir):
115
def initialize(self, a_bzrdir, name=None, repository=None,
116
append_revisions_only=None):
146
117
"""Format 4 branches cannot be created."""
147
t = a_bzrdir.get_branch_transport(self)
118
t = a_bzrdir.get_branch_transport(self, name=name)
148
119
t.put_bytes('format', self.get_format_string())
149
120
return 'A branch'
151
122
def is_supported(self):
154
def open(self, transport, _found=False, ignore_fallbacks=False):
125
def open(self, transport, name=None, _found=False, ignore_fallbacks=False):
155
126
return "opened branch."
158
class TestBzrBranchFormat(TestCaseWithTransport):
129
# Demonstrating how lazy loading is often implemented:
130
# A constant string is created.
131
SampleSupportedBranchFormatString = "Sample supported branch format."
133
# And the format class can then reference the constant to avoid skew.
134
class SampleSupportedBranchFormat(_mod_branch.BranchFormat):
135
"""A sample supported format."""
137
def get_format_string(self):
138
"""See BzrBranchFormat.get_format_string()."""
139
return SampleSupportedBranchFormatString
141
def initialize(self, a_bzrdir, name=None, append_revisions_only=None):
142
t = a_bzrdir.get_branch_transport(self, name=name)
143
t.put_bytes('format', self.get_format_string())
146
def open(self, transport, name=None, _found=False, ignore_fallbacks=False):
147
return "opened supported branch."
150
class SampleExtraBranchFormat(_mod_branch.BranchFormat):
151
"""A sample format that is not usable in a metadir."""
153
def get_format_string(self):
154
# This format is not usable in a metadir.
157
def network_name(self):
158
# Network name always has to be provided.
161
def initialize(self, a_bzrdir, name=None):
162
raise NotImplementedError(self.initialize)
164
def open(self, transport, name=None, _found=False, ignore_fallbacks=False):
165
raise NotImplementedError(self.open)
168
class TestBzrBranchFormat(tests.TestCaseWithTransport):
159
169
"""Tests for the BzrBranchFormat facility."""
161
171
def test_find_format(self):
167
177
dir = format._matchingbzrdir.initialize(url)
168
178
dir.create_repository()
169
179
format.initialize(dir)
170
found_format = BranchFormat.find_format(dir)
171
self.failUnless(isinstance(found_format, format.__class__))
172
check_format(BzrBranchFormat5(), "bar")
180
found_format = _mod_branch.BranchFormat.find_format(dir)
181
self.assertIsInstance(found_format, format.__class__)
182
check_format(_mod_branch.BzrBranchFormat5(), "bar")
184
def test_find_format_factory(self):
185
dir = bzrdir.BzrDirMetaFormat1().initialize(self.get_url())
186
SampleSupportedBranchFormat().initialize(dir)
187
factory = _mod_branch.MetaDirBranchFormatFactory(
188
SampleSupportedBranchFormatString,
189
"bzrlib.tests.test_branch", "SampleSupportedBranchFormat")
190
_mod_branch.format_registry.register(factory)
191
self.addCleanup(_mod_branch.format_registry.remove, factory)
192
b = _mod_branch.Branch.open(self.get_url())
193
self.assertEqual(b, "opened supported branch.")
174
195
def test_find_format_not_branch(self):
175
196
dir = bzrdir.BzrDirMetaFormat1().initialize(self.get_url())
176
self.assertRaises(NotBranchError,
177
BranchFormat.find_format,
197
self.assertRaises(errors.NotBranchError,
198
_mod_branch.BranchFormat.find_format,
180
201
def test_find_format_unknown_format(self):
181
202
dir = bzrdir.BzrDirMetaFormat1().initialize(self.get_url())
182
203
SampleBranchFormat().initialize(dir)
183
self.assertRaises(UnknownFormatError,
184
BranchFormat.find_format,
204
self.assertRaises(errors.UnknownFormatError,
205
_mod_branch.BranchFormat.find_format,
187
208
def test_register_unregister_format(self):
209
# Test the deprecated format registration functions
188
210
format = SampleBranchFormat()
189
211
# make a control dir
190
212
dir = bzrdir.BzrDirMetaFormat1().initialize(self.get_url())
192
214
format.initialize(dir)
193
215
# register a format for it.
194
BranchFormat.register_format(format)
216
self.applyDeprecated(symbol_versioning.deprecated_in((2, 4, 0)),
217
_mod_branch.BranchFormat.register_format, format)
195
218
# which branch.Open will refuse (not supported)
196
self.assertRaises(UnsupportedFormatError, Branch.open, self.get_url())
219
self.assertRaises(errors.UnsupportedFormatError,
220
_mod_branch.Branch.open, self.get_url())
197
221
self.make_branch_and_tree('foo')
198
222
# but open_downlevel will work
199
self.assertEqual(format.open(dir), bzrdir.BzrDir.open(self.get_url()).open_branch(unsupported=True))
225
bzrdir.BzrDir.open(self.get_url()).open_branch(unsupported=True))
200
226
# unregister the format
201
BranchFormat.unregister_format(format)
227
self.applyDeprecated(symbol_versioning.deprecated_in((2, 4, 0)),
228
_mod_branch.BranchFormat.unregister_format, format)
202
229
self.make_branch_and_tree('bar')
232
class TestBranchFormatRegistry(tests.TestCase):
235
super(TestBranchFormatRegistry, self).setUp()
236
self.registry = _mod_branch.BranchFormatRegistry()
238
def test_default(self):
239
self.assertIs(None, self.registry.get_default())
240
format = SampleBranchFormat()
241
self.registry.set_default(format)
242
self.assertEquals(format, self.registry.get_default())
244
def test_register_unregister_format(self):
245
format = SampleBranchFormat()
246
self.registry.register(format)
247
self.assertEquals(format,
248
self.registry.get("Sample branch format."))
249
self.registry.remove(format)
250
self.assertRaises(KeyError, self.registry.get,
251
"Sample branch format.")
253
def test_get_all(self):
254
format = SampleBranchFormat()
255
self.assertEquals([], self.registry._get_all())
256
self.registry.register(format)
257
self.assertEquals([format], self.registry._get_all())
259
def test_register_extra(self):
260
format = SampleExtraBranchFormat()
261
self.assertEquals([], self.registry._get_all())
262
self.registry.register_extra(format)
263
self.assertEquals([format], self.registry._get_all())
265
def test_register_extra_lazy(self):
266
self.assertEquals([], self.registry._get_all())
267
self.registry.register_extra_lazy("bzrlib.tests.test_branch",
268
"SampleExtraBranchFormat")
269
formats = self.registry._get_all()
270
self.assertEquals(1, len(formats))
271
self.assertIsInstance(formats[0], SampleExtraBranchFormat)
274
#Used by TestMetaDirBranchFormatFactory
275
FakeLazyFormat = None
278
class TestMetaDirBranchFormatFactory(tests.TestCase):
280
def test_get_format_string_does_not_load(self):
281
"""Formats have a static format string."""
282
factory = _mod_branch.MetaDirBranchFormatFactory("yo", None, None)
283
self.assertEqual("yo", factory.get_format_string())
285
def test_call_loads(self):
286
# __call__ is used by the network_format_registry interface to get a
288
global FakeLazyFormat
290
factory = _mod_branch.MetaDirBranchFormatFactory(None,
291
"bzrlib.tests.test_branch", "FakeLazyFormat")
292
self.assertRaises(AttributeError, factory)
294
def test_call_returns_call_of_referenced_object(self):
295
global FakeLazyFormat
296
FakeLazyFormat = lambda:'called'
297
factory = _mod_branch.MetaDirBranchFormatFactory(None,
298
"bzrlib.tests.test_branch", "FakeLazyFormat")
299
self.assertEqual('called', factory())
205
302
class TestBranch67(object):
206
303
"""Common tests for both branch 6 and 7 which are mostly the same."""
227
324
def test_layout(self):
228
325
branch = self.make_branch('a', format=self.get_format_name())
229
self.failUnlessExists('a/.bzr/branch/last-revision')
230
self.failIfExists('a/.bzr/branch/revision-history')
231
self.failIfExists('a/.bzr/branch/references')
326
self.assertPathExists('a/.bzr/branch/last-revision')
327
self.assertPathDoesNotExist('a/.bzr/branch/revision-history')
328
self.assertPathDoesNotExist('a/.bzr/branch/references')
233
330
def test_config(self):
234
331
"""Ensure that all configuration data is stored in the branch"""
235
332
branch = self.make_branch('a', format=self.get_format_name())
236
branch.set_parent('http://bazaar-vcs.org')
237
self.failIfExists('a/.bzr/branch/parent')
238
self.assertEqual('http://bazaar-vcs.org', branch.get_parent())
239
branch.set_push_location('sftp://bazaar-vcs.org')
333
branch.set_parent('http://example.com')
334
self.assertPathDoesNotExist('a/.bzr/branch/parent')
335
self.assertEqual('http://example.com', branch.get_parent())
336
branch.set_push_location('sftp://example.com')
240
337
config = branch.get_config()._get_branch_data_config()
241
self.assertEqual('sftp://bazaar-vcs.org',
338
self.assertEqual('sftp://example.com',
242
339
config.get_user_option('push_location'))
243
branch.set_bound_location('ftp://bazaar-vcs.org')
244
self.failIfExists('a/.bzr/branch/bound')
245
self.assertEqual('ftp://bazaar-vcs.org', branch.get_bound_location())
340
branch.set_bound_location('ftp://example.com')
341
self.assertPathDoesNotExist('a/.bzr/branch/bound')
342
self.assertEqual('ftp://example.com', branch.get_bound_location())
247
344
def test_set_revision_history(self):
248
345
builder = self.make_branch_builder('.', format=self.get_format_name())
435
536
branch.lock_write()
436
537
branch.set_reference_info('file-id', 'path2', 'location2')
438
doppelganger = Branch.open('branch')
539
doppelganger = _mod_branch.Branch.open('branch')
439
540
doppelganger.set_reference_info('file-id', 'path3', 'location3')
440
541
self.assertEqual(('path3', 'location3'),
441
542
branch.get_reference_info('file-id'))
443
class TestBranchReference(TestCaseWithTransport):
544
def _recordParentMapCalls(self, repo):
545
self._parent_map_calls = []
546
orig_get_parent_map = repo.revisions.get_parent_map
547
def get_parent_map(q):
549
self._parent_map_calls.extend([e[0] for e in q])
550
return orig_get_parent_map(q)
551
repo.revisions.get_parent_map = get_parent_map
554
class TestBranchReference(tests.TestCaseWithTransport):
444
555
"""Tests for the branch reference facility."""
446
557
def test_create_open_reference(self):
447
558
bzrdirformat = bzrdir.BzrDirMetaFormat1()
448
t = get_transport(self.get_url('.'))
559
t = self.get_transport()
450
561
dir = bzrdirformat.initialize(self.get_url('repo'))
451
562
dir.create_repository()
452
563
target_branch = dir.create_branch()
453
564
t.mkdir('branch')
454
565
branch_dir = bzrdirformat.initialize(self.get_url('branch'))
455
made_branch = BranchReferenceFormat().initialize(branch_dir, target_branch)
566
made_branch = _mod_branch.BranchReferenceFormat().initialize(
567
branch_dir, target_branch=target_branch)
456
568
self.assertEqual(made_branch.base, target_branch.base)
457
569
opened_branch = branch_dir.open_branch()
458
570
self.assertEqual(opened_branch.base, target_branch.base)
469
581
_mod_branch.BranchReferenceFormat().get_reference(checkout.bzrdir))
472
class TestHooks(TestCase):
584
class TestHooks(tests.TestCaseWithTransport):
474
586
def test_constructor(self):
475
587
"""Check that creating a BranchHooks instance has the right defaults."""
476
hooks = BranchHooks()
588
hooks = _mod_branch.BranchHooks()
477
589
self.assertTrue("set_rh" in hooks, "set_rh not in %s" % hooks)
478
590
self.assertTrue("post_push" in hooks, "post_push not in %s" % hooks)
479
591
self.assertTrue("post_commit" in hooks, "post_commit not in %s" % hooks)
480
592
self.assertTrue("pre_commit" in hooks, "pre_commit not in %s" % hooks)
481
593
self.assertTrue("post_pull" in hooks, "post_pull not in %s" % hooks)
482
self.assertTrue("post_uncommit" in hooks, "post_uncommit not in %s" % hooks)
594
self.assertTrue("post_uncommit" in hooks,
595
"post_uncommit not in %s" % hooks)
483
596
self.assertTrue("post_change_branch_tip" in hooks,
484
597
"post_change_branch_tip not in %s" % hooks)
598
self.assertTrue("post_branch_init" in hooks,
599
"post_branch_init not in %s" % hooks)
600
self.assertTrue("post_switch" in hooks,
601
"post_switch not in %s" % hooks)
486
603
def test_installed_hooks_are_BranchHooks(self):
487
604
"""The installed hooks object should be a BranchHooks."""
488
605
# the installed hooks are saved in self._preserved_hooks.
489
606
self.assertIsInstance(self._preserved_hooks[_mod_branch.Branch][1],
493
class TestPullResult(TestCase):
607
_mod_branch.BranchHooks)
609
def test_post_branch_init_hook(self):
611
_mod_branch.Branch.hooks.install_named_hook('post_branch_init',
613
self.assertLength(0, calls)
614
branch = self.make_branch('a')
615
self.assertLength(1, calls)
617
self.assertIsInstance(params, _mod_branch.BranchInitHookParams)
618
self.assertTrue(hasattr(params, 'bzrdir'))
619
self.assertTrue(hasattr(params, 'branch'))
621
def test_post_branch_init_hook_repr(self):
623
_mod_branch.Branch.hooks.install_named_hook('post_branch_init',
624
lambda params: param_reprs.append(repr(params)), None)
625
branch = self.make_branch('a')
626
self.assertLength(1, param_reprs)
627
param_repr = param_reprs[0]
628
self.assertStartsWith(param_repr, '<BranchInitHookParams of ')
630
def test_post_switch_hook(self):
631
from bzrlib import switch
633
_mod_branch.Branch.hooks.install_named_hook('post_switch',
635
tree = self.make_branch_and_tree('branch-1')
636
self.build_tree(['branch-1/file-1'])
639
to_branch = tree.bzrdir.sprout('branch-2').open_branch()
640
self.build_tree(['branch-1/file-2'])
642
tree.remove('file-1')
644
checkout = tree.branch.create_checkout('checkout')
645
self.assertLength(0, calls)
646
switch.switch(checkout.bzrdir, to_branch)
647
self.assertLength(1, calls)
649
self.assertIsInstance(params, _mod_branch.SwitchHookParams)
650
self.assertTrue(hasattr(params, 'to_branch'))
651
self.assertTrue(hasattr(params, 'revision_id'))
654
class TestBranchOptions(tests.TestCaseWithTransport):
657
super(TestBranchOptions, self).setUp()
658
self.branch = self.make_branch('.')
659
self.config = self.branch.get_config()
661
def check_append_revisions_only(self, expected_value, value=None):
662
"""Set append_revisions_only in config and check its interpretation."""
663
if value is not None:
664
self.config.set_user_option('append_revisions_only', value)
665
self.assertEqual(expected_value,
666
self.branch.get_append_revisions_only())
668
def test_valid_append_revisions_only(self):
669
self.assertEquals(None,
670
self.config.get_user_option('append_revisions_only'))
671
self.check_append_revisions_only(None)
672
self.check_append_revisions_only(False, 'False')
673
self.check_append_revisions_only(True, 'True')
674
# The following values will cause compatibility problems on projects
675
# using older bzr versions (<2.2) but are accepted
676
self.check_append_revisions_only(False, 'false')
677
self.check_append_revisions_only(True, 'true')
679
def test_invalid_append_revisions_only(self):
680
"""Ensure warning is noted on invalid settings"""
683
self.warnings.append(args[0] % args[1:])
684
self.overrideAttr(trace, 'warning', warning)
685
self.check_append_revisions_only(None, 'not-a-bool')
686
self.assertLength(1, self.warnings)
688
'Value "not-a-bool" is not a boolean for "append_revisions_only"',
692
class TestPullResult(tests.TestCase):
495
694
def test_pull_result_to_int(self):
496
695
# to support old code, the pull result can be used as an int
696
r = _mod_branch.PullResult()
500
699
# this usage of results is not recommended for new code (because it
501
700
# doesn't describe very well what happened), but for api stability
502
701
# it's still supported
503
a = "%d revisions pulled" % r
504
self.assertEqual(a, "10 revisions pulled")
508
class _StubLockable(object):
509
"""Helper for TestRunWithWriteLockedTarget."""
511
def __init__(self, calls, unlock_exc=None):
513
self.unlock_exc = unlock_exc
515
def lock_write(self):
516
self.calls.append('lock_write')
519
self.calls.append('unlock')
520
if self.unlock_exc is not None:
521
raise self.unlock_exc
524
class _ErrorFromCallable(Exception):
525
"""Helper for TestRunWithWriteLockedTarget."""
528
class _ErrorFromUnlock(Exception):
529
"""Helper for TestRunWithWriteLockedTarget."""
532
class TestRunWithWriteLockedTarget(TestCase):
533
"""Tests for _run_with_write_locked_target."""
539
def func_that_returns_ok(self):
540
self._calls.append('func called')
543
def func_that_raises(self):
544
self._calls.append('func called')
545
raise _ErrorFromCallable()
547
def test_success_unlocks(self):
548
lockable = _StubLockable(self._calls)
549
result = _run_with_write_locked_target(
550
lockable, self.func_that_returns_ok)
551
self.assertEqual('ok', result)
552
self.assertEqual(['lock_write', 'func called', 'unlock'], self._calls)
554
def test_exception_unlocks_and_propagates(self):
555
lockable = _StubLockable(self._calls)
556
self.assertRaises(_ErrorFromCallable,
557
_run_with_write_locked_target, lockable, self.func_that_raises)
558
self.assertEqual(['lock_write', 'func called', 'unlock'], self._calls)
560
def test_callable_succeeds_but_error_during_unlock(self):
561
lockable = _StubLockable(self._calls, unlock_exc=_ErrorFromUnlock())
562
self.assertRaises(_ErrorFromUnlock,
563
_run_with_write_locked_target, lockable, self.func_that_returns_ok)
564
self.assertEqual(['lock_write', 'func called', 'unlock'], self._calls)
566
def test_error_during_unlock_does_not_mask_original_error(self):
567
lockable = _StubLockable(self._calls, unlock_exc=_ErrorFromUnlock())
568
self.assertRaises(_ErrorFromCallable,
569
_run_with_write_locked_target, lockable, self.func_that_raises)
570
self.assertEqual(['lock_write', 'func called', 'unlock'], self._calls)
702
self.assertEqual(self.applyDeprecated(
703
symbol_versioning.deprecated_in((2, 3, 0)),
707
def test_report_changed(self):
708
r = _mod_branch.PullResult()
709
r.old_revid = "old-revid"
711
r.new_revid = "new-revid"
715
self.assertEqual("Now on revision 20.\n", f.getvalue())
717
def test_report_unchanged(self):
718
r = _mod_branch.PullResult()
719
r.old_revid = "same-revid"
720
r.new_revid = "same-revid"
723
self.assertEqual("No revisions or tags to pull.\n", f.getvalue())