--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/eric7/Documentation/Source/eric7.Plugins.VcsPlugins.vcsMercurial.QueuesExtension.queues.html Thu Jul 07 11:23:56 2022 +0200 @@ -0,0 +1,518 @@ +<!DOCTYPE html> +<html><head> +<title>eric7.Plugins.VcsPlugins.vcsMercurial.QueuesExtension.queues</title> +<meta charset="UTF-8"> +<link rel="stylesheet" href="styles.css"> +</head> +<body> +<a NAME="top" ID="top"></a> +<h1>eric7.Plugins.VcsPlugins.vcsMercurial.QueuesExtension.queues</h1> + +<p> +Module implementing the queues extension interface. +</p> +<h3>Global Attributes</h3> + +<table> +<tr><td>None</td></tr> +</table> +<h3>Classes</h3> + +<table> + +<tr> +<td><a href="#Queues">Queues</a></td> +<td>Class implementing the queues extension interface.</td> +</tr> +</table> +<h3>Functions</h3> + +<table> +<tr><td>None</td></tr> +</table> +<hr /> +<hr /> +<a NAME="Queues" ID="Queues"></a> +<h2>Queues</h2> + +<p> + Class implementing the queues extension interface. +</p> +<h3>Derived from</h3> +HgExtension +<h3>Class Attributes</h3> + +<table> +<tr><td>APPLIED_LIST</td></tr><tr><td>GOTO</td></tr><tr><td>POP</td></tr><tr><td>PUSH</td></tr><tr><td>QUEUE_ACTIVATE</td></tr><tr><td>QUEUE_DELETE</td></tr><tr><td>QUEUE_PURGE</td></tr><tr><td>SERIES_LIST</td></tr><tr><td>UNAPPLIED_LIST</td></tr> +</table> +<h3>Class Methods</h3> + +<table> +<tr><td>None</td></tr> +</table> +<h3>Methods</h3> + +<table> + +<tr> +<td><a href="#Queues.__init__">Queues</a></td> +<td>Constructor</td> +</tr> +<tr> +<td><a href="#Queues.__getCommitMessage">__getCommitMessage</a></td> +<td>Private method to get the commit message of the current patch.</td> +</tr> +<tr> +<td><a href="#Queues.__getCurrentPatch">__getCurrentPatch</a></td> +<td>Private method to get the name of the current patch.</td> +</tr> +<tr> +<td><a href="#Queues.__getPatchesList">__getPatchesList</a></td> +<td>Private method to get a list of patches of a given type.</td> +</tr> +<tr> +<td><a href="#Queues.getGuardsList">getGuardsList</a></td> +<td>Public method to get a list of all guards defined.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueCreateRenameQueue">hgQueueCreateRenameQueue</a></td> +<td>Public method to create a new queue or rename the active queue.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueDeletePatch">hgQueueDeletePatch</a></td> +<td>Public method to delete a selected unapplied patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueDeletePurgeActivateQueue">hgQueueDeletePurgeActivateQueue</a></td> +<td>Public method to delete the reference to a queue and optionally remove the patch directory or set the active queue.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueFinishAppliedPatches">hgQueueFinishAppliedPatches</a></td> +<td>Public method to finish all applied patches.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueFoldUnappliedPatches">hgQueueFoldUnappliedPatches</a></td> +<td>Public method to fold patches into the current patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueGuardsDeactivate">hgQueueGuardsDeactivate</a></td> +<td>Public method to deactivate all active guards.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueGuardsDefine">hgQueueGuardsDefine</a></td> +<td>Public method to define guards for the current or a named patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueGuardsDropAll">hgQueueGuardsDropAll</a></td> +<td>Public method to drop all guards of the current or a named patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueGuardsIdentifyActive">hgQueueGuardsIdentifyActive</a></td> +<td>Public method to list all active guards.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueGuardsList">hgQueueGuardsList</a></td> +<td>Public method to list the guards for the current or a named patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueGuardsListAll">hgQueueGuardsListAll</a></td> +<td>Public method to list all guards of all patches.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueGuardsSetActive">hgQueueGuardsSetActive</a></td> +<td>Public method to set the active guards.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueInit">hgQueueInit</a></td> +<td>Public method to initialize a new queue repository.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueListPatches">hgQueueListPatches</a></td> +<td>Public method to show a list of all patches.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueListQueues">hgQueueListQueues</a></td> +<td>Public method to list available queues.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueNewPatch">hgQueueNewPatch</a></td> +<td>Public method to create a new named patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueuePushPopPatches">hgQueuePushPopPatches</a></td> +<td>Public method to push patches onto the stack or pop patches off the stack.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueRefreshPatch">hgQueueRefreshPatch</a></td> +<td>Public method to refresh the current patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueRenamePatch">hgQueueRenamePatch</a></td> +<td>Public method to rename the current or a selected patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueShowHeader">hgQueueShowHeader</a></td> +<td>Public method to show the commit message of the current patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueShowPatch">hgQueueShowPatch</a></td> +<td>Public method to show the contents of the current patch.</td> +</tr> +<tr> +<td><a href="#Queues.hgQueueStatus">hgQueueStatus</a></td> +<td>Public method used to view the status of a queue repository.</td> +</tr> +<tr> +<td><a href="#Queues.shutdown">shutdown</a></td> +<td>Public method used to shutdown the queues interface.</td> +</tr> +</table> +<h3>Static Methods</h3> + +<table> +<tr><td>None</td></tr> +</table> + +<a NAME="Queues.__init__" ID="Queues.__init__"></a> +<h4>Queues (Constructor)</h4> +<b>Queues</b>(<i>vcs</i>) + +<p> + Constructor +</p> +<dl> + +<dt><i>vcs</i></dt> +<dd> +reference to the Mercurial vcs object +</dd> +</dl> +<a NAME="Queues.__getCommitMessage" ID="Queues.__getCommitMessage"></a> +<h4>Queues.__getCommitMessage</h4> +<b>__getCommitMessage</b>(<i></i>) + +<p> + Private method to get the commit message of the current patch. +</p> +<dl> +<dt>Return:</dt> +<dd> +name of the current patch (string) +</dd> +</dl> +<a NAME="Queues.__getCurrentPatch" ID="Queues.__getCurrentPatch"></a> +<h4>Queues.__getCurrentPatch</h4> +<b>__getCurrentPatch</b>(<i></i>) + +<p> + Private method to get the name of the current patch. +</p> +<dl> +<dt>Return:</dt> +<dd> +name of the current patch (string) +</dd> +</dl> +<a NAME="Queues.__getPatchesList" ID="Queues.__getPatchesList"></a> +<h4>Queues.__getPatchesList</h4> +<b>__getPatchesList</b>(<i>listType, withSummary=False</i>) + +<p> + Private method to get a list of patches of a given type. +</p> +<dl> + +<dt><i>listType</i></dt> +<dd> +type of patches list to get + (Queues.APPLIED_LIST, Queues.UNAPPLIED_LIST, Queues.SERIES_LIST) +</dd> +<dt><i>withSummary</i></dt> +<dd> +flag indicating to get a summary as well (boolean) +</dd> +</dl> +<dl> +<dt>Return:</dt> +<dd> +list of patches (list of string) +</dd> +</dl> +<dl> + +<dt>Raises <b>ValueError</b>:</dt> +<dd> +raised to indicate an invalid patch list type +</dd> +</dl> +<a NAME="Queues.getGuardsList" ID="Queues.getGuardsList"></a> +<h4>Queues.getGuardsList</h4> +<b>getGuardsList</b>(<i>allGuards=True</i>) + +<p> + Public method to get a list of all guards defined. +</p> +<dl> + +<dt><i>allGuards</i></dt> +<dd> +flag indicating to get all guards (boolean) +</dd> +</dl> +<dl> +<dt>Return:</dt> +<dd> +sorted list of guards (list of strings) +</dd> +</dl> +<a NAME="Queues.hgQueueCreateRenameQueue" ID="Queues.hgQueueCreateRenameQueue"></a> +<h4>Queues.hgQueueCreateRenameQueue</h4> +<b>hgQueueCreateRenameQueue</b>(<i>isCreate</i>) + +<p> + Public method to create a new queue or rename the active queue. +</p> +<dl> + +<dt><i>isCreate</i></dt> +<dd> +flag indicating to create a new queue (boolean) +</dd> +</dl> +<a NAME="Queues.hgQueueDeletePatch" ID="Queues.hgQueueDeletePatch"></a> +<h4>Queues.hgQueueDeletePatch</h4> +<b>hgQueueDeletePatch</b>(<i></i>) + +<p> + Public method to delete a selected unapplied patch. +</p> +<a NAME="Queues.hgQueueDeletePurgeActivateQueue" ID="Queues.hgQueueDeletePurgeActivateQueue"></a> +<h4>Queues.hgQueueDeletePurgeActivateQueue</h4> +<b>hgQueueDeletePurgeActivateQueue</b>(<i>operation</i>) + +<p> + Public method to delete the reference to a queue and optionally + remove the patch directory or set the active queue. +</p> +<dl> + +<dt><i>operation</i></dt> +<dd> +operation to be performed (Queues.QUEUE_DELETE, + Queues.QUEUE_PURGE, Queues.QUEUE_ACTIVATE) +</dd> +</dl> +<dl> + +<dt>Raises <b>ValueError</b>:</dt> +<dd> +raised to indicate an invalid operation +</dd> +</dl> +<a NAME="Queues.hgQueueFinishAppliedPatches" ID="Queues.hgQueueFinishAppliedPatches"></a> +<h4>Queues.hgQueueFinishAppliedPatches</h4> +<b>hgQueueFinishAppliedPatches</b>(<i></i>) + +<p> + Public method to finish all applied patches. +</p> +<a NAME="Queues.hgQueueFoldUnappliedPatches" ID="Queues.hgQueueFoldUnappliedPatches"></a> +<h4>Queues.hgQueueFoldUnappliedPatches</h4> +<b>hgQueueFoldUnappliedPatches</b>(<i></i>) + +<p> + Public method to fold patches into the current patch. +</p> +<a NAME="Queues.hgQueueGuardsDeactivate" ID="Queues.hgQueueGuardsDeactivate"></a> +<h4>Queues.hgQueueGuardsDeactivate</h4> +<b>hgQueueGuardsDeactivate</b>(<i></i>) + +<p> + Public method to deactivate all active guards. +</p> +<a NAME="Queues.hgQueueGuardsDefine" ID="Queues.hgQueueGuardsDefine"></a> +<h4>Queues.hgQueueGuardsDefine</h4> +<b>hgQueueGuardsDefine</b>(<i></i>) + +<p> + Public method to define guards for the current or a named patch. +</p> +<a NAME="Queues.hgQueueGuardsDropAll" ID="Queues.hgQueueGuardsDropAll"></a> +<h4>Queues.hgQueueGuardsDropAll</h4> +<b>hgQueueGuardsDropAll</b>(<i></i>) + +<p> + Public method to drop all guards of the current or a named patch. +</p> +<a NAME="Queues.hgQueueGuardsIdentifyActive" ID="Queues.hgQueueGuardsIdentifyActive"></a> +<h4>Queues.hgQueueGuardsIdentifyActive</h4> +<b>hgQueueGuardsIdentifyActive</b>(<i></i>) + +<p> + Public method to list all active guards. +</p> +<a NAME="Queues.hgQueueGuardsList" ID="Queues.hgQueueGuardsList"></a> +<h4>Queues.hgQueueGuardsList</h4> +<b>hgQueueGuardsList</b>(<i></i>) + +<p> + Public method to list the guards for the current or a named patch. +</p> +<a NAME="Queues.hgQueueGuardsListAll" ID="Queues.hgQueueGuardsListAll"></a> +<h4>Queues.hgQueueGuardsListAll</h4> +<b>hgQueueGuardsListAll</b>(<i></i>) + +<p> + Public method to list all guards of all patches. +</p> +<a NAME="Queues.hgQueueGuardsSetActive" ID="Queues.hgQueueGuardsSetActive"></a> +<h4>Queues.hgQueueGuardsSetActive</h4> +<b>hgQueueGuardsSetActive</b>(<i></i>) + +<p> + Public method to set the active guards. +</p> +<a NAME="Queues.hgQueueInit" ID="Queues.hgQueueInit"></a> +<h4>Queues.hgQueueInit</h4> +<b>hgQueueInit</b>(<i>name</i>) + +<p> + Public method to initialize a new queue repository. +</p> +<dl> + +<dt><i>name</i></dt> +<dd> +directory name (string) +</dd> +</dl> +<a NAME="Queues.hgQueueListPatches" ID="Queues.hgQueueListPatches"></a> +<h4>Queues.hgQueueListPatches</h4> +<b>hgQueueListPatches</b>(<i></i>) + +<p> + Public method to show a list of all patches. +</p> +<a NAME="Queues.hgQueueListQueues" ID="Queues.hgQueueListQueues"></a> +<h4>Queues.hgQueueListQueues</h4> +<b>hgQueueListQueues</b>(<i></i>) + +<p> + Public method to list available queues. +</p> +<a NAME="Queues.hgQueueNewPatch" ID="Queues.hgQueueNewPatch"></a> +<h4>Queues.hgQueueNewPatch</h4> +<b>hgQueueNewPatch</b>(<i></i>) + +<p> + Public method to create a new named patch. +</p> +<a NAME="Queues.hgQueuePushPopPatches" ID="Queues.hgQueuePushPopPatches"></a> +<h4>Queues.hgQueuePushPopPatches</h4> +<b>hgQueuePushPopPatches</b>(<i>operation, doAll=False, named=False, force=False</i>) + +<p> + Public method to push patches onto the stack or pop patches off the + stack. +</p> +<dl> + +<dt><i>operation</i></dt> +<dd> +operation type to be performed (Queues.POP, + Queues.PUSH, Queues.GOTO) +</dd> +<dt><i>doAll</i></dt> +<dd> +flag indicating to push/pop all (boolean) +</dd> +<dt><i>named</i></dt> +<dd> +flag indicating to push/pop until a named patch + is at the top of the stack (boolean) +</dd> +<dt><i>force</i></dt> +<dd> +flag indicating a forceful pop (boolean) +</dd> +</dl> +<dl> +<dt>Return:</dt> +<dd> +flag indicating that the project should be reread (boolean) +</dd> +</dl> +<dl> + +<dt>Raises <b>ValueError</b>:</dt> +<dd> +raised to indicate an invalid operation +</dd> +</dl> +<a NAME="Queues.hgQueueRefreshPatch" ID="Queues.hgQueueRefreshPatch"></a> +<h4>Queues.hgQueueRefreshPatch</h4> +<b>hgQueueRefreshPatch</b>(<i>editMessage=False</i>) + +<p> + Public method to refresh the current patch. +</p> +<dl> + +<dt><i>editMessage</i></dt> +<dd> +flag indicating to edit the current + commit message (boolean) +</dd> +</dl> +<a NAME="Queues.hgQueueRenamePatch" ID="Queues.hgQueueRenamePatch"></a> +<h4>Queues.hgQueueRenamePatch</h4> +<b>hgQueueRenamePatch</b>(<i></i>) + +<p> + Public method to rename the current or a selected patch. +</p> +<a NAME="Queues.hgQueueShowHeader" ID="Queues.hgQueueShowHeader"></a> +<h4>Queues.hgQueueShowHeader</h4> +<b>hgQueueShowHeader</b>(<i></i>) + +<p> + Public method to show the commit message of the current patch. +</p> +<a NAME="Queues.hgQueueShowPatch" ID="Queues.hgQueueShowPatch"></a> +<h4>Queues.hgQueueShowPatch</h4> +<b>hgQueueShowPatch</b>(<i>name</i>) + +<p> + Public method to show the contents of the current patch. +</p> +<dl> + +<dt><i>name</i></dt> +<dd> +file/directory name (string) +</dd> +</dl> +<a NAME="Queues.hgQueueStatus" ID="Queues.hgQueueStatus"></a> +<h4>Queues.hgQueueStatus</h4> +<b>hgQueueStatus</b>(<i>name</i>) + +<p> + Public method used to view the status of a queue repository. +</p> +<dl> + +<dt><i>name</i></dt> +<dd> +directory name (string) +</dd> +</dl> +<a NAME="Queues.shutdown" ID="Queues.shutdown"></a> +<h4>Queues.shutdown</h4> +<b>shutdown</b>(<i></i>) + +<p> + Public method used to shutdown the queues interface. +</p> +<div align="right"><a href="#top">Up</a></div> +<hr /> +</body></html> \ No newline at end of file