--- a/ProjectPyramid/Documentation/source/Plugin_Project_Pyramid.ProjectPyramid.Project.html Wed Jan 01 11:58:58 2020 +0100 +++ b/ProjectPyramid/Documentation/source/Plugin_Project_Pyramid.ProjectPyramid.Project.html Thu Apr 09 18:16:19 2020 +0200 @@ -18,815 +18,1086 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>Plugin_Project_Pyramid.ProjectPyramid.Project</h1> + <p> Module implementing the Pyramid project support. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#Project">Project</a></td> <td>Class implementing the Pyramid project support.</td> -</tr><tr> +</tr> +<tr> <td><a href="#PyramidNoProjectSelectedException">PyramidNoProjectSelectedException</a></td> <td>Exception thrown to signal, that there is no current Pyramid project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#QProcess">QProcess</a></td> <td>Class transforming the call arguments in case of gnome-terminal.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="Project" ID="Project"></a> <h2>Project</h2> + <p> Class implementing the Pyramid project support. </p> <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="#Project.__init__">Project</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__adjustWorkingDirectory">__adjustWorkingDirectory</a></td> <td>Private method to adjust the working directory in the arguments list.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__buildDistribution">__buildDistribution</a></td> <td>Private slot to build a distribution file for the current Pyramid project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__createProject">__createProject</a></td> <td>Private slot to create a new Pyramid project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__findProjects">__findProjects</a></td> <td>Private method to determine the relative path of all Pyramid projects (= top level dirs).</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__getDebugEnvironment">__getDebugEnvironment</a></td> <td>Private method to get the path of the debugger environment.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__getExecutablePaths">__getExecutablePaths</a></td> <td>Private method to build all full paths of an executable file from the environment.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__getInitDbCommand">__getInitDbCommand</a></td> <td>Private method to create the path to the initialization script.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__getLocale">__getLocale</a></td> <td>Private method to extract the locale out of a file name.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__getVirtualEnvironment">__getVirtualEnvironment</a></td> <td>Private method to get the path of the virtual environment.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__initializeDatabase">__initializeDatabase</a></td> <td>Private slot to initialize the database of the Pyramid project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__isSuitableForVariant">__isSuitableForVariant</a></td> <td>Private method to test, if a detected command file is suitable for the given Python variant.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__normalizeList">__normalizeList</a></td> <td>Private method to normalize a list of file names.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__project">__project</a></td> <td>Private method to get the name of the current Pyramid project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__projectFilteredList">__projectFilteredList</a></td> <td>Private method to filter a list of file names by Pyramid project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__projectLanguageAdded">__projectLanguageAdded</a></td> <td>Private slot handling the addition of a new language.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__projectPath">__projectPath</a></td> <td>Private method to calculate the full path of the Pyramid project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__pyramidInfo">__pyramidInfo</a></td> <td>Private slot to show some info about Pyramid.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__runBrowser">__runBrowser</a></td> <td>Private slot to start the default web browser with the server URL.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__runLoggingServer">__runLoggingServer</a></td> <td>Private slot to start the Pyramid Web server with logging.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__runPythonShell">__runPythonShell</a></td> <td>Private slot to start a Python console for a Pyramid project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__runServer">__runServer</a></td> <td>Private slot to start the Pyramid Web server.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__selectProject">__selectProject</a></td> <td>Private method to select a Pyramid project to work with.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__serverProcFinished">__serverProcFinished</a></td> <td>Private slot connected to the finished signal.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__setCurrentProject">__setCurrentProject</a></td> <td>Private slot to set the current project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__setupDevelop">__setupDevelop</a></td> <td>Private slot to set up the development environment for the current project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__showDocumentation">__showDocumentation</a></td> <td>Private slot to show the helpviewer with the Pyramid documentation.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__showMatchingViews">__showMatchingViews</a></td> <td>Private slot showing all views that would match a given URL.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__showRoutes">__showRoutes</a></td> <td>Private slot showing all URL dispatch routes.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.__showTweens">__showTweens</a></td> <td>Private slot showing all implicit and explicit tween objects.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.compileCatalogs">compileCatalogs</a></td> <td>Public method to compile the message catalogs.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.compileSelectedCatalogs">compileSelectedCatalogs</a></td> <td>Public method to update the message catalogs.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.extractMessages">extractMessages</a></td> <td>Public method to extract the messages catalog template file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.getMenu">getMenu</a></td> <td>Public method to get a reference to the requested menu.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.getMenuNames">getMenuNames</a></td> <td>Public method to get the names of all menus.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.getPyramidCommand">getPyramidCommand</a></td> <td>Public method to build a Pyramid command.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.getPyramidVersion">getPyramidVersion</a></td> <td>Public method to get the Pyramid version as a tuple.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.getPyramidVersionString">getPyramidVersionString</a></td> <td>Public method to get the Pyramid version as a string.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.getPythonCommand">getPythonCommand</a></td> <td>Public method to build the Python command.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.initActions">initActions</a></td> <td>Public method to define the Pyramid actions.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.initMenu">initMenu</a></td> <td>Public slot to initialize the Pyramid menu.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.isSpawningConsole">isSpawningConsole</a></td> <td>Public method to check, if the given console is a spawning console.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.newForm">newForm</a></td> <td>Public method to create a new form.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.openPOEditor">openPOEditor</a></td> <td>Public method to edit the given file in an external .po editor.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.projectClosed">projectClosed</a></td> <td>Public method to handle the closing of a project.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.projectClosedHooks">projectClosedHooks</a></td> <td>Public method to remove our hook methods.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.projectOpenedHooks">projectOpenedHooks</a></td> <td>Public method to add our hook methods.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.registerOpenHook">registerOpenHook</a></td> <td>Public method to register the open hook to open a translations file in a translations editor.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.supportedPythonVariants">supportedPythonVariants</a></td> <td>Public method to get the supported Python variants.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.updateCatalogs">updateCatalogs</a></td> <td>Public method to update the message catalogs.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Project.updateSelectedCatalogs">updateSelectedCatalogs</a></td> <td>Public method to update the message catalogs.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="Project.__init__" ID="Project.__init__"></a> <h4>Project (Constructor)</h4> -<b>Project</b>(<i>plugin, parent=None</i>) +<b>Project</b>(<i>plugin, iconSuffix, parent=None</i>) + <p> Constructor -</p><dl> -<dt><i>plugin</i></dt> +</p> +<dl> + +<dt><i>plugin</i> (ProjectPyramidPlugin)</dt> <dd> reference to the plugin object -</dd><dt><i>parent</i></dt> +</dd> +<dt><i>iconSuffix</i> (str)</dt> <dd> -parent (QObject) +suffix for the icons </dd> -</dl><a NAME="Project.__adjustWorkingDirectory" ID="Project.__adjustWorkingDirectory"></a> +<dt><i>parent</i> (QObject)</dt> +<dd> +parent +</dd> +</dl> +<a NAME="Project.__adjustWorkingDirectory" ID="Project.__adjustWorkingDirectory"></a> <h4>Project.__adjustWorkingDirectory</h4> <b>__adjustWorkingDirectory</b>(<i>args, wd</i>) + <p> Private method to adjust the working directory in the arguments list. -</p><dl> +</p> +<dl> + <dt><i>args</i> (list of str)</dt> <dd> list of arguments to be modified -</dd><dt><i>wd</i> (str)</dt> +</dd> +<dt><i>wd</i> (str)</dt> <dd> working directory </dd> -</dl><a NAME="Project.__buildDistribution" ID="Project.__buildDistribution"></a> +</dl> +<a NAME="Project.__buildDistribution" ID="Project.__buildDistribution"></a> <h4>Project.__buildDistribution</h4> <b>__buildDistribution</b>(<i></i>) + <p> Private slot to build a distribution file for the current Pyramid project. -</p><a NAME="Project.__createProject" ID="Project.__createProject"></a> +</p> +<a NAME="Project.__createProject" ID="Project.__createProject"></a> <h4>Project.__createProject</h4> <b>__createProject</b>(<i></i>) + <p> Private slot to create a new Pyramid project. -</p><a NAME="Project.__findProjects" ID="Project.__findProjects"></a> +</p> +<a NAME="Project.__findProjects" ID="Project.__findProjects"></a> <h4>Project.__findProjects</h4> <b>__findProjects</b>(<i></i>) + <p> Private method to determine the relative path of all Pyramid projects (= top level dirs). -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> list of projects (list of string) </dd> -</dl><a NAME="Project.__getDebugEnvironment" ID="Project.__getDebugEnvironment"></a> +</dl> +<a NAME="Project.__getDebugEnvironment" ID="Project.__getDebugEnvironment"></a> <h4>Project.__getDebugEnvironment</h4> <b>__getDebugEnvironment</b>(<i>language=""</i>) + <p> Private method to get the path of the debugger environment. -</p><dl> +</p> +<dl> + <dt><i>language</i></dt> <dd> Python variant to get the debugger environment for (string, one of '', 'Python2' or 'Python3') </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> path of the debugger environment (string) </dd> -</dl><a NAME="Project.__getExecutablePaths" ID="Project.__getExecutablePaths"></a> +</dl> +<a NAME="Project.__getExecutablePaths" ID="Project.__getExecutablePaths"></a> <h4>Project.__getExecutablePaths</h4> <b>__getExecutablePaths</b>(<i>file</i>) + <p> Private method to build all full paths of an executable file from the environment. -</p><dl> +</p> +<dl> + <dt><i>file</i></dt> <dd> filename of the executable (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> list of full executable names, if the executable file is accessible via the searchpath defined by the PATH environment variable, or an empty list otherwise. </dd> -</dl><a NAME="Project.__getInitDbCommand" ID="Project.__getInitDbCommand"></a> +</dl> +<a NAME="Project.__getInitDbCommand" ID="Project.__getInitDbCommand"></a> <h4>Project.__getInitDbCommand</h4> <b>__getInitDbCommand</b>(<i></i>) + <p> Private method to create the path to the initialization script. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> path to the initialization script (string) </dd> -</dl><a NAME="Project.__getLocale" ID="Project.__getLocale"></a> +</dl> +<a NAME="Project.__getLocale" ID="Project.__getLocale"></a> <h4>Project.__getLocale</h4> <b>__getLocale</b>(<i>filename</i>) + <p> Private method to extract the locale out of a file name. -</p><dl> +</p> +<dl> + <dt><i>filename</i></dt> <dd> name of the file used for extraction (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> extracted locale (string) or None </dd> -</dl><a NAME="Project.__getVirtualEnvironment" ID="Project.__getVirtualEnvironment"></a> +</dl> +<a NAME="Project.__getVirtualEnvironment" ID="Project.__getVirtualEnvironment"></a> <h4>Project.__getVirtualEnvironment</h4> <b>__getVirtualEnvironment</b>(<i>language=""</i>) + <p> Private method to get the path of the virtual environment. -</p><dl> +</p> +<dl> + <dt><i>language</i></dt> <dd> Python variant to get the virtual environment for (string, one of '', 'Python2' or 'Python3') </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> path of the virtual environment (string) </dd> -</dl><a NAME="Project.__initializeDatabase" ID="Project.__initializeDatabase"></a> +</dl> +<a NAME="Project.__initializeDatabase" ID="Project.__initializeDatabase"></a> <h4>Project.__initializeDatabase</h4> <b>__initializeDatabase</b>(<i></i>) + <p> Private slot to initialize the database of the Pyramid project. -</p><a NAME="Project.__isSuitableForVariant" ID="Project.__isSuitableForVariant"></a> +</p> +<a NAME="Project.__isSuitableForVariant" ID="Project.__isSuitableForVariant"></a> <h4>Project.__isSuitableForVariant</h4> <b>__isSuitableForVariant</b>(<i>variant, line0</i>) + <p> Private method to test, if a detected command file is suitable for the given Python variant. -</p><dl> +</p> +<dl> + <dt><i>variant</i> (str (one of Python2 or Python3))</dt> <dd> Python variant to test for -</dd><dt><i>line0</i> (str)</dt> +</dd> +<dt><i>line0</i> (str)</dt> <dd> first line of the executable </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> flag indicating a suitable command </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="Project.__normalizeList" ID="Project.__normalizeList"></a> +</dl> +<a NAME="Project.__normalizeList" ID="Project.__normalizeList"></a> <h4>Project.__normalizeList</h4> <b>__normalizeList</b>(<i>filenames</i>) + <p> Private method to normalize a list of file names. -</p><dl> +</p> +<dl> + <dt><i>filenames</i></dt> <dd> list of file names to normalize (list of string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> normalized file names (list of string) </dd> -</dl><a NAME="Project.__project" ID="Project.__project"></a> +</dl> +<a NAME="Project.__project" ID="Project.__project"></a> <h4>Project.__project</h4> <b>__project</b>(<i></i>) + <p> Private method to get the name of the current Pyramid project. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> name of the project (string) </dd> -</dl><dl> +</dl> +<dl> + <dt>Raises <b>PyramidNoProjectSelectedException</b>:</dt> <dd> raised, if no project is selected </dd> -</dl><a NAME="Project.__projectFilteredList" ID="Project.__projectFilteredList"></a> +</dl> +<a NAME="Project.__projectFilteredList" ID="Project.__projectFilteredList"></a> <h4>Project.__projectFilteredList</h4> <b>__projectFilteredList</b>(<i>filenames</i>) + <p> Private method to filter a list of file names by Pyramid project. -</p><dl> +</p> +<dl> + <dt><i>filenames</i></dt> <dd> list of file names to be filtered (list of string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> file names belonging to the current site (list of string) </dd> -</dl><a NAME="Project.__projectLanguageAdded" ID="Project.__projectLanguageAdded"></a> +</dl> +<a NAME="Project.__projectLanguageAdded" ID="Project.__projectLanguageAdded"></a> <h4>Project.__projectLanguageAdded</h4> <b>__projectLanguageAdded</b>(<i>code</i>) + <p> Private slot handling the addition of a new language. -</p><dl> +</p> +<dl> + <dt><i>code</i></dt> <dd> language code of the new language (string) </dd> -</dl><a NAME="Project.__projectPath" ID="Project.__projectPath"></a> +</dl> +<a NAME="Project.__projectPath" ID="Project.__projectPath"></a> <h4>Project.__projectPath</h4> <b>__projectPath</b>(<i></i>) + <p> Private method to calculate the full path of the Pyramid project. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> path of the project (string) </dd> -</dl><dl> +</dl> +<dl> + <dt>Raises <b>PyramidNoProjectSelectedException</b>:</dt> <dd> raised, if no project is selected </dd> -</dl><a NAME="Project.__pyramidInfo" ID="Project.__pyramidInfo"></a> +</dl> +<a NAME="Project.__pyramidInfo" ID="Project.__pyramidInfo"></a> <h4>Project.__pyramidInfo</h4> <b>__pyramidInfo</b>(<i></i>) + <p> Private slot to show some info about Pyramid. -</p><a NAME="Project.__runBrowser" ID="Project.__runBrowser"></a> +</p> +<a NAME="Project.__runBrowser" ID="Project.__runBrowser"></a> <h4>Project.__runBrowser</h4> <b>__runBrowser</b>(<i></i>) + <p> Private slot to start the default web browser with the server URL. -</p><a NAME="Project.__runLoggingServer" ID="Project.__runLoggingServer"></a> +</p> +<a NAME="Project.__runLoggingServer" ID="Project.__runLoggingServer"></a> <h4>Project.__runLoggingServer</h4> <b>__runLoggingServer</b>(<i></i>) + <p> Private slot to start the Pyramid Web server with logging. -</p><a NAME="Project.__runPythonShell" ID="Project.__runPythonShell"></a> +</p> +<a NAME="Project.__runPythonShell" ID="Project.__runPythonShell"></a> <h4>Project.__runPythonShell</h4> <b>__runPythonShell</b>(<i></i>) + <p> Private slot to start a Python console for a Pyramid project. -</p><a NAME="Project.__runServer" ID="Project.__runServer"></a> +</p> +<a NAME="Project.__runServer" ID="Project.__runServer"></a> <h4>Project.__runServer</h4> <b>__runServer</b>(<i>logging=False</i>) + <p> Private slot to start the Pyramid Web server. -</p><dl> +</p> +<dl> + <dt><i>logging</i></dt> <dd> flag indicating to enable logging (boolean) </dd> -</dl><a NAME="Project.__selectProject" ID="Project.__selectProject"></a> +</dl> +<a NAME="Project.__selectProject" ID="Project.__selectProject"></a> <h4>Project.__selectProject</h4> <b>__selectProject</b>(<i></i>) + <p> Private method to select a Pyramid project to work with. -</p><a NAME="Project.__serverProcFinished" ID="Project.__serverProcFinished"></a> +</p> +<a NAME="Project.__serverProcFinished" ID="Project.__serverProcFinished"></a> <h4>Project.__serverProcFinished</h4> <b>__serverProcFinished</b>(<i></i>) + <p> Private slot connected to the finished signal. -</p><a NAME="Project.__setCurrentProject" ID="Project.__setCurrentProject"></a> +</p> +<a NAME="Project.__setCurrentProject" ID="Project.__setCurrentProject"></a> <h4>Project.__setCurrentProject</h4> <b>__setCurrentProject</b>(<i>project</i>) + <p> Private slot to set the current project. -</p><dl> +</p> +<dl> + <dt><i>project</i></dt> <dd> name of the project (string) </dd> -</dl><a NAME="Project.__setupDevelop" ID="Project.__setupDevelop"></a> +</dl> +<a NAME="Project.__setupDevelop" ID="Project.__setupDevelop"></a> <h4>Project.__setupDevelop</h4> <b>__setupDevelop</b>(<i></i>) + <p> Private slot to set up the development environment for the current project. -</p><a NAME="Project.__showDocumentation" ID="Project.__showDocumentation"></a> +</p> +<a NAME="Project.__showDocumentation" ID="Project.__showDocumentation"></a> <h4>Project.__showDocumentation</h4> <b>__showDocumentation</b>(<i></i>) + <p> Private slot to show the helpviewer with the Pyramid documentation. -</p><a NAME="Project.__showMatchingViews" ID="Project.__showMatchingViews"></a> +</p> +<a NAME="Project.__showMatchingViews" ID="Project.__showMatchingViews"></a> <h4>Project.__showMatchingViews</h4> <b>__showMatchingViews</b>(<i></i>) + <p> Private slot showing all views that would match a given URL. -</p><a NAME="Project.__showRoutes" ID="Project.__showRoutes"></a> +</p> +<a NAME="Project.__showRoutes" ID="Project.__showRoutes"></a> <h4>Project.__showRoutes</h4> <b>__showRoutes</b>(<i></i>) + <p> Private slot showing all URL dispatch routes. -</p><a NAME="Project.__showTweens" ID="Project.__showTweens"></a> +</p> +<a NAME="Project.__showTweens" ID="Project.__showTweens"></a> <h4>Project.__showTweens</h4> <b>__showTweens</b>(<i></i>) + <p> Private slot showing all implicit and explicit tween objects. -</p><a NAME="Project.compileCatalogs" ID="Project.compileCatalogs"></a> +</p> +<a NAME="Project.compileCatalogs" ID="Project.compileCatalogs"></a> <h4>Project.compileCatalogs</h4> <b>compileCatalogs</b>(<i>filenames</i>) + <p> Public method to compile the message catalogs. -</p><dl> +</p> +<dl> + <dt><i>filenames</i></dt> <dd> list of filenames (not used) </dd> -</dl><a NAME="Project.compileSelectedCatalogs" ID="Project.compileSelectedCatalogs"></a> +</dl> +<a NAME="Project.compileSelectedCatalogs" ID="Project.compileSelectedCatalogs"></a> <h4>Project.compileSelectedCatalogs</h4> <b>compileSelectedCatalogs</b>(<i>filenames</i>) + <p> Public method to update the message catalogs. -</p><dl> +</p> +<dl> + <dt><i>filenames</i></dt> <dd> list of file names (list of string) </dd> -</dl><a NAME="Project.extractMessages" ID="Project.extractMessages"></a> +</dl> +<a NAME="Project.extractMessages" ID="Project.extractMessages"></a> <h4>Project.extractMessages</h4> <b>extractMessages</b>(<i></i>) + <p> Public method to extract the messages catalog template file. -</p><a NAME="Project.getMenu" ID="Project.getMenu"></a> +</p> +<a NAME="Project.getMenu" ID="Project.getMenu"></a> <h4>Project.getMenu</h4> <b>getMenu</b>(<i>name</i>) + <p> Public method to get a reference to the requested menu. -</p><dl> +</p> +<dl> + <dt><i>name</i></dt> <dd> name of the menu (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> reference to the menu (QMenu) or None, if no menu with the given name exists </dd> -</dl><a NAME="Project.getMenuNames" ID="Project.getMenuNames"></a> +</dl> +<a NAME="Project.getMenuNames" ID="Project.getMenuNames"></a> <h4>Project.getMenuNames</h4> <b>getMenuNames</b>(<i></i>) + <p> Public method to get the names of all menus. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> menu names (list of string) </dd> -</dl><a NAME="Project.getPyramidCommand" ID="Project.getPyramidCommand"></a> +</dl> +<a NAME="Project.getPyramidCommand" ID="Project.getPyramidCommand"></a> <h4>Project.getPyramidCommand</h4> <b>getPyramidCommand</b>(<i>cmd, language=""</i>) + <p> Public method to build a Pyramid command. -</p><dl> +</p> +<dl> + <dt><i>cmd</i></dt> <dd> command (string) -</dd><dt><i>language</i></dt> +</dd> +<dt><i>language</i></dt> <dd> Python variant to get the virtual environment for (string, one of '', 'Python2' or 'Python3') </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> full pyramid command (string) </dd> -</dl><a NAME="Project.getPyramidVersion" ID="Project.getPyramidVersion"></a> +</dl> +<a NAME="Project.getPyramidVersion" ID="Project.getPyramidVersion"></a> <h4>Project.getPyramidVersion</h4> <b>getPyramidVersion</b>(<i></i>) + <p> Public method to get the Pyramid version as a tuple. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> Pyramid version </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> tuple of int </dd> -</dl><a NAME="Project.getPyramidVersionString" ID="Project.getPyramidVersionString"></a> +</dl> +<a NAME="Project.getPyramidVersionString" ID="Project.getPyramidVersionString"></a> <h4>Project.getPyramidVersionString</h4> <b>getPyramidVersionString</b>(<i></i>) + <p> Public method to get the Pyramid version as a string. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> Pyramid version </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="Project.getPythonCommand" ID="Project.getPythonCommand"></a> +</dl> +<a NAME="Project.getPythonCommand" ID="Project.getPythonCommand"></a> <h4>Project.getPythonCommand</h4> <b>getPythonCommand</b>(<i></i>) + <p> Public method to build the Python command. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> python command (string) </dd> -</dl><a NAME="Project.initActions" ID="Project.initActions"></a> +</dl> +<a NAME="Project.initActions" ID="Project.initActions"></a> <h4>Project.initActions</h4> <b>initActions</b>(<i></i>) + <p> Public method to define the Pyramid actions. -</p><a NAME="Project.initMenu" ID="Project.initMenu"></a> +</p> +<a NAME="Project.initMenu" ID="Project.initMenu"></a> <h4>Project.initMenu</h4> <b>initMenu</b>(<i></i>) + <p> Public slot to initialize the Pyramid menu. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> the menu generated (QMenu) </dd> -</dl><a NAME="Project.isSpawningConsole" ID="Project.isSpawningConsole"></a> +</dl> +<a NAME="Project.isSpawningConsole" ID="Project.isSpawningConsole"></a> <h4>Project.isSpawningConsole</h4> <b>isSpawningConsole</b>(<i>consoleCmd</i>) + <p> Public method to check, if the given console is a spawning console. -</p><dl> +</p> +<dl> + <dt><i>consoleCmd</i></dt> <dd> console command (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> tuple of two entries giving an indication, if the console is spawning (boolean) and the (possibly) cleaned console command (string) </dd> -</dl><a NAME="Project.newForm" ID="Project.newForm"></a> +</dl> +<a NAME="Project.newForm" ID="Project.newForm"></a> <h4>Project.newForm</h4> <b>newForm</b>(<i>path</i>) + <p> Public method to create a new form. -</p><dl> +</p> +<dl> + <dt><i>path</i></dt> <dd> full directory path for the new form file (string) </dd> -</dl><a NAME="Project.openPOEditor" ID="Project.openPOEditor"></a> +</dl> +<a NAME="Project.openPOEditor" ID="Project.openPOEditor"></a> <h4>Project.openPOEditor</h4> <b>openPOEditor</b>(<i>poFile</i>) + <p> Public method to edit the given file in an external .po editor. -</p><dl> +</p> +<dl> + <dt><i>poFile</i></dt> <dd> name of the .po file (string) </dd> -</dl><a NAME="Project.projectClosed" ID="Project.projectClosed"></a> +</dl> +<a NAME="Project.projectClosed" ID="Project.projectClosed"></a> <h4>Project.projectClosed</h4> <b>projectClosed</b>(<i></i>) + <p> Public method to handle the closing of a project. -</p><a NAME="Project.projectClosedHooks" ID="Project.projectClosedHooks"></a> +</p> +<a NAME="Project.projectClosedHooks" ID="Project.projectClosedHooks"></a> <h4>Project.projectClosedHooks</h4> <b>projectClosedHooks</b>(<i></i>) + <p> Public method to remove our hook methods. -</p><a NAME="Project.projectOpenedHooks" ID="Project.projectOpenedHooks"></a> +</p> +<a NAME="Project.projectOpenedHooks" ID="Project.projectOpenedHooks"></a> <h4>Project.projectOpenedHooks</h4> <b>projectOpenedHooks</b>(<i></i>) + <p> Public method to add our hook methods. -</p><a NAME="Project.registerOpenHook" ID="Project.registerOpenHook"></a> +</p> +<a NAME="Project.registerOpenHook" ID="Project.registerOpenHook"></a> <h4>Project.registerOpenHook</h4> <b>registerOpenHook</b>(<i></i>) + <p> Public method to register the open hook to open a translations file in a translations editor. -</p><a NAME="Project.supportedPythonVariants" ID="Project.supportedPythonVariants"></a> +</p> +<a NAME="Project.supportedPythonVariants" ID="Project.supportedPythonVariants"></a> <h4>Project.supportedPythonVariants</h4> <b>supportedPythonVariants</b>(<i></i>) + <p> Public method to get the supported Python variants. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> list of supported Python variants (list of strings) </dd> -</dl><a NAME="Project.updateCatalogs" ID="Project.updateCatalogs"></a> +</dl> +<a NAME="Project.updateCatalogs" ID="Project.updateCatalogs"></a> <h4>Project.updateCatalogs</h4> <b>updateCatalogs</b>(<i>filenames</i>) + <p> Public method to update the message catalogs. -</p><dl> +</p> +<dl> + <dt><i>filenames</i></dt> <dd> list of filenames (not used) </dd> -</dl><a NAME="Project.updateSelectedCatalogs" ID="Project.updateSelectedCatalogs"></a> +</dl> +<a NAME="Project.updateSelectedCatalogs" ID="Project.updateSelectedCatalogs"></a> <h4>Project.updateSelectedCatalogs</h4> <b>updateSelectedCatalogs</b>(<i>filenames</i>) + <p> Public method to update the message catalogs. -</p><dl> +</p> +<dl> + <dt><i>filenames</i></dt> <dd> list of filenames </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="PyramidNoProjectSelectedException" ID="PyramidNoProjectSelectedException"></a> <h2>PyramidNoProjectSelectedException</h2> + <p> Exception thrown to signal, that there is no current Pyramid project. </p> <h3>Derived from</h3> Exception <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>None</td></tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="QProcess" ID="QProcess"></a> <h2>QProcess</h2> + <p> Class transforming the call arguments in case of gnome-terminal. </p> <h3>Derived from</h3> QProcessPyQt <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="#QProcess.start">start</a></td> <td>Public method to start the given program (cmd) in a new process, if none is already running, passing the command line arguments in args.</td> </tr> </table> <h3>Static Methods</h3> + <table> + <tr> <td><a href="#QProcess.startDetached">startDetached</a></td> <td>Public static method to start the given program (cmd) in a new process, if none is already running, passing the command line arguments in args.</td> </tr> </table> + <a NAME="QProcess.start" ID="QProcess.start"></a> <h4>QProcess.start</h4> <b>start</b>(<i>cmd, args=None, mode=QProcessPyQt.ReadWrite</i>) + <p> Public method to start the given program (cmd) in a new process, if none is already running, passing the command line arguments in args. -</p><dl> +</p> +<dl> + <dt><i>cmd</i></dt> <dd> start the given program cmd (string) -</dd><dt><i>args=</i></dt> +</dd> +<dt><i>args=</i></dt> <dd> list of parameters (list of strings) -</dd><dt><i>mode=</i></dt> +</dd> +<dt><i>mode=</i></dt> <dd> access mode (QIODevice.OpenMode) </dd> -</dl><a NAME="QProcess.startDetached" ID="QProcess.startDetached"></a> +</dl> +<a NAME="QProcess.startDetached" ID="QProcess.startDetached"></a> <h4>QProcess.startDetached (static)</h4> <b>startDetached</b>(<i>args=None, path=''</i>) + <p> Public static method to start the given program (cmd) in a new process, if none is already running, passing the command line arguments in args. -</p><dl> +</p> +<dl> + <dt><i>cmd</i></dt> <dd> start the given program cmd (string) -</dd><dt><i>args=</i></dt> +</dd> +<dt><i>args=</i></dt> <dd> list of parameters (list of strings) -</dd><dt><i>path=</i></dt> +</dd> +<dt><i>path=</i></dt> <dd> new working directory (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> tuple of successful start and process id (boolean, integer)