~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/repository.py

  • Committer: Robert Collins
  • Date: 2007-07-04 08:08:13 UTC
  • mfrom: (2572 +trunk)
  • mto: This revision was merged to the branch mainline in revision 2587.
  • Revision ID: robertc@robertcollins.net-20070704080813-wzebx0r88fvwj5rq
Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006 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
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
 
from binascii import hexlify
18
 
from copy import deepcopy
19
17
from cStringIO import StringIO
 
18
 
 
19
from bzrlib.lazy_import import lazy_import
 
20
lazy_import(globals(), """
20
21
import re
21
22
import time
22
 
from unittest import TestSuite
23
23
 
24
24
from bzrlib import (
25
 
    bzrdir, 
26
 
    check, 
27
 
    delta, 
28
 
    gpg, 
29
 
    errors, 
 
25
    bzrdir,
 
26
    check,
 
27
    deprecated_graph,
 
28
    errors,
 
29
    generate_ids,
 
30
    gpg,
 
31
    graph,
 
32
    lazy_regex,
 
33
    lockable_files,
 
34
    lockdir,
30
35
    osutils,
 
36
    registry,
 
37
    remote,
 
38
    revision as _mod_revision,
 
39
    symbol_versioning,
31
40
    transactions,
32
 
    ui, 
33
 
    xml5, 
34
 
    xml6,
 
41
    ui,
35
42
    )
 
43
from bzrlib.revisiontree import RevisionTree
 
44
from bzrlib.store.versioned import VersionedFileStore
 
45
from bzrlib.store.text import TextStore
 
46
from bzrlib.testament import Testament
 
47
 
 
48
""")
 
49
 
36
50
from bzrlib.decorators import needs_read_lock, needs_write_lock
37
 
from bzrlib.errors import InvalidRevisionId
38
 
from bzrlib.graph import Graph
39
51
from bzrlib.inter import InterObject
40
52
from bzrlib.inventory import Inventory, InventoryDirectory, ROOT_ID
41
 
from bzrlib.knit import KnitVersionedFile, KnitPlainFactory
42
 
from bzrlib.lockable_files import LockableFiles, TransportLock
43
 
from bzrlib.lockdir import LockDir
44
 
from bzrlib.osutils import (safe_unicode, rand_bytes, compact_date, 
45
 
                            local_time_offset)
46
 
from bzrlib.revision import NULL_REVISION, Revision
47
 
from bzrlib.revisiontree import RevisionTree
48
 
from bzrlib.store.versioned import VersionedFileStore, WeaveStore
49
 
from bzrlib.store.text import TextStore
50
 
from bzrlib import symbol_versioning
51
 
from bzrlib.symbol_versioning import (deprecated_method,
52
 
        zero_nine, 
 
53
from bzrlib.symbol_versioning import (
 
54
        deprecated_method,
 
55
        zero_nine,
53
56
        )
54
 
from bzrlib.testament import Testament
55
57
from bzrlib.trace import mutter, note, warning
56
 
from bzrlib.tsort import topo_sort
57
 
from bzrlib.weave import WeaveFile
58
58
 
59
59
 
60
60
# Old formats display a warning, but only once
61
61
_deprecation_warning_done = False
62
62
 
63
63
 
 
64
######################################################################
 
65
# Repositories
 
66
 
64
67
class Repository(object):
65
68
    """Repository holding history for one or more branches.
66
69
 
73
76
    remote) disk.
74
77
    """
75
78
 
 
79
    _file_ids_altered_regex = lazy_regex.lazy_compile(
 
80
        r'file_id="(?P<file_id>[^"]+)"'
 
81
        r'.*revision="(?P<revision_id>[^"]+)"'
 
82
        )
 
83
 
76
84
    @needs_write_lock
77
 
    def add_inventory(self, revid, inv, parents):
78
 
        """Add the inventory inv to the repository as revid.
 
85
    def add_inventory(self, revision_id, inv, parents):
 
86
        """Add the inventory inv to the repository as revision_id.
79
87
        
80
 
        :param parents: The revision ids of the parents that revid
 
88
        :param parents: The revision ids of the parents that revision_id
81
89
                        is known to have and are in the repository already.
82
90
 
83
91
        returns the sha1 of the serialized inventory.
84
92
        """
85
 
        assert inv.revision_id is None or inv.revision_id == revid, \
 
93
        revision_id = osutils.safe_revision_id(revision_id)
 
94
        _mod_revision.check_not_reserved_id(revision_id)
 
95
        assert inv.revision_id is None or inv.revision_id == revision_id, \
86
96
            "Mismatch between inventory revision" \
87
 
            " id and insertion revid (%r, %r)" % (inv.revision_id, revid)
 
97
            " id and insertion revid (%r, %r)" % (inv.revision_id, revision_id)
88
98
        assert inv.root is not None
89
99
        inv_text = self.serialise_inventory(inv)
90
100
        inv_sha1 = osutils.sha_string(inv_text)
91
101
        inv_vf = self.control_weaves.get_weave('inventory',
92
102
                                               self.get_transaction())
93
 
        self._inventory_add_lines(inv_vf, revid, parents, osutils.split_lines(inv_text))
 
103
        self._inventory_add_lines(inv_vf, revision_id, parents,
 
104
                                  osutils.split_lines(inv_text))
94
105
        return inv_sha1
95
106
 
96
 
    def _inventory_add_lines(self, inv_vf, revid, parents, lines):
 
107
    def _inventory_add_lines(self, inv_vf, revision_id, parents, lines):
97
108
        final_parents = []
98
109
        for parent in parents:
99
110
            if parent in inv_vf:
100
111
                final_parents.append(parent)
101
112
 
102
 
        inv_vf.add_lines(revid, final_parents, lines)
 
113
        inv_vf.add_lines(revision_id, final_parents, lines)
103
114
 
104
115
    @needs_write_lock
105
 
    def add_revision(self, rev_id, rev, inv=None, config=None):
106
 
        """Add rev to the revision store as rev_id.
 
116
    def add_revision(self, revision_id, rev, inv=None, config=None):
 
117
        """Add rev to the revision store as revision_id.
107
118
 
108
 
        :param rev_id: the revision id to use.
 
119
        :param revision_id: the revision id to use.
109
120
        :param rev: The revision object.
110
121
        :param inv: The inventory for the revision. if None, it will be looked
111
122
                    up in the inventory storer
113
124
                       If supplied its signature_needed method will be used
114
125
                       to determine if a signature should be made.
115
126
        """
 
127
        revision_id = osutils.safe_revision_id(revision_id)
 
128
        # TODO: jam 20070210 Shouldn't we check rev.revision_id and
 
129
        #       rev.parent_ids?
 
130
        _mod_revision.check_not_reserved_id(revision_id)
116
131
        if config is not None and config.signature_needed():
117
132
            if inv is None:
118
 
                inv = self.get_inventory(rev_id)
 
133
                inv = self.get_inventory(revision_id)
119
134
            plaintext = Testament(rev, inv).as_short_text()
120
135
            self.store_revision_signature(
121
 
                gpg.GPGStrategy(config), plaintext, rev_id)
122
 
        if not rev_id in self.get_inventory_weave():
 
136
                gpg.GPGStrategy(config), plaintext, revision_id)
 
137
        if not revision_id in self.get_inventory_weave():
123
138
            if inv is None:
124
 
                raise errors.WeaveRevisionNotPresent(rev_id,
 
139
                raise errors.WeaveRevisionNotPresent(revision_id,
125
140
                                                     self.get_inventory_weave())
126
141
            else:
127
142
                # yes, this is not suitable for adding with ghosts.
128
 
                self.add_inventory(rev_id, inv, rev.parent_ids)
 
143
                self.add_inventory(revision_id, inv, rev.parent_ids)
129
144
        self._revision_store.add_revision(rev, self.get_transaction())
130
145
 
131
146
    @needs_read_lock
153
168
        if self._revision_store.text_store.listable():
154
169
            return self._revision_store.all_revision_ids(self.get_transaction())
155
170
        result = self._all_possible_ids()
 
171
        # TODO: jam 20070210 Ensure that _all_possible_ids returns non-unicode
 
172
        #       ids. (It should, since _revision_store's API should change to
 
173
        #       return utf8 revision_ids)
156
174
        return self._eliminate_revisions_not_present(result)
157
175
 
158
176
    def break_lock(self):
206
224
        # TODO: make sure to construct the right store classes, etc, depending
207
225
        # on whether escaping is required.
208
226
        self._warn_if_deprecated()
209
 
        self._serializer = xml5.serializer_v5
210
227
 
211
228
    def __repr__(self):
212
229
        return '%s(%r)' % (self.__class__.__name__, 
215
232
    def is_locked(self):
216
233
        return self.control_files.is_locked()
217
234
 
218
 
    def lock_write(self):
219
 
        self.control_files.lock_write()
 
235
    def lock_write(self, token=None):
 
236
        """Lock this repository for writing.
 
237
        
 
238
        :param token: if this is already locked, then lock_write will fail
 
239
            unless the token matches the existing lock.
 
240
        :returns: a token if this instance supports tokens, otherwise None.
 
241
        :raises TokenLockingNotSupported: when a token is given but this
 
242
            instance doesn't support using token locks.
 
243
        :raises MismatchedToken: if the specified token doesn't match the token
 
244
            of the existing lock.
 
245
 
 
246
        A token should be passed in if you know that you have locked the object
 
247
        some other way, and need to synchronise this object's state with that
 
248
        fact.
 
249
 
 
250
        XXX: this docstring is duplicated in many places, e.g. lockable_files.py
 
251
        """
 
252
        return self.control_files.lock_write(token=token)
220
253
 
221
254
    def lock_read(self):
222
255
        self.control_files.lock_read()
224
257
    def get_physical_lock_status(self):
225
258
        return self.control_files.get_physical_lock_status()
226
259
 
 
260
    def leave_lock_in_place(self):
 
261
        """Tell this repository not to release the physical lock when this
 
262
        object is unlocked.
 
263
        
 
264
        If lock_write doesn't return a token, then this method is not supported.
 
265
        """
 
266
        self.control_files.leave_in_place()
 
267
 
 
268
    def dont_leave_lock_in_place(self):
 
269
        """Tell this repository to release the physical lock when this
 
270
        object is unlocked, even if it didn't originally acquire it.
 
271
 
 
272
        If lock_write doesn't return a token, then this method is not supported.
 
273
        """
 
274
        self.control_files.dont_leave_in_place()
 
275
 
 
276
    @needs_read_lock
 
277
    def gather_stats(self, revid=None, committers=None):
 
278
        """Gather statistics from a revision id.
 
279
 
 
280
        :param revid: The revision id to gather statistics from, if None, then
 
281
            no revision specific statistics are gathered.
 
282
        :param committers: Optional parameter controlling whether to grab
 
283
            a count of committers from the revision specific statistics.
 
284
        :return: A dictionary of statistics. Currently this contains:
 
285
            committers: The number of committers if requested.
 
286
            firstrev: A tuple with timestamp, timezone for the penultimate left
 
287
                most ancestor of revid, if revid is not the NULL_REVISION.
 
288
            latestrev: A tuple with timestamp, timezone for revid, if revid is
 
289
                not the NULL_REVISION.
 
290
            revisions: The total revision count in the repository.
 
291
            size: An estimate disk size of the repository in bytes.
 
292
        """
 
293
        result = {}
 
294
        if revid and committers:
 
295
            result['committers'] = 0
 
296
        if revid and revid != _mod_revision.NULL_REVISION:
 
297
            if committers:
 
298
                all_committers = set()
 
299
            revisions = self.get_ancestry(revid)
 
300
            # pop the leading None
 
301
            revisions.pop(0)
 
302
            first_revision = None
 
303
            if not committers:
 
304
                # ignore the revisions in the middle - just grab first and last
 
305
                revisions = revisions[0], revisions[-1]
 
306
            for revision in self.get_revisions(revisions):
 
307
                if not first_revision:
 
308
                    first_revision = revision
 
309
                if committers:
 
310
                    all_committers.add(revision.committer)
 
311
            last_revision = revision
 
312
            if committers:
 
313
                result['committers'] = len(all_committers)
 
314
            result['firstrev'] = (first_revision.timestamp,
 
315
                first_revision.timezone)
 
316
            result['latestrev'] = (last_revision.timestamp,
 
317
                last_revision.timezone)
 
318
 
 
319
        # now gather global repository information
 
320
        if self.bzrdir.root_transport.listable():
 
321
            c, t = self._revision_store.total_size(self.get_transaction())
 
322
            result['revisions'] = c
 
323
            result['size'] = t
 
324
        return result
 
325
 
227
326
    @needs_read_lock
228
327
    def missing_revision_ids(self, other, revision_id=None):
229
328
        """Return the revision ids that other has that this does not.
232
331
 
233
332
        revision_id: only return revision ids included by revision_id.
234
333
        """
 
334
        revision_id = osutils.safe_revision_id(revision_id)
235
335
        return InterRepository.get(other, self).missing_revision_ids(revision_id)
236
336
 
237
337
    @staticmethod
244
344
        control = bzrdir.BzrDir.open(base)
245
345
        return control.open_repository()
246
346
 
247
 
    def copy_content_into(self, destination, revision_id=None, basis=None):
 
347
    def copy_content_into(self, destination, revision_id=None):
248
348
        """Make a complete copy of the content in self into destination.
249
349
        
250
350
        This is a destructive operation! Do not use it on existing 
251
351
        repositories.
252
352
        """
253
 
        return InterRepository.get(self, destination).copy_content(revision_id, basis)
 
353
        revision_id = osutils.safe_revision_id(revision_id)
 
354
        return InterRepository.get(self, destination).copy_content(revision_id)
254
355
 
255
356
    def fetch(self, source, revision_id=None, pb=None):
256
357
        """Fetch the content required to construct revision_id from source.
257
358
 
258
359
        If revision_id is None all content is copied.
259
360
        """
260
 
        return InterRepository.get(source, self).fetch(revision_id=revision_id,
261
 
                                                       pb=pb)
 
361
        revision_id = osutils.safe_revision_id(revision_id)
 
362
        inter = InterRepository.get(source, self)
 
363
        try:
 
364
            return inter.fetch(revision_id=revision_id, pb=pb)
 
365
        except NotImplementedError:
 
366
            raise errors.IncompatibleRepositories(source, self)
262
367
 
263
368
    def get_commit_builder(self, branch, parents, config, timestamp=None, 
264
369
                           timezone=None, committer=None, revprops=None, 
274
379
        :param revprops: Optional dictionary of revision properties.
275
380
        :param revision_id: Optional revision id.
276
381
        """
 
382
        revision_id = osutils.safe_revision_id(revision_id)
277
383
        return _CommitBuilder(self, parents, config, timestamp, timezone,
278
384
                              committer, revprops, revision_id)
279
385
 
281
387
        self.control_files.unlock()
282
388
 
283
389
    @needs_read_lock
284
 
    def clone(self, a_bzrdir, revision_id=None, basis=None):
 
390
    def clone(self, a_bzrdir, revision_id=None):
285
391
        """Clone this repository into a_bzrdir using the current format.
286
392
 
287
393
        Currently no check is made that the format of this repository and
288
394
        the bzrdir format are compatible. FIXME RBC 20060201.
289
 
        """
 
395
 
 
396
        :return: The newly created destination repository.
 
397
        """
 
398
        # TODO: deprecate after 0.16; cloning this with all its settings is
 
399
        # probably not very useful -- mbp 20070423
 
400
        dest_repo = self._create_sprouting_repo(a_bzrdir, shared=self.is_shared())
 
401
        self.copy_content_into(dest_repo, revision_id)
 
402
        return dest_repo
 
403
 
 
404
    @needs_read_lock
 
405
    def sprout(self, to_bzrdir, revision_id=None):
 
406
        """Create a descendent repository for new development.
 
407
 
 
408
        Unlike clone, this does not copy the settings of the repository.
 
409
        """
 
410
        dest_repo = self._create_sprouting_repo(to_bzrdir, shared=False)
 
411
        dest_repo.fetch(self, revision_id=revision_id)
 
412
        return dest_repo
 
413
 
 
414
    def _create_sprouting_repo(self, a_bzrdir, shared):
290
415
        if not isinstance(a_bzrdir._format, self.bzrdir._format.__class__):
291
416
            # use target default format.
292
 
            result = a_bzrdir.create_repository()
293
 
        # FIXME RBC 20060209 split out the repository type to avoid this check ?
294
 
        elif isinstance(a_bzrdir._format,
295
 
                      (bzrdir.BzrDirFormat4,
296
 
                       bzrdir.BzrDirFormat5,
297
 
                       bzrdir.BzrDirFormat6)):
298
 
            result = a_bzrdir.open_repository()
 
417
            dest_repo = a_bzrdir.create_repository()
299
418
        else:
300
 
            result = self._format.initialize(a_bzrdir, shared=self.is_shared())
301
 
        self.copy_content_into(result, revision_id, basis)
302
 
        return result
 
419
            # Most control formats need the repository to be specifically
 
420
            # created, but on some old all-in-one formats it's not needed
 
421
            try:
 
422
                dest_repo = self._format.initialize(a_bzrdir, shared=shared)
 
423
            except errors.UninitializableFormat:
 
424
                dest_repo = a_bzrdir.open_repository()
 
425
        return dest_repo
303
426
 
304
427
    @needs_read_lock
305
428
    def has_revision(self, revision_id):
306
429
        """True if this repository has a copy of the revision."""
 
430
        revision_id = osutils.safe_revision_id(revision_id)
307
431
        return self._revision_store.has_revision_id(revision_id,
308
432
                                                    self.get_transaction())
309
433
 
317
441
        or testing the revision graph.
318
442
        """
319
443
        if not revision_id or not isinstance(revision_id, basestring):
320
 
            raise InvalidRevisionId(revision_id=revision_id, branch=self)
321
 
        return self._revision_store.get_revisions([revision_id],
322
 
                                                  self.get_transaction())[0]
 
444
            raise errors.InvalidRevisionId(revision_id=revision_id,
 
445
                                           branch=self)
 
446
        return self.get_revisions([revision_id])[0]
 
447
 
323
448
    @needs_read_lock
324
449
    def get_revisions(self, revision_ids):
325
 
        return self._revision_store.get_revisions(revision_ids,
 
450
        revision_ids = [osutils.safe_revision_id(r) for r in revision_ids]
 
451
        revs = self._revision_store.get_revisions(revision_ids,
326
452
                                                  self.get_transaction())
 
453
        for rev in revs:
 
454
            assert not isinstance(rev.revision_id, unicode)
 
455
            for parent_id in rev.parent_ids:
 
456
                assert not isinstance(parent_id, unicode)
 
457
        return revs
327
458
 
328
459
    @needs_read_lock
329
460
    def get_revision_xml(self, revision_id):
330
 
        rev = self.get_revision(revision_id) 
 
461
        # TODO: jam 20070210 This shouldn't be necessary since get_revision
 
462
        #       would have already do it.
 
463
        # TODO: jam 20070210 Just use _serializer.write_revision_to_string()
 
464
        revision_id = osutils.safe_revision_id(revision_id)
 
465
        rev = self.get_revision(revision_id)
331
466
        rev_tmp = StringIO()
332
467
        # the current serializer..
333
468
        self._revision_store._serializer.write_revision(rev, rev_tmp)
337
472
    @needs_read_lock
338
473
    def get_revision(self, revision_id):
339
474
        """Return the Revision object for a named revision"""
 
475
        # TODO: jam 20070210 get_revision_reconcile should do this for us
 
476
        revision_id = osutils.safe_revision_id(revision_id)
340
477
        r = self.get_revision_reconcile(revision_id)
341
478
        # weave corruption can lead to absent revision markers that should be
342
479
        # present.
398
535
 
399
536
    @needs_write_lock
400
537
    def store_revision_signature(self, gpg_strategy, plaintext, revision_id):
 
538
        revision_id = osutils.safe_revision_id(revision_id)
401
539
        signature = gpg_strategy.sign(plaintext)
402
540
        self._revision_store.add_revision_signature_text(revision_id,
403
541
                                                         signature,
414
552
        assert self._serializer.support_altered_by_hack, \
415
553
            ("fileids_altered_by_revision_ids only supported for branches " 
416
554
             "which store inventory as unnested xml, not on %r" % self)
417
 
        selected_revision_ids = set(revision_ids)
 
555
        selected_revision_ids = set(osutils.safe_revision_id(r)
 
556
                                    for r in revision_ids)
418
557
        w = self.get_inventory_weave()
419
558
        result = {}
420
559
 
426
565
        # revisions. We don't need to see all lines in the inventory because
427
566
        # only those added in an inventory in rev X can contain a revision=X
428
567
        # line.
 
568
        unescape_revid_cache = {}
 
569
        unescape_fileid_cache = {}
 
570
 
 
571
        # jam 20061218 In a big fetch, this handles hundreds of thousands
 
572
        # of lines, so it has had a lot of inlining and optimizing done.
 
573
        # Sorry that it is a little bit messy.
 
574
        # Move several functions to be local variables, since this is a long
 
575
        # running loop.
 
576
        search = self._file_ids_altered_regex.search
 
577
        unescape = _unescape_xml
 
578
        setdefault = result.setdefault
429
579
        pb = ui.ui_factory.nested_progress_bar()
430
580
        try:
431
581
            for line in w.iter_lines_added_or_present_in_versions(
432
 
                selected_revision_ids, pb=pb):
433
 
                start = line.find('file_id="')+9
434
 
                if start < 9: continue
435
 
                end = line.find('"', start)
436
 
                assert end>= 0
437
 
                file_id = _unescape_xml(line[start:end])
438
 
 
439
 
                start = line.find('revision="')+10
440
 
                if start < 10: continue
441
 
                end = line.find('"', start)
442
 
                assert end>= 0
443
 
                revision_id = _unescape_xml(line[start:end])
 
582
                                        selected_revision_ids, pb=pb):
 
583
                match = search(line)
 
584
                if match is None:
 
585
                    continue
 
586
                # One call to match.group() returning multiple items is quite a
 
587
                # bit faster than 2 calls to match.group() each returning 1
 
588
                file_id, revision_id = match.group('file_id', 'revision_id')
 
589
 
 
590
                # Inlining the cache lookups helps a lot when you make 170,000
 
591
                # lines and 350k ids, versus 8.4 unique ids.
 
592
                # Using a cache helps in 2 ways:
 
593
                #   1) Avoids unnecessary decoding calls
 
594
                #   2) Re-uses cached strings, which helps in future set and
 
595
                #      equality checks.
 
596
                # (2) is enough that removing encoding entirely along with
 
597
                # the cache (so we are using plain strings) results in no
 
598
                # performance improvement.
 
599
                try:
 
600
                    revision_id = unescape_revid_cache[revision_id]
 
601
                except KeyError:
 
602
                    unescaped = unescape(revision_id)
 
603
                    unescape_revid_cache[revision_id] = unescaped
 
604
                    revision_id = unescaped
 
605
 
444
606
                if revision_id in selected_revision_ids:
445
 
                    result.setdefault(file_id, set()).add(revision_id)
 
607
                    try:
 
608
                        file_id = unescape_fileid_cache[file_id]
 
609
                    except KeyError:
 
610
                        unescaped = unescape(file_id)
 
611
                        unescape_fileid_cache[file_id] = unescaped
 
612
                        file_id = unescaped
 
613
                    setdefault(file_id, set()).add(revision_id)
446
614
        finally:
447
615
            pb.finished()
448
616
        return result
455
623
    @needs_read_lock
456
624
    def get_inventory(self, revision_id):
457
625
        """Get Inventory object by hash."""
 
626
        # TODO: jam 20070210 Technically we don't need to sanitize, since all
 
627
        #       called functions must sanitize.
 
628
        revision_id = osutils.safe_revision_id(revision_id)
458
629
        return self.deserialise_inventory(
459
630
            revision_id, self.get_inventory_xml(revision_id))
460
631
 
464
635
        :param revision_id: The expected revision id of the inventory.
465
636
        :param xml: A serialised inventory.
466
637
        """
 
638
        revision_id = osutils.safe_revision_id(revision_id)
467
639
        result = self._serializer.read_inventory_from_string(xml)
468
640
        result.root.revision = revision_id
469
641
        return result
474
646
    @needs_read_lock
475
647
    def get_inventory_xml(self, revision_id):
476
648
        """Get inventory XML as a file object."""
 
649
        revision_id = osutils.safe_revision_id(revision_id)
477
650
        try:
478
 
            assert isinstance(revision_id, basestring), type(revision_id)
 
651
            assert isinstance(revision_id, str), type(revision_id)
479
652
            iw = self.get_inventory_weave()
480
653
            return iw.get_text(revision_id)
481
654
        except IndexError:
485
658
    def get_inventory_sha1(self, revision_id):
486
659
        """Return the sha1 hash of the inventory entry
487
660
        """
 
661
        # TODO: jam 20070210 Shouldn't this be deprecated / removed?
 
662
        revision_id = osutils.safe_revision_id(revision_id)
488
663
        return self.get_revision(revision_id).inventory_sha1
489
664
 
490
665
    @needs_read_lock
497
672
        :return: a dictionary of revision_id->revision_parents_list.
498
673
        """
499
674
        # special case NULL_REVISION
500
 
        if revision_id == NULL_REVISION:
 
675
        if revision_id == _mod_revision.NULL_REVISION:
501
676
            return {}
502
 
        weave = self.get_inventory_weave()
503
 
        all_revisions = self._eliminate_revisions_not_present(weave.versions())
504
 
        entire_graph = dict([(node, weave.get_parents(node)) for 
 
677
        revision_id = osutils.safe_revision_id(revision_id)
 
678
        a_weave = self.get_inventory_weave()
 
679
        all_revisions = self._eliminate_revisions_not_present(
 
680
                                a_weave.versions())
 
681
        entire_graph = dict([(node, a_weave.get_parents(node)) for 
505
682
                             node in all_revisions])
506
683
        if revision_id is None:
507
684
            return entire_graph
526
703
        :param revision_ids: an iterable of revisions to graph or None for all.
527
704
        :return: a Graph object with the graph reachable from revision_ids.
528
705
        """
529
 
        result = Graph()
 
706
        result = deprecated_graph.Graph()
530
707
        if not revision_ids:
531
708
            pending = set(self.all_revision_ids())
532
709
            required = set([])
533
710
        else:
534
 
            pending = set(revision_ids)
 
711
            pending = set(osutils.safe_revision_id(r) for r in revision_ids)
535
712
            # special case NULL_REVISION
536
 
            if NULL_REVISION in pending:
537
 
                pending.remove(NULL_REVISION)
 
713
            if _mod_revision.NULL_REVISION in pending:
 
714
                pending.remove(_mod_revision.NULL_REVISION)
538
715
            required = set(pending)
539
716
        done = set([])
540
717
        while len(pending):
557
734
            done.add(revision_id)
558
735
        return result
559
736
 
 
737
    def _get_history_vf(self):
 
738
        """Get a versionedfile whose history graph reflects all revisions.
 
739
 
 
740
        For weave repositories, this is the inventory weave.
 
741
        """
 
742
        return self.get_inventory_weave()
 
743
 
 
744
    def iter_reverse_revision_history(self, revision_id):
 
745
        """Iterate backwards through revision ids in the lefthand history
 
746
 
 
747
        :param revision_id: The revision id to start with.  All its lefthand
 
748
            ancestors will be traversed.
 
749
        """
 
750
        revision_id = osutils.safe_revision_id(revision_id)
 
751
        if revision_id in (None, _mod_revision.NULL_REVISION):
 
752
            return
 
753
        next_id = revision_id
 
754
        versionedfile = self._get_history_vf()
 
755
        while True:
 
756
            yield next_id
 
757
            parents = versionedfile.get_parents(next_id)
 
758
            if len(parents) == 0:
 
759
                return
 
760
            else:
 
761
                next_id = parents[0]
 
762
 
560
763
    @needs_read_lock
561
764
    def get_revision_inventory(self, revision_id):
562
765
        """Return inventory of a past revision."""
585
788
        reconciler = RepoReconciler(self, thorough=thorough)
586
789
        reconciler.reconcile()
587
790
        return reconciler
588
 
    
 
791
 
589
792
    @needs_read_lock
590
793
    def revision_tree(self, revision_id):
591
794
        """Return Tree for a revision on this branch.
594
797
        """
595
798
        # TODO: refactor this to use an existing revision object
596
799
        # so we don't need to read it in twice.
597
 
        if revision_id is None or revision_id == NULL_REVISION:
598
 
            return RevisionTree(self, Inventory(), NULL_REVISION)
 
800
        if revision_id is None or revision_id == _mod_revision.NULL_REVISION:
 
801
            return RevisionTree(self, Inventory(root_id=None), 
 
802
                                _mod_revision.NULL_REVISION)
599
803
        else:
 
804
            revision_id = osutils.safe_revision_id(revision_id)
600
805
            inv = self.get_revision_inventory(revision_id)
601
806
            return RevisionTree(self, inv, revision_id)
602
807
 
606
811
 
607
812
        `revision_id` may not be None or 'null:'"""
608
813
        assert None not in revision_ids
609
 
        assert NULL_REVISION not in revision_ids
 
814
        assert _mod_revision.NULL_REVISION not in revision_ids
610
815
        texts = self.get_inventory_weave().get_texts(revision_ids)
611
816
        for text, revision_id in zip(texts, revision_ids):
612
817
            inv = self.deserialise_inventory(revision_id, text)
613
818
            yield RevisionTree(self, inv, revision_id)
614
819
 
615
820
    @needs_read_lock
616
 
    def get_ancestry(self, revision_id):
 
821
    def get_ancestry(self, revision_id, topo_sorted=True):
617
822
        """Return a list of revision-ids integrated by a revision.
618
823
 
619
824
        The first element of the list is always None, indicating the origin 
624
829
        """
625
830
        if revision_id is None:
626
831
            return [None]
 
832
        revision_id = osutils.safe_revision_id(revision_id)
627
833
        if not self.has_revision(revision_id):
628
834
            raise errors.NoSuchRevision(self, revision_id)
629
835
        w = self.get_inventory_weave()
630
 
        candidates = w.get_ancestry(revision_id)
 
836
        candidates = w.get_ancestry(revision_id, topo_sorted)
631
837
        return [None] + candidates # self._eliminate_revisions_not_present(candidates)
632
838
 
633
839
    @needs_read_lock
638
844
        - it writes to stdout, it assumes that that is valid etc. Fix
639
845
        by creating a new more flexible convenience function.
640
846
        """
 
847
        revision_id = osutils.safe_revision_id(revision_id)
641
848
        tree = self.revision_tree(revision_id)
642
849
        # use inventory as it was in that revision
643
850
        file_id = tree.inventory.path2id(file)
651
858
    def get_transaction(self):
652
859
        return self.control_files.get_transaction()
653
860
 
654
 
    def revision_parents(self, revid):
655
 
        return self.get_inventory_weave().parent_names(revid)
 
861
    def revision_parents(self, revision_id):
 
862
        revision_id = osutils.safe_revision_id(revision_id)
 
863
        return self.get_inventory_weave().parent_names(revision_id)
 
864
 
 
865
    def get_parents(self, revision_ids):
 
866
        """See StackedParentsProvider.get_parents"""
 
867
        parents_list = []
 
868
        for revision_id in revision_ids:
 
869
            if revision_id == _mod_revision.NULL_REVISION:
 
870
                parents = []
 
871
            else:
 
872
                try:
 
873
                    parents = self.get_revision(revision_id).parent_ids
 
874
                except errors.NoSuchRevision:
 
875
                    parents = None
 
876
                else:
 
877
                    if len(parents) == 0:
 
878
                        parents = [_mod_revision.NULL_REVISION]
 
879
            parents_list.append(parents)
 
880
        return parents_list
 
881
 
 
882
    def _make_parents_provider(self):
 
883
        return self
 
884
 
 
885
    def get_graph(self, other_repository=None):
 
886
        """Return the graph walker for this repository format"""
 
887
        parents_provider = self._make_parents_provider()
 
888
        if (other_repository is not None and
 
889
            other_repository.bzrdir.transport.base !=
 
890
            self.bzrdir.transport.base):
 
891
            parents_provider = graph._StackedParentsProvider(
 
892
                [parents_provider, other_repository._make_parents_provider()])
 
893
        return graph.Graph(parents_provider)
656
894
 
657
895
    @needs_write_lock
658
896
    def set_make_working_trees(self, new_value):
672
910
 
673
911
    @needs_write_lock
674
912
    def sign_revision(self, revision_id, gpg_strategy):
 
913
        revision_id = osutils.safe_revision_id(revision_id)
675
914
        plaintext = Testament.from_revision(self, revision_id).as_short_text()
676
915
        self.store_revision_signature(gpg_strategy, plaintext, revision_id)
677
916
 
678
917
    @needs_read_lock
679
918
    def has_signature_for_revision_id(self, revision_id):
680
919
        """Query for a revision signature for revision_id in the repository."""
 
920
        revision_id = osutils.safe_revision_id(revision_id)
681
921
        return self._revision_store.has_signature(revision_id,
682
922
                                                  self.get_transaction())
683
923
 
684
924
    @needs_read_lock
685
925
    def get_signature_text(self, revision_id):
686
926
        """Return the text for a signature."""
 
927
        revision_id = osutils.safe_revision_id(revision_id)
687
928
        return self._revision_store.get_signature_text(revision_id,
688
929
                                                       self.get_transaction())
689
930
 
699
940
        if not revision_ids:
700
941
            raise ValueError("revision_ids must be non-empty in %s.check" 
701
942
                    % (self,))
 
943
        revision_ids = [osutils.safe_revision_id(r) for r in revision_ids]
702
944
        return self._check(revision_ids)
703
945
 
704
946
    def _check(self, revision_ids):
717
959
    def supports_rich_root(self):
718
960
        return self._format.rich_root_data
719
961
 
720
 
 
721
 
class AllInOneRepository(Repository):
722
 
    """Legacy support - the repository behaviour for all-in-one branches."""
723
 
 
724
 
    def __init__(self, _format, a_bzrdir, _revision_store, control_store, text_store):
725
 
        # we reuse one control files instance.
726
 
        dir_mode = a_bzrdir._control_files._dir_mode
727
 
        file_mode = a_bzrdir._control_files._file_mode
728
 
 
729
 
        def get_store(name, compressed=True, prefixed=False):
730
 
            # FIXME: This approach of assuming stores are all entirely compressed
731
 
            # or entirely uncompressed is tidy, but breaks upgrade from 
732
 
            # some existing branches where there's a mixture; we probably 
733
 
            # still want the option to look for both.
734
 
            relpath = a_bzrdir._control_files._escape(name)
735
 
            store = TextStore(a_bzrdir._control_files._transport.clone(relpath),
736
 
                              prefixed=prefixed, compressed=compressed,
737
 
                              dir_mode=dir_mode,
738
 
                              file_mode=file_mode)
739
 
            #if self._transport.should_cache():
740
 
            #    cache_path = os.path.join(self.cache_root, name)
741
 
            #    os.mkdir(cache_path)
742
 
            #    store = bzrlib.store.CachedStore(store, cache_path)
743
 
            return store
744
 
 
745
 
        # not broken out yet because the controlweaves|inventory_store
746
 
        # and text_store | weave_store bits are still different.
747
 
        if isinstance(_format, RepositoryFormat4):
748
 
            # cannot remove these - there is still no consistent api 
749
 
            # which allows access to this old info.
750
 
            self.inventory_store = get_store('inventory-store')
751
 
            text_store = get_store('text-store')
752
 
        super(AllInOneRepository, self).__init__(_format, a_bzrdir, a_bzrdir._control_files, _revision_store, control_store, text_store)
753
 
 
754
 
    @needs_read_lock
755
 
    def is_shared(self):
756
 
        """AllInOne repositories cannot be shared."""
757
 
        return False
758
 
 
759
 
    @needs_write_lock
760
 
    def set_make_working_trees(self, new_value):
761
 
        """Set the policy flag for making working trees when creating branches.
762
 
 
763
 
        This only applies to branches that use this repository.
764
 
 
765
 
        The default is 'True'.
766
 
        :param new_value: True to restore the default, False to disable making
767
 
                          working trees.
768
 
        """
769
 
        raise NotImplementedError(self.set_make_working_trees)
770
 
    
771
 
    def make_working_trees(self):
772
 
        """Returns the policy for making working trees on new branches."""
773
 
        return True
 
962
    def _check_ascii_revisionid(self, revision_id, method):
 
963
        """Private helper for ascii-only repositories."""
 
964
        # weave repositories refuse to store revisionids that are non-ascii.
 
965
        if revision_id is not None:
 
966
            # weaves require ascii revision ids.
 
967
            if isinstance(revision_id, unicode):
 
968
                try:
 
969
                    revision_id.encode('ascii')
 
970
                except UnicodeEncodeError:
 
971
                    raise errors.NonAsciiRevisionId(method, self)
 
972
            else:
 
973
                try:
 
974
                    revision_id.decode('ascii')
 
975
                except UnicodeDecodeError:
 
976
                    raise errors.NonAsciiRevisionId(method, self)
 
977
 
 
978
 
 
979
 
 
980
# remove these delegates a while after bzr 0.15
 
981
def __make_delegated(name, from_module):
 
982
    def _deprecated_repository_forwarder():
 
983
        symbol_versioning.warn('%s moved to %s in bzr 0.15'
 
984
            % (name, from_module),
 
985
            DeprecationWarning,
 
986
            stacklevel=2)
 
987
        m = __import__(from_module, globals(), locals(), [name])
 
988
        try:
 
989
            return getattr(m, name)
 
990
        except AttributeError:
 
991
            raise AttributeError('module %s has no name %s'
 
992
                    % (m, name))
 
993
    globals()[name] = _deprecated_repository_forwarder
 
994
 
 
995
for _name in [
 
996
        'AllInOneRepository',
 
997
        'WeaveMetaDirRepository',
 
998
        'PreSplitOutRepositoryFormat',
 
999
        'RepositoryFormat4',
 
1000
        'RepositoryFormat5',
 
1001
        'RepositoryFormat6',
 
1002
        'RepositoryFormat7',
 
1003
        ]:
 
1004
    __make_delegated(_name, 'bzrlib.repofmt.weaverepo')
 
1005
 
 
1006
for _name in [
 
1007
        'KnitRepository',
 
1008
        'RepositoryFormatKnit',
 
1009
        'RepositoryFormatKnit1',
 
1010
        ]:
 
1011
    __make_delegated(_name, 'bzrlib.repofmt.knitrepo')
774
1012
 
775
1013
 
776
1014
def install_revision(repository, rev, revision_tree):
862
1100
        return not self.control_files._transport.has('no-working-trees')
863
1101
 
864
1102
 
865
 
class KnitRepository(MetaDirRepository):
866
 
    """Knit format repository."""
867
 
 
868
 
    def _warn_if_deprecated(self):
869
 
        # This class isn't deprecated
870
 
        pass
871
 
 
872
 
    def _inventory_add_lines(self, inv_vf, revid, parents, lines):
873
 
        inv_vf.add_lines_with_ghosts(revid, parents, lines)
874
 
 
875
 
    @needs_read_lock
876
 
    def _all_revision_ids(self):
877
 
        """See Repository.all_revision_ids()."""
878
 
        # Knits get the revision graph from the index of the revision knit, so
879
 
        # it's always possible even if they're on an unlistable transport.
880
 
        return self._revision_store.all_revision_ids(self.get_transaction())
881
 
 
882
 
    def fileid_involved_between_revs(self, from_revid, to_revid):
883
 
        """Find file_id(s) which are involved in the changes between revisions.
884
 
 
885
 
        This determines the set of revisions which are involved, and then
886
 
        finds all file ids affected by those revisions.
887
 
        """
888
 
        vf = self._get_revision_vf()
889
 
        from_set = set(vf.get_ancestry(from_revid))
890
 
        to_set = set(vf.get_ancestry(to_revid))
891
 
        changed = to_set.difference(from_set)
892
 
        return self._fileid_involved_by_set(changed)
893
 
 
894
 
    def fileid_involved(self, last_revid=None):
895
 
        """Find all file_ids modified in the ancestry of last_revid.
896
 
 
897
 
        :param last_revid: If None, last_revision() will be used.
898
 
        """
899
 
        if not last_revid:
900
 
            changed = set(self.all_revision_ids())
901
 
        else:
902
 
            changed = set(self.get_ancestry(last_revid))
903
 
        if None in changed:
904
 
            changed.remove(None)
905
 
        return self._fileid_involved_by_set(changed)
906
 
 
907
 
    @needs_read_lock
908
 
    def get_ancestry(self, revision_id):
909
 
        """Return a list of revision-ids integrated by a revision.
910
 
        
911
 
        This is topologically sorted.
912
 
        """
913
 
        if revision_id is None:
914
 
            return [None]
915
 
        vf = self._get_revision_vf()
916
 
        try:
917
 
            return [None] + vf.get_ancestry(revision_id)
918
 
        except errors.RevisionNotPresent:
919
 
            raise errors.NoSuchRevision(self, revision_id)
920
 
 
921
 
    @needs_read_lock
922
 
    def get_revision(self, revision_id):
923
 
        """Return the Revision object for a named revision"""
924
 
        return self.get_revision_reconcile(revision_id)
925
 
 
926
 
    @needs_read_lock
927
 
    def get_revision_graph(self, revision_id=None):
928
 
        """Return a dictionary containing the revision graph.
929
 
 
930
 
        :param revision_id: The revision_id to get a graph from. If None, then
931
 
        the entire revision graph is returned. This is a deprecated mode of
932
 
        operation and will be removed in the future.
933
 
        :return: a dictionary of revision_id->revision_parents_list.
934
 
        """
935
 
        # special case NULL_REVISION
936
 
        if revision_id == NULL_REVISION:
937
 
            return {}
938
 
        weave = self._get_revision_vf()
939
 
        entire_graph = weave.get_graph()
940
 
        if revision_id is None:
941
 
            return weave.get_graph()
942
 
        elif revision_id not in weave:
943
 
            raise errors.NoSuchRevision(self, revision_id)
944
 
        else:
945
 
            # add what can be reached from revision_id
946
 
            result = {}
947
 
            pending = set([revision_id])
948
 
            while len(pending) > 0:
949
 
                node = pending.pop()
950
 
                result[node] = weave.get_parents(node)
951
 
                for revision_id in result[node]:
952
 
                    if revision_id not in result:
953
 
                        pending.add(revision_id)
954
 
            return result
955
 
 
956
 
    @needs_read_lock
957
 
    def get_revision_graph_with_ghosts(self, revision_ids=None):
958
 
        """Return a graph of the revisions with ghosts marked as applicable.
959
 
 
960
 
        :param revision_ids: an iterable of revisions to graph or None for all.
961
 
        :return: a Graph object with the graph reachable from revision_ids.
962
 
        """
963
 
        result = Graph()
964
 
        vf = self._get_revision_vf()
965
 
        versions = set(vf.versions())
966
 
        if not revision_ids:
967
 
            pending = set(self.all_revision_ids())
968
 
            required = set([])
969
 
        else:
970
 
            pending = set(revision_ids)
971
 
            # special case NULL_REVISION
972
 
            if NULL_REVISION in pending:
973
 
                pending.remove(NULL_REVISION)
974
 
            required = set(pending)
975
 
        done = set([])
976
 
        while len(pending):
977
 
            revision_id = pending.pop()
978
 
            if not revision_id in versions:
979
 
                if revision_id in required:
980
 
                    raise errors.NoSuchRevision(self, revision_id)
981
 
                # a ghost
982
 
                result.add_ghost(revision_id)
983
 
                # mark it as done so we don't try for it again.
984
 
                done.add(revision_id)
985
 
                continue
986
 
            parent_ids = vf.get_parents_with_ghosts(revision_id)
987
 
            for parent_id in parent_ids:
988
 
                # is this queued or done ?
989
 
                if (parent_id not in pending and
990
 
                    parent_id not in done):
991
 
                    # no, queue it.
992
 
                    pending.add(parent_id)
993
 
            result.add_node(revision_id, parent_ids)
994
 
            done.add(revision_id)
995
 
        return result
996
 
 
997
 
    def _get_revision_vf(self):
998
 
        """:return: a versioned file containing the revisions."""
999
 
        vf = self._revision_store.get_revision_file(self.get_transaction())
1000
 
        return vf
1001
 
 
1002
 
    @needs_write_lock
1003
 
    def reconcile(self, other=None, thorough=False):
1004
 
        """Reconcile this repository."""
1005
 
        from bzrlib.reconcile import KnitReconciler
1006
 
        reconciler = KnitReconciler(self, thorough=thorough)
1007
 
        reconciler.reconcile()
1008
 
        return reconciler
 
1103
class RepositoryFormatRegistry(registry.Registry):
 
1104
    """Registry of RepositoryFormats.
 
1105
    """
 
1106
 
 
1107
    def get(self, format_string):
 
1108
        r = registry.Registry.get(self, format_string)
 
1109
        if callable(r):
 
1110
            r = r()
 
1111
        return r
1009
1112
    
1010
 
    def revision_parents(self, revision_id):
1011
 
        return self._get_revision_vf().get_parents(revision_id)
1012
 
 
1013
 
 
1014
 
class KnitRepository2(KnitRepository):
1015
 
    """"""
1016
 
    def __init__(self, _format, a_bzrdir, control_files, _revision_store,
1017
 
                 control_store, text_store):
1018
 
        KnitRepository.__init__(self, _format, a_bzrdir, control_files,
1019
 
                              _revision_store, control_store, text_store)
1020
 
        self._serializer = xml6.serializer_v6
1021
 
 
1022
 
    def deserialise_inventory(self, revision_id, xml):
1023
 
        """Transform the xml into an inventory object. 
1024
 
 
1025
 
        :param revision_id: The expected revision id of the inventory.
1026
 
        :param xml: A serialised inventory.
1027
 
        """
1028
 
        result = self._serializer.read_inventory_from_string(xml)
1029
 
        assert result.root.revision is not None
1030
 
        return result
1031
 
 
1032
 
    def serialise_inventory(self, inv):
1033
 
        """Transform the inventory object into XML text.
1034
 
 
1035
 
        :param revision_id: The expected revision id of the inventory.
1036
 
        :param xml: A serialised inventory.
1037
 
        """
1038
 
        assert inv.revision_id is not None
1039
 
        assert inv.root.revision is not None
1040
 
        return KnitRepository.serialise_inventory(self, inv)
1041
 
 
1042
 
    def get_commit_builder(self, branch, parents, config, timestamp=None, 
1043
 
                           timezone=None, committer=None, revprops=None, 
1044
 
                           revision_id=None):
1045
 
        """Obtain a CommitBuilder for this repository.
1046
 
        
1047
 
        :param branch: Branch to commit to.
1048
 
        :param parents: Revision ids of the parents of the new revision.
1049
 
        :param config: Configuration to use.
1050
 
        :param timestamp: Optional timestamp recorded for commit.
1051
 
        :param timezone: Optional timezone for timestamp.
1052
 
        :param committer: Optional committer to set for commit.
1053
 
        :param revprops: Optional dictionary of revision properties.
1054
 
        :param revision_id: Optional revision id.
1055
 
        """
1056
 
        return RootCommitBuilder(self, parents, config, timestamp, timezone,
1057
 
                                 committer, revprops, revision_id)
1058
 
 
 
1113
 
 
1114
format_registry = RepositoryFormatRegistry()
 
1115
"""Registry of formats, indexed by their identifying format string.
 
1116
 
 
1117
This can contain either format instances themselves, or classes/factories that
 
1118
can be called to obtain one.
 
1119
"""
 
1120
 
 
1121
 
 
1122
#####################################################################
 
1123
# Repository Formats
1059
1124
 
1060
1125
class RepositoryFormat(object):
1061
1126
    """A repository format.
1081
1146
    parameterisation.
1082
1147
    """
1083
1148
 
1084
 
    _default_format = None
1085
 
    """The default format used for new repositories."""
1086
 
 
1087
 
    _formats = {}
1088
 
    """The known formats."""
1089
 
 
1090
1149
    def __str__(self):
1091
1150
        return "<%s>" % self.__class__.__name__
1092
1151
 
 
1152
    def __eq__(self, other):
 
1153
        # format objects are generally stateless
 
1154
        return isinstance(other, self.__class__)
 
1155
 
 
1156
    def __ne__(self, other):
 
1157
        return not self == other
 
1158
 
1093
1159
    @classmethod
1094
1160
    def find_format(klass, a_bzrdir):
1095
 
        """Return the format for the repository object in a_bzrdir."""
 
1161
        """Return the format for the repository object in a_bzrdir.
 
1162
        
 
1163
        This is used by bzr native formats that have a "format" file in
 
1164
        the repository.  Other methods may be used by different types of 
 
1165
        control directory.
 
1166
        """
1096
1167
        try:
1097
1168
            transport = a_bzrdir.get_repository_transport(None)
1098
1169
            format_string = transport.get("format").read()
1099
 
            return klass._formats[format_string]
 
1170
            return format_registry.get(format_string)
1100
1171
        except errors.NoSuchFile:
1101
1172
            raise errors.NoRepositoryPresent(a_bzrdir)
1102
1173
        except KeyError:
1103
1174
            raise errors.UnknownFormatError(format=format_string)
1104
1175
 
1105
 
    def _get_control_store(self, repo_transport, control_files):
1106
 
        """Return the control store for this repository."""
1107
 
        raise NotImplementedError(self._get_control_store)
 
1176
    @classmethod
 
1177
    def register_format(klass, format):
 
1178
        format_registry.register(format.get_format_string(), format)
 
1179
 
 
1180
    @classmethod
 
1181
    def unregister_format(klass, format):
 
1182
        format_registry.remove(format.get_format_string())
1108
1183
    
1109
1184
    @classmethod
1110
1185
    def get_default_format(klass):
1111
1186
        """Return the current default format."""
1112
 
        return klass._default_format
 
1187
        from bzrlib import bzrdir
 
1188
        return bzrdir.format_registry.make_bzrdir('default').repository_format
 
1189
 
 
1190
    def _get_control_store(self, repo_transport, control_files):
 
1191
        """Return the control store for this repository."""
 
1192
        raise NotImplementedError(self._get_control_store)
1113
1193
 
1114
1194
    def get_format_string(self):
1115
1195
        """Return the ASCII format string that identifies this format.
1142
1222
        from bzrlib.store.revision.text import TextRevisionStore
1143
1223
        dir_mode = control_files._dir_mode
1144
1224
        file_mode = control_files._file_mode
1145
 
        text_store =TextStore(transport.clone(name),
 
1225
        text_store = TextStore(transport.clone(name),
1146
1226
                              prefixed=prefixed,
1147
1227
                              compressed=compressed,
1148
1228
                              dir_mode=dir_mode,
1150
1230
        _revision_store = TextRevisionStore(text_store, serializer)
1151
1231
        return _revision_store
1152
1232
 
 
1233
    # TODO: this shouldn't be in the base class, it's specific to things that
 
1234
    # use weaves or knits -- mbp 20070207
1153
1235
    def _get_versioned_file_store(self,
1154
1236
                                  name,
1155
1237
                                  transport,
1156
1238
                                  control_files,
1157
1239
                                  prefixed=True,
1158
 
                                  versionedfile_class=WeaveFile,
 
1240
                                  versionedfile_class=None,
1159
1241
                                  versionedfile_kwargs={},
1160
1242
                                  escaped=False):
 
1243
        if versionedfile_class is None:
 
1244
            versionedfile_class = self._versionedfile_class
1161
1245
        weave_transport = control_files._transport.clone(name)
1162
1246
        dir_mode = control_files._dir_mode
1163
1247
        file_mode = control_files._file_mode
1173
1257
 
1174
1258
        :param a_bzrdir: The bzrdir to put the new repository in it.
1175
1259
        :param shared: The repository should be initialized as a sharable one.
1176
 
 
 
1260
        :returns: The new repository object.
 
1261
        
1177
1262
        This may raise UninitializableFormat if shared repository are not
1178
1263
        compatible the a_bzrdir.
1179
1264
        """
 
1265
        raise NotImplementedError(self.initialize)
1180
1266
 
1181
1267
    def is_supported(self):
1182
1268
        """Is this format supported?
1197
1283
        """
1198
1284
        raise NotImplementedError(self.open)
1199
1285
 
1200
 
    @classmethod
1201
 
    def register_format(klass, format):
1202
 
        klass._formats[format.get_format_string()] = format
1203
 
 
1204
 
    @classmethod
1205
 
    def set_default_format(klass, format):
1206
 
        klass._default_format = format
1207
 
 
1208
 
    @classmethod
1209
 
    def unregister_format(klass, format):
1210
 
        assert klass._formats[format.get_format_string()] is format
1211
 
        del klass._formats[format.get_format_string()]
1212
 
 
1213
 
 
1214
 
class PreSplitOutRepositoryFormat(RepositoryFormat):
1215
 
    """Base class for the pre split out repository formats."""
1216
 
 
1217
 
    rich_root_data = False
1218
 
 
1219
 
    def initialize(self, a_bzrdir, shared=False, _internal=False):
1220
 
        """Create a weave repository.
1221
 
        
1222
 
        TODO: when creating split out bzr branch formats, move this to a common
1223
 
        base for Format5, Format6. or something like that.
1224
 
        """
1225
 
        from bzrlib.weavefile import write_weave_v5
1226
 
        from bzrlib.weave import Weave
1227
 
 
1228
 
        if shared:
1229
 
            raise errors.IncompatibleFormat(self, a_bzrdir._format)
1230
 
 
1231
 
        if not _internal:
1232
 
            # always initialized when the bzrdir is.
1233
 
            return self.open(a_bzrdir, _found=True)
1234
 
        
1235
 
        # Create an empty weave
1236
 
        sio = StringIO()
1237
 
        write_weave_v5(Weave(), sio)
1238
 
        empty_weave = sio.getvalue()
1239
 
 
1240
 
        mutter('creating repository in %s.', a_bzrdir.transport.base)
1241
 
        dirs = ['revision-store', 'weaves']
1242
 
        files = [('inventory.weave', StringIO(empty_weave)),
1243
 
                 ]
1244
 
        
1245
 
        # FIXME: RBC 20060125 don't peek under the covers
1246
 
        # NB: no need to escape relative paths that are url safe.
1247
 
        control_files = LockableFiles(a_bzrdir.transport, 'branch-lock',
1248
 
                                      TransportLock)
1249
 
        control_files.create_lock()
1250
 
        control_files.lock_write()
1251
 
        control_files._transport.mkdir_multi(dirs,
1252
 
                mode=control_files._dir_mode)
1253
 
        try:
1254
 
            for file, content in files:
1255
 
                control_files.put(file, content)
1256
 
        finally:
1257
 
            control_files.unlock()
1258
 
        return self.open(a_bzrdir, _found=True)
1259
 
 
1260
 
    def _get_control_store(self, repo_transport, control_files):
1261
 
        """Return the control store for this repository."""
1262
 
        return self._get_versioned_file_store('',
1263
 
                                              repo_transport,
1264
 
                                              control_files,
1265
 
                                              prefixed=False)
1266
 
 
1267
 
    def _get_text_store(self, transport, control_files):
1268
 
        """Get a store for file texts for this format."""
1269
 
        raise NotImplementedError(self._get_text_store)
1270
 
 
1271
 
    def open(self, a_bzrdir, _found=False):
1272
 
        """See RepositoryFormat.open()."""
1273
 
        if not _found:
1274
 
            # we are being called directly and must probe.
1275
 
            raise NotImplementedError
1276
 
 
1277
 
        repo_transport = a_bzrdir.get_repository_transport(None)
1278
 
        control_files = a_bzrdir._control_files
1279
 
        text_store = self._get_text_store(repo_transport, control_files)
1280
 
        control_store = self._get_control_store(repo_transport, control_files)
1281
 
        _revision_store = self._get_revision_store(repo_transport, control_files)
1282
 
        return AllInOneRepository(_format=self,
1283
 
                                  a_bzrdir=a_bzrdir,
1284
 
                                  _revision_store=_revision_store,
1285
 
                                  control_store=control_store,
1286
 
                                  text_store=text_store)
1287
 
 
1288
 
    def check_conversion_target(self, target_format):
1289
 
        pass
1290
 
 
1291
 
 
1292
 
class RepositoryFormat4(PreSplitOutRepositoryFormat):
1293
 
    """Bzr repository format 4.
1294
 
 
1295
 
    This repository format has:
1296
 
     - flat stores
1297
 
     - TextStores for texts, inventories,revisions.
1298
 
 
1299
 
    This format is deprecated: it indexes texts using a text id which is
1300
 
    removed in format 5; initialization and write support for this format
1301
 
    has been removed.
1302
 
    """
1303
 
 
1304
 
    def __init__(self):
1305
 
        super(RepositoryFormat4, self).__init__()
1306
 
        self._matchingbzrdir = bzrdir.BzrDirFormat4()
1307
 
 
1308
 
    def get_format_description(self):
1309
 
        """See RepositoryFormat.get_format_description()."""
1310
 
        return "Repository format 4"
1311
 
 
1312
 
    def initialize(self, url, shared=False, _internal=False):
1313
 
        """Format 4 branches cannot be created."""
1314
 
        raise errors.UninitializableFormat(self)
1315
 
 
1316
 
    def is_supported(self):
1317
 
        """Format 4 is not supported.
1318
 
 
1319
 
        It is not supported because the model changed from 4 to 5 and the
1320
 
        conversion logic is expensive - so doing it on the fly was not 
1321
 
        feasible.
1322
 
        """
1323
 
        return False
1324
 
 
1325
 
    def _get_control_store(self, repo_transport, control_files):
1326
 
        """Format 4 repositories have no formal control store at this point.
1327
 
        
1328
 
        This will cause any control-file-needing apis to fail - this is desired.
1329
 
        """
1330
 
        return None
1331
 
    
1332
 
    def _get_revision_store(self, repo_transport, control_files):
1333
 
        """See RepositoryFormat._get_revision_store()."""
1334
 
        from bzrlib.xml4 import serializer_v4
1335
 
        return self._get_text_rev_store(repo_transport,
1336
 
                                        control_files,
1337
 
                                        'revision-store',
1338
 
                                        serializer=serializer_v4)
1339
 
 
1340
 
    def _get_text_store(self, transport, control_files):
1341
 
        """See RepositoryFormat._get_text_store()."""
1342
 
 
1343
 
 
1344
 
class RepositoryFormat5(PreSplitOutRepositoryFormat):
1345
 
    """Bzr control format 5.
1346
 
 
1347
 
    This repository format has:
1348
 
     - weaves for file texts and inventory
1349
 
     - flat stores
1350
 
     - TextStores for revisions and signatures.
1351
 
    """
1352
 
 
1353
 
    def __init__(self):
1354
 
        super(RepositoryFormat5, self).__init__()
1355
 
        self._matchingbzrdir = bzrdir.BzrDirFormat5()
1356
 
 
1357
 
    def get_format_description(self):
1358
 
        """See RepositoryFormat.get_format_description()."""
1359
 
        return "Weave repository format 5"
1360
 
 
1361
 
    def _get_revision_store(self, repo_transport, control_files):
1362
 
        """See RepositoryFormat._get_revision_store()."""
1363
 
        """Return the revision store object for this a_bzrdir."""
1364
 
        return self._get_text_rev_store(repo_transport,
1365
 
                                        control_files,
1366
 
                                        'revision-store',
1367
 
                                        compressed=False)
1368
 
 
1369
 
    def _get_text_store(self, transport, control_files):
1370
 
        """See RepositoryFormat._get_text_store()."""
1371
 
        return self._get_versioned_file_store('weaves', transport, control_files, prefixed=False)
1372
 
 
1373
 
 
1374
 
class RepositoryFormat6(PreSplitOutRepositoryFormat):
1375
 
    """Bzr control format 6.
1376
 
 
1377
 
    This repository format has:
1378
 
     - weaves for file texts and inventory
1379
 
     - hash subdirectory based stores.
1380
 
     - TextStores for revisions and signatures.
1381
 
    """
1382
 
 
1383
 
    def __init__(self):
1384
 
        super(RepositoryFormat6, self).__init__()
1385
 
        self._matchingbzrdir = bzrdir.BzrDirFormat6()
1386
 
 
1387
 
    def get_format_description(self):
1388
 
        """See RepositoryFormat.get_format_description()."""
1389
 
        return "Weave repository format 6"
1390
 
 
1391
 
    def _get_revision_store(self, repo_transport, control_files):
1392
 
        """See RepositoryFormat._get_revision_store()."""
1393
 
        return self._get_text_rev_store(repo_transport,
1394
 
                                        control_files,
1395
 
                                        'revision-store',
1396
 
                                        compressed=False,
1397
 
                                        prefixed=True)
1398
 
 
1399
 
    def _get_text_store(self, transport, control_files):
1400
 
        """See RepositoryFormat._get_text_store()."""
1401
 
        return self._get_versioned_file_store('weaves', transport, control_files)
1402
 
 
1403
1286
 
1404
1287
class MetaDirRepositoryFormat(RepositoryFormat):
1405
1288
    """Common base class for the new repositories using the metadir layout."""
1406
1289
 
1407
1290
    rich_root_data = False
 
1291
    supports_tree_reference = False
 
1292
    _matchingbzrdir = bzrdir.BzrDirMetaFormat1()
1408
1293
 
1409
1294
    def __init__(self):
1410
1295
        super(MetaDirRepositoryFormat, self).__init__()
1411
 
        self._matchingbzrdir = bzrdir.BzrDirMetaFormat1()
1412
1296
 
1413
1297
    def _create_control_files(self, a_bzrdir):
1414
1298
        """Create the required files and the initial control_files object."""
1415
1299
        # FIXME: RBC 20060125 don't peek under the covers
1416
1300
        # NB: no need to escape relative paths that are url safe.
1417
1301
        repository_transport = a_bzrdir.get_repository_transport(self)
1418
 
        control_files = LockableFiles(repository_transport, 'lock', LockDir)
 
1302
        control_files = lockable_files.LockableFiles(repository_transport,
 
1303
                                'lock', lockdir.LockDir)
1419
1304
        control_files.create_lock()
1420
1305
        return control_files
1421
1306
 
1436
1321
            control_files.unlock()
1437
1322
 
1438
1323
 
1439
 
class RepositoryFormat7(MetaDirRepositoryFormat):
1440
 
    """Bzr repository 7.
1441
 
 
1442
 
    This repository format has:
1443
 
     - weaves for file texts and inventory
1444
 
     - hash subdirectory based stores.
1445
 
     - TextStores for revisions and signatures.
1446
 
     - a format marker of its own
1447
 
     - an optional 'shared-storage' flag
1448
 
     - an optional 'no-working-trees' flag
1449
 
    """
1450
 
 
1451
 
    def _get_control_store(self, repo_transport, control_files):
1452
 
        """Return the control store for this repository."""
1453
 
        return self._get_versioned_file_store('',
1454
 
                                              repo_transport,
1455
 
                                              control_files,
1456
 
                                              prefixed=False)
1457
 
 
1458
 
    def get_format_string(self):
1459
 
        """See RepositoryFormat.get_format_string()."""
1460
 
        return "Bazaar-NG Repository format 7"
1461
 
 
1462
 
    def get_format_description(self):
1463
 
        """See RepositoryFormat.get_format_description()."""
1464
 
        return "Weave repository format 7"
1465
 
 
1466
 
    def check_conversion_target(self, target_format):
1467
 
        pass
1468
 
 
1469
 
    def _get_revision_store(self, repo_transport, control_files):
1470
 
        """See RepositoryFormat._get_revision_store()."""
1471
 
        return self._get_text_rev_store(repo_transport,
1472
 
                                        control_files,
1473
 
                                        'revision-store',
1474
 
                                        compressed=False,
1475
 
                                        prefixed=True,
1476
 
                                        )
1477
 
 
1478
 
    def _get_text_store(self, transport, control_files):
1479
 
        """See RepositoryFormat._get_text_store()."""
1480
 
        return self._get_versioned_file_store('weaves',
1481
 
                                              transport,
1482
 
                                              control_files)
1483
 
 
1484
 
    def initialize(self, a_bzrdir, shared=False):
1485
 
        """Create a weave repository.
1486
 
 
1487
 
        :param shared: If true the repository will be initialized as a shared
1488
 
                       repository.
1489
 
        """
1490
 
        from bzrlib.weavefile import write_weave_v5
1491
 
        from bzrlib.weave import Weave
1492
 
 
1493
 
        # Create an empty weave
1494
 
        sio = StringIO()
1495
 
        write_weave_v5(Weave(), sio)
1496
 
        empty_weave = sio.getvalue()
1497
 
 
1498
 
        mutter('creating repository in %s.', a_bzrdir.transport.base)
1499
 
        dirs = ['revision-store', 'weaves']
1500
 
        files = [('inventory.weave', StringIO(empty_weave)), 
1501
 
                 ]
1502
 
        utf8_files = [('format', self.get_format_string())]
1503
 
 
1504
 
        self._upload_blank_content(a_bzrdir, dirs, files, utf8_files, shared)
1505
 
        return self.open(a_bzrdir=a_bzrdir, _found=True)
1506
 
 
1507
 
    def open(self, a_bzrdir, _found=False, _override_transport=None):
1508
 
        """See RepositoryFormat.open().
1509
 
        
1510
 
        :param _override_transport: INTERNAL USE ONLY. Allows opening the
1511
 
                                    repository at a slightly different url
1512
 
                                    than normal. I.e. during 'upgrade'.
1513
 
        """
1514
 
        if not _found:
1515
 
            format = RepositoryFormat.find_format(a_bzrdir)
1516
 
            assert format.__class__ ==  self.__class__
1517
 
        if _override_transport is not None:
1518
 
            repo_transport = _override_transport
1519
 
        else:
1520
 
            repo_transport = a_bzrdir.get_repository_transport(None)
1521
 
        control_files = LockableFiles(repo_transport, 'lock', LockDir)
1522
 
        text_store = self._get_text_store(repo_transport, control_files)
1523
 
        control_store = self._get_control_store(repo_transport, control_files)
1524
 
        _revision_store = self._get_revision_store(repo_transport, control_files)
1525
 
        return MetaDirRepository(_format=self,
1526
 
                                 a_bzrdir=a_bzrdir,
1527
 
                                 control_files=control_files,
1528
 
                                 _revision_store=_revision_store,
1529
 
                                 control_store=control_store,
1530
 
                                 text_store=text_store)
1531
 
 
1532
 
 
1533
 
class RepositoryFormatKnit(MetaDirRepositoryFormat):
1534
 
    """Bzr repository knit format (generalized). 
1535
 
 
1536
 
    This repository format has:
1537
 
     - knits for file texts and inventory
1538
 
     - hash subdirectory based stores.
1539
 
     - knits for revisions and signatures
1540
 
     - TextStores for revisions and signatures.
1541
 
     - a format marker of its own
1542
 
     - an optional 'shared-storage' flag
1543
 
     - an optional 'no-working-trees' flag
1544
 
     - a LockDir lock
1545
 
    """
1546
 
 
1547
 
    def _get_control_store(self, repo_transport, control_files):
1548
 
        """Return the control store for this repository."""
1549
 
        return VersionedFileStore(
1550
 
            repo_transport,
1551
 
            prefixed=False,
1552
 
            file_mode=control_files._file_mode,
1553
 
            versionedfile_class=KnitVersionedFile,
1554
 
            versionedfile_kwargs={'factory':KnitPlainFactory()},
1555
 
            )
1556
 
 
1557
 
    def _get_revision_store(self, repo_transport, control_files):
1558
 
        """See RepositoryFormat._get_revision_store()."""
1559
 
        from bzrlib.store.revision.knit import KnitRevisionStore
1560
 
        versioned_file_store = VersionedFileStore(
1561
 
            repo_transport,
1562
 
            file_mode=control_files._file_mode,
1563
 
            prefixed=False,
1564
 
            precious=True,
1565
 
            versionedfile_class=KnitVersionedFile,
1566
 
            versionedfile_kwargs={'delta':False, 'factory':KnitPlainFactory(),},
1567
 
            escaped=True,
1568
 
            )
1569
 
        return KnitRevisionStore(versioned_file_store)
1570
 
 
1571
 
    def _get_text_store(self, transport, control_files):
1572
 
        """See RepositoryFormat._get_text_store()."""
1573
 
        return self._get_versioned_file_store('knits',
1574
 
                                              transport,
1575
 
                                              control_files,
1576
 
                                              versionedfile_class=KnitVersionedFile,
1577
 
                                              versionedfile_kwargs={
1578
 
                                                  'create_parent_dir':True,
1579
 
                                                  'delay_create':True,
1580
 
                                                  'dir_mode':control_files._dir_mode,
1581
 
                                              },
1582
 
                                              escaped=True)
1583
 
 
1584
 
    def initialize(self, a_bzrdir, shared=False):
1585
 
        """Create a knit format 1 repository.
1586
 
 
1587
 
        :param a_bzrdir: bzrdir to contain the new repository; must already
1588
 
            be initialized.
1589
 
        :param shared: If true the repository will be initialized as a shared
1590
 
                       repository.
1591
 
        """
1592
 
        mutter('creating repository in %s.', a_bzrdir.transport.base)
1593
 
        dirs = ['revision-store', 'knits']
1594
 
        files = []
1595
 
        utf8_files = [('format', self.get_format_string())]
1596
 
        
1597
 
        self._upload_blank_content(a_bzrdir, dirs, files, utf8_files, shared)
1598
 
        repo_transport = a_bzrdir.get_repository_transport(None)
1599
 
        control_files = LockableFiles(repo_transport, 'lock', LockDir)
1600
 
        control_store = self._get_control_store(repo_transport, control_files)
1601
 
        transaction = transactions.WriteTransaction()
1602
 
        # trigger a write of the inventory store.
1603
 
        control_store.get_weave_or_empty('inventory', transaction)
1604
 
        _revision_store = self._get_revision_store(repo_transport, control_files)
1605
 
        _revision_store.has_revision_id('A', transaction)
1606
 
        _revision_store.get_signature_file(transaction)
1607
 
        return self.open(a_bzrdir=a_bzrdir, _found=True)
1608
 
 
1609
 
    def open(self, a_bzrdir, _found=False, _override_transport=None):
1610
 
        """See RepositoryFormat.open().
1611
 
        
1612
 
        :param _override_transport: INTERNAL USE ONLY. Allows opening the
1613
 
                                    repository at a slightly different url
1614
 
                                    than normal. I.e. during 'upgrade'.
1615
 
        """
1616
 
        if not _found:
1617
 
            format = RepositoryFormat.find_format(a_bzrdir)
1618
 
            assert format.__class__ ==  self.__class__
1619
 
        if _override_transport is not None:
1620
 
            repo_transport = _override_transport
1621
 
        else:
1622
 
            repo_transport = a_bzrdir.get_repository_transport(None)
1623
 
        control_files = LockableFiles(repo_transport, 'lock', LockDir)
1624
 
        text_store = self._get_text_store(repo_transport, control_files)
1625
 
        control_store = self._get_control_store(repo_transport, control_files)
1626
 
        _revision_store = self._get_revision_store(repo_transport, control_files)
1627
 
        return KnitRepository(_format=self,
1628
 
                              a_bzrdir=a_bzrdir,
1629
 
                              control_files=control_files,
1630
 
                              _revision_store=_revision_store,
1631
 
                              control_store=control_store,
1632
 
                              text_store=text_store)
1633
 
 
1634
 
 
1635
 
class RepositoryFormatKnit1(RepositoryFormatKnit):
1636
 
    """Bzr repository knit format 1.
1637
 
 
1638
 
    This repository format has:
1639
 
     - knits for file texts and inventory
1640
 
     - hash subdirectory based stores.
1641
 
     - knits for revisions and signatures
1642
 
     - TextStores for revisions and signatures.
1643
 
     - a format marker of its own
1644
 
     - an optional 'shared-storage' flag
1645
 
     - an optional 'no-working-trees' flag
1646
 
     - a LockDir lock
1647
 
 
1648
 
    This format was introduced in bzr 0.8.
1649
 
    """
1650
 
    def get_format_string(self):
1651
 
        """See RepositoryFormat.get_format_string()."""
1652
 
        return "Bazaar-NG Knit Repository Format 1"
1653
 
 
1654
 
    def get_format_description(self):
1655
 
        """See RepositoryFormat.get_format_description()."""
1656
 
        return "Knit repository format 1"
1657
 
 
1658
 
    def check_conversion_target(self, target_format):
1659
 
        pass
1660
 
 
1661
 
 
1662
 
class RepositoryFormatKnit2(RepositoryFormatKnit):
1663
 
    """Bzr repository knit format 2.
1664
 
 
1665
 
    THIS FORMAT IS EXPERIMENTAL
1666
 
    This repository format has:
1667
 
     - knits for file texts and inventory
1668
 
     - hash subdirectory based stores.
1669
 
     - knits for revisions and signatures
1670
 
     - TextStores for revisions and signatures.
1671
 
     - a format marker of its own
1672
 
     - an optional 'shared-storage' flag
1673
 
     - an optional 'no-working-trees' flag
1674
 
     - a LockDir lock
1675
 
     - Support for recording full info about the tree root
1676
 
 
1677
 
    """
1678
 
    
1679
 
    rich_root_data = True
1680
 
 
1681
 
    def get_format_string(self):
1682
 
        """See RepositoryFormat.get_format_string()."""
1683
 
        return "Bazaar Knit Repository Format 2\n"
1684
 
 
1685
 
    def get_format_description(self):
1686
 
        """See RepositoryFormat.get_format_description()."""
1687
 
        return "Knit repository format 2"
1688
 
 
1689
 
    def check_conversion_target(self, target_format):
1690
 
        if not target_format.rich_root_data:
1691
 
            raise errors.BadConversionTarget(
1692
 
                'Does not support rich root data.', target_format)
1693
 
 
1694
 
    def open(self, a_bzrdir, _found=False, _override_transport=None):
1695
 
        """See RepositoryFormat.open().
1696
 
        
1697
 
        :param _override_transport: INTERNAL USE ONLY. Allows opening the
1698
 
                                    repository at a slightly different url
1699
 
                                    than normal. I.e. during 'upgrade'.
1700
 
        """
1701
 
        if not _found:
1702
 
            format = RepositoryFormat.find_format(a_bzrdir)
1703
 
            assert format.__class__ ==  self.__class__
1704
 
        if _override_transport is not None:
1705
 
            repo_transport = _override_transport
1706
 
        else:
1707
 
            repo_transport = a_bzrdir.get_repository_transport(None)
1708
 
        control_files = LockableFiles(repo_transport, 'lock', LockDir)
1709
 
        text_store = self._get_text_store(repo_transport, control_files)
1710
 
        control_store = self._get_control_store(repo_transport, control_files)
1711
 
        _revision_store = self._get_revision_store(repo_transport, control_files)
1712
 
        return KnitRepository2(_format=self,
1713
 
                               a_bzrdir=a_bzrdir,
1714
 
                               control_files=control_files,
1715
 
                               _revision_store=_revision_store,
1716
 
                               control_store=control_store,
1717
 
                               text_store=text_store)
1718
 
 
1719
 
 
1720
 
 
1721
1324
# formats which have no format string are not discoverable
1722
 
# and not independently creatable, so are not registered.
1723
 
RepositoryFormat.register_format(RepositoryFormat7())
1724
 
_default_format = RepositoryFormatKnit1()
1725
 
RepositoryFormat.register_format(_default_format)
1726
 
RepositoryFormat.register_format(RepositoryFormatKnit2())
1727
 
RepositoryFormat.set_default_format(_default_format)
1728
 
_legacy_formats = [RepositoryFormat4(),
1729
 
                   RepositoryFormat5(),
1730
 
                   RepositoryFormat6()]
 
1325
# and not independently creatable, so are not registered.  They're 
 
1326
# all in bzrlib.repofmt.weaverepo now.  When an instance of one of these is
 
1327
# needed, it's constructed directly by the BzrDir.  Non-native formats where
 
1328
# the repository is not separately opened are similar.
 
1329
 
 
1330
format_registry.register_lazy(
 
1331
    'Bazaar-NG Repository format 7',
 
1332
    'bzrlib.repofmt.weaverepo',
 
1333
    'RepositoryFormat7'
 
1334
    )
 
1335
# KEEP in sync with bzrdir.format_registry default, which controls the overall
 
1336
# default control directory format
 
1337
 
 
1338
format_registry.register_lazy(
 
1339
    'Bazaar-NG Knit Repository Format 1',
 
1340
    'bzrlib.repofmt.knitrepo',
 
1341
    'RepositoryFormatKnit1',
 
1342
    )
 
1343
format_registry.default_key = 'Bazaar-NG Knit Repository Format 1'
 
1344
 
 
1345
format_registry.register_lazy(
 
1346
    'Bazaar Knit Repository Format 3 (bzr 0.15)\n',
 
1347
    'bzrlib.repofmt.knitrepo',
 
1348
    'RepositoryFormatKnit3',
 
1349
    )
1731
1350
 
1732
1351
 
1733
1352
class InterRepository(InterObject):
1745
1364
    _optimisers = []
1746
1365
    """The available optimised InterRepository types."""
1747
1366
 
1748
 
    def copy_content(self, revision_id=None, basis=None):
 
1367
    def copy_content(self, revision_id=None):
1749
1368
        raise NotImplementedError(self.copy_content)
1750
1369
 
1751
1370
    def fetch(self, revision_id=None, pb=None):
1775
1394
        # generic, possibly worst case, slow code path.
1776
1395
        target_ids = set(self.target.all_revision_ids())
1777
1396
        if revision_id is not None:
 
1397
            # TODO: jam 20070210 InterRepository is internal enough that it
 
1398
            #       should assume revision_ids are already utf-8
 
1399
            revision_id = osutils.safe_revision_id(revision_id)
1778
1400
            source_ids = self.source.get_ancestry(revision_id)
1779
1401
            assert source_ids[0] is None
1780
1402
            source_ids.pop(0)
1793
1415
    Data format and model must match for this to work.
1794
1416
    """
1795
1417
 
1796
 
    _matching_repo_format = RepositoryFormat4()
1797
 
    """Repository format for testing with."""
 
1418
    @classmethod
 
1419
    def _get_repo_format_to_test(self):
 
1420
        """Repository format for testing with."""
 
1421
        return RepositoryFormat.get_default_format()
1798
1422
 
1799
1423
    @staticmethod
1800
1424
    def is_compatible(source, target):
1801
 
        if not isinstance(source, Repository):
1802
 
            return False
1803
 
        if not isinstance(target, Repository):
1804
 
            return False
1805
 
        if source._format.rich_root_data == target._format.rich_root_data:
1806
 
            return True
1807
 
        else:
1808
 
            return False
 
1425
        if source.supports_rich_root() != target.supports_rich_root():
 
1426
            return False
 
1427
        if source._serializer != target._serializer:
 
1428
            return False
 
1429
        return True
1809
1430
 
1810
1431
    @needs_write_lock
1811
 
    def copy_content(self, revision_id=None, basis=None):
 
1432
    def copy_content(self, revision_id=None):
1812
1433
        """Make a complete copy of the content in self into destination.
 
1434
 
 
1435
        This copies both the repository's revision data, and configuration information
 
1436
        such as the make_working_trees setting.
1813
1437
        
1814
1438
        This is a destructive operation! Do not use it on existing 
1815
1439
        repositories.
1816
1440
 
1817
1441
        :param revision_id: Only copy the content needed to construct
1818
1442
                            revision_id and its parents.
1819
 
        :param basis: Copy the needed data preferentially from basis.
1820
1443
        """
1821
1444
        try:
1822
1445
            self.target.set_make_working_trees(self.source.make_working_trees())
1823
1446
        except NotImplementedError:
1824
1447
            pass
1825
 
        # grab the basis available data
1826
 
        if basis is not None:
1827
 
            self.target.fetch(basis, revision_id=revision_id)
 
1448
        # TODO: jam 20070210 This is fairly internal, so we should probably
 
1449
        #       just assert that revision_id is not unicode.
 
1450
        revision_id = osutils.safe_revision_id(revision_id)
1828
1451
        # but don't bother fetching if we have the needed data now.
1829
 
        if (revision_id not in (None, NULL_REVISION) and 
 
1452
        if (revision_id not in (None, _mod_revision.NULL_REVISION) and 
1830
1453
            self.target.has_revision(revision_id)):
1831
1454
            return
1832
1455
        self.target.fetch(self.source, revision_id=revision_id)
1838
1461
        mutter("Using fetch logic to copy between %s(%s) and %s(%s)",
1839
1462
               self.source, self.source._format, self.target, 
1840
1463
               self.target._format)
 
1464
        # TODO: jam 20070210 This should be an assert, not a translate
 
1465
        revision_id = osutils.safe_revision_id(revision_id)
1841
1466
        f = GenericRepoFetcher(to_repository=self.target,
1842
1467
                               from_repository=self.source,
1843
1468
                               last_revision=revision_id,
1848
1473
class InterWeaveRepo(InterSameDataRepository):
1849
1474
    """Optimised code paths between Weave based repositories."""
1850
1475
 
1851
 
    _matching_repo_format = RepositoryFormat7()
1852
 
    """Repository format for testing with."""
 
1476
    @classmethod
 
1477
    def _get_repo_format_to_test(self):
 
1478
        from bzrlib.repofmt import weaverepo
 
1479
        return weaverepo.RepositoryFormat7()
1853
1480
 
1854
1481
    @staticmethod
1855
1482
    def is_compatible(source, target):
1859
1486
        could lead to confusing results, and there is no need to be 
1860
1487
        overly general.
1861
1488
        """
 
1489
        from bzrlib.repofmt.weaverepo import (
 
1490
                RepositoryFormat5,
 
1491
                RepositoryFormat6,
 
1492
                RepositoryFormat7,
 
1493
                )
1862
1494
        try:
1863
1495
            return (isinstance(source._format, (RepositoryFormat5,
1864
1496
                                                RepositoryFormat6,
1870
1502
            return False
1871
1503
    
1872
1504
    @needs_write_lock
1873
 
    def copy_content(self, revision_id=None, basis=None):
 
1505
    def copy_content(self, revision_id=None):
1874
1506
        """See InterRepository.copy_content()."""
1875
1507
        # weave specific optimised path:
1876
 
        if basis is not None:
1877
 
            # copy the basis in, then fetch remaining data.
1878
 
            basis.copy_content_into(self.target, revision_id)
1879
 
            # the basis copy_content_into could miss-set this.
 
1508
        # TODO: jam 20070210 Internal, should be an assert, not translate
 
1509
        revision_id = osutils.safe_revision_id(revision_id)
 
1510
        try:
 
1511
            self.target.set_make_working_trees(self.source.make_working_trees())
 
1512
        except NotImplementedError:
 
1513
            pass
 
1514
        # FIXME do not peek!
 
1515
        if self.source.control_files._transport.listable():
 
1516
            pb = ui.ui_factory.nested_progress_bar()
1880
1517
            try:
1881
 
                self.target.set_make_working_trees(self.source.make_working_trees())
1882
 
            except NotImplementedError:
1883
 
                pass
 
1518
                self.target.weave_store.copy_all_ids(
 
1519
                    self.source.weave_store,
 
1520
                    pb=pb,
 
1521
                    from_transaction=self.source.get_transaction(),
 
1522
                    to_transaction=self.target.get_transaction())
 
1523
                pb.update('copying inventory', 0, 1)
 
1524
                self.target.control_weaves.copy_multi(
 
1525
                    self.source.control_weaves, ['inventory'],
 
1526
                    from_transaction=self.source.get_transaction(),
 
1527
                    to_transaction=self.target.get_transaction())
 
1528
                self.target._revision_store.text_store.copy_all_ids(
 
1529
                    self.source._revision_store.text_store,
 
1530
                    pb=pb)
 
1531
            finally:
 
1532
                pb.finished()
 
1533
        else:
1884
1534
            self.target.fetch(self.source, revision_id=revision_id)
1885
 
        else:
1886
 
            try:
1887
 
                self.target.set_make_working_trees(self.source.make_working_trees())
1888
 
            except NotImplementedError:
1889
 
                pass
1890
 
            # FIXME do not peek!
1891
 
            if self.source.control_files._transport.listable():
1892
 
                pb = ui.ui_factory.nested_progress_bar()
1893
 
                try:
1894
 
                    self.target.weave_store.copy_all_ids(
1895
 
                        self.source.weave_store,
1896
 
                        pb=pb,
1897
 
                        from_transaction=self.source.get_transaction(),
1898
 
                        to_transaction=self.target.get_transaction())
1899
 
                    pb.update('copying inventory', 0, 1)
1900
 
                    self.target.control_weaves.copy_multi(
1901
 
                        self.source.control_weaves, ['inventory'],
1902
 
                        from_transaction=self.source.get_transaction(),
1903
 
                        to_transaction=self.target.get_transaction())
1904
 
                    self.target._revision_store.text_store.copy_all_ids(
1905
 
                        self.source._revision_store.text_store,
1906
 
                        pb=pb)
1907
 
                finally:
1908
 
                    pb.finished()
1909
 
            else:
1910
 
                self.target.fetch(self.source, revision_id=revision_id)
1911
1535
 
1912
1536
    @needs_write_lock
1913
1537
    def fetch(self, revision_id=None, pb=None):
1915
1539
        from bzrlib.fetch import GenericRepoFetcher
1916
1540
        mutter("Using fetch logic to copy between %s(%s) and %s(%s)",
1917
1541
               self.source, self.source._format, self.target, self.target._format)
 
1542
        # TODO: jam 20070210 This should be an assert, not a translate
 
1543
        revision_id = osutils.safe_revision_id(revision_id)
1918
1544
        f = GenericRepoFetcher(to_repository=self.target,
1919
1545
                               from_repository=self.source,
1920
1546
                               last_revision=revision_id,
1966
1592
class InterKnitRepo(InterSameDataRepository):
1967
1593
    """Optimised code paths between Knit based repositories."""
1968
1594
 
1969
 
    _matching_repo_format = RepositoryFormatKnit1()
1970
 
    """Repository format for testing with."""
 
1595
    @classmethod
 
1596
    def _get_repo_format_to_test(self):
 
1597
        from bzrlib.repofmt import knitrepo
 
1598
        return knitrepo.RepositoryFormatKnit1()
1971
1599
 
1972
1600
    @staticmethod
1973
1601
    def is_compatible(source, target):
1977
1605
        could lead to confusing results, and there is no need to be 
1978
1606
        overly general.
1979
1607
        """
 
1608
        from bzrlib.repofmt.knitrepo import RepositoryFormatKnit1
1980
1609
        try:
1981
1610
            return (isinstance(source._format, (RepositoryFormatKnit1)) and
1982
1611
                    isinstance(target._format, (RepositoryFormatKnit1)))
1989
1618
        from bzrlib.fetch import KnitRepoFetcher
1990
1619
        mutter("Using fetch logic to copy between %s(%s) and %s(%s)",
1991
1620
               self.source, self.source._format, self.target, self.target._format)
 
1621
        # TODO: jam 20070210 This should be an assert, not a translate
 
1622
        revision_id = osutils.safe_revision_id(revision_id)
1992
1623
        f = KnitRepoFetcher(to_repository=self.target,
1993
1624
                            from_repository=self.source,
1994
1625
                            last_revision=revision_id,
2028
1659
 
2029
1660
class InterModel1and2(InterRepository):
2030
1661
 
2031
 
    _matching_repo_format = None
 
1662
    @classmethod
 
1663
    def _get_repo_format_to_test(self):
 
1664
        return None
2032
1665
 
2033
1666
    @staticmethod
2034
1667
    def is_compatible(source, target):
2035
 
        if not isinstance(source, Repository):
2036
 
            return False
2037
 
        if not isinstance(target, Repository):
2038
 
            return False
2039
 
        if not source._format.rich_root_data and target._format.rich_root_data:
 
1668
        if not source.supports_rich_root() and target.supports_rich_root():
2040
1669
            return True
2041
1670
        else:
2042
1671
            return False
2045
1674
    def fetch(self, revision_id=None, pb=None):
2046
1675
        """See InterRepository.fetch()."""
2047
1676
        from bzrlib.fetch import Model1toKnit2Fetcher
 
1677
        # TODO: jam 20070210 This should be an assert, not a translate
 
1678
        revision_id = osutils.safe_revision_id(revision_id)
2048
1679
        f = Model1toKnit2Fetcher(to_repository=self.target,
2049
1680
                                 from_repository=self.source,
2050
1681
                                 last_revision=revision_id,
2052
1683
        return f.count_copied, f.failed_revisions
2053
1684
 
2054
1685
    @needs_write_lock
2055
 
    def copy_content(self, revision_id=None, basis=None):
 
1686
    def copy_content(self, revision_id=None):
2056
1687
        """Make a complete copy of the content in self into destination.
2057
1688
        
2058
1689
        This is a destructive operation! Do not use it on existing 
2060
1691
 
2061
1692
        :param revision_id: Only copy the content needed to construct
2062
1693
                            revision_id and its parents.
2063
 
        :param basis: Copy the needed data preferentially from basis.
2064
1694
        """
2065
1695
        try:
2066
1696
            self.target.set_make_working_trees(self.source.make_working_trees())
2067
1697
        except NotImplementedError:
2068
1698
            pass
2069
 
        # grab the basis available data
2070
 
        if basis is not None:
2071
 
            self.target.fetch(basis, revision_id=revision_id)
 
1699
        # TODO: jam 20070210 Internal, assert, don't translate
 
1700
        revision_id = osutils.safe_revision_id(revision_id)
2072
1701
        # but don't bother fetching if we have the needed data now.
2073
 
        if (revision_id not in (None, NULL_REVISION) and 
 
1702
        if (revision_id not in (None, _mod_revision.NULL_REVISION) and 
2074
1703
            self.target.has_revision(revision_id)):
2075
1704
            return
2076
1705
        self.target.fetch(self.source, revision_id=revision_id)
2078
1707
 
2079
1708
class InterKnit1and2(InterKnitRepo):
2080
1709
 
2081
 
    _matching_repo_format = None
 
1710
    @classmethod
 
1711
    def _get_repo_format_to_test(self):
 
1712
        return None
2082
1713
 
2083
1714
    @staticmethod
2084
1715
    def is_compatible(source, target):
2085
 
        """Be compatible with Knit1 source and Knit2 target"""
 
1716
        """Be compatible with Knit1 source and Knit3 target"""
 
1717
        from bzrlib.repofmt.knitrepo import RepositoryFormatKnit3
2086
1718
        try:
 
1719
            from bzrlib.repofmt.knitrepo import RepositoryFormatKnit1, \
 
1720
                    RepositoryFormatKnit3
2087
1721
            return (isinstance(source._format, (RepositoryFormatKnit1)) and
2088
 
                    isinstance(target._format, (RepositoryFormatKnit2)))
 
1722
                    isinstance(target._format, (RepositoryFormatKnit3)))
2089
1723
        except AttributeError:
2090
1724
            return False
2091
1725
 
2096
1730
        mutter("Using fetch logic to copy between %s(%s) and %s(%s)",
2097
1731
               self.source, self.source._format, self.target, 
2098
1732
               self.target._format)
 
1733
        # TODO: jam 20070210 This should be an assert, not a translate
 
1734
        revision_id = osutils.safe_revision_id(revision_id)
2099
1735
        f = Knit1to2Fetcher(to_repository=self.target,
2100
1736
                            from_repository=self.source,
2101
1737
                            last_revision=revision_id,
2103
1739
        return f.count_copied, f.failed_revisions
2104
1740
 
2105
1741
 
 
1742
class InterRemoteRepository(InterRepository):
 
1743
    """Code for converting between RemoteRepository objects.
 
1744
 
 
1745
    This just gets an non-remote repository from the RemoteRepository, and calls
 
1746
    InterRepository.get again.
 
1747
    """
 
1748
 
 
1749
    def __init__(self, source, target):
 
1750
        if isinstance(source, remote.RemoteRepository):
 
1751
            source._ensure_real()
 
1752
            real_source = source._real_repository
 
1753
        else:
 
1754
            real_source = source
 
1755
        if isinstance(target, remote.RemoteRepository):
 
1756
            target._ensure_real()
 
1757
            real_target = target._real_repository
 
1758
        else:
 
1759
            real_target = target
 
1760
        self.real_inter = InterRepository.get(real_source, real_target)
 
1761
 
 
1762
    @staticmethod
 
1763
    def is_compatible(source, target):
 
1764
        if isinstance(source, remote.RemoteRepository):
 
1765
            return True
 
1766
        if isinstance(target, remote.RemoteRepository):
 
1767
            return True
 
1768
        return False
 
1769
 
 
1770
    def copy_content(self, revision_id=None):
 
1771
        self.real_inter.copy_content(revision_id=revision_id)
 
1772
 
 
1773
    def fetch(self, revision_id=None, pb=None):
 
1774
        self.real_inter.fetch(revision_id=revision_id, pb=pb)
 
1775
 
 
1776
    @classmethod
 
1777
    def _get_repo_format_to_test(self):
 
1778
        return None
 
1779
 
 
1780
 
2106
1781
InterRepository.register_optimiser(InterSameDataRepository)
2107
1782
InterRepository.register_optimiser(InterWeaveRepo)
2108
1783
InterRepository.register_optimiser(InterKnitRepo)
2109
1784
InterRepository.register_optimiser(InterModel1and2)
2110
1785
InterRepository.register_optimiser(InterKnit1and2)
2111
 
 
2112
 
 
2113
 
class RepositoryTestProviderAdapter(object):
2114
 
    """A tool to generate a suite testing multiple repository formats at once.
2115
 
 
2116
 
    This is done by copying the test once for each transport and injecting
2117
 
    the transport_server, transport_readonly_server, and bzrdir_format and
2118
 
    repository_format classes into each copy. Each copy is also given a new id()
2119
 
    to make it easy to identify.
2120
 
    """
2121
 
 
2122
 
    def __init__(self, transport_server, transport_readonly_server, formats):
2123
 
        self._transport_server = transport_server
2124
 
        self._transport_readonly_server = transport_readonly_server
2125
 
        self._formats = formats
2126
 
    
2127
 
    def adapt(self, test):
2128
 
        result = TestSuite()
2129
 
        for repository_format, bzrdir_format in self._formats:
2130
 
            new_test = deepcopy(test)
2131
 
            new_test.transport_server = self._transport_server
2132
 
            new_test.transport_readonly_server = self._transport_readonly_server
2133
 
            new_test.bzrdir_format = bzrdir_format
2134
 
            new_test.repository_format = repository_format
2135
 
            def make_new_test_id():
2136
 
                new_id = "%s(%s)" % (new_test.id(), repository_format.__class__.__name__)
2137
 
                return lambda: new_id
2138
 
            new_test.id = make_new_test_id()
2139
 
            result.addTest(new_test)
2140
 
        return result
2141
 
 
2142
 
 
2143
 
class InterRepositoryTestProviderAdapter(object):
2144
 
    """A tool to generate a suite testing multiple inter repository formats.
2145
 
 
2146
 
    This is done by copying the test once for each interrepo provider and injecting
2147
 
    the transport_server, transport_readonly_server, repository_format and 
2148
 
    repository_to_format classes into each copy.
2149
 
    Each copy is also given a new id() to make it easy to identify.
2150
 
    """
2151
 
 
2152
 
    def __init__(self, transport_server, transport_readonly_server, formats):
2153
 
        self._transport_server = transport_server
2154
 
        self._transport_readonly_server = transport_readonly_server
2155
 
        self._formats = formats
2156
 
    
2157
 
    def adapt(self, test):
2158
 
        result = TestSuite()
2159
 
        for interrepo_class, repository_format, repository_format_to in self._formats:
2160
 
            new_test = deepcopy(test)
2161
 
            new_test.transport_server = self._transport_server
2162
 
            new_test.transport_readonly_server = self._transport_readonly_server
2163
 
            new_test.interrepo_class = interrepo_class
2164
 
            new_test.repository_format = repository_format
2165
 
            new_test.repository_format_to = repository_format_to
2166
 
            def make_new_test_id():
2167
 
                new_id = "%s(%s)" % (new_test.id(), interrepo_class.__name__)
2168
 
                return lambda: new_id
2169
 
            new_test.id = make_new_test_id()
2170
 
            result.addTest(new_test)
2171
 
        return result
2172
 
 
2173
 
    @staticmethod
2174
 
    def default_test_list():
2175
 
        """Generate the default list of interrepo permutations to test."""
2176
 
        result = []
2177
 
        # test the default InterRepository between format 6 and the current 
2178
 
        # default format.
2179
 
        # XXX: robertc 20060220 reinstate this when there are two supported
2180
 
        # formats which do not have an optimal code path between them.
2181
 
        #result.append((InterRepository,
2182
 
        #               RepositoryFormat6(),
2183
 
        #               RepositoryFormatKnit1()))
2184
 
        for optimiser in InterRepository._optimisers:
2185
 
            if optimiser._matching_repo_format is not None:
2186
 
                result.append((optimiser,
2187
 
                               optimiser._matching_repo_format,
2188
 
                               optimiser._matching_repo_format
2189
 
                               ))
2190
 
        # if there are specific combinations we want to use, we can add them 
2191
 
        # here.
2192
 
        result.append((InterModel1and2, RepositoryFormat5(),
2193
 
                       RepositoryFormatKnit2()))
2194
 
        result.append((InterKnit1and2, RepositoryFormatKnit1(),
2195
 
                       RepositoryFormatKnit2()))
2196
 
        return result
 
1786
InterRepository.register_optimiser(InterRemoteRepository)
2197
1787
 
2198
1788
 
2199
1789
class CopyConverter(object):
2279
1869
            self._committer = committer
2280
1870
 
2281
1871
        self.new_inventory = Inventory(None)
2282
 
        self._new_revision_id = revision_id
 
1872
        self._new_revision_id = osutils.safe_revision_id(revision_id)
2283
1873
        self.parents = parents
2284
1874
        self.repository = repository
2285
1875
 
2293
1883
        self._timestamp = round(timestamp, 3)
2294
1884
 
2295
1885
        if timezone is None:
2296
 
            self._timezone = local_time_offset()
 
1886
            self._timezone = osutils.local_time_offset()
2297
1887
        else:
2298
1888
            self._timezone = int(timezone)
2299
1889
 
2304
1894
 
2305
1895
        :return: The revision id of the recorded revision.
2306
1896
        """
2307
 
        rev = Revision(timestamp=self._timestamp,
 
1897
        rev = _mod_revision.Revision(
 
1898
                       timestamp=self._timestamp,
2308
1899
                       timezone=self._timezone,
2309
1900
                       committer=self._committer,
2310
1901
                       message=message,
2344
1935
 
2345
1936
    def _gen_revision_id(self):
2346
1937
        """Return new revision-id."""
2347
 
        s = '%s-%s-' % (self._config.user_email(), 
2348
 
                        compact_date(self._timestamp))
2349
 
        s += hexlify(rand_bytes(8))
2350
 
        return s
 
1938
        return generate_ids.gen_revision_id(self._config.username(),
 
1939
                                            self._timestamp)
2351
1940
 
2352
1941
    def _generate_revision_if_needed(self):
2353
1942
        """Create a revision id if None was supplied.
2354
1943
        
2355
1944
        If the repository can not support user-specified revision ids
2356
 
        they should override this function and raise UnsupportedOperation
 
1945
        they should override this function and raise CannotSetRevisionId
2357
1946
        if _new_revision_id is not None.
2358
1947
 
2359
 
        :raises: UnsupportedOperation
 
1948
        :raises: CannotSetRevisionId
2360
1949
        """
2361
1950
        if self._new_revision_id is None:
2362
1951
            self._new_revision_id = self._gen_revision_id()
2408
1997
        :param file_parents: The per-file parent revision ids.
2409
1998
        """
2410
1999
        self._add_text_to_weave(file_id, [], file_parents.keys())
 
2000
 
 
2001
    def modified_reference(self, file_id, file_parents):
 
2002
        """Record the modification of a reference.
 
2003
 
 
2004
        :param file_id: The file_id of the link to record.
 
2005
        :param file_parents: The per-file parent revision ids.
 
2006
        """
 
2007
        self._add_text_to_weave(file_id, [], file_parents.keys())
2411
2008
    
2412
2009
    def modified_file_text(self, file_id, file_parents,
2413
2010
                           get_content_byte_lines, text_sha1=None,
2512
2109
 
2513
2110
 
2514
2111
def _unescaper(match, _map=_unescape_map):
2515
 
    return _map[match.group(1)]
 
2112
    code = match.group(1)
 
2113
    try:
 
2114
        return _map[code]
 
2115
    except KeyError:
 
2116
        if not code.startswith('#'):
 
2117
            raise
 
2118
        return unichr(int(code[1:])).encode('utf8')
2516
2119
 
2517
2120
 
2518
2121
_unescape_re = None
2522
2125
    """Unescape predefined XML entities in a string of data."""
2523
2126
    global _unescape_re
2524
2127
    if _unescape_re is None:
2525
 
        _unescape_re = re.compile('\&([^;]*);')
 
2128
        _unescape_re = re.compile('\&([^;]*);')
2526
2129
    return _unescape_re.sub(_unescaper, data)