1 """Package for parsing and compiling Python source code

     2 

     3 There are several functions defined at the top level that are imported

     4 from modules contained in the package.

     5 

     6 parse(buf, mode="exec") -> AST

     7     Converts a string containing Python source code to an abstract

     8     syntax tree (AST).  The AST is defined in compiler.ast.

     9 

    10 parseFile(path) -> AST

    11     The same as parse(open(path))

    12 

    13 walk(ast, visitor, verbose=None)

    14     Does a pre-order walk over the ast using the visitor instance.

    15     See compiler.visitor for details.

    16 

    17 compile(source, filename, mode, flags=None, dont_inherit=None)

    18     Returns a code object.  A replacement for the builtin compile() function.

    19 

    20 compileFile(filename)

    21     Generates a .pyc file by compiling filename.

    22 """

    23 from warnings import warnpy3k

    24 warnpy3k("the compiler package has been removed in Python 3.0", stacklevel=2)

    25 del warnpy3k

    26 

    27 from compiler.transformer import parse, parseFile

    28 from compiler.visitor import walk

    29 from compiler.pycodegen import compile, compileFile