← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/missing.py

Turn completion assertions into separate methods.

Many common assertions used to be expressed as arguments to the complete
method.  This makes the checks more explicit, and the code easier to read.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/missing.py
1
 
# Copyright (C) 2005, 2006 Canonical Ltd
2
 
#
3
 
# This program is free software; you can redistribute it and/or modify
4
 
# it under the terms of the GNU General Public License as published by
5
 
# the Free Software Foundation; either version 2 of the License, or
6
 
# (at your option) any later version.
7
 
#
8
 
# This program is distributed in the hope that it will be useful,
9
 
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
 
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
 
# GNU General Public License for more details.
12
 
#
13
 
# You should have received a copy of the GNU General Public License
14
 
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
 
 
17
 
"""Display what revisions are missing in 'other' from 'this' and vice versa."""
18
 
 
19
 
from bzrlib import (
20
 
    log,
21
 
    )
22
 
import bzrlib.revision as _mod_revision
23
 
 
24
 
 
25
 
def iter_log_revisions(revisions, revision_source, verbose):
26
 
    last_tree = revision_source.revision_tree(_mod_revision.NULL_REVISION)
27
 
    last_rev_id = None
28
 
    for rev in revisions:
29
 
        # We need the following for backward compatibilty (hopefully
30
 
        # this will be deprecated soon :-/) -- vila 080911
31
 
        if len(rev) == 2:
32
 
            revno, rev_id = rev
33
 
            merge_depth = 0
34
 
        else:
35
 
            revno, rev_id, merge_depth = rev
36
 
        rev = revision_source.get_revision(rev_id)
37
 
        if verbose:
38
 
            delta = revision_source.get_revision_delta(rev_id)
39
 
        else:
40
 
            delta = None
41
 
        yield log.LogRevision(rev, revno, merge_depth, delta=delta)
42
 
 
43
 
 
44
 
def find_unmerged(local_branch, remote_branch, restrict='all',
45
 
                  include_merges=False, backward=False,
46
 
                  local_revid_range=None, remote_revid_range=None):
47
 
    """Find revisions from each side that have not been merged.
48
 
 
49
 
    :param local_branch: Compare the history of local_branch
50
 
    :param remote_branch: versus the history of remote_branch, and determine
51
 
        mainline revisions which have not been merged.
52
 
    :param restrict: ('all', 'local', 'remote') If 'all', we will return the
53
 
        unique revisions from both sides. If 'local', we will return None
54
 
        for the remote revisions, similarly if 'remote' we will return None for
55
 
        the local revisions.
56
 
    :param include_merges: Show mainline revisions only if False,
57
 
        all revisions otherwise.
58
 
    :param backward: Show oldest versions first when True, newest versions
59
 
        first when False.
60
 
    :param local_revid_range: Revision-id range for filtering local_branch
61
 
        revisions (lower bound, upper bound)
62
 
    :param remote_revid_range: Revision-id range for filtering remote_branch
63
 
        revisions (lower bound, upper bound)
64
 
 
65
 
    :return: A list of [(revno, revision_id)] for the mainline revisions on
66
 
        each side.
67
 
    """
68
 
    local_branch.lock_read()
69
 
    try:
70
 
        remote_branch.lock_read()
71
 
        try:
72
 
            return _find_unmerged(
73
 
                local_branch, remote_branch, restrict=restrict,
74
 
                include_merges=include_merges, backward=backward,
75
 
                local_revid_range=local_revid_range,
76
 
                remote_revid_range=remote_revid_range)
77
 
        finally:
78
 
            remote_branch.unlock()
79
 
    finally:
80
 
        local_branch.unlock()
81
 
 
82
 
 
83
 
def _enumerate_mainline(ancestry, graph, tip_revno, tip, backward=True):
84
 
    """Enumerate the mainline revisions for these revisions.
85
 
 
86
 
    :param ancestry: A set of revisions that we care about
87
 
    :param graph: A Graph which lets us find the parents for a revision
88
 
    :param tip_revno: The revision number for the tip revision
89
 
    :param tip: The tip of mainline
90
 
    :param backward: Show oldest versions first when True, newest versions
91
 
        first when False.
92
 
    :return: [(revno, revision_id)] for all revisions in ancestry that
93
 
        are left-hand parents from tip, or None if ancestry is None.
94
 
    """
95
 
    if ancestry is None:
96
 
        return None
97
 
    if not ancestry: #Empty ancestry, no need to do any work
98
 
        return []
99
 
 
100
 
    # Optionally, we could make 1 call to graph.get_parent_map with all
101
 
    # ancestors. However that will often check many more parents than we
102
 
    # actually need, and the Graph is likely to already have the parents cached
103
 
    # anyway.
104
 
    mainline = []
105
 
    cur = tip
106
 
    cur_revno = tip_revno
107
 
    while cur in ancestry:
108
 
        parent_map = graph.get_parent_map([cur])
109
 
        parents = parent_map.get(cur)
110
 
        if not parents:
111
 
            break # Ghost, we are done
112
 
        mainline.append((str(cur_revno), cur))
113
 
        cur = parents[0]
114
 
        cur_revno -= 1
115
 
    if not backward:
116
 
        mainline.reverse()
117
 
    return mainline
118
 
 
119
 
 
120
 
def _enumerate_with_merges(branch, ancestry, graph, tip_revno, tip,
121
 
                           backward=True):
122
 
    """Enumerate the revisions for the ancestry.
123
 
 
124
 
    :param branch: The branch we care about
125
 
    :param ancestry: A set of revisions that we care about
126
 
    :param graph: A Graph which lets us find the parents for a revision
127
 
    :param tip_revno: The revision number for the tip revision
128
 
    :param tip: The tip of the ancsetry
129
 
    :param backward: Show oldest versions first when True, newest versions
130
 
        first when False.
131
 
    :return: [(revno, revision_id)] for all revisions in ancestry that
132
 
        are parents from tip, or None if ancestry is None.
133
 
    """
134
 
    if ancestry is None:
135
 
        return None
136
 
    if not ancestry: #Empty ancestry, no need to do any work
137
 
        return []
138
 
 
139
 
    merge_sorted_revisions = branch.iter_merge_sorted_revisions()
140
 
    # Now that we got the correct revnos, keep only the relevant
141
 
    # revisions.
142
 
    merge_sorted_revisions = [
143
 
        # log.reverse_by_depth expects seq_num to be present, but it is
144
 
        # stripped by iter_merge_sorted_revisions()
145
 
        (0, revid, n, d, e) for revid, n, d, e in merge_sorted_revisions
146
 
        if revid in ancestry]
147
 
    if not backward:
148
 
        merge_sorted_revisions = log.reverse_by_depth(merge_sorted_revisions)
149
 
    revline = []
150
 
    for seq, rev_id, merge_depth, revno, end_of_merge in merge_sorted_revisions:
151
 
        revline.append(('.'.join(map(str, revno)), rev_id, merge_depth))
152
 
    return revline
153
 
 
154
 
 
155
 
def _filter_revs(graph, revs, revid_range):
156
 
    if revid_range is None or revs is None:
157
 
        return revs
158
 
    return [rev for rev in revs
159
 
        if graph.is_between(rev[1], revid_range[0], revid_range[1])]
160
 
 
161
 
 
162
 
def _find_unmerged(local_branch, remote_branch, restrict,
163
 
                   include_merges, backward,
164
 
                   local_revid_range=None, remote_revid_range=None):
165
 
    """See find_unmerged.
166
 
 
167
 
    The branches should already be locked before entering.
168
 
    """
169
 
    local_revno, local_revision_id = local_branch.last_revision_info()
170
 
    remote_revno, remote_revision_id = remote_branch.last_revision_info()
171
 
    if local_revno == remote_revno and local_revision_id == remote_revision_id:
172
 
        # A simple shortcut when the tips are at the same point
173
 
        return [], []
174
 
    graph = local_branch.repository.get_graph(remote_branch.repository)
175
 
    if restrict == 'remote':
176
 
        local_extra = None
177
 
        remote_extra = graph.find_unique_ancestors(remote_revision_id,
178
 
                                                   [local_revision_id])
179
 
    elif restrict == 'local':
180
 
        remote_extra = None
181
 
        local_extra = graph.find_unique_ancestors(local_revision_id,
182
 
                                                  [remote_revision_id])
183
 
    else:
184
 
        if restrict != 'all':
185
 
            raise ValueError('param restrict not one of "all", "local",'
186
 
                             ' "remote": %r' % (restrict,))
187
 
        local_extra, remote_extra = graph.find_difference(local_revision_id,
188
 
                                                          remote_revision_id)
189
 
    if include_merges:
190
 
        locals = _enumerate_with_merges(local_branch, local_extra,
191
 
                                        graph, local_revno,
192
 
                                        local_revision_id, backward)
193
 
        remotes = _enumerate_with_merges(remote_branch, remote_extra,
194
 
                                         graph, remote_revno,
195
 
                                         remote_revision_id, backward)
196
 
    else:
197
 
        # Now that we have unique ancestors, compute just the mainline, and
198
 
        # generate revnos for them.
199
 
        locals = _enumerate_mainline(local_extra, graph, local_revno,
200
 
                                     local_revision_id, backward)
201
 
        remotes = _enumerate_mainline(remote_extra, graph, remote_revno,
202
 
                                      remote_revision_id, backward)
203
 
    return _filter_revs(graph, locals, local_revid_range), _filter_revs(graph,
204
 
        remotes, remote_revid_range)
205
 
 
206
 
 
207
 
def sorted_revisions(revisions, history_map):
208
 
    revisions = [(history_map[r],r) for r in revisions]
209
 
    revisions.sort()
210
 
    return revisions