--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/eric6/Documentation/Source/setup.html Sun Apr 21 15:10:54 2019 +0200 @@ -0,0 +1,227 @@ +<!DOCTYPE html> +<html><head> +<title>setup</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>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> +<td><a href="#cleanupSource">cleanupSource</a></td> +<td>Cleanup the sources directory to get rid of leftover files and directories.</td> +</tr><tr> +<td><a href="#compileUiFiles">compileUiFiles</a></td> +<td>Compile the .ui files to Python sources.</td> +</tr><tr> +<td><a href="#getDataFiles">getDataFiles</a></td> +<td>Function to return data_files in a platform dependent manner.</td> +</tr><tr> +<td><a href="#getLongDescription">getLongDescription</a></td> +<td>Function to get the long description via the README file.</td> +</tr><tr> +<td><a href="#getPackageData">getPackageData</a></td> +<td>Function to return data files of a package with givene extensions.</td> +</tr><tr> +<td><a href="#getVersion">getVersion</a></td> +<td>Function to get the version from file.</td> +</tr><tr> +<td><a href="#prepareAppdataFile">prepareAppdataFile</a></td> +<td>Function to prepare a .appdata.xml file.</td> +</tr><tr> +<td><a href="#prepareInfoFile">prepareInfoFile</a></td> +<td>Function to prepare an Info.py file.</td> +</tr> +</table> +<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> +<dt><i>py_dir</i></dt> +<dd> +suggested name of the directory (string) +</dd><dt><i>py_file</i></dt> +<dd> +suggested name for the compile source file (string) +</dd> +</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 /> +<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> +<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 /> +<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> +<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 /> +<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> +<dt>Returns:</dt> +<dd> +list containing the platform specific data files +</dd> +</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 /> +<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> +<dt>Returns:</dt> +<dd> +long description +</dd> +</dl><dl> +<dt>Return Type:</dt> +<dd> +str +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<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> +<dt><i>package</i> (str)</dt> +<dd> +name of the package directory +</dd><dt><i>extensions</i> (list of str)</dt> +<dd> +list of extensions to test for +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +list of package data files +</dd> +</dl><dl> +<dt>Return Type:</dt> +<dd> +list of str +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<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> +<dt>Returns:</dt> +<dd> +string containing the version +</dd> +</dl><dl> +<dt>Return Type:</dt> +<dd> +str +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<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> +<dt><i>fileName</i></dt> +<dd> +name of the .appdata.xml file (string) +</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 /> +<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> +<dt><i>fileName</i></dt> +<dd> +name of the Python file containing the info (string) +</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 /> +</body></html> \ No newline at end of file