diff -r 1779dc278077 -r 391d6b7b1eff eric6/Documentation/Source/eric6.Graphics.PackageDiagramBuilder.html --- a/eric6/Documentation/Source/eric6.Graphics.PackageDiagramBuilder.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.Graphics.PackageDiagramBuilder.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,275 +18,366 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.Graphics.PackageDiagramBuilder</h1> + <p> Module implementing a dialog showing a UML like class diagram of a package. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#PackageDiagramBuilder">PackageDiagramBuilder</a></td> <td>Class implementing a builder for UML like class diagrams of a package.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="PackageDiagramBuilder" ID="PackageDiagramBuilder"></a> <h2>PackageDiagramBuilder</h2> + <p> Class implementing a builder for UML like class diagrams of a package. </p> <h3>Derived from</h3> UMLDiagramBuilder <h3>Class Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Class Methods</h3> + <table> <tr><td>None</td></tr> </table> <h3>Methods</h3> + <table> + <tr> <td><a href="#PackageDiagramBuilder.__init__">PackageDiagramBuilder</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.__addExternalClass">__addExternalClass</a></td> <td>Private method to add a class defined outside the module.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.__addLocalClass">__addLocalClass</a></td> <td>Private method to add a class defined in the module.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.__addPackage">__addPackage</a></td> <td>Private method to add a package to the diagram.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.__arrangeClasses">__arrangeClasses</a></td> <td>Private method to arrange the shapes on the canvas.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.__buildModulesDict">__buildModulesDict</a></td> <td>Private method to build a dictionary of modules contained in the package.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.__buildSubpackagesDict">__buildSubpackagesDict</a></td> <td>Private method to build a dictionary of sub-packages contained in this package.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.__createAssociations">__createAssociations</a></td> <td>Private method to generate the associations between the class shapes.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.__getCurrentShape">__getCurrentShape</a></td> <td>Private method to get the named shape.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.buildDiagram">buildDiagram</a></td> <td>Public method to build the class shapes of the package diagram.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.getPersistenceData">getPersistenceData</a></td> <td>Public method to get a string for data to be persisted.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.initialize">initialize</a></td> <td>Public method to initialize the object.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PackageDiagramBuilder.parsePersistenceData">parsePersistenceData</a></td> <td>Public method to parse persisted data.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="PackageDiagramBuilder.__init__" ID="PackageDiagramBuilder.__init__"></a> <h4>PackageDiagramBuilder (Constructor)</h4> <b>PackageDiagramBuilder</b>(<i>dialog, view, project, package, noAttrs=False</i>) + <p> Constructor -</p><dl> +</p> +<dl> + <dt><i>dialog</i></dt> <dd> reference to the UML dialog (UMLDialog) -</dd><dt><i>view</i></dt> +</dd> +<dt><i>view</i></dt> <dd> reference to the view object (UMLGraphicsView) -</dd><dt><i>project</i></dt> +</dd> +<dt><i>project</i></dt> <dd> reference to the project object (Project) -</dd><dt><i>package</i></dt> +</dd> +<dt><i>package</i></dt> <dd> name of a python package to be shown (string) -</dd><dt><i>noAttrs=</i></dt> +</dd> +<dt><i>noAttrs=</i></dt> <dd> flag indicating, that no attributes should be shown (boolean) </dd> -</dl><a NAME="PackageDiagramBuilder.__addExternalClass" ID="PackageDiagramBuilder.__addExternalClass"></a> +</dl> +<a NAME="PackageDiagramBuilder.__addExternalClass" ID="PackageDiagramBuilder.__addExternalClass"></a> <h4>PackageDiagramBuilder.__addExternalClass</h4> <b>__addExternalClass</b>(<i>_class, x, y</i>) + <p> Private method to add a class defined outside the module. -</p><p> +</p> +<p> If the canvas is too small to take the shape, it is enlarged. -</p><dl> +</p> +<dl> + <dt><i>_class</i></dt> <dd> class to be shown (string) -</dd><dt><i>x</i></dt> +</dd> +<dt><i>x</i></dt> <dd> x-coordinate (float) -</dd><dt><i>y</i></dt> +</dd> +<dt><i>y</i></dt> <dd> y-coordinate (float) </dd> -</dl><a NAME="PackageDiagramBuilder.__addLocalClass" ID="PackageDiagramBuilder.__addLocalClass"></a> +</dl> +<a NAME="PackageDiagramBuilder.__addLocalClass" ID="PackageDiagramBuilder.__addLocalClass"></a> <h4>PackageDiagramBuilder.__addLocalClass</h4> <b>__addLocalClass</b>(<i>className, _class, x, y, isRbModule=False</i>) + <p> Private method to add a class defined in the module. -</p><dl> +</p> +<dl> + <dt><i>className</i></dt> <dd> name of the class to be as a dictionary key (string) -</dd><dt><i>_class</i></dt> +</dd> +<dt><i>_class</i></dt> <dd> class to be shown (ModuleParser.Class) -</dd><dt><i>x</i></dt> +</dd> +<dt><i>x</i></dt> <dd> x-coordinate (float) -</dd><dt><i>y</i></dt> +</dd> +<dt><i>y</i></dt> <dd> y-coordinate (float) -</dd><dt><i>isRbModule</i></dt> +</dd> +<dt><i>isRbModule</i></dt> <dd> flag indicating a Ruby module (boolean) </dd> -</dl><a NAME="PackageDiagramBuilder.__addPackage" ID="PackageDiagramBuilder.__addPackage"></a> +</dl> +<a NAME="PackageDiagramBuilder.__addPackage" ID="PackageDiagramBuilder.__addPackage"></a> <h4>PackageDiagramBuilder.__addPackage</h4> <b>__addPackage</b>(<i>name, modules, x, y</i>) + <p> Private method to add a package to the diagram. -</p><dl> +</p> +<dl> + <dt><i>name</i></dt> <dd> package name to be shown (string) -</dd><dt><i>modules</i></dt> +</dd> +<dt><i>modules</i></dt> <dd> list of module names contained in the package (list of strings) -</dd><dt><i>x</i></dt> +</dd> +<dt><i>x</i></dt> <dd> x-coordinate (float) -</dd><dt><i>y</i></dt> +</dd> +<dt><i>y</i></dt> <dd> y-coordinate (float) </dd> -</dl><a NAME="PackageDiagramBuilder.__arrangeClasses" ID="PackageDiagramBuilder.__arrangeClasses"></a> +</dl> +<a NAME="PackageDiagramBuilder.__arrangeClasses" ID="PackageDiagramBuilder.__arrangeClasses"></a> <h4>PackageDiagramBuilder.__arrangeClasses</h4> <b>__arrangeClasses</b>(<i>nodes, routes, whiteSpaceFactor=1.2</i>) + <p> Private method to arrange the shapes on the canvas. -</p><p> +</p> +<p> The algorithm is borrowed from Boa Constructor. -</p><dl> +</p> +<dl> + <dt><i>nodes</i></dt> <dd> list of nodes to arrange -</dd><dt><i>routes</i></dt> +</dd> +<dt><i>routes</i></dt> <dd> list of routes -</dd><dt><i>whiteSpaceFactor</i></dt> +</dd> +<dt><i>whiteSpaceFactor</i></dt> <dd> factor to increase whitespace between items (float) </dd> -</dl><a NAME="PackageDiagramBuilder.__buildModulesDict" ID="PackageDiagramBuilder.__buildModulesDict"></a> +</dl> +<a NAME="PackageDiagramBuilder.__buildModulesDict" ID="PackageDiagramBuilder.__buildModulesDict"></a> <h4>PackageDiagramBuilder.__buildModulesDict</h4> <b>__buildModulesDict</b>(<i></i>) + <p> Private method to build a dictionary of modules contained in the package. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> dictionary of modules contained in the package. </dd> -</dl><a NAME="PackageDiagramBuilder.__buildSubpackagesDict" ID="PackageDiagramBuilder.__buildSubpackagesDict"></a> +</dl> +<a NAME="PackageDiagramBuilder.__buildSubpackagesDict" ID="PackageDiagramBuilder.__buildSubpackagesDict"></a> <h4>PackageDiagramBuilder.__buildSubpackagesDict</h4> <b>__buildSubpackagesDict</b>(<i></i>) + <p> Private method to build a dictionary of sub-packages contained in this package. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> dictionary of sub-packages contained in this package </dd> -</dl><a NAME="PackageDiagramBuilder.__createAssociations" ID="PackageDiagramBuilder.__createAssociations"></a> +</dl> +<a NAME="PackageDiagramBuilder.__createAssociations" ID="PackageDiagramBuilder.__createAssociations"></a> <h4>PackageDiagramBuilder.__createAssociations</h4> <b>__createAssociations</b>(<i>routes</i>) + <p> Private method to generate the associations between the class shapes. -</p><dl> +</p> +<dl> + <dt><i>routes</i></dt> <dd> list of relationsships </dd> -</dl><a NAME="PackageDiagramBuilder.__getCurrentShape" ID="PackageDiagramBuilder.__getCurrentShape"></a> +</dl> +<a NAME="PackageDiagramBuilder.__getCurrentShape" ID="PackageDiagramBuilder.__getCurrentShape"></a> <h4>PackageDiagramBuilder.__getCurrentShape</h4> <b>__getCurrentShape</b>(<i>name</i>) + <p> Private method to get the named shape. -</p><dl> +</p> +<dl> + <dt><i>name</i></dt> <dd> name of the shape (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> shape (QCanvasItem) </dd> -</dl><a NAME="PackageDiagramBuilder.buildDiagram" ID="PackageDiagramBuilder.buildDiagram"></a> +</dl> +<a NAME="PackageDiagramBuilder.buildDiagram" ID="PackageDiagramBuilder.buildDiagram"></a> <h4>PackageDiagramBuilder.buildDiagram</h4> <b>buildDiagram</b>(<i></i>) + <p> Public method to build the class shapes of the package diagram. -</p><p> +</p> +<p> The algorithm is borrowed from Boa Constructor. -</p><a NAME="PackageDiagramBuilder.getPersistenceData" ID="PackageDiagramBuilder.getPersistenceData"></a> +</p> +<a NAME="PackageDiagramBuilder.getPersistenceData" ID="PackageDiagramBuilder.getPersistenceData"></a> <h4>PackageDiagramBuilder.getPersistenceData</h4> <b>getPersistenceData</b>(<i></i>) + <p> Public method to get a string for data to be persisted. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> persisted data string (string) </dd> -</dl><a NAME="PackageDiagramBuilder.initialize" ID="PackageDiagramBuilder.initialize"></a> +</dl> +<a NAME="PackageDiagramBuilder.initialize" ID="PackageDiagramBuilder.initialize"></a> <h4>PackageDiagramBuilder.initialize</h4> <b>initialize</b>(<i></i>) + <p> Public method to initialize the object. -</p><a NAME="PackageDiagramBuilder.parsePersistenceData" ID="PackageDiagramBuilder.parsePersistenceData"></a> +</p> +<a NAME="PackageDiagramBuilder.parsePersistenceData" ID="PackageDiagramBuilder.parsePersistenceData"></a> <h4>PackageDiagramBuilder.parsePersistenceData</h4> <b>parsePersistenceData</b>(<i>version, data</i>) + <p> Public method to parse persisted data. -</p><dl> +</p> +<dl> + <dt><i>version</i></dt> <dd> version of the data (string) -</dd><dt><i>data</i></dt> +</dd> +<dt><i>data</i></dt> <dd> persisted data to be parsed (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> flag indicating success (boolean)