summaryrefslogtreecommitdiff
path: root/python/astroid/README
diff options
context:
space:
mode:
Diffstat (limited to 'python/astroid/README')
-rw-r--r--python/astroid/README12
1 files changed, 12 insertions, 0 deletions
diff --git a/python/astroid/README b/python/astroid/README
new file mode 100644
index 0000000000..ddfdb8c032
--- /dev/null
+++ b/python/astroid/README
@@ -0,0 +1,12 @@
+The aim of this module is to provide a common base representation of
+python source code for projects such as pychecker, pyreverse,
+pylint... Well, actually the development of this library is essentially
+governed by pylint's needs. It used to be called logilab-astng.
+
+It provides a compatible representation which comes from the `_ast`
+module. It rebuilds the tree generated by the builtin _ast module by
+recursively walking down the AST and building an extended ast. The new
+node classes have additional methods and attributes for different
+usages. They include some support for static inference and local name
+scopes. Furthermore, astroid builds partial trees by inspecting living
+objects.