/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
2052.3.2 by John Arbash Meinel
Change Copyright .. by Canonical to Copyright ... Canonical
1
# Copyright (C) 2005 Canonical Ltd
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
2
#
3
# Authors:
4
#   Johan Rydberg <jrydberg@gnu.org>
5
#
6
# This program is free software; you can redistribute it and/or modify
7
# it under the terms of the GNU General Public License as published by
8
# the Free Software Foundation; either version 2 of the License, or
9
# (at your option) any later version.
1887.1.1 by Adeodato Simó
Do not separate paragraphs in the copyright statement with blank lines,
10
#
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
11
# This program is distributed in the hope that it will be useful,
12
# but WITHOUT ANY WARRANTY; without even the implied warranty of
13
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14
# GNU General Public License for more details.
1887.1.1 by Adeodato Simó
Do not separate paragraphs in the copyright statement with blank lines,
15
#
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
16
# You should have received a copy of the GNU General Public License
17
# along with this program; if not, write to the Free Software
18
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19
20
1704.2.15 by Martin Pool
Remove TODO about knit testing printed from test suite
21
# TODO: might be nice to create a versionedfile with some type of corruption
22
# considered typical and check that it can be detected/corrected.
23
1664.2.9 by Aaron Bentley
Ported weave merge test to versionedfile
24
from StringIO import StringIO
25
1563.2.6 by Robert Collins
Start check tests for knits (pending), and remove dead code.
26
import bzrlib
2039.1.1 by Aaron Bentley
Clean up progress properly when interrupted during fetch (#54000)
27
from bzrlib import (
28
    errors,
2309.4.7 by John Arbash Meinel
Update VersionedFile tests to ensure that they can take Unicode,
29
    osutils,
2039.1.1 by Aaron Bentley
Clean up progress properly when interrupted during fetch (#54000)
30
    progress,
31
    )
1563.2.11 by Robert Collins
Consolidate reweave and join as we have no separate usage, make reweave tests apply to all versionedfile implementations and deprecate the old reweave apis.
32
from bzrlib.errors import (
33
                           RevisionNotPresent, 
34
                           RevisionAlreadyPresent,
35
                           WeaveParentMismatch
36
                           )
1563.2.6 by Robert Collins
Start check tests for knits (pending), and remove dead code.
37
from bzrlib.knit import KnitVersionedFile, \
38
     KnitAnnotateFactory
1563.2.12 by Robert Collins
Checkpointing: created InterObject to factor out common inter object worker code, added InterVersionedFile and tests to allow making join work between any versionedfile.
39
from bzrlib.tests import TestCaseWithTransport
1666.1.1 by Robert Collins
Add trivial http-using test for versioned files.
40
from bzrlib.tests.HTTPTestUtil import TestCaseWithWebserver
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
41
from bzrlib.trace import mutter
1563.2.16 by Robert Collins
Change WeaveStore into VersionedFileStore and make its versoined file class parameterisable.
42
from bzrlib.transport import get_transport
1563.2.13 by Robert Collins
InterVersionedFile implemented.
43
from bzrlib.transport.memory import MemoryTransport
1684.3.1 by Robert Collins
Fix versioned file joins with empty targets.
44
from bzrlib.tsort import topo_sort
1563.2.12 by Robert Collins
Checkpointing: created InterObject to factor out common inter object worker code, added InterVersionedFile and tests to allow making join work between any versionedfile.
45
import bzrlib.versionedfile as versionedfile
1563.2.9 by Robert Collins
Update versionedfile api tests to ensure that data is available after every operation.
46
from bzrlib.weave import WeaveFile
1664.2.9 by Aaron Bentley
Ported weave merge test to versionedfile
47
from bzrlib.weavefile import read_weave, write_weave
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
48
49
50
class VersionedFileTestMixIn(object):
51
    """A mixin test class for testing VersionedFiles.
52
53
    This is not an adaptor-style test at this point because
54
    theres no dynamic substitution of versioned file implementations,
55
    they are strictly controlled by their owning repositories.
56
    """
57
58
    def test_add(self):
59
        f = self.get_file()
60
        f.add_lines('r0', [], ['a\n', 'b\n'])
61
        f.add_lines('r1', ['r0'], ['b\n', 'c\n'])
1563.2.9 by Robert Collins
Update versionedfile api tests to ensure that data is available after every operation.
62
        def verify_file(f):
63
            versions = f.versions()
64
            self.assertTrue('r0' in versions)
65
            self.assertTrue('r1' in versions)
66
            self.assertEquals(f.get_lines('r0'), ['a\n', 'b\n'])
67
            self.assertEquals(f.get_text('r0'), 'a\nb\n')
68
            self.assertEquals(f.get_lines('r1'), ['b\n', 'c\n'])
1563.2.18 by Robert Collins
get knit repositories really using knits for text storage.
69
            self.assertEqual(2, len(f))
70
            self.assertEqual(2, f.num_versions())
1563.2.9 by Robert Collins
Update versionedfile api tests to ensure that data is available after every operation.
71
    
72
            self.assertRaises(RevisionNotPresent,
73
                f.add_lines, 'r2', ['foo'], [])
74
            self.assertRaises(RevisionAlreadyPresent,
75
                f.add_lines, 'r1', [], [])
76
        verify_file(f)
1666.1.6 by Robert Collins
Make knit the default format.
77
        # this checks that reopen with create=True does not break anything.
78
        f = self.reopen_file(create=True)
1563.2.9 by Robert Collins
Update versionedfile api tests to ensure that data is available after every operation.
79
        verify_file(f)
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
80
1596.2.32 by Robert Collins
Reduce re-extraction of texts during weave to knit joins by providing a memoisation facility.
81
    def test_adds_with_parent_texts(self):
82
        f = self.get_file()
83
        parent_texts = {}
84
        parent_texts['r0'] = f.add_lines('r0', [], ['a\n', 'b\n'])
85
        try:
86
            parent_texts['r1'] = f.add_lines_with_ghosts('r1',
87
                                                         ['r0', 'ghost'], 
88
                                                         ['b\n', 'c\n'],
89
                                                         parent_texts=parent_texts)
90
        except NotImplementedError:
91
            # if the format doesn't support ghosts, just add normally.
92
            parent_texts['r1'] = f.add_lines('r1',
93
                                             ['r0'], 
94
                                             ['b\n', 'c\n'],
95
                                             parent_texts=parent_texts)
96
        f.add_lines('r2', ['r1'], ['c\n', 'd\n'], parent_texts=parent_texts)
97
        self.assertNotEqual(None, parent_texts['r0'])
98
        self.assertNotEqual(None, parent_texts['r1'])
99
        def verify_file(f):
100
            versions = f.versions()
101
            self.assertTrue('r0' in versions)
102
            self.assertTrue('r1' in versions)
103
            self.assertTrue('r2' in versions)
104
            self.assertEquals(f.get_lines('r0'), ['a\n', 'b\n'])
105
            self.assertEquals(f.get_lines('r1'), ['b\n', 'c\n'])
106
            self.assertEquals(f.get_lines('r2'), ['c\n', 'd\n'])
107
            self.assertEqual(3, f.num_versions())
108
            origins = f.annotate('r1')
109
            self.assertEquals(origins[0][0], 'r0')
110
            self.assertEquals(origins[1][0], 'r1')
111
            origins = f.annotate('r2')
112
            self.assertEquals(origins[0][0], 'r1')
113
            self.assertEquals(origins[1][0], 'r2')
114
115
        verify_file(f)
116
        f = self.reopen_file()
117
        verify_file(f)
118
1666.1.6 by Robert Collins
Make knit the default format.
119
    def test_add_unicode_content(self):
120
        # unicode content is not permitted in versioned files. 
121
        # versioned files version sequences of bytes only.
122
        vf = self.get_file()
123
        self.assertRaises(errors.BzrBadParameterUnicode,
124
            vf.add_lines, 'a', [], ['a\n', u'b\n', 'c\n'])
125
        self.assertRaises(
126
            (errors.BzrBadParameterUnicode, NotImplementedError),
127
            vf.add_lines_with_ghosts, 'a', [], ['a\n', u'b\n', 'c\n'])
128
129
    def test_inline_newline_throws(self):
130
        # \r characters are not permitted in lines being added
131
        vf = self.get_file()
132
        self.assertRaises(errors.BzrBadParameterContainsNewline, 
133
            vf.add_lines, 'a', [], ['a\n\n'])
134
        self.assertRaises(
135
            (errors.BzrBadParameterContainsNewline, NotImplementedError),
136
            vf.add_lines_with_ghosts, 'a', [], ['a\n\n'])
137
        # but inline CR's are allowed
138
        vf.add_lines('a', [], ['a\r\n'])
139
        try:
140
            vf.add_lines_with_ghosts('b', [], ['a\r\n'])
141
        except NotImplementedError:
142
            pass
143
2229.2.1 by Aaron Bentley
Reject reserved ids in versiondfile, tree, branch and repository
144
    def test_add_reserved(self):
145
        vf = self.get_file()
146
        self.assertRaises(errors.ReservedId,
147
            vf.add_lines, 'a:', [], ['a\n', 'b\n', 'c\n'])
148
149
        self.assertRaises(errors.ReservedId,
150
            vf.add_delta, 'a:', [], None, 'sha1', False, ((0, 0, 0, []),))
151
152
    def test_get_reserved(self):
153
        vf = self.get_file()
154
        self.assertRaises(errors.ReservedId, vf.get_delta, 'b:')
155
        self.assertRaises(errors.ReservedId, vf.get_texts, ['b:'])
156
        self.assertRaises(errors.ReservedId, vf.get_lines, 'b:')
157
        self.assertRaises(errors.ReservedId, vf.get_text, 'b:')
158
1596.2.37 by Robert Collins
Switch to delta based content copying in the generic versioned file copier.
159
    def test_get_delta(self):
1596.2.36 by Robert Collins
add a get_delta api to versioned_file.
160
        f = self.get_file()
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
161
        sha1s = self._setup_for_deltas(f)
162
        expected_delta = (None, '6bfa09d82ce3e898ad4641ae13dd4fdb9cf0d76b', False, 
163
                          [(0, 0, 1, [('base', 'line\n')])])
164
        self.assertEqual(expected_delta, f.get_delta('base'))
165
        next_parent = 'base'
166
        text_name = 'chain1-'
167
        for depth in range(26):
168
            new_version = text_name + '%s' % depth
169
            expected_delta = (next_parent, sha1s[depth], 
170
                              False,
171
                              [(depth + 1, depth + 1, 1, [(new_version, 'line\n')])])
172
            self.assertEqual(expected_delta, f.get_delta(new_version))
173
            next_parent = new_version
174
        next_parent = 'base'
175
        text_name = 'chain2-'
176
        for depth in range(26):
177
            new_version = text_name + '%s' % depth
178
            expected_delta = (next_parent, sha1s[depth], False,
179
                              [(depth + 1, depth + 1, 1, [(new_version, 'line\n')])])
180
            self.assertEqual(expected_delta, f.get_delta(new_version))
181
            next_parent = new_version
182
        # smoke test for eol support
183
        expected_delta = ('base', '264f39cab871e4cfd65b3a002f7255888bb5ed97', True, [])
184
        self.assertEqual(['line'], f.get_lines('noeol'))
185
        self.assertEqual(expected_delta, f.get_delta('noeol'))
186
187
    def test_get_deltas(self):
188
        f = self.get_file()
189
        sha1s = self._setup_for_deltas(f)
190
        deltas = f.get_deltas(f.versions())
191
        expected_delta = (None, '6bfa09d82ce3e898ad4641ae13dd4fdb9cf0d76b', False, 
192
                          [(0, 0, 1, [('base', 'line\n')])])
193
        self.assertEqual(expected_delta, deltas['base'])
194
        next_parent = 'base'
195
        text_name = 'chain1-'
196
        for depth in range(26):
197
            new_version = text_name + '%s' % depth
198
            expected_delta = (next_parent, sha1s[depth], 
199
                              False,
200
                              [(depth + 1, depth + 1, 1, [(new_version, 'line\n')])])
201
            self.assertEqual(expected_delta, deltas[new_version])
202
            next_parent = new_version
203
        next_parent = 'base'
204
        text_name = 'chain2-'
205
        for depth in range(26):
206
            new_version = text_name + '%s' % depth
207
            expected_delta = (next_parent, sha1s[depth], False,
208
                              [(depth + 1, depth + 1, 1, [(new_version, 'line\n')])])
209
            self.assertEqual(expected_delta, deltas[new_version])
210
            next_parent = new_version
211
        # smoke tests for eol support
212
        expected_delta = ('base', '264f39cab871e4cfd65b3a002f7255888bb5ed97', True, [])
213
        self.assertEqual(['line'], f.get_lines('noeol'))
214
        self.assertEqual(expected_delta, deltas['noeol'])
215
        # smoke tests for eol support - two noeol in a row same content
216
        expected_deltas = (('noeol', '3ad7ee82dbd8f29ecba073f96e43e414b3f70a4d', True, 
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
217
                          [(0, 1, 2, [('noeolsecond', 'line\n'), ('noeolsecond', 'line\n')])]),
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
218
                          ('noeol', '3ad7ee82dbd8f29ecba073f96e43e414b3f70a4d', True, 
219
                           [(0, 0, 1, [('noeolsecond', 'line\n')]), (1, 1, 0, [])]))
220
        self.assertEqual(['line\n', 'line'], f.get_lines('noeolsecond'))
221
        self.assertTrue(deltas['noeolsecond'] in expected_deltas)
222
        # two no-eol in a row, different content
223
        expected_delta = ('noeolsecond', '8bb553a84e019ef1149db082d65f3133b195223b', True, 
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
224
                          [(1, 2, 1, [('noeolnotshared', 'phone\n')])])
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
225
        self.assertEqual(['line\n', 'phone'], f.get_lines('noeolnotshared'))
226
        self.assertEqual(expected_delta, deltas['noeolnotshared'])
227
        # eol folling a no-eol with content change
228
        expected_delta = ('noeol', 'a61f6fb6cfc4596e8d88c34a308d1e724caf8977', False, 
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
229
                          [(0, 1, 1, [('eol', 'phone\n')])])
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
230
        self.assertEqual(['phone\n'], f.get_lines('eol'))
231
        self.assertEqual(expected_delta, deltas['eol'])
232
        # eol folling a no-eol with content change
233
        expected_delta = ('noeol', '6bfa09d82ce3e898ad4641ae13dd4fdb9cf0d76b', False, 
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
234
                          [(0, 1, 1, [('eolline', 'line\n')])])
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
235
        self.assertEqual(['line\n'], f.get_lines('eolline'))
236
        self.assertEqual(expected_delta, deltas['eolline'])
237
        # eol with no parents
238
        expected_delta = (None, '264f39cab871e4cfd65b3a002f7255888bb5ed97', True, 
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
239
                          [(0, 0, 1, [('noeolbase', 'line\n')])])
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
240
        self.assertEqual(['line'], f.get_lines('noeolbase'))
241
        self.assertEqual(expected_delta, deltas['noeolbase'])
242
        # eol with two parents, in inverse insertion order
243
        expected_deltas = (('noeolbase', '264f39cab871e4cfd65b3a002f7255888bb5ed97', True,
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
244
                            [(0, 1, 1, [('eolbeforefirstparent', 'line\n')])]),
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
245
                           ('noeolbase', '264f39cab871e4cfd65b3a002f7255888bb5ed97', True,
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
246
                            [(0, 1, 1, [('eolbeforefirstparent', 'line\n')])]))
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
247
        self.assertEqual(['line'], f.get_lines('eolbeforefirstparent'))
248
        #self.assertTrue(deltas['eolbeforefirstparent'] in expected_deltas)
249
2520.4.85 by Aaron Bentley
Get all test passing (which just proves there aren't enough tests!)
250
    def test_make_mpdiffs(self):
2520.4.3 by Aaron Bentley
Implement plain strategy for extracting and installing multiparent diffs
251
        from bzrlib import multiparent
252
        vf = self.get_file('foo')
253
        sha1s = self._setup_for_deltas(vf)
254
        new_vf = self.get_file('bar')
255
        for version in multiparent.topo_iter(vf):
2520.4.85 by Aaron Bentley
Get all test passing (which just proves there aren't enough tests!)
256
            mpdiff = vf.make_mpdiffs([version])[0]
257
            new_vf.add_mpdiffs([(version, vf.get_parents(version),
258
                                 vf.get_sha1(version), mpdiff)])
2520.4.3 by Aaron Bentley
Implement plain strategy for extracting and installing multiparent diffs
259
            self.assertEqualDiff(vf.get_text(version),
260
                                 new_vf.get_text(version))
261
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
262
    def _setup_for_deltas(self, f):
1596.2.36 by Robert Collins
add a get_delta api to versioned_file.
263
        self.assertRaises(errors.RevisionNotPresent, f.get_delta, 'base')
264
        # add texts that should trip the knit maximum delta chain threshold
265
        # as well as doing parallel chains of data in knits.
266
        # this is done by two chains of 25 insertions
267
        f.add_lines('base', [], ['line\n'])
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
268
        f.add_lines('noeol', ['base'], ['line'])
269
        # detailed eol tests:
270
        # shared last line with parent no-eol
271
        f.add_lines('noeolsecond', ['noeol'], ['line\n', 'line'])
272
        # differing last line with parent, both no-eol
273
        f.add_lines('noeolnotshared', ['noeolsecond'], ['line\n', 'phone'])
274
        # add eol following a noneol parent, change content
275
        f.add_lines('eol', ['noeol'], ['phone\n'])
276
        # add eol following a noneol parent, no change content
277
        f.add_lines('eolline', ['noeol'], ['line\n'])
278
        # noeol with no parents:
279
        f.add_lines('noeolbase', [], ['line'])
280
        # noeol preceeding its leftmost parent in the output:
281
        # this is done by making it a merge of two parents with no common
282
        # anestry: noeolbase and noeol with the 
283
        # later-inserted parent the leftmost.
284
        f.add_lines('eolbeforefirstparent', ['noeolbase', 'noeol'], ['line'])
285
        # two identical eol texts
286
        f.add_lines('noeoldup', ['noeol'], ['line'])
1596.2.36 by Robert Collins
add a get_delta api to versioned_file.
287
        next_parent = 'base'
288
        text_name = 'chain1-'
289
        text = ['line\n']
290
        sha1s = {0 :'da6d3141cb4a5e6f464bf6e0518042ddc7bfd079',
291
                 1 :'45e21ea146a81ea44a821737acdb4f9791c8abe7',
292
                 2 :'e1f11570edf3e2a070052366c582837a4fe4e9fa',
293
                 3 :'26b4b8626da827088c514b8f9bbe4ebf181edda1',
294
                 4 :'e28a5510be25ba84d31121cff00956f9970ae6f6',
295
                 5 :'d63ec0ce22e11dcf65a931b69255d3ac747a318d',
296
                 6 :'2c2888d288cb5e1d98009d822fedfe6019c6a4ea',
297
                 7 :'95c14da9cafbf828e3e74a6f016d87926ba234ab',
298
                 8 :'779e9a0b28f9f832528d4b21e17e168c67697272',
299
                 9 :'1f8ff4e5c6ff78ac106fcfe6b1e8cb8740ff9a8f',
300
                 10:'131a2ae712cf51ed62f143e3fbac3d4206c25a05',
301
                 11:'c5a9d6f520d2515e1ec401a8f8a67e6c3c89f199',
302
                 12:'31a2286267f24d8bedaa43355f8ad7129509ea85',
303
                 13:'dc2a7fe80e8ec5cae920973973a8ee28b2da5e0a',
304
                 14:'2c4b1736566b8ca6051e668de68650686a3922f2',
305
                 15:'5912e4ecd9b0c07be4d013e7e2bdcf9323276cde',
306
                 16:'b0d2e18d3559a00580f6b49804c23fea500feab3',
307
                 17:'8e1d43ad72f7562d7cb8f57ee584e20eb1a69fc7',
308
                 18:'5cf64a3459ae28efa60239e44b20312d25b253f3',
309
                 19:'1ebed371807ba5935958ad0884595126e8c4e823',
310
                 20:'2aa62a8b06fb3b3b892a3292a068ade69d5ee0d3',
311
                 21:'01edc447978004f6e4e962b417a4ae1955b6fe5d',
312
                 22:'d8d8dc49c4bf0bab401e0298bb5ad827768618bb',
313
                 23:'c21f62b1c482862983a8ffb2b0c64b3451876e3f',
314
                 24:'c0593fe795e00dff6b3c0fe857a074364d5f04fc',
315
                 25:'dd1a1cf2ba9cc225c3aff729953e6364bf1d1855',
316
                 }
317
        for depth in range(26):
318
            new_version = text_name + '%s' % depth
319
            text = text + ['line\n']
320
            f.add_lines(new_version, [next_parent], text)
321
            next_parent = new_version
322
        next_parent = 'base'
323
        text_name = 'chain2-'
324
        text = ['line\n']
325
        for depth in range(26):
326
            new_version = text_name + '%s' % depth
327
            text = text + ['line\n']
328
            f.add_lines(new_version, [next_parent], text)
329
            next_parent = new_version
1596.2.38 by Robert Collins
rollback from using deltas to using fulltexts - deltas need more work to be ready.
330
        return sha1s
1596.2.37 by Robert Collins
Switch to delta based content copying in the generic versioned file copier.
331
332
    def test_add_delta(self):
333
        # tests for the add-delta facility.
334
        # at this point, optimising for speed, we assume no checks when deltas are inserted.
335
        # this may need to be revisited.
336
        source = self.get_file('source')
337
        source.add_lines('base', [], ['line\n'])
338
        next_parent = 'base'
339
        text_name = 'chain1-'
340
        text = ['line\n']
341
        for depth in range(26):
342
            new_version = text_name + '%s' % depth
343
            text = text + ['line\n']
344
            source.add_lines(new_version, [next_parent], text)
345
            next_parent = new_version
346
        next_parent = 'base'
347
        text_name = 'chain2-'
348
        text = ['line\n']
349
        for depth in range(26):
350
            new_version = text_name + '%s' % depth
351
            text = text + ['line\n']
352
            source.add_lines(new_version, [next_parent], text)
353
            next_parent = new_version
354
        source.add_lines('noeol', ['base'], ['line'])
355
        
356
        target = self.get_file('target')
357
        for version in source.versions():
358
            parent, sha1, noeol, delta = source.get_delta(version)
359
            target.add_delta(version,
360
                             source.get_parents(version),
361
                             parent,
362
                             sha1,
363
                             noeol,
364
                             delta)
365
        self.assertRaises(RevisionAlreadyPresent,
366
                          target.add_delta, 'base', [], None, '', False, [])
367
        for version in source.versions():
368
            self.assertEqual(source.get_lines(version),
369
                             target.get_lines(version))
1596.2.36 by Robert Collins
add a get_delta api to versioned_file.
370
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
371
    def test_ancestry(self):
372
        f = self.get_file()
1563.2.29 by Robert Collins
Remove all but fetch references to repository.revision_store.
373
        self.assertEqual([], f.get_ancestry([]))
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
374
        f.add_lines('r0', [], ['a\n', 'b\n'])
375
        f.add_lines('r1', ['r0'], ['b\n', 'c\n'])
376
        f.add_lines('r2', ['r0'], ['b\n', 'c\n'])
377
        f.add_lines('r3', ['r2'], ['b\n', 'c\n'])
378
        f.add_lines('rM', ['r1', 'r2'], ['b\n', 'c\n'])
1563.2.29 by Robert Collins
Remove all but fetch references to repository.revision_store.
379
        self.assertEqual([], f.get_ancestry([]))
1563.2.35 by Robert Collins
cleanup deprecation warnings and finish conversion so the inventory is knit based too.
380
        versions = f.get_ancestry(['rM'])
381
        # there are some possibilities:
382
        # r0 r1 r2 rM r3
383
        # r0 r1 r2 r3 rM
384
        # etc
385
        # so we check indexes
386
        r0 = versions.index('r0')
387
        r1 = versions.index('r1')
388
        r2 = versions.index('r2')
389
        self.assertFalse('r3' in versions)
390
        rM = versions.index('rM')
391
        self.assertTrue(r0 < r1)
392
        self.assertTrue(r0 < r2)
393
        self.assertTrue(r1 < rM)
394
        self.assertTrue(r2 < rM)
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
395
396
        self.assertRaises(RevisionNotPresent,
397
            f.get_ancestry, ['rM', 'rX'])
1594.2.21 by Robert Collins
Teach versioned files to prevent mutation after finishing.
398
2530.1.1 by Aaron Bentley
Make topological sorting optional for get_ancestry
399
        self.assertEqual(set(f.get_ancestry('rM')),
400
            set(f.get_ancestry('rM', topo_sorted=False)))
401
1594.2.21 by Robert Collins
Teach versioned files to prevent mutation after finishing.
402
    def test_mutate_after_finish(self):
403
        f = self.get_file()
404
        f.transaction_finished()
1596.2.37 by Robert Collins
Switch to delta based content copying in the generic versioned file copier.
405
        self.assertRaises(errors.OutSideTransaction, f.add_delta, '', [], '', '', False, [])
1594.2.21 by Robert Collins
Teach versioned files to prevent mutation after finishing.
406
        self.assertRaises(errors.OutSideTransaction, f.add_lines, '', [], [])
407
        self.assertRaises(errors.OutSideTransaction, f.add_lines_with_ghosts, '', [], [])
408
        self.assertRaises(errors.OutSideTransaction, f.fix_parents, '', [])
409
        self.assertRaises(errors.OutSideTransaction, f.join, '')
1594.2.24 by Robert Collins
Make use of the transaction finalisation warning support to implement in-knit caching.
410
        self.assertRaises(errors.OutSideTransaction, f.clone_text, 'base', 'bar', ['foo'])
1563.2.7 by Robert Collins
add versioned file clear_cache entry.
411
        
412
    def test_clear_cache(self):
413
        f = self.get_file()
414
        # on a new file it should not error
415
        f.clear_cache()
416
        # and after adding content, doing a clear_cache and a get should work.
417
        f.add_lines('0', [], ['a'])
418
        f.clear_cache()
419
        self.assertEqual(['a'], f.get_lines('0'))
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
420
421
    def test_clone_text(self):
422
        f = self.get_file()
423
        f.add_lines('r0', [], ['a\n', 'b\n'])
1563.2.5 by Robert Collins
Remove unused transaction references from knit.py and the versionedfile interface.
424
        f.clone_text('r1', 'r0', ['r0'])
1563.2.9 by Robert Collins
Update versionedfile api tests to ensure that data is available after every operation.
425
        def verify_file(f):
426
            self.assertEquals(f.get_lines('r1'), f.get_lines('r0'))
427
            self.assertEquals(f.get_lines('r1'), ['a\n', 'b\n'])
428
            self.assertEquals(f.get_parents('r1'), ['r0'])
429
    
430
            self.assertRaises(RevisionNotPresent,
431
                f.clone_text, 'r2', 'rX', [])
432
            self.assertRaises(RevisionAlreadyPresent,
433
                f.clone_text, 'r1', 'r0', [])
434
        verify_file(f)
435
        verify_file(self.reopen_file())
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
436
1563.2.13 by Robert Collins
InterVersionedFile implemented.
437
    def test_create_empty(self):
438
        f = self.get_file()
439
        f.add_lines('0', [], ['a\n'])
440
        new_f = f.create_empty('t', MemoryTransport())
441
        # smoke test, specific types should check it is honoured correctly for
442
        # non type attributes
443
        self.assertEqual([], new_f.versions())
444
        self.assertTrue(isinstance(new_f, f.__class__))
445
1563.2.15 by Robert Collins
remove the weavestore assumptions about the number and nature of files it manages.
446
    def test_copy_to(self):
447
        f = self.get_file()
448
        f.add_lines('0', [], ['a\n'])
449
        t = MemoryTransport()
450
        f.copy_to('foo', t)
451
        for suffix in f.__class__.get_suffixes():
452
            self.assertTrue(t.has('foo' + suffix))
453
454
    def test_get_suffixes(self):
455
        f = self.get_file()
456
        # should be the same
457
        self.assertEqual(f.__class__.get_suffixes(), f.__class__.get_suffixes())
458
        # and should be a list
459
        self.assertTrue(isinstance(f.__class__.get_suffixes(), list))
460
1684.3.1 by Robert Collins
Fix versioned file joins with empty targets.
461
    def build_graph(self, file, graph):
462
        for node in topo_sort(graph.items()):
463
            file.add_lines(node, graph[node], [])
464
1563.2.13 by Robert Collins
InterVersionedFile implemented.
465
    def test_get_graph(self):
466
        f = self.get_file()
1684.3.1 by Robert Collins
Fix versioned file joins with empty targets.
467
        graph = {
2625.8.1 by Robert Collins
LIBRARY API BREAKS:
468
            'v1': (),
469
            'v2': ('v1', ),
470
            'v3': ('v2', )}
1684.3.1 by Robert Collins
Fix versioned file joins with empty targets.
471
        self.build_graph(f, graph)
472
        self.assertEqual(graph, f.get_graph())
473
    
474
    def test_get_graph_partial(self):
475
        f = self.get_file()
476
        complex_graph = {}
477
        simple_a = {
2625.8.1 by Robert Collins
LIBRARY API BREAKS:
478
            'c': (),
479
            'b': ('c', ),
480
            'a': ('b', ),
1684.3.1 by Robert Collins
Fix versioned file joins with empty targets.
481
            }
482
        complex_graph.update(simple_a)
483
        simple_b = {
2625.8.1 by Robert Collins
LIBRARY API BREAKS:
484
            'c': (),
485
            'b': ('c', ),
1684.3.1 by Robert Collins
Fix versioned file joins with empty targets.
486
            }
487
        complex_graph.update(simple_b)
488
        simple_gam = {
2625.8.1 by Robert Collins
LIBRARY API BREAKS:
489
            'c': (),
490
            'oo': (),
491
            'bar': ('oo', 'c'),
492
            'gam': ('bar', ),
1684.3.1 by Robert Collins
Fix versioned file joins with empty targets.
493
            }
494
        complex_graph.update(simple_gam)
495
        simple_b_gam = {}
496
        simple_b_gam.update(simple_gam)
497
        simple_b_gam.update(simple_b)
498
        self.build_graph(f, complex_graph)
499
        self.assertEqual(simple_a, f.get_graph(['a']))
500
        self.assertEqual(simple_b, f.get_graph(['b']))
501
        self.assertEqual(simple_gam, f.get_graph(['gam']))
502
        self.assertEqual(simple_b_gam, f.get_graph(['b', 'gam']))
1563.2.13 by Robert Collins
InterVersionedFile implemented.
503
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
504
    def test_get_parents(self):
505
        f = self.get_file()
506
        f.add_lines('r0', [], ['a\n', 'b\n'])
507
        f.add_lines('r1', [], ['a\n', 'b\n'])
508
        f.add_lines('r2', [], ['a\n', 'b\n'])
509
        f.add_lines('r3', [], ['a\n', 'b\n'])
510
        f.add_lines('m', ['r0', 'r1', 'r2', 'r3'], ['a\n', 'b\n'])
511
        self.assertEquals(f.get_parents('m'), ['r0', 'r1', 'r2', 'r3'])
512
513
        self.assertRaises(RevisionNotPresent,
514
            f.get_parents, 'y')
515
516
    def test_annotate(self):
517
        f = self.get_file()
518
        f.add_lines('r0', [], ['a\n', 'b\n'])
519
        f.add_lines('r1', ['r0'], ['c\n', 'b\n'])
520
        origins = f.annotate('r1')
521
        self.assertEquals(origins[0][0], 'r1')
522
        self.assertEquals(origins[1][0], 'r0')
523
524
        self.assertRaises(RevisionNotPresent,
525
            f.annotate, 'foo')
526
527
    def test_walk(self):
1563.2.35 by Robert Collins
cleanup deprecation warnings and finish conversion so the inventory is knit based too.
528
        # tests that walk returns all the inclusions for the requested
529
        # revisions as well as the revisions changes themselves.
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
530
        f = self.get_file('1')
531
        f.add_lines('r0', [], ['a\n', 'b\n'])
532
        f.add_lines('r1', ['r0'], ['c\n', 'b\n'])
533
        f.add_lines('rX', ['r1'], ['d\n', 'b\n'])
534
        f.add_lines('rY', ['r1'], ['c\n', 'e\n'])
535
536
        lines = {}
537
        for lineno, insert, dset, text in f.walk(['rX', 'rY']):
538
            lines[text] = (insert, dset)
539
540
        self.assertTrue(lines['a\n'], ('r0', set(['r1'])))
541
        self.assertTrue(lines['b\n'], ('r0', set(['rY'])))
542
        self.assertTrue(lines['c\n'], ('r1', set(['rX'])))
543
        self.assertTrue(lines['d\n'], ('rX', set([])))
544
        self.assertTrue(lines['e\n'], ('rY', set([])))
545
1563.2.6 by Robert Collins
Start check tests for knits (pending), and remove dead code.
546
    def test_detection(self):
547
        # Test weaves detect corruption.
548
        #
549
        # Weaves contain a checksum of their texts.
550
        # When a text is extracted, this checksum should be
551
        # verified.
552
553
        w = self.get_file_corrupted_text()
554
555
        self.assertEqual('hello\n', w.get_text('v1'))
556
        self.assertRaises(errors.WeaveInvalidChecksum, w.get_text, 'v2')
557
        self.assertRaises(errors.WeaveInvalidChecksum, w.get_lines, 'v2')
558
        self.assertRaises(errors.WeaveInvalidChecksum, w.check)
559
560
        w = self.get_file_corrupted_checksum()
561
562
        self.assertEqual('hello\n', w.get_text('v1'))
563
        self.assertRaises(errors.WeaveInvalidChecksum, w.get_text, 'v2')
564
        self.assertRaises(errors.WeaveInvalidChecksum, w.get_lines, 'v2')
565
        self.assertRaises(errors.WeaveInvalidChecksum, w.check)
566
567
    def get_file_corrupted_text(self):
568
        """Return a versioned file with corrupt text but valid metadata."""
569
        raise NotImplementedError(self.get_file_corrupted_text)
570
1563.2.9 by Robert Collins
Update versionedfile api tests to ensure that data is available after every operation.
571
    def reopen_file(self, name='foo'):
572
        """Open the versioned file from disk again."""
573
        raise NotImplementedError(self.reopen_file)
574
2625.8.1 by Robert Collins
LIBRARY API BREAKS:
575
    def test_iter_parents(self):
576
        """iter_parents returns the parents for many nodes."""
577
        f = self.get_file()
578
        # sample data:
579
        # no parents
580
        f.add_lines('r0', [], ['a\n', 'b\n'])
581
        # 1 parents
582
        f.add_lines('r1', ['r0'], ['a\n', 'b\n'])
583
        # 2 parents
584
        f.add_lines('r2', ['r1', 'r0'], ['a\n', 'b\n'])
585
        # XXX TODO a ghost
586
        # cases: each sample data individually:
587
        self.assertEqual(set([('r0', ())]),
588
            set(f.iter_parents(['r0'])))
589
        self.assertEqual(set([('r1', ('r0', ))]),
590
            set(f.iter_parents(['r1'])))
591
        self.assertEqual(set([('r2', ('r1', 'r0'))]),
592
            set(f.iter_parents(['r2'])))
593
        # no nodes returned for a missing node
594
        self.assertEqual(set(),
595
            set(f.iter_parents(['missing'])))
596
        # 1 node returned with missing nodes skipped
597
        self.assertEqual(set([('r1', ('r0', ))]),
598
            set(f.iter_parents(['ghost1', 'r1', 'ghost'])))
599
        # 2 nodes returned
600
        self.assertEqual(set([('r0', ()), ('r1', ('r0', ))]),
601
            set(f.iter_parents(['r0', 'r1'])))
602
        # 2 nodes returned, missing skipped
603
        self.assertEqual(set([('r0', ()), ('r1', ('r0', ))]),
604
            set(f.iter_parents(['a', 'r0', 'b', 'r1', 'c'])))
605
1594.2.6 by Robert Collins
Introduce a api specifically for looking at lines in some versions of the inventory, for fileid_involved.
606
    def test_iter_lines_added_or_present_in_versions(self):
607
        # test that we get at least an equalset of the lines added by
608
        # versions in the weave 
609
        # the ordering here is to make a tree so that dumb searches have
610
        # more changes to muck up.
2039.1.1 by Aaron Bentley
Clean up progress properly when interrupted during fetch (#54000)
611
612
        class InstrumentedProgress(progress.DummyProgress):
613
614
            def __init__(self):
615
616
                progress.DummyProgress.__init__(self)
617
                self.updates = []
618
619
            def update(self, msg=None, current=None, total=None):
620
                self.updates.append((msg, current, total))
621
1594.2.6 by Robert Collins
Introduce a api specifically for looking at lines in some versions of the inventory, for fileid_involved.
622
        vf = self.get_file()
623
        # add a base to get included
624
        vf.add_lines('base', [], ['base\n'])
625
        # add a ancestor to be included on one side
626
        vf.add_lines('lancestor', [], ['lancestor\n'])
627
        # add a ancestor to be included on the other side
628
        vf.add_lines('rancestor', ['base'], ['rancestor\n'])
629
        # add a child of rancestor with no eofile-nl
630
        vf.add_lines('child', ['rancestor'], ['base\n', 'child\n'])
631
        # add a child of lancestor and base to join the two roots
632
        vf.add_lines('otherchild',
633
                     ['lancestor', 'base'],
634
                     ['base\n', 'lancestor\n', 'otherchild\n'])
2039.1.1 by Aaron Bentley
Clean up progress properly when interrupted during fetch (#54000)
635
        def iter_with_versions(versions, expected):
1594.2.6 by Robert Collins
Introduce a api specifically for looking at lines in some versions of the inventory, for fileid_involved.
636
            # now we need to see what lines are returned, and how often.
637
            lines = {'base\n':0,
638
                     'lancestor\n':0,
639
                     'rancestor\n':0,
640
                     'child\n':0,
641
                     'otherchild\n':0,
642
                     }
2039.1.1 by Aaron Bentley
Clean up progress properly when interrupted during fetch (#54000)
643
            progress = InstrumentedProgress()
1594.2.6 by Robert Collins
Introduce a api specifically for looking at lines in some versions of the inventory, for fileid_involved.
644
            # iterate over the lines
2039.1.1 by Aaron Bentley
Clean up progress properly when interrupted during fetch (#54000)
645
            for line in vf.iter_lines_added_or_present_in_versions(versions, 
646
                pb=progress):
1594.2.6 by Robert Collins
Introduce a api specifically for looking at lines in some versions of the inventory, for fileid_involved.
647
                lines[line] += 1
2039.1.2 by Aaron Bentley
Tweak test to avoid catching assert
648
            if []!= progress.updates: 
649
                self.assertEqual(expected, progress.updates)
1594.2.6 by Robert Collins
Introduce a api specifically for looking at lines in some versions of the inventory, for fileid_involved.
650
            return lines
2147.1.3 by John Arbash Meinel
In knit.py we were re-using a variable in 2 loops, causing bogus progress messages to be generated.
651
        lines = iter_with_versions(['child', 'otherchild'],
652
                                   [('Walking content.', 0, 2),
653
                                    ('Walking content.', 1, 2),
2039.1.1 by Aaron Bentley
Clean up progress properly when interrupted during fetch (#54000)
654
                                    ('Walking content.', 2, 2)])
1594.2.6 by Robert Collins
Introduce a api specifically for looking at lines in some versions of the inventory, for fileid_involved.
655
        # we must see child and otherchild
656
        self.assertTrue(lines['child\n'] > 0)
657
        self.assertTrue(lines['otherchild\n'] > 0)
658
        # we dont care if we got more than that.
659
        
660
        # test all lines
2147.1.3 by John Arbash Meinel
In knit.py we were re-using a variable in 2 loops, causing bogus progress messages to be generated.
661
        lines = iter_with_versions(None, [('Walking content.', 0, 5),
662
                                          ('Walking content.', 1, 5),
663
                                          ('Walking content.', 2, 5),
664
                                          ('Walking content.', 3, 5),
665
                                          ('Walking content.', 4, 5),
2039.1.1 by Aaron Bentley
Clean up progress properly when interrupted during fetch (#54000)
666
                                          ('Walking content.', 5, 5)])
1594.2.6 by Robert Collins
Introduce a api specifically for looking at lines in some versions of the inventory, for fileid_involved.
667
        # all lines must be seen at least once
668
        self.assertTrue(lines['base\n'] > 0)
669
        self.assertTrue(lines['lancestor\n'] > 0)
670
        self.assertTrue(lines['rancestor\n'] > 0)
671
        self.assertTrue(lines['child\n'] > 0)
672
        self.assertTrue(lines['otherchild\n'] > 0)
1594.2.7 by Robert Collins
Add versionedfile.fix_parents api for correcting data post hoc.
673
674
    def test_fix_parents(self):
675
        # some versioned files allow incorrect parents to be corrected after
676
        # insertion - this may not fix ancestry..
677
        # if they do not supported, they just do not implement it.
1594.2.8 by Robert Collins
add ghost aware apis to knits.
678
        # we test this as an interface test to ensure that those that *do*
679
        # implementent it get it right.
1594.2.7 by Robert Collins
Add versionedfile.fix_parents api for correcting data post hoc.
680
        vf = self.get_file()
681
        vf.add_lines('notbase', [], [])
682
        vf.add_lines('base', [], [])
683
        try:
684
            vf.fix_parents('notbase', ['base'])
685
        except NotImplementedError:
686
            return
687
        self.assertEqual(['base'], vf.get_parents('notbase'))
688
        # open again, check it stuck.
689
        vf = self.get_file()
690
        self.assertEqual(['base'], vf.get_parents('notbase'))
691
1594.2.8 by Robert Collins
add ghost aware apis to knits.
692
    def test_fix_parents_with_ghosts(self):
693
        # when fixing parents, ghosts that are listed should not be ghosts
694
        # anymore.
695
        vf = self.get_file()
696
697
        try:
698
            vf.add_lines_with_ghosts('notbase', ['base', 'stillghost'], [])
699
        except NotImplementedError:
700
            return
701
        vf.add_lines('base', [], [])
702
        vf.fix_parents('notbase', ['base', 'stillghost'])
703
        self.assertEqual(['base'], vf.get_parents('notbase'))
704
        # open again, check it stuck.
705
        vf = self.get_file()
706
        self.assertEqual(['base'], vf.get_parents('notbase'))
707
        # and check the ghosts
708
        self.assertEqual(['base', 'stillghost'],
709
                         vf.get_parents_with_ghosts('notbase'))
710
711
    def test_add_lines_with_ghosts(self):
712
        # some versioned file formats allow lines to be added with parent
713
        # information that is > than that in the format. Formats that do
714
        # not support this need to raise NotImplementedError on the
715
        # add_lines_with_ghosts api.
716
        vf = self.get_file()
717
        # add a revision with ghost parents
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
718
        # The preferred form is utf8, but we should translate when needed
719
        parent_id_unicode = u'b\xbfse'
720
        parent_id_utf8 = parent_id_unicode.encode('utf8')
1594.2.8 by Robert Collins
add ghost aware apis to knits.
721
        try:
2309.4.7 by John Arbash Meinel
Update VersionedFile tests to ensure that they can take Unicode,
722
            vf.add_lines_with_ghosts('notbxbfse', [parent_id_utf8], [])
1594.2.8 by Robert Collins
add ghost aware apis to knits.
723
        except NotImplementedError:
724
            # check the other ghost apis are also not implemented
725
            self.assertRaises(NotImplementedError, vf.has_ghost, 'foo')
726
            self.assertRaises(NotImplementedError, vf.get_ancestry_with_ghosts, ['foo'])
727
            self.assertRaises(NotImplementedError, vf.get_parents_with_ghosts, 'foo')
728
            self.assertRaises(NotImplementedError, vf.get_graph_with_ghosts)
729
            return
2150.2.1 by Robert Collins
Correctly decode utf8 revision ids from knits when parsing, fixes a regression where a unicode revision id is stored correctly, but then indexed by the utf8 value on the next invocation of bzr, rather than the unicode value.
730
        vf = self.reopen_file()
1594.2.8 by Robert Collins
add ghost aware apis to knits.
731
        # test key graph related apis: getncestry, _graph, get_parents
732
        # has_version
733
        # - these are ghost unaware and must not be reflect ghosts
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
734
        self.assertEqual(['notbxbfse'], vf.get_ancestry('notbxbfse'))
735
        self.assertEqual([], vf.get_parents('notbxbfse'))
2625.8.1 by Robert Collins
LIBRARY API BREAKS:
736
        self.assertEqual({'notbxbfse':()}, vf.get_graph())
2309.4.7 by John Arbash Meinel
Update VersionedFile tests to ensure that they can take Unicode,
737
        self.assertFalse(self.callDeprecated([osutils._revision_id_warning],
738
                         vf.has_version, parent_id_unicode))
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
739
        self.assertFalse(vf.has_version(parent_id_utf8))
1594.2.8 by Robert Collins
add ghost aware apis to knits.
740
        # we have _with_ghost apis to give us ghost information.
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
741
        self.assertEqual([parent_id_utf8, 'notbxbfse'], vf.get_ancestry_with_ghosts(['notbxbfse']))
742
        self.assertEqual([parent_id_utf8], vf.get_parents_with_ghosts('notbxbfse'))
743
        self.assertEqual({'notbxbfse':[parent_id_utf8]}, vf.get_graph_with_ghosts())
2309.4.7 by John Arbash Meinel
Update VersionedFile tests to ensure that they can take Unicode,
744
        self.assertTrue(self.callDeprecated([osutils._revision_id_warning],
745
                        vf.has_ghost, parent_id_unicode))
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
746
        self.assertTrue(vf.has_ghost(parent_id_utf8))
1594.2.8 by Robert Collins
add ghost aware apis to knits.
747
        # if we add something that is a ghost of another, it should correct the
748
        # results of the prior apis
2309.4.7 by John Arbash Meinel
Update VersionedFile tests to ensure that they can take Unicode,
749
        self.callDeprecated([osutils._revision_id_warning],
750
                            vf.add_lines, parent_id_unicode, [], [])
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
751
        self.assertEqual([parent_id_utf8, 'notbxbfse'], vf.get_ancestry(['notbxbfse']))
752
        self.assertEqual([parent_id_utf8], vf.get_parents('notbxbfse'))
2625.8.1 by Robert Collins
LIBRARY API BREAKS:
753
        self.assertEqual({parent_id_utf8:(),
754
                          'notbxbfse':(parent_id_utf8, ),
1594.2.8 by Robert Collins
add ghost aware apis to knits.
755
                          },
756
                         vf.get_graph())
2309.4.7 by John Arbash Meinel
Update VersionedFile tests to ensure that they can take Unicode,
757
        self.assertTrue(self.callDeprecated([osutils._revision_id_warning],
758
                        vf.has_version, parent_id_unicode))
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
759
        self.assertTrue(vf.has_version(parent_id_utf8))
1594.2.8 by Robert Collins
add ghost aware apis to knits.
760
        # we have _with_ghost apis to give us ghost information.
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
761
        self.assertEqual([parent_id_utf8, 'notbxbfse'], vf.get_ancestry_with_ghosts(['notbxbfse']))
762
        self.assertEqual([parent_id_utf8], vf.get_parents_with_ghosts('notbxbfse'))
763
        self.assertEqual({parent_id_utf8:[],
764
                          'notbxbfse':[parent_id_utf8],
1594.2.8 by Robert Collins
add ghost aware apis to knits.
765
                          },
766
                         vf.get_graph_with_ghosts())
2309.4.7 by John Arbash Meinel
Update VersionedFile tests to ensure that they can take Unicode,
767
        self.assertFalse(self.callDeprecated([osutils._revision_id_warning],
768
                         vf.has_ghost, parent_id_unicode))
2249.5.12 by John Arbash Meinel
Change the APIs for VersionedFile, Store, and some of Repository into utf-8
769
        self.assertFalse(vf.has_ghost(parent_id_utf8))
1594.2.8 by Robert Collins
add ghost aware apis to knits.
770
1594.2.9 by Robert Collins
Teach Knit repositories how to handle ghosts without corrupting at all.
771
    def test_add_lines_with_ghosts_after_normal_revs(self):
772
        # some versioned file formats allow lines to be added with parent
773
        # information that is > than that in the format. Formats that do
774
        # not support this need to raise NotImplementedError on the
775
        # add_lines_with_ghosts api.
776
        vf = self.get_file()
777
        # probe for ghost support
778
        try:
779
            vf.has_ghost('hoo')
780
        except NotImplementedError:
781
            return
782
        vf.add_lines_with_ghosts('base', [], ['line\n', 'line_b\n'])
783
        vf.add_lines_with_ghosts('references_ghost',
784
                                 ['base', 'a_ghost'],
785
                                 ['line\n', 'line_b\n', 'line_c\n'])
786
        origins = vf.annotate('references_ghost')
787
        self.assertEquals(('base', 'line\n'), origins[0])
788
        self.assertEquals(('base', 'line_b\n'), origins[1])
789
        self.assertEquals(('references_ghost', 'line_c\n'), origins[2])
1594.2.23 by Robert Collins
Test versioned file storage handling of clean/dirty status for accessed versioned files.
790
791
    def test_readonly_mode(self):
792
        transport = get_transport(self.get_url('.'))
793
        factory = self.get_factory()
794
        vf = factory('id', transport, 0777, create=True, access_mode='w')
795
        vf = factory('id', transport, access_mode='r')
1596.2.37 by Robert Collins
Switch to delta based content copying in the generic versioned file copier.
796
        self.assertRaises(errors.ReadOnlyError, vf.add_delta, '', [], '', '', False, [])
1594.2.23 by Robert Collins
Test versioned file storage handling of clean/dirty status for accessed versioned files.
797
        self.assertRaises(errors.ReadOnlyError, vf.add_lines, 'base', [], [])
798
        self.assertRaises(errors.ReadOnlyError,
799
                          vf.add_lines_with_ghosts,
800
                          'base',
801
                          [],
802
                          [])
803
        self.assertRaises(errors.ReadOnlyError, vf.fix_parents, 'base', [])
804
        self.assertRaises(errors.ReadOnlyError, vf.join, 'base')
1594.2.24 by Robert Collins
Make use of the transaction finalisation warning support to implement in-knit caching.
805
        self.assertRaises(errors.ReadOnlyError, vf.clone_text, 'base', 'bar', ['foo'])
1666.1.6 by Robert Collins
Make knit the default format.
806
    
807
    def test_get_sha1(self):
808
        # check the sha1 data is available
809
        vf = self.get_file()
810
        # a simple file
811
        vf.add_lines('a', [], ['a\n'])
812
        # the same file, different metadata
813
        vf.add_lines('b', ['a'], ['a\n'])
814
        # a file differing only in last newline.
815
        vf.add_lines('c', [], ['a'])
816
        self.assertEqual(
817
            '3f786850e387550fdab836ed7e6dc881de23001b', vf.get_sha1('a'))
818
        self.assertEqual(
819
            '3f786850e387550fdab836ed7e6dc881de23001b', vf.get_sha1('b'))
820
        self.assertEqual(
821
            '86f7e437faa5a7fce15d1ddcb9eaeaea377667b8', vf.get_sha1('c'))
2520.4.89 by Aaron Bentley
Add get_sha1s to weaves
822
823
        self.assertEqual(['3f786850e387550fdab836ed7e6dc881de23001b',
824
                          '86f7e437faa5a7fce15d1ddcb9eaeaea377667b8',
825
                          '3f786850e387550fdab836ed7e6dc881de23001b'],
826
                          vf.get_sha1s(['a', 'c', 'b']))
1594.2.9 by Robert Collins
Teach Knit repositories how to handle ghosts without corrupting at all.
827
        
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
828
1563.2.12 by Robert Collins
Checkpointing: created InterObject to factor out common inter object worker code, added InterVersionedFile and tests to allow making join work between any versionedfile.
829
class TestWeave(TestCaseWithTransport, VersionedFileTestMixIn):
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
830
831
    def get_file(self, name='foo'):
1563.2.25 by Robert Collins
Merge in upstream.
832
        return WeaveFile(name, get_transport(self.get_url('.')), create=True)
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
833
1563.2.6 by Robert Collins
Start check tests for knits (pending), and remove dead code.
834
    def get_file_corrupted_text(self):
1563.2.25 by Robert Collins
Merge in upstream.
835
        w = WeaveFile('foo', get_transport(self.get_url('.')), create=True)
1563.2.13 by Robert Collins
InterVersionedFile implemented.
836
        w.add_lines('v1', [], ['hello\n'])
837
        w.add_lines('v2', ['v1'], ['hello\n', 'there\n'])
1563.2.6 by Robert Collins
Start check tests for knits (pending), and remove dead code.
838
        
839
        # We are going to invasively corrupt the text
840
        # Make sure the internals of weave are the same
841
        self.assertEqual([('{', 0)
842
                        , 'hello\n'
843
                        , ('}', None)
844
                        , ('{', 1)
845
                        , 'there\n'
846
                        , ('}', None)
847
                        ], w._weave)
848
        
849
        self.assertEqual(['f572d396fae9206628714fb2ce00f72e94f2258f'
850
                        , '90f265c6e75f1c8f9ab76dcf85528352c5f215ef'
851
                        ], w._sha1s)
852
        w.check()
853
        
854
        # Corrupted
855
        w._weave[4] = 'There\n'
856
        return w
857
858
    def get_file_corrupted_checksum(self):
859
        w = self.get_file_corrupted_text()
860
        # Corrected
861
        w._weave[4] = 'there\n'
862
        self.assertEqual('hello\nthere\n', w.get_text('v2'))
863
        
864
        #Invalid checksum, first digit changed
865
        w._sha1s[1] =  'f0f265c6e75f1c8f9ab76dcf85528352c5f215ef'
866
        return w
867
1666.1.6 by Robert Collins
Make knit the default format.
868
    def reopen_file(self, name='foo', create=False):
869
        return WeaveFile(name, get_transport(self.get_url('.')), create=create)
1563.2.9 by Robert Collins
Update versionedfile api tests to ensure that data is available after every operation.
870
1563.2.25 by Robert Collins
Merge in upstream.
871
    def test_no_implicit_create(self):
872
        self.assertRaises(errors.NoSuchFile,
873
                          WeaveFile,
874
                          'foo',
875
                          get_transport(self.get_url('.')))
876
1594.2.23 by Robert Collins
Test versioned file storage handling of clean/dirty status for accessed versioned files.
877
    def get_factory(self):
878
        return WeaveFile
879
1563.2.1 by Robert Collins
Merge in a variation of the versionedfile api from versioned-file.
880
1563.2.12 by Robert Collins
Checkpointing: created InterObject to factor out common inter object worker code, added InterVersionedFile and tests to allow making join work between any versionedfile.
881
class TestKnit(TestCaseWithTransport, VersionedFileTestMixIn):
1563.2.4 by Robert Collins
First cut at including the knit implementation of versioned_file.
882
883
    def get_file(self, name='foo'):
1563.2.16 by Robert Collins
Change WeaveStore into VersionedFileStore and make its versoined file class parameterisable.
884
        return KnitVersionedFile(name, get_transport(self.get_url('.')),
1563.2.25 by Robert Collins
Merge in upstream.
885
                                 delta=True, create=True)
1563.2.6 by Robert Collins
Start check tests for knits (pending), and remove dead code.
886
1594.2.23 by Robert Collins
Test versioned file storage handling of clean/dirty status for accessed versioned files.
887
    def get_factory(self):
888
        return KnitVersionedFile
889
1563.2.6 by Robert Collins
Start check tests for knits (pending), and remove dead code.
890
    def get_file_corrupted_text(self):
891
        knit = self.get_file()
892
        knit.add_lines('v1', [], ['hello\n'])
893
        knit.add_lines('v2', ['v1'], ['hello\n', 'there\n'])
894
        return knit
1563.2.9 by Robert Collins
Update versionedfile api tests to ensure that data is available after every operation.
895
1666.1.6 by Robert Collins
Make knit the default format.
896
    def reopen_file(self, name='foo', create=False):
897
        return KnitVersionedFile(name, get_transport(self.get_url('.')),
898
            delta=True,
899
            create=create)
1563.2.10 by Robert Collins
Change weave store to be a versioned store, using WeaveFiles which maintain integrity without needing explicit 'put' operations.
900
901
    def test_detection(self):
1563.2.19 by Robert Collins
stub out a check for knits.
902
        knit = self.get_file()
903
        knit.check()
1563.2.12 by Robert Collins
Checkpointing: created InterObject to factor out common inter object worker code, added InterVersionedFile and tests to allow making join work between any versionedfile.
904
1563.2.25 by Robert Collins
Merge in upstream.
905
    def test_no_implicit_create(self):
906
        self.assertRaises(errors.NoSuchFile,
907
                          KnitVersionedFile,
908
                          'foo',
909
                          get_transport(self.get_url('.')))
910
1563.2.12 by Robert Collins
Checkpointing: created InterObject to factor out common inter object worker code, added InterVersionedFile and tests to allow making join work between any versionedfile.
911
912
class InterString(versionedfile.InterVersionedFile):
913
    """An inter-versionedfile optimised code path for strings.
914
915
    This is for use during testing where we use strings as versionedfiles
916
    so that none of the default regsitered interversionedfile classes will
917
    match - which lets us test the match logic.
918
    """
919
920
    @staticmethod
921
    def is_compatible(source, target):
922
        """InterString is compatible with strings-as-versionedfiles."""
923
        return isinstance(source, str) and isinstance(target, str)
924
925
926
# TODO this and the InterRepository core logic should be consolidatable
927
# if we make the registry a separate class though we still need to 
928
# test the behaviour in the active registry to catch failure-to-handle-
929
# stange-objects
930
class TestInterVersionedFile(TestCaseWithTransport):
931
932
    def test_get_default_inter_versionedfile(self):
933
        # test that the InterVersionedFile.get(a, b) probes
934
        # for a class where is_compatible(a, b) returns
935
        # true and returns a default interversionedfile otherwise.
936
        # This also tests that the default registered optimised interversionedfile
937
        # classes do not barf inappropriately when a surprising versionedfile type
938
        # is handed to them.
939
        dummy_a = "VersionedFile 1."
940
        dummy_b = "VersionedFile 2."
941
        self.assertGetsDefaultInterVersionedFile(dummy_a, dummy_b)
942
943
    def assertGetsDefaultInterVersionedFile(self, a, b):
944
        """Asserts that InterVersionedFile.get(a, b) -> the default."""
945
        inter = versionedfile.InterVersionedFile.get(a, b)
946
        self.assertEqual(versionedfile.InterVersionedFile,
947
                         inter.__class__)
948
        self.assertEqual(a, inter.source)
949
        self.assertEqual(b, inter.target)
950
951
    def test_register_inter_versionedfile_class(self):
952
        # test that a optimised code path provider - a
953
        # InterVersionedFile subclass can be registered and unregistered
954
        # and that it is correctly selected when given a versionedfile
955
        # pair that it returns true on for the is_compatible static method
956
        # check
957
        dummy_a = "VersionedFile 1."
958
        dummy_b = "VersionedFile 2."
959
        versionedfile.InterVersionedFile.register_optimiser(InterString)
960
        try:
961
            # we should get the default for something InterString returns False
962
            # to
963
            self.assertFalse(InterString.is_compatible(dummy_a, None))
964
            self.assertGetsDefaultInterVersionedFile(dummy_a, None)
965
            # and we should get an InterString for a pair it 'likes'
966
            self.assertTrue(InterString.is_compatible(dummy_a, dummy_b))
967
            inter = versionedfile.InterVersionedFile.get(dummy_a, dummy_b)
968
            self.assertEqual(InterString, inter.__class__)
969
            self.assertEqual(dummy_a, inter.source)
970
            self.assertEqual(dummy_b, inter.target)
971
        finally:
972
            versionedfile.InterVersionedFile.unregister_optimiser(InterString)
973
        # now we should get the default InterVersionedFile object again.
974
        self.assertGetsDefaultInterVersionedFile(dummy_a, dummy_b)
1666.1.1 by Robert Collins
Add trivial http-using test for versioned files.
975
976
977
class TestReadonlyHttpMixin(object):
978
979
    def test_readonly_http_works(self):
980
        # we should be able to read from http with a versioned file.
981
        vf = self.get_file()
1666.1.6 by Robert Collins
Make knit the default format.
982
        # try an empty file access
983
        readonly_vf = self.get_factory()('foo', get_transport(self.get_readonly_url('.')))
984
        self.assertEqual([], readonly_vf.versions())
985
        # now with feeling.
1666.1.1 by Robert Collins
Add trivial http-using test for versioned files.
986
        vf.add_lines('1', [], ['a\n'])
987
        vf.add_lines('2', ['1'], ['b\n', 'a\n'])
988
        readonly_vf = self.get_factory()('foo', get_transport(self.get_readonly_url('.')))
1666.1.6 by Robert Collins
Make knit the default format.
989
        self.assertEqual(['1', '2'], vf.versions())
1666.1.1 by Robert Collins
Add trivial http-using test for versioned files.
990
        for version in readonly_vf.versions():
991
            readonly_vf.get_lines(version)
992
993
994
class TestWeaveHTTP(TestCaseWithWebserver, TestReadonlyHttpMixin):
995
996
    def get_file(self):
997
        return WeaveFile('foo', get_transport(self.get_url('.')), create=True)
998
999
    def get_factory(self):
1000
        return WeaveFile
1001
1002
1003
class TestKnitHTTP(TestCaseWithWebserver, TestReadonlyHttpMixin):
1004
1005
    def get_file(self):
1006
        return KnitVersionedFile('foo', get_transport(self.get_url('.')),
1007
                                 delta=True, create=True)
1008
1009
    def get_factory(self):
1010
        return KnitVersionedFile
1664.2.9 by Aaron Bentley
Ported weave merge test to versionedfile
1011
1012
1013
class MergeCasesMixin(object):
1014
1015
    def doMerge(self, base, a, b, mp):
1016
        from cStringIO import StringIO
1017
        from textwrap import dedent
1018
1019
        def addcrlf(x):
1020
            return x + '\n'
1021
        
1022
        w = self.get_file()
1023
        w.add_lines('text0', [], map(addcrlf, base))
1024
        w.add_lines('text1', ['text0'], map(addcrlf, a))
1025
        w.add_lines('text2', ['text0'], map(addcrlf, b))
1026
1027
        self.log_contents(w)
1028
1029
        self.log('merge plan:')
1030
        p = list(w.plan_merge('text1', 'text2'))
1031
        for state, line in p:
1032
            if line:
1033
                self.log('%12s | %s' % (state, line[:-1]))
1034
1035
        self.log('merge:')
1036
        mt = StringIO()
1037
        mt.writelines(w.weave_merge(p))
1038
        mt.seek(0)
1039
        self.log(mt.getvalue())
1040
1041
        mp = map(addcrlf, mp)
1042
        self.assertEqual(mt.readlines(), mp)
1043
        
1044
        
1045
    def testOneInsert(self):
1046
        self.doMerge([],
1047
                     ['aa'],
1048
                     [],
1049
                     ['aa'])
1050
1051
    def testSeparateInserts(self):
1052
        self.doMerge(['aaa', 'bbb', 'ccc'],
1053
                     ['aaa', 'xxx', 'bbb', 'ccc'],
1054
                     ['aaa', 'bbb', 'yyy', 'ccc'],
1055
                     ['aaa', 'xxx', 'bbb', 'yyy', 'ccc'])
1056
1057
    def testSameInsert(self):
1058
        self.doMerge(['aaa', 'bbb', 'ccc'],
1059
                     ['aaa', 'xxx', 'bbb', 'ccc'],
1060
                     ['aaa', 'xxx', 'bbb', 'yyy', 'ccc'],
1061
                     ['aaa', 'xxx', 'bbb', 'yyy', 'ccc'])
1062
    overlappedInsertExpected = ['aaa', 'xxx', 'yyy', 'bbb']
1063
    def testOverlappedInsert(self):
1064
        self.doMerge(['aaa', 'bbb'],
1065
                     ['aaa', 'xxx', 'yyy', 'bbb'],
1066
                     ['aaa', 'xxx', 'bbb'], self.overlappedInsertExpected)
1067
1068
        # really it ought to reduce this to 
1069
        # ['aaa', 'xxx', 'yyy', 'bbb']
1070
1071
1072
    def testClashReplace(self):
1073
        self.doMerge(['aaa'],
1074
                     ['xxx'],
1075
                     ['yyy', 'zzz'],
1076
                     ['<<<<<<< ', 'xxx', '=======', 'yyy', 'zzz', 
1077
                      '>>>>>>> '])
1078
1079
    def testNonClashInsert1(self):
1080
        self.doMerge(['aaa'],
1081
                     ['xxx', 'aaa'],
1082
                     ['yyy', 'zzz'],
1083
                     ['<<<<<<< ', 'xxx', 'aaa', '=======', 'yyy', 'zzz', 
1084
                      '>>>>>>> '])
1085
1086
    def testNonClashInsert2(self):
1087
        self.doMerge(['aaa'],
1088
                     ['aaa'],
1089
                     ['yyy', 'zzz'],
1090
                     ['yyy', 'zzz'])
1091
1092
1093
    def testDeleteAndModify(self):
1094
        """Clashing delete and modification.
1095
1096
        If one side modifies a region and the other deletes it then
1097
        there should be a conflict with one side blank.
1098
        """
1099
1100
        #######################################
1101
        # skippd, not working yet
1102
        return
1103
        
1104
        self.doMerge(['aaa', 'bbb', 'ccc'],
1105
                     ['aaa', 'ddd', 'ccc'],
1106
                     ['aaa', 'ccc'],
1107
                     ['<<<<<<<< ', 'aaa', '=======', '>>>>>>> ', 'ccc'])
1108
1109
    def _test_merge_from_strings(self, base, a, b, expected):
1110
        w = self.get_file()
1111
        w.add_lines('text0', [], base.splitlines(True))
1112
        w.add_lines('text1', ['text0'], a.splitlines(True))
1113
        w.add_lines('text2', ['text0'], b.splitlines(True))
1114
        self.log('merge plan:')
1115
        p = list(w.plan_merge('text1', 'text2'))
1116
        for state, line in p:
1117
            if line:
1118
                self.log('%12s | %s' % (state, line[:-1]))
1119
        self.log('merge result:')
1120
        result_text = ''.join(w.weave_merge(p))
1121
        self.log(result_text)
1122
        self.assertEqualDiff(result_text, expected)
1123
1124
    def test_weave_merge_conflicts(self):
1125
        # does weave merge properly handle plans that end with unchanged?
1126
        result = ''.join(self.get_file().weave_merge([('new-a', 'hello\n')]))
1127
        self.assertEqual(result, 'hello\n')
1128
1129
    def test_deletion_extended(self):
1130
        """One side deletes, the other deletes more.
1131
        """
1132
        base = """\
1133
            line 1
1134
            line 2
1135
            line 3
1136
            """
1137
        a = """\
1138
            line 1
1139
            line 2
1140
            """
1141
        b = """\
1142
            line 1
1143
            """
1144
        result = """\
1145
            line 1
1146
            """
1147
        self._test_merge_from_strings(base, a, b, result)
1148
1149
    def test_deletion_overlap(self):
1150
        """Delete overlapping regions with no other conflict.
1151
1152
        Arguably it'd be better to treat these as agreement, rather than 
1153
        conflict, but for now conflict is safer.
1154
        """
1155
        base = """\
1156
            start context
1157
            int a() {}
1158
            int b() {}
1159
            int c() {}
1160
            end context
1161
            """
1162
        a = """\
1163
            start context
1164
            int a() {}
1165
            end context
1166
            """
1167
        b = """\
1168
            start context
1169
            int c() {}
1170
            end context
1171
            """
1172
        result = """\
1173
            start context
1174
<<<<<<< 
1175
            int a() {}
1176
=======
1177
            int c() {}
1178
>>>>>>> 
1179
            end context
1180
            """
1181
        self._test_merge_from_strings(base, a, b, result)
1182
1183
    def test_agreement_deletion(self):
1184
        """Agree to delete some lines, without conflicts."""
1185
        base = """\
1186
            start context
1187
            base line 1
1188
            base line 2
1189
            end context
1190
            """
1191
        a = """\
1192
            start context
1193
            base line 1
1194
            end context
1195
            """
1196
        b = """\
1197
            start context
1198
            base line 1
1199
            end context
1200
            """
1201
        result = """\
1202
            start context
1203
            base line 1
1204
            end context
1205
            """
1206
        self._test_merge_from_strings(base, a, b, result)
1207
1208
    def test_sync_on_deletion(self):
1209
        """Specific case of merge where we can synchronize incorrectly.
1210
        
1211
        A previous version of the weave merge concluded that the two versions
1212
        agreed on deleting line 2, and this could be a synchronization point.
1213
        Line 1 was then considered in isolation, and thought to be deleted on 
1214
        both sides.
1215
1216
        It's better to consider the whole thing as a disagreement region.
1217
        """
1218
        base = """\
1219
            start context
1220
            base line 1
1221
            base line 2
1222
            end context
1223
            """
1224
        a = """\
1225
            start context
1226
            base line 1
1227
            a's replacement line 2
1228
            end context
1229
            """
1230
        b = """\
1231
            start context
1232
            b replaces
1233
            both lines
1234
            end context
1235
            """
1236
        result = """\
1237
            start context
1238
<<<<<<< 
1239
            base line 1
1240
            a's replacement line 2
1241
=======
1242
            b replaces
1243
            both lines
1244
>>>>>>> 
1245
            end context
1246
            """
1247
        self._test_merge_from_strings(base, a, b, result)
1248
1249
1250
class TestKnitMerge(TestCaseWithTransport, MergeCasesMixin):
1251
1252
    def get_file(self, name='foo'):
1253
        return KnitVersionedFile(name, get_transport(self.get_url('.')),
1254
                                 delta=True, create=True)
1255
1256
    def log_contents(self, w):
1257
        pass
1258
1259
1260
class TestWeaveMerge(TestCaseWithTransport, MergeCasesMixin):
1261
1262
    def get_file(self, name='foo'):
1263
        return WeaveFile(name, get_transport(self.get_url('.')), create=True)
1264
1265
    def log_contents(self, w):
1266
        self.log('weave is:')
1267
        tmpf = StringIO()
1268
        write_weave(w, tmpf)
1269
        self.log(tmpf.getvalue())
1270
1271
    overlappedInsertExpected = ['aaa', '<<<<<<< ', 'xxx', 'yyy', '=======', 
1272
                                'xxx', '>>>>>>> ', 'bbb']