1
# Copyright (C) 2005-2011 Canonical Ltd
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
5
5
# the Free Software Foundation; either version 2 of the License, or
6
6
# (at your option) any later version.
8
8
# This program is distributed in the hope that it will be useful,
9
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
11
# GNU General Public License for more details.
13
13
# You should have received a copy of the GNU General Public License
14
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
17
# TODO: Some kind of command-line display of revision properties:
18
# perhaps show them in log -v and allow them as options to the commit command.
21
from bzrlib.lazy_import import lazy_import
22
lazy_import(globals(), """
23
from bzrlib import bugtracker
29
from bzrlib.osutils import contains_whitespace
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19
from bzrlib.graph import node_distances, select_farthest, all_descendants
31
21
NULL_REVISION="null:"
32
CURRENT_REVISION="current:"
35
23
class Revision(object):
36
24
"""Single revision on a branch.
69
52
def __eq__(self, other):
70
53
if not isinstance(other, Revision):
73
self.inventory_sha1 == other.inventory_sha1
55
return (self.inventory_id == other.inventory_id
56
and self.inventory_sha1 == other.inventory_sha1
74
57
and self.revision_id == other.revision_id
75
58
and self.timestamp == other.timestamp
76
59
and self.message == other.message
77
60
and self.timezone == other.timezone
78
and self.committer == other.committer
79
and self.properties == other.properties
80
and self.parent_ids == other.parent_ids)
61
and self.committer == other.committer)
82
63
def __ne__(self, other):
83
64
return not self.__eq__(other)
85
def _check_properties(self):
86
"""Verify that all revision properties are OK."""
87
for name, value in self.properties.iteritems():
88
if not isinstance(name, basestring) or contains_whitespace(name):
89
raise ValueError("invalid property name %r" % name)
90
if not isinstance(value, basestring):
91
raise ValueError("invalid property value %r for %r" %
94
def get_history(self, repository):
95
"""Return the canonical line-of-history for this revision.
97
If ghosts are present this may differ in result from a ghost-free
100
current_revision = self
102
while current_revision is not None:
103
reversed_result.append(current_revision.revision_id)
104
if not len (current_revision.parent_ids):
105
reversed_result.append(None)
106
current_revision = None
108
next_revision_id = current_revision.parent_ids[0]
109
current_revision = repository.get_revision(next_revision_id)
110
reversed_result.reverse()
111
return reversed_result
113
def get_summary(self):
114
"""Get the first line of the log message for this revision.
116
Return an empty string if message is None.
119
return self.message.lstrip().split('\n', 1)[0]
123
def get_apparent_authors(self):
124
"""Return the apparent authors of this revision.
126
If the revision properties contain the names of the authors,
127
return them. Otherwise return the committer name.
129
The return value will be a list containing at least one element.
131
authors = self.properties.get('authors', None)
133
author = self.properties.get('author', self.committer)
138
return authors.split("\n")
141
"""Iterate over the bugs associated with this revision."""
142
bug_property = self.properties.get('bugs', None)
143
if bug_property is None:
145
for line in bug_property.splitlines():
147
url, status = line.split(None, 2)
149
raise errors.InvalidLineInBugsProperty(line)
150
if status not in bugtracker.ALLOWED_BUG_STATUSES:
151
raise errors.InvalidBugStatus(status)
70
def validate_revision_id(rid):
71
"""Check rid is syntactically valid for a revision id."""
73
if not REVISION_ID_RE:
75
REVISION_ID_RE = re.compile('[\w.-]+@[\w.-]+--?\d+--?[0-9a-f]+\Z')
77
if not REVISION_ID_RE.match(rid):
78
raise ValueError("malformed revision-id %r" % rid)
81
def is_ancestor(revision_id, candidate_id, branch):
82
"""Return true if candidate_id is an ancestor of revision_id.
84
A false negative will be returned if any intermediate descendent of
85
candidate_id is not present in any of the revision_sources.
87
revisions_source is an object supporting a get_revision operation that
88
behaves like Branch's.
90
return candidate_id in branch.get_ancestry(revision_id)
155
93
def iter_ancestors(revision_id, revision_source, only_present=False):
178
116
"""Return the ancestors of a revision present in a branch.
180
118
It's possible that a branch won't have the complete ancestry of
181
one of its revisions.
119
one of its revisions.
184
122
found_ancestors = {}
185
123
anc_iter = enumerate(iter_ancestors(revision_id, revision_source,
186
124
only_present=True))
187
125
for anc_order, (anc_id, anc_distance) in anc_iter:
188
if anc_id not in found_ancestors:
126
if not found_ancestors.has_key(anc_id):
189
127
found_ancestors[anc_id] = (anc_order, anc_distance)
190
128
return found_ancestors
193
131
def __get_closest(intersection):
194
132
intersection.sort()
196
134
for entry in intersection:
197
135
if entry[0] == intersection[0][0]:
198
136
matches.append(entry[2])
202
def is_reserved_id(revision_id):
203
"""Determine whether a revision id is reserved
205
:return: True if the revision is reserved, False otherwise
140
def old_common_ancestor(revision_a, revision_b, revision_source):
141
"""Find the ancestor common to both revisions that is closest to both.
207
return isinstance(revision_id, basestring) and revision_id.endswith(':')
210
def check_not_reserved_id(revision_id):
211
"""Raise ReservedId if the supplied revision_id is reserved"""
212
if is_reserved_id(revision_id):
213
raise errors.ReservedId(revision_id)
216
def ensure_null(revision_id):
217
"""Ensure only NULL_REVISION is used to represent the null revision"""
218
if revision_id is None:
219
symbol_versioning.warn('NULL_REVISION should be used for the null'
220
' revision instead of None, as of bzr 0.91.',
221
DeprecationWarning, stacklevel=2)
143
from bzrlib.trace import mutter
144
a_ancestors = find_present_ancestors(revision_a, revision_source)
145
b_ancestors = find_present_ancestors(revision_b, revision_source)
148
# a_order is used as a tie-breaker when two equally-good bases are found
149
for revision, (a_order, a_distance) in a_ancestors.iteritems():
150
if b_ancestors.has_key(revision):
151
a_intersection.append((a_distance, a_order, revision))
152
b_intersection.append((b_ancestors[revision][1], a_order, revision))
153
mutter("a intersection: %r" % a_intersection)
154
mutter("b intersection: %r" % b_intersection)
156
a_closest = __get_closest(a_intersection)
157
if len(a_closest) == 0:
159
b_closest = __get_closest(b_intersection)
160
assert len(b_closest) != 0
161
mutter ("a_closest %r" % a_closest)
162
mutter ("b_closest %r" % b_closest)
163
if a_closest[0] in b_closest:
165
elif b_closest[0] in a_closest:
227
def is_null(revision_id):
228
if revision_id is None:
229
symbol_versioning.warn('NULL_REVISION should be used for the null'
230
' revision instead of None, as of bzr 0.90.',
231
DeprecationWarning, stacklevel=2)
232
return revision_id in (None, NULL_REVISION)
168
raise bzrlib.errors.AmbiguousBase((a_closest[0], b_closest[0]))
171
def revision_graph(revision, revision_source):
172
"""Produce a graph of the ancestry of the specified revision.
173
Return root, ancestors map, descendants map
175
TODO: Produce graphs with the NULL revision as root, so that we can find
176
a common even when trees are not branches don't represent a single line
183
descendants[revision] = {}
184
while len(lines) > 0:
187
if line == NULL_REVISION:
192
rev = revision_source.get_revision(line)
193
parents = list(rev.parent_ids)
194
if len(parents) == 0:
195
parents = [NULL_REVISION]
196
except bzrlib.errors.NoSuchRevision:
200
if parents is not None:
201
for parent in parents:
202
if parent not in ancestors:
203
new_lines.add(parent)
204
if parent not in descendants:
205
descendants[parent] = {}
206
descendants[parent][line] = 1
207
if parents is not None:
208
ancestors[line] = set(parents)
210
assert root not in descendants[root]
211
assert root not in ancestors[root]
212
return root, ancestors, descendants
214
def combined_graph(revision_a, revision_b, revision_source):
215
"""Produce a combined ancestry graph.
216
Return graph root, ancestors map, descendants map, set of common nodes"""
217
root, ancestors, descendants = revision_graph(revision_a, revision_source)
218
root_b, ancestors_b, descendants_b = revision_graph(revision_b,
221
raise bzrlib.errors.NoCommonRoot(revision_a, revision_b)
223
for node, node_anc in ancestors_b.iteritems():
224
if node in ancestors:
227
ancestors[node] = set()
228
ancestors[node].update(node_anc)
229
for node, node_dec in descendants_b.iteritems():
230
if node not in descendants:
231
descendants[node] = {}
232
descendants[node].update(node_dec)
233
return root, ancestors, descendants, common
235
def common_ancestor(revision_a, revision_b, revision_source):
237
root, ancestors, descendants, common = \
238
combined_graph(revision_a, revision_b, revision_source)
239
except bzrlib.errors.NoCommonRoot:
240
raise bzrlib.errors.NoCommonAncestor(revision_a, revision_b)
242
distances = node_distances (descendants, ancestors, root)
243
farthest = select_farthest(distances, common)
244
if farthest is None or farthest == NULL_REVISION:
245
raise bzrlib.errors.NoCommonAncestor(revision_a, revision_b)
248
class MultipleRevisionSources(object):
249
"""Proxy that looks in multiple branches for revisions."""
250
def __init__(self, *args):
251
object.__init__(self)
252
assert len(args) != 0
253
self._revision_sources = args
255
def get_revision(self, revision_id):
256
for source in self._revision_sources:
258
return source.get_revision(revision_id)
259
except bzrlib.errors.NoSuchRevision, e:
263
def get_intervening_revisions(ancestor_id, rev_id, rev_source,
264
revision_history=None):
265
"""Find the longest line of descent from maybe_ancestor to revision.
266
Revision history is followed where possible.
268
If ancestor_id == rev_id, list will be empty.
269
Otherwise, rev_id will be the last entry. ancestor_id will never appear.
270
If ancestor_id is not an ancestor, NotAncestor will be thrown
272
root, ancestors, descendants = revision_graph(rev_id, rev_source)
273
if len(descendants) == 0:
274
raise NoSuchRevision(rev_source, rev_id)
275
if ancestor_id not in descendants:
276
rev_source.get_revision(ancestor_id)
277
raise bzrlib.errors.NotAncestor(rev_id, ancestor_id)
278
root_descendants = all_descendants(descendants, ancestor_id)
279
root_descendants.add(ancestor_id)
280
if rev_id not in root_descendants:
281
raise bzrlib.errors.NotAncestor(rev_id, ancestor_id)
282
distances = node_distances(descendants, ancestors, ancestor_id,
283
root_descendants=root_descendants)
285
def best_ancestor(rev_id):
287
for anc_id in ancestors[rev_id]:
289
distance = distances[anc_id]
292
if revision_history is not None and anc_id in revision_history:
294
elif best is None or distance > best[1]:
295
best = (anc_id, distance)
300
while next != ancestor_id:
302
next = best_ancestor(next)
added
removed
bzrlib/revision.py
