Lib/compiler/__init__.py

   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