~bzr-pqm/bzr/bzr.dev

1185.33.86 by Martin Pool
Add additional module for lsprof.
1
# this is copied from the lsprof distro because somehow
2
# it is not installed by distutils
3
# I made one modification to profile so that it returns a pair
4
# instead of just the Stats object
5
2493.2.3 by Ian Clatworthy
changes requested in jameinel's review incorporated
6
import cPickle
7
import os
1185.33.86 by Martin Pool
Add additional module for lsprof.
8
import sys
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
9
import thread
10
import threading
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
11
from _lsprof import Profiler, profiler_entry
1185.33.86 by Martin Pool
Add additional module for lsprof.
12
13
__all__ = ['profile', 'Stats']
14
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
15
_g_threadmap = {}
16
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
17
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
18
def _thread_profile(f, *args, **kwds):
19
    # we lose the first profile point for a new thread in order to trampoline
20
    # a new Profile object into place
21
    global _g_threadmap
22
    thr = thread.get_ident()
23
    _g_threadmap[thr] = p = Profiler()
24
    # this overrides our sys.setprofile hook:
1706.2.7 by Robey Pointer
pull over some changes from the original lsprof
25
    p.enable(subcalls=True, builtins=True)
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
26
27
1185.33.86 by Martin Pool
Add additional module for lsprof.
28
def profile(f, *args, **kwds):
29
    """XXX docstring"""
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
30
    global _g_threadmap
1185.33.86 by Martin Pool
Add additional module for lsprof.
31
    p = Profiler()
32
    p.enable(subcalls=True)
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
33
    threading.setprofile(_thread_profile)
1185.33.86 by Martin Pool
Add additional module for lsprof.
34
    try:
35
        ret = f(*args, **kwds)
36
    finally:
37
        p.disable()
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
38
        for pp in _g_threadmap.values():
39
            pp.disable()
40
        threading.setprofile(None)
41
    
42
    threads = {}
43
    for tid, pp in _g_threadmap.items():
44
        threads[tid] = Stats(pp.getstats(), {})
45
    _g_threadmap = {}
46
    return ret, Stats(p.getstats(), threads)
1185.33.86 by Martin Pool
Add additional module for lsprof.
47
48
49
class Stats(object):
50
    """XXX docstring"""
51
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
52
    def __init__(self, data, threads):
1185.33.86 by Martin Pool
Add additional module for lsprof.
53
        self.data = data
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
54
        self.threads = threads
1185.33.86 by Martin Pool
Add additional module for lsprof.
55
56
    def sort(self, crit="inlinetime"):
57
        """XXX docstring"""
58
        if crit not in profiler_entry.__dict__:
59
            raise ValueError, "Can't sort by %s" % crit
60
        self.data.sort(lambda b, a: cmp(getattr(a, crit),
61
                                        getattr(b, crit)))
62
        for e in self.data:
63
            if e.calls:
64
                e.calls.sort(lambda b, a: cmp(getattr(a, crit),
65
                                              getattr(b, crit)))
66
67
    def pprint(self, top=None, file=None):
68
        """XXX docstring"""
69
        if file is None:
70
            file = sys.stdout
71
        d = self.data
72
        if top is not None:
73
            d = d[:top]
74
        cols = "% 12s %12s %11.4f %11.4f   %s\n"
75
        hcols = "% 12s %12s %12s %12s %s\n"
76
        cols2 = "+%12s %12s %11.4f %11.4f +  %s\n"
77
        file.write(hcols % ("CallCount", "Recursive", "Total(ms)",
78
                            "Inline(ms)", "module:lineno(function)"))
79
        for e in d:
80
            file.write(cols % (e.callcount, e.reccallcount, e.totaltime,
81
                               e.inlinetime, label(e.code)))
82
            if e.calls:
83
                for se in e.calls:
84
                    file.write(cols % ("+%s" % se.callcount, se.reccallcount,
85
                                       se.totaltime, se.inlinetime,
86
                                       "+%s" % label(se.code)))
87
88
    def freeze(self):
89
        """Replace all references to code objects with string
90
        descriptions; this makes it possible to pickle the instance."""
91
92
        # this code is probably rather ickier than it needs to be!
93
        for i in range(len(self.data)):
94
            e = self.data[i]
95
            if not isinstance(e.code, str):
96
                self.data[i] = type(e)((label(e.code),) + e[1:])
1706.2.7 by Robey Pointer
pull over some changes from the original lsprof
97
            if e.calls:
98
                for j in range(len(e.calls)):
99
                    se = e.calls[j]
100
                    if not isinstance(se.code, str):
101
                        e.calls[j] = type(se)((label(se.code),) + se[1:])
1553.7.2 by Robey Pointer
add threading support -- each thread created during an lsprof session gets its own profile object, and the Stats objects are attached to a 'threads' member of the final Stats object
102
        for s in self.threads.values():
103
            s.freeze()
104
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
105
    def calltree(self, file):
106
        """Output profiling data in calltree format (for KCacheGrind)."""
107
        _CallTreeFilter(self.data).output(file)
108
2493.2.3 by Ian Clatworthy
changes requested in jameinel's review incorporated
109
    def save(self, filename, format=None):
110
        """Save profiling data to a file.
111
112
        :param filename: the name of the output file
113
        :param format: 'txt' for a text representation;
114
            'callgrind' for calltree format;
115
            otherwise a pickled Python object. A format of None indicates
116
            that the format to use is to be found from the extension of
117
            filename.
118
        """
119
        if format is None:
120
            ext = os.path.splitext(filename)[1]
121
            if len(ext) > 1:
122
                format = ext[1:]
123
        outfile = open(filename, 'wb')
124
        try:
125
            if format == "callgrind":
126
                self.calltree(outfile)
127
            elif format == "txt":
128
                self.pprint(file=outfile)
129
            else:
130
                self.freeze()
131
                cPickle.dump(self, outfile, 2)
132
        finally:
133
            outfile.close()
134
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
135
136
class _CallTreeFilter(object):
2493.2.2 by Ian Clatworthy
Incorporate feedback from Robert Collins
137
    """Converter of a Stats object to input suitable for KCacheGrind.
138
139
    This code is taken from http://ddaa.net/blog/python/lsprof-calltree
140
    with the changes made by J.P. Calderone and Itamar applied. Note that
141
    isinstance(code, str) needs to be used at times to determine if the code 
142
    object is actually an external code object (with a filename, etc.) or
143
    a Python built-in.
144
    """
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
145
146
    def __init__(self, data):
147
        self.data = data
148
        self.out_file = None
149
150
    def output(self, out_file):
151
        self.out_file = out_file        
152
        print >> out_file, 'events: Ticks'
153
        self._print_summary()
154
        for entry in self.data:
155
            self._entry(entry)
156
157
    def _print_summary(self):
158
        max_cost = 0
159
        for entry in self.data:
160
            totaltime = int(entry.totaltime * 1000)
161
            max_cost = max(max_cost, totaltime)
162
        print >> self.out_file, 'summary: %d' % (max_cost,)
163
164
    def _entry(self, entry):
165
        out_file = self.out_file
166
        code = entry.code
167
        inlinetime = int(entry.inlinetime * 1000)
168
        #print >> out_file, 'ob=%s' % (code.co_filename,)
2493.2.1 by Ian Clatworthy
make profiling information easier to view and better documented
169
        if isinstance(code, str):
170
            print >> out_file, 'fi=~'
171
        else:
172
            print >> out_file, 'fi=%s' % (code.co_filename,)
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
173
        print >> out_file, 'fn=%s' % (label(code, True),)
2493.2.1 by Ian Clatworthy
make profiling information easier to view and better documented
174
        if isinstance(code, str):
175
            print >> out_file, '0 ', inlinetime
176
        else:
177
            print >> out_file, '%d %d' % (code.co_firstlineno, inlinetime)
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
178
        # recursive calls are counted in entry.calls
179
        if entry.calls:
180
            calls = entry.calls
181
        else:
182
            calls = []
2493.2.1 by Ian Clatworthy
make profiling information easier to view and better documented
183
        if isinstance(code, str):
184
            lineno = 0
185
        else:
186
            lineno = code.co_firstlineno
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
187
        for subentry in calls:
2493.2.1 by Ian Clatworthy
make profiling information easier to view and better documented
188
            self._subentry(lineno, subentry)
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
189
        print >> out_file
190
191
    def _subentry(self, lineno, subentry):
192
        out_file = self.out_file
193
        code = subentry.code
194
        totaltime = int(subentry.totaltime * 1000)
195
        #print >> out_file, 'cob=%s' % (code.co_filename,)
196
        print >> out_file, 'cfn=%s' % (label(code, True),)
2493.2.1 by Ian Clatworthy
make profiling information easier to view and better documented
197
        if isinstance(code, str):
198
            print >> out_file, 'cfi=~'
199
            print >> out_file, 'calls=%d 0' % (subentry.callcount,)
200
        else:
201
            print >> out_file, 'cfi=%s' % (code.co_filename,)
202
            print >> out_file, 'calls=%d %d' % (
203
                subentry.callcount, code.co_firstlineno)
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
204
        print >> out_file, '%d %d' % (lineno, totaltime)
205
1185.33.86 by Martin Pool
Add additional module for lsprof.
206
_fn2mod = {}
207
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
208
def label(code, calltree=False):
1185.33.86 by Martin Pool
Add additional module for lsprof.
209
    if isinstance(code, str):
210
        return code
211
    try:
212
        mname = _fn2mod[code.co_filename]
213
    except KeyError:
1711.2.124 by John Arbash Meinel
Use sys.modules.items() to prevent running into site.py problems
214
        for k, v in sys.modules.items():
1185.33.86 by Martin Pool
Add additional module for lsprof.
215
            if v is None:
216
                continue
1963.2.6 by Robey Pointer
pychecker is on crack; go back to using 'is None'.
217
            if getattr(v, '__file__', None) is None:
1185.33.86 by Martin Pool
Add additional module for lsprof.
218
                continue
219
            if not isinstance(v.__file__, str):
220
                continue
221
            if v.__file__.startswith(code.co_filename):
222
                mname = _fn2mod[code.co_filename] = k
223
                break
224
        else:
225
            mname = _fn2mod[code.co_filename] = '<%s>'%code.co_filename
1553.7.3 by Robey Pointer
patch from ddaa to add kcachegrind output-format support to lsprof
226
    if calltree:
227
        return '%s %s:%d' % (code.co_name, mname, code.co_firstlineno)
228
    else:
229
        return '%s:%d(%s)' % (mname, code.co_firstlineno, code.co_name)
1185.33.86 by Martin Pool
Add additional module for lsprof.
230
231
232
if __name__ == '__main__':
233
    import os
234
    sys.argv = sys.argv[1:]
235
    if not sys.argv:
236
        print >> sys.stderr, "usage: lsprof.py <script> <arguments...>"
237
        sys.exit(2)
238
    sys.path.insert(0, os.path.abspath(os.path.dirname(sys.argv[0])))
239
    stats = profile(execfile, sys.argv[0], globals(), locals())
240
    stats.sort()
241
    stats.pprint()