diff -r 9251c4dc4f7a -r 90a9aefd4253 eric6/Documentation/Source/eric6.UI.PythonDisViewer.html
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/eric6/Documentation/Source/eric6.UI.PythonDisViewer.html Sun Sep 20 18:32:28 2020 +0200
@@ -0,0 +1,586 @@
+<!DOCTYPE html>
+<html><head>
+<title>eric6.UI.PythonDisViewer</title>
+<meta charset="UTF-8">
+<style>
+body {
+ background: #EDECE6;
+ margin: 0em 1em 10em 1em;
+ color: black;
+}
+
+h1 { color: white; background: #85774A; }
+h2 { color: white; background: #85774A; }
+h3 { color: white; background: #9D936E; }
+h4 { color: white; background: #9D936E; }
+
+a { color: #BA6D36; }
+
+</style>
+</head>
+<body>
+<a NAME="top" ID="top"></a>
+<h1>eric6.UI.PythonDisViewer</h1>
+
+<p>
+Module implementing a widget to visualize the Python Disassembly for some
+Python sources.
+</p>
+<h3>Global Attributes</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Classes</h3>
+
+<table>
+
+<tr>
+<td><a href="#PythonDisViewer">PythonDisViewer</a></td>
+<td>Class implementing a widget to visualize the Python Disassembly for some Python sources.</td>
+</tr>
+</table>
+<h3>Functions</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<hr />
+<hr />
+<a NAME="PythonDisViewer" ID="PythonDisViewer"></a>
+<h2>PythonDisViewer</h2>
+
+<p>
+ Class implementing a widget to visualize the Python Disassembly for some
+ Python sources.
+</p>
+<h3>Derived from</h3>
+QWidget
+<h3>Class Attributes</h3>
+
+<table>
+<tr><td>EndLineRole</td></tr><tr><td>StartLineRole</td></tr>
+</table>
+<h3>Class Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Methods</h3>
+
+<table>
+
+<tr>
+<td><a href="#PythonDisViewer.__init__">PythonDisViewer</a></td>
+<td>Constructor</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__clearSelection">__clearSelection</a></td>
+<td>Private method to clear all selected items.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__collapseAll">__collapseAll</a></td>
+<td>Private slot to collapse all items.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__contextMenuRequested">__contextMenuRequested</a></td>
+<td>Private slot to show the context menu.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__createErrorItem">__createErrorItem</a></td>
+<td>Private method to create a top level error item.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__createInstructionItem">__createInstructionItem</a></td>
+<td>Private method to create an item for the given instruction.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__createTitleItem">__createTitleItem</a></td>
+<td>Private method to create a title item.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__disItemClicked">__disItemClicked</a></td>
+<td>Private slot handling a user click on a Disassembly node item.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__disViewerStateChanged">__disViewerStateChanged</a></td>
+<td>Private slot to toggle the display of the Disassembly viewer.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__disassembleObject">__disassembleObject</a></td>
+<td>Private method to disassemble the given code object recursively.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__editorChanged">__editorChanged</a></td>
+<td>Private slot to handle a change of the current editor.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__editorLineChanged">__editorLineChanged</a></td>
+<td>Private slot to handle a mouse button double click in the editor.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__editorSaved">__editorSaved</a></td>
+<td>Private slot to reload the Disassembly after the connected editor was saved.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__expandAll">__expandAll</a></td>
+<td>Private slot to expand all items.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__grabFocus">__grabFocus</a></td>
+<td>Private method to grab the input focus.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__lastEditorClosed">__lastEditorClosed</a></td>
+<td>Private slot to handle the last editor closed signal of the view manager.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__loadDIS">__loadDIS</a></td>
+<td>Private method to generate the Disassembly from the source of the current editor and visualize it.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__resizeColumns">__resizeColumns</a></td>
+<td>Private method to resize the columns to suitable values.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__selectChildren">__selectChildren</a></td>
+<td>Private method to select children of the given item covering the given line number.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__selectItemForEditorLine">__selectItemForEditorLine</a></td>
+<td>Private slot to select the items corresponding with the cursor line of the current editor.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__tryCompile">__tryCompile</a></td>
+<td>Private method to attempt to compile the given source, first as an expression and then as a statement if the first approach fails.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.__updateItemEndLine">__updateItemEndLine</a></td>
+<td>Private method to update an items end line based on its children.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.hide">hide</a></td>
+<td>Public slot to hide the DIS viewer.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.preferencesChanged">preferencesChanged</a></td>
+<td>Public slot handling changes of the Disassembly viewer settings.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.resizeEvent">resizeEvent</a></td>
+<td>Protected method to handle resize events.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.show">show</a></td>
+<td>Public slot to show the DIS viewer.</td>
+</tr>
+<tr>
+<td><a href="#PythonDisViewer.shutdown">shutdown</a></td>
+<td>Public method to perform shutdown actions.</td>
+</tr>
+</table>
+<h3>Static Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+
+<a NAME="PythonDisViewer.__init__" ID="PythonDisViewer.__init__"></a>
+<h4>PythonDisViewer (Constructor)</h4>
+<b>PythonDisViewer</b>(<i>viewmanager, parent=None</i>)
+
+<p>
+ Constructor
+</p>
+<dl>
+
+<dt><i>viewmanager</i> (ViewManager)</dt>
+<dd>
+reference to the viewmanager object
+</dd>
+<dt><i>parent</i> (QWidget)</dt>
+<dd>
+reference to the parent widget
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__clearSelection" ID="PythonDisViewer.__clearSelection"></a>
+<h4>PythonDisViewer.__clearSelection</h4>
+<b>__clearSelection</b>(<i></i>)
+
+<p>
+ Private method to clear all selected items.
+</p>
+<a NAME="PythonDisViewer.__collapseAll" ID="PythonDisViewer.__collapseAll"></a>
+<h4>PythonDisViewer.__collapseAll</h4>
+<b>__collapseAll</b>(<i></i>)
+
+<p>
+ Private slot to collapse all items.
+</p>
+<a NAME="PythonDisViewer.__contextMenuRequested" ID="PythonDisViewer.__contextMenuRequested"></a>
+<h4>PythonDisViewer.__contextMenuRequested</h4>
+<b>__contextMenuRequested</b>(<i>coord</i>)
+
+<p>
+ Private slot to show the context menu.
+</p>
+<dl>
+
+<dt><i>coord</i> (QPoint)</dt>
+<dd>
+position of the mouse pointer
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__createErrorItem" ID="PythonDisViewer.__createErrorItem"></a>
+<h4>PythonDisViewer.__createErrorItem</h4>
+<b>__createErrorItem</b>(<i>error</i>)
+
+<p>
+ Private method to create a top level error item.
+</p>
+<dl>
+
+<dt><i>error</i> (str)</dt>
+<dd>
+error message
+</dd>
+</dl>
+<dl>
+<dt>Returns:</dt>
+<dd>
+generated item
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+QTreeWidgetItem
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__createInstructionItem" ID="PythonDisViewer.__createInstructionItem"></a>
+<h4>PythonDisViewer.__createInstructionItem</h4>
+<b>__createInstructionItem</b>(<i>instr, parent, lasti=-1</i>)
+
+<p>
+ Private method to create an item for the given instruction.
+</p>
+<dl>
+
+<dt><i>instr</i> (dis.Instruction)</dt>
+<dd>
+instruction the item should be based on
+</dd>
+<dt><i>parent</i> (QTreeWidgetItem)</dt>
+<dd>
+reference to the parent item
+</dd>
+<dt><i>lasti</i> (int)</dt>
+<dd>
+index of the instruction of a traceback
+</dd>
+</dl>
+<dl>
+<dt>Returns:</dt>
+<dd>
+generated item
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+QTreeWidgetItem
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__createTitleItem" ID="PythonDisViewer.__createTitleItem"></a>
+<h4>PythonDisViewer.__createTitleItem</h4>
+<b>__createTitleItem</b>(<i>title, line, parentItem</i>)
+
+<p>
+ Private method to create a title item.
+</p>
+<dl>
+
+<dt><i>title</i> (str)</dt>
+<dd>
+titel string for the item
+</dd>
+<dt><i>line</i> (int)</dt>
+<dd>
+start line of the titled disassembly
+</dd>
+<dt><i>parentItem</i> (QTreeWidget or QTreeWidgetItem)</dt>
+<dd>
+reference to the parent item
+</dd>
+</dl>
+<dl>
+<dt>Returns:</dt>
+<dd>
+generated item
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+QTreeWidgetItem
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__disItemClicked" ID="PythonDisViewer.__disItemClicked"></a>
+<h4>PythonDisViewer.__disItemClicked</h4>
+<b>__disItemClicked</b>(<i>itm, column</i>)
+
+<p>
+ Private slot handling a user click on a Disassembly node item.
+</p>
+<dl>
+
+<dt><i>itm</i> (QTreeWidgetItem)</dt>
+<dd>
+reference to the clicked item
+</dd>
+<dt><i>column</i> (int)</dt>
+<dd>
+column number of the click
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__disViewerStateChanged" ID="PythonDisViewer.__disViewerStateChanged"></a>
+<h4>PythonDisViewer.__disViewerStateChanged</h4>
+<b>__disViewerStateChanged</b>(<i>on</i>)
+
+<p>
+ Private slot to toggle the display of the Disassembly viewer.
+</p>
+<dl>
+
+<dt><i>on</i> (bool)</dt>
+<dd>
+flag indicating to show the Disassembly
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__disassembleObject" ID="PythonDisViewer.__disassembleObject"></a>
+<h4>PythonDisViewer.__disassembleObject</h4>
+<b>__disassembleObject</b>(<i>co, parentItem, parentName="", lasti=-1</i>)
+
+<p>
+ Private method to disassemble the given code object recursively.
+</p>
+<dl>
+
+<dt><i>co</i> (code object)</dt>
+<dd>
+code object to be disassembled
+</dd>
+<dt><i>parentItem</i> (QTreeWidget or QTreeWidgetItem)</dt>
+<dd>
+reference to the parent item
+</dd>
+<dt><i>parentName</i> (str)</dt>
+<dd>
+name of the parent code object
+</dd>
+<dt><i>lasti</i> (int)</dt>
+<dd>
+index of the instruction of a traceback
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__editorChanged" ID="PythonDisViewer.__editorChanged"></a>
+<h4>PythonDisViewer.__editorChanged</h4>
+<b>__editorChanged</b>(<i>editor</i>)
+
+<p>
+ Private slot to handle a change of the current editor.
+</p>
+<dl>
+
+<dt><i>editor</i> (Editor)</dt>
+<dd>
+reference to the current editor
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__editorLineChanged" ID="PythonDisViewer.__editorLineChanged"></a>
+<h4>PythonDisViewer.__editorLineChanged</h4>
+<b>__editorLineChanged</b>(<i>editor, lineno</i>)
+
+<p>
+ Private slot to handle a mouse button double click in the editor.
+</p>
+<dl>
+
+<dt><i>editor</i> (Editor)</dt>
+<dd>
+reference to the editor, that emitted the signal
+</dd>
+<dt><i>lineno</i> (int)</dt>
+<dd>
+line number of the editor's cursor (zero based)
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__editorSaved" ID="PythonDisViewer.__editorSaved"></a>
+<h4>PythonDisViewer.__editorSaved</h4>
+<b>__editorSaved</b>(<i>editor</i>)
+
+<p>
+ Private slot to reload the Disassembly after the connected editor was
+ saved.
+</p>
+<dl>
+
+<dt><i>editor</i> (Editor)</dt>
+<dd>
+reference to the editor that performed a save action
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__expandAll" ID="PythonDisViewer.__expandAll"></a>
+<h4>PythonDisViewer.__expandAll</h4>
+<b>__expandAll</b>(<i></i>)
+
+<p>
+ Private slot to expand all items.
+</p>
+<a NAME="PythonDisViewer.__grabFocus" ID="PythonDisViewer.__grabFocus"></a>
+<h4>PythonDisViewer.__grabFocus</h4>
+<b>__grabFocus</b>(<i></i>)
+
+<p>
+ Private method to grab the input focus.
+</p>
+<a NAME="PythonDisViewer.__lastEditorClosed" ID="PythonDisViewer.__lastEditorClosed"></a>
+<h4>PythonDisViewer.__lastEditorClosed</h4>
+<b>__lastEditorClosed</b>(<i></i>)
+
+<p>
+ Private slot to handle the last editor closed signal of the view
+ manager.
+</p>
+<a NAME="PythonDisViewer.__loadDIS" ID="PythonDisViewer.__loadDIS"></a>
+<h4>PythonDisViewer.__loadDIS</h4>
+<b>__loadDIS</b>(<i></i>)
+
+<p>
+ Private method to generate the Disassembly from the source of the
+ current editor and visualize it.
+</p>
+<a NAME="PythonDisViewer.__resizeColumns" ID="PythonDisViewer.__resizeColumns"></a>
+<h4>PythonDisViewer.__resizeColumns</h4>
+<b>__resizeColumns</b>(<i></i>)
+
+<p>
+ Private method to resize the columns to suitable values.
+</p>
+<a NAME="PythonDisViewer.__selectChildren" ID="PythonDisViewer.__selectChildren"></a>
+<h4>PythonDisViewer.__selectChildren</h4>
+<b>__selectChildren</b>(<i>itm, lineno</i>)
+
+<p>
+ Private method to select children of the given item covering the given
+ line number.
+</p>
+<dl>
+
+<dt><i>itm</i> (QTreeWidgetItem)</dt>
+<dd>
+reference to the item
+</dd>
+<dt><i>lineno</i> (int)</dt>
+<dd>
+line number to base the selection on
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__selectItemForEditorLine" ID="PythonDisViewer.__selectItemForEditorLine"></a>
+<h4>PythonDisViewer.__selectItemForEditorLine</h4>
+<b>__selectItemForEditorLine</b>(<i></i>)
+
+<p>
+ Private slot to select the items corresponding with the cursor line
+ of the current editor.
+</p>
+<a NAME="PythonDisViewer.__tryCompile" ID="PythonDisViewer.__tryCompile"></a>
+<h4>PythonDisViewer.__tryCompile</h4>
+<b>__tryCompile</b>(<i>source, name</i>)
+
+<p>
+ Private method to attempt to compile the given source, first as an
+ expression and then as a statement if the first approach fails.
+</p>
+<dl>
+
+<dt><i>source</i> (str)</dt>
+<dd>
+source code string to be compiled
+</dd>
+<dt><i>name</i> (str)</dt>
+<dd>
+name of the file containing the source
+</dd>
+</dl>
+<dl>
+<dt>Returns:</dt>
+<dd>
+compiled code
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+code object
+</dd>
+</dl>
+<a NAME="PythonDisViewer.__updateItemEndLine" ID="PythonDisViewer.__updateItemEndLine"></a>
+<h4>PythonDisViewer.__updateItemEndLine</h4>
+<b>__updateItemEndLine</b>(<i>itm</i>)
+
+<p>
+ Private method to update an items end line based on its children.
+</p>
+<dl>
+
+<dt><i>itm</i> (QTreeWidgetItem)</dt>
+<dd>
+reference to the item to be updated
+</dd>
+</dl>
+<a NAME="PythonDisViewer.hide" ID="PythonDisViewer.hide"></a>
+<h4>PythonDisViewer.hide</h4>
+<b>hide</b>(<i></i>)
+
+<p>
+ Public slot to hide the DIS viewer.
+</p>
+<a NAME="PythonDisViewer.preferencesChanged" ID="PythonDisViewer.preferencesChanged"></a>
+<h4>PythonDisViewer.preferencesChanged</h4>
+<b>preferencesChanged</b>(<i></i>)
+
+<p>
+ Public slot handling changes of the Disassembly viewer settings.
+</p>
+<a NAME="PythonDisViewer.resizeEvent" ID="PythonDisViewer.resizeEvent"></a>
+<h4>PythonDisViewer.resizeEvent</h4>
+<b>resizeEvent</b>(<i>evt</i>)
+
+<p>
+ Protected method to handle resize events.
+</p>
+<dl>
+
+<dt><i>evt</i> (QResizeEvent)</dt>
+<dd>
+resize event
+</dd>
+</dl>
+<a NAME="PythonDisViewer.show" ID="PythonDisViewer.show"></a>
+<h4>PythonDisViewer.show</h4>
+<b>show</b>(<i></i>)
+
+<p>
+ Public slot to show the DIS viewer.
+</p>
+<a NAME="PythonDisViewer.shutdown" ID="PythonDisViewer.shutdown"></a>
+<h4>PythonDisViewer.shutdown</h4>
+<b>shutdown</b>(<i></i>)
+
+<p>
+ Public method to perform shutdown actions.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr />
+</body></html>
\ No newline at end of file
