RefactoringRope/Documentation/source/Plugin_Refactoring_Rope.PluginRefactoringRope.html

<!DOCTYPE html>
<html><head>
<title>Plugin_Refactoring_Rope.PluginRefactoringRope</title>
<meta charset="UTF-8">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<a NAME="top" ID="top"></a>
<h1>Plugin_Refactoring_Rope.PluginRefactoringRope</h1>

<p>
Module implementing the Rope refactoring plugin.
</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>doNotCompile</td></tr><tr><td>error</td></tr><tr><td>internalPackages</td></tr><tr><td>longDescription</td></tr><tr><td>name</td></tr><tr><td>packageName</td></tr><tr><td>pyqtApi</td></tr><tr><td>refactoringRopePluginObject</td></tr><tr><td>shortDescription</td></tr><tr><td>version</td></tr>
</table>
<h3>Classes</h3>

<table>

<tr>
<td><a href="#RefactoringRopePlugin">RefactoringRopePlugin</a></td>
<td>Class implementing the Rope refactoring plugin.</td>
</tr>
</table>
<h3>Functions</h3>

<table>

<tr>
<td><a href="#createAutoCompletionPage">createAutoCompletionPage</a></td>
<td>Module function to create the autocompletion configuration page.</td>
</tr>
<tr>
<td><a href="#createCallTipsPage">createCallTipsPage</a></td>
<td>Module function to create the calltips configuration page.</td>
</tr>
<tr>
<td><a href="#createMouseClickHandlerPage">createMouseClickHandlerPage</a></td>
<td>Module function to create the mouse click handler configuration page.</td>
</tr>
<tr>
<td><a href="#getConfigData">getConfigData</a></td>
<td>Module function returning data as required by the configuration dialog.</td>
</tr>
<tr>
<td><a href="#installDependencies">installDependencies</a></td>
<td>Function to install dependencies of this plug-in.</td>
</tr>
<tr>
<td><a href="#prepareUninstall">prepareUninstall</a></td>
<td>Module function to prepare for an uninstallation.</td>
</tr>
</table>
<hr />
<hr />
<a NAME="RefactoringRopePlugin" ID="RefactoringRopePlugin"></a>
<h2>RefactoringRopePlugin</h2>

<p>
    Class implementing the Rope refactoring plugin.
</p>
<h3>Derived from</h3>
QObject
<h3>Class Attributes</h3>

<table>
<tr><td>PreferencesKey</td></tr>
</table>
<h3>Class Methods</h3>

<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>

<table>

<tr>
<td><a href="#RefactoringRopePlugin.__init__">RefactoringRopePlugin</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__connectEditor">__connectEditor</a></td>
<td>Private method to connect an editor.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__connectMouseClickHandler">__connectMouseClickHandler</a></td>
<td>Private method to connect the mouse click handler to an editor.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__determineLanguage">__determineLanguage</a></td>
<td>Private method to determine the valid language strings.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__disconnectEditor">__disconnectEditor</a></td>
<td>Private method to disconnect an editor.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__disconnectMouseClickHandler">__disconnectMouseClickHandler</a></td>
<td>Private method to disconnect the mouse click handler from an editor.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__editorAboutToBeSaved">__editorAboutToBeSaved</a></td>
<td>Private slot to get the old contents of the named file.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__editorClosed">__editorClosed</a></td>
<td>Private slot called, when an editor was closed.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__editorLanguageChanged">__editorLanguageChanged</a></td>
<td>Private slot to handle the language change of an editor.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__editorOpened">__editorOpened</a></td>
<td>Private slot called, when a new editor was opened.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__editorSaved">__editorSaved</a></td>
<td>Private slot to activate SOA.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__initialize">__initialize</a></td>
<td>Private slot to (re)initialize the plugin.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__loadTranslator">__loadTranslator</a></td>
<td>Private method to load the translation file.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__setAutoCompletionHook">__setAutoCompletionHook</a></td>
<td>Private method to set the autocompletion hook.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__setCalltipsHook">__setCalltipsHook</a></td>
<td>Private method to set the calltip hook.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__shutdown">__shutdown</a></td>
<td>Private slot handling the shutdown signal of the plug-in manager.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__unsetAutoCompletionHook">__unsetAutoCompletionHook</a></td>
<td>Private method to unset the autocompletion hook.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.__unsetCalltipsHook">__unsetCalltipsHook</a></td>
<td>Private method to unset the calltip hook.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.activate">activate</a></td>
<td>Public method to activate this plugin.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.deactivate">deactivate</a></td>
<td>Public method to deactivate this plugin.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.getCodeAssistServer">getCodeAssistServer</a></td>
<td>Public method to get a reference to the code assist server.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.getPreferences">getPreferences</a></td>
<td>Public method to retrieve the various refactoring settings.</td>
</tr>
<tr>
<td><a href="#RefactoringRopePlugin.setPreferences">setPreferences</a></td>
<td>Public method to store the various refactoring settings.</td>
</tr>
</table>
<h3>Static Methods</h3>

<table>
<tr><td>None</td></tr>
</table>

<a NAME="RefactoringRopePlugin.__init__" ID="RefactoringRopePlugin.__init__"></a>
<h4>RefactoringRopePlugin (Constructor)</h4>
<b>RefactoringRopePlugin</b>(<i>ui</i>)

<p>
        Constructor
</p>
<dl>

<dt><i>ui</i> (UserInterface)</dt>
<dd>
reference to the user interface object
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__connectEditor" ID="RefactoringRopePlugin.__connectEditor"></a>
<h4>RefactoringRopePlugin.__connectEditor</h4>
<b>__connectEditor</b>(<i>editor</i>)

<p>
        Private method to connect an editor.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__connectMouseClickHandler" ID="RefactoringRopePlugin.__connectMouseClickHandler"></a>
<h4>RefactoringRopePlugin.__connectMouseClickHandler</h4>
<b>__connectMouseClickHandler</b>(<i>editor</i>)

<p>
        Private method to connect the mouse click handler to an editor.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__determineLanguage" ID="RefactoringRopePlugin.__determineLanguage"></a>
<h4>RefactoringRopePlugin.__determineLanguage</h4>
<b>__determineLanguage</b>(<i></i>)

<p>
        Private method to determine the valid language strings.
</p>
<dl>
<dt>Return:</dt>
<dd>
list of valid language strings
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
list of str
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__disconnectEditor" ID="RefactoringRopePlugin.__disconnectEditor"></a>
<h4>RefactoringRopePlugin.__disconnectEditor</h4>
<b>__disconnectEditor</b>(<i>editor</i>)

<p>
        Private method to disconnect an editor.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__disconnectMouseClickHandler" ID="RefactoringRopePlugin.__disconnectMouseClickHandler"></a>
<h4>RefactoringRopePlugin.__disconnectMouseClickHandler</h4>
<b>__disconnectMouseClickHandler</b>(<i>editor</i>)

<p>
        Private method to disconnect the mouse click handler from an editor.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__editorAboutToBeSaved" ID="RefactoringRopePlugin.__editorAboutToBeSaved"></a>
<h4>RefactoringRopePlugin.__editorAboutToBeSaved</h4>
<b>__editorAboutToBeSaved</b>(<i>filename</i>)

<p>
        Private slot to get the old contents of the named file.
</p>
<dl>

<dt><i>filename</i> (str)</dt>
<dd>
name of the file about to be saved
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__editorClosed" ID="RefactoringRopePlugin.__editorClosed"></a>
<h4>RefactoringRopePlugin.__editorClosed</h4>
<b>__editorClosed</b>(<i>editor</i>)

<p>
        Private slot called, when an editor was closed.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__editorLanguageChanged" ID="RefactoringRopePlugin.__editorLanguageChanged"></a>
<h4>RefactoringRopePlugin.__editorLanguageChanged</h4>
<b>__editorLanguageChanged</b>(<i>language</i>)

<p>
        Private slot to handle the language change of an editor.
</p>
<dl>

<dt><i>language</i> (str)</dt>
<dd>
programming language of the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__editorOpened" ID="RefactoringRopePlugin.__editorOpened"></a>
<h4>RefactoringRopePlugin.__editorOpened</h4>
<b>__editorOpened</b>(<i>editor</i>)

<p>
        Private slot called, when a new editor was opened.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the new editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__editorSaved" ID="RefactoringRopePlugin.__editorSaved"></a>
<h4>RefactoringRopePlugin.__editorSaved</h4>
<b>__editorSaved</b>(<i>filename</i>)

<p>
        Private slot to activate SOA.
</p>
<dl>

<dt><i>filename</i> (str)</dt>
<dd>
name of the file that was saved
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__initialize" ID="RefactoringRopePlugin.__initialize"></a>
<h4>RefactoringRopePlugin.__initialize</h4>
<b>__initialize</b>(<i></i>)

<p>
        Private slot to (re)initialize the plugin.
</p>
<a NAME="RefactoringRopePlugin.__loadTranslator" ID="RefactoringRopePlugin.__loadTranslator"></a>
<h4>RefactoringRopePlugin.__loadTranslator</h4>
<b>__loadTranslator</b>(<i></i>)

<p>
        Private method to load the translation file.
</p>
<a NAME="RefactoringRopePlugin.__setAutoCompletionHook" ID="RefactoringRopePlugin.__setAutoCompletionHook"></a>
<h4>RefactoringRopePlugin.__setAutoCompletionHook</h4>
<b>__setAutoCompletionHook</b>(<i>editor</i>)

<p>
        Private method to set the autocompletion hook.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__setCalltipsHook" ID="RefactoringRopePlugin.__setCalltipsHook"></a>
<h4>RefactoringRopePlugin.__setCalltipsHook</h4>
<b>__setCalltipsHook</b>(<i>editor</i>)

<p>
        Private method to set the calltip hook.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__shutdown" ID="RefactoringRopePlugin.__shutdown"></a>
<h4>RefactoringRopePlugin.__shutdown</h4>
<b>__shutdown</b>(<i></i>)

<p>
        Private slot handling the shutdown signal of the plug-in manager.
</p>
<a NAME="RefactoringRopePlugin.__unsetAutoCompletionHook" ID="RefactoringRopePlugin.__unsetAutoCompletionHook"></a>
<h4>RefactoringRopePlugin.__unsetAutoCompletionHook</h4>
<b>__unsetAutoCompletionHook</b>(<i>editor</i>)

<p>
        Private method to unset the autocompletion hook.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.__unsetCalltipsHook" ID="RefactoringRopePlugin.__unsetCalltipsHook"></a>
<h4>RefactoringRopePlugin.__unsetCalltipsHook</h4>
<b>__unsetCalltipsHook</b>(<i>editor</i>)

<p>
        Private method to unset the calltip hook.
</p>
<dl>

<dt><i>editor</i> (Editor)</dt>
<dd>
reference to the editor
</dd>
</dl>
<a NAME="RefactoringRopePlugin.activate" ID="RefactoringRopePlugin.activate"></a>
<h4>RefactoringRopePlugin.activate</h4>
<b>activate</b>(<i></i>)

<p>
        Public method to activate this plugin.
</p>
<dl>
<dt>Return:</dt>
<dd>
tuple of None and activation status
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
tuple of (None, bool)
</dd>
</dl>
<a NAME="RefactoringRopePlugin.deactivate" ID="RefactoringRopePlugin.deactivate"></a>
<h4>RefactoringRopePlugin.deactivate</h4>
<b>deactivate</b>(<i></i>)

<p>
        Public method to deactivate this plugin.
</p>
<a NAME="RefactoringRopePlugin.getCodeAssistServer" ID="RefactoringRopePlugin.getCodeAssistServer"></a>
<h4>RefactoringRopePlugin.getCodeAssistServer</h4>
<b>getCodeAssistServer</b>(<i></i>)

<p>
        Public method to get a reference to the code assist server.
</p>
<dl>
<dt>Return:</dt>
<dd>
reference to the code assist server
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
CodeAssistServer
</dd>
</dl>
<a NAME="RefactoringRopePlugin.getPreferences" ID="RefactoringRopePlugin.getPreferences"></a>
<h4>RefactoringRopePlugin.getPreferences</h4>
<b>getPreferences</b>(<i>key</i>)

<p>
        Public method to retrieve the various refactoring settings.
</p>
<dl>

<dt><i>key</i> (str)</dt>
<dd>
the key of the value to get
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
the requested refactoring setting
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
Any
</dd>
</dl>
<a NAME="RefactoringRopePlugin.setPreferences" ID="RefactoringRopePlugin.setPreferences"></a>
<h4>RefactoringRopePlugin.setPreferences</h4>
<b>setPreferences</b>(<i>key, value</i>)

<p>
        Public method to store the various refactoring settings.
</p>
<dl>

<dt><i>key</i> (str)</dt>
<dd>
the key of the setting to be set
</dd>
<dt><i>value</i> (Any)</dt>
<dd>
the value to be set
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="createAutoCompletionPage" ID="createAutoCompletionPage"></a>
<h2>createAutoCompletionPage</h2>
<b>createAutoCompletionPage</b>(<i>configDlg</i>)

<p>
    Module function to create the autocompletion configuration page.
</p>
<dl>

<dt><i>configDlg</i> (ConfigurationWidget)</dt>
<dd>
reference to the configuration dialog
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
reference to the configuration page
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
AutoCompletionRopePage
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="createCallTipsPage" ID="createCallTipsPage"></a>
<h2>createCallTipsPage</h2>
<b>createCallTipsPage</b>(<i>configDlg</i>)

<p>
    Module function to create the calltips configuration page.
</p>
<dl>

<dt><i>configDlg</i> (ConfigurationWidget)</dt>
<dd>
reference to the configuration dialog
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
reference to the configuration page
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
CallTipsRopePage
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="createMouseClickHandlerPage" ID="createMouseClickHandlerPage"></a>
<h2>createMouseClickHandlerPage</h2>
<b>createMouseClickHandlerPage</b>(<i>configDlg</i>)

<p>
    Module function to create the mouse click handler configuration page.
</p>
<dl>

<dt><i>configDlg</i> (ConfigurationWidget)</dt>
<dd>
reference to the configuration dialog
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
reference to the configuration page
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
MouseClickHandlerRopePage
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="getConfigData" ID="getConfigData"></a>
<h2>getConfigData</h2>
<b>getConfigData</b>(<i></i>)

<p>
    Module function returning data as required by the configuration dialog.
</p>
<dl>
<dt>Return:</dt>
<dd>
dictionary containing the relevant data
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
dict
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="installDependencies" ID="installDependencies"></a>
<h2>installDependencies</h2>
<b>installDependencies</b>(<i>pipInstall</i>)

<p>
    Function to install dependencies of this plug-in.
</p>
<dl>

<dt><i>pipInstall</i> (function)</dt>
<dd>
function to be called with a list of package names.
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="prepareUninstall" ID="prepareUninstall"></a>
<h2>prepareUninstall</h2>
<b>prepareUninstall</b>(<i></i>)

<p>
    Module function to prepare for an uninstallation.
</p>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>