#!/usr/bin/env python

# portions copyright 2001, Autonomous Zones Industries, Inc., all rights...

# err...  reserved and offered to the public under the terms of the

# Python 2.2 license.

# Author: Zooko O'Whielacronx

# http://zooko.com/

# mailto:zooko@zooko.com

#

# Copyright 2000, Mojam Media, Inc., all rights reserved.

# Author: Skip Montanaro

#

# Copyright 1999, Bioreason, Inc., all rights reserved.

# Author: Andrew Dalke

#

# Copyright 1995-1997, Automatrix, Inc., all rights reserved.

# Author: Skip Montanaro

#

# Copyright 1991-1995, Stichting Mathematisch Centrum, all rights reserved.

#

#

# Permission to use, copy, modify, and distribute this Python software and

# its associated documentation for any purpose without fee is hereby

# granted, provided that the above copyright notice appears in all copies,

# and that both that copyright notice and this permission notice appear in

# supporting documentation, and that the name of neither Automatrix,

# Bioreason or Mojam Media be used in advertising or publicity pertaining to

# distribution of the software without specific, written prior permission.

#

"""program/module to trace Python program or function execution

Sample use, command line:

  trace.py -c -f counts --ignore-dir '$prefix' spam.py eggs

  trace.py -t --ignore-dir '$prefix' spam.py eggs

  trace.py --trackcalls spam.py eggs

Sample use, programmatically

  import sys

  # create a Trace object, telling it what to ignore, and whether to

  # do tracing or line-counting or both.

  tracer = trace.Trace(ignoredirs=[sys.prefix, sys.exec_prefix,], trace=0,

                    count=1)

  # run the new command using the given tracer

  tracer.run('main()')

  # make a report, placing output in /tmp

  r = tracer.results()

  r.write_results(show_missing=True, coverdir="/tmp")

"""

import linecache

import os

import re

import sys

import threading

import time

import token

import tokenize

import types

import gc

try:

    import cPickle

    pickle = cPickle

except ImportError:

    import pickle

def usage(outfile):

    outfile.write("""Usage: %s [OPTIONS] <file> [ARGS]

Meta-options:

--help                Display this help then exit.

--version             Output version information then exit.

Otherwise, exactly one of the following three options must be given:

-t, --trace           Print each line to sys.stdout before it is executed.

-c, --count           Count the number of times each line is executed

                      and write the counts to <module>.cover for each

                      module executed, in the module's directory.

                      See also `--coverdir', `--file', `--no-report' below.

-l, --listfuncs       Keep track of which functions are executed at least

                      once and write the results to sys.stdout after the

                      program exits.

-T, --trackcalls      Keep track of caller/called pairs and write the

                      results to sys.stdout after the program exits.

-r, --report          Generate a report from a counts file; do not execute

                      any code.  `--file' must specify the results file to

                      read, which must have been created in a previous run

                      with `--count --file=FILE'.

Modifiers:

-f, --file=<file>     File to accumulate counts over several runs.

-R, --no-report       Do not generate the coverage report files.

                      Useful if you want to accumulate over several runs.

-C, --coverdir=<dir>  Directory where the report files.  The coverage

                      report for <package>.<module> is written to file

                      <dir>/<package>/<module>.cover.

-m, --missing         Annotate executable lines that were not executed

                      with '>>>>>> '.

-s, --summary         Write a brief summary on stdout for each file.

                      (Can only be used with --count or --report.)

-g, --timing          Prefix each line with the time since the program started.

                      Only used while tracing.

Filters, may be repeated multiple times:

--ignore-module=<mod> Ignore the given module(s) and its submodules

                      (if it is a package).  Accepts comma separated

                      list of module names

--ignore-dir=<dir>    Ignore files in the given directory (multiple

                      directories can be joined by os.pathsep).

""" % sys.argv[0])

PRAGMA_NOCOVER = "#pragma NO COVER"

# Simple rx to find lines with no code.

rx_blank = re.compile(r'^\s*(#.*)?$')

class Ignore:

    def __init__(self, modules = None, dirs = None):

        self._mods = modules or []

        self._dirs = dirs or []

        self._dirs = map(os.path.normpath, self._dirs)

        self._ignore = { '<string>': 1 }

    def names(self, filename, modulename):

        if self._ignore.has_key(modulename):

            return self._ignore[modulename]

        # haven't seen this one before, so see if the module name is

        # on the ignore list.  Need to take some care since ignoring

        # "cmp" musn't mean ignoring "cmpcache" but ignoring

        # "Spam" must also mean ignoring "Spam.Eggs".

        for mod in self._mods:

            if mod == modulename:  # Identical names, so ignore

                self._ignore[modulename] = 1

                return 1

            # check if the module is a proper submodule of something on

            # the ignore list

            n = len(mod)

            # (will not overflow since if the first n characters are the

            # same and the name has not already occurred, then the size

            # of "name" is greater than that of "mod")

            if mod == modulename[:n] and modulename[n] == '.':

                self._ignore[modulename] = 1

                return 1

        # Now check that __file__ isn't in one of the directories

        if filename is None:

            # must be a built-in, so we must ignore

            self._ignore[modulename] = 1

            return 1

        # Ignore a file when it contains one of the ignorable paths

        for d in self._dirs:

            # The '+ os.sep' is to ensure that d is a parent directory,

            # as compared to cases like:

            #  d = "/usr/local"

            #  filename = "/usr/local.py"

            # or

            #  d = "/usr/local.py"

            #  filename = "/usr/local.py"

            if filename.startswith(d + os.sep):

                self._ignore[modulename] = 1

                return 1

        # Tried the different ways, so we don't ignore this module

        self._ignore[modulename] = 0

        return 0

def modname(path):

    """Return a plausible module name for the patch."""

    base = os.path.basename(path)

    filename, ext = os.path.splitext(base)

    return filename

def fullmodname(path):

    """Return a plausible module name for the path."""

    # If the file 'path' is part of a package, then the filename isn't

    # enough to uniquely identify it.  Try to do the right thing by

    # looking in sys.path for the longest matching prefix.  We'll

    # assume that the rest is the package name.

    comparepath = os.path.normcase(path)

    longest = ""

    for dir in sys.path:

        dir = os.path.normcase(dir)

        if comparepath.startswith(dir) and comparepath[len(dir)] == os.sep:

            if len(dir) > len(longest):

                longest = dir

    if longest:

        base = path[len(longest) + 1:]

    else:

        base = path

    base = base.replace(os.sep, ".")

    if os.altsep:

        base = base.replace(os.altsep, ".")

    filename, ext = os.path.splitext(base)

    return filename

class CoverageResults:

    def __init__(self, counts=None, calledfuncs=None, infile=None,

                 callers=None, outfile=None):

        self.counts = counts

        if self.counts is None:

            self.counts = {}

        self.counter = self.counts.copy() # map (filename, lineno) to count

        self.calledfuncs = calledfuncs

        if self.calledfuncs is None:

            self.calledfuncs = {}

        self.calledfuncs = self.calledfuncs.copy()

        self.callers = callers

        if self.callers is None:

            self.callers = {}

        self.callers = self.callers.copy()

        self.infile = infile

        self.outfile = outfile

        if self.infile:

            # Try to merge existing counts file.

            try:

                counts, calledfuncs, callers = \

                        pickle.load(open(self.infile, 'rb'))

                self.update(self.__class__(counts, calledfuncs, callers))

            except (IOError, EOFError, ValueError), err:

                print >> sys.stderr, ("Skipping counts file %r: %s"

                                      % (self.infile, err))

    def update(self, other):

        """Merge in the data from another CoverageResults"""

        counts = self.counts

        calledfuncs = self.calledfuncs

        callers = self.callers

        other_counts = other.counts

        other_calledfuncs = other.calledfuncs

        other_callers = other.callers

        for key in other_counts.keys():

            counts[key] = counts.get(key, 0) + other_counts[key]

        for key in other_calledfuncs.keys():

            calledfuncs[key] = 1

        for key in other_callers.keys():

            callers[key] = 1

    def write_results(self, show_missing=True, summary=False, coverdir=None):

        """

        @param coverdir

        """

        if self.calledfuncs:

            print

            print "functions called:"

            calls = self.calledfuncs.keys()

            calls.sort()

            for filename, modulename, funcname in calls:

                print ("filename: %s, modulename: %s, funcname: %s"

                       % (filename, modulename, funcname))

        if self.callers:

            print

            print "calling relationships:"

            calls = self.callers.keys()

            calls.sort()

            lastfile = lastcfile = ""

            for ((pfile, pmod, pfunc), (cfile, cmod, cfunc)) in calls:

                if pfile != lastfile:

                    print

                    print "***", pfile, "***"

                    lastfile = pfile

                    lastcfile = ""

                if cfile != pfile and lastcfile != cfile:

                    print "  -->", cfile

                    lastcfile = cfile

                print "    %s.%s -> %s.%s" % (pmod, pfunc, cmod, cfunc)

        # turn the counts data ("(filename, lineno) = count") into something

        # accessible on a per-file basis

        per_file = {}

        for filename, lineno in self.counts.keys():

            lines_hit = per_file[filename] = per_file.get(filename, {})

            lines_hit[lineno] = self.counts[(filename, lineno)]

        # accumulate summary info, if needed

        sums = {}

        for filename, count in per_file.iteritems():

            # skip some "files" we don't care about...

            if filename == "<string>":

                continue

            if filename.startswith("<doctest "):

                continue

            if filename.endswith((".pyc", ".pyo")):

                filename = filename[:-1]

            if coverdir is None:

                dir = os.path.dirname(os.path.abspath(filename))

                modulename = modname(filename)

            else:

                dir = coverdir

                if not os.path.exists(dir):

                    os.makedirs(dir)

                modulename = fullmodname(filename)

            # If desired, get a list of the line numbers which represent

            # executable content (returned as a dict for better lookup speed)

            if show_missing:

                lnotab = find_executable_linenos(filename)

            else:

                lnotab = {}

            source = linecache.getlines(filename)

            coverpath = os.path.join(dir, modulename + ".cover")

            n_hits, n_lines = self.write_results_file(coverpath, source,

                                                      lnotab, count)

            if summary and n_lines:

                percent = int(100 * n_hits / n_lines)

                sums[modulename] = n_lines, percent, modulename, filename

        if summary and sums:

            mods = sums.keys()

            mods.sort()

            print "lines   cov%   module   (path)"

            for m in mods:

                n_lines, percent, modulename, filename = sums[m]

                print "%5d   %3d%%   %s   (%s)" % sums[m]

        if self.outfile:

            # try and store counts and module info into self.outfile

            try:

                pickle.dump((self.counts, self.calledfuncs, self.callers),

                            open(self.outfile, 'wb'), 1)

            except IOError, err:

                print >> sys.stderr, "Can't save counts files because %s" % err

    def write_results_file(self, path, lines, lnotab, lines_hit):

        """Return a coverage results file in path."""

        try:

            outfile = open(path, "w")

        except IOError, err:

            print >> sys.stderr, ("trace: Could not open %r for writing: %s"

                                  "- skipping" % (path, err))

            return 0, 0

        n_lines = 0

        n_hits = 0

        for i, line in enumerate(lines):

            lineno = i + 1

            # do the blank/comment match to try to mark more lines

            # (help the reader find stuff that hasn't been covered)

            if lineno in lines_hit:

                outfile.write("%5d: " % lines_hit[lineno])

                n_hits += 1

                n_lines += 1

            elif rx_blank.match(line):

                outfile.write("       ")

            else:

                # lines preceded by no marks weren't hit

                # Highlight them if so indicated, unless the line contains

                # #pragma: NO COVER

                if lineno in lnotab and not PRAGMA_NOCOVER in lines[i]:

                    outfile.write(">>>>>> ")

                    n_lines += 1

                else:

                    outfile.write("       ")

            outfile.write(lines[i].expandtabs(8))

        outfile.close()

        return n_hits, n_lines

def find_lines_from_code(code, strs):

    """Return dict where keys are lines in the line number table."""

    linenos = {}

    line_increments = [ord(c) for c in code.co_lnotab[1::2]]

    table_length = len(line_increments)

    docstring = False

    lineno = code.co_firstlineno

    for li in line_increments:

        lineno += li

        if lineno not in strs:

            linenos[lineno] = 1

    return linenos

def find_lines(code, strs):

    """Return lineno dict for all code objects reachable from code."""

    # get all of the lineno information from the code of this scope level

    linenos = find_lines_from_code(code, strs)

    # and check the constants for references to other code objects

    for c in code.co_consts:

        if isinstance(c, types.CodeType):

            # find another code object, so recurse into it

            linenos.update(find_lines(c, strs))

    return linenos

def find_strings(filename):

    """Return a dict of possible docstring positions.

    The dict maps line numbers to strings.  There is an entry for

    line that contains only a string or a part of a triple-quoted

    string.

    """

    d = {}

    # If the first token is a string, then it's the module docstring.

    # Add this special case so that the test in the loop passes.

    prev_ttype = token.INDENT

    f = open(filename)

    for ttype, tstr, start, end, line in tokenize.generate_tokens(f.readline):

        if ttype == token.STRING:

            if prev_ttype == token.INDENT:

                sline, scol = start

                eline, ecol = end

                for i in range(sline, eline + 1):

                    d[i] = 1

        prev_ttype = ttype

    f.close()

    return d

def find_executable_linenos(filename):

    """Return dict where keys are line numbers in the line number table."""

    try:

        prog = open(filename, "rU").read()

    except IOError, err:

        print >> sys.stderr, ("Not printing coverage data for %r: %s"

                              % (filename, err))

        return {}

    code = compile(prog, filename, "exec")

    strs = find_strings(filename)

    return find_lines(code, strs)

class Trace:

    def __init__(self, count=1, trace=1, countfuncs=0, countcallers=0,

                 ignoremods=(), ignoredirs=(), infile=None, outfile=None,

                 timing=False):

        """

        @param count true iff it should count number of times each

                     line is executed

        @param trace true iff it should print out each line that is

                     being counted

        @param countfuncs true iff it should just output a list of

                     (filename, modulename, funcname,) for functions

                     that were called at least once;  This overrides

                     `count' and `trace'

        @param ignoremods a list of the names of modules to ignore

        @param ignoredirs a list of the names of directories to ignore

                     all of the (recursive) contents of

        @param infile file from which to read stored counts to be

                     added into the results

        @param outfile file in which to write the results

        @param timing true iff timing information be displayed

        """

        self.infile = infile

        self.outfile = outfile

        self.ignore = Ignore(ignoremods, ignoredirs)

        self.counts = {}   # keys are (filename, linenumber)

        self.blabbed = {} # for debugging

        self.pathtobasename = {} # for memoizing os.path.basename

        self.donothing = 0

        self.trace = trace

        self._calledfuncs = {}

        self._callers = {}

        self._caller_cache = {}

        self.start_time = None

        if timing:

            self.start_time = time.time()

        if countcallers:

            self.globaltrace = self.globaltrace_trackcallers

        elif countfuncs:

            self.globaltrace = self.globaltrace_countfuncs

        elif trace and count:

            self.globaltrace = self.globaltrace_lt

            self.localtrace = self.localtrace_trace_and_count

        elif trace:

            self.globaltrace = self.globaltrace_lt

            self.localtrace = self.localtrace_trace

        elif count:

            self.globaltrace = self.globaltrace_lt

            self.localtrace = self.localtrace_count

        else:

            # Ahem -- do nothing?  Okay.

            self.donothing = 1

    def run(self, cmd):

        import __main__

        dict = __main__.__dict__

        if not self.donothing:

            sys.settrace(self.globaltrace)

            threading.settrace(self.globaltrace)

        try:

            exec cmd in dict, dict

        finally:

            if not self.donothing:

                sys.settrace(None)

                threading.settrace(None)

    def runctx(self, cmd, globals=None, locals=None):

        if globals is None: globals = {}

        if locals is None: locals = {}

        if not self.donothing:

            sys.settrace(self.globaltrace)

            threading.settrace(self.globaltrace)

        try:

            exec cmd in globals, locals

        finally:

            if not self.donothing:

                sys.settrace(None)

                threading.settrace(None)

    def runfunc(self, func, *args, **kw):

        result = None

        if not self.donothing:

            sys.settrace(self.globaltrace)

        try:

            result = func(*args, **kw)

        finally:

            if not self.donothing:

                sys.settrace(None)

        return result

    def file_module_function_of(self, frame):