1"""Package for parsing and compiling Python source code
2
3There are several functions defined at the top level that are imported
4from modules contained in the package.
5
6parse(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
10parseFile(path) -> AST
11    The same as parse(open(path))
12
13walk(ast, visitor, verbose=None)
14    Does a pre-order walk over the ast using the visitor instance.
15    See compiler.visitor for details.
16
17compile(source, filename, mode, flags=None, dont_inherit=None)
18    Returns a code object.  A replacement for the builtin compile() function.
19
20compileFile(filename)
21    Generates a .pyc file by compiling filename.
22"""
23
24import warnings
25
26warnings.warn("The compiler package is deprecated and removed in Python 3.x.",
27              DeprecationWarning, stacklevel=2)
28
29from compiler.transformer import parse, parseFile
30from compiler.visitor import walk
31from compiler.pycodegen import compile, compileFile
32