eric7/Documentation/Source/eric7.VCS.StatusMonitorThread.html

branch
eric7
changeset 8372
e0227a7c850e
child 8596
d64760b2da50
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/eric7/Documentation/Source/eric7.VCS.StatusMonitorThread.html	Mon May 24 11:19:57 2021 +0200
@@ -0,0 +1,331 @@
+<!DOCTYPE html>
+<html><head>
+<title>eric7.VCS.StatusMonitorThread</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>eric7.VCS.StatusMonitorThread</h1>
+
+<p>
+Module implementing the VCS status monitor thread base class.
+</p>
+<h3>Global Attributes</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Classes</h3>
+
+<table>
+
+<tr>
+<td><a href="#VcsStatusMonitorThread">VcsStatusMonitorThread</a></td>
+<td>Class implementing the VCS status monitor thread base class.</td>
+</tr>
+</table>
+<h3>Functions</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<hr />
+<hr />
+<a NAME="VcsStatusMonitorThread" ID="VcsStatusMonitorThread"></a>
+<h2>VcsStatusMonitorThread</h2>
+
+<p>
+    Class implementing the VCS status monitor thread base class.
+</p>
+<h3>Signals</h3>
+<dl>
+
+<dt>vcsStatusMonitorData(list of str)</dt>
+<dd>
+emitted to update the VCS status
+</dd>
+<dt>vcsStatusMonitorInfo(str)</dt>
+<dd>
+emitted to signal some info of the
+        monitoring thread
+</dd>
+<dt>vcsStatusMonitorStatus(str, str)</dt>
+<dd>
+emitted to signal the status of
+        the monitoring thread (ok, nok, op) and a status message
+</dd>
+</dl>
+<h3>Derived from</h3>
+QThread
+<h3>Class Attributes</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Class Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Methods</h3>
+
+<table>
+
+<tr>
+<td><a href="#VcsStatusMonitorThread.__init__">VcsStatusMonitorThread</a></td>
+<td>Constructor</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread._getInfo">_getInfo</a></td>
+<td>Protected method implementing the real info action.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread._performMonitor">_performMonitor</a></td>
+<td>Protected method implementing the real monitoring action.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread._shutdown">_shutdown</a></td>
+<td>Protected method performing shutdown actions.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread.checkStatus">checkStatus</a></td>
+<td>Public method to wake up the status monitor thread.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread.clearCachedState">clearCachedState</a></td>
+<td>Public method to clear the cached VCS state of a file/directory.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread.getAutoUpdate">getAutoUpdate</a></td>
+<td>Public method to retrieve the status of the auto update function.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread.getInterval">getInterval</a></td>
+<td>Public method to get the monitor interval.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread.run">run</a></td>
+<td>Public method implementing the tasks action.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread.setAutoUpdate">setAutoUpdate</a></td>
+<td>Public method to enable the auto update function.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread.setInterval">setInterval</a></td>
+<td>Public method to change the monitor interval.</td>
+</tr>
+<tr>
+<td><a href="#VcsStatusMonitorThread.stop">stop</a></td>
+<td>Public method to stop the monitor thread.</td>
+</tr>
+</table>
+<h3>Static Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+
+<a NAME="VcsStatusMonitorThread.__init__" ID="VcsStatusMonitorThread.__init__"></a>
+<h4>VcsStatusMonitorThread (Constructor)</h4>
+<b>VcsStatusMonitorThread</b>(<i>interval, project, vcs, parent=None</i>)
+
+<p>
+        Constructor
+</p>
+<dl>
+
+<dt><i>interval</i></dt>
+<dd>
+new interval in seconds (integer)
+</dd>
+<dt><i>project</i></dt>
+<dd>
+reference to the project object (Project)
+</dd>
+<dt><i>vcs</i></dt>
+<dd>
+reference to the version control object
+</dd>
+<dt><i>parent</i></dt>
+<dd>
+reference to the parent object (QObject)
+</dd>
+</dl>
+<a NAME="VcsStatusMonitorThread._getInfo" ID="VcsStatusMonitorThread._getInfo"></a>
+<h4>VcsStatusMonitorThread._getInfo</h4>
+<b>_getInfo</b>(<i></i>)
+
+<p>
+        Protected method implementing the real info action.
+</p>
+<p>
+        This method should be overridden and create a short info message to be
+        shown in the main window status bar right next to the status indicator.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+short info message
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+str
+</dd>
+</dl>
+<a NAME="VcsStatusMonitorThread._performMonitor" ID="VcsStatusMonitorThread._performMonitor"></a>
+<h4>VcsStatusMonitorThread._performMonitor</h4>
+<b>_performMonitor</b>(<i></i>)
+
+<p>
+        Protected method implementing the real monitoring action.
+</p>
+<p>
+        This method must be overridden and populate the statusList member
+        variable with a list of strings giving the status in the first column
+        and the path relative to the project directory starting with the
+        third column. The allowed status flags are:
+        <ul>
+            <li>"A" path was added but not yet comitted</li>
+            <li>"M" path has local changes</li>
+            <li>"O" path was removed</li>
+            <li>"R" path was deleted and then re-added</li>
+            <li>"U" path needs an update</li>
+            <li>"Z" path contains a conflict</li>
+            <li>" " path is back at normal</li>
+        </ul>
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+tuple of flag indicating successful operation (boolean) and
+            a status message in case of non successful operation (string)
+</dd>
+</dl>
+<dl>
+
+<dt>Raises <b>RuntimeError</b>:</dt>
+<dd>
+to indicate that this method must be
+            implemented by a subclass
+</dd>
+</dl>
+<a NAME="VcsStatusMonitorThread._shutdown" ID="VcsStatusMonitorThread._shutdown"></a>
+<h4>VcsStatusMonitorThread._shutdown</h4>
+<b>_shutdown</b>(<i></i>)
+
+<p>
+        Protected method performing shutdown actions.
+</p>
+<p>
+        The default implementation does nothing.
+</p>
+<a NAME="VcsStatusMonitorThread.checkStatus" ID="VcsStatusMonitorThread.checkStatus"></a>
+<h4>VcsStatusMonitorThread.checkStatus</h4>
+<b>checkStatus</b>(<i></i>)
+
+<p>
+        Public method to wake up the status monitor thread.
+</p>
+<a NAME="VcsStatusMonitorThread.clearCachedState" ID="VcsStatusMonitorThread.clearCachedState"></a>
+<h4>VcsStatusMonitorThread.clearCachedState</h4>
+<b>clearCachedState</b>(<i>name</i>)
+
+<p>
+        Public method to clear the cached VCS state of a file/directory.
+</p>
+<dl>
+
+<dt><i>name</i></dt>
+<dd>
+name of the entry to be cleared (string)
+</dd>
+</dl>
+<a NAME="VcsStatusMonitorThread.getAutoUpdate" ID="VcsStatusMonitorThread.getAutoUpdate"></a>
+<h4>VcsStatusMonitorThread.getAutoUpdate</h4>
+<b>getAutoUpdate</b>(<i></i>)
+
+<p>
+        Public method to retrieve the status of the auto update function.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+status of the auto update function (boolean)
+</dd>
+</dl>
+<a NAME="VcsStatusMonitorThread.getInterval" ID="VcsStatusMonitorThread.getInterval"></a>
+<h4>VcsStatusMonitorThread.getInterval</h4>
+<b>getInterval</b>(<i></i>)
+
+<p>
+        Public method to get the monitor interval.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+interval in seconds (integer)
+</dd>
+</dl>
+<a NAME="VcsStatusMonitorThread.run" ID="VcsStatusMonitorThread.run"></a>
+<h4>VcsStatusMonitorThread.run</h4>
+<b>run</b>(<i></i>)
+
+<p>
+        Public method implementing the tasks action.
+</p>
+<a NAME="VcsStatusMonitorThread.setAutoUpdate" ID="VcsStatusMonitorThread.setAutoUpdate"></a>
+<h4>VcsStatusMonitorThread.setAutoUpdate</h4>
+<b>setAutoUpdate</b>(<i>auto</i>)
+
+<p>
+        Public method to enable the auto update function.
+</p>
+<dl>
+
+<dt><i>auto</i></dt>
+<dd>
+status of the auto update function (boolean)
+</dd>
+</dl>
+<a NAME="VcsStatusMonitorThread.setInterval" ID="VcsStatusMonitorThread.setInterval"></a>
+<h4>VcsStatusMonitorThread.setInterval</h4>
+<b>setInterval</b>(<i>interval</i>)
+
+<p>
+        Public method to change the monitor interval.
+</p>
+<dl>
+
+<dt><i>interval</i></dt>
+<dd>
+new interval in seconds (integer)
+</dd>
+</dl>
+<a NAME="VcsStatusMonitorThread.stop" ID="VcsStatusMonitorThread.stop"></a>
+<h4>VcsStatusMonitorThread.stop</h4>
+<b>stop</b>(<i></i>)
+
+<p>
+        Public method to stop the monitor thread.
+</p>
+<div align="right"><a href="#top">Up</a></div>
+<hr />
+</body></html>
\ No newline at end of file

eric ide

mercurial