~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/revision.py

  • Committer: Martin Pool
  • Date: 2005-09-01 12:34:34 UTC
  • Revision ID: mbp@sourcefrog.net-20050901123434-47f5353abbeae0d6
- typo fixes from kfish

- point the tutorial to the web site where it's now maintained

Show diffs side-by-side

added added

removed removed

Lines of Context:
16
16
 
17
17
 
18
18
import bzrlib.errors
19
 
from bzrlib.graph import node_distances, select_farthest, all_descendants
 
19
 
20
20
 
21
21
class RevisionReference(object):
22
22
    """
70
70
    def __repr__(self):
71
71
        return "<Revision id %s>" % self.revision_id
72
72
 
73
 
    def __eq__(self, other):
74
 
        if not isinstance(other, Revision):
75
 
            return False
76
 
        return (self.inventory_id == other.inventory_id
77
 
                and self.inventory_sha1 == other.inventory_sha1
78
 
                and self.revision_id == other.revision_id
79
 
                and self.timestamp == other.timestamp
80
 
                and self.message == other.message
81
 
                and self.timezone == other.timezone
82
 
                and self.committer == other.committer)
83
 
 
84
 
    def __ne__(self, other):
85
 
        return not self.__eq__(other)
86
 
 
87
 
        
 
73
        
 
74
    def to_element(self):
 
75
        from bzrlib.xml import Element, SubElement
 
76
        
 
77
        root = Element('revision',
 
78
                       committer = self.committer,
 
79
                       timestamp = '%.9f' % self.timestamp,
 
80
                       revision_id = self.revision_id,
 
81
                       inventory_id = self.inventory_id,
 
82
                       inventory_sha1 = self.inventory_sha1,
 
83
                       )
 
84
        if self.timezone:
 
85
            root.set('timezone', str(self.timezone))
 
86
        root.text = '\n'
 
87
        
 
88
        msg = SubElement(root, 'message')
 
89
        msg.text = self.message
 
90
        msg.tail = '\n'
 
91
 
 
92
        if self.parents:
 
93
            pelts = SubElement(root, 'parents')
 
94
            pelts.tail = pelts.text = '\n'
 
95
            for rr in self.parents:
 
96
                assert isinstance(rr, RevisionReference)
 
97
                p = SubElement(pelts, 'revision_ref')
 
98
                p.tail = '\n'
 
99
                assert rr.revision_id
 
100
                p.set('revision_id', rr.revision_id)
 
101
                if rr.revision_sha1:
 
102
                    p.set('revision_sha1', rr.revision_sha1)
 
103
 
 
104
        return root
 
105
 
 
106
 
 
107
    def from_element(cls, elt):
 
108
        return unpack_revision(elt)
 
109
 
 
110
    from_element = classmethod(from_element)
 
111
 
 
112
 
 
113
 
 
114
def unpack_revision(elt):
 
115
    """Convert XML element into Revision object."""
 
116
    # <changeset> is deprecated...
 
117
    if elt.tag not in ('revision', 'changeset'):
 
118
        raise bzrlib.errors.BzrError("unexpected tag in revision file: %r" % elt)
 
119
 
 
120
    rev = Revision(committer = elt.get('committer'),
 
121
                   timestamp = float(elt.get('timestamp')),
 
122
                   revision_id = elt.get('revision_id'),
 
123
                   inventory_id = elt.get('inventory_id'),
 
124
                   inventory_sha1 = elt.get('inventory_sha1')
 
125
                   )
 
126
 
 
127
    precursor = elt.get('precursor')
 
128
    precursor_sha1 = elt.get('precursor_sha1')
 
129
 
 
130
    pelts = elt.find('parents')
 
131
 
 
132
    if pelts:
 
133
        for p in pelts:
 
134
            assert p.tag == 'revision_ref', \
 
135
                   "bad parent node tag %r" % p.tag
 
136
            rev_ref = RevisionReference(p.get('revision_id'),
 
137
                                        p.get('revision_sha1'))
 
138
            rev.parents.append(rev_ref)
 
139
 
 
140
        if precursor:
 
141
            # must be consistent
 
142
            prec_parent = rev.parents[0].revision_id
 
143
            assert prec_parent == precursor
 
144
    elif precursor:
 
145
        # revisions written prior to 0.0.5 have a single precursor
 
146
        # give as an attribute
 
147
        rev_ref = RevisionReference(precursor, precursor_sha1)
 
148
        rev.parents.append(rev_ref)
 
149
 
 
150
    v = elt.get('timezone')
 
151
    rev.timezone = v and int(v)
 
152
 
 
153
    rev.message = elt.findtext('message') # text of <message>
 
154
    return rev
 
155
 
 
156
 
88
157
 
89
158
REVISION_ID_RE = None
90
159
 
159
228
    return matches
160
229
 
161
230
 
162
 
def old_common_ancestor(revision_a, revision_b, revision_source):
 
231
def common_ancestor(revision_a, revision_b, revision_source):
163
232
    """Find the ancestor common to both revisions that is closest to both.
164
233
    """
165
234
    from bzrlib.trace import mutter
190
259
        raise bzrlib.errors.AmbiguousBase((a_closest[0], b_closest[0]))
191
260
    return a_closest[0]
192
261
 
193
 
def revision_graph(revision, revision_source):
194
 
    """Produce a graph of the ancestry of the specified revision.
195
 
    Return root, ancestors map, descendants map
196
 
 
197
 
    TODO: Produce graphs with the NULL revision as root, so that we can find
198
 
    a common even when trees are not branches don't represent a single line
199
 
    of descent.
200
 
    """
201
 
    ancestors = {}
202
 
    descendants = {}
203
 
    lines = [revision]
204
 
    root = None
205
 
    descendants[revision] = {}
206
 
    while len(lines) > 0:
207
 
        new_lines = set()
208
 
        for line in lines:
209
 
            try:
210
 
                rev = revision_source.get_revision(line)
211
 
                parents = [p.revision_id for p in rev.parents]
212
 
                if len(parents) == 0:
213
 
                    root = line
214
 
            except bzrlib.errors.NoSuchRevision:
215
 
                if line == revision:
216
 
                    raise
217
 
                parents = None
218
 
            if parents is not None:
219
 
                for parent in parents:
220
 
                    if parent not in ancestors:
221
 
                        new_lines.add(parent)
222
 
                    if parent not in descendants:
223
 
                        descendants[parent] = {}
224
 
                    descendants[parent][line] = 1
225
 
            if parents is not None:
226
 
                ancestors[line] = set(parents)
227
 
        lines = new_lines
228
 
    assert root not in descendants[root]
229
 
    assert root not in ancestors[root]
230
 
    return root, ancestors, descendants
231
 
 
232
 
def combined_graph(revision_a, revision_b, revision_source):
233
 
    """Produce a combined ancestry graph.
234
 
    Return graph root, ancestors map, descendants map, set of common nodes"""
235
 
    root, ancestors, descendants = revision_graph(revision_a, revision_source)
236
 
    root_b, ancestors_b, descendants_b = revision_graph(revision_b, 
237
 
                                                        revision_source)
238
 
    if root != root_b:
239
 
        raise bzrlib.errors.NoCommonRoot(revision_a, revision_b)
240
 
    common = set()
241
 
    for node, node_anc in ancestors_b.iteritems():
242
 
        if node in ancestors:
243
 
            common.add(node)
244
 
        else:
245
 
            ancestors[node] = set()
246
 
        ancestors[node].update(node_anc)
247
 
    for node, node_dec in descendants_b.iteritems():
248
 
        if node not in descendants:
249
 
            descendants[node] = set()
250
 
        descendants[node].update(node_dec)
251
 
    return root, ancestors, descendants, common
252
 
 
253
 
def common_ancestor(revision_a, revision_b, revision_source):
254
 
    try:
255
 
        root, ancestors, descendants, common = \
256
 
            combined_graph(revision_a, revision_b, revision_source)
257
 
    except bzrlib.errors.NoCommonRoot:
258
 
        raise bzrlib.errors.NoCommonAncestor(revision_a, revision_b)
259
 
        
260
 
    distances = node_distances (descendants, ancestors, root)
261
 
    farthest = select_farthest(distances, common)
262
 
    if farthest is None:
263
 
        raise bzrlib.errors.NoCommonAncestor(revision_a, revision_b)
264
 
    return farthest
265
 
 
266
262
class MultipleRevisionSources(object):
267
263
    """Proxy that looks in multiple branches for revisions."""
268
264
    def __init__(self, *args):
277
273
            except bzrlib.errors.NoSuchRevision, e:
278
274
                pass
279
275
        raise e
280
 
 
281
 
def get_intervening_revisions(ancestor_id, rev_id, rev_source, 
282
 
                              revision_history=None):
283
 
    """Find the longest line of descent from maybe_ancestor to revision.
284
 
    Revision history is followed where possible.
285
 
 
286
 
    If ancestor_id == rev_id, list will be empty.
287
 
    Otherwise, rev_id will be the last entry.  ancestor_id will never appear.
288
 
    If ancestor_id is not an ancestor, NotAncestor will be thrown
289
 
    """
290
 
    root, ancestors, descendants = revision_graph(rev_id, rev_source)
291
 
    if len(descendants) == 0:
292
 
        raise NoSuchRevision(rev_source, rev_id)
293
 
    if ancestor_id not in descendants:
294
 
        rev_source.get_revision(ancestor_id)
295
 
        raise bzrlib.errors.NotAncestor(rev_id, ancestor_id)
296
 
    root_descendants = all_descendants(descendants, ancestor_id)
297
 
    root_descendants.add(ancestor_id)
298
 
    if rev_id not in root_descendants:
299
 
        raise bzrlib.errors.NotAncestor(rev_id, ancestor_id)
300
 
    distances = node_distances(descendants, ancestors, ancestor_id,
301
 
                               root_descendants=root_descendants)
302
 
 
303
 
    def best_ancestor(rev_id):
304
 
        best = None
305
 
        for anc_id in ancestors[rev_id]:
306
 
            try:
307
 
                distance = distances[anc_id]
308
 
            except KeyError:
309
 
                continue
310
 
            if revision_history is not None and anc_id in revision_history:
311
 
                return anc_id
312
 
            elif best is None or distance > best[1]:
313
 
                best = (anc_id, distance)
314
 
        return best[0]
315
 
 
316
 
    next = rev_id
317
 
    path = []
318
 
    while next != ancestor_id:
319
 
        path.append(next)
320
 
        next = best_ancestor(next)
321
 
    path.reverse()
322
 
    return path