Sat, 14 Oct 2017 19:31:11 +0200
Added support for the extraction of source code documentation.
<!DOCTYPE html> <html><head> <title>Plugin_Refactoring_Rope.RefactoringRope.CodeAssistServer</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>Plugin_Refactoring_Rope.RefactoringRope.CodeAssistServer</h1> <p> Module implementing the autocompletion interface to rope. </p> <h3>Global Attributes</h3> <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> <table> <tr> <td><a href="#CodeAssistServer">CodeAssistServer</a></td> <td>Class implementing the autocompletion interface to rope.</td> </tr> </table> <h3>Functions</h3> <table> <tr><td>None</td></tr> </table> <hr /><hr /> <a NAME="CodeAssistServer" ID="CodeAssistServer"></a> <h2>CodeAssistServer</h2> <p> Class implementing the autocompletion interface to rope. </p> <h3>Derived from</h3> JsonServer <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="#CodeAssistServer.__init__">CodeAssistServer</a></td> <td>Constructor</td> </tr><tr> <td><a href="#CodeAssistServer.__configChanged">__configChanged</a></td> <td>Private slot called, when the rope config file has changed.</td> </tr><tr> <td><a href="#CodeAssistServer.__ensureActive">__ensureActive</a></td> <td>Private method to ensure, that the requested client is active.</td> </tr><tr> <td><a href="#CodeAssistServer.__getConfigs">__getConfigs</a></td> <td>Private method to get the configurations of all connected clients.</td> </tr><tr> <td><a href="#CodeAssistServer.__processCallTipsResult">__processCallTipsResult</a></td> <td>Private method to process the calltips sent by the client.</td> </tr><tr> <td><a href="#CodeAssistServer.__processClientException">__processClientException</a></td> <td>Private method to handle exceptions of the refactoring client.</td> </tr><tr> <td><a href="#CodeAssistServer.__processCompletionsResult">__processCompletionsResult</a></td> <td>Private method to process the completions sent by the client.</td> </tr><tr> <td><a href="#CodeAssistServer.__processDocumentationResult">__processDocumentationResult</a></td> <td>Private method to process the documentation sent by the client.</td> </tr><tr> <td><a href="#CodeAssistServer.__ropeConfigFile">__ropeConfigFile</a></td> <td>Private method to get the name of the rope configuration file.</td> </tr><tr> <td><a href="#CodeAssistServer.__setAutoCompletionHook">__setAutoCompletionHook</a></td> <td>Private method to set the auto-completion hook.</td> </tr><tr> <td><a href="#CodeAssistServer.__setCalltipsHook">__setCalltipsHook</a></td> <td>Private method to set the calltip hook.</td> </tr><tr> <td><a href="#CodeAssistServer.__setConfig">__setConfig</a></td> <td>Private method to set the rope client configuration data.</td> </tr><tr> <td><a href="#CodeAssistServer.__startCodeAssistClient">__startCodeAssistClient</a></td> <td>Private method to start the code assist client with the given interpreter.</td> </tr><tr> <td><a href="#CodeAssistServer.__unsetAutoCompletionHook">__unsetAutoCompletionHook</a></td> <td>Private method to unset the auto-completion hook.</td> </tr><tr> <td><a href="#CodeAssistServer.__unsetCalltipsHook">__unsetCalltipsHook</a></td> <td>Private method to unset the calltip hook.</td> </tr><tr> <td><a href="#CodeAssistServer.__updateEditorLanguageMapping">__updateEditorLanguageMapping</a></td> <td>Private method to update the editor language to connection mapping.</td> </tr><tr> <td><a href="#CodeAssistServer.activate">activate</a></td> <td>Public method to activate the code assist server.</td> </tr><tr> <td><a href="#CodeAssistServer.connectEditor">connectEditor</a></td> <td>Public method to connect an editor.</td> </tr><tr> <td><a href="#CodeAssistServer.deactivate">deactivate</a></td> <td>Public method to deactivate the code assist server.</td> </tr><tr> <td><a href="#CodeAssistServer.disconnectEditor">disconnectEditor</a></td> <td>Public method to disconnect an editor.</td> </tr><tr> <td><a href="#CodeAssistServer.editConfig">editConfig</a></td> <td>Public slot to open the rope configuration file in an editor.</td> </tr><tr> <td><a href="#CodeAssistServer.getCallTips">getCallTips</a></td> <td>Public method to calculate calltips.</td> </tr><tr> <td><a href="#CodeAssistServer.getCompletions">getCompletions</a></td> <td>Public method to calculate the possible completions.</td> </tr><tr> <td><a href="#CodeAssistServer.handleCall">handleCall</a></td> <td>Public method to handle a method call from the client.</td> </tr><tr> <td><a href="#CodeAssistServer.handleNewConnection">handleNewConnection</a></td> <td>Public slot for new incoming connections from a client.</td> </tr><tr> <td><a href="#CodeAssistServer.isSupportedLanguage">isSupportedLanguage</a></td> <td>Public method to check, if the given language is supported.</td> </tr><tr> <td><a href="#CodeAssistServer.reportChanged">reportChanged</a></td> <td>Public slot to report some changed sources.</td> </tr><tr> <td><a href="#CodeAssistServer.requestCodeDocumentation">requestCodeDocumentation</a></td> <td>Public method to request source code documentation for the given editor.</td> </tr><tr> <td><a href="#CodeAssistServer.requestCompletions">requestCompletions</a></td> <td>Public method to request a list of possible completions.</td> </tr> </table> <h3>Static Methods</h3> <table> <tr><td>None</td></tr> </table> <a NAME="CodeAssistServer.__init__" ID="CodeAssistServer.__init__"></a> <h4>CodeAssistServer (Constructor)</h4> <b>CodeAssistServer</b>(<i>plugin, parent=None</i>) <p> Constructor </p><dl> <dt><i>plugin</i> (RefactoringRopePlugin)</dt> <dd> reference to the plugin object </dd><dt><i>parent</i> (QObject)</dt> <dd> parent </dd> </dl><a NAME="CodeAssistServer.__configChanged" ID="CodeAssistServer.__configChanged"></a> <h4>CodeAssistServer.__configChanged</h4> <b>__configChanged</b>(<i>idString</i>) <p> Private slot called, when the rope config file has changed. </p><dl> <dt><i>idString</i> (str)</dt> <dd> id for which to get the configuration file </dd> </dl><a NAME="CodeAssistServer.__ensureActive" ID="CodeAssistServer.__ensureActive"></a> <h4>CodeAssistServer.__ensureActive</h4> <b>__ensureActive</b>(<i>idString</i>) <p> Private method to ensure, that the requested client is active. </p><p> A non-active client will be started. </p><dl> <dt><i>idString</i> (str)</dt> <dd> id of the client to be checked </dd> </dl><dl> <dt>Returns:</dt> <dd> flag indicating an active client </dd> </dl><dl> <dt>Return Type:</dt> <dd> bool </dd> </dl><a NAME="CodeAssistServer.__getConfigs" ID="CodeAssistServer.__getConfigs"></a> <h4>CodeAssistServer.__getConfigs</h4> <b>__getConfigs</b>(<i></i>) <p> Private method to get the configurations of all connected clients. </p><a NAME="CodeAssistServer.__processCallTipsResult" ID="CodeAssistServer.__processCallTipsResult"></a> <h4>CodeAssistServer.__processCallTipsResult</h4> <b>__processCallTipsResult</b>(<i>result</i>) <p> Private method to process the calltips sent by the client. </p><dl> <dt><i>result</i> (dict)</dt> <dd> dictionary containing the result sent by the client </dd> </dl><a NAME="CodeAssistServer.__processClientException" ID="CodeAssistServer.__processClientException"></a> <h4>CodeAssistServer.__processClientException</h4> <b>__processClientException</b>(<i>params</i>) <p> Private method to handle exceptions of the refactoring client. </p><dl> <dt><i>params</i> (dict)</dt> <dd> dictionary containing the exception data </dd> </dl><a NAME="CodeAssistServer.__processCompletionsResult" ID="CodeAssistServer.__processCompletionsResult"></a> <h4>CodeAssistServer.__processCompletionsResult</h4> <b>__processCompletionsResult</b>(<i>result</i>) <p> Private method to process the completions sent by the client. </p><dl> <dt><i>result</i> (dict)</dt> <dd> dictionary containing the result sent by the client </dd> </dl><a NAME="CodeAssistServer.__processDocumentationResult" ID="CodeAssistServer.__processDocumentationResult"></a> <h4>CodeAssistServer.__processDocumentationResult</h4> <b>__processDocumentationResult</b>(<i>result</i>) <p> Private method to process the documentation sent by the client. </p><dl> <dt><i>result</i> (dict)</dt> <dd> dictionary containing the result sent by the client </dd> </dl><a NAME="CodeAssistServer.__ropeConfigFile" ID="CodeAssistServer.__ropeConfigFile"></a> <h4>CodeAssistServer.__ropeConfigFile</h4> <b>__ropeConfigFile</b>(<i>idString</i>) <p> Private method to get the name of the rope configuration file. </p><dl> <dt><i>idString</i> (str)</dt> <dd> id for which to get the configuration file </dd> </dl><dl> <dt>Returns:</dt> <dd> name of the rope configuration file </dd> </dl><dl> <dt>Return Type:</dt> <dd> str </dd> </dl><a NAME="CodeAssistServer.__setAutoCompletionHook" ID="CodeAssistServer.__setAutoCompletionHook"></a> <h4>CodeAssistServer.__setAutoCompletionHook</h4> <b>__setAutoCompletionHook</b>(<i>editor</i>) <p> Private method to set the auto-completion hook. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor </dd> </dl><a NAME="CodeAssistServer.__setCalltipsHook" ID="CodeAssistServer.__setCalltipsHook"></a> <h4>CodeAssistServer.__setCalltipsHook</h4> <b>__setCalltipsHook</b>(<i>editor</i>) <p> Private method to set the calltip hook. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor </dd> </dl><a NAME="CodeAssistServer.__setConfig" ID="CodeAssistServer.__setConfig"></a> <h4>CodeAssistServer.__setConfig</h4> <b>__setConfig</b>(<i>params</i>) <p> Private method to set the rope client configuration data. </p><dl> <dt><i>params</i> (dict)</dt> <dd> dictionary containing the configuration data </dd> </dl><a NAME="CodeAssistServer.__startCodeAssistClient" ID="CodeAssistServer.__startCodeAssistClient"></a> <h4>CodeAssistServer.__startCodeAssistClient</h4> <b>__startCodeAssistClient</b>(<i>interpreter, idString</i>) <p> Private method to start the code assist client with the given interpreter. </p><dl> <dt><i>interpreter</i> (str)</dt> <dd> interpreter to be used for the code assist client </dd><dt><i>idString</i> (str)</dt> <dd> id of the client to be started </dd> </dl><dl> <dt>Returns:</dt> <dd> flag indicating a successful start of the client </dd> </dl><dl> <dt>Return Type:</dt> <dd> bool </dd> </dl><a NAME="CodeAssistServer.__unsetAutoCompletionHook" ID="CodeAssistServer.__unsetAutoCompletionHook"></a> <h4>CodeAssistServer.__unsetAutoCompletionHook</h4> <b>__unsetAutoCompletionHook</b>(<i>editor</i>) <p> Private method to unset the auto-completion hook. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor </dd> </dl><a NAME="CodeAssistServer.__unsetCalltipsHook" ID="CodeAssistServer.__unsetCalltipsHook"></a> <h4>CodeAssistServer.__unsetCalltipsHook</h4> <b>__unsetCalltipsHook</b>(<i>editor</i>) <p> Private method to unset the calltip hook. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor </dd> </dl><a NAME="CodeAssistServer.__updateEditorLanguageMapping" ID="CodeAssistServer.__updateEditorLanguageMapping"></a> <h4>CodeAssistServer.__updateEditorLanguageMapping</h4> <b>__updateEditorLanguageMapping</b>(<i></i>) <p> Private method to update the editor language to connection mapping. </p><a NAME="CodeAssistServer.activate" ID="CodeAssistServer.activate"></a> <h4>CodeAssistServer.activate</h4> <b>activate</b>(<i></i>) <p> Public method to activate the code assist server. </p><a NAME="CodeAssistServer.connectEditor" ID="CodeAssistServer.connectEditor"></a> <h4>CodeAssistServer.connectEditor</h4> <b>connectEditor</b>(<i>editor</i>) <p> Public method to connect an editor. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor </dd> </dl><a NAME="CodeAssistServer.deactivate" ID="CodeAssistServer.deactivate"></a> <h4>CodeAssistServer.deactivate</h4> <b>deactivate</b>(<i></i>) <p> Public method to deactivate the code assist server. </p><a NAME="CodeAssistServer.disconnectEditor" ID="CodeAssistServer.disconnectEditor"></a> <h4>CodeAssistServer.disconnectEditor</h4> <b>disconnectEditor</b>(<i>editor</i>) <p> Public method to disconnect an editor. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor </dd> </dl><a NAME="CodeAssistServer.editConfig" ID="CodeAssistServer.editConfig"></a> <h4>CodeAssistServer.editConfig</h4> <b>editConfig</b>(<i>idString</i>) <p> Public slot to open the rope configuration file in an editor. </p><dl> <dt><i>idString</i> (str)</dt> <dd> id for which to get the configuration file </dd> </dl><a NAME="CodeAssistServer.getCallTips" ID="CodeAssistServer.getCallTips"></a> <h4>CodeAssistServer.getCallTips</h4> <b>getCallTips</b>(<i>editor, pos, commas</i>) <p> Public method to calculate calltips. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor object, that called this method </dd><dt><i>pos</i> (int)</dt> <dd> position in the text for the calltip </dd><dt><i>commas</i> (int)</dt> <dd> minimum number of commas contained in the calltip </dd> </dl><dl> <dt>Returns:</dt> <dd> list of possible calltips </dd> </dl><dl> <dt>Return Type:</dt> <dd> list of str </dd> </dl><a NAME="CodeAssistServer.getCompletions" ID="CodeAssistServer.getCompletions"></a> <h4>CodeAssistServer.getCompletions</h4> <b>getCompletions</b>(<i>editor, context</i>) <p> Public method to calculate the possible completions. </p><p> Note: This is the synchronous variant for eric6 before 17.11. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor object, that called this method </dd><dt><i>context</i> (bool)</dt> <dd> flag indicating to autocomplete a context </dd> </dl><dl> <dt>Returns:</dt> <dd> list of possible completions </dd> </dl><dl> <dt>Return Type:</dt> <dd> list of str </dd> </dl><a NAME="CodeAssistServer.handleCall" ID="CodeAssistServer.handleCall"></a> <h4>CodeAssistServer.handleCall</h4> <b>handleCall</b>(<i>method, params</i>) <p> Public method to handle a method call from the client. </p><dl> <dt><i>method</i> (str)</dt> <dd> requested method name </dd><dt><i>params</i> (dict)</dt> <dd> dictionary with method specific parameters </dd> </dl><a NAME="CodeAssistServer.handleNewConnection" ID="CodeAssistServer.handleNewConnection"></a> <h4>CodeAssistServer.handleNewConnection</h4> <b>handleNewConnection</b>(<i></i>) <p> Public slot for new incoming connections from a client. </p><a NAME="CodeAssistServer.isSupportedLanguage" ID="CodeAssistServer.isSupportedLanguage"></a> <h4>CodeAssistServer.isSupportedLanguage</h4> <b>isSupportedLanguage</b>(<i>language</i>) <p> Public method to check, if the given language is supported. </p><dl> <dt><i>language</i> (str)</dt> <dd> editor programming language to check </dd> </dl><dl> <dt>Returns:</dt> <dd> flag indicating the support status </dd> </dl><dl> <dt>Return Type:</dt> <dd> bool </dd> </dl><a NAME="CodeAssistServer.reportChanged" ID="CodeAssistServer.reportChanged"></a> <h4>CodeAssistServer.reportChanged</h4> <b>reportChanged</b>(<i>filename, oldSource</i>) <p> Public slot to report some changed sources. </p><dl> <dt><i>filename</i> (str)</dt> <dd> file name of the changed source </dd><dt><i>oldSource</i> (str)</dt> <dd> source code before the change </dd> </dl><a NAME="CodeAssistServer.requestCodeDocumentation" ID="CodeAssistServer.requestCodeDocumentation"></a> <h4>CodeAssistServer.requestCodeDocumentation</h4> <b>requestCodeDocumentation</b>(<i>editor</i>) <p> Public method to request source code documentation for the given editor. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor to get source code documentation for </dd> </dl><a NAME="CodeAssistServer.requestCompletions" ID="CodeAssistServer.requestCompletions"></a> <h4>CodeAssistServer.requestCompletions</h4> <b>requestCompletions</b>(<i>editor, context, acText</i>) <p> Public method to request a list of possible completions. </p><p> Note: This is part of the asynchronous variant for eric6 17.11 and later. </p><dl> <dt><i>editor</i> (QScintilla.Editor.Editor)</dt> <dd> reference to the editor object, that called this method </dd><dt><i>context</i> (bool)</dt> <dd> flag indicating to autocomplete a context </dd><dt><i>acText</i> (str)</dt> <dd> text to be completed </dd> </dl> <div align="right"><a href="#top">Up</a></div> <hr /> </body></html>