Home | History | Annotate | Download | only in compiler
      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 
     24 import warnings
     25 
     26 warnings.warn("The compiler package is deprecated and removed in Python 3.x.",
     27               DeprecationWarning, stacklevel=2)
     28 
     29 from compiler.transformer import parse, parseFile
     30 from compiler.visitor import walk
     31 from compiler.pycodegen import compile, compileFile
     32