Public facing node documentation

4 files changed, 372 insertions, 0 deletions

diff --git a/doc/api/astroid.exceptions.rst b/doc/api/astroid.exceptions.rst
new file mode 100644
index 00000000..ede67432
--- /dev/null
+++ b/doc/api/astroid.exceptions.rst
@@ -0,0 +1,38 @@
+:mod:`astroid.exceptions`
+=========================
+
+.. automodule:: astroid.exceptions
+
+   .. rubric:: Classes
+
+   .. autosummary::
+
+      BinaryOperationError
+      OperationError
+      UnaryOperationError
+
+   .. rubric:: Exceptions
+
+   .. autosummary::
+
+      AstroidBuildingError
+      AstroidBuildingException
+      AstroidError
+      AstroidImportError
+      AstroidIndexError
+      AstroidSyntaxError
+      AstroidTypeError
+      AttributeInferenceError
+      DuplicateBasesError
+      InconsistentMroError
+      InferenceError
+      MroError
+      NameInferenceError
+      NoDefault
+      NotFoundError
+      ResolveError
+      SuperArgumentTypeError
+      SuperError
+      TooManyLevelsError
+      UnresolvableName
+      UseInferenceDefault
diff --git a/doc/api/astroid.nodes.rst b/doc/api/astroid.nodes.rst
new file mode 100644
index 00000000..84ceba98
--- /dev/null
+++ b/doc/api/astroid.nodes.rst
@@ -0,0 +1,226 @@
+:mod:`astroid.nodes`
+====================
+
+.. automodule:: astroid.nodes
+
+For a list of available nodes see :ref:`nodes`.
+
+.. _nodes:
+
+Nodes
+-----
+.. autosummary::
+
+   AnnAssign
+   Arguments
+   Assert
+   Assign
+   AssignAttr
+   AssignName
+   AsyncFor
+   AsyncFunctionDef
+   AsyncWith
+   Attribute
+   AugAssign
+   Await
+   BinOp
+   BoolOp
+   Break
+   Call
+   ClassDef
+   Compare
+   Comprehension
+   Const
+   Continue
+   Decorators
+   DelAttr
+   DelName
+   Delete
+   Dict
+   DictComp
+   DictUnpack
+   Ellipsis
+   EmptyNode
+   ExceptHandler
+   Exec
+   Expr
+   ExtSlice
+   For
+   FormattedValue
+   FunctionDef
+   GeneratorExp
+   Global
+   If
+   IfExp
+   Import
+   ImportFrom
+   Index
+   JoinedStr
+   Keyword
+   Lambda
+   List
+   ListComp
+   Module
+   Name
+   Nonlocal
+   Pass
+   Print
+   Raise
+   Repr
+   Return
+   Set
+   SetComp
+   Slice
+   Starred
+   Subscript
+   TryExcept
+   TryFinally
+   Tuple
+   UnaryOp
+   Unknown
+   While
+   With
+   Yield
+   YieldFrom
+
+.. autoclass:: AnnAssign
+
+.. autoclass:: Arguments
+
+.. autoclass:: Assert
+
+.. autoclass:: Assign
+
+.. autoclass:: AssignAttr
+
+.. autoclass:: AssignName
+
+.. autoclass:: AsyncFor
+
+.. autoclass:: AsyncFunctionDef
+
+.. autoclass:: AsyncWith
+
+.. autoclass:: Attribute
+
+.. autoclass:: AugAssign
+
+.. autoclass:: Await
+
+.. autoclass:: BinOp
+
+.. autoclass:: BoolOp
+
+.. autoclass:: Break
+
+.. autoclass:: Call
+
+.. autoclass:: ClassDef
+
+.. autoclass:: Compare
+
+.. autoclass:: Comprehension
+
+.. autoclass:: Const
+
+.. autoclass:: Continue
+
+.. autoclass:: Decorators
+
+.. autoclass:: DelAttr
+
+.. autoclass:: DelName
+
+.. autoclass:: Delete
+
+.. autoclass:: Dict
+
+.. autoclass:: DictComp
+
+.. autoclass:: DictUnpack
+
+.. autoclass:: Ellipsis
+
+.. autoclass:: EmptyNode
+
+.. autoclass:: ExceptHandler
+
+.. autoclass:: Exec
+
+.. autoclass:: Expr
+
+.. autoclass:: ExtSlice
+
+.. autoclass:: For
+
+.. autoclass:: FormattedValue
+
+.. autoclass:: FunctionDef
+
+.. autoclass:: GeneratorExp
+
+.. autoclass:: Global
+
+.. autoclass:: If
+
+.. autoclass:: IfExp
+
+.. autoclass:: Import
+
+.. autoclass:: ImportFrom
+
+.. autoclass:: Index
+
+.. autoclass:: JoinedStr
+
+.. autoclass:: Keyword
+
+.. autoclass:: Lambda
+
+.. autoclass:: List
+
+.. autoclass:: ListComp
+
+.. autoclass:: Module
+
+.. autoclass:: Name
+
+.. autoclass:: Nonlocal
+
+.. autoclass:: Pass
+
+.. autoclass:: Print
+
+.. autoclass:: Raise
+
+.. autoclass:: Repr
+
+.. autoclass:: Return
+
+.. autoclass:: Set
+
+.. autoclass:: SetComp
+
+.. autoclass:: Slice
+
+.. autoclass:: Starred
+
+.. autoclass:: Subscript
+
+.. autoclass:: TryExcept
+
+.. autoclass:: TryFinally
+
+.. autoclass:: Tuple
+
+.. autoclass:: UnaryOp
+
+.. autoclass:: Unknown
+
+.. autoclass:: While
+
+.. autoclass:: With
+
+.. autoclass:: Yield
+
+.. autoclass:: YieldFrom
diff --git a/doc/api/astroid.rst b/doc/api/astroid.rst
new file mode 100644
index 00000000..fda60271
--- /dev/null
+++ b/doc/api/astroid.rst
@@ -0,0 +1,64 @@
+:mod:`astroid`
+==============
+
+.. automodule:: astroid
+
+Submodules
+----------
+.. autosummary::
+   :toctree:
+
+   astroid.exceptions
+   astroid.nodes
+
+Exceptions
+----------
+.. currentmodule:: astroid.exceptions
+
+.. autosummary::
+
+   AstroidBuildingError
+   AstroidBuildingException
+   AstroidError
+   AstroidImportError
+   AstroidIndexError
+   AstroidSyntaxError
+   AstroidTypeError
+   AttributeInferenceError
+   BinaryOperationError
+   DuplicateBasesError
+   InconsistentMroError
+   InferenceError
+   MroError
+   NameInferenceError
+   NoDefault
+   NotFoundError
+   OperationError
+   ResolveError
+   SuperArgumentTypeError
+   SuperError
+   TooManyLevelsError
+   UnaryOperationError
+   UnresolvableName
+   UseInferenceDefault
+
+.. currentmodule:: astroid
+
+.. data:: MANAGER
+
+   The manager for doing stuff.
+
+   :type: astroid.manager.AstroidManager
+
+
+.. autoclass:: Uninferable
+
+.. autofunction:: are_exclusive
+
+.. autofunction:: builtin_lookup
+
+.. autofunction:: extract_node
+
+.. autofunction:: parse
+
+.. autofunction:: unpack_infer
diff --git a/doc/api/base_nodes.rst b/doc/api/base_nodes.rst
new file mode 100644
index 00000000..b298caa8
--- /dev/null
+++ b/doc/api/base_nodes.rst
@@ -0,0 +1,44 @@
+Base Nodes
+==========
+
+These are abstract node classes that :ref:`other nodes <nodes>` inherit from.
+
+.. autosummary::
+
+   astroid.mixins.AssignTypeMixin
+   astroid.node_classes._BaseContainer
+   astroid.mixins.BlockRangeMixIn
+   astroid.scoped_nodes.ComprehensionScope
+   astroid.mixins.FilterStmtsMixin
+   astroid.mixins.ImportFromMixin
+   astroid.scoped_nodes._ListComp
+   astroid.scoped_nodes.LocalsDictNodeNG
+   astroid.node_classes.LookupMixIn
+   astroid.node_classes.NodeNG
+   astroid.mixins.ParentAssignTypeMixin
+   astroid.node_classes.Statement
+
+
+.. autoclass:: astroid.mixins.AssignTypeMixin
+
+.. autoclass:: astroid.node_classes._BaseContainer
+
+.. autoclass:: astroid.mixins.BlockRangeMixIn
+
+.. autoclass:: astroid.scoped_nodes.ComprehensionScope
+
+.. autoclass:: astroid.mixins.FilterStmtsMixin
+
+.. autoclass:: astroid.mixins.ImportFromMixin
+
+.. autoclass:: astroid.scoped_nodes._ListComp
+
+.. autoclass:: astroid.scoped_nodes.LocalsDictNodeNG
+
+.. autoclass:: astroid.node_classes.LookupMixIn
+
+.. autoclass:: astroid.node_classes.NodeNG
+
+.. autoclass:: astroid.mixins.ParentAssignTypeMixin
+
+.. autoclass:: astroid.node_classes.Statement