From 6dd7114e47a7520e62c1175f9b5e5094d18887cd Mon Sep 17 00:00:00 2001
From: jchanvfx <jjohnnycchan@gmail.com>
Date: Wed, 8 Jan 2020 20:36:30 +1300
Subject: [PATCH 1/6] updated example docs.

---
 NodeGraphQt/__init__.py                       |  54 +++++-----
 NodeGraphQt/base/graph.py                     |  65 +++++++++---
 NodeGraphQt/base/menu.py                      |  36 +------
 NodeGraphQt/base/node.py                      |   6 +-
 NodeGraphQt/base/utils.py                     |   9 +-
 docs/_images/selection.png                    | Bin 0 -> 55263 bytes
 docs/constants.rst                            |   1 -
 docs/examples/ex_index.rst                    |  16 +++
 docs/examples/ex_menu.rst                     | 100 ++++++++++++++++++
 docs/examples/ex_node.rst                     |   2 +
 .../ex_overview.rst}                          |  60 ++++++-----
 docs/graph.rst                                |   6 +-
 docs/index.rst                                |   8 +-
 docs/menu.rst                                 |  48 ++-------
 docs/nodes/NodeObject.rst                     |  37 +++++--
 15 files changed, 289 insertions(+), 159 deletions(-)
 create mode 100644 docs/_images/selection.png
 create mode 100644 docs/examples/ex_index.rst
 create mode 100644 docs/examples/ex_menu.rst
 create mode 100644 docs/examples/ex_node.rst
 rename docs/{overview.rst => examples/ex_overview.rst} (79%)

diff --git a/NodeGraphQt/__init__.py b/NodeGraphQt/__init__.py
index aa004d71..ba7ba753 100644
--- a/NodeGraphQt/__init__.py
+++ b/NodeGraphQt/__init__.py
@@ -30,45 +30,47 @@
 # OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 # EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 """
-NodeGraphQt is a node graph framework that can be implemented and re purposed
-into applications that supports PySide2.
+**NodeGraphQt** is a node graph framework that can be implemented and re purposed
+into applications that supports **PySide2**.
 
-url: https://github.com/jchanvfx/NodeGraphQt
-docs: http://chantasticvfx.com/nodeGraphQt/html/index.html
+project: https://github.com/jchanvfx/NodeGraphQt
 
-Basic Example:
+example code:
 
-import sys
-from NodeGraphQt import QtWidgets, NodeGraph, BaseNode
+.. code-block:: python
+    :linenos:
 
+    import sys
+    from NodeGraphQt import QtWidgets, NodeGraph, BaseNode
 
-class MyNode(BaseNode):
 
-    __identifier__ = 'com.chantasticvfx'
-    NODE_NAME = 'My Node'
+    class MyNode(BaseNode):
 
-    def __init__(self):
-        super(MyNode, self).__init__()
-        self.add_input('foo', color=(180, 80, 0))
-        self.add_output('bar')
+        __identifier__ = 'com.chantasticvfx'
+        NODE_NAME = 'My Node'
 
-if __name__ == '__main__':
-    app = QtWidgets.QApplication(sys.argv)
-    graph = NodeGraph()
+        def __init__(self):
+            super(MyNode, self).__init__()
+            self.add_input('foo', color=(180, 80, 0))
+            self.add_output('bar')
 
-    graph.register_node(BaseNode)
-    graph.register_node(BackdropNode)
+    if __name__ == '__main__':
+        app = QtWidgets.QApplication(sys.argv)
+        graph = NodeGraph()
 
-    backdrop = graph.create_node('nodeGraphQt.nodes.Backdrop', name='Backdrop')
-    node_a = graph.create_node('com.chantasticvfx.MyNode', name='Node A')
-    node_b = graph.create_node('com.chantasticvfx.MyNode', name='Node B', color='#5b162f')
+        graph.register_node(BaseNode)
+        graph.register_node(BackdropNode)
 
-    node_a.set_input(0, node_b.output(0))
+        backdrop = graph.create_node('nodeGraphQt.nodes.Backdrop', name='Backdrop')
+        node_a = graph.create_node('com.chantasticvfx.MyNode', name='Node A')
+        node_b = graph.create_node('com.chantasticvfx.MyNode', name='Node B', color='#5b162f')
 
-    viewer = graph.viewer()
-    viewer.show()
+        node_a.set_input(0, node_b.output(0))
 
-    app.exec_()
+        viewer = graph.viewer()
+        viewer.show()
+
+        app.exec_()
 """
 
 try:
diff --git a/NodeGraphQt/base/graph.py b/NodeGraphQt/base/graph.py
index ba406d98..da091170 100644
--- a/NodeGraphQt/base/graph.py
+++ b/NodeGraphQt/base/graph.py
@@ -32,22 +32,61 @@ class NodeGraph(QtCore.QObject):
         :width: 60%
     """
 
-    #:QtCore.Signal: emits the node object when a node is created in the node graph.
     node_created = QtCore.Signal(NodeObject)
-    #:QtCore.Signal: emits a ``list[str]`` of node ids from the deleted nodes.
+    """
+    Signal triggered when a node is created in the node graph.
+    
+    :parameters: :class:`NodeGraphQt.NodeObject`
+    :emits: created node
+    """
     nodes_deleted = QtCore.Signal(list)
-    #:QtCore.Signal: emits the node object when selected in the node graph.
+    """
+    Signal triggered when nodes have been deleted from the node graph.
+
+    :parameters: list[str]
+    :emits: list of deleted node ids.
+    """
     node_selected = QtCore.Signal(NodeObject)
-    #:QtCore.Signal: triggered when a node is double clicked and emits the node.
+    """
+    Signal triggered when a node is clicked with the LMB.
+    
+    :parameters: :class:`NodeGraphQt.NodeObject`
+    :emits: selected node
+    """
     node_double_clicked = QtCore.Signal(NodeObject)
-    #:QtCore.Signal: for when a node has been connected emits (``input port``, ``output port``).
+    """
+    Signal triggered when a node is double clicked and emits the node.
+
+    :parameters: :class:`NodeGraphQt.NodeObject`
+    :emits: selected node
+    """
     port_connected = QtCore.Signal(Port, Port)
-    #:QtCore.Signal: for when a node has been disconnected emits (``input port``, ``output port``).
+    """
+    Signal triggered when a node port has been connected.
+
+    :parameters: :class:`NodeGraphQt.Port`, :class:`NodeGraphQt.Port` 
+    :emits: input port, output port
+    """
     port_disconnected = QtCore.Signal(Port, Port)
-    #:QtCore.Signal: for when a node property has changed emits (``node``, ``property name``, ``property value``).
+    """
+    Signal triggered when a node port has been disconnected.
+
+    :parameters: :class:`NodeGraphQt.Port`, :class:`NodeGraphQt.Port` 
+    :emits: input port, output port
+    """
     property_changed = QtCore.Signal(NodeObject, str, object)
-    #:QtCore.Signal: for when drop data has been added to the graph.
+    """
+    Signal is triggered when a property has changed on a node.  
+
+    :parameters: :class:`NodeGraphQt.BaseNode`, str, object
+    :emits: triggered node, property name, property value
+    """
     data_dropped = QtCore.Signal(QtCore.QMimeData, QtCore.QPoint)
+    """
+    Signal is triggered when data has been dropped to the graph.
+    
+    :parameters: :class:`PySide2.QtCore.QMimeData`, :class:`PySide2.QtCore.QPoint`
+    """
 
     def __init__(self, parent=None):
         super(NodeGraph, self).__init__(parent)
@@ -237,7 +276,7 @@ def widget(self):
         The node graph widget for adding into a layout.
 
         Returns:
-            QtWidgets.QWidget: node graph widget.
+            PySide2.QtWidgets.QWidget: node graph widget.
         """
         if self._widget is None:
             self._widget = QtWidgets.QWidget()
@@ -249,16 +288,16 @@ def widget(self):
     def show(self):
         """
         Show node graph widget this is just a convenience
-        function to :meth:`NodeGraph.widget().show()`.
+        function to :meth:`NodeGraph.widget.show()`.
         """
-        self._widget.show()
+        self.widget.show()
 
     def close(self):
         """
         Close node graph NodeViewer widget this is just a convenience
-        function to :meth:`NodeGraph.widget().close()`.
+        function to :meth:`NodeGraph.widget.close()`.
         """
-        self._widget.close()
+        self.widget.close()
 
     def viewer(self):
         """
diff --git a/NodeGraphQt/base/menu.py b/NodeGraphQt/base/menu.py
index 58ee0b0b..66c57b73 100644
--- a/NodeGraphQt/base/menu.py
+++ b/NodeGraphQt/base/menu.py
@@ -8,7 +8,7 @@
 
 class NodeGraphMenu(object):
     """
-    The ``NodeGraphMenu`` is the context menu triggered from the node graph.
+    The ``NodeGraphMenu`` is the main context menu triggered from the node graph.
 
     example for accessing the node graph context menu.
 
@@ -22,8 +22,6 @@ class NodeGraphMenu(object):
         # get the context menu for the node graph.
         context_menu = node_graph.get_context_menu('graph')
 
-        print(context_menu)
-        # >> <NodeGraphMenu("NodeGraph") object at 0x10910fdd8>
     """
 
     def __init__(self, graph, qmenu):
@@ -146,45 +144,21 @@ def add_separator(self):
 
 class NodesMenu(NodeGraphMenu):
     """
-    The ``NodesMenu`` is the context menu triggered from the nodes.
+    The ``NodesMenu`` is the context menu triggered from a node.
 
     **Inherited from:** :class:`NodeGraphQt.NodeGraphMenu`
 
-    example for adding a command to the nodes context menu.
+    example for accessing the nodes context menu.
 
     .. code-block:: python
         :linenos:
 
-        from NodeGraphQt import BaseNode, NodeGraph
-
-        # example node.
-        class MyNode(BaseNode):
-
-            __identifier__ = 'com.chantasticvfx'
-            NODE_NAME = 'my node'
-
-            def __init__(self):
-                super(MyNode, self).__init__()
-                self.add_input('in')
-                self.add_output('out')
+        from NodeGraphQt import NodeGraph
 
-        # create node graph.
         node_graph = NodeGraph()
 
-        # register example node.
-        node_graph.register_node(MyNode)
-
-        # get the context menu for the nodes.
+        # get the nodes context menu.
         nodes_menu = node_graph.get_context_menu('nodes')
-
-        # create a command
-        def test_func(graph, node):
-            print('Clicked on node: {}'.format(node.name()))
-
-        nodes_menu.add_command('test',
-                               func=test_func,
-                               node_type='com.chantasticvfx.MyNode')
-
     """
 
     def add_command(self, name, func=None, node_type=None):
diff --git a/NodeGraphQt/base/node.py b/NodeGraphQt/base/node.py
index 22509444..b8a8114c 100644
--- a/NodeGraphQt/base/node.py
+++ b/NodeGraphQt/base/node.py
@@ -36,10 +36,10 @@ class NodeObject(object):
         qgraphics_item (AbstractNodeItem): graphic item used for drawing.
     """
 
-    #:str: unique node identifier domain.
+    # Unique node identifier domain. `eg.` ``"com.chantacticvfx"``
     __identifier__ = 'nodeGraphQt.nodes'
 
-    #:str: base node name.
+    # Base node name.
     NODE_NAME = None
 
     def __init__(self, qgraphics_item=None):
@@ -61,7 +61,7 @@ def __repr__(self):
     def type_(cls):
         """
         Node type identifier followed by the class name.
-        eg. nodeGraphQt.nodes.MyNode
+        `eg.` ``"com.chantacticvfx.NodeObject"``
 
         Returns:
             str: node type.
diff --git a/NodeGraphQt/base/utils.py b/NodeGraphQt/base/utils.py
index 2d384f64..bc677b0f 100644
--- a/NodeGraphQt/base/utils.py
+++ b/NodeGraphQt/base/utils.py
@@ -6,7 +6,9 @@
 
 def setup_context_menu(graph):
     """
-    Sets up the node graphs context menu with some basic menus and commands.
+    populate the specified graph's context menu with essential menus commands.
+
+    example code:
 
     .. code-block:: python
         :linenos:
@@ -16,6 +18,11 @@ def setup_context_menu(graph):
         graph = NodeGraph()
         setup_context_menu(graph)
 
+    result:
+
+    .. image:: _images/menu_hotkeys.png
+        :width: 300px
+
     Args:
         graph (NodeGraphQt.NodeGraph): node graph.
     """
diff --git a/docs/_images/selection.png b/docs/_images/selection.png
new file mode 100644
index 0000000000000000000000000000000000000000..de08904b28b626fb282cbecf81839a6ef1ba541a
GIT binary patch
literal 55263
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
A8vp<R

literal 0
HcmV?d00001

diff --git a/docs/constants.rst b/docs/constants.rst
index 8bdcb729..3c0b225d 100644
--- a/docs/constants.rst
+++ b/docs/constants.rst
@@ -4,4 +4,3 @@ Constants
 .. automodule:: NodeGraphQt.constants
     :members:
     :member-order: bysource
-    :noindex:
diff --git a/docs/examples/ex_index.rst b/docs/examples/ex_index.rst
new file mode 100644
index 00000000..4eae9919
--- /dev/null
+++ b/docs/examples/ex_index.rst
@@ -0,0 +1,16 @@
+Examples
+########
+
+.. image:: ../_images/overview.png
+    :width: 70%
+
+----
+
+.. toctree::
+    :name: examplestoc
+    :maxdepth: 3
+
+    ex_overview
+    ex_menu
+    ex_node
+
diff --git a/docs/examples/ex_menu.rst b/docs/examples/ex_menu.rst
new file mode 100644
index 00000000..717010e2
--- /dev/null
+++ b/docs/examples/ex_menu.rst
@@ -0,0 +1,100 @@
+Menu Examples
+#############
+
+Examples for customizing context menus in NodeGraphQt.
+
+Default Menu Setup
+******************
+
+The NodeGraphQt module has a convenience function for setting up the node graph
+with a few essential menu commands.
+
+`See function:` :func:`NodeGraphQt.setup_context_menu`
+
+.. image:: ../_images/menu_hotkeys.png
+    :width: 300px
+
+Adding to the Graph Menu
+************************
+
+The ``"graph"`` menu is the main context menu from the NodeGraph object, below
+is an example where we add a ``"Foo"`` menu and then a ``"Bar"`` command with
+the registered ``my_test()`` function.
+
+.. code-block:: python
+    :linenos:
+
+    from NodeGraphQt import NodeGraph
+
+    # test function.
+    def my_test(graph):
+        selected_nodes = graph.selected_nodes()
+        print('Number of nodes selected: {}'.format(len(selected_nodes)))
+
+    # create node graph.
+    node_graph = NodeGraph()
+
+    # get the main context menu.
+    context_menu = node_graph.get_context_menu('graph')
+
+    # add a menu called "Foo".
+    foo_menu = context_menu.add_menu('Foo')
+
+    # add "Bar" command to the "Foo" menu.
+    # we also assign a short cut key "Shift+t" for this example.
+    foo_menu.add_command('Bar', my_test, 'Shift+t')
+
+Adding to the Nodes Menu
+************************
+
+Aside from the main context menu, the NodeGraph also has a nodes menu where you
+can override context menus on a per node type basis.
+
+Below is an example for overriding a context menu for the node type ``"com.chantasticvfx.FooNode"``
+
+.. code-block:: python
+    :linenos:
+
+    from NodeGraphQt import BaseNode, NodeGraph, setup_context_menu
+
+    # define a couple example nodes.
+    class FooNode(BaseNode):
+
+        __identifier__ = 'com.chantasticvfx'
+        NODE_NAME = 'foo node'
+
+        def __init__(self):
+            super(FooNode, self).__init__()
+            self.add_input('in')
+            self.add_output('out')
+
+    class BarNode(FooNode):
+
+        NODE_NAME = 'bar node'
+
+    # define a test function.
+    def test_func(graph, node):
+        print('Clicked on node: {}'.format(node.name()))
+
+    # create node graph and register node classes.
+    node_graph = NodeGraph()
+    node_graph.register_node(FooNode)
+    node_graph.register_node(BarNode)
+
+    # set up default menu commands.
+    setup_context_menu(node_graph)
+
+    # get the nodes menu.
+    nodes_menu = node_graph.get_context_menu('nodes')
+
+    # here we add override the context menu for "com.chantasticvfx.FooNode".
+    nodes_menu.add_command('Test',
+                           func=test_func,
+                           node_type='com.chantasticvfx.FooNode')
+
+    # create some nodes.
+    foo_node = graph.create_node('com.chantasticvfx.FooNode')
+    bar_node = graph.create_node('com.chantasticvfx.BarNode', pos=[300, 100])
+
+    # show widget.
+    node_graph.widget.show()
\ No newline at end of file
diff --git a/docs/examples/ex_node.rst b/docs/examples/ex_node.rst
new file mode 100644
index 00000000..df79d54e
--- /dev/null
+++ b/docs/examples/ex_node.rst
@@ -0,0 +1,2 @@
+Node Examples
+#############
diff --git a/docs/overview.rst b/docs/examples/ex_overview.rst
similarity index 79%
rename from docs/overview.rst
rename to docs/examples/ex_overview.rst
index aa173c31..073c61fc 100644
--- a/docs/overview.rst
+++ b/docs/examples/ex_overview.rst
@@ -1,10 +1,7 @@
-Overview
-########
+Graph UI Overview
+#################
 
-NodeGraphQt is a node graph framework that can be implemented and repurposed into applications that supports ``PySide2``.
-
-.. image:: _images/overview.png
-    :width: 70%
+User interface overview for the node graph.
 
 Navigation
 **********
@@ -17,28 +14,21 @@ Navigation
 | Pan           | *Alt + LMB + Drag* or *MMB + Drag*           |
 +---------------+----------------------------------------------+
 
-Port Connections
-****************
+Node Selection
+**************
 
-.. image:: _images/slicer.png
-    :width: 600px
+.. image:: ../_images/selection.png
+    :width: 500px
 
-Connection pipes can be disconnected easily with the built in slice tool.
+Nodes can be selected/unselected with the selection marquee using LMB + Drag
 
-+---------------------+----------------------------+
-| action              | controls                   |
-+=====================+============================+
-| Slice connections   | *Alt + Shift + LMB + Drag* |
-+---------------------+----------------------------+
-
-
-Node Search
-***********
+Tab Search
+**********
 
-.. image:: _images/node_search.png
+.. image:: ../_images/node_search.png
     :width: 269px
 
-Node can be created with the tab node search widget.
+Nodes registered in the node graph can be created with the tab search widget.
 
 +-------------------+--------+
 | action            | hotkey |
@@ -46,16 +36,25 @@ Node can be created with the tab node search widget.
 | Toggle Visibility | *Tab*  |
 +-------------------+--------+
 
+Pipe Slicing
+************
 
-Example
-*******
+.. image:: ../_images/slicer.png
+    :width: 600px
 
-Here's a basic example for creating two nodes and connecting them together.
+Connection pipes can be disconnected easily with the built in slice tool.
 
-.. image:: _images/example_result.png
-    :width: 60%
++---------------------+----------------------------+
+| action              | controls                   |
++=====================+============================+
+| Slice connections   | *Alt + Shift + LMB + Drag* |
++---------------------+----------------------------+
+
+
+Basic Example
+*************
 
-example code:
+Here's a basic example snippet for creating two nodes and connecting them together.
 
 .. code-block:: python
     :linenos:
@@ -108,3 +107,8 @@ example code:
         node_a.set_output(0, node_b.input(2))
 
         app.exec_()
+
+result:
+
+.. image:: ../_images/example_result.png
+    :width: 60%
\ No newline at end of file
diff --git a/docs/graph.rst b/docs/graph.rst
index dc224591..ff973465 100644
--- a/docs/graph.rst
+++ b/docs/graph.rst
@@ -5,7 +5,5 @@ NodeGraph
     :members:
     :exclude-members: model, widget
 
-----
-
-.. autoattribute:: NodeGraphQt.NodeGraph.widget
-.. autoattribute:: NodeGraphQt.NodeGraph.model
+    .. autoattribute:: NodeGraphQt.NodeGraph.widget
+    .. autoattribute:: NodeGraphQt.NodeGraph.model
diff --git a/docs/index.rst b/docs/index.rst
index b9ab4dbf..45870e80 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,7 +1,7 @@
-NodeGraphQt
-###########
+NodeGraphQt API
+###############
 
-Welcome to the ``NodeGraphQt`` documentation.
+Welcome to the NodeGraphQt documentation.
 
 .. image:: _images/screenshot.png
     :width: 95%
@@ -14,9 +14,9 @@ Project Repo: https://github.com/jchanvfx/NodeGraphQt
     :name: mastertoc
     :maxdepth: 3
 
-    overview
     constants
     graph
     nodes
     menu
     widgets
+    examples/ex_index
diff --git a/docs/menu.rst b/docs/menu.rst
index e0ca7463..b8f90309 100644
--- a/docs/menu.rst
+++ b/docs/menu.rst
@@ -1,52 +1,22 @@
 Menus
 #####
 
-.. image:: _images/menu_hotkeys.png
-    :width: 50%
+.. currentmodule:: NodeGraphQt
 
+Setup Context Menu
+******************
 
-Here's an example where we add a ``"Foo"`` menu and then a ``"Bar"`` command with
-the function ``my_test()`` registered.
-
-.. code-block:: python
-    :linenos:
-
-    from NodeGraphQt import NodeGraph
-
-    # test function.
-    def my_test(graph):
-        selected_nodes = graph.selected_nodes()
-        print('Number of nodes selected: {}'.format(len(selected_nodes)))
-
-    # create node graph.
-    graph = NodeGraph()
-
-    # get the main context menu.
-    context_menu = node_graph.get_context_menu('graph')
-
-    # add a menu called "Foo".
-    foo_menu = context_menu.add_menu('Foo')
-
-    # add "Bar" command to the "Foo" menu.
-    # we also assign a short cut key "Shift+t" for this example.
-    foo_menu.add_command('Bar', my_test, 'Shift+t')
-
-----
-
-The ``NodeGraphQt.setup_context_menu`` is a built in function that'll populate
-the node graphs context menu a few default menus and commands.
-
-
-.. autofunction:: NodeGraphQt.setup_context_menu
-    :noindex:
+The ``setup_context_menu`` is a convenience function that'll populate the main
+context menu on node graph.
 
+.. autofunction:: setup_context_menu
 
 Graph Menu
 **********
 
 The context menu triggered from the node graph.
 
-.. autoclass:: NodeGraphQt.NodeGraphMenu
+.. autoclass:: NodeGraphMenu
     :members:
 
 
@@ -55,12 +25,12 @@ Nodes Menu
 
 The context menu triggered from a node.
 
-.. autoclass:: NodeGraphQt.NodesMenu
+.. autoclass:: NodesMenu
     :members:
 
 
 Command
 *******
 
-.. autoclass:: NodeGraphQt.NodeGraphCommand
+.. autoclass:: NodeGraphCommand
     :members:
diff --git a/docs/nodes/NodeObject.rst b/docs/nodes/NodeObject.rst
index eeb628a6..b101a1e2 100644
--- a/docs/nodes/NodeObject.rst
+++ b/docs/nodes/NodeObject.rst
@@ -5,12 +5,31 @@ NodeObject
     :members:
     :exclude-members: NODE_NAME, graph, id, model, type_, view
 
-----
-
-.. autoattribute:: NodeGraphQt.NodeObject.type_
-.. autoattribute:: NodeGraphQt.NodeObject.__identifier__
-.. autoattribute:: NodeGraphQt.NodeObject.NODE_NAME
-.. autoattribute:: NodeGraphQt.NodeObject.graph
-.. autoattribute:: NodeGraphQt.NodeObject.id
-.. autoattribute:: NodeGraphQt.NodeObject.model
-.. autoattribute:: NodeGraphQt.NodeObject.view
+    .. autoattribute:: NODE_NAME
+        :annotation: = (re-implementation required)
+
+        Initial base node name.
+
+        :return: node name
+        :rtype: str
+
+    .. autoattribute:: __identifier__
+        :annotation: = (re-implementation required)
+
+        Unique node identifier domain. eg. ``"com.chantacticvfx"``
+
+        :return: node identifer domain
+        :rtype: str
+
+    .. autoattribute:: graph
+    .. autoattribute:: id
+    .. autoattribute:: model
+    .. autoattribute:: type_
+        :annotation: = (__identifier__.__className__)
+
+        Node type identifier followed by the class name. `eg.` ``"com.chantacticvfx.NodeObject"``
+
+        :return: node type
+        :rtype: str
+
+    .. autoattribute:: view

From 1bd4cc7af0c0cf1f9a6e543505a461608d2a8e0c Mon Sep 17 00:00:00 2001
From: jchanvfx <jjohnnycchan@gmail.com>
Date: Wed, 8 Jan 2020 23:34:16 +1300
Subject: [PATCH 2/6] menu doc updates.

---
 NodeGraphQt/base/menu.py  |  6 +--
 docs/examples/ex_node.rst | 81 +++++++++++++++++++++++++++++++++++++++
 docs/menu.rst             |  2 +
 docs/widgets.rst          |  8 ++--
 4 files changed, 90 insertions(+), 7 deletions(-)

diff --git a/NodeGraphQt/base/menu.py b/NodeGraphQt/base/menu.py
index 66c57b73..ac437aab 100644
--- a/NodeGraphQt/base/menu.py
+++ b/NodeGraphQt/base/menu.py
@@ -122,7 +122,7 @@ def add_command(self, name, func=None, shortcut=None):
             shortcut (str): shotcut key.
 
         Returns:
-            NodeGraphQt.MenuCommand: the appended command.
+            NodeGraphQt.NodeGraphCommand: the appended command.
         """
         action = GraphAction(name, self._graph.viewer())
         action.graph = self._graph
@@ -171,7 +171,7 @@ def add_command(self, name, func=None, node_type=None):
             node_type (str): specified node type for the command.
 
         Returns:
-            NodeGraphQt.MenuCommand: the appended command.
+            NodeGraphQt.NodeGraphCommand: the appended command.
         """
         if not node_type:
             raise NodeMenuError('Node type not specified!')
@@ -213,7 +213,7 @@ def qaction(self):
         The underlying qaction.
 
         Returns:
-            BaseAction: qaction object.
+            GraphAction: qaction object.
         """
         return self._qaction
 
diff --git a/docs/examples/ex_node.rst b/docs/examples/ex_node.rst
index df79d54e..5d47a2d0 100644
--- a/docs/examples/ex_node.rst
+++ b/docs/examples/ex_node.rst
@@ -1,2 +1,83 @@
 Node Examples
 #############
+
+Creating Nodes
+**************
+
+| Creating is done simply by calling the :func:`NodeGraphQt.NodeGraph.create_node` function.
+| (`see example below` ``line22``)
+
+.. code-block:: python
+    :linenos:
+
+    from NodeGraphQt import BaseNode, NodeGraph, QtWidgets
+
+    class MyNode(BaseNode):
+
+        __identifier__ = 'com.chantasticvfx'
+        NODE_NAME = 'my node'
+
+        def __init__(self):
+            super(MyNode, self).__init__()
+            self.add_input('foo')
+            self.add_input('hello')
+            self.add_output('bar')
+            self.add_output('world')
+
+    if __name__ == '__main__':
+        app = QtWidgets.QApplication([])
+
+        node_graph = NodeGraph()
+        node_graph.register_node(MyNode)
+        node_graph.widget.show()
+
+        # here we create a couple nodes in the node graph.
+        node_a = node_graph.create_node('com.chantasticvfx.MyNode', name='node a')
+        node_b = node_graph.create_node('com.chantasticvfx.MyNode', name='node b', pos=[300, 100])
+
+        app.exec_()
+
+
+Connecting Nodes
+****************
+
+There a multiple ways for connecting node ports here are a few examples below.
+
+connecting nodes by the port index:
+
+.. code-block:: python
+
+    node_b.set_input(0, node_a.output(0))
+
+connect nodes by the port name:
+
+.. code-block:: python
+
+    node_a.outputs()['bar'].connect_to(node_b.inputs()['foo'])
+
+connecting nodes with the port objects:
+
+.. code-block:: python
+
+    # node_a "bar" output port.
+    port_a = node_a.output(0)
+    # node_b "foo" input port.
+    port_b = node_b.inputs()['foo']
+    # make the connection.
+    port_a.connect_to(port_b)
+
+
+See functions:
+    - :func:`NodeGraphQt.BaseNode.input`,
+    - :func:`NodeGraphQt.BaseNode.output`
+    - :func:`NodeGraphQt.BaseNode.set_input`,
+    - :func:`NodeGraphQt.BaseNode.set_output`,
+    - :func:`NodeGraphQt.BaseNode.inputs`,
+    - :func:`NodeGraphQt.BaseNode.outputs`
+    - :func:`NodeGraphQt.Port.connect_to`,
+    - :func:`NodeGraphQt.Port.disconnect_from`
+
+
+Properties Bin Setup
+********************
+
diff --git a/docs/menu.rst b/docs/menu.rst
index b8f90309..115208d6 100644
--- a/docs/menu.rst
+++ b/docs/menu.rst
@@ -18,6 +18,7 @@ The context menu triggered from the node graph.
 
 .. autoclass:: NodeGraphMenu
     :members:
+    :exclude-members: qmenu
 
 
 Nodes Menu
@@ -34,3 +35,4 @@ Command
 
 .. autoclass:: NodeGraphCommand
     :members:
+    :exclude-members: qaction
diff --git a/docs/widgets.rst b/docs/widgets.rst
index ab727ad8..32d76e61 100644
--- a/docs/widgets.rst
+++ b/docs/widgets.rst
@@ -2,8 +2,8 @@ Widgets
 #######
 
 
-PropertiesBinWidget
-*******************
+Properties Bin
+**************
 
 The ``PropertiesBinWidget`` is a list widget for displaying and editing a
 nodes properties.
@@ -31,8 +31,8 @@ example
     :members:
     :exclude-members: property_changed
 
-NodeTreeWidget
-**************
+Nodes Tree
+**********
 
 The ``NodeTreeWidget`` is a widget for displaying all registered nodes from the
 node graph with this widget a user can create nodes by dragging and dropping.

From 765e63e584fa8746c23f591c09f6025bbf88d704 Mon Sep 17 00:00:00 2001
From: jchanvfx <jjohnnycchan@gmail.com>
Date: Thu, 9 Jan 2020 00:05:28 +1300
Subject: [PATCH 3/6] added properties bin example

---
 docs/examples/ex_node.rst | 61 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 58 insertions(+), 3 deletions(-)

diff --git a/docs/examples/ex_node.rst b/docs/examples/ex_node.rst
index 5d47a2d0..9da94f28 100644
--- a/docs/examples/ex_node.rst
+++ b/docs/examples/ex_node.rst
@@ -67,7 +67,7 @@ connecting nodes with the port objects:
     port_a.connect_to(port_b)
 
 
-See functions:
+more on ports and connections:
     - :func:`NodeGraphQt.BaseNode.input`,
     - :func:`NodeGraphQt.BaseNode.output`
     - :func:`NodeGraphQt.BaseNode.set_input`,
@@ -78,6 +78,61 @@ See functions:
     - :func:`NodeGraphQt.Port.disconnect_from`
 
 
-Properties Bin Setup
-********************
+Widget Example
+**************
+
+Here's an example where we subclass the ``NodeGraph`` and connect it up to a
+``PropertiesBinWidget`` and have it show when a node is double clicked.
+
+.. code-block:: python
+    :linenos:
+
+    from NodeGraphQt import BaseNode, NodeGraph, PropertiesBinWidget, QtCore, QtWidgets
+
+
+    class MyNode(BaseNode):
+
+        __identifier__ = 'com.chantasticvfx'
+        NODE_NAME = 'my node'
+
+        def __init__(self):
+            super(MyNode, self).__init__()
+            self.add_input('in')
+            self.add_output('out')
+
+
+    class MyNodeGraph(NodeGraph):
+
+        def __init__(self, parent=None):
+            super(MyNodeGraph, self).__init__(parent)
+
+            # properties bin widget.
+            self._prop_bin = PropertiesBinWidget(node_graph=self)
+            self._prop_bin.setWindowFlags(QtCore.Qt.Tool)
+
+            # wire signal.
+            self.node_double_clicked.connect(self.display_prop_bin)
+
+        def display_prop_bin(self, node):
+            """
+            function for displaying the properties bin when a node
+            is double clicked
+            """
+            if not self._prop_bin.isVisible():
+                self._prop_bin.show()
+
+
+    if __name__ == '__main__':
+        app = QtWidgets.QApplication([])
+
+        node_graph = MyNodeGraph()
+        node_graph.register_node(MyNode)
+        node_graph.widget.show()
+
+        node_a = node_graph.create_node('com.chantasticvfx.MyNode')
+
+        app.exec_()
 
+more on the properties bin and node_double_clicked signal:
+    - :class:`NodeGraphQt.PropertiesBinWidget`
+    - :attr:`NodeGraphQt.NodeGraph.node_double_clicked`
\ No newline at end of file

From fae527e7b783b361c5131893a048b5c7d3304d11 Mon Sep 17 00:00:00 2001
From: jchanvfx <jjohnnycchan@gmail.com>
Date: Thu, 9 Jan 2020 01:13:32 +1300
Subject: [PATCH 4/6] toc updates

---
 docs/examples/ex_index.rst    | 10 ++++------
 docs/examples/ex_overview.rst |  7 +++++--
 docs/examples/ex_toc.rst      |  9 +++++++++
 docs/index.rst                | 15 +++++++++++----
 4 files changed, 29 insertions(+), 12 deletions(-)
 create mode 100644 docs/examples/ex_toc.rst

diff --git a/docs/examples/ex_index.rst b/docs/examples/ex_index.rst
index 4eae9919..af00760c 100644
--- a/docs/examples/ex_index.rst
+++ b/docs/examples/ex_index.rst
@@ -1,5 +1,5 @@
-Examples
-########
+NodeGraphQt Examples
+####################
 
 .. image:: ../_images/overview.png
     :width: 70%
@@ -7,10 +7,8 @@ Examples
 ----
 
 .. toctree::
-    :name: examplestoc
+    :caption: Module Examples
     :maxdepth: 3
 
-    ex_overview
-    ex_menu
-    ex_node
+    ex_toc
 
diff --git a/docs/examples/ex_overview.rst b/docs/examples/ex_overview.rst
index 073c61fc..b58fedf5 100644
--- a/docs/examples/ex_overview.rst
+++ b/docs/examples/ex_overview.rst
@@ -1,8 +1,11 @@
-Graph UI Overview
-#################
+Graph Overview
+##############
 
 User interface overview for the node graph.
 
+.. image:: ../_images/overview.png
+    :width: 70%
+
 Navigation
 **********
 
diff --git a/docs/examples/ex_toc.rst b/docs/examples/ex_toc.rst
new file mode 100644
index 00000000..23ceed93
--- /dev/null
+++ b/docs/examples/ex_toc.rst
@@ -0,0 +1,9 @@
+
+.. toctree::
+    :caption: Module Examples
+    :maxdepth: 3
+
+    ex_overview
+    ex_menu
+    ex_node
+
diff --git a/docs/index.rst b/docs/index.rst
index 45870e80..7e632705 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -6,17 +6,24 @@ Welcome to the NodeGraphQt documentation.
 .. image:: _images/screenshot.png
     :width: 95%
 
-Project Repo: https://github.com/jchanvfx/NodeGraphQt
+GitHub Project: https://github.com/jchanvfx/NodeGraphQt
 
 ----
 
 .. toctree::
-    :name: mastertoc
-    :maxdepth: 3
+    :caption: Module Contents
+    :name: moduletoc
+    :maxdepth: 2
 
     constants
     graph
     nodes
     menu
     widgets
-    examples/ex_index
+
+.. toctree::
+    :caption: Module Examples
+    :name: examplestoc
+    :maxdepth: 3
+
+    examples/ex_toc

From 72234eb74aa5a73cbc92863dc6814a9c2023378e Mon Sep 17 00:00:00 2001
From: jchanvfx <jjohnnycchan@gmail.com>
Date: Thu, 9 Jan 2020 11:02:09 +1300
Subject: [PATCH 5/6] doc formatting tweaks.

---
 NodeGraphQt/base/graph.py     |  7 ++++---
 docs/examples/ex_index.rst    | 14 --------------
 docs/examples/ex_node.rst     | 23 ++++++++++++-----------
 docs/examples/ex_overview.rst |  5 +++--
 docs/examples/ex_toc.rst      |  9 ---------
 docs/graph.rst                |  4 ++++
 docs/index.rst                |  4 +++-
 7 files changed, 26 insertions(+), 40 deletions(-)
 delete mode 100644 docs/examples/ex_index.rst
 delete mode 100644 docs/examples/ex_toc.rst

diff --git a/NodeGraphQt/base/graph.py b/NodeGraphQt/base/graph.py
index da091170..1d32d738 100644
--- a/NodeGraphQt/base/graph.py
+++ b/NodeGraphQt/base/graph.py
@@ -26,7 +26,7 @@ class NodeGraph(QtCore.QObject):
     """
     The ``NodeGraph`` class is the main controller for managing all nodes.
 
-    Inherited from: ``PySide2.QtCore.QObject``
+    Inherited from: :class:`PySide2.QtCore.QObject`
 
     .. image:: _images/graph.png
         :width: 60%
@@ -86,6 +86,7 @@ class NodeGraph(QtCore.QObject):
     Signal is triggered when data has been dropped to the graph.
     
     :parameters: :class:`PySide2.QtCore.QMimeData`, :class:`PySide2.QtCore.QPoint`
+    :emits: mime data, node graph position
     """
 
     def __init__(self, parent=None):
@@ -309,7 +310,7 @@ def viewer(self):
 
         See Also:
             :attr:`NodeGraph.widget` for adding the node graph into a 
-            QtWidgets.QLayout.
+            :class:`PySide2.QtWidgets.QLayout`.
 
         Returns:
             NodeGraphQt.widgets.viewer.NodeViewer: viewer interface.
@@ -468,7 +469,7 @@ def get_context_menu(self, menu):
             menu (str): menu name.
 
         Returns:
-            NodeGraphMenu or NodesMenu: context menu object.
+            NodeGraphQt.NodeGraphMenu or NodeGraphQt.NodesMenu: context menu object.
         """
         menus = self._viewer.context_menus()
         if menus.get(menu):
diff --git a/docs/examples/ex_index.rst b/docs/examples/ex_index.rst
deleted file mode 100644
index af00760c..00000000
--- a/docs/examples/ex_index.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-NodeGraphQt Examples
-####################
-
-.. image:: ../_images/overview.png
-    :width: 70%
-
-----
-
-.. toctree::
-    :caption: Module Examples
-    :maxdepth: 3
-
-    ex_toc
-
diff --git a/docs/examples/ex_node.rst b/docs/examples/ex_node.rst
index 9da94f28..e4cb6c72 100644
--- a/docs/examples/ex_node.rst
+++ b/docs/examples/ex_node.rst
@@ -5,7 +5,7 @@ Creating Nodes
 **************
 
 | Creating is done simply by calling the :func:`NodeGraphQt.NodeGraph.create_node` function.
-| (`see example below` ``line22``)
+| (`see example below` ``line: 22``)
 
 .. code-block:: python
     :linenos:
@@ -66,16 +66,16 @@ connecting nodes with the port objects:
     # make the connection.
     port_a.connect_to(port_b)
 
+`more on ports and connections.`
 
-more on ports and connections:
-    - :func:`NodeGraphQt.BaseNode.input`,
-    - :func:`NodeGraphQt.BaseNode.output`
-    - :func:`NodeGraphQt.BaseNode.set_input`,
-    - :func:`NodeGraphQt.BaseNode.set_output`,
-    - :func:`NodeGraphQt.BaseNode.inputs`,
-    - :func:`NodeGraphQt.BaseNode.outputs`
-    - :func:`NodeGraphQt.Port.connect_to`,
-    - :func:`NodeGraphQt.Port.disconnect_from`
+        - :func:`NodeGraphQt.BaseNode.input`
+        - :func:`NodeGraphQt.BaseNode.output`
+        - :func:`NodeGraphQt.BaseNode.set_input`
+        - :func:`NodeGraphQt.BaseNode.set_output`
+        - :func:`NodeGraphQt.BaseNode.inputs`
+        - :func:`NodeGraphQt.BaseNode.outputs`
+        - :func:`NodeGraphQt.Port.connect_to`
+        - :func:`NodeGraphQt.Port.disconnect_from`
 
 
 Widget Example
@@ -133,6 +133,7 @@ Here's an example where we subclass the ``NodeGraph`` and connect it up to a
 
         app.exec_()
 
-more on the properties bin and node_double_clicked signal:
+`more on the properties bin and node_double_clicked signal`
+
     - :class:`NodeGraphQt.PropertiesBinWidget`
     - :attr:`NodeGraphQt.NodeGraph.node_double_clicked`
\ No newline at end of file
diff --git a/docs/examples/ex_overview.rst b/docs/examples/ex_overview.rst
index b58fedf5..79c9b0a6 100644
--- a/docs/examples/ex_overview.rst
+++ b/docs/examples/ex_overview.rst
@@ -1,5 +1,5 @@
-Graph Overview
-##############
+NodeGraph Overview
+##################
 
 User interface overview for the node graph.
 
@@ -68,6 +68,7 @@ Here's a basic example snippet for creating two nodes and connecting them togeth
     from NodeGraphQt import NodeGraph, BaseNode, setup_context_menu
 
 
+    # create a node class object inherited from BaseNode.
     class FooNode(BaseNode):
 
         # unique node identifier domain.
diff --git a/docs/examples/ex_toc.rst b/docs/examples/ex_toc.rst
deleted file mode 100644
index 23ceed93..00000000
--- a/docs/examples/ex_toc.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-
-.. toctree::
-    :caption: Module Examples
-    :maxdepth: 3
-
-    ex_overview
-    ex_menu
-    ex_node
-
diff --git a/docs/graph.rst b/docs/graph.rst
index ff973465..7959c535 100644
--- a/docs/graph.rst
+++ b/docs/graph.rst
@@ -1,6 +1,10 @@
 NodeGraph
 #########
 
+`See` :ref:`Basic Example` `from the NodeGraph overview.`
+
+----
+
 .. autoclass:: NodeGraphQt.NodeGraph
     :members:
     :exclude-members: model, widget
diff --git a/docs/index.rst b/docs/index.rst
index 7e632705..7d2446e8 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -26,4 +26,6 @@ GitHub Project: https://github.com/jchanvfx/NodeGraphQt
     :name: examplestoc
     :maxdepth: 3
 
-    examples/ex_toc
+    examples/ex_overview
+    examples/ex_node
+    examples/ex_menu

From e2569084c6b251dcd7a946d8bac023da6d72fc3a Mon Sep 17 00:00:00 2001
From: jchanvfx <jjohnnycchan@gmail.com>
Date: Thu, 9 Jan 2020 11:33:57 +1300
Subject: [PATCH 6/6] node attr tweaks

---
 docs/nodes/NodeObject.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/nodes/NodeObject.rst b/docs/nodes/NodeObject.rst
index b101a1e2..7ecb032a 100644
--- a/docs/nodes/NodeObject.rst
+++ b/docs/nodes/NodeObject.rst
@@ -6,18 +6,22 @@ NodeObject
     :exclude-members: NODE_NAME, graph, id, model, type_, view
 
     .. autoattribute:: NODE_NAME
-        :annotation: = (re-implementation required)
+        :annotation:
 
         Initial base node name.
 
+        .. note:: re-implement this attribute to provide a base node name.
+
         :return: node name
         :rtype: str
 
     .. autoattribute:: __identifier__
-        :annotation: = (re-implementation required)
+        :annotation:
 
         Unique node identifier domain. eg. ``"com.chantacticvfx"``
 
+        .. note:: re-implement this attribute to provide a unique node type.
+
         :return: node identifer domain
         :rtype: str
 
@@ -25,11 +29,11 @@ NodeObject
     .. autoattribute:: id
     .. autoattribute:: model
     .. autoattribute:: type_
-        :annotation: = (__identifier__.__className__)
+        :annotation:
 
         Node type identifier followed by the class name. `eg.` ``"com.chantacticvfx.NodeObject"``
 
-        :return: node type
+        :return: node type (``__identifier__.__className__``)
         :rtype: str
 
     .. autoattribute:: view