--- a/VultureChecker/Documentation/source/Plugin_Checker_Vulture.PluginVulture.html Wed Jan 01 11:58:52 2020 +0100 +++ b/VultureChecker/Documentation/source/Plugin_Checker_Vulture.PluginVulture.html Tue Jun 23 17:33:21 2020 +0200 @@ -18,41 +18,53 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>Plugin_Checker_Vulture.PluginVulture</h1> + <p> Module implementing the vulture plug-in. </p> <h3>Global Attributes</h3> + <table> -<tr><td>author</td></tr><tr><td>autoactivate</td></tr><tr><td>className</td></tr><tr><td>deactivateable</td></tr><tr><td>error</td></tr><tr><td>longDescription</td></tr><tr><td>name</td></tr><tr><td>needsRestart</td></tr><tr><td>packageName</td></tr><tr><td>pyqtApi</td></tr><tr><td>python2Compatible</td></tr><tr><td>shortDescription</td></tr><tr><td>version</td></tr> +<tr><td>author</td></tr><tr><td>autoactivate</td></tr><tr><td>className</td></tr><tr><td>deactivateable</td></tr><tr><td>error</td></tr><tr><td>longDescription</td></tr><tr><td>name</td></tr><tr><td>needsRestart</td></tr><tr><td>packageName</td></tr><tr><td>pyqtApi</td></tr><tr><td>shortDescription</td></tr><tr><td>version</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#VulturePlugin">VulturePlugin</a></td> <td>Class documentation goes here.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="VulturePlugin" ID="VulturePlugin"></a> <h2>VulturePlugin</h2> + <p> Class documentation goes here. -</p><h3>Signals</h3> +</p> +<h3>Signals</h3> <dl> + <dt>analysisDone(str, dict)</dt> <dd> emitted when the code analysis has been completed for a file -</dd><dt>batchFinished()</dt> +</dd> +<dt>batchFinished()</dt> <dd> emitted when a style check batch is done -</dd><dt>error(str, str)</dt> +</dd> +<dt>error(str, str)</dt> <dd> emitted in case of an error </dd> @@ -60,236 +72,289 @@ <h3>Derived from</h3> QObject <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="#VulturePlugin.__init__">VulturePlugin</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.__initialize">__initialize</a></td> <td>Private slot to (re)initialize the plug-in.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.__loadTranslator">__loadTranslator</a></td> <td>Private method to load the translation file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.__projectClosed">__projectClosed</a></td> <td>Private slot to handle closing a project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.__projectShowMenu">__projectShowMenu</a></td> <td>Private slot called, when the the project menu or a submenu is about to be shown.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.__projectVultureCheck">__projectVultureCheck</a></td> <td>Private slot used to check the project for unused code.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.__serviceError">__serviceError</a></td> <td>Private slot handling service errors.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.activate">activate</a></td> <td>Public method to activate this plug-in.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.batchJobDone">batchJobDone</a></td> <td>Public slot handling the completion of a batch job.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.cancelVultureCheckBatch">cancelVultureCheckBatch</a></td> <td>Public method to cancel all batch jobs.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.deactivate">deactivate</a></td> <td>Public method to deactivate this plug-in.</td> -</tr><tr> -<td><a href="#VulturePlugin.serviceErrorPy2">serviceErrorPy2</a></td> -<td>Public slot handling service errors for Python 2.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.serviceErrorPy3">serviceErrorPy3</a></td> <td>Public slot handling service errors for Python 3.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.vultureCheck">vultureCheck</a></td> <td>Public method to prepare a vulture check for a Python project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.vultureCheckBatch">vultureCheckBatch</a></td> <td>Public method to prepare a vulture check for a Python project using the batch mode.</td> -</tr><tr> +</tr> +<tr> <td><a href="#VulturePlugin.vultureCheckDone">vultureCheckDone</a></td> <td>Public slot to dispatch the result.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="VulturePlugin.__init__" ID="VulturePlugin.__init__"></a> <h4>VulturePlugin (Constructor)</h4> <b>VulturePlugin</b>(<i>ui</i>) + <p> Constructor -</p><dl> +</p> +<dl> + <dt><i>ui</i></dt> <dd> reference to the user interface object (UI.UserInterface) </dd> -</dl><a NAME="VulturePlugin.__initialize" ID="VulturePlugin.__initialize"></a> +</dl> +<a NAME="VulturePlugin.__initialize" ID="VulturePlugin.__initialize"></a> <h4>VulturePlugin.__initialize</h4> <b>__initialize</b>(<i></i>) + <p> Private slot to (re)initialize the plug-in. -</p><a NAME="VulturePlugin.__loadTranslator" ID="VulturePlugin.__loadTranslator"></a> +</p> +<a NAME="VulturePlugin.__loadTranslator" ID="VulturePlugin.__loadTranslator"></a> <h4>VulturePlugin.__loadTranslator</h4> <b>__loadTranslator</b>(<i></i>) + <p> Private method to load the translation file. -</p><a NAME="VulturePlugin.__projectClosed" ID="VulturePlugin.__projectClosed"></a> +</p> +<a NAME="VulturePlugin.__projectClosed" ID="VulturePlugin.__projectClosed"></a> <h4>VulturePlugin.__projectClosed</h4> <b>__projectClosed</b>(<i></i>) + <p> Private slot to handle closing a project. -</p><a NAME="VulturePlugin.__projectShowMenu" ID="VulturePlugin.__projectShowMenu"></a> +</p> +<a NAME="VulturePlugin.__projectShowMenu" ID="VulturePlugin.__projectShowMenu"></a> <h4>VulturePlugin.__projectShowMenu</h4> <b>__projectShowMenu</b>(<i>menuName, menu</i>) + <p> Private slot called, when the the project menu or a submenu is about to be shown. -</p><dl> +</p> +<dl> + <dt><i>menuName</i> (str)</dt> <dd> name of the menu to be shown -</dd><dt><i>menu</i> (QMenu)</dt> +</dd> +<dt><i>menu</i> (QMenu)</dt> <dd> reference to the menu </dd> -</dl><a NAME="VulturePlugin.__projectVultureCheck" ID="VulturePlugin.__projectVultureCheck"></a> +</dl> +<a NAME="VulturePlugin.__projectVultureCheck" ID="VulturePlugin.__projectVultureCheck"></a> <h4>VulturePlugin.__projectVultureCheck</h4> <b>__projectVultureCheck</b>(<i></i>) + <p> Private slot used to check the project for unused code. -</p><a NAME="VulturePlugin.__serviceError" ID="VulturePlugin.__serviceError"></a> +</p> +<a NAME="VulturePlugin.__serviceError" ID="VulturePlugin.__serviceError"></a> <h4>VulturePlugin.__serviceError</h4> <b>__serviceError</b>(<i>fn, msg</i>) + <p> Private slot handling service errors. -</p><dl> +</p> +<dl> + <dt><i>fn</i> (str)</dt> <dd> file name -</dd><dt><i>msg</i> (str)</dt> +</dd> +<dt><i>msg</i> (str)</dt> <dd> message text </dd> -</dl><a NAME="VulturePlugin.activate" ID="VulturePlugin.activate"></a> +</dl> +<a NAME="VulturePlugin.activate" ID="VulturePlugin.activate"></a> <h4>VulturePlugin.activate</h4> <b>activate</b>(<i></i>) + <p> Public method to activate this plug-in. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> tuple of None and activation status (boolean) </dd> -</dl><a NAME="VulturePlugin.batchJobDone" ID="VulturePlugin.batchJobDone"></a> +</dl> +<a NAME="VulturePlugin.batchJobDone" ID="VulturePlugin.batchJobDone"></a> <h4>VulturePlugin.batchJobDone</h4> <b>batchJobDone</b>(<i>fx, lang</i>) + <p> Public slot handling the completion of a batch job. -</p><dl> -<dt><i>fx</i> (str)</dt> -<dd> -service name -</dd><dt><i>lang</i> (str)</dt> -<dd> -language -</dd> -</dl><a NAME="VulturePlugin.cancelVultureCheckBatch" ID="VulturePlugin.cancelVultureCheckBatch"></a> -<h4>VulturePlugin.cancelVultureCheckBatch</h4> -<b>cancelVultureCheckBatch</b>(<i></i>) -<p> - Public method to cancel all batch jobs. -</p><a NAME="VulturePlugin.deactivate" ID="VulturePlugin.deactivate"></a> -<h4>VulturePlugin.deactivate</h4> -<b>deactivate</b>(<i></i>) -<p> - Public method to deactivate this plug-in. -</p><a NAME="VulturePlugin.serviceErrorPy2" ID="VulturePlugin.serviceErrorPy2"></a> -<h4>VulturePlugin.serviceErrorPy2</h4> -<b>serviceErrorPy2</b>(<i>fx, lang, fn, msg</i>) -<p> - Public slot handling service errors for Python 2. -</p><dl> +</p> +<dl> + <dt><i>fx</i> (str)</dt> <dd> service name -</dd><dt><i>lang</i> (str)</dt> +</dd> +<dt><i>lang</i> (str)</dt> <dd> language -</dd><dt><i>fn</i> (str)</dt> +</dd> +</dl> +<a NAME="VulturePlugin.cancelVultureCheckBatch" ID="VulturePlugin.cancelVultureCheckBatch"></a> +<h4>VulturePlugin.cancelVultureCheckBatch</h4> +<b>cancelVultureCheckBatch</b>(<i></i>) + +<p> + Public method to cancel all batch jobs. +</p> +<a NAME="VulturePlugin.deactivate" ID="VulturePlugin.deactivate"></a> +<h4>VulturePlugin.deactivate</h4> +<b>deactivate</b>(<i></i>) + +<p> + Public method to deactivate this plug-in. +</p> +<a NAME="VulturePlugin.serviceErrorPy3" ID="VulturePlugin.serviceErrorPy3"></a> +<h4>VulturePlugin.serviceErrorPy3</h4> +<b>serviceErrorPy3</b>(<i>fx, lang, fn, msg</i>) + +<p> + Public slot handling service errors for Python 3. +</p> +<dl> + +<dt><i>fx</i> (str)</dt> +<dd> +service name +</dd> +<dt><i>lang</i> (str)</dt> +<dd> +language +</dd> +<dt><i>fn</i> (str)</dt> <dd> file name -</dd><dt><i>msg</i> (str)</dt> +</dd> +<dt><i>msg</i> (str)</dt> <dd> message text </dd> -</dl><a NAME="VulturePlugin.serviceErrorPy3" ID="VulturePlugin.serviceErrorPy3"></a> -<h4>VulturePlugin.serviceErrorPy3</h4> -<b>serviceErrorPy3</b>(<i>fx, lang, fn, msg</i>) -<p> - Public slot handling service errors for Python 3. -</p><dl> -<dt><i>fx</i> (str)</dt> -<dd> -service name -</dd><dt><i>lang</i> (str)</dt> -<dd> -language -</dd><dt><i>fn</i> (str)</dt> -<dd> -file name -</dd><dt><i>msg</i> (str)</dt> -<dd> -message text -</dd> -</dl><a NAME="VulturePlugin.vultureCheck" ID="VulturePlugin.vultureCheck"></a> +</dl> +<a NAME="VulturePlugin.vultureCheck" ID="VulturePlugin.vultureCheck"></a> <h4>VulturePlugin.vultureCheck</h4> <b>vultureCheck</b>(<i>lang, filename, source</i>) + <p> Public method to prepare a vulture check for a Python project. -</p><dl> +</p> +<dl> + <dt><i>lang</i> (str or None)</dt> <dd> language of the files or None to determine by internal algorithm -</dd><dt><i>filename</i> (str)</dt> +</dd> +<dt><i>filename</i> (str)</dt> <dd> name of the file to analyze -</dd><dt><i>source</i> (str)</dt> +</dd> +<dt><i>source</i> (str)</dt> <dd> string containing the code </dd> -</dl><a NAME="VulturePlugin.vultureCheckBatch" ID="VulturePlugin.vultureCheckBatch"></a> +</dl> +<a NAME="VulturePlugin.vultureCheckBatch" ID="VulturePlugin.vultureCheckBatch"></a> <h4>VulturePlugin.vultureCheckBatch</h4> <b>vultureCheckBatch</b>(<i>argumentsList</i>) + <p> Public method to prepare a vulture check for a Python project using the batch mode. -</p><dl> +</p> +<dl> + <dt><i>argumentsList</i> ((str, str))</dt> <dd> list of arguments tuples with each tuple containing filename and source </dd> -</dl><a NAME="VulturePlugin.vultureCheckDone" ID="VulturePlugin.vultureCheckDone"></a> +</dl> +<a NAME="VulturePlugin.vultureCheckDone" ID="VulturePlugin.vultureCheckDone"></a> <h4>VulturePlugin.vultureCheckDone</h4> <b>vultureCheckDone</b>(<i>filename, result</i>) + <p> Public slot to dispatch the result. -</p><dl> +</p> +<dl> + <dt><i>filename</i> (str)</dt> <dd> name of the file the results belong to -</dd><dt><i>result</i> (dict)</dt> +</dd> +<dt><i>result</i> (dict)</dt> <dd> result dictionary </dd>