Documentation/Source/eric5.Project.ProjectTranslationsBrowser.html

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN'
'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
<html><head>
<title>eric5.Project.ProjectTranslationsBrowser</title>
<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>eric5.Project.ProjectTranslationsBrowser</h1>
<p>
Module implementing a class used to display the translations part of the project.
</p>
<h3>Global Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>
<h3>Classes</h3>
<table>
<tr>
<td><a href="#ProjectTranslationsBrowser">ProjectTranslationsBrowser</a></td>
<td>A class used to display the translations part of the project.</td>
</tr>
</table>
<h3>Functions</h3>
<table>
<tr><td>None</td></tr>
</table>
<hr /><hr />
<a NAME="ProjectTranslationsBrowser" ID="ProjectTranslationsBrowser"></a>
<h2>ProjectTranslationsBrowser</h2>
<p>
    A class used to display the translations part of the project.
</p><h4>Signals</h4>
<dl>
<dt>appendStderr(str)</dt>
<dd>
emitted after something was received from
            a QProcess on stderr
</dd><dt>appendStdout(str)</dt>
<dd>
emitted after something was received from
            a QProcess on stdout
</dd><dt>closeSourceWindow(str)</dt>
<dd>
emitted after a file has been removed/deleted
            from the project
</dd><dt>linguistFile(str)</dt>
<dd>
emitted to open a translation file with
            Qt-Linguist
</dd><dt>showMenu(str, QMenu)</dt>
<dd>
emitted when a menu is about to be shown. The name
            of the menu and a reference to the menu are given.
</dd><dt>sourceFile(str)</dt>
<dd>
emitted to open a translation file in an editor
</dd><dt>trpreview(list of str, bool = False)</dt>
<dd>
emitted to preview translations in the
            translations previewer
</dd>
</dl>
<h3>Derived from</h3>
ProjectBaseBrowser
<h3>Class Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<td><a href="#ProjectTranslationsBrowser.__init__">ProjectTranslationsBrowser</a></td>
<td>Constructor</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__TRPreview">__TRPreview</a></td>
<td>Private slot to handle the Preview translations action.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__TRPreviewAll">__TRPreviewAll</a></td>
<td>Private slot to handle the Preview all translations action.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__addTranslationFiles">__addTranslationFiles</a></td>
<td>Private method to add translation files to the project.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__deleteLanguageFile">__deleteLanguageFile</a></td>
<td>Private method to delete a translation file from the project.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__extractMessages">__extractMessages</a></td>
<td>Private slot to extract the messages to form a messages template file.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__generateAll">__generateAll</a></td>
<td>Private method to generate all translation files (.ts) for Qt Linguist.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__generateObsoleteAll">__generateObsoleteAll</a></td>
<td>Private method to generate all translation files (.ts) for Qt Linguist.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__generateObsoleteSelected">__generateObsoleteSelected</a></td>
<td>Private method to generate selected translation files (.ts) for Qt Linguist.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__generateSelected">__generateSelected</a></td>
<td>Private method to generate selected translation files (.ts) for Qt Linguist.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__generateTSFile">__generateTSFile</a></td>
<td>Private method used to run pylupdate/pylupdate4 to generate the .ts files.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__generateTSFileDone">__generateTSFileDone</a></td>
<td>Private slot to handle the finished signal of the pylupdate process.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__openFileInEditor">__openFileInEditor</a></td>
<td>Private slot to handle the Open in Editor menu action.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__readStderr">__readStderr</a></td>
<td>Private method to read from a process' stderr channel.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__readStderrLrelease">__readStderrLrelease</a></td>
<td>Private slot to handle the readyReadStandardError signal of the lrelease process.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__readStderrLupdate">__readStderrLupdate</a></td>
<td>Private slot to handle the readyReadStandardError signal of the pylupdate process.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__readStdout">__readStdout</a></td>
<td>Private method to read from a process' stdout channel.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__readStdoutLrelease">__readStdoutLrelease</a></td>
<td>Private slot to handle the readyReadStandardOutput signal of the lrelease process.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__readStdoutLupdate">__readStdoutLupdate</a></td>
<td>Private slot to handle the readyReadStandardOutput signal of the pylupdate process.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__releaseAll">__releaseAll</a></td>
<td>Private method to release the translation files (.qm).</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__releaseSelected">__releaseSelected</a></td>
<td>Private method to release the translation files (.qm).</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__releaseTSFile">__releaseTSFile</a></td>
<td>Private method to run lrelease to release the translation files (.qm).</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__releaseTSFileDone">__releaseTSFileDone</a></td>
<td>Private slot to handle the finished signal of the lrelease process.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__removeLanguageFile">__removeLanguageFile</a></td>
<td>Private method to remove a translation from the project.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__showContextMenu">__showContextMenu</a></td>
<td>Private slot called by the menu aboutToShow signal.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__showContextMenuBack">__showContextMenuBack</a></td>
<td>Private slot called by the backMenu aboutToShow signal.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__showContextMenuDir">__showContextMenuDir</a></td>
<td>Private slot called by the dirMenu aboutToShow signal.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__showContextMenuMulti">__showContextMenuMulti</a></td>
<td>Private slot called by the multiMenu aboutToShow signal.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser.__writeTempProjectFile">__writeTempProjectFile</a></td>
<td>Private method to write a temporary project file suitable for pylupdate and lrelease.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser._contextMenuRequested">_contextMenuRequested</a></td>
<td>Protected slot to show the context menu.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser._createPopupMenus">_createPopupMenus</a></td>
<td>Protected overloaded method to generate the popup menu.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser._initHookMethods">_initHookMethods</a></td>
<td>Protected method to initialize the hooks dictionary.</td>
</tr><tr>
<td><a href="#ProjectTranslationsBrowser._openItem">_openItem</a></td>
<td>Protected slot to handle the open popup menu entry.</td>
</tr>
</table>
<a NAME="ProjectTranslationsBrowser.__init__" ID="ProjectTranslationsBrowser.__init__"></a>
<h4>ProjectTranslationsBrowser (Constructor)</h4>
<b>ProjectTranslationsBrowser</b>(<i>project, parent=None</i>)
<p>
        Constructor
</p><dl>
<dt><i>project</i></dt>
<dd>
reference to the project object
</dd><dt><i>parent</i></dt>
<dd>
parent widget of this browser (QWidget)
</dd>
</dl><a NAME="ProjectTranslationsBrowser.__TRPreview" ID="ProjectTranslationsBrowser.__TRPreview"></a>
<h4>ProjectTranslationsBrowser.__TRPreview</h4>
<b>__TRPreview</b>(<i>previewAll=False</i>)
<p>
        Private slot to handle the Preview translations action.
</p><dl>
<dt><i>previewAll</i></dt>
<dd>
flag indicating, that all translations
            should be previewed (boolean)
</dd>
</dl><a NAME="ProjectTranslationsBrowser.__TRPreviewAll" ID="ProjectTranslationsBrowser.__TRPreviewAll"></a>
<h4>ProjectTranslationsBrowser.__TRPreviewAll</h4>
<b>__TRPreviewAll</b>(<i></i>)
<p>
        Private slot to handle the Preview all translations action.
</p><a NAME="ProjectTranslationsBrowser.__addTranslationFiles" ID="ProjectTranslationsBrowser.__addTranslationFiles"></a>
<h4>ProjectTranslationsBrowser.__addTranslationFiles</h4>
<b>__addTranslationFiles</b>(<i></i>)
<p>
        Private method to add translation files to the project.
</p><a NAME="ProjectTranslationsBrowser.__deleteLanguageFile" ID="ProjectTranslationsBrowser.__deleteLanguageFile"></a>
<h4>ProjectTranslationsBrowser.__deleteLanguageFile</h4>
<b>__deleteLanguageFile</b>(<i></i>)
<p>
        Private method to delete a translation file from the project.
</p><a NAME="ProjectTranslationsBrowser.__extractMessages" ID="ProjectTranslationsBrowser.__extractMessages"></a>
<h4>ProjectTranslationsBrowser.__extractMessages</h4>
<b>__extractMessages</b>(<i></i>)
<p>
        Private slot to extract the messages to form a messages template file.
</p><a NAME="ProjectTranslationsBrowser.__generateAll" ID="ProjectTranslationsBrowser.__generateAll"></a>
<h4>ProjectTranslationsBrowser.__generateAll</h4>
<b>__generateAll</b>(<i></i>)
<p>
        Private method to generate all translation files (.ts) for Qt Linguist.
</p><p>
        All obsolete strings are removed from the .ts file.
</p><a NAME="ProjectTranslationsBrowser.__generateObsoleteAll" ID="ProjectTranslationsBrowser.__generateObsoleteAll"></a>
<h4>ProjectTranslationsBrowser.__generateObsoleteAll</h4>
<b>__generateObsoleteAll</b>(<i></i>)
<p>
        Private method to generate all translation files (.ts) for Qt Linguist.
</p><p>
        Obsolete strings are kept.
</p><a NAME="ProjectTranslationsBrowser.__generateObsoleteSelected" ID="ProjectTranslationsBrowser.__generateObsoleteSelected"></a>
<h4>ProjectTranslationsBrowser.__generateObsoleteSelected</h4>
<b>__generateObsoleteSelected</b>(<i></i>)
<p>
        Private method to generate selected translation files (.ts) for Qt Linguist.
</p><p>
        Obsolete strings are kept.
</p><a NAME="ProjectTranslationsBrowser.__generateSelected" ID="ProjectTranslationsBrowser.__generateSelected"></a>
<h4>ProjectTranslationsBrowser.__generateSelected</h4>
<b>__generateSelected</b>(<i></i>)
<p>
        Private method to generate selected translation files (.ts) for Qt Linguist.
</p><p>
        All obsolete strings are removed from the .ts file.
</p><a NAME="ProjectTranslationsBrowser.__generateTSFile" ID="ProjectTranslationsBrowser.__generateTSFile"></a>
<h4>ProjectTranslationsBrowser.__generateTSFile</h4>
<b>__generateTSFile</b>(<i>noobsolete=False, generateAll=True</i>)
<p>
        Private method used to run pylupdate/pylupdate4 to generate the .ts files.
</p><dl>
<dt><i>noobsolete</i></dt>
<dd>
flag indicating whether obsolete entries should be
            kept (boolean)
</dd><dt><i>generateAll</i></dt>
<dd>
flag indicating whether all translations should be
            generated (boolean)
</dd>
</dl><a NAME="ProjectTranslationsBrowser.__generateTSFileDone" ID="ProjectTranslationsBrowser.__generateTSFileDone"></a>
<h4>ProjectTranslationsBrowser.__generateTSFileDone</h4>
<b>__generateTSFileDone</b>(<i>exitCode, exitStatus</i>)
<p>
        Private slot to handle the finished signal of the pylupdate process.
</p><dl>
<dt><i>exitCode</i></dt>
<dd>
exit code of the process (integer)
</dd><dt><i>exitStatus</i></dt>
<dd>
exit status of the process (QProcess.ExitStatus)
</dd>
</dl><a NAME="ProjectTranslationsBrowser.__openFileInEditor" ID="ProjectTranslationsBrowser.__openFileInEditor"></a>
<h4>ProjectTranslationsBrowser.__openFileInEditor</h4>
<b>__openFileInEditor</b>(<i></i>)
<p>
        Private slot to handle the Open in Editor menu action.
</p><a NAME="ProjectTranslationsBrowser.__readStderr" ID="ProjectTranslationsBrowser.__readStderr"></a>
<h4>ProjectTranslationsBrowser.__readStderr</h4>
<b>__readStderr</b>(<i>proc, ps</i>)
<p>
        Private method to read from a process' stderr channel.
</p><dl>
<dt><i>proc</i></dt>
<dd>
process to read from (QProcess)
</dd><dt><i>ps</i></dt>
<dd>
propmt string (string)
</dd>
</dl><a NAME="ProjectTranslationsBrowser.__readStderrLrelease" ID="ProjectTranslationsBrowser.__readStderrLrelease"></a>
<h4>ProjectTranslationsBrowser.__readStderrLrelease</h4>
<b>__readStderrLrelease</b>(<i></i>)
<p>
        Private slot to handle the readyReadStandardError signal of the
        lrelease process.
</p><a NAME="ProjectTranslationsBrowser.__readStderrLupdate" ID="ProjectTranslationsBrowser.__readStderrLupdate"></a>
<h4>ProjectTranslationsBrowser.__readStderrLupdate</h4>
<b>__readStderrLupdate</b>(<i></i>)
<p>
        Private slot to handle the readyReadStandardError signal of the
        pylupdate process.
</p><a NAME="ProjectTranslationsBrowser.__readStdout" ID="ProjectTranslationsBrowser.__readStdout"></a>
<h4>ProjectTranslationsBrowser.__readStdout</h4>
<b>__readStdout</b>(<i>proc, ps</i>)
<p>
        Private method to read from a process' stdout channel.
</p><dl>
<dt><i>proc</i></dt>
<dd>
process to read from (QProcess)
</dd><dt><i>ps</i></dt>
<dd>
prompt string (string)
</dd>
</dl><a NAME="ProjectTranslationsBrowser.__readStdoutLrelease" ID="ProjectTranslationsBrowser.__readStdoutLrelease"></a>
<h4>ProjectTranslationsBrowser.__readStdoutLrelease</h4>
<b>__readStdoutLrelease</b>(<i></i>)
<p>
        Private slot to handle the readyReadStandardOutput signal of the
        lrelease process.
</p><a NAME="ProjectTranslationsBrowser.__readStdoutLupdate" ID="ProjectTranslationsBrowser.__readStdoutLupdate"></a>
<h4>ProjectTranslationsBrowser.__readStdoutLupdate</h4>
<b>__readStdoutLupdate</b>(<i></i>)
<p>
        Private slot to handle the readyReadStandardOutput signal of the
        pylupdate process.
</p><a NAME="ProjectTranslationsBrowser.__releaseAll" ID="ProjectTranslationsBrowser.__releaseAll"></a>
<h4>ProjectTranslationsBrowser.__releaseAll</h4>
<b>__releaseAll</b>(<i></i>)
<p>
        Private method to release the translation files (.qm).
</p><a NAME="ProjectTranslationsBrowser.__releaseSelected" ID="ProjectTranslationsBrowser.__releaseSelected"></a>
<h4>ProjectTranslationsBrowser.__releaseSelected</h4>
<b>__releaseSelected</b>(<i></i>)
<p>
        Private method to release the translation files (.qm).
</p><a NAME="ProjectTranslationsBrowser.__releaseTSFile" ID="ProjectTranslationsBrowser.__releaseTSFile"></a>
<h4>ProjectTranslationsBrowser.__releaseTSFile</h4>
<b>__releaseTSFile</b>(<i>generateAll=False</i>)
<p>
        Private method to run lrelease to release the translation files (.qm).
</p><dl>
<dt><i>generateAll</i></dt>
<dd>
flag indicating whether all translations should be
            released (boolean)
</dd>
</dl><a NAME="ProjectTranslationsBrowser.__releaseTSFileDone" ID="ProjectTranslationsBrowser.__releaseTSFileDone"></a>
<h4>ProjectTranslationsBrowser.__releaseTSFileDone</h4>
<b>__releaseTSFileDone</b>(<i>exitCode, exitStatus</i>)
<p>
        Private slot to handle the finished signal of the lrelease process.
</p><a NAME="ProjectTranslationsBrowser.__removeLanguageFile" ID="ProjectTranslationsBrowser.__removeLanguageFile"></a>
<h4>ProjectTranslationsBrowser.__removeLanguageFile</h4>
<b>__removeLanguageFile</b>(<i></i>)
<p>
        Private method to remove a translation from the project.
</p><a NAME="ProjectTranslationsBrowser.__showContextMenu" ID="ProjectTranslationsBrowser.__showContextMenu"></a>
<h4>ProjectTranslationsBrowser.__showContextMenu</h4>
<b>__showContextMenu</b>(<i></i>)
<p>
        Private slot called by the menu aboutToShow signal.
</p><a NAME="ProjectTranslationsBrowser.__showContextMenuBack" ID="ProjectTranslationsBrowser.__showContextMenuBack"></a>
<h4>ProjectTranslationsBrowser.__showContextMenuBack</h4>
<b>__showContextMenuBack</b>(<i></i>)
<p>
        Private slot called by the backMenu aboutToShow signal.
</p><a NAME="ProjectTranslationsBrowser.__showContextMenuDir" ID="ProjectTranslationsBrowser.__showContextMenuDir"></a>
<h4>ProjectTranslationsBrowser.__showContextMenuDir</h4>
<b>__showContextMenuDir</b>(<i></i>)
<p>
        Private slot called by the dirMenu aboutToShow signal.
</p><a NAME="ProjectTranslationsBrowser.__showContextMenuMulti" ID="ProjectTranslationsBrowser.__showContextMenuMulti"></a>
<h4>ProjectTranslationsBrowser.__showContextMenuMulti</h4>
<b>__showContextMenuMulti</b>(<i></i>)
<p>
        Private slot called by the multiMenu aboutToShow signal.
</p><a NAME="ProjectTranslationsBrowser.__writeTempProjectFile" ID="ProjectTranslationsBrowser.__writeTempProjectFile"></a>
<h4>ProjectTranslationsBrowser.__writeTempProjectFile</h4>
<b>__writeTempProjectFile</b>(<i>langs, filter</i>)
<p>
        Private method to write a temporary project file suitable for pylupdate and
        lrelease.
</p><dl>
<dt><i>langs</i></dt>
<dd>
list of languages to include in the process. An empty list (default)
            means that all translations should be included.
            (list of ProjectBrowserFileItem)
</dd><dt><i>filter</i></dt>
<dd>
list of source file extension that should be considered
            (list of strings)
</dd>
</dl><dl>
<dt>Returns:</dt>
<dd>
flag indicating success
</dd>
</dl><a NAME="ProjectTranslationsBrowser._contextMenuRequested" ID="ProjectTranslationsBrowser._contextMenuRequested"></a>
<h4>ProjectTranslationsBrowser._contextMenuRequested</h4>
<b>_contextMenuRequested</b>(<i>coord</i>)
<p>
        Protected slot to show the context menu.
</p><dl>
<dt><i>coord</i></dt>
<dd>
the position of the mouse pointer (QPoint)
</dd>
</dl><a NAME="ProjectTranslationsBrowser._createPopupMenus" ID="ProjectTranslationsBrowser._createPopupMenus"></a>
<h4>ProjectTranslationsBrowser._createPopupMenus</h4>
<b>_createPopupMenus</b>(<i></i>)
<p>
        Protected overloaded method to generate the popup menu.
</p><a NAME="ProjectTranslationsBrowser._initHookMethods" ID="ProjectTranslationsBrowser._initHookMethods"></a>
<h4>ProjectTranslationsBrowser._initHookMethods</h4>
<b>_initHookMethods</b>(<i></i>)
<p>
        Protected method to initialize the hooks dictionary.
</p><p>
        Supported hook methods are:
        <ul>
        <li>extractMessages: takes no parameters</li>
        <li>generateAll: takes list of filenames as parameter</li>
        <li>generateAllWithObsolete: takes list of filenames as parameter</li>
        <li>generateSelected: takes list of filenames as parameter</li>
        <li>generateSelectedWithObsolete: takes list of filenames as parameter</li>
        <li>releaseAll: takes list of filenames as parameter</li>
        <li>releaseSelected: takes list of filenames as parameter</li>
        </ul>
</p><p>
        <b>Note</b>: Filenames are relative to the project directory.
</p><a NAME="ProjectTranslationsBrowser._openItem" ID="ProjectTranslationsBrowser._openItem"></a>
<h4>ProjectTranslationsBrowser._openItem</h4>
<b>_openItem</b>(<i></i>)
<p>
        Protected slot to handle the open popup menu entry.
</p>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>