--- a/eric6/Documentation/Source/eric6.PipInterface.Pip.html Wed Sep 25 19:40:31 2019 +0200 +++ b/eric6/Documentation/Source/eric6.PipInterface.Pip.html Wed Sep 25 19:42:44 2019 +0200 @@ -18,484 +18,632 @@ </style> </head> -<body><a NAME="top" ID="top"></a> +<body> +<a NAME="top" ID="top"></a> <h1>eric6.PipInterface.Pip</h1> + <p> Package implementing the pip GUI logic. </p> <h3>Global Attributes</h3> + <table> <tr><td>None</td></tr> </table> <h3>Classes</h3> + <table> + <tr> <td><a href="#Pip">Pip</a></td> <td>Class implementing the pip GUI logic.</td> </tr> </table> <h3>Functions</h3> + <table> <tr><td>None</td></tr> </table> -<hr /><hr /> +<hr /> +<hr /> <a NAME="Pip" ID="Pip"></a> <h2>Pip</h2> + <p> Class implementing the pip GUI logic. </p> <h3>Derived from</h3> QObject <h3>Class Attributes</h3> + <table> <tr><td>DefaultIndexUrlPip</td></tr><tr><td>DefaultIndexUrlXml</td></tr><tr><td>DefaultPyPiUrl</td></tr> </table> <h3>Class Methods</h3> + <table> <tr><td>None</td></tr> </table> <h3>Methods</h3> + <table> + <tr> <td><a href="#Pip.__init__">Pip</a></td> <td>Constructor</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.__checkUpgradePyQt">__checkUpgradePyQt</a></td> <td>Private method to check, if an upgrade of PyQt packages is attempted.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getIndexUrl">getIndexUrl</a></td> <td>Public method to get the index URL for PyPI.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getIndexUrlXml">getIndexUrlXml</a></td> <td>Public method to get the index URL for XML RPC calls.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getInstalledPackages">getInstalledPackages</a></td> <td>Public method to get the list of installed packages.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getOutdatedPackages">getOutdatedPackages</a></td> <td>Public method to get the list of outdated packages.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getPackageDetails">getPackageDetails</a></td> <td>Public method to get package details using the PyPI JSON interface.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getProjectEnvironmentString">getProjectEnvironmentString</a></td> <td>Public method to get the string for the project environment.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getUserConfig">getUserConfig</a></td> <td>Public method to get the name of the user configuration file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getVirtualenvConfig">getVirtualenvConfig</a></td> <td>Public method to get the name of the virtualenv configuration file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getVirtualenvInterpreter">getVirtualenvInterpreter</a></td> <td>Public method to get the interpreter for a virtual environment.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.getVirtualenvNames">getVirtualenvNames</a></td> <td>Public method to get a sorted list of virtual environment names.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.installPackages">installPackages</a></td> <td>Public method to install the given list of packages.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.installPip">installPip</a></td> <td>Public method to install pip.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.installRequirements">installRequirements</a></td> <td>Public method to install packages as given in a requirements file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.repairPip">repairPip</a></td> <td>Public method to repair the pip installation.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.runProcess">runProcess</a></td> <td>Public method to execute the current pip with the given arguments.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.uninstallPackages">uninstallPackages</a></td> <td>Public method to uninstall the given list of packages.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.uninstallRequirements">uninstallRequirements</a></td> <td>Public method to uninstall packages as given in a requirements file.</td> -</tr><tr> +</tr> +<tr> <td><a href="#Pip.upgradePackages">upgradePackages</a></td> <td>Public method to upgrade the given list of packages.</td> </tr> </table> <h3>Static Methods</h3> + <table> <tr><td>None</td></tr> </table> + <a NAME="Pip.__init__" ID="Pip.__init__"></a> <h4>Pip (Constructor)</h4> <b>Pip</b>(<i>parent=None</i>) + <p> Constructor -</p><dl> +</p> +<dl> + <dt><i>parent</i> (QObject)</dt> <dd> parent </dd> -</dl><a NAME="Pip.__checkUpgradePyQt" ID="Pip.__checkUpgradePyQt"></a> +</dl> +<a NAME="Pip.__checkUpgradePyQt" ID="Pip.__checkUpgradePyQt"></a> <h4>Pip.__checkUpgradePyQt</h4> <b>__checkUpgradePyQt</b>(<i>packages</i>) + <p> Private method to check, if an upgrade of PyQt packages is attempted. -</p><dl> +</p> +<dl> + <dt><i>packages</i> (list of str)</dt> <dd> list of packages to upgrade </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> flag indicating to abort the upgrade attempt </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="Pip.getIndexUrl" ID="Pip.getIndexUrl"></a> +</dl> +<a NAME="Pip.getIndexUrl" ID="Pip.getIndexUrl"></a> <h4>Pip.getIndexUrl</h4> <b>getIndexUrl</b>(<i></i>) + <p> Public method to get the index URL for PyPI. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> index URL for PyPI </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="Pip.getIndexUrlXml" ID="Pip.getIndexUrlXml"></a> +</dl> +<a NAME="Pip.getIndexUrlXml" ID="Pip.getIndexUrlXml"></a> <h4>Pip.getIndexUrlXml</h4> <b>getIndexUrlXml</b>(<i></i>) + <p> Public method to get the index URL for XML RPC calls. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> index URL for XML RPC calls </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="Pip.getInstalledPackages" ID="Pip.getInstalledPackages"></a> +</dl> +<a NAME="Pip.getInstalledPackages" ID="Pip.getInstalledPackages"></a> <h4>Pip.getInstalledPackages</h4> <b>getInstalledPackages</b>(<i>envName, localPackages=True, notRequired=False, usersite=False</i>) + <p> Public method to get the list of installed packages. -</p><dl> +</p> +<dl> + <dt><i>envName</i> (str)</dt> <dd> name of the environment to get the packages for -</dd><dt><i>localPackages</i> (bool)</dt> +</dd> +<dt><i>localPackages</i> (bool)</dt> <dd> flag indicating to get local packages only -</dd><dt><i>notRequired</i> (bool)</dt> +</dd> +<dt><i>notRequired</i> (bool)</dt> <dd> flag indicating to list packages that are not dependencies of installed packages as well -</dd><dt><i>usersite</i> (bool)</dt> +</dd> +<dt><i>usersite</i> (bool)</dt> <dd> flag indicating to only list packages installed in user-site </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> list of tuples containing the package name and version </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> list of tuple of (str, str) </dd> -</dl><a NAME="Pip.getOutdatedPackages" ID="Pip.getOutdatedPackages"></a> +</dl> +<a NAME="Pip.getOutdatedPackages" ID="Pip.getOutdatedPackages"></a> <h4>Pip.getOutdatedPackages</h4> <b>getOutdatedPackages</b>(<i>envName, localPackages=True, notRequired=False, usersite=False</i>) + <p> Public method to get the list of outdated packages. -</p><dl> +</p> +<dl> + <dt><i>envName</i> (str)</dt> <dd> name of the environment to get the packages for -</dd><dt><i>localPackages</i> (bool)</dt> +</dd> +<dt><i>localPackages</i> (bool)</dt> <dd> flag indicating to get local packages only -</dd><dt><i>notRequired</i> (bool)</dt> +</dd> +<dt><i>notRequired</i> (bool)</dt> <dd> flag indicating to list packages that are not dependencies of installed packages as well -</dd><dt><i>usersite</i> (bool)</dt> +</dd> +<dt><i>usersite</i> (bool)</dt> <dd> flag indicating to only list packages installed in user-site </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> list of tuples containing the package name, installed version and available version </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> list of tuple of (str, str, str) </dd> -</dl><a NAME="Pip.getPackageDetails" ID="Pip.getPackageDetails"></a> +</dl> +<a NAME="Pip.getPackageDetails" ID="Pip.getPackageDetails"></a> <h4>Pip.getPackageDetails</h4> <b>getPackageDetails</b>(<i>name, version</i>) + <p> Public method to get package details using the PyPI JSON interface. -</p><dl> +</p> +<dl> + <dt><i>name</i> (str)</dt> <dd> package name -</dd><dt><i>version</i> (str)</dt> +</dd> +<dt><i>version</i> (str)</dt> <dd> package version </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> dictionary containing PyPI package data </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> dict </dd> -</dl><a NAME="Pip.getProjectEnvironmentString" ID="Pip.getProjectEnvironmentString"></a> +</dl> +<a NAME="Pip.getProjectEnvironmentString" ID="Pip.getProjectEnvironmentString"></a> <h4>Pip.getProjectEnvironmentString</h4> <b>getProjectEnvironmentString</b>(<i></i>) + <p> Public method to get the string for the project environment. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> string for the project environment </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="Pip.getUserConfig" ID="Pip.getUserConfig"></a> +</dl> +<a NAME="Pip.getUserConfig" ID="Pip.getUserConfig"></a> <h4>Pip.getUserConfig</h4> <b>getUserConfig</b>(<i></i>) + <p> Public method to get the name of the user configuration file. -</p><dl> +</p> +<dl> <dt>Returns:</dt> <dd> path of the user configuration file </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="Pip.getVirtualenvConfig" ID="Pip.getVirtualenvConfig"></a> +</dl> +<a NAME="Pip.getVirtualenvConfig" ID="Pip.getVirtualenvConfig"></a> <h4>Pip.getVirtualenvConfig</h4> <b>getVirtualenvConfig</b>(<i>venvName</i>) + <p> Public method to get the name of the virtualenv configuration file. -</p><dl> +</p> +<dl> + <dt><i>venvName</i> (str)</dt> <dd> name of the environment to get config file path for </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> path of the virtualenv configuration file </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="Pip.getVirtualenvInterpreter" ID="Pip.getVirtualenvInterpreter"></a> +</dl> +<a NAME="Pip.getVirtualenvInterpreter" ID="Pip.getVirtualenvInterpreter"></a> <h4>Pip.getVirtualenvInterpreter</h4> <b>getVirtualenvInterpreter</b>(<i>venvName</i>) + <p> Public method to get the interpreter for a virtual environment. -</p><dl> +</p> +<dl> + <dt><i>venvName</i> (str)</dt> <dd> logical name for the virtual environment </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> interpreter path </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> str </dd> -</dl><a NAME="Pip.getVirtualenvNames" ID="Pip.getVirtualenvNames"></a> +</dl> +<a NAME="Pip.getVirtualenvNames" ID="Pip.getVirtualenvNames"></a> <h4>Pip.getVirtualenvNames</h4> <b>getVirtualenvNames</b>(<i>noRemote=False</i>) + <p> Public method to get a sorted list of virtual environment names. -</p><dl> +</p> +<dl> + <dt><i>noRemote</i> (bool)</dt> <dd> flag indicating to exclude environments for remote debugging </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> sorted list of virtual environment names </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> list of str </dd> -</dl><a NAME="Pip.installPackages" ID="Pip.installPackages"></a> +</dl> +<a NAME="Pip.installPackages" ID="Pip.installPackages"></a> <h4>Pip.installPackages</h4> <b>installPackages</b>(<i>packages, venvName="", userSite=False, interpreter=""</i>) + <p> Public method to install the given list of packages. -</p><dl> +</p> +<dl> + <dt><i>packages</i> (list of str)</dt> <dd> list of packages to install -</dd><dt><i>venvName</i> (str)</dt> +</dd> +<dt><i>venvName</i> (str)</dt> <dd> name of the virtual environment to be used -</dd><dt><i>userSite</i> (bool)</dt> +</dd> +<dt><i>userSite</i> (bool)</dt> <dd> flag indicating an install to the user install directory -</dd><dt><i>interpreter</i> (str)</dt> +</dd> +<dt><i>interpreter</i> (str)</dt> <dd> interpreter to be used for execution </dd> -</dl><a NAME="Pip.installPip" ID="Pip.installPip"></a> +</dl> +<a NAME="Pip.installPip" ID="Pip.installPip"></a> <h4>Pip.installPip</h4> <b>installPip</b>(<i>venvName, userSite=False</i>) + <p> Public method to install pip. -</p><dl> +</p> +<dl> + <dt><i>venvName</i> (str)</dt> <dd> name of the environment to install pip into -</dd><dt><i>userSite</i> (bool)</dt> +</dd> +<dt><i>userSite</i> (bool)</dt> <dd> flag indicating an install to the user install directory </dd> -</dl><a NAME="Pip.installRequirements" ID="Pip.installRequirements"></a> +</dl> +<a NAME="Pip.installRequirements" ID="Pip.installRequirements"></a> <h4>Pip.installRequirements</h4> <b>installRequirements</b>(<i>venvName</i>) + <p> Public method to install packages as given in a requirements file. -</p><dl> +</p> +<dl> + <dt><i>venvName</i> (str)</dt> <dd> name of the virtual environment to be used </dd> -</dl><a NAME="Pip.repairPip" ID="Pip.repairPip"></a> +</dl> +<a NAME="Pip.repairPip" ID="Pip.repairPip"></a> <h4>Pip.repairPip</h4> <b>repairPip</b>(<i>venvName</i>) + <p> Public method to repair the pip installation. -</p><dl> +</p> +<dl> + <dt><i>venvName</i> (str)</dt> <dd> name of the environment to install pip into </dd> -</dl><a NAME="Pip.runProcess" ID="Pip.runProcess"></a> +</dl> +<a NAME="Pip.runProcess" ID="Pip.runProcess"></a> <h4>Pip.runProcess</h4> <b>runProcess</b>(<i>args, interpreter</i>) + <p> Public method to execute the current pip with the given arguments. -</p><p> +</p> +<p> The selected pip executable is called with the given arguments and waited for its end. -</p><dl> +</p> +<dl> + <dt><i>args</i> (list of str)</dt> <dd> list of command line arguments -</dd><dt><i>interpreter</i> (str)</dt> +</dd> +<dt><i>interpreter</i> (str)</dt> <dd> path of the Python interpreter to be used </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> tuple containing a flag indicating success and the output of the process </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> tuple of (bool, str) </dd> -</dl><a NAME="Pip.uninstallPackages" ID="Pip.uninstallPackages"></a> +</dl> +<a NAME="Pip.uninstallPackages" ID="Pip.uninstallPackages"></a> <h4>Pip.uninstallPackages</h4> <b>uninstallPackages</b>(<i>packages, venvName</i>) + <p> Public method to uninstall the given list of packages. -</p><dl> +</p> +<dl> + <dt><i>packages</i> (list of str)</dt> <dd> list of packages to uninstall -</dd><dt><i>venvName</i> (str)</dt> +</dd> +<dt><i>venvName</i> (str)</dt> <dd> name of the virtual environment to be used </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> flag indicating a successful execution </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool </dd> -</dl><a NAME="Pip.uninstallRequirements" ID="Pip.uninstallRequirements"></a> +</dl> +<a NAME="Pip.uninstallRequirements" ID="Pip.uninstallRequirements"></a> <h4>Pip.uninstallRequirements</h4> <b>uninstallRequirements</b>(<i>venvName</i>) + <p> Public method to uninstall packages as given in a requirements file. -</p><dl> +</p> +<dl> + <dt><i>venvName</i> (str)</dt> <dd> name of the virtual environment to be used </dd> -</dl><a NAME="Pip.upgradePackages" ID="Pip.upgradePackages"></a> +</dl> +<a NAME="Pip.upgradePackages" ID="Pip.upgradePackages"></a> <h4>Pip.upgradePackages</h4> <b>upgradePackages</b>(<i>packages, venvName, userSite=False</i>) + <p> Public method to upgrade the given list of packages. -</p><dl> +</p> +<dl> + <dt><i>packages</i> (list of str)</dt> <dd> list of packages to upgrade -</dd><dt><i>venvName</i> (str)</dt> +</dd> +<dt><i>venvName</i> (str)</dt> <dd> name of the virtual environment to be used -</dd><dt><i>userSite</i> (bool)</dt> +</dd> +<dt><i>userSite</i> (bool)</dt> <dd> flag indicating an install to the user install directory </dd> -</dl><dl> +</dl> +<dl> <dt>Returns:</dt> <dd> flag indicating a successful execution </dd> -</dl><dl> +</dl> +<dl> <dt>Return Type:</dt> <dd> bool