← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/repository.py

  • Committer: Jelmer Vernooij
  • Date: 2010-03-12 19:59:50 UTC
  • mto: This revision was merged to the branch mainline in revision 5089.
  • Revision ID: jelmer@samba.org-20100312195950-wwufs49rlkf0s471
``bzrlib.merge_directive._BaseMergeDirective`` has been renamed to 
``bzrlib.merge_directive.BaseMergeDirective`` and is now public.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/repository.py
40
40
    lru_cache,
41
41
    osutils,
42
42
    revision as _mod_revision,
43
 
    static_tuple,
44
43
    symbol_versioning,
45
44
    trace,
46
45
    tsort,
860
859
        # versioned roots do not change unless the tree found a change.
861
860
 
862
861
 
863
 
class RepositoryWriteLockResult(object):
864
 
    """The result of write locking a repository.
865
 
 
866
 
    :ivar repository_token: The token obtained from the underlying lock, or
867
 
        None.
868
 
    :ivar unlock: A callable which will unlock the lock.
869
 
    """
870
 
 
871
 
    def __init__(self, unlock, repository_token):
872
 
        self.repository_token = repository_token
873
 
        self.unlock = unlock
874
 
 
875
 
    def __str__(self):
876
 
        return "RepositoryWriteLockResult(%s, %s)" % (self.repository_token,
877
 
            self.unlock)
878
 
 
879
 
 
880
862
######################################################################
881
863
# Repositories
882
864
 
883
865
 
884
 
class Repository(_RelockDebugMixin, bzrdir.ControlComponent):
 
866
class Repository(_RelockDebugMixin):
885
867
    """Repository holding history for one or more branches.
886
868
 
887
869
    The repository holds and retrieves historical information including
1308
1290
 
1309
1291
        :param _format: The format of the repository on disk.
1310
1292
        :param a_bzrdir: The BzrDir of the repository.
 
1293
 
 
1294
        In the future we will have a single api for all stores for
 
1295
        getting file texts, inventories and revisions, then
 
1296
        this construct will accept instances of those things.
1311
1297
        """
1312
 
        # In the future we will have a single api for all stores for
1313
 
        # getting file texts, inventories and revisions, then
1314
 
        # this construct will accept instances of those things.
1315
1298
        super(Repository, self).__init__()
1316
1299
        self._format = _format
1317
1300
        # the following are part of the public API for Repository:
1332
1315
        # rather copying them?
1333
1316
        self._safe_to_return_from_cache = False
1334
1317
 
1335
 
    @property
1336
 
    def user_transport(self):
1337
 
        return self.bzrdir.user_transport
1338
 
 
1339
 
    @property
1340
 
    def control_transport(self):
1341
 
        return self._transport
1342
 
 
1343
1318
    def __repr__(self):
1344
1319
        if self._fallback_repositories:
1345
1320
            return '%s(%r, fallback_repositories=%r)' % (
1393
1368
        data during reads, and allows a 'write_group' to be obtained. Write
1394
1369
        groups must be used for actual data insertion.
1395
1370
 
1396
 
        A token should be passed in if you know that you have locked the object
1397
 
        some other way, and need to synchronise this object's state with that
1398
 
        fact.
1399
 
 
1400
 
        XXX: this docstring is duplicated in many places, e.g. lockable_files.py
1401
 
 
1402
1371
        :param token: if this is already locked, then lock_write will fail
1403
1372
            unless the token matches the existing lock.
1404
1373
        :returns: a token if this instance supports tokens, otherwise None.
1407
1376
        :raises MismatchedToken: if the specified token doesn't match the token
1408
1377
            of the existing lock.
1409
1378
        :seealso: start_write_group.
1410
 
        :return: A RepositoryWriteLockResult.
 
1379
 
 
1380
        A token should be passed in if you know that you have locked the object
 
1381
        some other way, and need to synchronise this object's state with that
 
1382
        fact.
 
1383
 
 
1384
        XXX: this docstring is duplicated in many places, e.g. lockable_files.py
1411
1385
        """
1412
1386
        locked = self.is_locked()
1413
 
        token = self.control_files.lock_write(token=token)
 
1387
        result = self.control_files.lock_write(token=token)
1414
1388
        if not locked:
1415
1389
            self._warn_if_deprecated()
1416
1390
            self._note_lock('w')
1418
1392
                # Writes don't affect fallback repos
1419
1393
                repo.lock_read()
1420
1394
            self._refresh_data()
1421
 
        return RepositoryWriteLockResult(self.unlock, token)
 
1395
        return result
1422
1396
 
1423
1397
    def lock_read(self):
1424
 
        """Lock the repository for read operations.
1425
 
 
1426
 
        :return: An object with an unlock method which will release the lock
1427
 
            obtained.
1428
 
        """
1429
1398
        locked = self.is_locked()
1430
1399
        self.control_files.lock_read()
1431
1400
        if not locked:
1434
1403
            for repo in self._fallback_repositories:
1435
1404
                repo.lock_read()
1436
1405
            self._refresh_data()
1437
 
        return self
1438
1406
 
1439
1407
    def get_physical_lock_status(self):
1440
1408
        return self.control_files.get_physical_lock_status()
1500
1468
 
1501
1469
        # now gather global repository information
1502
1470
        # XXX: This is available for many repos regardless of listability.
1503
 
        if self.user_transport.listable():
 
1471
        if self.bzrdir.root_transport.listable():
1504
1472
            # XXX: do we want to __define len__() ?
1505
1473
            # Maybe the versionedfiles object should provide a different
1506
1474
            # method to get the number of keys.
1538
1506
 
1539
1507
        ret = []
1540
1508
        for branches, repository in bzrdir.BzrDir.find_bzrdirs(
1541
 
                self.user_transport, evaluate=Evaluator()):
 
1509
                self.bzrdir.root_transport, evaluate=Evaluator()):
1542
1510
            if branches is not None:
1543
1511
                ret.extend(branches)
1544
1512
            if not using and repository is not None:
2612
2580
            keys = tsort.topo_sort(parent_map)
2613
2581
        return [None] + list(keys)
2614
2582
 
2615
 
    def pack(self, hint=None, clean_obsolete_packs=False):
 
2583
    def pack(self, hint=None):
2616
2584
        """Compress the data within the repository.
2617
2585
 
2618
2586
        This operation only makes sense for some repository types. For other
2628
2596
            obtained from the result of commit_write_group(). Out of
2629
2597
            date hints are simply ignored, because concurrent operations
2630
2598
            can obsolete them rapidly.
2631
 
 
2632
 
        :param clean_obsolete_packs: Clean obsolete packs immediately after
2633
 
            the pack operation.
2634
2599
        """
2635
2600
 
2636
2601
    def get_transaction(self):
2661
2626
    def _make_parents_provider(self):
2662
2627
        return self
2663
2628
 
2664
 
    @needs_read_lock
2665
 
    def get_known_graph_ancestry(self, revision_ids):
2666
 
        """Return the known graph for a set of revision ids and their ancestors.
2667
 
        """
2668
 
        st = static_tuple.StaticTuple
2669
 
        revision_keys = [st(r_id).intern() for r_id in revision_ids]
2670
 
        known_graph = self.revisions.get_known_graph_ancestry(revision_keys)
2671
 
        return graph.GraphThunkIdsToKeys(known_graph)
2672
 
 
2673
2629
    def get_graph(self, other_repository=None):
2674
2630
        """Return the graph walker for this repository format"""
2675
2631
        parents_provider = self._make_parents_provider()
3077
3033
    # Is the format experimental ?
3078
3034
    experimental = False
3079
3035
 
3080
 
    def __repr__(self):
3081
 
        return "%s()" % self.__class__.__name__
 
3036
    def __str__(self):
 
3037
        return "<%s>" % self.__class__.__name__
3082
3038
 
3083
3039
    def __eq__(self, other):
3084
3040
        # format objects are generally stateless
3202
3158
        """
3203
3159
        raise NotImplementedError(self.open)
3204
3160
 
3205
 
    def _run_post_repo_init_hooks(self, repository, a_bzrdir, shared):
3206
 
        from bzrlib.bzrdir import BzrDir, RepoInitHookParams
3207
 
        hooks = BzrDir.hooks['post_repo_init']
3208
 
        if not hooks:
3209
 
            return
3210
 
        params = RepoInitHookParams(repository, self, a_bzrdir, shared)
3211
 
        for hook in hooks:
3212
 
            hook(params)
3213
 
 
3214
3161
 
3215
3162
class MetaDirRepositoryFormat(RepositoryFormat):
3216
3163
    """Common base class for the new repositories using the metadir layout."""
3425
3372
        :return: None.
3426
3373
        """
3427
3374
        ui.ui_factory.warn_experimental_format_fetch(self)
3428
 
        from bzrlib.fetch import RepoFetcher
3429
 
        # See <https://launchpad.net/bugs/456077> asking for a warning here
3430
 
        if self.source._format.network_name() != self.target._format.network_name():
3431
 
            ui.ui_factory.show_user_warning('cross_format_fetch',
3432
 
                from_format=self.source._format,
3433
 
                to_format=self.target._format)
3434
 
        f = RepoFetcher(to_repository=self.target,
 
3375
        f = _mod_fetch.RepoFetcher(to_repository=self.target,
3435
3376
                               from_repository=self.source,
3436
3377
                               last_revision=revision_id,
3437
3378
                               fetch_spec=fetch_spec,
4015
3956
        """See InterRepository.fetch()."""
4016
3957
        if fetch_spec is not None:
4017
3958
            raise AssertionError("Not implemented yet...")
 
3959
        # See <https://launchpad.net/bugs/456077> asking for a warning here
 
3960
        #
 
3961
        # nb this is only active for local-local fetches; other things using
 
3962
        # streaming.
 
3963
        ui.ui_factory.warn_cross_format_fetch(self.source._format,
 
3964
            self.target._format)
4018
3965
        ui.ui_factory.warn_experimental_format_fetch(self)
4019
3966
        if (not self.source.supports_rich_root()
4020
3967
            and self.target.supports_rich_root()):
4022
3969
            self._revision_id_to_root_id = {}
4023
3970
        else:
4024
3971
            self._converting_to_rich_root = False
4025
 
        # See <https://launchpad.net/bugs/456077> asking for a warning here
4026
 
        if self.source._format.network_name() != self.target._format.network_name():
4027
 
            ui.ui_factory.show_user_warning('cross_format_fetch',
4028
 
                from_format=self.source._format,
4029
 
                to_format=self.target._format)
4030
3972
        revision_ids = self.target.search_missing_revision_ids(self.source,
4031
3973
            revision_id, find_ghosts=find_ghosts).get_keys()
4032
3974
        if not revision_ids:
4315
4257
                    self._extract_and_insert_inventories(
4316
4258
                        substream, src_serializer)
4317
4259
            elif substream_type == 'inventory-deltas':
 
4260
                ui.ui_factory.warn_cross_format_fetch(src_format,
 
4261
                    self.target_repo._format)
4318
4262
                self._extract_and_insert_inventory_deltas(
4319
4263
                    substream, src_serializer)
4320
4264
            elif substream_type == 'chk_bytes':