1
# Copyright (C) 2005, 2008 Canonical Ltd
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.
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.
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
18
def max_distance(node, ancestors, distances, root_descendants):
19
"""Calculate the max distance to an ancestor.
2
def max_distance(node, ancestors, distances):
3
"""Calculate the max distance to an ancestor.
20
4
Return None if not all possible ancestors have known distances"""
22
6
if node in distances:
23
7
best = distances[node]
24
8
for ancestor in ancestors[node]:
25
# skip ancestors we will never traverse:
26
if root_descendants is not None and ancestor not in root_descendants:
28
9
# An ancestor which is not listed in ancestors will never be in
29
10
# distances, so we pretend it never existed.
30
11
if ancestor not in ancestors:
32
13
if ancestor not in distances:
34
if best is None or distances[ancestor]+1 > best:
15
if best is None or distances[ancestor] > best:
35
16
best = distances[ancestor] + 1
39
def node_distances(graph, ancestors, start, root_descendants=None):
20
def farthest_nodes(graph, ancestors, start):
40
21
"""Produce a list of nodes, sorted by distance from a start node.
41
22
This is an algorithm devised by Aaron Bentley, because applying Dijkstra
42
23
backwards seemed too complicated.
56
37
while len(lines) > 0:
59
line_descendants = graph[line]
60
for descendant in line_descendants:
61
distance = max_distance(descendant, ancestors, distances,
40
assert line not in graph[line], "%s refers to itself" % line
41
for descendant in graph[line]:
42
distance = max_distance(descendant, ancestors, distances)
63
43
if distance is None:
65
45
distances[descendant] = distance
66
46
new_lines.add(descendant)
70
def nodes_by_distance(distances):
71
"""Return a list of nodes sorted by distance"""
72
49
def by_distance(n):
73
50
return distances[n],n
75
51
node_list = distances.keys()
76
52
node_list.sort(key=by_distance, reverse=True)
79
def select_farthest(distances, common):
80
"""Return the farthest common node, or None if no node qualifies."""
81
node_list = nodes_by_distance(distances)
82
for node in node_list:
86
def all_descendants(descendants, start):
87
"""Produce a set of all descendants of the start node.
88
The input is a map of node->list of descendants for a graph encompassing
96
if line not in descendants:
98
for descendant in descendants[line]:
99
if descendant in result:
101
result.add(descendant)
102
new_lines.add(descendant)
108
"""A graph object which can memoise and cache results for performance."""
111
super(Graph, self).__init__()
113
self.ghosts = set([])
114
self._graph_ancestors = {}
115
self._graph_descendants = {}
117
def add_ghost(self, node_id):
118
"""Add a ghost to the graph."""
119
self.ghosts.add(node_id)
120
self._ensure_descendant(node_id)
122
def add_node(self, node_id, parent_ids):
123
"""Add node_id to the graph with parent_ids as its parents."""
124
if len(parent_ids) == 0:
125
self.roots.add(node_id)
126
self._graph_ancestors[node_id] = list(parent_ids)
127
self._ensure_descendant(node_id)
128
for parent in parent_ids:
129
self._ensure_descendant(parent)
130
self._graph_descendants[parent][node_id] = 1
132
def _ensure_descendant(self, node_id):
133
"""Ensure that a descendant lookup for node_id will work."""
134
if not node_id in self._graph_descendants:
135
self._graph_descendants[node_id] = {}
137
def get_ancestors(self):
138
"""Return a dictionary of graph node:ancestor_list entries."""
139
return dict(self._graph_ancestors.items())
141
def get_ancestry(self, node_id, topo_sorted=True):
142
"""Return the inclusive ancestors of node_id in topological order."""
143
# maybe optimise this ?
144
from bzrlib.tsort import topo_sort
146
pending = set([node_id])
148
current = pending.pop()
149
parents = self._graph_ancestors[current]
150
parents = [parent for parent in parents if parent not in self.ghosts]
151
result[current] = parents
152
for parent in parents:
153
if parent not in result and parent not in pending:
157
return topo_sort(result.items())
159
def get_descendants(self):
160
"""Return a dictionary of graph node:child_node:distance entries."""
161
return dict(self._graph_descendants.items())