| 1 | #!/usr/bin/env python
|
|---|
| 2 |
|
|---|
| 3 | # portions copyright 2001, Autonomous Zones Industries, Inc., all rights...
|
|---|
| 4 | # err... reserved and offered to the public under the terms of the
|
|---|
| 5 | # Python 2.2 license.
|
|---|
| 6 | # Author: Zooko O'Whielacronx
|
|---|
| 7 | # http://zooko.com/
|
|---|
| 8 | # mailto:[email protected]
|
|---|
| 9 | #
|
|---|
| 10 | # Copyright 2000, Mojam Media, Inc., all rights reserved.
|
|---|
| 11 | # Author: Skip Montanaro
|
|---|
| 12 | #
|
|---|
| 13 | # Copyright 1999, Bioreason, Inc., all rights reserved.
|
|---|
| 14 | # Author: Andrew Dalke
|
|---|
| 15 | #
|
|---|
| 16 | # Copyright 1995-1997, Automatrix, Inc., all rights reserved.
|
|---|
| 17 | # Author: Skip Montanaro
|
|---|
| 18 | #
|
|---|
| 19 | # Copyright 1991-1995, Stichting Mathematisch Centrum, all rights reserved.
|
|---|
| 20 | #
|
|---|
| 21 | #
|
|---|
| 22 | # Permission to use, copy, modify, and distribute this Python software and
|
|---|
| 23 | # its associated documentation for any purpose without fee is hereby
|
|---|
| 24 | # granted, provided that the above copyright notice appears in all copies,
|
|---|
| 25 | # and that both that copyright notice and this permission notice appear in
|
|---|
| 26 | # supporting documentation, and that the name of neither Automatrix,
|
|---|
| 27 | # Bioreason or Mojam Media be used in advertising or publicity pertaining to
|
|---|
| 28 | # distribution of the software without specific, written prior permission.
|
|---|
| 29 | #
|
|---|
| 30 | """program/module to trace Python program or function execution
|
|---|
| 31 |
|
|---|
| 32 | Sample use, command line:
|
|---|
| 33 | trace.py -c -f counts --ignore-dir '$prefix' spam.py eggs
|
|---|
| 34 | trace.py -t --ignore-dir '$prefix' spam.py eggs
|
|---|
| 35 | trace.py --trackcalls spam.py eggs
|
|---|
| 36 |
|
|---|
| 37 | Sample use, programmatically
|
|---|
| 38 | import sys
|
|---|
| 39 |
|
|---|
| 40 | # create a Trace object, telling it what to ignore, and whether to
|
|---|
| 41 | # do tracing or line-counting or both.
|
|---|
| 42 | tracer = trace.Trace(ignoredirs=[sys.prefix, sys.exec_prefix,], trace=0,
|
|---|
| 43 | count=1)
|
|---|
| 44 | # run the new command using the given tracer
|
|---|
| 45 | tracer.run('main()')
|
|---|
| 46 | # make a report, placing output in /tmp
|
|---|
| 47 | r = tracer.results()
|
|---|
| 48 | r.write_results(show_missing=True, coverdir="/tmp")
|
|---|
| 49 | """
|
|---|
| 50 |
|
|---|
| 51 | import linecache
|
|---|
| 52 | import os
|
|---|
| 53 | import re
|
|---|
| 54 | import sys
|
|---|
| 55 | import threading
|
|---|
| 56 | import token
|
|---|
| 57 | import tokenize
|
|---|
| 58 | import types
|
|---|
| 59 | import gc
|
|---|
| 60 |
|
|---|
| 61 | try:
|
|---|
| 62 | import cPickle
|
|---|
| 63 | pickle = cPickle
|
|---|
| 64 | except ImportError:
|
|---|
| 65 | import pickle
|
|---|
| 66 |
|
|---|
| 67 | def usage(outfile):
|
|---|
| 68 | outfile.write("""Usage: %s [OPTIONS] <file> [ARGS]
|
|---|
| 69 |
|
|---|
| 70 | Meta-options:
|
|---|
| 71 | --help Display this help then exit.
|
|---|
| 72 | --version Output version information then exit.
|
|---|
| 73 |
|
|---|
| 74 | Otherwise, exactly one of the following three options must be given:
|
|---|
| 75 | -t, --trace Print each line to sys.stdout before it is executed.
|
|---|
| 76 | -c, --count Count the number of times each line is executed
|
|---|
| 77 | and write the counts to <module>.cover for each
|
|---|
| 78 | module executed, in the module's directory.
|
|---|
| 79 | See also `--coverdir', `--file', `--no-report' below.
|
|---|
| 80 | -l, --listfuncs Keep track of which functions are executed at least
|
|---|
| 81 | once and write the results to sys.stdout after the
|
|---|
| 82 | program exits.
|
|---|
| 83 | -T, --trackcalls Keep track of caller/called pairs and write the
|
|---|
| 84 | results to sys.stdout after the program exits.
|
|---|
| 85 | -r, --report Generate a report from a counts file; do not execute
|
|---|
| 86 | any code. `--file' must specify the results file to
|
|---|
| 87 | read, which must have been created in a previous run
|
|---|
| 88 | with `--count --file=FILE'.
|
|---|
| 89 |
|
|---|
| 90 | Modifiers:
|
|---|
| 91 | -f, --file=<file> File to accumulate counts over several runs.
|
|---|
| 92 | -R, --no-report Do not generate the coverage report files.
|
|---|
| 93 | Useful if you want to accumulate over several runs.
|
|---|
| 94 | -C, --coverdir=<dir> Directory where the report files. The coverage
|
|---|
| 95 | report for <package>.<module> is written to file
|
|---|
| 96 | <dir>/<package>/<module>.cover.
|
|---|
| 97 | -m, --missing Annotate executable lines that were not executed
|
|---|
| 98 | with '>>>>>> '.
|
|---|
| 99 | -s, --summary Write a brief summary on stdout for each file.
|
|---|
| 100 | (Can only be used with --count or --report.)
|
|---|
| 101 |
|
|---|
| 102 | Filters, may be repeated multiple times:
|
|---|
| 103 | --ignore-module=<mod> Ignore the given module and its submodules
|
|---|
| 104 | (if it is a package).
|
|---|
| 105 | --ignore-dir=<dir> Ignore files in the given directory (multiple
|
|---|
| 106 | directories can be joined by os.pathsep).
|
|---|
| 107 | """ % sys.argv[0])
|
|---|
| 108 |
|
|---|
| 109 | PRAGMA_NOCOVER = "#pragma NO COVER"
|
|---|
| 110 |
|
|---|
| 111 | # Simple rx to find lines with no code.
|
|---|
| 112 | rx_blank = re.compile(r'^\s*(#.*)?$')
|
|---|
| 113 |
|
|---|
| 114 | class Ignore:
|
|---|
| 115 | def __init__(self, modules = None, dirs = None):
|
|---|
| 116 | self._mods = modules or []
|
|---|
| 117 | self._dirs = dirs or []
|
|---|
| 118 |
|
|---|
| 119 | self._dirs = map(os.path.normpath, self._dirs)
|
|---|
| 120 | self._ignore = { '<string>': 1 }
|
|---|
| 121 |
|
|---|
| 122 | def names(self, filename, modulename):
|
|---|
| 123 | if self._ignore.has_key(modulename):
|
|---|
| 124 | return self._ignore[modulename]
|
|---|
| 125 |
|
|---|
| 126 | # haven't seen this one before, so see if the module name is
|
|---|
| 127 | # on the ignore list. Need to take some care since ignoring
|
|---|
| 128 | # "cmp" musn't mean ignoring "cmpcache" but ignoring
|
|---|
| 129 | # "Spam" must also mean ignoring "Spam.Eggs".
|
|---|
| 130 | for mod in self._mods:
|
|---|
| 131 | if mod == modulename: # Identical names, so ignore
|
|---|
| 132 | self._ignore[modulename] = 1
|
|---|
| 133 | return 1
|
|---|
| 134 | # check if the module is a proper submodule of something on
|
|---|
| 135 | # the ignore list
|
|---|
| 136 | n = len(mod)
|
|---|
| 137 | # (will not overflow since if the first n characters are the
|
|---|
| 138 | # same and the name has not already occurred, then the size
|
|---|
| 139 | # of "name" is greater than that of "mod")
|
|---|
| 140 | if mod == modulename[:n] and modulename[n] == '.':
|
|---|
| 141 | self._ignore[modulename] = 1
|
|---|
| 142 | return 1
|
|---|
| 143 |
|
|---|
| 144 | # Now check that __file__ isn't in one of the directories
|
|---|
| 145 | if filename is None:
|
|---|
| 146 | # must be a built-in, so we must ignore
|
|---|
| 147 | self._ignore[modulename] = 1
|
|---|
| 148 | return 1
|
|---|
| 149 |
|
|---|
| 150 | # Ignore a file when it contains one of the ignorable paths
|
|---|
| 151 | for d in self._dirs:
|
|---|
| 152 | # The '+ os.sep' is to ensure that d is a parent directory,
|
|---|
| 153 | # as compared to cases like:
|
|---|
| 154 | # d = "/usr/local"
|
|---|
| 155 | # filename = "/usr/local.py"
|
|---|
| 156 | # or
|
|---|
| 157 | # d = "/usr/local.py"
|
|---|
| 158 | # filename = "/usr/local.py"
|
|---|
| 159 | if filename.startswith(d + os.sep):
|
|---|
| 160 | self._ignore[modulename] = 1
|
|---|
| 161 | return 1
|
|---|
| 162 |
|
|---|
| 163 | # Tried the different ways, so we don't ignore this module
|
|---|
| 164 | self._ignore[modulename] = 0
|
|---|
| 165 | return 0
|
|---|
| 166 |
|
|---|
| 167 | def modname(path):
|
|---|
| 168 | """Return a plausible module name for the patch."""
|
|---|
| 169 |
|
|---|
| 170 | base = os.path.basename(path)
|
|---|
| 171 | filename, ext = os.path.splitext(base)
|
|---|
| 172 | return filename
|
|---|
| 173 |
|
|---|
| 174 | def fullmodname(path):
|
|---|
| 175 | """Return a plausible module name for the path."""
|
|---|
| 176 |
|
|---|
| 177 | # If the file 'path' is part of a package, then the filename isn't
|
|---|
| 178 | # enough to uniquely identify it. Try to do the right thing by
|
|---|
| 179 | # looking in sys.path for the longest matching prefix. We'll
|
|---|
| 180 | # assume that the rest is the package name.
|
|---|
| 181 |
|
|---|
| 182 | comparepath = os.path.normcase(path)
|
|---|
| 183 | longest = ""
|
|---|
| 184 | for dir in sys.path:
|
|---|
| 185 | dir = os.path.normcase(dir)
|
|---|
| 186 | if comparepath.startswith(dir) and comparepath[len(dir)] == os.sep:
|
|---|
| 187 | if len(dir) > len(longest):
|
|---|
| 188 | longest = dir
|
|---|
| 189 |
|
|---|
| 190 | if longest:
|
|---|
| 191 | base = path[len(longest) + 1:]
|
|---|
| 192 | else:
|
|---|
| 193 | base = path
|
|---|
| 194 | base = base.replace(os.sep, ".")
|
|---|
| 195 | if os.altsep:
|
|---|
| 196 | base = base.replace(os.altsep, ".")
|
|---|
| 197 | filename, ext = os.path.splitext(base)
|
|---|
| 198 | return filename
|
|---|
| 199 |
|
|---|
| 200 | class CoverageResults:
|
|---|
| 201 | def __init__(self, counts=None, calledfuncs=None, infile=None,
|
|---|
| 202 | callers=None, outfile=None):
|
|---|
| 203 | self.counts = counts
|
|---|
| 204 | if self.counts is None:
|
|---|
| 205 | self.counts = {}
|
|---|
| 206 | self.counter = self.counts.copy() # map (filename, lineno) to count
|
|---|
| 207 | self.calledfuncs = calledfuncs
|
|---|
| 208 | if self.calledfuncs is None:
|
|---|
| 209 | self.calledfuncs = {}
|
|---|
| 210 | self.calledfuncs = self.calledfuncs.copy()
|
|---|
| 211 | self.callers = callers
|
|---|
| 212 | if self.callers is None:
|
|---|
| 213 | self.callers = {}
|
|---|
| 214 | self.callers = self.callers.copy()
|
|---|
| 215 | self.infile = infile
|
|---|
| 216 | self.outfile = outfile
|
|---|
| 217 | if self.infile:
|
|---|
| 218 | # Try to merge existing counts file.
|
|---|
| 219 | try:
|
|---|
| 220 | counts, calledfuncs, callers = \
|
|---|
| 221 | pickle.load(open(self.infile, 'rb'))
|
|---|
| 222 | self.update(self.__class__(counts, calledfuncs, callers))
|
|---|
| 223 | except (IOError, EOFError, ValueError), err:
|
|---|
| 224 | print >> sys.stderr, ("Skipping counts file %r: %s"
|
|---|
| 225 | % (self.infile, err))
|
|---|
| 226 |
|
|---|
| 227 | def update(self, other):
|
|---|
| 228 | """Merge in the data from another CoverageResults"""
|
|---|
| 229 | counts = self.counts
|
|---|
| 230 | calledfuncs = self.calledfuncs
|
|---|
| 231 | callers = self.callers
|
|---|
| 232 | other_counts = other.counts
|
|---|
| 233 | other_calledfuncs = other.calledfuncs
|
|---|
| 234 | other_callers = other.callers
|
|---|
| 235 |
|
|---|
| 236 | for key in other_counts.keys():
|
|---|
| 237 | counts[key] = counts.get(key, 0) + other_counts[key]
|
|---|
| 238 |
|
|---|
| 239 | for key in other_calledfuncs.keys():
|
|---|
| 240 | calledfuncs[key] = 1
|
|---|
| 241 |
|
|---|
| 242 | for key in other_callers.keys():
|
|---|
| 243 | callers[key] = 1
|
|---|
| 244 |
|
|---|
| 245 | def write_results(self, show_missing=True, summary=False, coverdir=None):
|
|---|
| 246 | """
|
|---|
| 247 | @param coverdir
|
|---|
| 248 | """
|
|---|
| 249 | if self.calledfuncs:
|
|---|
| 250 | print
|
|---|
| 251 | print "functions called:"
|
|---|
| 252 | calls = self.calledfuncs.keys()
|
|---|
| 253 | calls.sort()
|
|---|
| 254 | for filename, modulename, funcname in calls:
|
|---|
| 255 | print ("filename: %s, modulename: %s, funcname: %s"
|
|---|
| 256 | % (filename, modulename, funcname))
|
|---|
| 257 |
|
|---|
| 258 | if self.callers:
|
|---|
| 259 | print
|
|---|
| 260 | print "calling relationships:"
|
|---|
| 261 | calls = self.callers.keys()
|
|---|
| 262 | calls.sort()
|
|---|
| 263 | lastfile = lastcfile = ""
|
|---|
| 264 | for ((pfile, pmod, pfunc), (cfile, cmod, cfunc)) in calls:
|
|---|
| 265 | if pfile != lastfile:
|
|---|
| 266 | print
|
|---|
| 267 | print "***", pfile, "***"
|
|---|
| 268 | lastfile = pfile
|
|---|
| 269 | lastcfile = ""
|
|---|
| 270 | if cfile != pfile and lastcfile != cfile:
|
|---|
| 271 | print " -->", cfile
|
|---|
| 272 | lastcfile = cfile
|
|---|
| 273 | print " %s.%s -> %s.%s" % (pmod, pfunc, cmod, cfunc)
|
|---|
| 274 |
|
|---|
| 275 | # turn the counts data ("(filename, lineno) = count") into something
|
|---|
| 276 | # accessible on a per-file basis
|
|---|
| 277 | per_file = {}
|
|---|
| 278 | for filename, lineno in self.counts.keys():
|
|---|
| 279 | lines_hit = per_file[filename] = per_file.get(filename, {})
|
|---|
| 280 | lines_hit[lineno] = self.counts[(filename, lineno)]
|
|---|
| 281 |
|
|---|
| 282 | # accumulate summary info, if needed
|
|---|
| 283 | sums = {}
|
|---|
| 284 |
|
|---|
| 285 | for filename, count in per_file.iteritems():
|
|---|
| 286 | # skip some "files" we don't care about...
|
|---|
| 287 | if filename == "<string>":
|
|---|
| 288 | continue
|
|---|
| 289 |
|
|---|
| 290 | if filename.endswith((".pyc", ".pyo")):
|
|---|
| 291 | filename = filename[:-1]
|
|---|
| 292 |
|
|---|
| 293 | if coverdir is None:
|
|---|
| 294 | dir = os.path.dirname(os.path.abspath(filename))
|
|---|
| 295 | modulename = modname(filename)
|
|---|
| 296 | else:
|
|---|
| 297 | dir = coverdir
|
|---|
| 298 | if not os.path.exists(dir):
|
|---|
| 299 | os.makedirs(dir)
|
|---|
| 300 | modulename = fullmodname(filename)
|
|---|
| 301 |
|
|---|
| 302 | # If desired, get a list of the line numbers which represent
|
|---|
| 303 | # executable content (returned as a dict for better lookup speed)
|
|---|
| 304 | if show_missing:
|
|---|
| 305 | lnotab = find_executable_linenos(filename)
|
|---|
| 306 | else:
|
|---|
| 307 | lnotab = {}
|
|---|
| 308 |
|
|---|
| 309 | source = linecache.getlines(filename)
|
|---|
| 310 | coverpath = os.path.join(dir, modulename + ".cover")
|
|---|
| 311 | n_hits, n_lines = self.write_results_file(coverpath, source,
|
|---|
| 312 | lnotab, count)
|
|---|
| 313 |
|
|---|
| 314 | if summary and n_lines:
|
|---|
| 315 | percent = int(100 * n_hits / n_lines)
|
|---|
| 316 | sums[modulename] = n_lines, percent, modulename, filename
|
|---|
| 317 |
|
|---|
| 318 | if summary and sums:
|
|---|
| 319 | mods = sums.keys()
|
|---|
| 320 | mods.sort()
|
|---|
| 321 | print "lines cov% module (path)"
|
|---|
| 322 | for m in mods:
|
|---|
| 323 | n_lines, percent, modulename, filename = sums[m]
|
|---|
| 324 | print "%5d %3d%% %s (%s)" % sums[m]
|
|---|
| 325 |
|
|---|
| 326 | if self.outfile:
|
|---|
| 327 | # try and store counts and module info into self.outfile
|
|---|
| 328 | try:
|
|---|
| 329 | pickle.dump((self.counts, self.calledfuncs, self.callers),
|
|---|
| 330 | open(self.outfile, 'wb'), 1)
|
|---|
| 331 | except IOError, err:
|
|---|
| 332 | print >> sys.stderr, "Can't save counts files because %s" % err
|
|---|
| 333 |
|
|---|
| 334 | def write_results_file(self, path, lines, lnotab, lines_hit):
|
|---|
| 335 | """Return a coverage results file in path."""
|
|---|
| 336 |
|
|---|
| 337 | try:
|
|---|
| 338 | outfile = open(path, "w")
|
|---|
| 339 | except IOError, err:
|
|---|
| 340 | print >> sys.stderr, ("trace: Could not open %r for writing: %s"
|
|---|
| 341 | "- skipping" % (path, err))
|
|---|
| 342 | return 0, 0
|
|---|
| 343 |
|
|---|
| 344 | n_lines = 0
|
|---|
| 345 | n_hits = 0
|
|---|
| 346 | for i, line in enumerate(lines):
|
|---|
| 347 | lineno = i + 1
|
|---|
| 348 | # do the blank/comment match to try to mark more lines
|
|---|
| 349 | # (help the reader find stuff that hasn't been covered)
|
|---|
| 350 | if lineno in lines_hit:
|
|---|
| 351 | outfile.write("%5d: " % lines_hit[lineno])
|
|---|
| 352 | n_hits += 1
|
|---|
| 353 | n_lines += 1
|
|---|
| 354 | elif rx_blank.match(line):
|
|---|
| 355 | outfile.write(" ")
|
|---|
| 356 | else:
|
|---|
| 357 | # lines preceded by no marks weren't hit
|
|---|
| 358 | # Highlight them if so indicated, unless the line contains
|
|---|
| 359 | # #pragma: NO COVER
|
|---|
| 360 | if lineno in lnotab and not PRAGMA_NOCOVER in lines[i]:
|
|---|
| 361 | outfile.write(">>>>>> ")
|
|---|
| 362 | n_lines += 1
|
|---|
| 363 | else:
|
|---|
| 364 | outfile.write(" ")
|
|---|
| 365 | outfile.write(lines[i].expandtabs(8))
|
|---|
| 366 | outfile.close()
|
|---|
| 367 |
|
|---|
| 368 | return n_hits, n_lines
|
|---|
| 369 |
|
|---|
| 370 | def find_lines_from_code(code, strs):
|
|---|
| 371 | """Return dict where keys are lines in the line number table."""
|
|---|
| 372 | linenos = {}
|
|---|
| 373 |
|
|---|
| 374 | line_increments = [ord(c) for c in code.co_lnotab[1::2]]
|
|---|
| 375 | table_length = len(line_increments)
|
|---|
| 376 | docstring = False
|
|---|
| 377 |
|
|---|
| 378 | lineno = code.co_firstlineno
|
|---|
| 379 | for li in line_increments:
|
|---|
| 380 | lineno += li
|
|---|
| 381 | if lineno not in strs:
|
|---|
| 382 | linenos[lineno] = 1
|
|---|
| 383 |
|
|---|
| 384 | return linenos
|
|---|
| 385 |
|
|---|
| 386 | def find_lines(code, strs):
|
|---|
| 387 | """Return lineno dict for all code objects reachable from code."""
|
|---|
| 388 | # get all of the lineno information from the code of this scope level
|
|---|
| 389 | linenos = find_lines_from_code(code, strs)
|
|---|
| 390 |
|
|---|
| 391 | # and check the constants for references to other code objects
|
|---|
| 392 | for c in code.co_consts:
|
|---|
| 393 | if isinstance(c, types.CodeType):
|
|---|
| 394 | # find another code object, so recurse into it
|
|---|
| 395 | linenos.update(find_lines(c, strs))
|
|---|
| 396 | return linenos
|
|---|
| 397 |
|
|---|
| 398 | def find_strings(filename):
|
|---|
| 399 | """Return a dict of possible docstring positions.
|
|---|
| 400 |
|
|---|
| 401 | The dict maps line numbers to strings. There is an entry for
|
|---|
| 402 | line that contains only a string or a part of a triple-quoted
|
|---|
| 403 | string.
|
|---|
| 404 | """
|
|---|
| 405 | d = {}
|
|---|
| 406 | # If the first token is a string, then it's the module docstring.
|
|---|
| 407 | # Add this special case so that the test in the loop passes.
|
|---|
| 408 | prev_ttype = token.INDENT
|
|---|
| 409 | f = open(filename)
|
|---|
| 410 | for ttype, tstr, start, end, line in tokenize.generate_tokens(f.readline):
|
|---|
| 411 | if ttype == token.STRING:
|
|---|
| 412 | if prev_ttype == token.INDENT:
|
|---|
| 413 | sline, scol = start
|
|---|
| 414 | eline, ecol = end
|
|---|
| 415 | for i in range(sline, eline + 1):
|
|---|
| 416 | d[i] = 1
|
|---|
| 417 | prev_ttype = ttype
|
|---|
| 418 | f.close()
|
|---|
| 419 | return d
|
|---|
| 420 |
|
|---|
| 421 | def find_executable_linenos(filename):
|
|---|
| 422 | """Return dict where keys are line numbers in the line number table."""
|
|---|
| 423 | try:
|
|---|
| 424 | prog = open(filename, "rU").read()
|
|---|
| 425 | except IOError, err:
|
|---|
| 426 | print >> sys.stderr, ("Not printing coverage data for %r: %s"
|
|---|
| 427 | % (filename, err))
|
|---|
| 428 | return {}
|
|---|
| 429 | code = compile(prog, filename, "exec")
|
|---|
| 430 | strs = find_strings(filename)
|
|---|
| 431 | return find_lines(code, strs)
|
|---|
| 432 |
|
|---|
| 433 | class Trace:
|
|---|
| 434 | def __init__(self, count=1, trace=1, countfuncs=0, countcallers=0,
|
|---|
| 435 | ignoremods=(), ignoredirs=(), infile=None, outfile=None):
|
|---|
| 436 | """
|
|---|
| 437 | @param count true iff it should count number of times each
|
|---|
| 438 | line is executed
|
|---|
| 439 | @param trace true iff it should print out each line that is
|
|---|
| 440 | being counted
|
|---|
| 441 | @param countfuncs true iff it should just output a list of
|
|---|
| 442 | (filename, modulename, funcname,) for functions
|
|---|
| 443 | that were called at least once; This overrides
|
|---|
| 444 | `count' and `trace'
|
|---|
| 445 | @param ignoremods a list of the names of modules to ignore
|
|---|
| 446 | @param ignoredirs a list of the names of directories to ignore
|
|---|
| 447 | all of the (recursive) contents of
|
|---|
| 448 | @param infile file from which to read stored counts to be
|
|---|
| 449 | added into the results
|
|---|
| 450 | @param outfile file in which to write the results
|
|---|
| 451 | """
|
|---|
| 452 | self.infile = infile
|
|---|
| 453 | self.outfile = outfile
|
|---|
| 454 | self.ignore = Ignore(ignoremods, ignoredirs)
|
|---|
| 455 | self.counts = {} # keys are (filename, linenumber)
|
|---|
| 456 | self.blabbed = {} # for debugging
|
|---|
| 457 | self.pathtobasename = {} # for memoizing os.path.basename
|
|---|
| 458 | self.donothing = 0
|
|---|
| 459 | self.trace = trace
|
|---|
| 460 | self._calledfuncs = {}
|
|---|
| 461 | self._callers = {}
|
|---|
| 462 | self._caller_cache = {}
|
|---|
| 463 | if countcallers:
|
|---|
| 464 | self.globaltrace = self.globaltrace_trackcallers
|
|---|
| 465 | elif countfuncs:
|
|---|
| 466 | self.globaltrace = self.globaltrace_countfuncs
|
|---|
| 467 | elif trace and count:
|
|---|
| 468 | self.globaltrace = self.globaltrace_lt
|
|---|
| 469 | self.localtrace = self.localtrace_trace_and_count
|
|---|
| 470 | elif trace:
|
|---|
| 471 | self.globaltrace = self.globaltrace_lt
|
|---|
| 472 | self.localtrace = self.localtrace_trace
|
|---|
| 473 | elif count:
|
|---|
| 474 | self.globaltrace = self.globaltrace_lt
|
|---|
| 475 | self.localtrace = self.localtrace_count
|
|---|
| 476 | else:
|
|---|
| 477 | # Ahem -- do nothing? Okay.
|
|---|
| 478 | self.donothing = 1
|
|---|
| 479 |
|
|---|
| 480 | def run(self, cmd):
|
|---|
| 481 | import __main__
|
|---|
| 482 | dict = __main__.__dict__
|
|---|
| 483 | if not self.donothing:
|
|---|
| 484 | sys.settrace(self.globaltrace)
|
|---|
| 485 | threading.settrace(self.globaltrace)
|
|---|
| 486 | try:
|
|---|
| 487 | exec cmd in dict, dict
|
|---|
| 488 | finally:
|
|---|
| 489 | if not self.donothing:
|
|---|
| 490 | sys.settrace(None)
|
|---|
| 491 | threading.settrace(None)
|
|---|
| 492 |
|
|---|
| 493 | def runctx(self, cmd, globals=None, locals=None):
|
|---|
| 494 | if globals is None: globals = {}
|
|---|
| 495 | if locals is None: locals = {}
|
|---|
| 496 | if not self.donothing:
|
|---|
| 497 | sys.settrace(self.globaltrace)
|
|---|
| 498 | threading.settrace(self.globaltrace)
|
|---|
| 499 | try:
|
|---|
| 500 | exec cmd in globals, locals
|
|---|
| 501 | finally:
|
|---|
| 502 | if not self.donothing:
|
|---|
| 503 | sys.settrace(None)
|
|---|
| 504 | threading.settrace(None)
|
|---|
| 505 |
|
|---|
| 506 | def runfunc(self, func, *args, **kw):
|
|---|
| 507 | result = None
|
|---|
| 508 | if not self.donothing:
|
|---|
| 509 | sys.settrace(self.globaltrace)
|
|---|
| 510 | try:
|
|---|
| 511 | result = func(*args, **kw)
|
|---|
| 512 | finally:
|
|---|
| 513 | if not self.donothing:
|
|---|
| 514 | sys.settrace(None)
|
|---|
| 515 | return result
|
|---|
| 516 |
|
|---|
| 517 | def file_module_function_of(self, frame):
|
|---|
| 518 | code = frame.f_code
|
|---|
| 519 | filename = code.co_filename
|
|---|
| 520 | if filename:
|
|---|
| 521 | modulename = modname(filename)
|
|---|
| 522 | else:
|
|---|
| 523 | modulename = None
|
|---|
| 524 |
|
|---|
| 525 | funcname = code.co_name
|
|---|
| 526 | clsname = None
|
|---|
| 527 | if code in self._caller_cache:
|
|---|
| 528 | if self._caller_cache[code] is not None:
|
|---|
| 529 | clsname = self._caller_cache[code]
|
|---|
| 530 | else:
|
|---|
| 531 | self._caller_cache[code] = None
|
|---|
| 532 | ## use of gc.get_referrers() was suggested by Michael Hudson
|
|---|
| 533 | # all functions which refer to this code object
|
|---|
| 534 | funcs = [f for f in gc.get_referrers(code)
|
|---|
| 535 | if hasattr(f, "func_doc")]
|
|---|
| 536 | # require len(func) == 1 to avoid ambiguity caused by calls to
|
|---|
| 537 | # new.function(): "In the face of ambiguity, refuse the
|
|---|
| 538 | # temptation to guess."
|
|---|
| 539 | if len(funcs) == 1:
|
|---|
| 540 | dicts = [d for d in gc.get_referrers(funcs[0])
|
|---|
| 541 | if isinstance(d, dict)]
|
|---|
| 542 | if len(dicts) == 1:
|
|---|
| 543 | classes = [c for c in gc.get_referrers(dicts[0])
|
|---|
| 544 | if hasattr(c, "__bases__")]
|
|---|
| 545 | if len(classes) == 1:
|
|---|
| 546 | # ditto for new.classobj()
|
|---|
| 547 | clsname = str(classes[0])
|
|---|
| 548 | # cache the result - assumption is that new.* is
|
|---|
| 549 | # not called later to disturb this relationship
|
|---|
| 550 | # _caller_cache could be flushed if functions in
|
|---|
| 551 | # the new module get called.
|
|---|
| 552 | self._caller_cache[code] = clsname
|
|---|
| 553 | if clsname is not None:
|
|---|
| 554 | # final hack - module name shows up in str(cls), but we've already
|
|---|
| 555 | # computed module name, so remove it
|
|---|
| 556 | clsname = clsname.split(".")[1:]
|
|---|
| 557 | clsname = ".".join(clsname)
|
|---|
| 558 | funcname = "%s.%s" % (clsname, funcname)
|
|---|
| 559 |
|
|---|
| 560 | return filename, modulename, funcname
|
|---|
| 561 |
|
|---|
| 562 | def globaltrace_trackcallers(self, frame, why, arg):
|
|---|
| 563 | """Handler for call events.
|
|---|
| 564 |
|
|---|
| 565 | Adds information about who called who to the self._callers dict.
|
|---|
| 566 | """
|
|---|
| 567 | if why == 'call':
|
|---|
| 568 | # XXX Should do a better job of identifying methods
|
|---|
| 569 | this_func = self.file_module_function_of(frame)
|
|---|
| 570 | parent_func = self.file_module_function_of(frame.f_back)
|
|---|
| 571 | self._callers[(parent_func, this_func)] = 1
|
|---|
| 572 |
|
|---|
| 573 | def globaltrace_countfuncs(self, frame, why, arg):
|
|---|
| 574 | """Handler for call events.
|
|---|
| 575 |
|
|---|
| 576 | Adds (filename, modulename, funcname) to the self._calledfuncs dict.
|
|---|
| 577 | """
|
|---|
| 578 | if why == 'call':
|
|---|
| 579 | this_func = self.file_module_function_of(frame)
|
|---|
| 580 | self._calledfuncs[this_func] = 1
|
|---|
| 581 |
|
|---|
| 582 | def globaltrace_lt(self, frame, why, arg):
|
|---|
| 583 | """Handler for call events.
|
|---|
| 584 |
|
|---|
| 585 | If the code block being entered is to be ignored, returns `None',
|
|---|
| 586 | else returns self.localtrace.
|
|---|
| 587 | """
|
|---|
| 588 | if why == 'call':
|
|---|
| 589 | code = frame.f_code
|
|---|
| 590 | filename = code.co_filename
|
|---|
| 591 | if filename:
|
|---|
| 592 | # XXX modname() doesn't work right for packages, so
|
|---|
| 593 | # the ignore support won't work right for packages
|
|---|
| 594 | modulename = modname(filename)
|
|---|
| 595 | if modulename is not None:
|
|---|
| 596 | ignore_it = self.ignore.names(filename, modulename)
|
|---|
| 597 | if not ignore_it:
|
|---|
| 598 | if self.trace:
|
|---|
| 599 | print (" --- modulename: %s, funcname: %s"
|
|---|
| 600 | % (modulename, code.co_name))
|
|---|
| 601 | return self.localtrace
|
|---|
| 602 | else:
|
|---|
| 603 | return None
|
|---|
| 604 |
|
|---|
| 605 | def localtrace_trace_and_count(self, frame, why, arg):
|
|---|
| 606 | if why == "line":
|
|---|
| 607 | # record the file name and line number of every trace
|
|---|
| 608 | filename = frame.f_code.co_filename
|
|---|
| 609 | lineno = frame.f_lineno
|
|---|
| 610 | key = filename, lineno
|
|---|
| 611 | self.counts[key] = self.counts.get(key, 0) + 1
|
|---|
| 612 |
|
|---|
| 613 | bname = os.path.basename(filename)
|
|---|
| 614 | print "%s(%d): %s" % (bname, lineno,
|
|---|
| 615 | linecache.getline(filename, lineno)),
|
|---|
| 616 | return self.localtrace
|
|---|
| 617 |
|
|---|
| 618 | def localtrace_trace(self, frame, why, arg):
|
|---|
| 619 | if why == "line":
|
|---|
| 620 | # record the file name and line number of every trace
|
|---|
| 621 | filename = frame.f_code.co_filename
|
|---|
| 622 | lineno = frame.f_lineno
|
|---|
| 623 |
|
|---|
| 624 | bname = os.path.basename(filename)
|
|---|
| 625 | print "%s(%d): %s" % (bname, lineno,
|
|---|
| 626 | linecache.getline(filename, lineno)),
|
|---|
| 627 | return self.localtrace
|
|---|
| 628 |
|
|---|
| 629 | def localtrace_count(self, frame, why, arg):
|
|---|
| 630 | if why == "line":
|
|---|
| 631 | filename = frame.f_code.co_filename
|
|---|
| 632 | lineno = frame.f_lineno
|
|---|
| 633 | key = filename, lineno
|
|---|
| 634 | self.counts[key] = self.counts.get(key, 0) + 1
|
|---|
| 635 | return self.localtrace
|
|---|
| 636 |
|
|---|
| 637 | def results(self):
|
|---|
| 638 | return CoverageResults(self.counts, infile=self.infile,
|
|---|
| 639 | outfile=self.outfile,
|
|---|
| 640 | calledfuncs=self._calledfuncs,
|
|---|
| 641 | callers=self._callers)
|
|---|
| 642 |
|
|---|
| 643 | def _err_exit(msg):
|
|---|
| 644 | sys.stderr.write("%s: %s\n" % (sys.argv[0], msg))
|
|---|
| 645 | sys.exit(1)
|
|---|
| 646 |
|
|---|
| 647 | def main(argv=None):
|
|---|
| 648 | import getopt
|
|---|
| 649 |
|
|---|
| 650 | if argv is None:
|
|---|
| 651 | argv = sys.argv
|
|---|
| 652 | try:
|
|---|
| 653 | opts, prog_argv = getopt.getopt(argv[1:], "tcrRf:d:msC:lT",
|
|---|
| 654 | ["help", "version", "trace", "count",
|
|---|
| 655 | "report", "no-report", "summary",
|
|---|
| 656 | "file=", "missing",
|
|---|
| 657 | "ignore-module=", "ignore-dir=",
|
|---|
| 658 | "coverdir=", "listfuncs",
|
|---|
| 659 | "trackcalls"])
|
|---|
| 660 |
|
|---|
| 661 | except getopt.error, msg:
|
|---|
| 662 | sys.stderr.write("%s: %s\n" % (sys.argv[0], msg))
|
|---|
| 663 | sys.stderr.write("Try `%s --help' for more information\n"
|
|---|
| 664 | % sys.argv[0])
|
|---|
| 665 | sys.exit(1)
|
|---|
| 666 |
|
|---|
| 667 | trace = 0
|
|---|
| 668 | count = 0
|
|---|
| 669 | report = 0
|
|---|
| 670 | no_report = 0
|
|---|
| 671 | counts_file = None
|
|---|
| 672 | missing = 0
|
|---|
| 673 | ignore_modules = []
|
|---|
| 674 | ignore_dirs = []
|
|---|
| 675 | coverdir = None
|
|---|
| 676 | summary = 0
|
|---|
| 677 | listfuncs = False
|
|---|
| 678 | countcallers = False
|
|---|
| 679 |
|
|---|
| 680 | for opt, val in opts:
|
|---|
| 681 | if opt == "--help":
|
|---|
| 682 | usage(sys.stdout)
|
|---|
| 683 | sys.exit(0)
|
|---|
| 684 |
|
|---|
| 685 | if opt == "--version":
|
|---|
| 686 | sys.stdout.write("trace 2.0\n")
|
|---|
| 687 | sys.exit(0)
|
|---|
| 688 |
|
|---|
| 689 | if opt == "-T" or opt == "--trackcalls":
|
|---|
| 690 | countcallers = True
|
|---|
| 691 | continue
|
|---|
| 692 |
|
|---|
| 693 | if opt == "-l" or opt == "--listfuncs":
|
|---|
| 694 | listfuncs = True
|
|---|
| 695 | continue
|
|---|
| 696 |
|
|---|
| 697 | if opt == "-t" or opt == "--trace":
|
|---|
| 698 | trace = 1
|
|---|
| 699 | continue
|
|---|
| 700 |
|
|---|
| 701 | if opt == "-c" or opt == "--count":
|
|---|
| 702 | count = 1
|
|---|
| 703 | continue
|
|---|
| 704 |
|
|---|
| 705 | if opt == "-r" or opt == "--report":
|
|---|
| 706 | report = 1
|
|---|
| 707 | continue
|
|---|
| 708 |
|
|---|
| 709 | if opt == "-R" or opt == "--no-report":
|
|---|
| 710 | no_report = 1
|
|---|
| 711 | continue
|
|---|
| 712 |
|
|---|
| 713 | if opt == "-f" or opt == "--file":
|
|---|
| 714 | counts_file = val
|
|---|
| 715 | continue
|
|---|
| 716 |
|
|---|
| 717 | if opt == "-m" or opt == "--missing":
|
|---|
| 718 | missing = 1
|
|---|
| 719 | continue
|
|---|
| 720 |
|
|---|
| 721 | if opt == "-C" or opt == "--coverdir":
|
|---|
| 722 | coverdir = val
|
|---|
| 723 | continue
|
|---|
| 724 |
|
|---|
| 725 | if opt == "-s" or opt == "--summary":
|
|---|
| 726 | summary = 1
|
|---|
| 727 | continue
|
|---|
| 728 |
|
|---|
| 729 | if opt == "--ignore-module":
|
|---|
| 730 | ignore_modules.append(val)
|
|---|
| 731 | continue
|
|---|
| 732 |
|
|---|
| 733 | if opt == "--ignore-dir":
|
|---|
| 734 | for s in val.split(os.pathsep):
|
|---|
| 735 | s = os.path.expandvars(s)
|
|---|
| 736 | # should I also call expanduser? (after all, could use $HOME)
|
|---|
| 737 |
|
|---|
| 738 | s = s.replace("$prefix",
|
|---|
| 739 | os.path.join(sys.prefix, "lib",
|
|---|
| 740 | "python" + sys.version[:3]))
|
|---|
| 741 | s = s.replace("$exec_prefix",
|
|---|
| 742 | os.path.join(sys.exec_prefix, "lib",
|
|---|
| 743 | "python" + sys.version[:3]))
|
|---|
| 744 | s = os.path.normpath(s)
|
|---|
| 745 | ignore_dirs.append(s)
|
|---|
| 746 | continue
|
|---|
| 747 |
|
|---|
| 748 | assert 0, "Should never get here"
|
|---|
| 749 |
|
|---|
| 750 | if listfuncs and (count or trace):
|
|---|
| 751 | _err_exit("cannot specify both --listfuncs and (--trace or --count)")
|
|---|
| 752 |
|
|---|
| 753 | if not (count or trace or report or listfuncs or countcallers):
|
|---|
| 754 | _err_exit("must specify one of --trace, --count, --report, "
|
|---|
| 755 | "--listfuncs, or --trackcalls")
|
|---|
| 756 |
|
|---|
| 757 | if report and no_report:
|
|---|
| 758 | _err_exit("cannot specify both --report and --no-report")
|
|---|
| 759 |
|
|---|
| 760 | if report and not counts_file:
|
|---|
| 761 | _err_exit("--report requires a --file")
|
|---|
| 762 |
|
|---|
| 763 | if no_report and len(prog_argv) == 0:
|
|---|
| 764 | _err_exit("missing name of file to run")
|
|---|
| 765 |
|
|---|
| 766 | # everything is ready
|
|---|
| 767 | if report:
|
|---|
| 768 | results = CoverageResults(infile=counts_file, outfile=counts_file)
|
|---|
| 769 | results.write_results(missing, summary=summary, coverdir=coverdir)
|
|---|
| 770 | else:
|
|---|
| 771 | sys.argv = prog_argv
|
|---|
| 772 | progname = prog_argv[0]
|
|---|
| 773 | sys.path[0] = os.path.split(progname)[0]
|
|---|
| 774 |
|
|---|
| 775 | t = Trace(count, trace, countfuncs=listfuncs,
|
|---|
| 776 | countcallers=countcallers, ignoremods=ignore_modules,
|
|---|
| 777 | ignoredirs=ignore_dirs, infile=counts_file,
|
|---|
| 778 | outfile=counts_file)
|
|---|
| 779 | try:
|
|---|
| 780 | t.run('execfile(%r)' % (progname,))
|
|---|
| 781 | except IOError, err:
|
|---|
| 782 | _err_exit("Cannot run file %r because: %s" % (sys.argv[0], err))
|
|---|
| 783 | except SystemExit:
|
|---|
| 784 | pass
|
|---|
| 785 |
|
|---|
| 786 | results = t.results()
|
|---|
| 787 |
|
|---|
| 788 | if not no_report:
|
|---|
| 789 | results.write_results(missing, summary=summary, coverdir=coverdir)
|
|---|
| 790 |
|
|---|
| 791 | if __name__=='__main__':
|
|---|
| 792 | main()
|
|---|
