~abentley/bzrtools/bzrtools.dev

« back to all changes in this revision

Viewing changes to graph.py

  • Committer: Aaron Bentley
  • Date: 2005-06-08 19:00:33 UTC
  • Revision ID: abentley@panoramicfeedback.com-20050608190033-daa1703096158164
grammar

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005 Aaron Bentley
2
 
# <aaron.bentley@utoronto.ca>
3
 
#
4
 
#    This program is free software; you can redistribute it and/or modify
5
 
#    it under the terms of the GNU General Public License as published by
6
 
#    the Free Software Foundation; either version 2 of the License, or
7
 
#    (at your option) any later version.
8
 
#
9
 
#    This program is distributed in the hope that it will be useful,
10
 
#    but WITHOUT ANY WARRANTY; without even the implied warranty of
11
 
#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12
 
#    GNU General Public License for more details.
13
 
#
14
 
#    You should have received a copy of the GNU General Public License
15
 
#    along with this program; if not, write to the Free Software
16
 
#    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17
 
from bzrtools import short_committer
18
 
from dotgraph import Node, dot_output, invoke_dot, invoke_dot_aa, NoDot, NoRsvg
19
 
from dotgraph import RSVG_OUTPUT_TYPES, DOT_OUTPUT_TYPES, Edge, invoke_dot_html
20
 
from bzrlib.branch import Branch
21
 
from bzrlib.errors import BzrCommandError, NoCommonRoot, NoSuchRevision
22
 
from bzrlib.graph import node_distances, select_farthest
23
 
from bzrlib.revision import combined_graph, revision_graph
24
 
from bzrlib.revision import MultipleRevisionSources
25
 
import bzrlib.errors
26
 
import re
27
 
import os.path
28
 
import time
29
 
 
30
 
mail_map = {'aaron.bentley@utoronto.ca'     : 'Aaron Bentley',
31
 
            'abentley@panoramicfeedback.com': 'Aaron Bentley',
32
 
            'abentley@lappy'                : 'Aaron Bentley',
33
 
            'john@arbash-meinel.com'        : 'John Arbash Meinel',
34
 
            'mbp@sourcefrog.net'            : 'Martin Pool',
35
 
            'robertc@robertcollins.net'     : 'Robert Collins',
36
 
            }
37
 
 
38
 
committer_alias = {'abentley': 'Aaron Bentley'}
39
 
def can_skip(rev_id, descendants, ancestors):
40
 
    if rev_id not in descendants:
41
 
        return False
42
 
    elif rev_id not in ancestors:
43
 
        return False
44
 
    elif len(ancestors[rev_id]) != 1:
45
 
        return False
46
 
    elif len(descendants[list(ancestors[rev_id])[0]]) != 1:
47
 
        return False
48
 
    elif len(descendants[rev_id]) != 1:
49
 
        return False
50
 
    else:
51
 
        return True
52
 
 
53
 
def compact_ancestors(descendants, ancestors, exceptions=()):
54
 
    new_ancestors={}
55
 
    skip = set()
56
 
    for me, my_parents in ancestors.iteritems():
57
 
        if me in skip:
58
 
            continue
59
 
        new_ancestors[me] = {} 
60
 
        for parent in my_parents:
61
 
            new_parent = parent 
62
 
            distance = 0
63
 
            while can_skip(new_parent, descendants, ancestors):
64
 
                if new_parent in exceptions:
65
 
                    break
66
 
                skip.add(new_parent)
67
 
                if new_parent in new_ancestors:
68
 
                    del new_ancestors[new_parent]
69
 
                new_parent = list(ancestors[new_parent])[0]
70
 
                distance += 1
71
 
            new_ancestors[me][new_parent] = distance
72
 
    return new_ancestors    
73
 
 
74
 
def get_rev_info(rev_id, source):
75
 
    """Return the committer, message, and date of a revision."""
76
 
    committer = None
77
 
    message = None
78
 
    date = None
79
 
    if rev_id == 'null:':
80
 
        return None, 'Null Revision', None
81
 
    try:
82
 
        rev = source.get_revision(rev_id)
83
 
    except NoSuchRevision:
84
 
        try:
85
 
            committer = '-'.join(rev_id.split('-')[:-2]).strip(' ')
86
 
            if committer == '':
87
 
                return None, None, None
88
 
        except ValueError:
89
 
            return None, None, None
90
 
    else:
91
 
        committer = short_committer(rev.committer)
92
 
        if rev.message is not None:
93
 
            message = rev.message.split('\n')[0]
94
 
        gmtime = time.gmtime(rev.timestamp + (rev.timezone or 0))
95
 
        date = time.strftime('%Y/%m/%d', gmtime)
96
 
    if '@' in committer:
97
 
        try:
98
 
            committer = mail_map[committer]
99
 
        except KeyError:
100
 
            pass
101
 
    try:
102
 
        committer = committer_alias[committer]
103
 
    except KeyError:
104
 
        pass
105
 
    return committer, message, date
106
 
 
107
 
class Grapher(object):
108
 
    def __init__(self, branch, other_branch=None):
109
 
        object.__init__(self)
110
 
        self.branch = branch
111
 
        self.other_branch = other_branch
112
 
        revision_a = self.branch.last_revision()
113
 
        if other_branch is not None:
114
 
            branch.fetch(other_branch)
115
 
            revision_b = self.other_branch.last_revision()
116
 
            try:
117
 
                self.root, self.ancestors, self.descendants, self.common = \
118
 
                    combined_graph(revision_a, revision_b,
119
 
                                   self.branch.repository)
120
 
            except bzrlib.errors.NoCommonRoot:
121
 
                raise bzrlib.errors.NoCommonAncestor(revision_a, revision_b)
122
 
        else:
123
 
            self.root, self.ancestors, self.descendants = \
124
 
                revision_graph(revision_a, branch.repository)
125
 
            self.common = []
126
 
 
127
 
        self.n_history = branch.revision_history()
128
 
        self.distances = node_distances(self.descendants, self.ancestors, 
129
 
                                        self.root)
130
 
        if other_branch is not None:
131
 
            self.base = select_farthest(self.distances, self.common)
132
 
            self.m_history = other_branch.revision_history() 
133
 
        else:
134
 
            self.base = None
135
 
            self.m_history = []
136
 
 
137
 
    def dot_node(self, node, num):
138
 
        try:
139
 
            n_rev = self.n_history.index(node) + 1
140
 
        except ValueError:
141
 
            n_rev = None
142
 
        try:
143
 
            m_rev = self.m_history.index(node) + 1
144
 
        except ValueError:
145
 
            m_rev = None
146
 
        if (n_rev, m_rev) == (None, None):
147
 
            name = node[-5:]
148
 
            cluster = None
149
 
        elif n_rev == m_rev:
150
 
            name = "rR%d" % n_rev
151
 
        else:
152
 
            namelist = []
153
 
            for prefix, revno in (('r', n_rev), ('R', m_rev)):
154
 
                if revno is not None:
155
 
                    namelist.append("%s%d" % (prefix, revno))
156
 
            name = ' '.join(namelist)
157
 
        if None not in (n_rev, m_rev):
158
 
            cluster = "common_history"
159
 
            color = "#ff9900"
160
 
        elif (None, None) == (n_rev, m_rev):
161
 
            cluster = None
162
 
            if node in self.common:
163
 
                color = "#6699ff"
164
 
            else:
165
 
                color = "white"
166
 
        elif n_rev is not None:
167
 
            cluster = "my_history"
168
 
            color = "#ffff00"
169
 
        else:
170
 
            assert m_rev is not None
171
 
            cluster = "other_history"
172
 
            color = "#ff0000"
173
 
        if node == self.base:
174
 
            color = "#33ff99"
175
 
 
176
 
        label = [name]
177
 
        committer, message, date = get_rev_info(node, self.branch.repository)
178
 
        if committer is not None:
179
 
            label.append(committer)
180
 
 
181
 
        if date is not None:
182
 
            label.append(date)
183
 
 
184
 
        if node in self.distances:
185
 
            rank = self.distances[node]
186
 
            label.append('d%d' % self.distances[node])
187
 
        else:
188
 
            rank = None
189
 
 
190
 
        d_node = Node("n%d" % num, color=color, label="\\n".join(label), 
191
 
                    rev_id=node, cluster=cluster, message=message,
192
 
                    date=date)
193
 
        d_node.rank = rank
194
 
 
195
 
        if node not in self.ancestors:
196
 
            d_node.node_style.append('dotted')
197
 
 
198
 
        return d_node
199
 
        
200
 
    def get_relations(self, collapse=False):
201
 
        dot_nodes = {}
202
 
        node_relations = []
203
 
        num = 0
204
 
        if collapse:
205
 
            visible_ancestors = compact_ancestors(self.descendants, 
206
 
                                                  self.ancestors, (self.base,))
207
 
        else:
208
 
            visible_ancestors = self.ancestors
209
 
        for node, parents in visible_ancestors.iteritems():
210
 
            if node not in dot_nodes:
211
 
                dot_nodes[node] = self.dot_node(node, num)
212
 
                num += 1
213
 
            if visible_ancestors is self.ancestors:
214
 
                parent_iter = ((f, 0) for f in parents)
215
 
            else:
216
 
                parent_iter = (f for f in parents.iteritems())
217
 
            for parent, skipped in parent_iter:
218
 
                if parent not in dot_nodes:
219
 
                    dot_nodes[parent] = self.dot_node(parent, num)
220
 
                    num += 1
221
 
                edge = Edge(dot_nodes[parent], dot_nodes[node])
222
 
                if skipped != 0:
223
 
                    edge.label = "%d" % skipped
224
 
                node_relations.append(edge)
225
 
        return node_relations
226
 
 
227
 
 
228
 
def write_ancestry_file(branch, filename, collapse=True, antialias=True,
229
 
                        merge_branch=None, ranking="forced"):
230
 
    b = Branch.open_containing(branch)[0]
231
 
    if merge_branch is not None:
232
 
        m = Branch.open_containing(merge_branch)[0]
233
 
    else:
234
 
        m = None
235
 
    b.lock_write()
236
 
    try:
237
 
        if m is not None:
238
 
            m.lock_read()
239
 
        try:
240
 
            grapher = Grapher(b, m)
241
 
            relations = grapher.get_relations(collapse)
242
 
        finally:
243
 
            if m is not None:
244
 
                m.unlock()
245
 
    finally:
246
 
        b.unlock()
247
 
 
248
 
    ext = filename.split('.')[-1]
249
 
    output = dot_output(relations, ranking)
250
 
    done = False
251
 
    if ext not in RSVG_OUTPUT_TYPES:
252
 
        antialias = False
253
 
    if antialias: 
254
 
        output = list(output)
255
 
        try:
256
 
            invoke_dot_aa(output, filename, ext)
257
 
            done = True
258
 
        except NoDot, e:
259
 
            raise BzrCommandError("Can't find 'dot'.  Please ensure Graphviz"\
260
 
                " is installed correctly.")
261
 
        except NoRsvg, e:
262
 
            print "Not antialiasing because rsvg (from librsvg-bin) is not"\
263
 
                " installed."
264
 
            antialias = False
265
 
    if ext in DOT_OUTPUT_TYPES and not antialias and not done:
266
 
        try:
267
 
            invoke_dot(output, filename, ext)
268
 
            done = True
269
 
        except NoDot, e:
270
 
            raise BzrCommandError("Can't find 'dot'.  Please ensure Graphviz"\
271
 
                " is installed correctly, or use --noantialias")
272
 
    elif ext == 'dot' and not done:
273
 
        my_file = file(filename, 'wb')
274
 
        for fragment in output:
275
 
            my_file.write(fragment.encode('utf-8'))
276
 
    elif ext == 'html':
277
 
        try:
278
 
            invoke_dot_html(output, filename)
279
 
        except NoDot, e:
280
 
            raise BzrCommandError("Can't find 'dot'.  Please ensure Graphviz"\
281
 
                " is installed correctly, or use --noantialias")
282
 
    elif not done:
283
 
        print "Unknown file extension: %s" % ext
284