diff options
Diffstat (limited to 'coverage')
| -rw-r--r-- | coverage/plugin.py | 22 | ||||
| -rw-r--r-- | coverage/plugin_support.py | 2 |
2 files changed, 21 insertions, 3 deletions
diff --git a/coverage/plugin.py b/coverage/plugin.py index aa2d2088..5d61e7f8 100644 --- a/coverage/plugin.py +++ b/coverage/plugin.py @@ -204,9 +204,27 @@ class FileReporter(object): return f.read() def source_token_lines(self): - """Return the 'tokenized' text for the code. + """Generate a series of tokenized lines, one for each line in `source`. + + These tokens are used for syntax-colored reports. + + Each line is a list of pairs, each pair is a token:: + + [('key', 'def'), ('ws', ' '), ('nam', 'hello'), ('op', '('), ... ] + + Each pair has a token class, and the token text. The token classes are: + + * `'com'`: a comment + * `'key'`: a keyword + * `'nam'`: a name, or identifier + * `'num'`: a number + * `'op'`: an operator + * `'str'`: a string literal + * `'txt'`: some other kind of text + + If you concatenate all the token texts, and then join them with newlines, + you should have your original `source` back. - 'str', 'nam', 'num', 'key', 'com', 'op' """ # A generic implementation, each line is one "txt" token. for line in self.source().splitlines(): diff --git a/coverage/plugin_support.py b/coverage/plugin_support.py index 8863b435..f88342e9 100644 --- a/coverage/plugin_support.py +++ b/coverage/plugin_support.py @@ -160,7 +160,7 @@ class DebugFileTracerWrapper(FileTracer): return "%s@%d" % ( os.path.basename(frame.f_code.co_filename), frame.f_lineno, - ) + ) def source_filename(self): sfilename = self.tracer.source_filename() |