mpacts.core.units.compat. tokenize

Tokenization help for Python programs.

tokenize(readline) is a generator that breaks a stream of bytes into Python tokens. It decodes the bytes according to PEP-0263 for determining source file encoding.

It accepts a readline-like method which is called repeatedly to get the next line of input (or b”” for EOF). It generates 5-tuples with these members:

the token type (see token.py) the token (a string) the starting (row, column) indices of the token (a 2-tuple of ints) the ending (row, column) indices of the token (a 2-tuple of ints) the original line (string)

It is designed to match the working of the Python tokenizer exactly, except that it produces COMMENT tokens for comments and gives type OP for all operators. Additionally, all token lists start with an ENCODING token which tells you which encoding was used to decode the bytes stream.

In order to be able to use this module import it like this:

import mpacts.core.units.compat.tokenize
#or assign it to a shorter name
import mpacts.core.units.compat.tokenize as tok

StopTokenizing

class mpacts.core.units.compat.tokenize.StopTokenizing

Bases: exceptions.Exception

StopTokenizing(name, parent, **kwargs)

TokenError

class mpacts.core.units.compat.tokenize.TokenError

Bases: exceptions.Exception

TokenError(name, parent, **kwargs)

TokenInfo

class mpacts.core.units.compat.tokenize.TokenInfo

Bases: mpacts.core.units.compat.tokenize.TokenInfo

TokenInfo(name, parent, **kwargs)
exact_type
mpacts.core.units.compat.tokenize._compile(expr)
mpacts.core.units.compat.tokenize._get_normal_name(orig_enc)

Imitates get_normal_name in tokenizer.c.

mpacts.core.units.compat.tokenize._tokenize(readline, encoding)
mpacts.core.units.compat.tokenize.any(*choices)
mpacts.core.units.compat.tokenize.detect_encoding(readline)

The detect_encoding() function is used to detect the encoding that should be used to decode a Python source file. It requires one argument, readline, in the same way as the tokenize() generator.

It will call readline a maximum of twice, and return the encoding used (as a string) and a list of any lines (left as bytes) it has read in.

It detects the encoding from the presence of a utf-8 bom or an encoding cookie as specified in pep-0263. If both a bom and a cookie are present, but disagree, a SyntaxError will be raised. If the encoding cookie is an invalid charset, raise a SyntaxError. Note that if a utf-8 bom is found, ‘utf-8-sig’ is returned.

If no encoding is specified, then the default of ‘utf-8’ will be returned.

mpacts.core.units.compat.tokenize.group(*choices)
mpacts.core.units.compat.tokenize.isidentifier(s)
mpacts.core.units.compat.tokenize.maybe(*choices)
mpacts.core.units.compat.tokenize.open(filename)

Open a file in read only mode using the encoding detected by detect_encoding().

mpacts.core.units.compat.tokenize.tokenize(readline)

The tokenize() generator requires one argment, readline, which must be a callable object which provides the same interface as the readline() method of built-in file objects. Each call to the function should return one line of input as bytes. Alternately, readline can be a callable function terminating with StopIteration:

readline = open(myfile, ‘rb’).__next__ # Example of alternate readline

The generator produces 5-tuples with these members: the token type; the token string; a 2-tuple (srow, scol) of ints specifying the row and column where the token begins in the source; a 2-tuple (erow, ecol) of ints specifying the row and column where the token ends in the source; and the line on which the token was found. The line passed is the logical line; continuation lines are included.

The first token sequence will always be an ENCODING token which tells you which encoding was used to decode the bytes stream.

mpacts.core.units.compat.tokenize.untokenize(iterable)

Transform tokens back into Python source code. It returns a bytes object, encoded using the ENCODING token, which is the first token sequence output by tokenize.

Each element returned by the iterable must be a token sequence with at least two elements, a token number and token value. If only two tokens are passed, the resulting output is poor.

Round-trip invariant for full input:
Untokenized source will match input source exactly
Round-trip invariant for limited intput:
# Output bytes will tokenize the back to the input t1 = [tok[:2] for tok in tokenize(f.readline)] newcode = untokenize(t1) readline = BytesIO(newcode).readline t2 = [tok[:2] for tok in tokenize(readline)] assert t1 == t2