~abentley/bzrtools/bzrtools.dev

257.1.2 by Aaron Bentley
Updated GPL notices
1
# Copyright (C) 2004, 2005 Aaron Bentley
612 by Aaron Bentley
Update email address
2
# <aaron@aaronbentley.com>
257.1.2 by Aaron Bentley
Updated GPL notices
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
125 by Aaron Bentley
Added pastegraph
18
from subprocess import Popen, PIPE
19
import os.path
139 by Aaron Bentley
Tweaked missing-dot handling
20
import errno
143 by Aaron Bentley
Used rsvga for nice antialiasing
21
import tempfile
22
import shutil
139 by Aaron Bentley
Tweaked missing-dot handling
23
167 by Aaron Bentley
Moved extention lists to dotgraph
24
RSVG_OUTPUT_TYPES = ('png', 'jpg')
531.2.2 by Charlie Shepherd
Remove all trailing whitespace
25
DOT_OUTPUT_TYPES = ('svg', 'svgz', 'gif', 'jpg', 'ps', 'fig', 'mif', 'png',
189 by Aaron Bentley
Enabled client-side imagemaps
26
                    'cmapx')
140 by Aaron Bentley
Mapped some email addresses to names
27
139 by Aaron Bentley
Tweaked missing-dot handling
28
class NoDot(Exception):
29
    def __init__(self):
30
        Exception.__init__(self, "Can't find dot!")
125 by Aaron Bentley
Added pastegraph
31
143 by Aaron Bentley
Used rsvga for nice antialiasing
32
class NoRsvg(Exception):
33
    def __init__(self):
34
        Exception.__init__(self, "Can't find rsvg!")
35
125 by Aaron Bentley
Added pastegraph
36
class Node(object):
142 by Aaron Bentley
Clustered the branch revision history
37
    def __init__(self, name, color=None, label=None, rev_id=None,
189.1.1 by John Arbash Meinel
Adding an html target.
38
                 cluster=None, node_style=None, date=None, message=None):
125 by Aaron Bentley
Added pastegraph
39
        self.name = name
40
        self.color = color
128 by Aaron Bentley
Got initial graphing functionality working
41
        self.label = label
130 by Aaron Bentley
Added committer to revisions
42
        self.committer = None
137 by Aaron Bentley
Put dotted outlines on missing revisions
43
        self.rev_id = rev_id
172 by Aaron Bentley
Marked missing nodes
44
        if node_style is None:
45
            self.node_style = []
142 by Aaron Bentley
Clustered the branch revision history
46
        self.cluster = cluster
178 by Aaron Bentley
Switched from clusters to forced ranking
47
        self.rank = None
189.1.1 by John Arbash Meinel
Adding an html target.
48
        self.date = date
49
        self.message = message
189 by Aaron Bentley
Enabled client-side imagemaps
50
        self.href = None
135 by Aaron Bentley
Enhanced revision-crediting
51
125 by Aaron Bentley
Added pastegraph
52
    def define(self):
137 by Aaron Bentley
Put dotted outlines on missing revisions
53
        attributes = []
130 by Aaron Bentley
Added committer to revisions
54
        style = []
125 by Aaron Bentley
Added pastegraph
55
        if self.color is not None:
137 by Aaron Bentley
Put dotted outlines on missing revisions
56
            attributes.append('fillcolor="%s"' % self.color)
57
            style.append('filled')
58
        style.extend(self.node_style)
59
        if len(style) > 0:
60
            attributes.append('style="%s"' % ",".join(style))
157 by Aaron Bentley
Got graph showing merge selection decently
61
        label = self.label
135 by Aaron Bentley
Enhanced revision-crediting
62
        if label is not None:
137 by Aaron Bentley
Put dotted outlines on missing revisions
63
            attributes.append('label="%s"' % label)
141 by Aaron Bentley
Switched to use boxes
64
        attributes.append('shape="box"')
189.1.1 by John Arbash Meinel
Adding an html target.
65
        tooltip = ''
66
        if self.message is not None:
67
            tooltip += self.message.replace('"', '\\"')
68
        if tooltip:
69
            attributes.append('tooltip="%s"' % tooltip)
189 by Aaron Bentley
Enabled client-side imagemaps
70
        if self.href is not None:
71
            attributes.append('href="%s"' % self.href)
189.1.1 by John Arbash Meinel
Adding an html target.
72
        elif tooltip:
73
            attributes.append('href="#"')
137 by Aaron Bentley
Put dotted outlines on missing revisions
74
        if len(attributes) > 0:
75
            return '%s[%s]' % (self.name, " ".join(attributes))
125 by Aaron Bentley
Added pastegraph
76
77
    def __str__(self):
78
        return self.name
79
175 by Aaron Bentley
Added edges
80
class Edge(object):
81
    def __init__(self, start, end, label=None):
82
        object.__init__(self)
83
        self.start = start
84
        self.end = end
85
        self.label = label
86
178 by Aaron Bentley
Switched from clusters to forced ranking
87
    def dot(self, do_weight=False):
175 by Aaron Bentley
Added edges
88
        attributes = []
89
        if self.label is not None:
90
            attributes.append(('label', self.label))
178 by Aaron Bentley
Switched from clusters to forced ranking
91
        if do_weight:
182 by Aaron Bentley
Set edge weight to 1 for missing revisions
92
            weight = '0'
178 by Aaron Bentley
Switched from clusters to forced ranking
93
            if self.start.cluster == self.end.cluster:
182 by Aaron Bentley
Set edge weight to 1 for missing revisions
94
                weight = '1'
95
            elif self.start.rank is None:
96
                weight = '1'
97
            elif self.end.rank is None:
98
                weight = '1'
99
            attributes.append(('weight', weight))
175 by Aaron Bentley
Added edges
100
        if len(attributes) > 0:
101
            atlist = []
102
            for key, value in attributes:
103
                atlist.append("%s=\"%s\"" % (key, value))
104
            pq = ' '.join(atlist)
105
            op = "[%s]" % pq
106
        else:
107
            op = ""
108
        return "%s->%s%s;" % (self.start.name, self.end.name, op)
109
110
def make_edge(relation):
176 by Aaron Bentley
Added skip labels to edges
111
    if hasattr(relation, 'start') and hasattr(relation, 'end'):
112
        return relation
175 by Aaron Bentley
Added edges
113
    return Edge(relation[0], relation[1])
114
178 by Aaron Bentley
Switched from clusters to forced ranking
115
def dot_output(relations, ranking="forced"):
116
    defined = {}
125 by Aaron Bentley
Added pastegraph
117
    yield "digraph G\n"
118
    yield "{\n"
142 by Aaron Bentley
Clustered the branch revision history
119
    clusters = set()
175 by Aaron Bentley
Added edges
120
    edges = [make_edge(f) for f in relations]
142 by Aaron Bentley
Clustered the branch revision history
121
    def rel_appropriate(start, end, cluster):
122
        if cluster is None:
169 by Aaron Bentley
Got ancestry-graph showing common and revision-history nodes properly
123
            return (start.cluster is None and end.cluster is None) or \
124
                start.cluster != end.cluster
142 by Aaron Bentley
Clustered the branch revision history
125
        else:
126
            return start.cluster==cluster and end.cluster==cluster
127
175 by Aaron Bentley
Added edges
128
    for edge in edges:
129
        if edge.start.cluster is not None:
130
            clusters.add(edge.start.cluster)
131
        if edge.end.cluster is not None:
132
            clusters.add(edge.end.cluster)
142 by Aaron Bentley
Clustered the branch revision history
133
    clusters = list(clusters)
134
    clusters.append(None)
135
    for index, cluster in enumerate(clusters):
178 by Aaron Bentley
Switched from clusters to forced ranking
136
        if cluster is not None and ranking == "cluster":
142 by Aaron Bentley
Clustered the branch revision history
137
            yield "subgraph cluster_%s\n" % index
138
            yield "{\n"
139
            yield '    label="%s"\n' % cluster
175 by Aaron Bentley
Added edges
140
        for edge in edges:
141
            if edge.start.name not in defined and edge.start.cluster == cluster:
178 by Aaron Bentley
Switched from clusters to forced ranking
142
                defined[edge.start.name] = edge.start
175 by Aaron Bentley
Added edges
143
                my_def = edge.start.define()
144
                if my_def is not None:
145
                    yield "    %s\n" % my_def
146
            if edge.end.name not in defined and edge.end.cluster == cluster:
178 by Aaron Bentley
Switched from clusters to forced ranking
147
                defined[edge.end.name] = edge.end
175 by Aaron Bentley
Added edges
148
                my_def = edge.end.define()
149
                if my_def is not None:
150
                    yield "    %s;\n" % my_def
151
            if rel_appropriate(edge.start, edge.end, cluster):
178 by Aaron Bentley
Switched from clusters to forced ranking
152
                yield "    %s\n" % edge.dot(do_weight=ranking=="forced")
153
        if cluster is not None and ranking == "cluster":
142 by Aaron Bentley
Clustered the branch revision history
154
            yield "}\n"
178 by Aaron Bentley
Switched from clusters to forced ranking
155
156
    if ranking == "forced":
157
        ranks = {}
158
        for node in defined.itervalues():
159
            if node.rank not in ranks:
160
                ranks[node.rank] = set()
161
            ranks[node.rank].add(node.name)
162
        sorted_ranks = [n for n in ranks.iteritems()]
163
        sorted_ranks.sort()
164
        last_rank = None
165
        for rank, nodes in sorted_ranks:
166
            if rank is None:
167
                continue
168
            yield 'rank%d[style="invis"];\n' % rank
169
            if last_rank is not None:
170
                yield 'rank%d -> rank%d[style="invis"];\n' % (last_rank, rank)
171
            last_rank = rank
172
        for rank, nodes in ranks.iteritems():
173
            if rank is None:
174
                continue
175
            node_text = "; ".join('"%s"' % n for n in nodes)
176
            yield ' {rank = same; "rank%d"; %s}\n' % (rank, node_text)
125 by Aaron Bentley
Added pastegraph
177
    yield "}\n"
178
143 by Aaron Bentley
Used rsvga for nice antialiasing
179
def invoke_dot_aa(input, out_file, file_type='png'):
180
    """\
181
    Produce antialiased Dot output, invoking rsvg on an intermediate file.
182
    rsvg only supports png, jpeg and .ico files."""
183
    tempdir = tempfile.mkdtemp()
184
    try:
185
        temp_file = os.path.join(tempdir, 'temp.svg')
186
        invoke_dot(input, temp_file, 'svg')
187
        cmdline = ['rsvg', temp_file, out_file]
188
        try:
189
            rsvg_proc = Popen(cmdline)
190
        except OSError, e:
191
            if e.errno == errno.ENOENT:
192
                raise NoRsvg()
193
        status = rsvg_proc.wait()
194
    finally:
195
        shutil.rmtree(tempdir)
196
    return status
197
531.2.2 by Charlie Shepherd
Remove all trailing whitespace
198
def invoke_dot(input, out_file=None, file_type='svg', antialias=None,
179 by Aaron Bentley
Enforced a font and size
199
               fontname="Helvetica", fontsize=11):
531.2.2 by Charlie Shepherd
Remove all trailing whitespace
200
    cmdline = ['dot', '-T%s' % file_type, '-Nfontname=%s' % fontname,
179 by Aaron Bentley
Enforced a font and size
201
               '-Efontname=%s' % fontname, '-Nfontsize=%d' % fontsize,
202
               '-Efontsize=%d' % fontsize]
125 by Aaron Bentley
Added pastegraph
203
    if out_file is not None:
204
        cmdline.extend(('-o', out_file))
138 by Aaron Bentley
Handle systems without dot (the horror!). From Magnus Therning.
205
    try:
206
        dot_proc = Popen(cmdline, stdin=PIPE)
207
    except OSError, e:
139 by Aaron Bentley
Tweaked missing-dot handling
208
        if e.errno == errno.ENOENT:
209
            raise NoDot()
210
        else:
211
            raise
125 by Aaron Bentley
Added pastegraph
212
    for line in input:
312 by Aaron Bentley
forced ancestry graph to use utf-8 Dot output
213
        dot_proc.stdin.write(line.encode('utf-8'))
125 by Aaron Bentley
Added pastegraph
214
    dot_proc.stdin.close()
215
    return dot_proc.wait()
189.1.1 by John Arbash Meinel
Adding an html target.
216
217
def invoke_dot_html(input, out_file):
218
    """\
219
    Produce an html file, which uses a .png file, and a cmap to provide
220
    annotated revisions.
221
    """
222
    tempdir = tempfile.mkdtemp()
223
    try:
224
        temp_dot = os.path.join(tempdir, 'temp.dot')
189.1.2 by John Arbash Meinel
Fix datestamp, reuse pre-layed out dot file.
225
        status = invoke_dot(input, temp_dot, file_type='dot')
226
189.1.1 by John Arbash Meinel
Adding an html target.
227
        dot = open(temp_dot)
228
        temp_file = os.path.join(tempdir, 'temp.cmapx')
229
        status = invoke_dot(dot, temp_file, 'cmapx')
230
231
        png_file = '.'.join(out_file.split('.')[:-1] + ['png'])
232
        dot.seek(0)
233
        status = invoke_dot(dot, png_file, 'png')
234
235
        png_relative = png_file.split('/')[-1]
236
        html = open(out_file, 'wb')
237
        w = html.write
238
        w('<html><head><title></title></head>\n')
239
        w('<body>\n')
240
        w('<img src="%s" usemap="#G" border=0/>' % png_relative)
241
        w(open(temp_file).read())
242
        w('</body></html>\n')
243
    finally:
244
        shutil.rmtree(tempdir)
245
    return status
246