diff -r 1779dc278077 -r 391d6b7b1eff eric6/Documentation/Source/setup.html --- a/eric6/Documentation/Source/setup.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/setup.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,206 +18,263 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>setup</h1> + <p> Module to prepare a distribution package for uploading to PyPI. </p> <h3>Global Attributes</h3> + <table> <tr><td>Version</td></tr><tr><td>appdataFileName</td></tr><tr><td>infoFileName</td></tr><tr><td>sourceDir</td></tr> </table> <h3>Classes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Functions</h3> + <table> + <tr> <td><a href="#__pyName">__pyName</a></td> <td>Local function to create the Python source file name for the compiled .ui file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#cleanupSource">cleanupSource</a></td> <td>Cleanup the sources directory to get rid of leftover files and directories.</td> -</tr><tr> +</tr> +<tr> <td><a href="#compileUiFiles">compileUiFiles</a></td> <td>Compile the .ui files to Python sources.</td> -</tr><tr> +</tr> +<tr> <td><a href="#getDataFiles">getDataFiles</a></td> <td>Function to return data_files in a platform dependent manner.</td> -</tr><tr> +</tr> +<tr> <td><a href="#getLongDescription">getLongDescription</a></td> <td>Function to get the long description via the README file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#getPackageData">getPackageData</a></td> <td>Function to return data files of a package with givene extensions.</td> -</tr><tr> +</tr> +<tr> <td><a href="#getVersion">getVersion</a></td> <td>Function to get the version from file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#prepareAppdataFile">prepareAppdataFile</a></td> <td>Function to prepare a .appdata.xml file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#prepareInfoFile">prepareInfoFile</a></td> <td>Function to prepare an Info.py file.</td> </tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="__pyName" ID="__pyName"></a> <h2>__pyName</h2> <b>__pyName</b>(<i>py_dir, py_file</i>) + <p> Local function to create the Python source file name for the compiled .ui file. -</p><dl> +</p> +<dl> + <dt><i>py_dir</i></dt> <dd> suggested name of the directory (string) -</dd><dt><i>py_file</i></dt> +</dd> +<dt><i>py_file</i></dt> <dd> suggested name for the compile source file (string) </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> tuple of directory name (string) and source file name (string) </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="cleanupSource" ID="cleanupSource"></a> <h2>cleanupSource</h2> <b>cleanupSource</b>(<i>dirName</i>) + <p> Cleanup the sources directory to get rid of leftover files and directories. -</p><dl> +</p> +<dl> + <dt><i>dirName</i></dt> <dd> name of the directory to prune (string) </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="compileUiFiles" ID="compileUiFiles"></a> <h2>compileUiFiles</h2> <b>compileUiFiles</b>(<i>dirName</i>) + <p> Compile the .ui files to Python sources. -</p><dl> +</p> +<dl> + <dt><i>dirName</i></dt> <dd> name of the directory to compile UI files for (string) </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="getDataFiles" ID="getDataFiles"></a> <h2>getDataFiles</h2> <b>getDataFiles</b>(<i></i>) + <p> Function to return data_files in a platform dependent manner. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> list containing the platform specific data files </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> list of tuples of (str, list of str) </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="getLongDescription" ID="getLongDescription"></a> <h2>getLongDescription</h2> <b>getLongDescription</b>(<i></i>) + <p> Function to get the long description via the README file. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> long description </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="getPackageData" ID="getPackageData"></a> <h2>getPackageData</h2> <b>getPackageData</b>(<i>package, extensions</i>) + <p> Function to return data files of a package with givene extensions. -</p><dl> +</p> +<dl> + <dt><i>package</i> (str)</dt> <dd> name of the package directory -</dd><dt><i>extensions</i> (list of str)</dt> +</dd> +<dt><i>extensions</i> (list of str)</dt> <dd> list of extensions to test for </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> list of package data files </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> list of str </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="getVersion" ID="getVersion"></a> <h2>getVersion</h2> <b>getVersion</b>(<i></i>) + <p> Function to get the version from file. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> string containing the version </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="prepareAppdataFile" ID="prepareAppdataFile"></a> <h2>prepareAppdataFile</h2> <b>prepareAppdataFile</b>(<i>fileName, version</i>) + <p> Function to prepare a .appdata.xml file. -</p><dl> +</p> +<dl> + <dt><i>fileName</i></dt> <dd> name of the .appdata.xml file (string) -</dd><dt><i>version</i></dt> +</dd> +<dt><i>version</i></dt> <dd> version string for the package (string) </dd> </dl> <div align="right"><a href="#top">Up</a></div> -<hr /><hr /> +<hr /> +<hr /> <a NAME="prepareInfoFile" ID="prepareInfoFile"></a> <h2>prepareInfoFile</h2> <b>prepareInfoFile</b>(<i>fileName, version</i>) + <p> Function to prepare an Info.py file. -</p><dl> +</p> +<dl> + <dt><i>fileName</i></dt> <dd> name of the Python file containing the info (string) -</dd><dt><i>version</i></dt> +</dd> +<dt><i>version</i></dt> <dd> version string for the package (string) </dd>