src/eric7/Documentation/Source/eric7.CondaInterface.Conda.html

<!DOCTYPE html>
<html><head>
<title>eric7.CondaInterface.Conda</title>
<meta charset="UTF-8">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<a NAME="top" ID="top"></a>
<h1>eric7.CondaInterface.Conda</h1>
<p>
Package implementing the conda GUI logic.
</p>

<h3>Global Attributes</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Classes</h3>
<table>
<tr>
<td><a href="#Conda">Conda</a></td>
<td>Class implementing the conda GUI logic.</td>
</tr>
</table>

<h3>Functions</h3>
<table>
<tr><td>None</td></tr>
</table>

<hr />
<hr />
<a NAME="Conda" ID="Conda"></a>
<h2>Conda</h2>
<p>
    Class implementing the conda GUI logic.
</p>

<h3>Signals</h3>
<dl>

<dt>condaEnvironmentCreated()</dt>
<dd>
emitted to indicate the creation of
        a new environment
</dd>
<dt>condaEnvironmentRemoved()</dt>
<dd>
emitted to indicate the removal of
        an environment
</dd>
</dl>
<h3>Derived from</h3>
QObject
<h3>Class Attributes</h3>
<table>
<tr><td>EnvironmentType</td></tr>
<tr><td>RootName</td></tr>
</table>

<h3>Class Methods</h3>
<table>
<tr><td>None</td></tr>
</table>

<h3>Methods</h3>
<table>
<tr>
<td><a href="#Conda.__init__">Conda</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#Conda.__preferencesChanged">__preferencesChanged</a></td>
<td>Private slot handling a change of configuration.</td>
</tr>
<tr>
<td><a href="#Conda.cleanConda">cleanConda</a></td>
<td>Public method to update conda itself.</td>
</tr>
<tr>
<td><a href="#Conda.condaDefaultExecPath">condaDefaultExecPath</a></td>
<td>Public method returning the default PATH prefix for a conda environment.</td>
</tr>
<tr>
<td><a href="#Conda.createCondaEnvironment">createCondaEnvironment</a></td>
<td>Public method to create a conda environment.</td>
</tr>
<tr>
<td><a href="#Conda.createCondaVirtualEnvironment">createCondaVirtualEnvironment</a></td>
<td>Public method to create an anaconda/miniconda environment.</td>
</tr>
<tr>
<td><a href="#Conda.deleteCondaVirtualEnvironment">deleteCondaVirtualEnvironment</a></td>
<td>Public method to delete a given anaconda/miniconda environment from disk.</td>
</tr>
<tr>
<td><a href="#Conda.getCondaEnvironmentsList">getCondaEnvironmentsList</a></td>
<td>Public method to get a list of all Conda environments.</td>
</tr>
<tr>
<td><a href="#Conda.getCondaInformation">getCondaInformation</a></td>
<td>Public method to get a dictionary containing information about conda.</td>
</tr>
<tr>
<td><a href="#Conda.getInstalledPackages">getInstalledPackages</a></td>
<td>Public method to get a list of installed packages of a conda environment.</td>
</tr>
<tr>
<td><a href="#Conda.getUpdateablePackages">getUpdateablePackages</a></td>
<td>Public method to get a list of updateable packages of a conda environment.</td>
</tr>
<tr>
<td><a href="#Conda.installPackages">installPackages</a></td>
<td>Public method to install packages into a conda environment.</td>
</tr>
<tr>
<td><a href="#Conda.removeCondaEnvironment">removeCondaEnvironment</a></td>
<td>Public method to remove a conda environment.</td>
</tr>
<tr>
<td><a href="#Conda.runProcess">runProcess</a></td>
<td>Public method to execute the conda with the given arguments.</td>
</tr>
<tr>
<td><a href="#Conda.searchPackages">searchPackages</a></td>
<td>Public method to search for a package pattern of a conda environment.</td>
</tr>
<tr>
<td><a href="#Conda.uninstallPackages">uninstallPackages</a></td>
<td>Public method to uninstall packages of a conda environment (including all no longer needed dependencies).</td>
</tr>
<tr>
<td><a href="#Conda.updateAllPackages">updateAllPackages</a></td>
<td>Public method to update all packages of a conda environment.</td>
</tr>
<tr>
<td><a href="#Conda.updateConda">updateConda</a></td>
<td>Public method to update conda itself.</td>
</tr>
<tr>
<td><a href="#Conda.updatePackages">updatePackages</a></td>
<td>Public method to update packages of a conda environment.</td>
</tr>
<tr>
<td><a href="#Conda.writeDefaultConfiguration">writeDefaultConfiguration</a></td>
<td>Public method to create a conda configuration with default values.</td>
</tr>
</table>

<h3>Static Methods</h3>
<table>
<tr><td>None</td></tr>
</table>


<a NAME="Conda.__init__" ID="Conda.__init__"></a>
<h4>Conda (Constructor)</h4>
<b>Conda</b>(<i>parent=None</i>)
<p>
        Constructor
</p>

<dl>

<dt><i>parent</i> (QObject)</dt>
<dd>
parent
</dd>
</dl>
<a NAME="Conda.__preferencesChanged" ID="Conda.__preferencesChanged"></a>
<h4>Conda.__preferencesChanged</h4>
<b>__preferencesChanged</b>(<i></i>)
<p>
        Private slot handling a change of configuration.
</p>

<a NAME="Conda.cleanConda" ID="Conda.cleanConda"></a>
<h4>Conda.cleanConda</h4>
<b>cleanConda</b>(<i>cleanAction</i>)
<p>
        Public method to update conda itself.
</p>

<dl>

<dt><i>cleanAction</i> (str)</dt>
<dd>
cleaning action to be performed (must be one of
            the command line parameters without '--')
</dd>
</dl>
<a NAME="Conda.condaDefaultExecPath" ID="Conda.condaDefaultExecPath"></a>
<h4>Conda.condaDefaultExecPath</h4>
<b>condaDefaultExecPath</b>(<i>venvDirectory</i>)
<p>
        Public method returning the default PATH prefix for a conda environment.
</p>

<dl>

<dt><i>venvDirectory</i> (str)</dt>
<dd>
path of the virtual environment to generate the
            default PATH prefix for
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
default PATH prefix string
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
str
</dd>
</dl>
<a NAME="Conda.createCondaEnvironment" ID="Conda.createCondaEnvironment"></a>
<h4>Conda.createCondaEnvironment</h4>
<b>createCondaEnvironment</b>(<i>arguments</i>)
<p>
        Public method to create a conda environment.
</p>

<dl>

<dt><i>arguments</i> (list of str)</dt>
<dd>
list of command line arguments
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
tuple containing a flag indicating success, the directory of
            the created environment (aka. prefix) and the corresponding Python
            interpreter
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
tuple of (bool, str, str)
</dd>
</dl>
<a NAME="Conda.createCondaVirtualEnvironment" ID="Conda.createCondaVirtualEnvironment"></a>
<h4>Conda.createCondaVirtualEnvironment</h4>
<b>createCondaVirtualEnvironment</b>(<i>baseDir=""</i>)
<p>
        Public method to create an anaconda/miniconda environment.
</p>
<p>
        Note: This method is used by the Virtual Environment Manager.
</p>

<dl>

<dt><i>baseDir</i> (str (optional))</dt>
<dd>
base directory for the virtual environments (defaults to "")
</dd>
</dl>
<a NAME="Conda.deleteCondaVirtualEnvironment" ID="Conda.deleteCondaVirtualEnvironment"></a>
<h4>Conda.deleteCondaVirtualEnvironment</h4>
<b>deleteCondaVirtualEnvironment</b>(<i>venvMetaData</i>)
<p>
        Public method to delete a given anaconda/miniconda environment from disk.
</p>
<p>
        Note: This method is used by the Virtual Environment Manager.
</p>

<dl>

<dt><i>venvMetaData</i> (VirtualenvMetaData)</dt>
<dd>
virtual environment meta data structure
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating success
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<a NAME="Conda.getCondaEnvironmentsList" ID="Conda.getCondaEnvironmentsList"></a>
<h4>Conda.getCondaEnvironmentsList</h4>
<b>getCondaEnvironmentsList</b>(<i></i>)
<p>
        Public method to get a list of all Conda environments.
</p>

<dl>
<dt>Return:</dt>
<dd>
list of tuples containing the environment name and prefix
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
list of tuples of (str, str)
</dd>
</dl>
<a NAME="Conda.getCondaInformation" ID="Conda.getCondaInformation"></a>
<h4>Conda.getCondaInformation</h4>
<b>getCondaInformation</b>(<i></i>)
<p>
        Public method to get a dictionary containing information about conda.
</p>

<dl>
<dt>Return:</dt>
<dd>
dictionary containing information about conda
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
dict
</dd>
</dl>
<a NAME="Conda.getInstalledPackages" ID="Conda.getInstalledPackages"></a>
<h4>Conda.getInstalledPackages</h4>
<b>getInstalledPackages</b>(<i>name="", prefix=""</i>)
<p>
        Public method to get a list of installed packages of a conda
        environment.
</p>

<dl>

<dt><i>name</i> (str)</dt>
<dd>
name of the environment
</dd>
<dt><i>prefix</i> (str)</dt>
<dd>
prefix of the environment
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
list of installed packages. Each entry is a tuple containing
            the package name, version and build.
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
list of tuples of (str, str, str)
</dd>
</dl>
<dl>

<dt>Raises <b>RuntimeError</b>:</dt>
<dd>
raised to indicate an error in parameters
        Note: only one of name or prefix must be given.
</dd>
</dl>
<a NAME="Conda.getUpdateablePackages" ID="Conda.getUpdateablePackages"></a>
<h4>Conda.getUpdateablePackages</h4>
<b>getUpdateablePackages</b>(<i>name="", prefix=""</i>)
<p>
        Public method to get a list of updateable packages of a conda
        environment.
</p>

<dl>

<dt><i>name</i> (str)</dt>
<dd>
name of the environment
</dd>
<dt><i>prefix</i> (str)</dt>
<dd>
prefix of the environment
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
list of installed packages. Each entry is a tuple containing
            the package name, version and build.
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
list of tuples of (str, str, str)
</dd>
</dl>
<dl>

<dt>Raises <b>RuntimeError</b>:</dt>
<dd>
raised to indicate an error in parameters
        Note: only one of name or prefix must be given.
</dd>
</dl>
<a NAME="Conda.installPackages" ID="Conda.installPackages"></a>
<h4>Conda.installPackages</h4>
<b>installPackages</b>(<i>packages, name="", prefix=""</i>)
<p>
        Public method to install packages into a conda environment.
</p>

<dl>

<dt><i>packages</i> (list of str)</dt>
<dd>
list of package names to be installed
</dd>
<dt><i>name</i> (str)</dt>
<dd>
name of the environment
</dd>
<dt><i>prefix</i> (str)</dt>
<dd>
prefix of the environment
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating success
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<dl>

<dt>Raises <b>RuntimeError</b>:</dt>
<dd>
raised to indicate an error in parameters
        Note: only one of name or prefix must be given.
</dd>
</dl>
<a NAME="Conda.removeCondaEnvironment" ID="Conda.removeCondaEnvironment"></a>
<h4>Conda.removeCondaEnvironment</h4>
<b>removeCondaEnvironment</b>(<i>name="", prefix=""</i>)
<p>
        Public method to remove a conda environment.
</p>

<dl>

<dt><i>name</i> (str)</dt>
<dd>
name of the environment
</dd>
<dt><i>prefix</i> (str)</dt>
<dd>
prefix of the environment
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating success
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<dl>

<dt>Raises <b>RuntimeError</b>:</dt>
<dd>
raised to indicate an error in parameters
        Note: only one of name or prefix must be given.
</dd>
</dl>
<a NAME="Conda.runProcess" ID="Conda.runProcess"></a>
<h4>Conda.runProcess</h4>
<b>runProcess</b>(<i>args</i>)
<p>
        Public method to execute the conda with the given arguments.
</p>
<p>
        The conda executable is called with the given arguments and
        waited for its end.
</p>

<dl>

<dt><i>args</i> (list of str)</dt>
<dd>
list of command line arguments
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
tuple containing a flag indicating success and the output
            of the process
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
tuple of (bool, str)
</dd>
</dl>
<a NAME="Conda.searchPackages" ID="Conda.searchPackages"></a>
<h4>Conda.searchPackages</h4>
<b>searchPackages</b>(<i>pattern, fullNameOnly=False, packageSpec=False, platform="", name="", prefix="", </i>)
<p>
        Public method to search for a package pattern of a conda environment.
</p>

<dl>

<dt><i>pattern</i> (str)</dt>
<dd>
package search pattern
</dd>
<dt><i>fullNameOnly</i> (bool)</dt>
<dd>
flag indicating to search for full names only
</dd>
<dt><i>packageSpec</i> (bool)</dt>
<dd>
flag indicating to search a package specification
</dd>
<dt><i>platform</i> (str)</dt>
<dd>
type of platform to be searched for
</dd>
<dt><i>name</i> (str)</dt>
<dd>
name of the environment
</dd>
<dt><i>prefix</i> (str)</dt>
<dd>
prefix of the environment
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating success and a dictionary with package name as
            key and list of dictionaries containing detailed data for the found
            packages as values
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
tuple of (bool, dict of list of dict)
</dd>
</dl>
<dl>

<dt>Raises <b>RuntimeError</b>:</dt>
<dd>
raised to indicate an error in parameters
        Note: only one of name or prefix must be given.
</dd>
</dl>
<a NAME="Conda.uninstallPackages" ID="Conda.uninstallPackages"></a>
<h4>Conda.uninstallPackages</h4>
<b>uninstallPackages</b>(<i>packages, name="", prefix=""</i>)
<p>
        Public method to uninstall packages of a conda environment (including
        all no longer needed dependencies).
</p>

<dl>

<dt><i>packages</i> (list of str)</dt>
<dd>
list of package names to be uninstalled
</dd>
<dt><i>name</i> (str)</dt>
<dd>
name of the environment
</dd>
<dt><i>prefix</i> (str)</dt>
<dd>
prefix of the environment
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating success
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<dl>

<dt>Raises <b>RuntimeError</b>:</dt>
<dd>
raised to indicate an error in parameters
        Note: only one of name or prefix must be given.
</dd>
</dl>
<a NAME="Conda.updateAllPackages" ID="Conda.updateAllPackages"></a>
<h4>Conda.updateAllPackages</h4>
<b>updateAllPackages</b>(<i>name="", prefix=""</i>)
<p>
        Public method to update all packages of a conda environment.
</p>

<dl>

<dt><i>name</i> (str)</dt>
<dd>
name of the environment
</dd>
<dt><i>prefix</i> (str)</dt>
<dd>
prefix of the environment
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating success
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<dl>

<dt>Raises <b>RuntimeError</b>:</dt>
<dd>
raised to indicate an error in parameters
        Note: only one of name or prefix must be given.
</dd>
</dl>
<a NAME="Conda.updateConda" ID="Conda.updateConda"></a>
<h4>Conda.updateConda</h4>
<b>updateConda</b>(<i></i>)
<p>
        Public method to update conda itself.
</p>

<dl>
<dt>Return:</dt>
<dd>
flag indicating success
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<a NAME="Conda.updatePackages" ID="Conda.updatePackages"></a>
<h4>Conda.updatePackages</h4>
<b>updatePackages</b>(<i>packages, name="", prefix=""</i>)
<p>
        Public method to update packages of a conda environment.
</p>

<dl>

<dt><i>packages</i> (list of str)</dt>
<dd>
list of package names to be updated
</dd>
<dt><i>name</i> (str)</dt>
<dd>
name of the environment
</dd>
<dt><i>prefix</i> (str)</dt>
<dd>
prefix of the environment
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating success
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<dl>

<dt>Raises <b>RuntimeError</b>:</dt>
<dd>
raised to indicate an error in parameters
        Note: only one of name or prefix must be given.
</dd>
</dl>
<a NAME="Conda.writeDefaultConfiguration" ID="Conda.writeDefaultConfiguration"></a>
<h4>Conda.writeDefaultConfiguration</h4>
<b>writeDefaultConfiguration</b>(<i></i>)
<p>
        Public method to create a conda configuration with default values.
</p>

<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>