/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/repofmt/knitrepo.py

added ianc tweaks to tbzr strategy doc

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/repofmt/knitrepo.py
1
 
# Copyright (C) 2007-2010 Canonical Ltd
 
1
# Copyright (C) 2005, 2006, 2007 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
from bzrlib.lazy_import import lazy_import
18
18
lazy_import(globals(), """
19
19
from bzrlib import (
 
20
    debug,
 
21
    )
 
22
from bzrlib.store import revision
 
23
from bzrlib.store.revision.knit import KnitRevisionStore
 
24
""")
 
25
from bzrlib import (
20
26
    bzrdir,
21
27
    errors,
22
 
    knit as _mod_knit,
 
28
    knit,
23
29
    lockable_files,
24
30
    lockdir,
25
31
    osutils,
26
 
    revision as _mod_revision,
27
 
    trace,
 
32
    symbol_versioning,
28
33
    transactions,
29
 
    versionedfile,
30
34
    xml5,
31
35
    xml6,
32
36
    xml7,
33
37
    )
34
 
""")
35
 
from bzrlib import (
36
 
    symbol_versioning,
37
 
    )
 
38
 
38
39
from bzrlib.decorators import needs_read_lock, needs_write_lock
39
40
from bzrlib.repository import (
40
41
    CommitBuilder,
43
44
    RepositoryFormat,
44
45
    RootCommitBuilder,
45
46
    )
 
47
import bzrlib.revision as _mod_revision
 
48
from bzrlib.store.versioned import VersionedFileStore
 
49
from bzrlib.trace import mutter, mutter_callsite
 
50
from bzrlib.util import bencode
46
51
 
47
52
 
48
53
class _KnitParentsProvider(object):
53
58
    def __repr__(self):
54
59
        return 'KnitParentsProvider(%r)' % self._knit
55
60
 
 
61
    @symbol_versioning.deprecated_method(symbol_versioning.one_one)
 
62
    def get_parents(self, revision_ids):
 
63
        """See graph._StackedParentsProvider.get_parents"""
 
64
        parent_map = self.get_parent_map(revision_ids)
 
65
        return [parent_map.get(r, None) for r in revision_ids]
 
66
 
56
67
    def get_parent_map(self, keys):
57
 
        """See graph.StackedParentsProvider.get_parent_map"""
 
68
        """See graph._StackedParentsProvider.get_parent_map"""
58
69
        parent_map = {}
59
70
        for revision_id in keys:
60
71
            if revision_id is None:
74
85
        return parent_map
75
86
 
76
87
 
77
 
class _KnitsParentsProvider(object):
78
 
 
79
 
    def __init__(self, knit, prefix=()):
80
 
        """Create a parent provider for string keys mapped to tuple keys."""
81
 
        self._knit = knit
82
 
        self._prefix = prefix
83
 
 
84
 
    def __repr__(self):
85
 
        return 'KnitsParentsProvider(%r)' % self._knit
86
 
 
87
 
    def get_parent_map(self, keys):
88
 
        """See graph.StackedParentsProvider.get_parent_map"""
89
 
        parent_map = self._knit.get_parent_map(
90
 
            [self._prefix + (key,) for key in keys])
91
 
        result = {}
92
 
        for key, parents in parent_map.items():
93
 
            revid = key[-1]
94
 
            if len(parents) == 0:
95
 
                parents = (_mod_revision.NULL_REVISION,)
96
 
            else:
97
 
                parents = tuple(parent[-1] for parent in parents)
98
 
            result[revid] = parents
99
 
        for revision_id in keys:
100
 
            if revision_id == _mod_revision.NULL_REVISION:
101
 
                result[revision_id] = ()
102
 
        return result
103
 
 
104
 
 
105
88
class KnitRepository(MetaDirRepository):
106
89
    """Knit format repository."""
107
90
 
112
95
    _commit_builder_class = None
113
96
    _serializer = None
114
97
 
115
 
    def __init__(self, _format, a_bzrdir, control_files, _commit_builder_class,
116
 
        _serializer):
117
 
        MetaDirRepository.__init__(self, _format, a_bzrdir, control_files)
 
98
    def __init__(self, _format, a_bzrdir, control_files, _revision_store,
 
99
        control_store, text_store, _commit_builder_class, _serializer):
 
100
        MetaDirRepository.__init__(self, _format, a_bzrdir, control_files,
 
101
            _revision_store, control_store, text_store)
118
102
        self._commit_builder_class = _commit_builder_class
119
103
        self._serializer = _serializer
120
104
        self._reconcile_fixes_text_parents = True
 
105
        control_store.get_scope = self.get_transaction
 
106
        text_store.get_scope = self.get_transaction
 
107
        _revision_store.get_scope = self.get_transaction
 
108
 
 
109
    def _warn_if_deprecated(self):
 
110
        # This class isn't deprecated
 
111
        pass
 
112
 
 
113
    def _inventory_add_lines(self, inv_vf, revid, parents, lines, check_content):
 
114
        return inv_vf.add_lines_with_ghosts(revid, parents, lines,
 
115
            check_content=check_content)[0]
121
116
 
122
117
    @needs_read_lock
123
118
    def _all_revision_ids(self):
124
119
        """See Repository.all_revision_ids()."""
125
 
        return [key[0] for key in self.revisions.keys()]
126
 
 
127
 
    def _activate_new_inventory(self):
128
 
        """Put a replacement inventory.new into use as inventories."""
129
 
        # Copy the content across
130
 
        t = self._transport
131
 
        t.copy('inventory.new.kndx', 'inventory.kndx')
132
 
        try:
133
 
            t.copy('inventory.new.knit', 'inventory.knit')
134
 
        except errors.NoSuchFile:
135
 
            # empty inventories knit
136
 
            t.delete('inventory.knit')
137
 
        # delete the temp inventory
138
 
        t.delete('inventory.new.kndx')
139
 
        try:
140
 
            t.delete('inventory.new.knit')
141
 
        except errors.NoSuchFile:
142
 
            # empty inventories knit
143
 
            pass
144
 
        # Force index reload (sanity check)
145
 
        self.inventories._index._reset_cache()
146
 
        self.inventories.keys()
147
 
 
148
 
    def _backup_inventory(self):
149
 
        t = self._transport
150
 
        t.copy('inventory.kndx', 'inventory.backup.kndx')
151
 
        t.copy('inventory.knit', 'inventory.backup.knit')
152
 
 
153
 
    def _move_file_id(self, from_id, to_id):
154
 
        t = self._transport.clone('knits')
155
 
        from_rel_url = self.texts._index._mapper.map((from_id, None))
156
 
        to_rel_url = self.texts._index._mapper.map((to_id, None))
157
 
        # We expect both files to always exist in this case.
158
 
        for suffix in ('.knit', '.kndx'):
159
 
            t.rename(from_rel_url + suffix, to_rel_url + suffix)
160
 
 
161
 
    def _remove_file_id(self, file_id):
162
 
        t = self._transport.clone('knits')
163
 
        rel_url = self.texts._index._mapper.map((file_id, None))
164
 
        for suffix in ('.kndx', '.knit'):
165
 
            try:
166
 
                t.delete(rel_url + suffix)
167
 
            except errors.NoSuchFile:
168
 
                pass
169
 
 
170
 
    def _temp_inventories(self):
171
 
        result = self._format._get_inventories(self._transport, self,
172
 
            'inventory.new')
173
 
        # Reconciling when the output has no revisions would result in no
174
 
        # writes - but we want to ensure there is an inventory for
175
 
        # compatibility with older clients that don't lazy-load.
176
 
        result.get_parent_map([('A',)])
177
 
        return result
 
120
        # Knits get the revision graph from the index of the revision knit, so
 
121
        # it's always possible even if they're on an unlistable transport.
 
122
        return self._revision_store.all_revision_ids(self.get_transaction())
178
123
 
179
124
    def fileid_involved_between_revs(self, from_revid, to_revid):
180
125
        """Find file_id(s) which are involved in the changes between revisions.
202
147
        return self._fileid_involved_by_set(changed)
203
148
 
204
149
    @needs_read_lock
 
150
    def get_ancestry(self, revision_id, topo_sorted=True):
 
151
        """Return a list of revision-ids integrated by a revision.
 
152
        
 
153
        This is topologically sorted, unless 'topo_sorted' is specified as
 
154
        False.
 
155
        """
 
156
        if _mod_revision.is_null(revision_id):
 
157
            return [None]
 
158
        vf = self._get_revision_vf()
 
159
        try:
 
160
            return [None] + vf.get_ancestry(revision_id, topo_sorted)
 
161
        except errors.RevisionNotPresent:
 
162
            raise errors.NoSuchRevision(self, revision_id)
 
163
 
 
164
    @symbol_versioning.deprecated_method(symbol_versioning.one_two)
 
165
    def get_data_stream(self, revision_ids):
 
166
        """See Repository.get_data_stream.
 
167
        
 
168
        Deprecated in 1.2 for get_data_stream_for_search.
 
169
        """
 
170
        search_result = self.revision_ids_to_search_result(set(revision_ids))
 
171
        return self.get_data_stream_for_search(search_result)
 
172
 
 
173
    def get_data_stream_for_search(self, search):
 
174
        """See Repository.get_data_stream_for_search."""
 
175
        item_keys = self.item_keys_introduced_by(search.get_keys())
 
176
        for knit_kind, file_id, versions in item_keys:
 
177
            name = (knit_kind,)
 
178
            if knit_kind == 'file':
 
179
                name = ('file', file_id)
 
180
                knit = self.weave_store.get_weave_or_empty(
 
181
                    file_id, self.get_transaction())
 
182
            elif knit_kind == 'inventory':
 
183
                knit = self.get_inventory_weave()
 
184
            elif knit_kind == 'revisions':
 
185
                knit = self._revision_store.get_revision_file(
 
186
                    self.get_transaction())
 
187
            elif knit_kind == 'signatures':
 
188
                knit = self._revision_store.get_signature_file(
 
189
                    self.get_transaction())
 
190
            else:
 
191
                raise AssertionError('Unknown knit kind %r' % (knit_kind,))
 
192
            yield name, _get_stream_as_bytes(knit, versions)
 
193
 
 
194
    @needs_read_lock
205
195
    def get_revision(self, revision_id):
206
196
        """Return the Revision object for a named revision"""
207
197
        revision_id = osutils.safe_revision_id(revision_id)
208
198
        return self.get_revision_reconcile(revision_id)
209
199
 
210
 
    def _refresh_data(self):
211
 
        if not self.is_locked():
212
 
            return
213
 
        # Create a new transaction to force all knits to see the scope change.
214
 
        # This is safe because we're outside a write group.
215
 
        self.control_files._finish_transaction()
216
 
        if self.is_write_locked():
217
 
            self.control_files._set_write_transaction()
218
 
        else:
219
 
            self.control_files._set_read_transaction()
 
200
    def _get_revision_vf(self):
 
201
        """:return: a versioned file containing the revisions."""
 
202
        vf = self._revision_store.get_revision_file(self.get_transaction())
 
203
        return vf
 
204
 
 
205
    def has_revisions(self, revision_ids):
 
206
        """See Repository.has_revisions()."""
 
207
        result = set()
 
208
        transaction = self.get_transaction()
 
209
        for revision_id in revision_ids:
 
210
            if self._revision_store.has_revision_id(revision_id, transaction):
 
211
                result.add(revision_id)
 
212
        return result
220
213
 
221
214
    @needs_write_lock
222
215
    def reconcile(self, other=None, thorough=False):
225
218
        reconciler = KnitReconciler(self, thorough=thorough)
226
219
        reconciler.reconcile()
227
220
        return reconciler
 
221
    
 
222
    @symbol_versioning.deprecated_method(symbol_versioning.one_five)
 
223
    def revision_parents(self, revision_id):
 
224
        return self._get_revision_vf().get_parents(revision_id)
228
225
 
229
226
    def _make_parents_provider(self):
230
 
        return _KnitsParentsProvider(self.revisions)
 
227
        return _KnitParentsProvider(self._get_revision_vf())
231
228
 
232
 
    def _find_inconsistent_revision_parents(self, revisions_iterator=None):
 
229
    def _find_inconsistent_revision_parents(self):
233
230
        """Find revisions with different parent lists in the revision object
234
231
        and in the index graph.
235
232
 
236
 
        :param revisions_iterator: None, or an iterator of (revid,
237
 
            Revision-or-None). This iterator controls the revisions checked.
238
233
        :returns: an iterator yielding tuples of (revison-id, parents-in-index,
239
234
            parents-in-revision).
240
235
        """
241
236
        if not self.is_locked():
242
237
            raise AssertionError()
243
 
        vf = self.revisions
244
 
        if revisions_iterator is None:
245
 
            revisions_iterator = self._iter_revisions(None)
246
 
        for revid, revision in revisions_iterator:
247
 
            if revision is None:
248
 
                pass
249
 
            parent_map = vf.get_parent_map([(revid,)])
250
 
            parents_according_to_index = tuple(parent[-1] for parent in
251
 
                parent_map[(revid,)])
 
238
        vf = self._get_revision_vf()
 
239
        for index_version in vf.versions():
 
240
            parents_according_to_index = tuple(vf.get_parents_with_ghosts(
 
241
                index_version))
 
242
            revision = self.get_revision(index_version)
252
243
            parents_according_to_revision = tuple(revision.parent_ids)
253
244
            if parents_according_to_index != parents_according_to_revision:
254
 
                yield (revid, parents_according_to_index,
 
245
                yield (index_version, parents_according_to_index,
255
246
                    parents_according_to_revision)
256
247
 
257
248
    def _check_for_inconsistent_revision_parents(self):
267
258
 
268
259
 
269
260
class RepositoryFormatKnit(MetaDirRepositoryFormat):
270
 
    """Bzr repository knit format (generalized).
 
261
    """Bzr repository knit format (generalized). 
271
262
 
272
263
    This repository format has:
273
264
     - knits for file texts and inventory
289
280
    _commit_builder_class = None
290
281
    # Set this attribute in derived clases to control the _serializer that the
291
282
    # repository objects will have passed to their constructor.
292
 
    @property
293
 
    def _serializer(self):
294
 
        return xml5.serializer_v5
 
283
    _serializer = xml5.serializer_v5
295
284
    # Knit based repositories handle ghosts reasonably well.
296
285
    supports_ghosts = True
297
286
    # External lookups are not supported in this format.
298
287
    supports_external_lookups = False
299
 
    # No CHK support.
300
 
    supports_chks = False
301
 
    _fetch_order = 'topological'
302
 
    _fetch_uses_deltas = True
303
 
    fast_deltas = False
304
 
 
305
 
    def _get_inventories(self, repo_transport, repo, name='inventory'):
306
 
        mapper = versionedfile.ConstantMapper(name)
307
 
        index = _mod_knit._KndxIndex(repo_transport, mapper,
308
 
            repo.get_transaction, repo.is_write_locked, repo.is_locked)
309
 
        access = _mod_knit._KnitKeyAccess(repo_transport, mapper)
310
 
        return _mod_knit.KnitVersionedFiles(index, access, annotated=False)
311
 
 
312
 
    def _get_revisions(self, repo_transport, repo):
313
 
        mapper = versionedfile.ConstantMapper('revisions')
314
 
        index = _mod_knit._KndxIndex(repo_transport, mapper,
315
 
            repo.get_transaction, repo.is_write_locked, repo.is_locked)
316
 
        access = _mod_knit._KnitKeyAccess(repo_transport, mapper)
317
 
        return _mod_knit.KnitVersionedFiles(index, access, max_delta_chain=0,
318
 
            annotated=False)
319
 
 
320
 
    def _get_signatures(self, repo_transport, repo):
321
 
        mapper = versionedfile.ConstantMapper('signatures')
322
 
        index = _mod_knit._KndxIndex(repo_transport, mapper,
323
 
            repo.get_transaction, repo.is_write_locked, repo.is_locked)
324
 
        access = _mod_knit._KnitKeyAccess(repo_transport, mapper)
325
 
        return _mod_knit.KnitVersionedFiles(index, access, max_delta_chain=0,
326
 
            annotated=False)
327
 
 
328
 
    def _get_texts(self, repo_transport, repo):
329
 
        mapper = versionedfile.HashEscapedPrefixMapper()
330
 
        base_transport = repo_transport.clone('knits')
331
 
        index = _mod_knit._KndxIndex(base_transport, mapper,
332
 
            repo.get_transaction, repo.is_write_locked, repo.is_locked)
333
 
        access = _mod_knit._KnitKeyAccess(base_transport, mapper)
334
 
        return _mod_knit.KnitVersionedFiles(index, access, max_delta_chain=200,
335
 
            annotated=True)
 
288
 
 
289
    def _get_control_store(self, repo_transport, control_files):
 
290
        """Return the control store for this repository."""
 
291
        return VersionedFileStore(
 
292
            repo_transport,
 
293
            prefixed=False,
 
294
            file_mode=control_files._file_mode,
 
295
            versionedfile_class=knit.make_file_knit,
 
296
            versionedfile_kwargs={'factory':knit.KnitPlainFactory()},
 
297
            )
 
298
 
 
299
    def _get_revision_store(self, repo_transport, control_files):
 
300
        """See RepositoryFormat._get_revision_store()."""
 
301
        versioned_file_store = VersionedFileStore(
 
302
            repo_transport,
 
303
            file_mode=control_files._file_mode,
 
304
            prefixed=False,
 
305
            precious=True,
 
306
            versionedfile_class=knit.make_file_knit,
 
307
            versionedfile_kwargs={'delta':False,
 
308
                                  'factory':knit.KnitPlainFactory(),
 
309
                                 },
 
310
            escaped=True,
 
311
            )
 
312
        return KnitRevisionStore(versioned_file_store)
 
313
 
 
314
    def _get_text_store(self, transport, control_files):
 
315
        """See RepositoryFormat._get_text_store()."""
 
316
        return self._get_versioned_file_store('knits',
 
317
                                  transport,
 
318
                                  control_files,
 
319
                                  versionedfile_class=knit.make_file_knit,
 
320
                                  versionedfile_kwargs={
 
321
                                      'create_parent_dir':True,
 
322
                                      'delay_create':True,
 
323
                                      'dir_mode':control_files._dir_mode,
 
324
                                  },
 
325
                                  escaped=True)
336
326
 
337
327
    def initialize(self, a_bzrdir, shared=False):
338
328
        """Create a knit format 1 repository.
342
332
        :param shared: If true the repository will be initialized as a shared
343
333
                       repository.
344
334
        """
345
 
        trace.mutter('creating repository in %s.', a_bzrdir.transport.base)
 
335
        mutter('creating repository in %s.', a_bzrdir.transport.base)
346
336
        dirs = ['knits']
347
337
        files = []
348
338
        utf8_files = [('format', self.get_format_string())]
349
 
 
 
339
        
350
340
        self._upload_blank_content(a_bzrdir, dirs, files, utf8_files, shared)
351
341
        repo_transport = a_bzrdir.get_repository_transport(None)
352
342
        control_files = lockable_files.LockableFiles(repo_transport,
353
343
                                'lock', lockdir.LockDir)
 
344
        control_store = self._get_control_store(repo_transport, control_files)
354
345
        transaction = transactions.WriteTransaction()
355
 
        result = self.open(a_bzrdir=a_bzrdir, _found=True)
356
 
        result.lock_write()
 
346
        # trigger a write of the inventory store.
 
347
        control_store.get_weave_or_empty('inventory', transaction)
 
348
        _revision_store = self._get_revision_store(repo_transport, control_files)
357
349
        # the revision id here is irrelevant: it will not be stored, and cannot
358
 
        # already exist, we do this to create files on disk for older clients.
359
 
        result.inventories.get_parent_map([('A',)])
360
 
        result.revisions.get_parent_map([('A',)])
361
 
        result.signatures.get_parent_map([('A',)])
362
 
        result.unlock()
363
 
        self._run_post_repo_init_hooks(result, a_bzrdir, shared)
364
 
        return result
 
350
        # already exist.
 
351
        _revision_store.has_revision_id('A', transaction)
 
352
        _revision_store.get_signature_file(transaction)
 
353
        return self.open(a_bzrdir=a_bzrdir, _found=True)
365
354
 
366
355
    def open(self, a_bzrdir, _found=False, _override_transport=None):
367
356
        """See RepositoryFormat.open().
368
 
 
 
357
        
369
358
        :param _override_transport: INTERNAL USE ONLY. Allows opening the
370
359
                                    repository at a slightly different url
371
360
                                    than normal. I.e. during 'upgrade'.
378
367
            repo_transport = a_bzrdir.get_repository_transport(None)
379
368
        control_files = lockable_files.LockableFiles(repo_transport,
380
369
                                'lock', lockdir.LockDir)
381
 
        repo = self.repository_class(_format=self,
 
370
        text_store = self._get_text_store(repo_transport, control_files)
 
371
        control_store = self._get_control_store(repo_transport, control_files)
 
372
        _revision_store = self._get_revision_store(repo_transport, control_files)
 
373
        return self.repository_class(_format=self,
382
374
                              a_bzrdir=a_bzrdir,
383
375
                              control_files=control_files,
 
376
                              _revision_store=_revision_store,
 
377
                              control_store=control_store,
 
378
                              text_store=text_store,
384
379
                              _commit_builder_class=self._commit_builder_class,
385
380
                              _serializer=self._serializer)
386
 
        repo.revisions = self._get_revisions(repo_transport, repo)
387
 
        repo.signatures = self._get_signatures(repo_transport, repo)
388
 
        repo.inventories = self._get_inventories(repo_transport, repo)
389
 
        repo.texts = self._get_texts(repo_transport, repo)
390
 
        repo.chk_bytes = None
391
 
        repo._transport = repo_transport
392
 
        return repo
393
381
 
394
382
 
395
383
class RepositoryFormatKnit1(RepositoryFormatKnit):
410
398
 
411
399
    repository_class = KnitRepository
412
400
    _commit_builder_class = CommitBuilder
413
 
    @property
414
 
    def _serializer(self):
415
 
        return xml5.serializer_v5
 
401
    _serializer = xml5.serializer_v5
416
402
 
417
403
    def __ne__(self, other):
418
404
        return self.__class__ is not other.__class__
425
411
        """See RepositoryFormat.get_format_description()."""
426
412
        return "Knit repository format 1"
427
413
 
 
414
    def check_conversion_target(self, target_format):
 
415
        pass
 
416
 
428
417
 
429
418
class RepositoryFormatKnit3(RepositoryFormatKnit):
430
419
    """Bzr repository knit format 3.
445
434
    repository_class = KnitRepository
446
435
    _commit_builder_class = RootCommitBuilder
447
436
    rich_root_data = True
448
 
    experimental = True
449
437
    supports_tree_reference = True
450
 
    @property
451
 
    def _serializer(self):
452
 
        return xml7.serializer_v7
 
438
    _serializer = xml7.serializer_v7
453
439
 
454
440
    def _get_matching_bzrdir(self):
455
441
        return bzrdir.format_registry.make_bzrdir('dirstate-with-subtree')
459
445
 
460
446
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
461
447
 
 
448
    def check_conversion_target(self, target_format):
 
449
        if not target_format.rich_root_data:
 
450
            raise errors.BadConversionTarget(
 
451
                'Does not support rich root data.', target_format)
 
452
        if not getattr(target_format, 'supports_tree_reference', False):
 
453
            raise errors.BadConversionTarget(
 
454
                'Does not support nested trees', target_format)
 
455
            
462
456
    def get_format_string(self):
463
457
        """See RepositoryFormat.get_format_string()."""
464
458
        return "Bazaar Knit Repository Format 3 (bzr 0.15)\n"
488
482
    _commit_builder_class = RootCommitBuilder
489
483
    rich_root_data = True
490
484
    supports_tree_reference = False
491
 
    @property
492
 
    def _serializer(self):
493
 
        return xml6.serializer_v6
 
485
    _serializer = xml6.serializer_v6
494
486
 
495
487
    def _get_matching_bzrdir(self):
496
488
        return bzrdir.format_registry.make_bzrdir('rich-root')
500
492
 
501
493
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
502
494
 
 
495
    def check_conversion_target(self, target_format):
 
496
        if not target_format.rich_root_data:
 
497
            raise errors.BadConversionTarget(
 
498
                'Does not support rich root data.', target_format)
 
499
 
503
500
    def get_format_string(self):
504
501
        """See RepositoryFormat.get_format_string()."""
505
502
        return 'Bazaar Knit Repository Format 4 (bzr 1.0)\n'
507
504
    def get_format_description(self):
508
505
        """See RepositoryFormat.get_format_description()."""
509
506
        return "Knit repository format 4"
 
507
 
 
508
 
 
509
def _get_stream_as_bytes(knit, required_versions):
 
510
    """Generate a serialised data stream.
 
511
 
 
512
    The format is a bencoding of a list.  The first element of the list is a
 
513
    string of the format signature, then each subsequent element is a list
 
514
    corresponding to a record.  Those lists contain:
 
515
 
 
516
      * a version id
 
517
      * a list of options
 
518
      * a list of parents
 
519
      * the bytes
 
520
 
 
521
    :returns: a bencoded list.
 
522
    """
 
523
    knit_stream = knit.get_data_stream(required_versions)
 
524
    format_signature, data_list, callable = knit_stream
 
525
    data = []
 
526
    data.append(format_signature)
 
527
    for version, options, length, parents in data_list:
 
528
        data.append([version, options, parents, callable(length)])
 
529
    return bencode.bencode(data)