summaryrefslogtreecommitdiff
path: root/lib/python2.7/compiler/__init__.py
diff options
context:
space:
mode:
Diffstat (limited to 'lib/python2.7/compiler/__init__.py')
-rw-r--r--lib/python2.7/compiler/__init__.py31
1 files changed, 31 insertions, 0 deletions
diff --git a/lib/python2.7/compiler/__init__.py b/lib/python2.7/compiler/__init__.py
new file mode 100644
index 0000000..2a6f64f
--- /dev/null
+++ b/lib/python2.7/compiler/__init__.py
@@ -0,0 +1,31 @@
+"""Package for parsing and compiling Python source code
+
+There are several functions defined at the top level that are imported
+from modules contained in the package.
+
+parse(buf, mode="exec") -> AST
+ Converts a string containing Python source code to an abstract
+ syntax tree (AST). The AST is defined in compiler.ast.
+
+parseFile(path) -> AST
+ The same as parse(open(path))
+
+walk(ast, visitor, verbose=None)
+ Does a pre-order walk over the ast using the visitor instance.
+ See compiler.visitor for details.
+
+compile(source, filename, mode, flags=None, dont_inherit=None)
+ Returns a code object. A replacement for the builtin compile() function.
+
+compileFile(filename)
+ Generates a .pyc file by compiling filename.
+"""
+
+import warnings
+
+warnings.warn("The compiler package is deprecated and removed in Python 3.x.",
+ DeprecationWarning, stacklevel=2)
+
+from compiler.transformer import parse, parseFile
+from compiler.visitor import walk
+from compiler.pycodegen import compile, compileFile