← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/revision.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2007-06-18 05:22:35 UTC
  • mfrom: (1551.15.27 Aaron's mergeable stuff)
  • Revision ID: pqm@pqm.ubuntu.com-20070618052235-mvns8j28szyzscy0
Turn list-weave into list-versionedfile

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/revision.py
18
18
# perhaps show them in log -v and allow them as options to the commit command.
19
19
 
20
20
 
21
 
from bzrlib import (
22
 
    errors,
23
 
    symbol_versioning
24
 
    )
25
 
from bzrlib.deprecated_graph import (
26
 
    all_descendants,
27
 
    Graph,
28
 
    node_distances,
29
 
    select_farthest,
30
 
    )
 
21
import bzrlib.errors as errors
 
22
from bzrlib.graph import node_distances, select_farthest, all_descendants, Graph
31
23
from bzrlib.osutils import contains_whitespace
32
24
from bzrlib.progress import DummyProgress
33
25
from bzrlib.symbol_versioning import (deprecated_function,
 
26
        zero_eight,
34
27
        )
35
28
 
36
29
NULL_REVISION="null:"
114
107
    def get_summary(self):
115
108
        """Get the first line of the log message for this revision.
116
109
        """
117
 
        return self.message.lstrip().split('\n', 1)[0]
118
 
 
119
 
    def get_apparent_author(self):
120
 
        """Return the apparent author of this revision.
121
 
 
122
 
        If the revision properties contain the author name,
123
 
        return it. Otherwise return the committer name.
124
 
        """
125
 
        return self.properties.get('author', self.committer)
126
 
 
127
 
 
128
 
@deprecated_function(symbol_versioning.one_zero)
 
110
        return self.message.split('\n', 1)[0]
 
111
 
 
112
 
129
113
def is_ancestor(revision_id, candidate_id, branch):
130
114
    """Return true if candidate_id is an ancestor of revision_id.
131
115
 
134
118
    
135
119
    revisions_source is an object supporting a get_revision operation that
136
120
    behaves like Branch's.
137
 
 
138
 
    This function is deprecated, it is better for callers to directly use
139
 
    Graph.is_ancestor() (just watch out that the parameter order is switched)
140
121
    """
141
 
    return branch.repository.get_graph().is_ancestor(candidate_id, revision_id)
 
122
    return (candidate_id in branch.repository.get_ancestry(revision_id))
142
123
 
143
124
 
144
125
def iter_ancestors(revision_id, revision_source, only_present=False):
272
253
                [revision_a, revision_b])
273
254
            # Shortcut the case where one of the tips is already included in
274
255
            # the other graphs ancestry.
275
 
            ancestry_a = graph.get_ancestry(revision_a, topo_sorted=False)
 
256
            ancestry_a = graph.get_ancestry(revision_a)
276
257
            if revision_b in ancestry_a:
277
258
                return revision_b
278
 
            ancestry_b = graph.get_ancestry(revision_b, topo_sorted=False)
 
259
            ancestry_b = graph.get_ancestry(revision_b)
279
260
            if revision_a in ancestry_b:
280
261
                return revision_a
281
262
            # convert to a NULL_REVISION based graph.
438
419
            source.unlock()
439
420
 
440
421
 
 
422
@deprecated_function(zero_eight)
 
423
def get_intervening_revisions(ancestor_id, rev_id, rev_source,
 
424
                              revision_history=None):
 
425
    """Find the longest line of descent from maybe_ancestor to revision.
 
426
    Revision history is followed where possible.
 
427
 
 
428
    If ancestor_id == rev_id, list will be empty.
 
429
    Otherwise, rev_id will be the last entry.  ancestor_id will never appear.
 
430
    If ancestor_id is not an ancestor, NotAncestor will be thrown
 
431
    """
 
432
    root, ancestors, descendants = revision_graph(rev_id, rev_source)
 
433
    if len(descendants) == 0:
 
434
        raise errors.NoSuchRevision(rev_source, rev_id)
 
435
    if ancestor_id not in descendants:
 
436
        rev_source.get_revision(ancestor_id)
 
437
        raise errors.NotAncestor(rev_id, ancestor_id)
 
438
    root_descendants = all_descendants(descendants, ancestor_id)
 
439
    root_descendants.add(ancestor_id)
 
440
    if rev_id not in root_descendants:
 
441
        raise errors.NotAncestor(rev_id, ancestor_id)
 
442
    distances = node_distances(descendants, ancestors, ancestor_id,
 
443
                               root_descendants=root_descendants)
 
444
 
 
445
    def best_ancestor(rev_id):
 
446
        best = None
 
447
        for anc_id in ancestors[rev_id]:
 
448
            try:
 
449
                distance = distances[anc_id]
 
450
            except KeyError:
 
451
                continue
 
452
            if revision_history is not None and anc_id in revision_history:
 
453
                return anc_id
 
454
            elif best is None or distance > best[1]:
 
455
                best = (anc_id, distance)
 
456
        return best[0]
 
457
 
 
458
    next = rev_id
 
459
    path = []
 
460
    while next != ancestor_id:
 
461
        path.append(next)
 
462
        next = best_ancestor(next)
 
463
    path.reverse()
 
464
    return path
 
465
 
 
466
 
441
467
def is_reserved_id(revision_id):
442
468
    """Determine whether a revision id is reserved
443
469
 
450
476
    """Raise ReservedId if the supplied revision_id is reserved"""
451
477
    if is_reserved_id(revision_id):
452
478
        raise errors.ReservedId(revision_id)
453
 
 
454
 
 
455
 
def ensure_null(revision_id):
456
 
    """Ensure only NULL_REVISION is used to represent the null revision"""
457
 
    if revision_id is None:
458
 
        symbol_versioning.warn('NULL_REVISION should be used for the null'
459
 
            ' revision instead of None, as of bzr 0.91.',
460
 
            DeprecationWarning, stacklevel=2)
461
 
        return NULL_REVISION
462
 
    else:
463
 
        return revision_id
464
 
 
465
 
 
466
 
def is_null(revision_id):
467
 
    if revision_id is None:
468
 
        symbol_versioning.warn('NULL_REVISION should be used for the null'
469
 
            ' revision instead of None, as of bzr 0.90.',
470
 
            DeprecationWarning, stacklevel=2)
471
 
    return revision_id in (None, NULL_REVISION)