/brz/remove-bazaar

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

« back to all changes in this revision

Viewing changes to bzrlib/branch.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2010-04-22 17:08:27 UTC
  • mfrom: (5107.3.8 new_branch_and_repo_hooks)
  • Revision ID: pqm@pqm.ubuntu.com-20100422170827-h0bb41yq5nkosu6t
(vila) Add 'post_repo_init', 'post_branch_init' and 'post_switch' hooks. (Marco Pantaleoni)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/branch.py
49
49
from bzrlib.decorators import needs_read_lock, needs_write_lock, only_raises
50
50
from bzrlib.hooks import HookPoint, Hooks
51
51
from bzrlib.inter import InterObject
52
 
from bzrlib.lock import _RelockDebugMixin, LogicalLockResult
 
52
from bzrlib.lock import _RelockDebugMixin
53
53
from bzrlib import registry
54
54
from bzrlib.symbol_versioning import (
55
55
    deprecated_in,
63
63
BZR_BRANCH_FORMAT_6 = "Bazaar Branch Format 6 (bzr 0.15)\n"
64
64
 
65
65
 
66
 
class Branch(bzrdir.ControlComponent):
 
66
# TODO: Maybe include checks for common corruption of newlines, etc?
 
67
 
 
68
# TODO: Some operations like log might retrieve the same revisions
 
69
# repeatedly to calculate deltas.  We could perhaps have a weakref
 
70
# cache in memory to make this faster.  In general anything can be
 
71
# cached in memory between lock and unlock operations. .. nb thats
 
72
# what the transaction identity map provides
 
73
 
 
74
 
 
75
######################################################################
 
76
# branch objects
 
77
 
 
78
class Branch(object):
67
79
    """Branch holding a history of revisions.
68
80
 
69
 
    :ivar base:
70
 
        Base directory/url of the branch; using control_url and
71
 
        control_transport is more standardized.
 
81
    base
 
82
        Base directory/url of the branch.
72
83
 
73
84
    hooks: An instance of BranchHooks.
74
85
    """
76
87
    # - RBC 20060112
77
88
    base = None
78
89
 
79
 
    @property
80
 
    def control_transport(self):
81
 
        return self._transport
82
 
 
83
 
    @property
84
 
    def user_transport(self):
85
 
        return self.bzrdir.user_transport
86
 
 
87
90
    def __init__(self, *ignored, **ignored_too):
88
91
        self.tags = self._format.make_tags(self)
89
92
        self._revision_history_cache = None
104
107
        """Activate the branch/repository from url as a fallback repository."""
105
108
        repo = self._get_fallback_repository(url)
106
109
        if repo.has_same_location(self.repository):
107
 
            raise errors.UnstackableLocationError(self.user_url, url)
 
110
            raise errors.UnstackableLocationError(self.base, url)
108
111
        self.repository.add_fallback_repository(repo)
109
112
 
110
113
    def break_lock(self):
283
286
        new_history.reverse()
284
287
        return new_history
285
288
 
286
 
    def lock_write(self, token=None):
287
 
        """Lock the branch for write operations.
288
 
 
289
 
        :param token: A token to permit reacquiring a previously held and
290
 
            preserved lock.
291
 
        :return: A BranchWriteLockResult.
292
 
        """
 
289
    def lock_write(self):
293
290
        raise NotImplementedError(self.lock_write)
294
291
 
295
292
    def lock_read(self):
296
 
        """Lock the branch for read operations.
297
 
 
298
 
        :return: A bzrlib.lock.LogicalLockResult.
299
 
        """
300
293
        raise NotImplementedError(self.lock_read)
301
294
 
302
295
    def unlock(self):
427
420
            * 'include' - the stop revision is the last item in the result
428
421
            * 'with-merges' - include the stop revision and all of its
429
422
              merged revisions in the result
430
 
            * 'with-merges-without-common-ancestry' - filter out revisions 
431
 
              that are in both ancestries
432
423
        :param direction: either 'reverse' or 'forward':
433
424
            * reverse means return the start_revision_id first, i.e.
434
425
              start at the most recent revision and go backwards in history
465
456
            stop_revision_id, stop_rule)
466
457
        # Make sure we don't return revisions that are not part of the
467
458
        # start_revision_id ancestry.
468
 
        filtered = self._filter_start_non_ancestors(filtered)
 
459
        filtered = self._filter_non_ancestors(filtered)
469
460
        if direction == 'reverse':
470
461
            return filtered
471
462
        if direction == 'forward':
508
499
                       node.end_of_merge)
509
500
                if rev_id == stop_revision_id:
510
501
                    return
511
 
        elif stop_rule == 'with-merges-without-common-ancestry':
512
 
            # We want to exclude all revisions that are already part of the
513
 
            # stop_revision_id ancestry.
514
 
            graph = self.repository.get_graph()
515
 
            ancestors = graph.find_unique_ancestors(start_revision_id,
516
 
                                                    [stop_revision_id])
517
 
            for node in rev_iter:
518
 
                rev_id = node.key[-1]
519
 
                if rev_id not in ancestors:
520
 
                    continue
521
 
                yield (rev_id, node.merge_depth, node.revno,
522
 
                       node.end_of_merge)
523
502
        elif stop_rule == 'with-merges':
524
503
            stop_rev = self.repository.get_revision(stop_revision_id)
525
504
            if stop_rev.parent_ids:
548
527
        else:
549
528
            raise ValueError('invalid stop_rule %r' % stop_rule)
550
529
 
551
 
    def _filter_start_non_ancestors(self, rev_iter):
 
530
    def _filter_non_ancestors(self, rev_iter):
552
531
        # If we started from a dotted revno, we want to consider it as a tip
553
532
        # and don't want to yield revisions that are not part of its
554
533
        # ancestry. Given the order guaranteed by the merge sort, we will see
615
594
        :param other: The branch to bind to
616
595
        :type other: Branch
617
596
        """
618
 
        raise errors.UpgradeRequired(self.user_url)
 
597
        raise errors.UpgradeRequired(self.base)
619
598
 
620
599
    def set_append_revisions_only(self, enabled):
621
600
        if not self._format.supports_set_append_revisions_only():
622
 
            raise errors.UpgradeRequired(self.user_url)
 
601
            raise errors.UpgradeRequired(self.base)
623
602
        if enabled:
624
603
            value = 'True'
625
604
        else:
673
652
    def get_old_bound_location(self):
674
653
        """Return the URL of the branch we used to be bound to
675
654
        """
676
 
        raise errors.UpgradeRequired(self.user_url)
 
655
        raise errors.UpgradeRequired(self.base)
677
656
 
678
657
    def get_commit_builder(self, parents, config=None, timestamp=None,
679
658
                           timezone=None, committer=None, revprops=None,
757
736
            stacking.
758
737
        """
759
738
        if not self._format.supports_stacking():
760
 
            raise errors.UnstackableBranchFormat(self._format, self.user_url)
 
739
            raise errors.UnstackableBranchFormat(self._format, self.base)
761
740
        # XXX: Changing from one fallback repository to another does not check
762
741
        # that all the data you need is present in the new fallback.
763
742
        # Possibly it should.
914
893
 
915
894
    def unbind(self):
916
895
        """Older format branches cannot bind or unbind."""
917
 
        raise errors.UpgradeRequired(self.user_url)
 
896
        raise errors.UpgradeRequired(self.base)
918
897
 
919
898
    def last_revision(self):
920
899
        """Return last revision id, or NULL_REVISION."""
1080
1059
        try:
1081
1060
            return urlutils.join(self.base[:-1], parent)
1082
1061
        except errors.InvalidURLJoin, e:
1083
 
            raise errors.InaccessibleParent(parent, self.user_url)
 
1062
            raise errors.InaccessibleParent(parent, self.base)
1084
1063
 
1085
1064
    def _get_parent_location(self):
1086
1065
        raise NotImplementedError(self._get_parent_location)
1585
1564
            elsewhere)
1586
1565
        :return: a branch in this format
1587
1566
        """
1588
 
        mutter('creating branch %r in %s', self, a_bzrdir.user_url)
 
1567
        mutter('creating branch %r in %s', self, a_bzrdir.transport.base)
1589
1568
        branch_transport = a_bzrdir.get_branch_transport(self, name=name)
1590
1569
        lock_map = {
1591
1570
            'metadir': ('lock', lockdir.LockDir),
1978
1957
            if format.__class__ != self.__class__:
1979
1958
                raise AssertionError("wrong format %r found for %r" %
1980
1959
                    (format, self))
1981
 
        transport = a_bzrdir.get_branch_transport(None, name=name)
1982
1960
        try:
 
1961
            transport = a_bzrdir.get_branch_transport(None, name=name)
1983
1962
            control_files = lockable_files.LockableFiles(transport, 'lock',
1984
1963
                                                         lockdir.LockDir)
1985
1964
            return self._branch_class()(_format=self,
2183
2162
            # this format does not implement branch itself, thus the implicit
2184
2163
            # creation contract must see it as uninitializable
2185
2164
            raise errors.UninitializableFormat(self)
2186
 
        mutter('creating branch reference in %s', a_bzrdir.user_url)
 
2165
        mutter('creating branch reference in %s', a_bzrdir.transport.base)
2187
2166
        branch_transport = a_bzrdir.get_branch_transport(self, name=name)
2188
2167
        branch_transport.put_bytes('location',
2189
 
            target_branch.bzrdir.user_url)
 
2168
            target_branch.bzrdir.root_transport.base)
2190
2169
        branch_transport.put_bytes('format', self.get_format_string())
2191
2170
        branch = self.open(
2192
2171
            a_bzrdir, name, _found=True,
2275
2254
    _legacy_formats[0].network_name(), _legacy_formats[0].__class__)
2276
2255
 
2277
2256
 
2278
 
class BranchWriteLockResult(LogicalLockResult):
2279
 
    """The result of write locking a branch.
2280
 
 
2281
 
    :ivar branch_token: The token obtained from the underlying branch lock, or
2282
 
        None.
2283
 
    :ivar unlock: A callable which will unlock the lock.
2284
 
    """
2285
 
 
2286
 
    def __init__(self, unlock, branch_token):
2287
 
        LogicalLockResult.__init__(self, unlock)
2288
 
        self.branch_token = branch_token
2289
 
 
2290
 
    def __repr__(self):
2291
 
        return "BranchWriteLockResult(%s, %s)" % (self.branch_token,
2292
 
            self.unlock)
2293
 
 
2294
 
 
2295
2257
class BzrBranch(Branch, _RelockDebugMixin):
2296
2258
    """A branch stored in the actual filesystem.
2297
2259
 
2331
2293
 
2332
2294
    def __str__(self):
2333
2295
        if self.name is None:
2334
 
            return '%s(%s)' % (self.__class__.__name__, self.user_url)
 
2296
            return '%s(%r)' % (self.__class__.__name__, self.base)
2335
2297
        else:
2336
 
            return '%s(%s,%s)' % (self.__class__.__name__, self.user_url,
2337
 
                self.name)
 
2298
            return '%s(%r,%r)' % (self.__class__.__name__, self.base, self.name)
2338
2299
 
2339
2300
    __repr__ = __str__
2340
2301
 
2351
2312
        return self.control_files.is_locked()
2352
2313
 
2353
2314
    def lock_write(self, token=None):
2354
 
        """Lock the branch for write operations.
2355
 
 
2356
 
        :param token: A token to permit reacquiring a previously held and
2357
 
            preserved lock.
2358
 
        :return: A BranchWriteLockResult.
2359
 
        """
2360
2315
        if not self.is_locked():
2361
2316
            self._note_lock('w')
2362
2317
        # All-in-one needs to always unlock/lock.
2368
2323
        else:
2369
2324
            took_lock = False
2370
2325
        try:
2371
 
            return BranchWriteLockResult(self.unlock,
2372
 
                self.control_files.lock_write(token=token))
 
2326
            return self.control_files.lock_write(token=token)
2373
2327
        except:
2374
2328
            if took_lock:
2375
2329
                self.repository.unlock()
2376
2330
            raise
2377
2331
 
2378
2332
    def lock_read(self):
2379
 
        """Lock the branch for read operations.
2380
 
 
2381
 
        :return: A bzrlib.lock.LogicalLockResult.
2382
 
        """
2383
2333
        if not self.is_locked():
2384
2334
            self._note_lock('r')
2385
2335
        # All-in-one needs to always unlock/lock.
2392
2342
            took_lock = False
2393
2343
        try:
2394
2344
            self.control_files.lock_read()
2395
 
            return LogicalLockResult(self.unlock)
2396
2345
        except:
2397
2346
            if took_lock:
2398
2347
                self.repository.unlock()
2567
2516
        return result
2568
2517
 
2569
2518
    def get_stacked_on_url(self):
2570
 
        raise errors.UnstackableBranchFormat(self._format, self.user_url)
 
2519
        raise errors.UnstackableBranchFormat(self._format, self.base)
2571
2520
 
2572
2521
    def set_push_location(self, location):
2573
2522
        """See Branch.set_push_location."""
2763
2712
        if _mod_revision.is_null(last_revision):
2764
2713
            return
2765
2714
        if last_revision not in self._lefthand_history(revision_id):
2766
 
            raise errors.AppendRevisionsOnlyViolation(self.user_url)
 
2715
            raise errors.AppendRevisionsOnlyViolation(self.base)
2767
2716
 
2768
2717
    def _gen_revision_history(self):
2769
2718
        """Generate the revision history from last revision
2869
2818
        if branch_location is None:
2870
2819
            return Branch.reference_parent(self, file_id, path,
2871
2820
                                           possible_transports)
2872
 
        branch_location = urlutils.join(self.user_url, branch_location)
 
2821
        branch_location = urlutils.join(self.base, branch_location)
2873
2822
        return Branch.open(branch_location,
2874
2823
                           possible_transports=possible_transports)
2875
2824
 
2921
2870
        return stacked_url
2922
2871
 
2923
2872
    def _get_append_revisions_only(self):
2924
 
        return self.get_config(
2925
 
            ).get_user_option_as_bool('append_revisions_only')
 
2873
        value = self.get_config().get_user_option('append_revisions_only')
 
2874
        return value == 'True'
2926
2875
 
2927
2876
    @needs_write_lock
2928
2877
    def generate_revision_history(self, revision_id, last_rev=None,
2990
2939
    """
2991
2940
 
2992
2941
    def get_stacked_on_url(self):
2993
 
        raise errors.UnstackableBranchFormat(self._format, self.user_url)
 
2942
        raise errors.UnstackableBranchFormat(self._format, self.base)
2994
2943
 
2995
2944
 
2996
2945
######################################################################
3083
3032
        :param verbose: Requests more detailed display of what was checked,
3084
3033
            if any.
3085
3034
        """
3086
 
        note('checked branch %s format %s', self.branch.user_url,
 
3035
        note('checked branch %s format %s', self.branch.base,
3087
3036
            self.branch._format)
3088
3037
        for error in self.errors:
3089
3038
            note('found error:%s', error)
3418
3367
        if local and not bound_location:
3419
3368
            raise errors.LocalRequiresBoundBranch()
3420
3369
        master_branch = None
3421
 
        if not local and bound_location and self.source.user_url != bound_location:
 
3370
        if not local and bound_location and self.source.base != bound_location:
3422
3371
            # not pulling from master, so we need to update master.
3423
3372
            master_branch = self.target.get_master_branch(possible_transports)
3424
3373
            master_branch.lock_write()