eric7/Documentation/Source/eric7.PipInterface.PipPackagesWidget.html

<!DOCTYPE html>
<html><head>
<title>eric7.PipInterface.PipPackagesWidget</title>
<meta charset="UTF-8">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<a NAME="top" ID="top"></a>
<h1>eric7.PipInterface.PipPackagesWidget</h1>

<p>
Module implementing the pip packages management widget.
</p>
<h3>Global Attributes</h3>

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

<table>

<tr>
<td><a href="#PipPackagesWidget">PipPackagesWidget</a></td>
<td>Class implementing the pip packages management widget.</td>
</tr>
<tr>
<td><a href="#PypiSearchResultsParser">PypiSearchResultsParser</a></td>
<td>Class implementing the parser for the PyPI search result page.</td>
</tr>
</table>
<h3>Functions</h3>

<table>
<tr><td>None</td></tr>
</table>
<hr />
<hr />
<a NAME="PipPackagesWidget" ID="PipPackagesWidget"></a>
<h2>PipPackagesWidget</h2>

<p>
    Class implementing the pip packages management widget.
</p>
<h3>Derived from</h3>
QWidget, Ui_PipPackagesWidget
<h3>Class Attributes</h3>

<table>
<tr><td>AvailableVersionColumn</td></tr><tr><td>InstalledVersionColumn</td></tr><tr><td>PackageColumn</td></tr><tr><td>SearchVersionRole</td></tr><tr><td>ShowProcessClassifiersMode</td></tr><tr><td>ShowProcessEntryPointsMode</td></tr><tr><td>ShowProcessFilesListMode</td></tr><tr><td>ShowProcessGeneralMode</td></tr><tr><td>VulnerabilityColumn</td></tr><tr><td>VulnerabilityRole</td></tr>
</table>
<h3>Class Methods</h3>

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

<table>

<tr>
<td><a href="#PipPackagesWidget.__init__">PipPackagesWidget</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__aboutToShowPipMenu">__aboutToShowPipMenu</a></td>
<td>Private slot to set the action enabled status.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__allUpdateableItems">__allUpdateableItems</a></td>
<td>Private method to get a list of all items that can be updated.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__availablePipVersion">__availablePipVersion</a></td>
<td>Private method to get the pip version of the selected environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__clearVulnerabilityInfo">__clearVulnerabilityInfo</a></td>
<td>Private slot to clear the vulnerability info.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__editConfiguration">__editConfiguration</a></td>
<td>Private method to edit a configuration.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__editUserConfiguration">__editUserConfiguration</a></td>
<td>Private slot to edit the user configuration.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__editVirtualenvConfiguration">__editVirtualenvConfiguration</a></td>
<td>Private slot to edit the configuration of the selected environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__finishSearch">__finishSearch</a></td>
<td>Private slot performing the search finishing actions.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__generateRequirements">__generateRequirements</a></td>
<td>Private slot to generate the contents for a requirements file.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__initPipMenu">__initPipMenu</a></td>
<td>Private method to create the super menu and attach it to the super menu button.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__installLocalPackage">__installLocalPackage</a></td>
<td>Private slot to install a package available on local storage.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__installPackages">__installPackages</a></td>
<td>Private slot to install packages to be given by the user.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__installPip">__installPip</a></td>
<td>Private slot to install pip into the selected environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__installPipUser">__installPipUser</a></td>
<td>Private slot to install pip into the user site for the selected environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__installRequirements">__installRequirements</a></td>
<td>Private slot to install packages as given in a requirements file.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__isPipAvailable">__isPipAvailable</a></td>
<td>Private method to check, if the pip package is available for the selected environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__pipConfigure">__pipConfigure</a></td>
<td>Private slot to open the configuration page.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__populateEnvironments">__populateEnvironments</a></td>
<td>Private method to get a list of environments and populate the selector.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__projectClosed">__projectClosed</a></td>
<td>Private slot to handle the projectClosed signal.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__purgeCache">__purgeCache</a></td>
<td>Private slot to empty the pip cache.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__refreshPackagesList">__refreshPackagesList</a></td>
<td>Private method to referesh the packages list.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__reinstallPackages">__reinstallPackages</a></td>
<td>Private slot to force a re-installation of the selected packages.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__removeCachedFiles">__removeCachedFiles</a></td>
<td>Private slot to remove files from the pip cache.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__repairPip">__repairPip</a></td>
<td>Private slot to repair the pip installation of the selected environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__search">__search</a></td>
<td>Private method to perform the search by calling the PyPI search URL.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__searchResponse">__searchResponse</a></td>
<td>Private method to extract the search result data from the response.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__selectedUpdateableItems">__selectedUpdateableItems</a></td>
<td>Private method to get a list of selected items that can be updated.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__showCacheInfo">__showCacheInfo</a></td>
<td>Private slot to show information about the cache.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__showCacheList">__showCacheList</a></td>
<td>Private slot to show a list of cached files.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__showPackageDetails">__showPackageDetails</a></td>
<td>Private method to populate the package details dialog.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__showPackageInformation">__showPackageInformation</a></td>
<td>Private method to show information for a package.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__showSearchedDetails">__showSearchedDetails</a></td>
<td>Private slot to show details about the selected search result package.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__showVulnerabilityInformation">__showVulnerabilityInformation</a></td>
<td>Private method to show the detected vulnerability data.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__uninstallRequirements">__uninstallRequirements</a></td>
<td>Private slot to uninstall packages as given in a requirements file.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__updateActionButtons">__updateActionButtons</a></td>
<td>Private method to set the state of the action buttons.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__updateSearchActionButtons">__updateSearchActionButtons</a></td>
<td>Private method to update the action button states of the search widget.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__updateSearchButton">__updateSearchButton</a></td>
<td>Private method to update the state of the search button.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__updateVulnerabilityData">__updateVulnerabilityData</a></td>
<td>Private slot to update the shown vulnerability info.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.__updateVulnerabilityDbCache">__updateVulnerabilityDbCache</a></td>
<td>Private slot to initiate an update of the local cache of the vulnerability database.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.executeInstallPackages">executeInstallPackages</a></td>
<td>Public method to install the given list of packages.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.executeUninstallPackages">executeUninstallPackages</a></td>
<td>Public method to uninstall the given list of packages.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.executeUpgradePackages">executeUpgradePackages</a></td>
<td>Public method to execute the pip upgrade command.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.getPip">getPip</a></td>
<td>Public method to get a reference to the pip interface object.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_environmentsComboBox_currentIndexChanged">on_environmentsComboBox_currentIndexChanged</a></td>
<td>Private slot handling the selection of a Python environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_installButton_clicked">on_installButton_clicked</a></td>
<td>Private slot to handle pressing the Install button..</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_installUserSiteButton_clicked">on_installUserSiteButton_clicked</a></td>
<td>Private slot to handle pressing the Install to User-Site button..</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_installedFilesCheckBox_clicked">on_installedFilesCheckBox_clicked</a></td>
<td>Private slot to handle a change of the installed files information checkbox.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_localCheckBox_clicked">on_localCheckBox_clicked</a></td>
<td>Private slot handling the switching of the local mode.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_notRequiredCheckBox_clicked">on_notRequiredCheckBox_clicked</a></td>
<td>Private slot handling the switching of the 'not required' mode.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_packagesList_itemClicked">on_packagesList_itemClicked</a></td>
<td>Private slot reacting on a package item click.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_packagesList_itemDoubleClicked">on_packagesList_itemDoubleClicked</a></td>
<td>Private slot reacting on a package item double click.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_refreshButton_clicked">on_refreshButton_clicked</a></td>
<td>Private slot to refresh the display.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_searchButton_clicked">on_searchButton_clicked</a></td>
<td>Private slot handling a press of the search button.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_searchEditName_returnPressed">on_searchEditName_returnPressed</a></td>
<td>Private slot initiating a search via a press of the Return key.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_searchEditName_textChanged">on_searchEditName_textChanged</a></td>
<td>Private slot handling a change of the search term.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_searchResultList_itemActivated">on_searchResultList_itemActivated</a></td>
<td>Private slot reacting on an search result item activation.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_searchResultList_itemSelectionChanged">on_searchResultList_itemSelectionChanged</a></td>
<td>Private slot handling changes of the search result selection.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_searchToggleButton_toggled">on_searchToggleButton_toggled</a></td>
<td>Private slot to togle the search widget.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_showDetailsButton_clicked">on_showDetailsButton_clicked</a></td>
<td>Private slot to handle pressing the Show Details button.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_showPackageDetailsButton_clicked">on_showPackageDetailsButton_clicked</a></td>
<td>Private slot to show information for the selected package.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_uninstallButton_clicked">on_uninstallButton_clicked</a></td>
<td>Private slot to remove selected packages of the selected environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_upgradeAllButton_clicked">on_upgradeAllButton_clicked</a></td>
<td>Private slot to upgrade all packages of the selected environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_upgradeButton_clicked">on_upgradeButton_clicked</a></td>
<td>Private slot to upgrade selected packages of the selected environment.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_userCheckBox_clicked">on_userCheckBox_clicked</a></td>
<td>Private slot handling the switching of the 'user-site' mode.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_verboseCheckBox_clicked">on_verboseCheckBox_clicked</a></td>
<td>Private slot to handle a change of the verbose package information checkbox.</td>
</tr>
<tr>
<td><a href="#PipPackagesWidget.on_vulnerabilityCheckBox_clicked">on_vulnerabilityCheckBox_clicked</a></td>
<td>Private slot handling a change of the automatic vulnerability checks.</td>
</tr>
</table>
<h3>Static Methods</h3>

<table>
<tr><td>None</td></tr>
</table>

<a NAME="PipPackagesWidget.__init__" ID="PipPackagesWidget.__init__"></a>
<h4>PipPackagesWidget (Constructor)</h4>
<b>PipPackagesWidget</b>(<i>pip, parent=None</i>)

<p>
        Constructor
</p>
<dl>

<dt><i>pip</i> (Pip)</dt>
<dd>
reference to the global pip interface
</dd>
<dt><i>parent</i> (QWidget)</dt>
<dd>
reference to the parent widget
</dd>
</dl>
<a NAME="PipPackagesWidget.__aboutToShowPipMenu" ID="PipPackagesWidget.__aboutToShowPipMenu"></a>
<h4>PipPackagesWidget.__aboutToShowPipMenu</h4>
<b>__aboutToShowPipMenu</b>(<i></i>)

<p>
        Private slot to set the action enabled status.
</p>
<a NAME="PipPackagesWidget.__allUpdateableItems" ID="PipPackagesWidget.__allUpdateableItems"></a>
<h4>PipPackagesWidget.__allUpdateableItems</h4>
<b>__allUpdateableItems</b>(<i></i>)

<p>
        Private method to get a list of all items that can be updated.
</p>
<dl>
<dt>Return:</dt>
<dd>
list of all items that can be updated
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
list of QTreeWidgetItem
</dd>
</dl>
<a NAME="PipPackagesWidget.__availablePipVersion" ID="PipPackagesWidget.__availablePipVersion"></a>
<h4>PipPackagesWidget.__availablePipVersion</h4>
<b>__availablePipVersion</b>(<i></i>)

<p>
        Private method to get the pip version of the selected environment.
</p>
<dl>
<dt>Return:</dt>
<dd>
tuple containing the version number or tuple with all zeros
            in case pip is not available
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
tuple of int
</dd>
</dl>
<a NAME="PipPackagesWidget.__clearVulnerabilityInfo" ID="PipPackagesWidget.__clearVulnerabilityInfo"></a>
<h4>PipPackagesWidget.__clearVulnerabilityInfo</h4>
<b>__clearVulnerabilityInfo</b>(<i></i>)

<p>
        Private slot to clear the vulnerability info.
</p>
<a NAME="PipPackagesWidget.__editConfiguration" ID="PipPackagesWidget.__editConfiguration"></a>
<h4>PipPackagesWidget.__editConfiguration</h4>
<b>__editConfiguration</b>(<i>venvName=""</i>)

<p>
        Private method to edit a configuration.
</p>
<dl>

<dt><i>venvName</i> (str)</dt>
<dd>
name of the environment to act upon
</dd>
</dl>
<a NAME="PipPackagesWidget.__editUserConfiguration" ID="PipPackagesWidget.__editUserConfiguration"></a>
<h4>PipPackagesWidget.__editUserConfiguration</h4>
<b>__editUserConfiguration</b>(<i></i>)

<p>
        Private slot to edit the user configuration.
</p>
<a NAME="PipPackagesWidget.__editVirtualenvConfiguration" ID="PipPackagesWidget.__editVirtualenvConfiguration"></a>
<h4>PipPackagesWidget.__editVirtualenvConfiguration</h4>
<b>__editVirtualenvConfiguration</b>(<i></i>)

<p>
        Private slot to edit the configuration of the selected environment.
</p>
<a NAME="PipPackagesWidget.__finishSearch" ID="PipPackagesWidget.__finishSearch"></a>
<h4>PipPackagesWidget.__finishSearch</h4>
<b>__finishSearch</b>(<i></i>)

<p>
        Private slot performing the search finishing actions.
</p>
<a NAME="PipPackagesWidget.__generateRequirements" ID="PipPackagesWidget.__generateRequirements"></a>
<h4>PipPackagesWidget.__generateRequirements</h4>
<b>__generateRequirements</b>(<i></i>)

<p>
        Private slot to generate the contents for a requirements file.
</p>
<a NAME="PipPackagesWidget.__initPipMenu" ID="PipPackagesWidget.__initPipMenu"></a>
<h4>PipPackagesWidget.__initPipMenu</h4>
<b>__initPipMenu</b>(<i></i>)

<p>
        Private method to create the super menu and attach it to the super
        menu button.
</p>
<a NAME="PipPackagesWidget.__installLocalPackage" ID="PipPackagesWidget.__installLocalPackage"></a>
<h4>PipPackagesWidget.__installLocalPackage</h4>
<b>__installLocalPackage</b>(<i></i>)

<p>
        Private slot to install a package available on local storage.
</p>
<a NAME="PipPackagesWidget.__installPackages" ID="PipPackagesWidget.__installPackages"></a>
<h4>PipPackagesWidget.__installPackages</h4>
<b>__installPackages</b>(<i></i>)

<p>
        Private slot to install packages to be given by the user.
</p>
<a NAME="PipPackagesWidget.__installPip" ID="PipPackagesWidget.__installPip"></a>
<h4>PipPackagesWidget.__installPip</h4>
<b>__installPip</b>(<i></i>)

<p>
        Private slot to install pip into the selected environment.
</p>
<a NAME="PipPackagesWidget.__installPipUser" ID="PipPackagesWidget.__installPipUser"></a>
<h4>PipPackagesWidget.__installPipUser</h4>
<b>__installPipUser</b>(<i></i>)

<p>
        Private slot to install pip into the user site for the selected
        environment.
</p>
<a NAME="PipPackagesWidget.__installRequirements" ID="PipPackagesWidget.__installRequirements"></a>
<h4>PipPackagesWidget.__installRequirements</h4>
<b>__installRequirements</b>(<i></i>)

<p>
        Private slot to install packages as given in a requirements file.
</p>
<a NAME="PipPackagesWidget.__isPipAvailable" ID="PipPackagesWidget.__isPipAvailable"></a>
<h4>PipPackagesWidget.__isPipAvailable</h4>
<b>__isPipAvailable</b>(<i></i>)

<p>
        Private method to check, if the pip package is available for the
        selected environment.
</p>
<dl>
<dt>Return:</dt>
<dd>
flag indicating availability
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool
</dd>
</dl>
<a NAME="PipPackagesWidget.__pipConfigure" ID="PipPackagesWidget.__pipConfigure"></a>
<h4>PipPackagesWidget.__pipConfigure</h4>
<b>__pipConfigure</b>(<i></i>)

<p>
        Private slot to open the configuration page.
</p>
<a NAME="PipPackagesWidget.__populateEnvironments" ID="PipPackagesWidget.__populateEnvironments"></a>
<h4>PipPackagesWidget.__populateEnvironments</h4>
<b>__populateEnvironments</b>(<i></i>)

<p>
        Private method to get a list of environments and populate the selector.
</p>
<a NAME="PipPackagesWidget.__projectClosed" ID="PipPackagesWidget.__projectClosed"></a>
<h4>PipPackagesWidget.__projectClosed</h4>
<b>__projectClosed</b>(<i>shutdown</i>)

<p>
        Private slot to handle the projectClosed signal.
</p>
<dl>

<dt><i>shutdown</i> (bool)</dt>
<dd>
flag indicating the IDE shutdown
</dd>
</dl>
<a NAME="PipPackagesWidget.__purgeCache" ID="PipPackagesWidget.__purgeCache"></a>
<h4>PipPackagesWidget.__purgeCache</h4>
<b>__purgeCache</b>(<i></i>)

<p>
        Private slot to empty the pip cache.
</p>
<a NAME="PipPackagesWidget.__refreshPackagesList" ID="PipPackagesWidget.__refreshPackagesList"></a>
<h4>PipPackagesWidget.__refreshPackagesList</h4>
<b>__refreshPackagesList</b>(<i></i>)

<p>
        Private method to referesh the packages list.
</p>
<a NAME="PipPackagesWidget.__reinstallPackages" ID="PipPackagesWidget.__reinstallPackages"></a>
<h4>PipPackagesWidget.__reinstallPackages</h4>
<b>__reinstallPackages</b>(<i></i>)

<p>
        Private slot to force a re-installation of the selected packages.
</p>
<a NAME="PipPackagesWidget.__removeCachedFiles" ID="PipPackagesWidget.__removeCachedFiles"></a>
<h4>PipPackagesWidget.__removeCachedFiles</h4>
<b>__removeCachedFiles</b>(<i></i>)

<p>
        Private slot to remove files from the pip cache.
</p>
<a NAME="PipPackagesWidget.__repairPip" ID="PipPackagesWidget.__repairPip"></a>
<h4>PipPackagesWidget.__repairPip</h4>
<b>__repairPip</b>(<i></i>)

<p>
        Private slot to repair the pip installation of the selected
        environment.
</p>
<a NAME="PipPackagesWidget.__search" ID="PipPackagesWidget.__search"></a>
<h4>PipPackagesWidget.__search</h4>
<b>__search</b>(<i></i>)

<p>
        Private method to perform the search by calling the PyPI search URL.
</p>
<a NAME="PipPackagesWidget.__searchResponse" ID="PipPackagesWidget.__searchResponse"></a>
<h4>PipPackagesWidget.__searchResponse</h4>
<b>__searchResponse</b>(<i>reply</i>)

<p>
        Private method to extract the search result data from the response.
</p>
<dl>

<dt><i>reply</i> (QNetworkReply)</dt>
<dd>
reference to the reply object containing the data
</dd>
</dl>
<a NAME="PipPackagesWidget.__selectedUpdateableItems" ID="PipPackagesWidget.__selectedUpdateableItems"></a>
<h4>PipPackagesWidget.__selectedUpdateableItems</h4>
<b>__selectedUpdateableItems</b>(<i></i>)

<p>
        Private method to get a list of selected items that can be updated.
</p>
<dl>
<dt>Return:</dt>
<dd>
list of selected items that can be updated
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
list of QTreeWidgetItem
</dd>
</dl>
<a NAME="PipPackagesWidget.__showCacheInfo" ID="PipPackagesWidget.__showCacheInfo"></a>
<h4>PipPackagesWidget.__showCacheInfo</h4>
<b>__showCacheInfo</b>(<i></i>)

<p>
        Private slot to show information about the cache.
</p>
<a NAME="PipPackagesWidget.__showCacheList" ID="PipPackagesWidget.__showCacheList"></a>
<h4>PipPackagesWidget.__showCacheList</h4>
<b>__showCacheList</b>(<i></i>)

<p>
        Private slot to show a list of cached files.
</p>
<a NAME="PipPackagesWidget.__showPackageDetails" ID="PipPackagesWidget.__showPackageDetails"></a>
<h4>PipPackagesWidget.__showPackageDetails</h4>
<b>__showPackageDetails</b>(<i>packageName, packageVersion, upgradable=False, installable=False</i>)

<p>
        Private method to populate the package details dialog.
</p>
<dl>

<dt><i>packageName</i> (str)</dt>
<dd>
name of the package to show details for
</dd>
<dt><i>packageVersion</i> (str)</dt>
<dd>
version of the package
</dd>
<dt><i>upgradable</i> (bool (optional))</dt>
<dd>
flag indicating that the package may be upgraded
            (defaults to False)
</dd>
<dt><i>installable</i> (bool (optional))</dt>
<dd>
flag indicating that the package may be installed
            (defaults to False)
</dd>
</dl>
<a NAME="PipPackagesWidget.__showPackageInformation" ID="PipPackagesWidget.__showPackageInformation"></a>
<h4>PipPackagesWidget.__showPackageInformation</h4>
<b>__showPackageInformation</b>(<i>packageName</i>)

<p>
        Private method to show information for a package.
</p>
<dl>

<dt><i>packageName</i> (str)</dt>
<dd>
name of the package
</dd>
</dl>
<a NAME="PipPackagesWidget.__showSearchedDetails" ID="PipPackagesWidget.__showSearchedDetails"></a>
<h4>PipPackagesWidget.__showSearchedDetails</h4>
<b>__showSearchedDetails</b>(<i>item=None</i>)

<p>
        Private slot to show details about the selected search result package.
</p>
<dl>

<dt><i>item</i> (QTreeWidgetItem)</dt>
<dd>
reference to the search result item to show details for
</dd>
</dl>
<a NAME="PipPackagesWidget.__showVulnerabilityInformation" ID="PipPackagesWidget.__showVulnerabilityInformation"></a>
<h4>PipPackagesWidget.__showVulnerabilityInformation</h4>
<b>__showVulnerabilityInformation</b>(<i>packageName, packageVersion, vulnerabilities</i>)

<p>
        Private method to show the detected vulnerability data.
</p>
<dl>

<dt><i>packageName</i> (str)</dt>
<dd>
name of the package
</dd>
<dt><i>packageVersion</i> (str)</dt>
<dd>
installed version number
</dd>
<dt><i>vulnerabilities</i> (list of Vulnerability)</dt>
<dd>
list of vulnerabilities
</dd>
</dl>
<a NAME="PipPackagesWidget.__uninstallRequirements" ID="PipPackagesWidget.__uninstallRequirements"></a>
<h4>PipPackagesWidget.__uninstallRequirements</h4>
<b>__uninstallRequirements</b>(<i></i>)

<p>
        Private slot to uninstall packages as given in a requirements file.
</p>
<a NAME="PipPackagesWidget.__updateActionButtons" ID="PipPackagesWidget.__updateActionButtons"></a>
<h4>PipPackagesWidget.__updateActionButtons</h4>
<b>__updateActionButtons</b>(<i></i>)

<p>
        Private method to set the state of the action buttons.
</p>
<a NAME="PipPackagesWidget.__updateSearchActionButtons" ID="PipPackagesWidget.__updateSearchActionButtons"></a>
<h4>PipPackagesWidget.__updateSearchActionButtons</h4>
<b>__updateSearchActionButtons</b>(<i></i>)

<p>
        Private method to update the action button states of the search widget.
</p>
<a NAME="PipPackagesWidget.__updateSearchButton" ID="PipPackagesWidget.__updateSearchButton"></a>
<h4>PipPackagesWidget.__updateSearchButton</h4>
<b>__updateSearchButton</b>(<i></i>)

<p>
        Private method to update the state of the search button.
</p>
<a NAME="PipPackagesWidget.__updateVulnerabilityData" ID="PipPackagesWidget.__updateVulnerabilityData"></a>
<h4>PipPackagesWidget.__updateVulnerabilityData</h4>
<b>__updateVulnerabilityData</b>(<i>clearFirst=True</i>)

<p>
        Private slot to update the shown vulnerability info.
</p>
<dl>

<dt><i>clearFirst</i> (bool (optional))</dt>
<dd>
flag indicating to clear the vulnerability info first
            (defaults to True)
</dd>
</dl>
<a NAME="PipPackagesWidget.__updateVulnerabilityDbCache" ID="PipPackagesWidget.__updateVulnerabilityDbCache"></a>
<h4>PipPackagesWidget.__updateVulnerabilityDbCache</h4>
<b>__updateVulnerabilityDbCache</b>(<i></i>)

<p>
        Private slot to initiate an update of the local cache of the
        vulnerability database.
</p>
<a NAME="PipPackagesWidget.executeInstallPackages" ID="PipPackagesWidget.executeInstallPackages"></a>
<h4>PipPackagesWidget.executeInstallPackages</h4>
<b>executeInstallPackages</b>(<i>packages, userSite=False</i>)

<p>
        Public method to install the given list of packages.
</p>
<dl>

<dt><i>packages</i> (list of str)</dt>
<dd>
list of package names to be installed
</dd>
<dt><i>userSite</i> (bool)</dt>
<dd>
flag indicating to install to the user directory
</dd>
</dl>
<a NAME="PipPackagesWidget.executeUninstallPackages" ID="PipPackagesWidget.executeUninstallPackages"></a>
<h4>PipPackagesWidget.executeUninstallPackages</h4>
<b>executeUninstallPackages</b>(<i>packages</i>)

<p>
        Public method to uninstall the given list of packages.
</p>
<dl>

<dt><i>packages</i> (list of str)</dt>
<dd>
list of package names to be uninstalled
</dd>
</dl>
<a NAME="PipPackagesWidget.executeUpgradePackages" ID="PipPackagesWidget.executeUpgradePackages"></a>
<h4>PipPackagesWidget.executeUpgradePackages</h4>
<b>executeUpgradePackages</b>(<i>packages</i>)

<p>
        Public method to execute the pip upgrade command.
</p>
<dl>

<dt><i>packages</i> (list of str)</dt>
<dd>
list of package names to be upgraded
</dd>
</dl>
<a NAME="PipPackagesWidget.getPip" ID="PipPackagesWidget.getPip"></a>
<h4>PipPackagesWidget.getPip</h4>
<b>getPip</b>(<i></i>)

<p>
        Public method to get a reference to the pip interface object.
</p>
<dl>
<dt>Return:</dt>
<dd>
reference to the pip interface object
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
Pip
</dd>
</dl>
<a NAME="PipPackagesWidget.on_environmentsComboBox_currentIndexChanged" ID="PipPackagesWidget.on_environmentsComboBox_currentIndexChanged"></a>
<h4>PipPackagesWidget.on_environmentsComboBox_currentIndexChanged</h4>
<b>on_environmentsComboBox_currentIndexChanged</b>(<i>index</i>)

<p>
        Private slot handling the selection of a Python environment.
</p>
<dl>

<dt><i>index</i> (int)</dt>
<dd>
index of the selected Python environment
</dd>
</dl>
<a NAME="PipPackagesWidget.on_installButton_clicked" ID="PipPackagesWidget.on_installButton_clicked"></a>
<h4>PipPackagesWidget.on_installButton_clicked</h4>
<b>on_installButton_clicked</b>(<i></i>)

<p>
        Private slot to handle pressing the Install button..
</p>
<a NAME="PipPackagesWidget.on_installUserSiteButton_clicked" ID="PipPackagesWidget.on_installUserSiteButton_clicked"></a>
<h4>PipPackagesWidget.on_installUserSiteButton_clicked</h4>
<b>on_installUserSiteButton_clicked</b>(<i></i>)

<p>
        Private slot to handle pressing the Install to User-Site button..
</p>
<a NAME="PipPackagesWidget.on_installedFilesCheckBox_clicked" ID="PipPackagesWidget.on_installedFilesCheckBox_clicked"></a>
<h4>PipPackagesWidget.on_installedFilesCheckBox_clicked</h4>
<b>on_installedFilesCheckBox_clicked</b>(<i>checked</i>)

<p>
        Private slot to handle a change of the installed files information
        checkbox.
</p>
<dl>

<dt><i>checked</i> (bool)</dt>
<dd>
state of the checkbox
</dd>
</dl>
<a NAME="PipPackagesWidget.on_localCheckBox_clicked" ID="PipPackagesWidget.on_localCheckBox_clicked"></a>
<h4>PipPackagesWidget.on_localCheckBox_clicked</h4>
<b>on_localCheckBox_clicked</b>(<i></i>)

<p>
        Private slot handling the switching of the local mode.
</p>
<a NAME="PipPackagesWidget.on_notRequiredCheckBox_clicked" ID="PipPackagesWidget.on_notRequiredCheckBox_clicked"></a>
<h4>PipPackagesWidget.on_notRequiredCheckBox_clicked</h4>
<b>on_notRequiredCheckBox_clicked</b>(<i></i>)

<p>
        Private slot handling the switching of the 'not required' mode.
</p>
<a NAME="PipPackagesWidget.on_packagesList_itemClicked" ID="PipPackagesWidget.on_packagesList_itemClicked"></a>
<h4>PipPackagesWidget.on_packagesList_itemClicked</h4>
<b>on_packagesList_itemClicked</b>(<i>item, column</i>)

<p>
        Private slot reacting on a package item click.
</p>
<dl>

<dt><i>item</i> (QTreeWidgetItem)</dt>
<dd>
reference to the clicked item
</dd>
<dt><i>column</i> (int)</dt>
<dd>
clicked column
</dd>
</dl>
<a NAME="PipPackagesWidget.on_packagesList_itemDoubleClicked" ID="PipPackagesWidget.on_packagesList_itemDoubleClicked"></a>
<h4>PipPackagesWidget.on_packagesList_itemDoubleClicked</h4>
<b>on_packagesList_itemDoubleClicked</b>(<i>item, column</i>)

<p>
        Private slot reacting on a package item double click.
</p>
<dl>

<dt><i>item</i> (QTreeWidgetItem)</dt>
<dd>
reference to the double clicked item
</dd>
<dt><i>column</i> (int)</dt>
<dd>
double clicked column
</dd>
</dl>
<a NAME="PipPackagesWidget.on_refreshButton_clicked" ID="PipPackagesWidget.on_refreshButton_clicked"></a>
<h4>PipPackagesWidget.on_refreshButton_clicked</h4>
<b>on_refreshButton_clicked</b>(<i></i>)

<p>
        Private slot to refresh the display.
</p>
<a NAME="PipPackagesWidget.on_searchButton_clicked" ID="PipPackagesWidget.on_searchButton_clicked"></a>
<h4>PipPackagesWidget.on_searchButton_clicked</h4>
<b>on_searchButton_clicked</b>(<i></i>)

<p>
        Private slot handling a press of the search button.
</p>
<a NAME="PipPackagesWidget.on_searchEditName_returnPressed" ID="PipPackagesWidget.on_searchEditName_returnPressed"></a>
<h4>PipPackagesWidget.on_searchEditName_returnPressed</h4>
<b>on_searchEditName_returnPressed</b>(<i></i>)

<p>
        Private slot initiating a search via a press of the Return key.
</p>
<a NAME="PipPackagesWidget.on_searchEditName_textChanged" ID="PipPackagesWidget.on_searchEditName_textChanged"></a>
<h4>PipPackagesWidget.on_searchEditName_textChanged</h4>
<b>on_searchEditName_textChanged</b>(<i>txt</i>)

<p>
        Private slot handling a change of the search term.
</p>
<dl>

<dt><i>txt</i> (str)</dt>
<dd>
search term
</dd>
</dl>
<a NAME="PipPackagesWidget.on_searchResultList_itemActivated" ID="PipPackagesWidget.on_searchResultList_itemActivated"></a>
<h4>PipPackagesWidget.on_searchResultList_itemActivated</h4>
<b>on_searchResultList_itemActivated</b>(<i>item, column</i>)

<p>
        Private slot reacting on an search result item activation.
</p>
<dl>

<dt><i>item</i> (QTreeWidgetItem)</dt>
<dd>
reference to the activated item
</dd>
<dt><i>column</i> (int)</dt>
<dd>
activated column
</dd>
</dl>
<a NAME="PipPackagesWidget.on_searchResultList_itemSelectionChanged" ID="PipPackagesWidget.on_searchResultList_itemSelectionChanged"></a>
<h4>PipPackagesWidget.on_searchResultList_itemSelectionChanged</h4>
<b>on_searchResultList_itemSelectionChanged</b>(<i></i>)

<p>
        Private slot handling changes of the search result selection.
</p>
<a NAME="PipPackagesWidget.on_searchToggleButton_toggled" ID="PipPackagesWidget.on_searchToggleButton_toggled"></a>
<h4>PipPackagesWidget.on_searchToggleButton_toggled</h4>
<b>on_searchToggleButton_toggled</b>(<i>checked</i>)

<p>
        Private slot to togle the search widget.
</p>
<dl>

<dt><i>checked</i> (bool)</dt>
<dd>
state of the search widget button
</dd>
</dl>
<a NAME="PipPackagesWidget.on_showDetailsButton_clicked" ID="PipPackagesWidget.on_showDetailsButton_clicked"></a>
<h4>PipPackagesWidget.on_showDetailsButton_clicked</h4>
<b>on_showDetailsButton_clicked</b>(<i></i>)

<p>
        Private slot to handle pressing the Show Details button.
</p>
<a NAME="PipPackagesWidget.on_showPackageDetailsButton_clicked" ID="PipPackagesWidget.on_showPackageDetailsButton_clicked"></a>
<h4>PipPackagesWidget.on_showPackageDetailsButton_clicked</h4>
<b>on_showPackageDetailsButton_clicked</b>(<i></i>)

<p>
        Private slot to show information for the selected package.
</p>
<a NAME="PipPackagesWidget.on_uninstallButton_clicked" ID="PipPackagesWidget.on_uninstallButton_clicked"></a>
<h4>PipPackagesWidget.on_uninstallButton_clicked</h4>
<b>on_uninstallButton_clicked</b>(<i></i>)

<p>
        Private slot to remove selected packages of the selected environment.
</p>
<a NAME="PipPackagesWidget.on_upgradeAllButton_clicked" ID="PipPackagesWidget.on_upgradeAllButton_clicked"></a>
<h4>PipPackagesWidget.on_upgradeAllButton_clicked</h4>
<b>on_upgradeAllButton_clicked</b>(<i></i>)

<p>
        Private slot to upgrade all packages of the selected environment.
</p>
<a NAME="PipPackagesWidget.on_upgradeButton_clicked" ID="PipPackagesWidget.on_upgradeButton_clicked"></a>
<h4>PipPackagesWidget.on_upgradeButton_clicked</h4>
<b>on_upgradeButton_clicked</b>(<i></i>)

<p>
        Private slot to upgrade selected packages of the selected environment.
</p>
<a NAME="PipPackagesWidget.on_userCheckBox_clicked" ID="PipPackagesWidget.on_userCheckBox_clicked"></a>
<h4>PipPackagesWidget.on_userCheckBox_clicked</h4>
<b>on_userCheckBox_clicked</b>(<i></i>)

<p>
        Private slot handling the switching of the 'user-site' mode.
</p>
<a NAME="PipPackagesWidget.on_verboseCheckBox_clicked" ID="PipPackagesWidget.on_verboseCheckBox_clicked"></a>
<h4>PipPackagesWidget.on_verboseCheckBox_clicked</h4>
<b>on_verboseCheckBox_clicked</b>(<i>checked</i>)

<p>
        Private slot to handle a change of the verbose package information
        checkbox.
</p>
<dl>

<dt><i>checked</i> (bool)</dt>
<dd>
state of the checkbox
</dd>
</dl>
<a NAME="PipPackagesWidget.on_vulnerabilityCheckBox_clicked" ID="PipPackagesWidget.on_vulnerabilityCheckBox_clicked"></a>
<h4>PipPackagesWidget.on_vulnerabilityCheckBox_clicked</h4>
<b>on_vulnerabilityCheckBox_clicked</b>(<i>checked</i>)

<p>
        Private slot handling a change of the automatic vulnerability checks.
</p>
<dl>

<dt><i>checked</i> (bool)</dt>
<dd>
flag indicating the state of the check box
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
<hr />
<a NAME="PypiSearchResultsParser" ID="PypiSearchResultsParser"></a>
<h2>PypiSearchResultsParser</h2>

<p>
    Class implementing the parser for the PyPI search result page.
</p>
<h3>Derived from</h3>
html.parser.HTMLParser
<h3>Class Attributes</h3>

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

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

<table>

<tr>
<td><a href="#PypiSearchResultsParser.__init__">PypiSearchResultsParser</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#PypiSearchResultsParser.__getClass">__getClass</a></td>
<td>Private method to extract the class attribute out of the list of attributes.</td>
</tr>
<tr>
<td><a href="#PypiSearchResultsParser.__getDate">__getDate</a></td>
<td>Private method to extract the datetime attribute out of the list of attributes and process it.</td>
</tr>
<tr>
<td><a href="#PypiSearchResultsParser.getResults">getResults</a></td>
<td>Public method to get the extracted search results.</td>
</tr>
<tr>
<td><a href="#PypiSearchResultsParser.handle_data">handle_data</a></td>
<td>Public method process arbitrary data.</td>
</tr>
<tr>
<td><a href="#PypiSearchResultsParser.handle_endtag">handle_endtag</a></td>
<td>Public method to process the end tag.</td>
</tr>
<tr>
<td><a href="#PypiSearchResultsParser.handle_starttag">handle_starttag</a></td>
<td>Public method to process the start tag.</td>
</tr>
</table>
<h3>Static Methods</h3>

<table>
<tr><td>None</td></tr>
</table>

<a NAME="PypiSearchResultsParser.__init__" ID="PypiSearchResultsParser.__init__"></a>
<h4>PypiSearchResultsParser (Constructor)</h4>
<b>PypiSearchResultsParser</b>(<i>data</i>)

<p>
        Constructor
</p>
<dl>

<dt><i>data</i> (str)</dt>
<dd>
data to be parsed
</dd>
</dl>
<a NAME="PypiSearchResultsParser.__getClass" ID="PypiSearchResultsParser.__getClass"></a>
<h4>PypiSearchResultsParser.__getClass</h4>
<b>__getClass</b>(<i>attrs</i>)

<p>
        Private method to extract the class attribute out of the list of
        attributes.
</p>
<dl>

<dt><i>attrs</i> (list of tuple of (str, str))</dt>
<dd>
list of tag attributes as (name, value) tuples
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
value of the 'class' attribute or None
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
str
</dd>
</dl>
<a NAME="PypiSearchResultsParser.__getDate" ID="PypiSearchResultsParser.__getDate"></a>
<h4>PypiSearchResultsParser.__getDate</h4>
<b>__getDate</b>(<i>attrs</i>)

<p>
        Private method to extract the datetime attribute out of the list of
        attributes and process it.
</p>
<dl>

<dt><i>attrs</i> (list of tuple of (str, str))</dt>
<dd>
list of tag attributes as (name, value) tuples
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
value of the 'class' attribute or None
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
str
</dd>
</dl>
<a NAME="PypiSearchResultsParser.getResults" ID="PypiSearchResultsParser.getResults"></a>
<h4>PypiSearchResultsParser.getResults</h4>
<b>getResults</b>(<i></i>)

<p>
        Public method to get the extracted search results.
</p>
<dl>
<dt>Return:</dt>
<dd>
extracted result data
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
list of dict
</dd>
</dl>
<a NAME="PypiSearchResultsParser.handle_data" ID="PypiSearchResultsParser.handle_data"></a>
<h4>PypiSearchResultsParser.handle_data</h4>
<b>handle_data</b>(<i>data</i>)

<p>
        Public method process arbitrary data.
</p>
<dl>

<dt><i>data</i> (str)</dt>
<dd>
data to be processed
</dd>
</dl>
<a NAME="PypiSearchResultsParser.handle_endtag" ID="PypiSearchResultsParser.handle_endtag"></a>
<h4>PypiSearchResultsParser.handle_endtag</h4>
<b>handle_endtag</b>(<i>tag</i>)

<p>
        Public method to process the end tag.
</p>
<dl>

<dt><i>tag</i> (str)</dt>
<dd>
tag name (all lowercase)
</dd>
</dl>
<a NAME="PypiSearchResultsParser.handle_starttag" ID="PypiSearchResultsParser.handle_starttag"></a>
<h4>PypiSearchResultsParser.handle_starttag</h4>
<b>handle_starttag</b>(<i>tag, attrs</i>)

<p>
        Public method to process the start tag.
</p>
<dl>

<dt><i>tag</i> (str)</dt>
<dd>
tag name (all lowercase)
</dd>
<dt><i>attrs</i> (list of tuple of (str, str))</dt>
<dd>
list of tag attributes as (name, value) tuples
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>