Documentation/Source/eric5.DebugClients.Python3.DebugThread.html

changeset 58
37f0444c3479
parent 21
b88a0e6268bd
child 409
0ea528e80202
--- a/Documentation/Source/eric5.DebugClients.Python3.DebugThread.html	Thu Jan 14 17:27:31 2010 +0000
+++ b/Documentation/Source/eric5.DebugClients.Python3.DebugThread.html	Thu Jan 14 18:35:52 2010 +0000
@@ -22,7 +22,7 @@
 <body><a NAME="top" ID="top"></a>
 <h1>eric5.DebugClients.Python3.DebugThread</h1>
 <p>
-&#77;&#111;&#100;&#117;&#108;&#101; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#116;&#104;&#114;&#101;&#97;&#100;.
+Module implementing the debug thread.
 </p>
 <h3>Global Attributes</h3>
 <table>
@@ -32,7 +32,7 @@
 <table>
 <tr>
 <td><a href="#DebugThread">DebugThread</a></td>
-<td>&#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#97; &#100;&#101;&#98;&#117;&#103; &#116;&#104;&#114;&#101;&#97;&#100;.</td>
+<td>Class implementing a debug thread.</td>
 </tr>
 </table>
 <h3>Functions</h3>
@@ -43,12 +43,12 @@
 <a NAME="DebugThread" ID="DebugThread"></a>
 <h2>DebugThread</h2>
 <p>
-    &#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#97; &#100;&#101;&#98;&#117;&#103; &#116;&#104;&#114;&#101;&#97;&#100;.
+    Class implementing a debug thread.
 </p><p>
-    &#73;&#116; &#114;&#101;&#112;&#114;&#101;&#115;&#101;&#110;&#116;&#115; &#97; &#116;&#104;&#114;&#101;&#97;&#100; &#105;&#110; &#116;&#104;&#101; &#112;y&#116;&#104;&#111;&#110; &#105;&#110;&#116;&#101;&#114;&#112;&#114;&#101;&#116;&#101;&#114; &#116;&#104;&#97;&#116; w&#101; &#97;&#114;&#101; &#116;&#114;&#97;&#99;&#105;&#110;&#103;.
+    It represents a thread in the python interpreter that we are tracing.
 </p><p>
-    &#80;&#114;&#111;v&#105;&#100;&#101;&#115; &#115;&#105;&#109;&#112;&#108;&#101; w&#114;&#97;&#112;&#112;&#101;&#114; &#109;&#101;&#116;&#104;&#111;&#100;&#115; &#97;&#114;&#111;&#117;&#110;&#100; &#98;&#100;&#98; &#102;&#111;&#114; &#116;&#104;&#101; '&#111;w&#110;&#105;&#110;&#103;' &#99;&#108;&#105;&#101;&#110;&#116; &#116;&#111;
-    &#99;&#97;&#108;&#108; &#116;&#111; &#115;&#116;&#101;&#112; &#101;&#116;&#99;.
+    Provides simple wrapper methods around bdb for the 'owning' client to
+    call to step etc.
 </p>
 <h3>Derived from</h3>
 DebugBase
@@ -60,116 +60,116 @@
 <table>
 <tr>
 <td><a href="#DebugThread.__init__">DebugThread</a></td>
-<td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td>
+<td>Constructor</td>
 </tr><tr>
 <td><a href="#DebugThread.bootstrap">bootstrap</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#98;&#111;&#111;&#116;&#115;&#116;&#114;&#97;&#112; &#116;&#104;&#101; &#116;&#104;&#114;&#101;&#97;&#100;.</td>
+<td>Private method to bootstrap the thread.</td>
 </tr><tr>
 <td><a href="#DebugThread.get_ident">get_ident</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#105;&#100; &#111;&#102; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.</td>
+<td>Public method to return the id of this thread.</td>
 </tr><tr>
 <td><a href="#DebugThread.get_name">get_name</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.</td>
+<td>Public method to return the name of this thread.</td>
 </tr><tr>
 <td><a href="#DebugThread.set_ident">set_ident</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116; &#116;&#104;&#101; &#105;&#100; &#102;&#111;&#114; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.</td>
+<td>Public method to set the id for this thread.</td>
 </tr><tr>
 <td><a href="#DebugThread.traceThread">traceThread</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116;&#117;&#112; &#116;&#114;&#97;&#99;&#105;&#110;&#103; &#102;&#111;&#114; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.</td>
+<td>Private method to setup tracing for this thread.</td>
 </tr><tr>
 <td><a href="#DebugThread.trace_dispatch">trace_dispatch</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; w&#114;&#97;&#112;&#112;&#105;&#110;&#103; &#116;&#104;&#101; &#116;&#114;&#97;&#99;&#101;&#95;&#100;&#105;&#115;&#112;&#97;&#116;&#99;&#104; &#111;&#102; &#98;&#100;&#98;.&#112;y.</td>
+<td>Private method wrapping the trace_dispatch of bdb.py.</td>
 </tr>
 </table>
 <a NAME="DebugThread.__init__" ID="DebugThread.__init__"></a>
 <h4>DebugThread (Constructor)</h4>
 <b>DebugThread</b>(<i>dbgClient, targ = None, args = None, kwargs = None, mainThread = False</i>)
 <p>
-        &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;
+        Constructor
 </p><dl>
 <dt><i>dbgClient</i></dt>
 <dd>
-&#116;&#104;&#101; &#111;w&#110;&#105;&#110;&#103; &#99;&#108;&#105;&#101;&#110;&#116;
+the owning client
 </dd><dt><i>targ</i></dt>
 <dd>
-&#116;&#104;&#101; &#116;&#97;&#114;&#103;&#101;&#116; &#109;&#101;&#116;&#104;&#111;&#100; &#105;&#110; &#116;&#104;&#101; &#114;&#117;&#110; &#116;&#104;&#114;&#101;&#97;&#100;
+the target method in the run thread
 </dd><dt><i>args</i></dt>
 <dd>
-&#97;&#114;&#103;&#117;&#109;&#101;&#110;&#116;&#115; &#116;&#111; &#98;&#101; &#112;&#97;&#115;&#115;&#101;&#100; &#116;&#111; &#116;&#104;&#101; &#116;&#104;&#114;&#101;&#97;&#100;
+arguments to be passed to the thread
 </dd><dt><i>kwargs</i></dt>
 <dd>
-&#97;&#114;&#103;&#117;&#109;&#101;&#110;&#116;&#115; &#116;&#111; &#98;&#101; &#112;&#97;&#115;&#115;&#101;&#100; &#116;&#111; &#116;&#104;&#101; &#116;&#104;&#114;&#101;&#97;&#100;
+arguments to be passed to the thread
 </dd><dt><i>mainThread</i></dt>
 <dd>
-&#48; &#105;&#102; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100; &#105;&#115; &#110;&#111;&#116; &#116;&#104;&#101; &#109;&#97;&#105;&#110;&#115;&#99;&#114;&#105;&#112;&#116;&#115; &#116;&#104;&#114;&#101;&#97;&#100;
+0 if this thread is not the mainscripts thread
 </dd>
 </dl><a NAME="DebugThread.bootstrap" ID="DebugThread.bootstrap"></a>
 <h4>DebugThread.bootstrap</h4>
 <b>bootstrap</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#98;&#111;&#111;&#116;&#115;&#116;&#114;&#97;&#112; &#116;&#104;&#101; &#116;&#104;&#114;&#101;&#97;&#100;.
+        Private method to bootstrap the thread.
 </p><p>
-        &#73;&#116; w&#114;&#97;&#112;&#115; &#116;&#104;&#101; &#99;&#97;&#108;&#108; &#116;&#111; &#116;&#104;&#101; &#117;&#115;&#101;&#114; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110; &#116;&#111; &#101;&#110;&#97;&#98;&#108;&#101; &#116;&#114;&#97;&#99;&#105;&#110;&#103; 
-        &#98;&#101;&#102;&#111;&#114;&#101; &#104;&#97;&#110;&#100;.
+        It wraps the call to the user function to enable tracing 
+        before hand.
 </p><a NAME="DebugThread.get_ident" ID="DebugThread.get_ident"></a>
 <h4>DebugThread.get_ident</h4>
 <b>get_ident</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#105;&#100; &#111;&#102; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.
+        Public method to return the id of this thread.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#116;&#104;&#101; &#105;&#100; &#111;&#102; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100; (&#105;&#110;&#116;)
+the id of this thread (int)
 </dd>
 </dl><a NAME="DebugThread.get_name" ID="DebugThread.get_name"></a>
 <h4>DebugThread.get_name</h4>
 <b>get_name</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.
+        Public method to return the name of this thread.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100; (&#115;&#116;&#114;&#105;&#110;&#103;)
+name of this thread (string)
 </dd>
 </dl><a NAME="DebugThread.set_ident" ID="DebugThread.set_ident"></a>
 <h4>DebugThread.set_ident</h4>
 <b>set_ident</b>(<i>id</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116; &#116;&#104;&#101; &#105;&#100; &#102;&#111;&#114; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.
+        Public method to set the id for this thread.
 </p><dl>
 <dt><i>id</i></dt>
 <dd>
-&#105;&#100; &#102;&#111;&#114; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100; (&#105;&#110;&#116;)
+id for this thread (int)
 </dd>
 </dl><a NAME="DebugThread.traceThread" ID="DebugThread.traceThread"></a>
 <h4>DebugThread.traceThread</h4>
 <b>traceThread</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116;&#117;&#112; &#116;&#114;&#97;&#99;&#105;&#110;&#103; &#102;&#111;&#114; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.
+        Private method to setup tracing for this thread.
 </p><a NAME="DebugThread.trace_dispatch" ID="DebugThread.trace_dispatch"></a>
 <h4>DebugThread.trace_dispatch</h4>
 <b>trace_dispatch</b>(<i>frame, event, arg</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; w&#114;&#97;&#112;&#112;&#105;&#110;&#103; &#116;&#104;&#101; &#116;&#114;&#97;&#99;&#101;&#95;&#100;&#105;&#115;&#112;&#97;&#116;&#99;&#104; &#111;&#102; &#98;&#100;&#98;.&#112;y.
+        Private method wrapping the trace_dispatch of bdb.py.
 </p><p>
-        &#73;&#116; w&#114;&#97;&#112;&#115; &#116;&#104;&#101; &#99;&#97;&#108;&#108; &#116;&#111; &#100;&#105;&#115;&#112;&#97;&#116;&#99;&#104; &#116;&#114;&#97;&#99;&#105;&#110;&#103; &#105;&#110;&#116;&#111;
-        &#98;&#100;&#98; &#116;&#111; &#109;&#97;&#107;&#101; &#115;&#117;&#114;&#101; w&#101; &#104;&#97;v&#101; &#108;&#111;&#99;&#107;&#101;&#100; &#116;&#104;&#101; &#99;&#108;&#105;&#101;&#110;&#116; &#116;&#111; &#112;&#114;&#101;v&#101;&#110;&#116; &#109;&#117;&#108;&#116;&#105;&#112;&#108;&#101;
-        &#116;&#104;&#114;&#101;&#97;&#100;&#115; &#102;&#114;&#111;&#109; &#101;&#110;&#116;&#101;&#114;&#105;&#110;&#103; &#116;&#104;&#101; &#99;&#108;&#105;&#101;&#110;&#116; &#101;v&#101;&#110;&#116; &#108;&#111;&#111;&#112;.
+        It wraps the call to dispatch tracing into
+        bdb to make sure we have locked the client to prevent multiple
+        threads from entering the client event loop.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#84;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;.
+The current stack frame.
 </dd><dt><i>event</i></dt>
 <dd>
-&#84;&#104;&#101; &#116;&#114;&#97;&#99;&#101; &#101;v&#101;&#110;&#116; (&#115;&#116;&#114;&#105;&#110;&#103;)
+The trace event (string)
 </dd><dt><i>arg</i></dt>
 <dd>
-&#84;&#104;&#101; &#97;&#114;&#103;&#117;&#109;&#101;&#110;&#116;&#115;
+The arguments
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#108;&#111;&#99;&#97;&#108; &#116;&#114;&#97;&#99;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;
+local trace function
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>

eric ide

mercurial