eric7/Documentation/Source/eric7.Debugger.DebugServer.html

branch
eric7
changeset 8372
e0227a7c850e
child 8596
d64760b2da50
equal deleted inserted replaced
8371:d6062691d424 8372:e0227a7c850e
1 <!DOCTYPE html>
2 <html><head>
3 <title>eric7.Debugger.DebugServer</title>
4 <meta charset="UTF-8">
5 <style>
6 body {
7 background: #EDECE6;
8 margin: 0em 1em 10em 1em;
9 color: black;
10 }
11
12 h1 { color: white; background: #85774A; }
13 h2 { color: white; background: #85774A; }
14 h3 { color: white; background: #9D936E; }
15 h4 { color: white; background: #9D936E; }
16
17 a { color: #BA6D36; }
18
19 </style>
20 </head>
21 <body>
22 <a NAME="top" ID="top"></a>
23 <h1>eric7.Debugger.DebugServer</h1>
24
25 <p>
26 Module implementing the debug server.
27 </p>
28 <h3>Global Attributes</h3>
29
30 <table>
31 <tr><td>DebuggerInterfaces</td></tr>
32 </table>
33 <h3>Classes</h3>
34
35 <table>
36
37 <tr>
38 <td><a href="#DebugServer">DebugServer</a></td>
39 <td>Class implementing the debug server embedded within the IDE.</td>
40 </tr>
41 </table>
42 <h3>Functions</h3>
43
44 <table>
45 <tr><td>None</td></tr>
46 </table>
47 <hr />
48 <hr />
49 <a NAME="DebugServer" ID="DebugServer"></a>
50 <h2>DebugServer</h2>
51
52 <p>
53 Class implementing the debug server embedded within the IDE.
54 </p>
55 <h3>Signals</h3>
56 <dl>
57
58 <dt>appendStdout(msg)</dt>
59 <dd>
60 emitted when a passive debug connection is
61 established or lost
62 </dd>
63 <dt>callTraceInfo</dt>
64 <dd>
65 emitted after the client reported the call trace
66 data (isCall, fromFile, fromLine, fromFunction, toFile, toLine,
67 toFunction, debuggerId)
68 </dd>
69 <dt>clientBanner(version, platform, venvname)</dt>
70 <dd>
71 emitted after
72 the client banner data was received
73 </dd>
74 <dt>clientBreakConditionError(fn, lineno, debuggerId)</dt>
75 <dd>
76 emitted after the
77 client has signaled a syntax error in a breakpoint condition
78 </dd>
79 <dt>clientCapabilities(capabilities, cltype, venvname)</dt>
80 <dd>
81 emitted after
82 the clients capabilities were received
83 </dd>
84 <dt>clientClearBreak(filename, lineno, debuggerId)</dt>
85 <dd>
86 emitted after the
87 debug client has decided to clear a temporary breakpoint
88 </dd>
89 <dt>clientClearWatch(condition, debuggerId)</dt>
90 <dd>
91 emitted after the debug
92 client has decided to clear a temporary watch expression
93 </dd>
94 <dt>clientCompletionList(completionList, text)</dt>
95 <dd>
96 emitted after the
97 commandline completion list and the reworked search string was
98 received from the client
99 </dd>
100 <dt>clientDebuggerId(debuggerId)</dt>
101 <dd>
102 emitted to indicate a newly connected
103 debugger backend
104 </dd>
105 <dt>clientDisassembly(disassembly, debuggerId)</dt>
106 <dd>
107 emitted after the client
108 has sent a disassembly of the code raising an exception
109 </dd>
110 <dt>clientDisconnected(str)</dt>
111 <dd>
112 emitted after a debug client has
113 disconnected (i.e. closed the network socket)
114 </dd>
115 <dt>clientException(exceptionType, exceptionMessage, stackTrace,debuggerId, threadName)</dt>
116 <dd>
117 emitted after an exception occured on the
118 client side
119 </dd>
120 <dt>clientExit(str, int, str, bool, str)</dt>
121 <dd>
122 emitted after the client has
123 exited giving the program name, the exit status, an exit message, an
124 indication to be quiet and the ID of the exited client
125 </dd>
126 <dt>clientGone(bool)</dt>
127 <dd>
128 emitted if the client went away (planned or
129 unplanned)
130 </dd>
131 <dt>clientInterpreterChanged(str)</dt>
132 <dd>
133 emitted to signal a change of the
134 client interpreter
135 </dd>
136 <dt>clientLine(filename, lineno, debuggerId, threadName, forStack)</dt>
137 <dd>
138 emitted after the debug client has executed a line of code
139 </dd>
140 <dt>clientOutput(str)</dt>
141 <dd>
142 emitted after the client has sent some output
143 </dd>
144 <dt>clientProcessStderr(str)</dt>
145 <dd>
146 emitted after the client has sent some
147 output via stderr
148 </dd>
149 <dt>clientProcessStdout(str)</dt>
150 <dd>
151 emitted after the client has sent some
152 output via stdout
153 </dd>
154 <dt>clientRawInput(prompt, echo, debuggerId)</dt>
155 <dd>
156 emitted after a raw input
157 request was received
158 </dd>
159 <dt>clientRawInputSent(debuggerId)</dt>
160 <dd>
161 emitted after the data was sent
162 to the indicated debug client
163 </dd>
164 <dt>clientSignal(message, filename, linenumber, function name,function arguments, debuggerId)</dt>
165 <dd>
166 emitted after a signal has been
167 generated on the client side
168 </dd>
169 <dt>clientStack(stack, debuggerId, threadName)</dt>
170 <dd>
171 emitted after the
172 debug client has executed a line of code
173 </dd>
174 <dt>clientStatement(continue, debuggerId)</dt>
175 <dd>
176 emitted after an interactive
177 command has been executed. The parameter is False to indicate that the
178 command is complete and True if it needs more input.
179 </dd>
180 <dt>clientSyntaxError(message, filename, linenumber, characternumber,debuggerId, threadName)</dt>
181 <dd>
182 emitted after a syntax error has been detected
183 on the client side
184 </dd>
185 <dt>clientThreadList(currentId, threadList, debuggerId)</dt>
186 <dd>
187 emitted after
188 a thread list has been received
189 </dd>
190 <dt>clientThreadSet(debuggerId)</dt>
191 <dd>
192 emitted after the client has
193 acknowledged the change of the current thread
194 </dd>
195 <dt>clientVariable(scope, variables, debuggerId)</dt>
196 <dd>
197 emitted after a dump
198 for one class variable has been received
199 </dd>
200 <dt>clientVariables(scope, variables, debuggerId)</dt>
201 <dd>
202 emitted after a
203 variables dump has been received
204 </dd>
205 <dt>clientWatchConditionError(condition, debuggerId)</dt>
206 <dd>
207 emitted after the
208 client has signaled a syntax error in a watch expression
209 </dd>
210 <dt>lastClientExited()</dt>
211 <dd>
212 emitted to indicate that the last connected
213 debug client has terminated
214 </dd>
215 <dt>mainClientExit()</dt>
216 <dd>
217 emitted to indicate that the main client process
218 has exited
219 </dd>
220 <dt>passiveDebugStarted(str, bool)</dt>
221 <dd>
222 emitted after the debug client has
223 connected in passive debug mode
224 </dd>
225 <dt>utDiscovered(testCases, exc_type, exc_value)</dt>
226 <dd>
227 emitted after the
228 client has performed a test case discovery action
229 </dd>
230 <dt>utFinished()</dt>
231 <dd>
232 emitted after the client signalled the end of the
233 unittest
234 </dd>
235 <dt>utPrepared(nrTests, exc_type, exc_value)</dt>
236 <dd>
237 emitted after the client
238 has loaded a unittest suite
239 </dd>
240 <dt>utStartTest(testname, testdocu)</dt>
241 <dd>
242 emitted after the client has
243 started a test
244 </dd>
245 <dt>utStopTest()</dt>
246 <dd>
247 emitted after the client has finished a test
248 </dd>
249 <dt>utTestErrored(testname, exc_info, id)</dt>
250 <dd>
251 emitted after the client
252 reported an errored test
253 </dd>
254 <dt>utTestFailed(testname, exc_info, id)</dt>
255 <dd>
256 emitted after the client
257 reported a failed test
258 </dd>
259 <dt>utTestFailedExpected(testname, exc_info, id)</dt>
260 <dd>
261 emitted after the
262 client reported an expected test failure
263 </dd>
264 <dt>utTestSkipped(testname, reason, id)</dt>
265 <dd>
266 emitted after the client
267 reported a skipped test
268 </dd>
269 <dt>utTestSucceededUnexpected(testname, id)</dt>
270 <dd>
271 emitted after the client
272 reported an unexpected test success
273 </dd>
274 </dl>
275 <h3>Derived from</h3>
276 QTcpServer
277 <h3>Class Attributes</h3>
278
279 <table>
280 <tr><td>None</td></tr>
281 </table>
282 <h3>Class Methods</h3>
283
284 <table>
285 <tr><td>None</td></tr>
286 </table>
287 <h3>Methods</h3>
288
289 <table>
290
291 <tr>
292 <td><a href="#DebugServer.__init__">DebugServer</a></td>
293 <td>Constructor</td>
294 </tr>
295 <tr>
296 <td><a href="#DebugServer.__addBreakPoints">__addBreakPoints</a></td>
297 <td>Private slot to add breakpoints.</td>
298 </tr>
299 <tr>
300 <td><a href="#DebugServer.__addWatchPoints">__addWatchPoints</a></td>
301 <td>Private slot to set a watch expression.</td>
302 </tr>
303 <tr>
304 <td><a href="#DebugServer.__breakPointDataAboutToBeChanged">__breakPointDataAboutToBeChanged</a></td>
305 <td>Private slot to handle the dataAboutToBeChanged signal of the breakpoint model.</td>
306 </tr>
307 <tr>
308 <td><a href="#DebugServer.__changeBreakPoints">__changeBreakPoints</a></td>
309 <td>Private slot to set changed breakpoints.</td>
310 </tr>
311 <tr>
312 <td><a href="#DebugServer.__changeWatchPoints">__changeWatchPoints</a></td>
313 <td>Private slot to set changed watch expressions.</td>
314 </tr>
315 <tr>
316 <td><a href="#DebugServer.__clientClearBreakPoint">__clientClearBreakPoint</a></td>
317 <td>Private slot to handle the clientClearBreak signal.</td>
318 </tr>
319 <tr>
320 <td><a href="#DebugServer.__clientClearWatchPoint">__clientClearWatchPoint</a></td>
321 <td>Private slot to handle the clientClearWatch signal.</td>
322 </tr>
323 <tr>
324 <td><a href="#DebugServer.__clientProcessError">__clientProcessError</a></td>
325 <td>Private slot to process client output received via stderr.</td>
326 </tr>
327 <tr>
328 <td><a href="#DebugServer.__clientProcessOutput">__clientProcessOutput</a></td>
329 <td>Private slot to process client output received via stdout.</td>
330 </tr>
331 <tr>
332 <td><a href="#DebugServer.__createDebuggerInterface">__createDebuggerInterface</a></td>
333 <td>Private slot to create the debugger interface object.</td>
334 </tr>
335 <tr>
336 <td><a href="#DebugServer.__deleteBreakPoints">__deleteBreakPoints</a></td>
337 <td>Private slot to delete breakpoints.</td>
338 </tr>
339 <tr>
340 <td><a href="#DebugServer.__deleteWatchPoints">__deleteWatchPoints</a></td>
341 <td>Private slot to delete watch expressions.</td>
342 </tr>
343 <tr>
344 <td><a href="#DebugServer.__findLanguageForExtension">__findLanguageForExtension</a></td>
345 <td>Private method to get the language associated with a file extension.</td>
346 </tr>
347 <tr>
348 <td><a href="#DebugServer.__getNetworkInterfaceAndIndex">__getNetworkInterfaceAndIndex</a></td>
349 <td>Private method to determine the network interface and the interface index.</td>
350 </tr>
351 <tr>
352 <td><a href="#DebugServer.__makeWatchCondition">__makeWatchCondition</a></td>
353 <td>Private method to construct the condition string.</td>
354 </tr>
355 <tr>
356 <td><a href="#DebugServer.__newConnection">__newConnection</a></td>
357 <td>Private slot to handle a new connection.</td>
358 </tr>
359 <tr>
360 <td><a href="#DebugServer.__passiveShutDown">__passiveShutDown</a></td>
361 <td>Private method to shut down a passive debug connection.</td>
362 </tr>
363 <tr>
364 <td><a href="#DebugServer.__registerDebuggerInterfaces">__registerDebuggerInterfaces</a></td>
365 <td>Private method to register the available internal debugger interfaces.</td>
366 </tr>
367 <tr>
368 <td><a href="#DebugServer.__remoteBreakpointEnable">__remoteBreakpointEnable</a></td>
369 <td>Private method to enable or disable a breakpoint.</td>
370 </tr>
371 <tr>
372 <td><a href="#DebugServer.__remoteBreakpointIgnore">__remoteBreakpointIgnore</a></td>
373 <td>Private method to ignore a breakpoint the next couple of occurrences.</td>
374 </tr>
375 <tr>
376 <td><a href="#DebugServer.__remoteWatchpoint">__remoteWatchpoint</a></td>
377 <td>Private method to set or clear a watch expression.</td>
378 </tr>
379 <tr>
380 <td><a href="#DebugServer.__remoteWatchpointEnable">__remoteWatchpointEnable</a></td>
381 <td>Private method to enable or disable a watch expression.</td>
382 </tr>
383 <tr>
384 <td><a href="#DebugServer.__remoteWatchpointIgnore">__remoteWatchpointIgnore</a></td>
385 <td>Private method to ignore a watch expression the next couple of occurrences.</td>
386 </tr>
387 <tr>
388 <td><a href="#DebugServer.__restoreBreakpoints">__restoreBreakpoints</a></td>
389 <td>Private method to restore the breakpoints after a restart.</td>
390 </tr>
391 <tr>
392 <td><a href="#DebugServer.__restoreNoDebugList">__restoreNoDebugList</a></td>
393 <td>Private method to restore the list of scripts not to be debugged after a restart.</td>
394 </tr>
395 <tr>
396 <td><a href="#DebugServer.__restoreWatchpoints">__restoreWatchpoints</a></td>
397 <td>Private method to restore the watch expressions after a restart.</td>
398 </tr>
399 <tr>
400 <td><a href="#DebugServer.__setClientType">__setClientType</a></td>
401 <td>Private method to set the client type.</td>
402 </tr>
403 <tr>
404 <td><a href="#DebugServer.__splitWatchCondition">__splitWatchCondition</a></td>
405 <td>Private method to split a remote watch expression.</td>
406 </tr>
407 <tr>
408 <td><a href="#DebugServer.__watchPointDataAboutToBeChanged">__watchPointDataAboutToBeChanged</a></td>
409 <td>Private slot to handle the dataAboutToBeChanged signal of the watch expression model.</td>
410 </tr>
411 <tr>
412 <td><a href="#DebugServer.clientUtDiscovered">clientUtDiscovered</a></td>
413 <td>Public method to process the client unittest discover info.</td>
414 </tr>
415 <tr>
416 <td><a href="#DebugServer.clientUtFinished">clientUtFinished</a></td>
417 <td>Public method to process the client unit test finished info.</td>
418 </tr>
419 <tr>
420 <td><a href="#DebugServer.clientUtPrepared">clientUtPrepared</a></td>
421 <td>Public method to process the client unittest prepared info.</td>
422 </tr>
423 <tr>
424 <td><a href="#DebugServer.clientUtStartTest">clientUtStartTest</a></td>
425 <td>Public method to process the client start test info.</td>
426 </tr>
427 <tr>
428 <td><a href="#DebugServer.clientUtStopTest">clientUtStopTest</a></td>
429 <td>Public method to process the client stop test info.</td>
430 </tr>
431 <tr>
432 <td><a href="#DebugServer.clientUtTestErrored">clientUtTestErrored</a></td>
433 <td>Public method to process the client test errored info.</td>
434 </tr>
435 <tr>
436 <td><a href="#DebugServer.clientUtTestFailed">clientUtTestFailed</a></td>
437 <td>Public method to process the client test failed info.</td>
438 </tr>
439 <tr>
440 <td><a href="#DebugServer.clientUtTestFailedExpected">clientUtTestFailedExpected</a></td>
441 <td>Public method to process the client test failed expected info.</td>
442 </tr>
443 <tr>
444 <td><a href="#DebugServer.clientUtTestSkipped">clientUtTestSkipped</a></td>
445 <td>Public method to process the client test skipped info.</td>
446 </tr>
447 <tr>
448 <td><a href="#DebugServer.clientUtTestSucceededUnexpected">clientUtTestSucceededUnexpected</a></td>
449 <td>Public method to process the client test succeeded unexpected info.</td>
450 </tr>
451 <tr>
452 <td><a href="#DebugServer.getBreakPointModel">getBreakPointModel</a></td>
453 <td>Public slot to get a reference to the breakpoint model object.</td>
454 </tr>
455 <tr>
456 <td><a href="#DebugServer.getClientCapabilities">getClientCapabilities</a></td>
457 <td>Public method to retrieve the debug clients capabilities.</td>
458 </tr>
459 <tr>
460 <td><a href="#DebugServer.getClientInterpreter">getClientInterpreter</a></td>
461 <td>Public method to get the interpreter of the debug client.</td>
462 </tr>
463 <tr>
464 <td><a href="#DebugServer.getClientType">getClientType</a></td>
465 <td>Public method to get the currently running debug client type.</td>
466 </tr>
467 <tr>
468 <td><a href="#DebugServer.getDebuggerIds">getDebuggerIds</a></td>
469 <td>Public method to return the IDs of the connected debugger backends.</td>
470 </tr>
471 <tr>
472 <td><a href="#DebugServer.getExtensions">getExtensions</a></td>
473 <td>Public slot to get the extensions associated with the given language.</td>
474 </tr>
475 <tr>
476 <td><a href="#DebugServer.getHostAddress">getHostAddress</a></td>
477 <td>Public method to get the IP address or hostname the debug server is listening.</td>
478 </tr>
479 <tr>
480 <td><a href="#DebugServer.getSupportedLanguages">getSupportedLanguages</a></td>
481 <td>Public slot to return the supported programming languages.</td>
482 </tr>
483 <tr>
484 <td><a href="#DebugServer.getWatchPointModel">getWatchPointModel</a></td>
485 <td>Public slot to get a reference to the watch expression model object.</td>
486 </tr>
487 <tr>
488 <td><a href="#DebugServer.initializeClient">initializeClient</a></td>
489 <td>Public method to initialize a freshly connected debug client.</td>
490 </tr>
491 <tr>
492 <td><a href="#DebugServer.isClientProcessUp">isClientProcessUp</a></td>
493 <td>Public method to check, if the debug client process is up.</td>
494 </tr>
495 <tr>
496 <td><a href="#DebugServer.isConnected">isConnected</a></td>
497 <td>Public method to test, if the debug server is connected to a backend.</td>
498 </tr>
499 <tr>
500 <td><a href="#DebugServer.isDebugging">isDebugging</a></td>
501 <td>Public method to test, if the debug server is debugging.</td>
502 </tr>
503 <tr>
504 <td><a href="#DebugServer.masterClientConnected">masterClientConnected</a></td>
505 <td>Public method to perform actions after the master client has finally established the connection.</td>
506 </tr>
507 <tr>
508 <td><a href="#DebugServer.passiveStartUp">passiveStartUp</a></td>
509 <td>Public method to handle a passive debug connection.</td>
510 </tr>
511 <tr>
512 <td><a href="#DebugServer.preferencesChanged">preferencesChanged</a></td>
513 <td>Public slot to handle the preferencesChanged signal.</td>
514 </tr>
515 <tr>
516 <td><a href="#DebugServer.registerDebuggerInterface">registerDebuggerInterface</a></td>
517 <td>Public method to register a debugger interface.</td>
518 </tr>
519 <tr>
520 <td><a href="#DebugServer.remoteBanner">remoteBanner</a></td>
521 <td>Public slot to get the banner info of the remote client.</td>
522 </tr>
523 <tr>
524 <td><a href="#DebugServer.remoteBreakpoint">remoteBreakpoint</a></td>
525 <td>Public method to set or clear a breakpoint.</td>
526 </tr>
527 <tr>
528 <td><a href="#DebugServer.remoteCapabilities">remoteCapabilities</a></td>
529 <td>Public slot to get the debug clients capabilities.</td>
530 </tr>
531 <tr>
532 <td><a href="#DebugServer.remoteClientDisassembly">remoteClientDisassembly</a></td>
533 <td>Public method to ask the client for the latest traceback disassembly.</td>
534 </tr>
535 <tr>
536 <td><a href="#DebugServer.remoteClientSetFilter">remoteClientSetFilter</a></td>
537 <td>Public method to set a variables filter list.</td>
538 </tr>
539 <tr>
540 <td><a href="#DebugServer.remoteClientStack">remoteClientStack</a></td>
541 <td>Public method to request the stack of the main thread.</td>
542 </tr>
543 <tr>
544 <td><a href="#DebugServer.remoteClientVariable">remoteClientVariable</a></td>
545 <td>Public method to request the variables of the debugged program.</td>
546 </tr>
547 <tr>
548 <td><a href="#DebugServer.remoteClientVariables">remoteClientVariables</a></td>
549 <td>Public method to request the variables of the debugged program.</td>
550 </tr>
551 <tr>
552 <td><a href="#DebugServer.remoteCompletion">remoteCompletion</a></td>
553 <td>Public slot to get the a list of possible commandline completions from the remote client.</td>
554 </tr>
555 <tr>
556 <td><a href="#DebugServer.remoteContinue">remoteContinue</a></td>
557 <td>Public method to continue the debugged program.</td>
558 </tr>
559 <tr>
560 <td><a href="#DebugServer.remoteContinueUntil">remoteContinueUntil</a></td>
561 <td>Public method to continue the debugged program to the given line or until returning from the current frame.</td>
562 </tr>
563 <tr>
564 <td><a href="#DebugServer.remoteCoverage">remoteCoverage</a></td>
565 <td>Public method to load a new program to collect coverage data.</td>
566 </tr>
567 <tr>
568 <td><a href="#DebugServer.remoteEnvironment">remoteEnvironment</a></td>
569 <td>Public method to set the environment for a program to debug, run, ...</td>
570 </tr>
571 <tr>
572 <td><a href="#DebugServer.remoteLoad">remoteLoad</a></td>
573 <td>Public method to load a new program to debug.</td>
574 </tr>
575 <tr>
576 <td><a href="#DebugServer.remoteMoveIP">remoteMoveIP</a></td>
577 <td>Public method to move the instruction pointer to a different line.</td>
578 </tr>
579 <tr>
580 <td><a href="#DebugServer.remoteProfile">remoteProfile</a></td>
581 <td>Public method to load a new program to collect profiling data.</td>
582 </tr>
583 <tr>
584 <td><a href="#DebugServer.remoteRawInput">remoteRawInput</a></td>
585 <td>Public method to send the raw input to the debugged program.</td>
586 </tr>
587 <tr>
588 <td><a href="#DebugServer.remoteRun">remoteRun</a></td>
589 <td>Public method to load a new program to run.</td>
590 </tr>
591 <tr>
592 <td><a href="#DebugServer.remoteSetThread">remoteSetThread</a></td>
593 <td>Public method to request to set the given thread as current thread.</td>
594 </tr>
595 <tr>
596 <td><a href="#DebugServer.remoteStatement">remoteStatement</a></td>
597 <td>Public method to execute a Python statement.</td>
598 </tr>
599 <tr>
600 <td><a href="#DebugServer.remoteStep">remoteStep</a></td>
601 <td>Public method to single step the debugged program.</td>
602 </tr>
603 <tr>
604 <td><a href="#DebugServer.remoteStepOut">remoteStepOut</a></td>
605 <td>Public method to step out the debugged program.</td>
606 </tr>
607 <tr>
608 <td><a href="#DebugServer.remoteStepOver">remoteStepOver</a></td>
609 <td>Public method to step over the debugged program.</td>
610 </tr>
611 <tr>
612 <td><a href="#DebugServer.remoteStepQuit">remoteStepQuit</a></td>
613 <td>Public method to stop the debugged program.</td>
614 </tr>
615 <tr>
616 <td><a href="#DebugServer.remoteThreadList">remoteThreadList</a></td>
617 <td>Public method to request the list of threads from the client.</td>
618 </tr>
619 <tr>
620 <td><a href="#DebugServer.remoteUTDiscover">remoteUTDiscover</a></td>
621 <td>Public method to perform a test case discovery.</td>
622 </tr>
623 <tr>
624 <td><a href="#DebugServer.remoteUTPrepare">remoteUTPrepare</a></td>
625 <td>Public method to prepare a new unittest run.</td>
626 </tr>
627 <tr>
628 <td><a href="#DebugServer.remoteUTRun">remoteUTRun</a></td>
629 <td>Public method to start a unittest run.</td>
630 </tr>
631 <tr>
632 <td><a href="#DebugServer.remoteUTStop">remoteUTStop</a></td>
633 <td>public method to stop a unittest run.</td>
634 </tr>
635 <tr>
636 <td><a href="#DebugServer.setCallTraceEnabled">setCallTraceEnabled</a></td>
637 <td>Public method to set the call trace state.</td>
638 </tr>
639 <tr>
640 <td><a href="#DebugServer.setDebugging">setDebugging</a></td>
641 <td>Public method to set the debugging state.</td>
642 </tr>
643 <tr>
644 <td><a href="#DebugServer.shutdownServer">shutdownServer</a></td>
645 <td>Public method to cleanly shut down.</td>
646 </tr>
647 <tr>
648 <td><a href="#DebugServer.signalClientBanner">signalClientBanner</a></td>
649 <td>Public method to process the client banner info.</td>
650 </tr>
651 <tr>
652 <td><a href="#DebugServer.signalClientBreakConditionError">signalClientBreakConditionError</a></td>
653 <td>Public method to process the client breakpoint condition error info.</td>
654 </tr>
655 <tr>
656 <td><a href="#DebugServer.signalClientCallTrace">signalClientCallTrace</a></td>
657 <td>Public method to process the client call trace data.</td>
658 </tr>
659 <tr>
660 <td><a href="#DebugServer.signalClientCapabilities">signalClientCapabilities</a></td>
661 <td>Public method to process the client capabilities info.</td>
662 </tr>
663 <tr>
664 <td><a href="#DebugServer.signalClientClearBreak">signalClientClearBreak</a></td>
665 <td>Public method to process the client clear breakpoint command.</td>
666 </tr>
667 <tr>
668 <td><a href="#DebugServer.signalClientClearWatch">signalClientClearWatch</a></td>
669 <td>Public slot to handle the clientClearWatch signal.</td>
670 </tr>
671 <tr>
672 <td><a href="#DebugServer.signalClientCompletionList">signalClientCompletionList</a></td>
673 <td>Public method to process the client auto completion info.</td>
674 </tr>
675 <tr>
676 <td><a href="#DebugServer.signalClientDebuggerId">signalClientDebuggerId</a></td>
677 <td>Public method to signal the receipt of a new debugger ID.</td>
678 </tr>
679 <tr>
680 <td><a href="#DebugServer.signalClientDisassembly">signalClientDisassembly</a></td>
681 <td>Public method to process the disassembly info from the client.</td>
682 </tr>
683 <tr>
684 <td><a href="#DebugServer.signalClientDisconnected">signalClientDisconnected</a></td>
685 <td>Public method to send a signal when a debug client has closed its connection.</td>
686 </tr>
687 <tr>
688 <td><a href="#DebugServer.signalClientException">signalClientException</a></td>
689 <td>Public method to process the exception info from the client.</td>
690 </tr>
691 <tr>
692 <td><a href="#DebugServer.signalClientExit">signalClientExit</a></td>
693 <td>Public method to process the client exit status.</td>
694 </tr>
695 <tr>
696 <td><a href="#DebugServer.signalClientLine">signalClientLine</a></td>
697 <td>Public method to process client position feedback.</td>
698 </tr>
699 <tr>
700 <td><a href="#DebugServer.signalClientOutput">signalClientOutput</a></td>
701 <td>Public method to process a line of client output.</td>
702 </tr>
703 <tr>
704 <td><a href="#DebugServer.signalClientRawInput">signalClientRawInput</a></td>
705 <td>Public method to process the client raw input command.</td>
706 </tr>
707 <tr>
708 <td><a href="#DebugServer.signalClientSignal">signalClientSignal</a></td>
709 <td>Public method to process a signal generated on the client side.</td>
710 </tr>
711 <tr>
712 <td><a href="#DebugServer.signalClientStack">signalClientStack</a></td>
713 <td>Public method to process a client's stack information.</td>
714 </tr>
715 <tr>
716 <td><a href="#DebugServer.signalClientStatement">signalClientStatement</a></td>
717 <td>Public method to process the input response from the client.</td>
718 </tr>
719 <tr>
720 <td><a href="#DebugServer.signalClientSyntaxError">signalClientSyntaxError</a></td>
721 <td>Public method to process a syntax error info from the client.</td>
722 </tr>
723 <tr>
724 <td><a href="#DebugServer.signalClientThreadList">signalClientThreadList</a></td>
725 <td>Public method to process the client thread list info.</td>
726 </tr>
727 <tr>
728 <td><a href="#DebugServer.signalClientThreadSet">signalClientThreadSet</a></td>
729 <td>Public method to handle the change of the client thread.</td>
730 </tr>
731 <tr>
732 <td><a href="#DebugServer.signalClientVariable">signalClientVariable</a></td>
733 <td>Public method to process the client variable info.</td>
734 </tr>
735 <tr>
736 <td><a href="#DebugServer.signalClientVariables">signalClientVariables</a></td>
737 <td>Public method to process the client variables info.</td>
738 </tr>
739 <tr>
740 <td><a href="#DebugServer.signalClientWatchConditionError">signalClientWatchConditionError</a></td>
741 <td>Public method to process the client watch expression error info.</td>
742 </tr>
743 <tr>
744 <td><a href="#DebugServer.signalLastClientExited">signalLastClientExited</a></td>
745 <td>Public method to process the last client exit event.</td>
746 </tr>
747 <tr>
748 <td><a href="#DebugServer.signalMainClientExit">signalMainClientExit</a></td>
749 <td>Public method to process the main client exiting.</td>
750 </tr>
751 <tr>
752 <td><a href="#DebugServer.startClient">startClient</a></td>
753 <td>Public method to start a debug client.</td>
754 </tr>
755 <tr>
756 <td><a href="#DebugServer.unregisterDebuggerInterface">unregisterDebuggerInterface</a></td>
757 <td>Public method to unregister a debugger interface.</td>
758 </tr>
759 </table>
760 <h3>Static Methods</h3>
761
762 <table>
763 <tr><td>None</td></tr>
764 </table>
765
766 <a NAME="DebugServer.__init__" ID="DebugServer.__init__"></a>
767 <h4>DebugServer (Constructor)</h4>
768 <b>DebugServer</b>(<i>originalPathString, preventPassiveDebugging=False, project=None, parent=None</i>)
769
770 <p>
771 Constructor
772 </p>
773 <dl>
774
775 <dt><i>originalPathString</i> (str)</dt>
776 <dd>
777 original PATH environment variable
778 </dd>
779 <dt><i>preventPassiveDebugging</i> (bool (optional))</dt>
780 <dd>
781 flag overriding the PassiveDbgEnabled
782 setting (defaults to False)
783 </dd>
784 <dt><i>project</i> (Project (optional))</dt>
785 <dd>
786 reference to the project object (defaults to None)
787 </dd>
788 <dt><i>parent</i> (QObject)</dt>
789 <dd>
790 reference to the parent object
791 </dd>
792 </dl>
793 <a NAME="DebugServer.__addBreakPoints" ID="DebugServer.__addBreakPoints"></a>
794 <h4>DebugServer.__addBreakPoints</h4>
795 <b>__addBreakPoints</b>(<i>parentIndex, start, end, debuggerId=""</i>)
796
797 <p>
798 Private slot to add breakpoints.
799 </p>
800 <dl>
801
802 <dt><i>parentIndex</i> (QModelIndex)</dt>
803 <dd>
804 index of parent item
805 </dd>
806 <dt><i>start</i> (int)</dt>
807 <dd>
808 start row
809 </dd>
810 <dt><i>end</i> (int)</dt>
811 <dd>
812 end row
813 </dd>
814 <dt><i>debuggerId</i> (str)</dt>
815 <dd>
816 ID of the debugger backend to send to. If this is
817 empty, they will be broadcast to all connected backends.
818 </dd>
819 </dl>
820 <a NAME="DebugServer.__addWatchPoints" ID="DebugServer.__addWatchPoints"></a>
821 <h4>DebugServer.__addWatchPoints</h4>
822 <b>__addWatchPoints</b>(<i>parentIndex, start, end, debuggerId=""</i>)
823
824 <p>
825 Private slot to set a watch expression.
826 </p>
827 <dl>
828
829 <dt><i>parentIndex</i> (QModelIndex)</dt>
830 <dd>
831 index of parent item
832 </dd>
833 <dt><i>start</i> (int)</dt>
834 <dd>
835 start row
836 </dd>
837 <dt><i>end</i> (int)</dt>
838 <dd>
839 end row
840 </dd>
841 <dt><i>debuggerId</i> (str)</dt>
842 <dd>
843 ID of the debugger backend to send to. If this is
844 empty, they will be broadcast to all connected backends.
845 </dd>
846 </dl>
847 <a NAME="DebugServer.__breakPointDataAboutToBeChanged" ID="DebugServer.__breakPointDataAboutToBeChanged"></a>
848 <h4>DebugServer.__breakPointDataAboutToBeChanged</h4>
849 <b>__breakPointDataAboutToBeChanged</b>(<i>startIndex, endIndex</i>)
850
851 <p>
852 Private slot to handle the dataAboutToBeChanged signal of the
853 breakpoint model.
854 </p>
855 <dl>
856
857 <dt><i>startIndex</i> (QModelIndex)</dt>
858 <dd>
859 start index of the rows to be changed
860 </dd>
861 <dt><i>endIndex</i> (QModelIndex)</dt>
862 <dd>
863 end index of the rows to be changed
864 </dd>
865 </dl>
866 <a NAME="DebugServer.__changeBreakPoints" ID="DebugServer.__changeBreakPoints"></a>
867 <h4>DebugServer.__changeBreakPoints</h4>
868 <b>__changeBreakPoints</b>(<i>startIndex, endIndex</i>)
869
870 <p>
871 Private slot to set changed breakpoints.
872 </p>
873 <dl>
874
875 <dt><i>startIndex</i> (QModelIndex)</dt>
876 <dd>
877 starting index of the change breakpoins
878 </dd>
879 <dt><i>endIndex</i> (QModelIndex)</dt>
880 <dd>
881 ending index of the change breakpoins
882 </dd>
883 </dl>
884 <a NAME="DebugServer.__changeWatchPoints" ID="DebugServer.__changeWatchPoints"></a>
885 <h4>DebugServer.__changeWatchPoints</h4>
886 <b>__changeWatchPoints</b>(<i>startIndex, endIndex</i>)
887
888 <p>
889 Private slot to set changed watch expressions.
890 </p>
891 <dl>
892
893 <dt><i>startIndex</i> (QModelIndex)</dt>
894 <dd>
895 start index of the rows to be changed
896 </dd>
897 <dt><i>endIndex</i> (QModelIndex)</dt>
898 <dd>
899 end index of the rows to be changed
900 </dd>
901 </dl>
902 <a NAME="DebugServer.__clientClearBreakPoint" ID="DebugServer.__clientClearBreakPoint"></a>
903 <h4>DebugServer.__clientClearBreakPoint</h4>
904 <b>__clientClearBreakPoint</b>(<i>fn, lineno</i>)
905
906 <p>
907 Private slot to handle the clientClearBreak signal.
908 </p>
909 <dl>
910
911 <dt><i>fn</i> (str)</dt>
912 <dd>
913 filename of breakpoint to clear
914 </dd>
915 <dt><i>lineno</i> (int)</dt>
916 <dd>
917 line number of breakpoint to clear
918 </dd>
919 </dl>
920 <a NAME="DebugServer.__clientClearWatchPoint" ID="DebugServer.__clientClearWatchPoint"></a>
921 <h4>DebugServer.__clientClearWatchPoint</h4>
922 <b>__clientClearWatchPoint</b>(<i>condition</i>)
923
924 <p>
925 Private slot to handle the clientClearWatch signal.
926 </p>
927 <dl>
928
929 <dt><i>condition</i> (str)</dt>
930 <dd>
931 expression of watch expression to clear
932 </dd>
933 </dl>
934 <a NAME="DebugServer.__clientProcessError" ID="DebugServer.__clientProcessError"></a>
935 <h4>DebugServer.__clientProcessError</h4>
936 <b>__clientProcessError</b>(<i></i>)
937
938 <p>
939 Private slot to process client output received via stderr.
940 </p>
941 <a NAME="DebugServer.__clientProcessOutput" ID="DebugServer.__clientProcessOutput"></a>
942 <h4>DebugServer.__clientProcessOutput</h4>
943 <b>__clientProcessOutput</b>(<i></i>)
944
945 <p>
946 Private slot to process client output received via stdout.
947 </p>
948 <a NAME="DebugServer.__createDebuggerInterface" ID="DebugServer.__createDebuggerInterface"></a>
949 <h4>DebugServer.__createDebuggerInterface</h4>
950 <b>__createDebuggerInterface</b>(<i>clientType=None</i>)
951
952 <p>
953 Private slot to create the debugger interface object.
954 </p>
955 <dl>
956
957 <dt><i>clientType</i> (str)</dt>
958 <dd>
959 type of the client interface to be created
960 </dd>
961 </dl>
962 <a NAME="DebugServer.__deleteBreakPoints" ID="DebugServer.__deleteBreakPoints"></a>
963 <h4>DebugServer.__deleteBreakPoints</h4>
964 <b>__deleteBreakPoints</b>(<i>parentIndex, start, end</i>)
965
966 <p>
967 Private slot to delete breakpoints.
968 </p>
969 <dl>
970
971 <dt><i>parentIndex</i> (QModelIndex)</dt>
972 <dd>
973 index of parent item
974 </dd>
975 <dt><i>start</i> (int)</dt>
976 <dd>
977 start row
978 </dd>
979 <dt><i>end</i> (int)</dt>
980 <dd>
981 end row
982 </dd>
983 </dl>
984 <a NAME="DebugServer.__deleteWatchPoints" ID="DebugServer.__deleteWatchPoints"></a>
985 <h4>DebugServer.__deleteWatchPoints</h4>
986 <b>__deleteWatchPoints</b>(<i>parentIndex, start, end</i>)
987
988 <p>
989 Private slot to delete watch expressions.
990 </p>
991 <dl>
992
993 <dt><i>parentIndex</i> (QModelIndex)</dt>
994 <dd>
995 index of parent item
996 </dd>
997 <dt><i>start</i> (int)</dt>
998 <dd>
999 start row
1000 </dd>
1001 <dt><i>end</i> (int)</dt>
1002 <dd>
1003 end row
1004 </dd>
1005 </dl>
1006 <a NAME="DebugServer.__findLanguageForExtension" ID="DebugServer.__findLanguageForExtension"></a>
1007 <h4>DebugServer.__findLanguageForExtension</h4>
1008 <b>__findLanguageForExtension</b>(<i>ext</i>)
1009
1010 <p>
1011 Private method to get the language associated with a file extension.
1012 </p>
1013 <dl>
1014
1015 <dt><i>ext</i> (str)</dt>
1016 <dd>
1017 file extension
1018 </dd>
1019 </dl>
1020 <dl>
1021 <dt>Return:</dt>
1022 <dd>
1023 associated language
1024 </dd>
1025 </dl>
1026 <dl>
1027 <dt>Return Type:</dt>
1028 <dd>
1029 str
1030 </dd>
1031 </dl>
1032 <a NAME="DebugServer.__getNetworkInterfaceAndIndex" ID="DebugServer.__getNetworkInterfaceAndIndex"></a>
1033 <h4>DebugServer.__getNetworkInterfaceAndIndex</h4>
1034 <b>__getNetworkInterfaceAndIndex</b>(<i>address</i>)
1035
1036 <p>
1037 Private method to determine the network interface and the interface
1038 index.
1039 </p>
1040 <dl>
1041
1042 <dt><i>address</i> (str)</dt>
1043 <dd>
1044 address to determine the info for
1045 </dd>
1046 </dl>
1047 <dl>
1048 <dt>Return:</dt>
1049 <dd>
1050 tuple of network interface name and index
1051 </dd>
1052 </dl>
1053 <dl>
1054 <dt>Return Type:</dt>
1055 <dd>
1056 tuple of (str, int)
1057 </dd>
1058 </dl>
1059 <a NAME="DebugServer.__makeWatchCondition" ID="DebugServer.__makeWatchCondition"></a>
1060 <h4>DebugServer.__makeWatchCondition</h4>
1061 <b>__makeWatchCondition</b>(<i>cond, special</i>)
1062
1063 <p>
1064 Private method to construct the condition string.
1065 </p>
1066 <dl>
1067
1068 <dt><i>cond</i> (str)</dt>
1069 <dd>
1070 condition
1071 </dd>
1072 <dt><i>special</i> (str)</dt>
1073 <dd>
1074 special condition
1075 </dd>
1076 </dl>
1077 <dl>
1078 <dt>Return:</dt>
1079 <dd>
1080 condition string
1081 </dd>
1082 </dl>
1083 <dl>
1084 <dt>Return Type:</dt>
1085 <dd>
1086 str
1087 </dd>
1088 </dl>
1089 <a NAME="DebugServer.__newConnection" ID="DebugServer.__newConnection"></a>
1090 <h4>DebugServer.__newConnection</h4>
1091 <b>__newConnection</b>(<i></i>)
1092
1093 <p>
1094 Private slot to handle a new connection.
1095 </p>
1096 <a NAME="DebugServer.__passiveShutDown" ID="DebugServer.__passiveShutDown"></a>
1097 <h4>DebugServer.__passiveShutDown</h4>
1098 <b>__passiveShutDown</b>(<i></i>)
1099
1100 <p>
1101 Private method to shut down a passive debug connection.
1102 </p>
1103 <a NAME="DebugServer.__registerDebuggerInterfaces" ID="DebugServer.__registerDebuggerInterfaces"></a>
1104 <h4>DebugServer.__registerDebuggerInterfaces</h4>
1105 <b>__registerDebuggerInterfaces</b>(<i></i>)
1106
1107 <p>
1108 Private method to register the available internal debugger interfaces.
1109 </p>
1110 <a NAME="DebugServer.__remoteBreakpointEnable" ID="DebugServer.__remoteBreakpointEnable"></a>
1111 <h4>DebugServer.__remoteBreakpointEnable</h4>
1112 <b>__remoteBreakpointEnable</b>(<i>debuggerId, fn, line, enable</i>)
1113
1114 <p>
1115 Private method to enable or disable a breakpoint.
1116 </p>
1117 <dl>
1118
1119 <dt><i>debuggerId</i> (str)</dt>
1120 <dd>
1121 ID of the debugger backend
1122 </dd>
1123 <dt><i>fn</i> (str)</dt>
1124 <dd>
1125 filename the breakpoint belongs to
1126 </dd>
1127 <dt><i>line</i> (int)</dt>
1128 <dd>
1129 linenumber of the breakpoint
1130 </dd>
1131 <dt><i>enable</i> (bool)</dt>
1132 <dd>
1133 flag indicating enabling or disabling a breakpoint
1134 </dd>
1135 </dl>
1136 <a NAME="DebugServer.__remoteBreakpointIgnore" ID="DebugServer.__remoteBreakpointIgnore"></a>
1137 <h4>DebugServer.__remoteBreakpointIgnore</h4>
1138 <b>__remoteBreakpointIgnore</b>(<i>debuggerId, fn, line, count</i>)
1139
1140 <p>
1141 Private method to ignore a breakpoint the next couple of occurrences.
1142 </p>
1143 <dl>
1144
1145 <dt><i>debuggerId</i> (str)</dt>
1146 <dd>
1147 ID of the debugger backend
1148 </dd>
1149 <dt><i>fn</i> (str)</dt>
1150 <dd>
1151 filename the breakpoint belongs to
1152 </dd>
1153 <dt><i>line</i> (int)</dt>
1154 <dd>
1155 linenumber of the breakpoint
1156 </dd>
1157 <dt><i>count</i> (int)</dt>
1158 <dd>
1159 number of occurrences to ignore
1160 </dd>
1161 </dl>
1162 <a NAME="DebugServer.__remoteWatchpoint" ID="DebugServer.__remoteWatchpoint"></a>
1163 <h4>DebugServer.__remoteWatchpoint</h4>
1164 <b>__remoteWatchpoint</b>(<i>debuggerId, cond, setWatch, temp=False</i>)
1165
1166 <p>
1167 Private method to set or clear a watch expression.
1168 </p>
1169 <dl>
1170
1171 <dt><i>debuggerId</i> (str)</dt>
1172 <dd>
1173 ID of the debugger backend
1174 </dd>
1175 <dt><i>cond</i> (str)</dt>
1176 <dd>
1177 expression of the watch expression
1178 </dd>
1179 <dt><i>setWatch</i> (bool)</dt>
1180 <dd>
1181 flag indicating setting or resetting a watch expression
1182 </dd>
1183 <dt><i>temp</i> (bool)</dt>
1184 <dd>
1185 flag indicating a temporary watch expression
1186 </dd>
1187 </dl>
1188 <a NAME="DebugServer.__remoteWatchpointEnable" ID="DebugServer.__remoteWatchpointEnable"></a>
1189 <h4>DebugServer.__remoteWatchpointEnable</h4>
1190 <b>__remoteWatchpointEnable</b>(<i>debuggerId, cond, enable</i>)
1191
1192 <p>
1193 Private method to enable or disable a watch expression.
1194 </p>
1195 <dl>
1196
1197 <dt><i>debuggerId</i> (str)</dt>
1198 <dd>
1199 ID of the debugger backend
1200 </dd>
1201 <dt><i>cond</i> (str)</dt>
1202 <dd>
1203 expression of the watch expression
1204 </dd>
1205 <dt><i>enable</i> (bool)</dt>
1206 <dd>
1207 flag indicating enabling or disabling a watch expression
1208 </dd>
1209 </dl>
1210 <a NAME="DebugServer.__remoteWatchpointIgnore" ID="DebugServer.__remoteWatchpointIgnore"></a>
1211 <h4>DebugServer.__remoteWatchpointIgnore</h4>
1212 <b>__remoteWatchpointIgnore</b>(<i>debuggerId, cond, count</i>)
1213
1214 <p>
1215 Private method to ignore a watch expression the next couple of
1216 occurrences.
1217 </p>
1218 <dl>
1219
1220 <dt><i>debuggerId</i> (str)</dt>
1221 <dd>
1222 ID of the debugger backend
1223 </dd>
1224 <dt><i>cond</i> (str)</dt>
1225 <dd>
1226 expression of the watch expression
1227 </dd>
1228 <dt><i>count</i> (int)</dt>
1229 <dd>
1230 number of occurrences to ignore
1231 </dd>
1232 </dl>
1233 <a NAME="DebugServer.__restoreBreakpoints" ID="DebugServer.__restoreBreakpoints"></a>
1234 <h4>DebugServer.__restoreBreakpoints</h4>
1235 <b>__restoreBreakpoints</b>(<i>debuggerId=""</i>)
1236
1237 <p>
1238 Private method to restore the breakpoints after a restart.
1239 </p>
1240 <dl>
1241
1242 <dt><i>debuggerId</i> (str)</dt>
1243 <dd>
1244 ID of the debugger backend to send to. If this is
1245 empty, they will be broadcast to all connected backends.
1246 </dd>
1247 </dl>
1248 <a NAME="DebugServer.__restoreNoDebugList" ID="DebugServer.__restoreNoDebugList"></a>
1249 <h4>DebugServer.__restoreNoDebugList</h4>
1250 <b>__restoreNoDebugList</b>(<i>debuggerId=""</i>)
1251
1252 <p>
1253 Private method to restore the list of scripts not to be debugged after
1254 a restart.
1255 </p>
1256 <dl>
1257
1258 <dt><i>debuggerId</i> (str)</dt>
1259 <dd>
1260 ID of the debugger backend to send to. If this is
1261 empty, they will be broadcast to all connected backends.
1262 </dd>
1263 </dl>
1264 <a NAME="DebugServer.__restoreWatchpoints" ID="DebugServer.__restoreWatchpoints"></a>
1265 <h4>DebugServer.__restoreWatchpoints</h4>
1266 <b>__restoreWatchpoints</b>(<i>debuggerId=""</i>)
1267
1268 <p>
1269 Private method to restore the watch expressions after a restart.
1270 </p>
1271 <dl>
1272
1273 <dt><i>debuggerId</i> (str)</dt>
1274 <dd>
1275 ID of the debugger backend to send to. If this is
1276 empty, they will be broadcast to all connected backends.
1277 </dd>
1278 </dl>
1279 <a NAME="DebugServer.__setClientType" ID="DebugServer.__setClientType"></a>
1280 <h4>DebugServer.__setClientType</h4>
1281 <b>__setClientType</b>(<i>clType</i>)
1282
1283 <p>
1284 Private method to set the client type.
1285 </p>
1286 <dl>
1287
1288 <dt><i>clType</i> (str)</dt>
1289 <dd>
1290 type of client to be started
1291 </dd>
1292 </dl>
1293 <a NAME="DebugServer.__splitWatchCondition" ID="DebugServer.__splitWatchCondition"></a>
1294 <h4>DebugServer.__splitWatchCondition</h4>
1295 <b>__splitWatchCondition</b>(<i>cond</i>)
1296
1297 <p>
1298 Private method to split a remote watch expression.
1299 </p>
1300 <dl>
1301
1302 <dt><i>cond</i> (str)</dt>
1303 <dd>
1304 remote expression
1305 </dd>
1306 </dl>
1307 <dl>
1308 <dt>Return:</dt>
1309 <dd>
1310 tuple of local expression (string) and special condition
1311 </dd>
1312 </dl>
1313 <dl>
1314 <dt>Return Type:</dt>
1315 <dd>
1316 str
1317 </dd>
1318 </dl>
1319 <a NAME="DebugServer.__watchPointDataAboutToBeChanged" ID="DebugServer.__watchPointDataAboutToBeChanged"></a>
1320 <h4>DebugServer.__watchPointDataAboutToBeChanged</h4>
1321 <b>__watchPointDataAboutToBeChanged</b>(<i>startIndex, endIndex</i>)
1322
1323 <p>
1324 Private slot to handle the dataAboutToBeChanged signal of the
1325 watch expression model.
1326 </p>
1327 <dl>
1328
1329 <dt><i>startIndex</i> (QModelIndex)</dt>
1330 <dd>
1331 start index of the rows to be changed
1332 </dd>
1333 <dt><i>endIndex</i> (QModelIndex)</dt>
1334 <dd>
1335 end index of the rows to be changed
1336 </dd>
1337 </dl>
1338 <a NAME="DebugServer.clientUtDiscovered" ID="DebugServer.clientUtDiscovered"></a>
1339 <h4>DebugServer.clientUtDiscovered</h4>
1340 <b>clientUtDiscovered</b>(<i>testCases, exceptionType, exceptionValue</i>)
1341
1342 <p>
1343 Public method to process the client unittest discover info.
1344 </p>
1345 <dl>
1346
1347 <dt><i>testCases</i> (str)</dt>
1348 <dd>
1349 list of detected test cases
1350 </dd>
1351 <dt><i>exceptionType</i> (str)</dt>
1352 <dd>
1353 exception type
1354 </dd>
1355 <dt><i>exceptionValue</i> (str)</dt>
1356 <dd>
1357 exception message
1358 </dd>
1359 </dl>
1360 <a NAME="DebugServer.clientUtFinished" ID="DebugServer.clientUtFinished"></a>
1361 <h4>DebugServer.clientUtFinished</h4>
1362 <b>clientUtFinished</b>(<i>status</i>)
1363
1364 <p>
1365 Public method to process the client unit test finished info.
1366 </p>
1367 <dl>
1368
1369 <dt><i>status</i> (int)</dt>
1370 <dd>
1371 exit status of the unit test
1372 </dd>
1373 </dl>
1374 <a NAME="DebugServer.clientUtPrepared" ID="DebugServer.clientUtPrepared"></a>
1375 <h4>DebugServer.clientUtPrepared</h4>
1376 <b>clientUtPrepared</b>(<i>result, exceptionType, exceptionValue</i>)
1377
1378 <p>
1379 Public method to process the client unittest prepared info.
1380 </p>
1381 <dl>
1382
1383 <dt><i>result</i> (int)</dt>
1384 <dd>
1385 number of test cases (0 = error)
1386 </dd>
1387 <dt><i>exceptionType</i> (str)</dt>
1388 <dd>
1389 exception type
1390 </dd>
1391 <dt><i>exceptionValue</i> (str)</dt>
1392 <dd>
1393 exception message
1394 </dd>
1395 </dl>
1396 <a NAME="DebugServer.clientUtStartTest" ID="DebugServer.clientUtStartTest"></a>
1397 <h4>DebugServer.clientUtStartTest</h4>
1398 <b>clientUtStartTest</b>(<i>testname, doc</i>)
1399
1400 <p>
1401 Public method to process the client start test info.
1402 </p>
1403 <dl>
1404
1405 <dt><i>testname</i> (str)</dt>
1406 <dd>
1407 name of the test
1408 </dd>
1409 <dt><i>doc</i> (str)</dt>
1410 <dd>
1411 short description of the test
1412 </dd>
1413 </dl>
1414 <a NAME="DebugServer.clientUtStopTest" ID="DebugServer.clientUtStopTest"></a>
1415 <h4>DebugServer.clientUtStopTest</h4>
1416 <b>clientUtStopTest</b>(<i></i>)
1417
1418 <p>
1419 Public method to process the client stop test info.
1420 </p>
1421 <a NAME="DebugServer.clientUtTestErrored" ID="DebugServer.clientUtTestErrored"></a>
1422 <h4>DebugServer.clientUtTestErrored</h4>
1423 <b>clientUtTestErrored</b>(<i>testname, traceback, testId</i>)
1424
1425 <p>
1426 Public method to process the client test errored info.
1427 </p>
1428 <dl>
1429
1430 <dt><i>testname</i> (str)</dt>
1431 <dd>
1432 name of the test
1433 </dd>
1434 <dt><i>traceback</i> (list of str)</dt>
1435 <dd>
1436 lines of traceback info
1437 </dd>
1438 <dt><i>testId</i> (str)</dt>
1439 <dd>
1440 id of the test
1441 </dd>
1442 </dl>
1443 <a NAME="DebugServer.clientUtTestFailed" ID="DebugServer.clientUtTestFailed"></a>
1444 <h4>DebugServer.clientUtTestFailed</h4>
1445 <b>clientUtTestFailed</b>(<i>testname, traceback, testId</i>)
1446
1447 <p>
1448 Public method to process the client test failed info.
1449 </p>
1450 <dl>
1451
1452 <dt><i>testname</i> (str)</dt>
1453 <dd>
1454 name of the test
1455 </dd>
1456 <dt><i>traceback</i> (list of str)</dt>
1457 <dd>
1458 lines of traceback info
1459 </dd>
1460 <dt><i>testId</i> (str)</dt>
1461 <dd>
1462 id of the test
1463 </dd>
1464 </dl>
1465 <a NAME="DebugServer.clientUtTestFailedExpected" ID="DebugServer.clientUtTestFailedExpected"></a>
1466 <h4>DebugServer.clientUtTestFailedExpected</h4>
1467 <b>clientUtTestFailedExpected</b>(<i>testname, traceback, testId</i>)
1468
1469 <p>
1470 Public method to process the client test failed expected info.
1471 </p>
1472 <dl>
1473
1474 <dt><i>testname</i> (str)</dt>
1475 <dd>
1476 name of the test
1477 </dd>
1478 <dt><i>traceback</i> (list of str)</dt>
1479 <dd>
1480 lines of traceback info
1481 </dd>
1482 <dt><i>testId</i> (str)</dt>
1483 <dd>
1484 id of the test
1485 </dd>
1486 </dl>
1487 <a NAME="DebugServer.clientUtTestSkipped" ID="DebugServer.clientUtTestSkipped"></a>
1488 <h4>DebugServer.clientUtTestSkipped</h4>
1489 <b>clientUtTestSkipped</b>(<i>testname, reason, testId</i>)
1490
1491 <p>
1492 Public method to process the client test skipped info.
1493 </p>
1494 <dl>
1495
1496 <dt><i>testname</i> (str)</dt>
1497 <dd>
1498 name of the test
1499 </dd>
1500 <dt><i>reason</i> (str)</dt>
1501 <dd>
1502 reason for skipping the test
1503 </dd>
1504 <dt><i>testId</i> (str)</dt>
1505 <dd>
1506 id of the test
1507 </dd>
1508 </dl>
1509 <a NAME="DebugServer.clientUtTestSucceededUnexpected" ID="DebugServer.clientUtTestSucceededUnexpected"></a>
1510 <h4>DebugServer.clientUtTestSucceededUnexpected</h4>
1511 <b>clientUtTestSucceededUnexpected</b>(<i>testname, testId</i>)
1512
1513 <p>
1514 Public method to process the client test succeeded unexpected info.
1515 </p>
1516 <dl>
1517
1518 <dt><i>testname</i> (str)</dt>
1519 <dd>
1520 name of the test
1521 </dd>
1522 <dt><i>testId</i> (str)</dt>
1523 <dd>
1524 id of the test
1525 </dd>
1526 </dl>
1527 <a NAME="DebugServer.getBreakPointModel" ID="DebugServer.getBreakPointModel"></a>
1528 <h4>DebugServer.getBreakPointModel</h4>
1529 <b>getBreakPointModel</b>(<i></i>)
1530
1531 <p>
1532 Public slot to get a reference to the breakpoint model object.
1533 </p>
1534 <dl>
1535 <dt>Return:</dt>
1536 <dd>
1537 reference to the breakpoint model object
1538 </dd>
1539 </dl>
1540 <dl>
1541 <dt>Return Type:</dt>
1542 <dd>
1543 BreakPointModel
1544 </dd>
1545 </dl>
1546 <a NAME="DebugServer.getClientCapabilities" ID="DebugServer.getClientCapabilities"></a>
1547 <h4>DebugServer.getClientCapabilities</h4>
1548 <b>getClientCapabilities</b>(<i>clientType</i>)
1549
1550 <p>
1551 Public method to retrieve the debug clients capabilities.
1552 </p>
1553 <dl>
1554
1555 <dt><i>clientType</i> (str)</dt>
1556 <dd>
1557 debug client type
1558 </dd>
1559 </dl>
1560 <dl>
1561 <dt>Return:</dt>
1562 <dd>
1563 debug client capabilities
1564 </dd>
1565 </dl>
1566 <dl>
1567 <dt>Return Type:</dt>
1568 <dd>
1569 int
1570 </dd>
1571 </dl>
1572 <a NAME="DebugServer.getClientInterpreter" ID="DebugServer.getClientInterpreter"></a>
1573 <h4>DebugServer.getClientInterpreter</h4>
1574 <b>getClientInterpreter</b>(<i></i>)
1575
1576 <p>
1577 Public method to get the interpreter of the debug client.
1578 </p>
1579 <dl>
1580 <dt>Return:</dt>
1581 <dd>
1582 interpreter of the debug client
1583 </dd>
1584 </dl>
1585 <dl>
1586 <dt>Return Type:</dt>
1587 <dd>
1588 str
1589 </dd>
1590 </dl>
1591 <a NAME="DebugServer.getClientType" ID="DebugServer.getClientType"></a>
1592 <h4>DebugServer.getClientType</h4>
1593 <b>getClientType</b>(<i></i>)
1594
1595 <p>
1596 Public method to get the currently running debug client type.
1597 </p>
1598 <dl>
1599 <dt>Return:</dt>
1600 <dd>
1601 debug client type
1602 </dd>
1603 </dl>
1604 <dl>
1605 <dt>Return Type:</dt>
1606 <dd>
1607 str
1608 </dd>
1609 </dl>
1610 <a NAME="DebugServer.getDebuggerIds" ID="DebugServer.getDebuggerIds"></a>
1611 <h4>DebugServer.getDebuggerIds</h4>
1612 <b>getDebuggerIds</b>(<i></i>)
1613
1614 <p>
1615 Public method to return the IDs of the connected debugger backends.
1616 </p>
1617 <dl>
1618 <dt>Return:</dt>
1619 <dd>
1620 list of connected debugger backend IDs
1621 </dd>
1622 </dl>
1623 <dl>
1624 <dt>Return Type:</dt>
1625 <dd>
1626 list of str
1627 </dd>
1628 </dl>
1629 <a NAME="DebugServer.getExtensions" ID="DebugServer.getExtensions"></a>
1630 <h4>DebugServer.getExtensions</h4>
1631 <b>getExtensions</b>(<i>language</i>)
1632
1633 <p>
1634 Public slot to get the extensions associated with the given language.
1635 </p>
1636 <dl>
1637
1638 <dt><i>language</i> (str)</dt>
1639 <dd>
1640 language to get extensions for
1641 </dd>
1642 </dl>
1643 <dl>
1644 <dt>Return:</dt>
1645 <dd>
1646 tuple of extensions associated with the language
1647 </dd>
1648 </dl>
1649 <dl>
1650 <dt>Return Type:</dt>
1651 <dd>
1652 tuple of str
1653 </dd>
1654 </dl>
1655 <a NAME="DebugServer.getHostAddress" ID="DebugServer.getHostAddress"></a>
1656 <h4>DebugServer.getHostAddress</h4>
1657 <b>getHostAddress</b>(<i>localhost</i>)
1658
1659 <p>
1660 Public method to get the IP address or hostname the debug server is
1661 listening.
1662 </p>
1663 <dl>
1664
1665 <dt><i>localhost</i> (bool)</dt>
1666 <dd>
1667 flag indicating to return the address for localhost
1668 </dd>
1669 </dl>
1670 <dl>
1671 <dt>Return:</dt>
1672 <dd>
1673 IP address or hostname
1674 </dd>
1675 </dl>
1676 <dl>
1677 <dt>Return Type:</dt>
1678 <dd>
1679 str
1680 </dd>
1681 </dl>
1682 <a NAME="DebugServer.getSupportedLanguages" ID="DebugServer.getSupportedLanguages"></a>
1683 <h4>DebugServer.getSupportedLanguages</h4>
1684 <b>getSupportedLanguages</b>(<i>shellOnly=False</i>)
1685
1686 <p>
1687 Public slot to return the supported programming languages.
1688 </p>
1689 <dl>
1690
1691 <dt><i>shellOnly</i> (bool)</dt>
1692 <dd>
1693 flag indicating only languages supporting an
1694 interactive shell should be returned
1695 </dd>
1696 </dl>
1697 <dl>
1698 <dt>Return:</dt>
1699 <dd>
1700 list of supported languages
1701 </dd>
1702 </dl>
1703 <dl>
1704 <dt>Return Type:</dt>
1705 <dd>
1706 list of str
1707 </dd>
1708 </dl>
1709 <a NAME="DebugServer.getWatchPointModel" ID="DebugServer.getWatchPointModel"></a>
1710 <h4>DebugServer.getWatchPointModel</h4>
1711 <b>getWatchPointModel</b>(<i></i>)
1712
1713 <p>
1714 Public slot to get a reference to the watch expression model object.
1715 </p>
1716 <dl>
1717 <dt>Return:</dt>
1718 <dd>
1719 reference to the watch expression model object
1720 </dd>
1721 </dl>
1722 <dl>
1723 <dt>Return Type:</dt>
1724 <dd>
1725 WatchPointModel
1726 </dd>
1727 </dl>
1728 <a NAME="DebugServer.initializeClient" ID="DebugServer.initializeClient"></a>
1729 <h4>DebugServer.initializeClient</h4>
1730 <b>initializeClient</b>(<i>debuggerId</i>)
1731
1732 <p>
1733 Public method to initialize a freshly connected debug client.
1734 </p>
1735 <dl>
1736
1737 <dt><i>debuggerId</i> (str)</dt>
1738 <dd>
1739 ID of the connected debugger
1740 </dd>
1741 </dl>
1742 <a NAME="DebugServer.isClientProcessUp" ID="DebugServer.isClientProcessUp"></a>
1743 <h4>DebugServer.isClientProcessUp</h4>
1744 <b>isClientProcessUp</b>(<i></i>)
1745
1746 <p>
1747 Public method to check, if the debug client process is up.
1748 </p>
1749 <dl>
1750 <dt>Return:</dt>
1751 <dd>
1752 flag indicating a running debug client process
1753 </dd>
1754 </dl>
1755 <dl>
1756 <dt>Return Type:</dt>
1757 <dd>
1758 bool
1759 </dd>
1760 </dl>
1761 <a NAME="DebugServer.isConnected" ID="DebugServer.isConnected"></a>
1762 <h4>DebugServer.isConnected</h4>
1763 <b>isConnected</b>(<i></i>)
1764
1765 <p>
1766 Public method to test, if the debug server is connected to a backend.
1767 </p>
1768 <dl>
1769 <dt>Return:</dt>
1770 <dd>
1771 flag indicating a connection
1772 </dd>
1773 </dl>
1774 <dl>
1775 <dt>Return Type:</dt>
1776 <dd>
1777 bool
1778 </dd>
1779 </dl>
1780 <a NAME="DebugServer.isDebugging" ID="DebugServer.isDebugging"></a>
1781 <h4>DebugServer.isDebugging</h4>
1782 <b>isDebugging</b>(<i></i>)
1783
1784 <p>
1785 Public method to test, if the debug server is debugging.
1786 </p>
1787 <dl>
1788 <dt>Return:</dt>
1789 <dd>
1790 flag indicating the debugging state
1791 </dd>
1792 </dl>
1793 <dl>
1794 <dt>Return Type:</dt>
1795 <dd>
1796 bool
1797 </dd>
1798 </dl>
1799 <a NAME="DebugServer.masterClientConnected" ID="DebugServer.masterClientConnected"></a>
1800 <h4>DebugServer.masterClientConnected</h4>
1801 <b>masterClientConnected</b>(<i></i>)
1802
1803 <p>
1804 Public method to perform actions after the master client has finally
1805 established the connection.
1806 </p>
1807 <a NAME="DebugServer.passiveStartUp" ID="DebugServer.passiveStartUp"></a>
1808 <h4>DebugServer.passiveStartUp</h4>
1809 <b>passiveStartUp</b>(<i>fn, exc, debuggerId</i>)
1810
1811 <p>
1812 Public method to handle a passive debug connection.
1813 </p>
1814 <dl>
1815
1816 <dt><i>fn</i> (str)</dt>
1817 <dd>
1818 filename of the debugged script
1819 </dd>
1820 <dt><i>exc</i> (bool)</dt>
1821 <dd>
1822 flag to enable exception reporting of the IDE
1823 </dd>
1824 <dt><i>debuggerId</i> (str)</dt>
1825 <dd>
1826 ID of the debugger backend
1827 </dd>
1828 </dl>
1829 <a NAME="DebugServer.preferencesChanged" ID="DebugServer.preferencesChanged"></a>
1830 <h4>DebugServer.preferencesChanged</h4>
1831 <b>preferencesChanged</b>(<i></i>)
1832
1833 <p>
1834 Public slot to handle the preferencesChanged signal.
1835 </p>
1836 <a NAME="DebugServer.registerDebuggerInterface" ID="DebugServer.registerDebuggerInterface"></a>
1837 <h4>DebugServer.registerDebuggerInterface</h4>
1838 <b>registerDebuggerInterface</b>(<i>interfaceName, getRegistryData, reregister=False</i>)
1839
1840 <p>
1841 Public method to register a debugger interface.
1842 </p>
1843 <dl>
1844
1845 <dt><i>interfaceName</i> (str)</dt>
1846 <dd>
1847 name of the debugger interface
1848 </dd>
1849 <dt><i>getRegistryData</i> (function)</dt>
1850 <dd>
1851 reference to a function to be called
1852 to get the debugger interface details. This method shall
1853 return the client language, the client capabilities, the
1854 list of associated file extensions and a function reference
1855 to create the debugger interface (see __createDebuggerInterface())
1856 </dd>
1857 <dt><i>reregister</i> (bool)</dt>
1858 <dd>
1859 flag indicating to re-register the interface
1860 </dd>
1861 </dl>
1862 <a NAME="DebugServer.remoteBanner" ID="DebugServer.remoteBanner"></a>
1863 <h4>DebugServer.remoteBanner</h4>
1864 <b>remoteBanner</b>(<i></i>)
1865
1866 <p>
1867 Public slot to get the banner info of the remote client.
1868 </p>
1869 <a NAME="DebugServer.remoteBreakpoint" ID="DebugServer.remoteBreakpoint"></a>
1870 <h4>DebugServer.remoteBreakpoint</h4>
1871 <b>remoteBreakpoint</b>(<i>debuggerId, fn, line, setBreakpoint, cond=None, temp=False</i>)
1872
1873 <p>
1874 Public method to set or clear a breakpoint.
1875 </p>
1876 <dl>
1877
1878 <dt><i>debuggerId</i> (str)</dt>
1879 <dd>
1880 ID of the debugger backend
1881 </dd>
1882 <dt><i>fn</i> (str)</dt>
1883 <dd>
1884 filename the breakpoint belongs to
1885 </dd>
1886 <dt><i>line</i> (int)</dt>
1887 <dd>
1888 linenumber of the breakpoint
1889 </dd>
1890 <dt><i>setBreakpoint</i> (bool)</dt>
1891 <dd>
1892 flag indicating setting or resetting a breakpoint
1893 </dd>
1894 <dt><i>cond</i> (str)</dt>
1895 <dd>
1896 condition of the breakpoint
1897 </dd>
1898 <dt><i>temp</i> (bool)</dt>
1899 <dd>
1900 flag indicating a temporary breakpoint
1901 </dd>
1902 </dl>
1903 <a NAME="DebugServer.remoteCapabilities" ID="DebugServer.remoteCapabilities"></a>
1904 <h4>DebugServer.remoteCapabilities</h4>
1905 <b>remoteCapabilities</b>(<i></i>)
1906
1907 <p>
1908 Public slot to get the debug clients capabilities.
1909 </p>
1910 <a NAME="DebugServer.remoteClientDisassembly" ID="DebugServer.remoteClientDisassembly"></a>
1911 <h4>DebugServer.remoteClientDisassembly</h4>
1912 <b>remoteClientDisassembly</b>(<i>debuggerId</i>)
1913
1914 <p>
1915 Public method to ask the client for the latest traceback disassembly.
1916 </p>
1917 <dl>
1918
1919 <dt><i>debuggerId</i> (str)</dt>
1920 <dd>
1921 ID of the debugger backend
1922 </dd>
1923 </dl>
1924 <a NAME="DebugServer.remoteClientSetFilter" ID="DebugServer.remoteClientSetFilter"></a>
1925 <h4>DebugServer.remoteClientSetFilter</h4>
1926 <b>remoteClientSetFilter</b>(<i>debuggerId, scope, filterStr</i>)
1927
1928 <p>
1929 Public method to set a variables filter list.
1930 </p>
1931 <dl>
1932
1933 <dt><i>debuggerId</i> (str)</dt>
1934 <dd>
1935 ID of the debugger backend
1936 </dd>
1937 <dt><i>scope</i> (int)</dt>
1938 <dd>
1939 the scope of the variables (0 = local, 1 = global)
1940 </dd>
1941 <dt><i>filterStr</i> (str)</dt>
1942 <dd>
1943 regexp string for variable names to filter out
1944 </dd>
1945 </dl>
1946 <a NAME="DebugServer.remoteClientStack" ID="DebugServer.remoteClientStack"></a>
1947 <h4>DebugServer.remoteClientStack</h4>
1948 <b>remoteClientStack</b>(<i>debuggerId</i>)
1949
1950 <p>
1951 Public method to request the stack of the main thread.
1952 </p>
1953 <dl>
1954
1955 <dt><i>debuggerId</i> (str)</dt>
1956 <dd>
1957 ID of the debugger backend
1958 </dd>
1959 </dl>
1960 <a NAME="DebugServer.remoteClientVariable" ID="DebugServer.remoteClientVariable"></a>
1961 <h4>DebugServer.remoteClientVariable</h4>
1962 <b>remoteClientVariable</b>(<i>debuggerId, scope, filterList, var, framenr=0, maxSize=0</i>)
1963
1964 <p>
1965 Public method to request the variables of the debugged program.
1966 </p>
1967 <dl>
1968
1969 <dt><i>debuggerId</i> (str)</dt>
1970 <dd>
1971 ID of the debugger backend
1972 </dd>
1973 <dt><i>scope</i> (int)</dt>
1974 <dd>
1975 the scope of the variables (0 = local, 1 = global)
1976 </dd>
1977 <dt><i>filterList</i> (list of str)</dt>
1978 <dd>
1979 list of variable types to filter out
1980 </dd>
1981 <dt><i>var</i> (list of str)</dt>
1982 <dd>
1983 list encoded name of variable to retrieve
1984 </dd>
1985 <dt><i>framenr</i> (int)</dt>
1986 <dd>
1987 framenumber of the variables to retrieve
1988 </dd>
1989 <dt><i>maxSize</i> (int)</dt>
1990 <dd>
1991 maximum size the formatted value of a variable will
1992 be shown. If it is bigger than that, a 'too big' indication will
1993 be given (@@TOO_BIG_TO_SHOW@@).
1994 </dd>
1995 </dl>
1996 <a NAME="DebugServer.remoteClientVariables" ID="DebugServer.remoteClientVariables"></a>
1997 <h4>DebugServer.remoteClientVariables</h4>
1998 <b>remoteClientVariables</b>(<i>debuggerId, scope, filterList, framenr=0</i>)
1999
2000 <p>
2001 Public method to request the variables of the debugged program.
2002 </p>
2003 <dl>
2004
2005 <dt><i>debuggerId</i> (str)</dt>
2006 <dd>
2007 ID of the debugger backend
2008 </dd>
2009 <dt><i>scope</i> (int)</dt>
2010 <dd>
2011 the scope of the variables (0 = local, 1 = global)
2012 </dd>
2013 <dt><i>filterList</i> (list of str)</dt>
2014 <dd>
2015 list of variable types to filter out
2016 </dd>
2017 <dt><i>framenr</i> (int)</dt>
2018 <dd>
2019 framenumber of the variables to retrieve
2020 </dd>
2021 </dl>
2022 <a NAME="DebugServer.remoteCompletion" ID="DebugServer.remoteCompletion"></a>
2023 <h4>DebugServer.remoteCompletion</h4>
2024 <b>remoteCompletion</b>(<i>debuggerId, text</i>)
2025
2026 <p>
2027 Public slot to get the a list of possible commandline completions
2028 from the remote client.
2029 </p>
2030 <dl>
2031
2032 <dt><i>debuggerId</i> (str)</dt>
2033 <dd>
2034 ID of the debugger backend
2035 </dd>
2036 <dt><i>text</i> (str)</dt>
2037 <dd>
2038 the text to be completed
2039 </dd>
2040 </dl>
2041 <a NAME="DebugServer.remoteContinue" ID="DebugServer.remoteContinue"></a>
2042 <h4>DebugServer.remoteContinue</h4>
2043 <b>remoteContinue</b>(<i>debuggerId, special=False</i>)
2044
2045 <p>
2046 Public method to continue the debugged program.
2047 </p>
2048 <dl>
2049
2050 <dt><i>debuggerId</i> (str)</dt>
2051 <dd>
2052 ID of the debugger backend
2053 </dd>
2054 <dt><i>special</i></dt>
2055 <dd>
2056 flag indicating a special continue operation
2057 </dd>
2058 </dl>
2059 <a NAME="DebugServer.remoteContinueUntil" ID="DebugServer.remoteContinueUntil"></a>
2060 <h4>DebugServer.remoteContinueUntil</h4>
2061 <b>remoteContinueUntil</b>(<i>debuggerId, line</i>)
2062
2063 <p>
2064 Public method to continue the debugged program to the given line
2065 or until returning from the current frame.
2066 </p>
2067 <dl>
2068
2069 <dt><i>debuggerId</i> (str)</dt>
2070 <dd>
2071 ID of the debugger backend
2072 </dd>
2073 <dt><i>line</i> (int)</dt>
2074 <dd>
2075 the new line, where execution should be continued to
2076 </dd>
2077 </dl>
2078 <a NAME="DebugServer.remoteCoverage" ID="DebugServer.remoteCoverage"></a>
2079 <h4>DebugServer.remoteCoverage</h4>
2080 <b>remoteCoverage</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, erase=False, forProject=False, runInConsole=False, clientType="", configOverride=None</i>)
2081
2082 <p>
2083 Public method to load a new program to collect coverage data.
2084 </p>
2085 <dl>
2086
2087 <dt><i>venvName</i> (str)</dt>
2088 <dd>
2089 name of the virtual environment to be used
2090 </dd>
2091 <dt><i>fn</i> (str)</dt>
2092 <dd>
2093 the filename to debug
2094 </dd>
2095 <dt><i>argv</i> (str)</dt>
2096 <dd>
2097 the command line arguments to pass to the program
2098 </dd>
2099 <dt><i>wd</i> (str)</dt>
2100 <dd>
2101 the working directory for the program
2102 </dd>
2103 <dt><i>env</i> (str)</dt>
2104 <dd>
2105 environment parameter settings
2106 </dd>
2107 <dt><i>autoClearShell</i> (bool)</dt>
2108 <dd>
2109 flag indicating, that the interpreter window
2110 should be cleared
2111 </dd>
2112 <dt><i>erase</i> (bool)</dt>
2113 <dd>
2114 flag indicating that coverage info should be
2115 cleared first
2116 </dd>
2117 <dt><i>forProject</i> (bool)</dt>
2118 <dd>
2119 flag indicating a project related action
2120 </dd>
2121 <dt><i>runInConsole</i> (bool)</dt>
2122 <dd>
2123 flag indicating to start the debugger in a
2124 console window
2125 </dd>
2126 <dt><i>clientType</i> (str)</dt>
2127 <dd>
2128 client type to be used
2129 </dd>
2130 <dt><i>configOverride</i> (dict)</dt>
2131 <dd>
2132 dictionary containing the global config override
2133 data
2134 </dd>
2135 </dl>
2136 <a NAME="DebugServer.remoteEnvironment" ID="DebugServer.remoteEnvironment"></a>
2137 <h4>DebugServer.remoteEnvironment</h4>
2138 <b>remoteEnvironment</b>(<i>env</i>)
2139
2140 <p>
2141 Public method to set the environment for a program to debug, run, ...
2142 </p>
2143 <dl>
2144
2145 <dt><i>env</i> (str)</dt>
2146 <dd>
2147 environment settings
2148 </dd>
2149 </dl>
2150 <a NAME="DebugServer.remoteLoad" ID="DebugServer.remoteLoad"></a>
2151 <h4>DebugServer.remoteLoad</h4>
2152 <b>remoteLoad</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, tracePython=False, autoContinue=True, forProject=False, runInConsole=False, clientType="", enableCallTrace=False, enableMultiprocess=False, multiprocessNoDebug="", configOverride=None</i>)
2153
2154 <p>
2155 Public method to load a new program to debug.
2156 </p>
2157 <dl>
2158
2159 <dt><i>venvName</i> (str)</dt>
2160 <dd>
2161 name of the virtual environment to be used
2162 </dd>
2163 <dt><i>fn</i> (str)</dt>
2164 <dd>
2165 the filename to debug
2166 </dd>
2167 <dt><i>argv</i> (str)</dt>
2168 <dd>
2169 the command line arguments to pass to the program
2170 </dd>
2171 <dt><i>wd</i> (str)</dt>
2172 <dd>
2173 the working directory for the program
2174 </dd>
2175 <dt><i>env</i> (str)</dt>
2176 <dd>
2177 environment parameter settings
2178 </dd>
2179 <dt><i>autoClearShell</i> (bool)</dt>
2180 <dd>
2181 flag indicating, that the interpreter window
2182 should be cleared
2183 </dd>
2184 <dt><i>tracePython</i> (bool)</dt>
2185 <dd>
2186 flag indicating if the Python library should be
2187 traced as well
2188 </dd>
2189 <dt><i>autoContinue</i> (bool)</dt>
2190 <dd>
2191 flag indicating, that the debugger should not
2192 stop at the first executable line
2193 </dd>
2194 <dt><i>forProject</i> (bool)</dt>
2195 <dd>
2196 flag indicating a project related action
2197 </dd>
2198 <dt><i>runInConsole</i> (bool)</dt>
2199 <dd>
2200 flag indicating to start the debugger in a
2201 console window
2202 </dd>
2203 <dt><i>clientType</i> (str)</dt>
2204 <dd>
2205 client type to be used
2206 </dd>
2207 <dt><i>enableCallTrace</i> (bool)</dt>
2208 <dd>
2209 flag indicating to enable the call trace
2210 function
2211 </dd>
2212 <dt><i>enableMultiprocess</i> (bool)</dt>
2213 <dd>
2214 flag indicating to perform multiprocess
2215 debugging
2216 </dd>
2217 <dt><i>multiprocessNoDebug</i> (str)</dt>
2218 <dd>
2219 space separated list of programs not to be
2220 debugged
2221 </dd>
2222 <dt><i>configOverride</i> (dict)</dt>
2223 <dd>
2224 dictionary containing the global config override
2225 data
2226 </dd>
2227 </dl>
2228 <a NAME="DebugServer.remoteMoveIP" ID="DebugServer.remoteMoveIP"></a>
2229 <h4>DebugServer.remoteMoveIP</h4>
2230 <b>remoteMoveIP</b>(<i>debuggerId, line</i>)
2231
2232 <p>
2233 Public method to move the instruction pointer to a different line.
2234 </p>
2235 <dl>
2236
2237 <dt><i>debuggerId</i> (str)</dt>
2238 <dd>
2239 ID of the debugger backend
2240 </dd>
2241 <dt><i>line</i> (int)</dt>
2242 <dd>
2243 the new line, where execution should be continued
2244 </dd>
2245 </dl>
2246 <a NAME="DebugServer.remoteProfile" ID="DebugServer.remoteProfile"></a>
2247 <h4>DebugServer.remoteProfile</h4>
2248 <b>remoteProfile</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, erase=False, forProject=False, runInConsole=False, clientType="", configOverride=None</i>)
2249
2250 <p>
2251 Public method to load a new program to collect profiling data.
2252 </p>
2253 <dl>
2254
2255 <dt><i>venvName</i> (str)</dt>
2256 <dd>
2257 name of the virtual environment to be used
2258 </dd>
2259 <dt><i>fn</i> (str)</dt>
2260 <dd>
2261 the filename to debug
2262 </dd>
2263 <dt><i>argv</i> (str)</dt>
2264 <dd>
2265 the command line arguments to pass to the program
2266 </dd>
2267 <dt><i>wd</i> (str)</dt>
2268 <dd>
2269 the working directory for the program
2270 </dd>
2271 <dt><i>env</i> (str)</dt>
2272 <dd>
2273 environment parameter settings
2274 </dd>
2275 <dt><i>autoClearShell</i> (bool)</dt>
2276 <dd>
2277 flag indicating, that the interpreter window
2278 should be cleared
2279 </dd>
2280 <dt><i>erase</i> (bool)</dt>
2281 <dd>
2282 flag indicating that coverage info should be
2283 cleared first
2284 </dd>
2285 <dt><i>forProject</i> (bool)</dt>
2286 <dd>
2287 flag indicating a project related action
2288 </dd>
2289 <dt><i>runInConsole</i> (bool)</dt>
2290 <dd>
2291 flag indicating to start the debugger in a
2292 console window
2293 </dd>
2294 <dt><i>clientType</i> (str)</dt>
2295 <dd>
2296 client type to be used
2297 </dd>
2298 <dt><i>configOverride</i> (dict)</dt>
2299 <dd>
2300 dictionary containing the global config override
2301 data
2302 </dd>
2303 </dl>
2304 <a NAME="DebugServer.remoteRawInput" ID="DebugServer.remoteRawInput"></a>
2305 <h4>DebugServer.remoteRawInput</h4>
2306 <b>remoteRawInput</b>(<i>debuggerId, inputString</i>)
2307
2308 <p>
2309 Public method to send the raw input to the debugged program.
2310 </p>
2311 <dl>
2312
2313 <dt><i>debuggerId</i> (str)</dt>
2314 <dd>
2315 ID of the debugger backend
2316 </dd>
2317 <dt><i>inputString</i> (str)</dt>
2318 <dd>
2319 the raw input
2320 </dd>
2321 </dl>
2322 <a NAME="DebugServer.remoteRun" ID="DebugServer.remoteRun"></a>
2323 <h4>DebugServer.remoteRun</h4>
2324 <b>remoteRun</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, forProject=False, runInConsole=False, clientType="", configOverride=None</i>)
2325
2326 <p>
2327 Public method to load a new program to run.
2328 </p>
2329 <dl>
2330
2331 <dt><i>venvName</i> (str)</dt>
2332 <dd>
2333 name of the virtual environment to be used
2334 </dd>
2335 <dt><i>fn</i> (str)</dt>
2336 <dd>
2337 the filename to debug
2338 </dd>
2339 <dt><i>argv</i> (str)</dt>
2340 <dd>
2341 the command line arguments to pass to the program
2342 </dd>
2343 <dt><i>wd</i> (str)</dt>
2344 <dd>
2345 the working directory for the program
2346 </dd>
2347 <dt><i>env</i> (str)</dt>
2348 <dd>
2349 environment parameter settings
2350 </dd>
2351 <dt><i>autoClearShell</i> (bool)</dt>
2352 <dd>
2353 flag indicating, that the interpreter window
2354 should be cleared
2355 </dd>
2356 <dt><i>forProject</i> (bool)</dt>
2357 <dd>
2358 flag indicating a project related action
2359 </dd>
2360 <dt><i>runInConsole</i> (bool)</dt>
2361 <dd>
2362 flag indicating to start the debugger in a
2363 console window
2364 </dd>
2365 <dt><i>clientType</i> (str)</dt>
2366 <dd>
2367 client type to be used
2368 </dd>
2369 <dt><i>configOverride</i> (dict)</dt>
2370 <dd>
2371 dictionary containing the global config override
2372 data
2373 </dd>
2374 </dl>
2375 <a NAME="DebugServer.remoteSetThread" ID="DebugServer.remoteSetThread"></a>
2376 <h4>DebugServer.remoteSetThread</h4>
2377 <b>remoteSetThread</b>(<i>debuggerId, tid</i>)
2378
2379 <p>
2380 Public method to request to set the given thread as current thread.
2381 </p>
2382 <dl>
2383
2384 <dt><i>debuggerId</i> (str)</dt>
2385 <dd>
2386 ID of the debugger backend
2387 </dd>
2388 <dt><i>tid</i> (int)</dt>
2389 <dd>
2390 id of the thread
2391 </dd>
2392 </dl>
2393 <a NAME="DebugServer.remoteStatement" ID="DebugServer.remoteStatement"></a>
2394 <h4>DebugServer.remoteStatement</h4>
2395 <b>remoteStatement</b>(<i>debuggerId, stmt</i>)
2396
2397 <p>
2398 Public method to execute a Python statement.
2399 </p>
2400 <dl>
2401
2402 <dt><i>debuggerId</i> (str)</dt>
2403 <dd>
2404 ID of the debugger backend
2405 </dd>
2406 <dt><i>stmt</i> (str)</dt>
2407 <dd>
2408 the Python statement to execute.
2409 </dd>
2410 </dl>
2411 <a NAME="DebugServer.remoteStep" ID="DebugServer.remoteStep"></a>
2412 <h4>DebugServer.remoteStep</h4>
2413 <b>remoteStep</b>(<i>debuggerId</i>)
2414
2415 <p>
2416 Public method to single step the debugged program.
2417 </p>
2418 <dl>
2419
2420 <dt><i>debuggerId</i> (str)</dt>
2421 <dd>
2422 ID of the debugger backend
2423 </dd>
2424 </dl>
2425 <a NAME="DebugServer.remoteStepOut" ID="DebugServer.remoteStepOut"></a>
2426 <h4>DebugServer.remoteStepOut</h4>
2427 <b>remoteStepOut</b>(<i>debuggerId</i>)
2428
2429 <p>
2430 Public method to step out the debugged program.
2431 </p>
2432 <dl>
2433
2434 <dt><i>debuggerId</i> (str)</dt>
2435 <dd>
2436 ID of the debugger backend
2437 </dd>
2438 </dl>
2439 <a NAME="DebugServer.remoteStepOver" ID="DebugServer.remoteStepOver"></a>
2440 <h4>DebugServer.remoteStepOver</h4>
2441 <b>remoteStepOver</b>(<i>debuggerId</i>)
2442
2443 <p>
2444 Public method to step over the debugged program.
2445 </p>
2446 <dl>
2447
2448 <dt><i>debuggerId</i> (str)</dt>
2449 <dd>
2450 ID of the debugger backend
2451 </dd>
2452 </dl>
2453 <a NAME="DebugServer.remoteStepQuit" ID="DebugServer.remoteStepQuit"></a>
2454 <h4>DebugServer.remoteStepQuit</h4>
2455 <b>remoteStepQuit</b>(<i>debuggerId</i>)
2456
2457 <p>
2458 Public method to stop the debugged program.
2459 </p>
2460 <dl>
2461
2462 <dt><i>debuggerId</i> (str)</dt>
2463 <dd>
2464 ID of the debugger backend
2465 </dd>
2466 </dl>
2467 <a NAME="DebugServer.remoteThreadList" ID="DebugServer.remoteThreadList"></a>
2468 <h4>DebugServer.remoteThreadList</h4>
2469 <b>remoteThreadList</b>(<i>debuggerId</i>)
2470
2471 <p>
2472 Public method to request the list of threads from the client.
2473 </p>
2474 <dl>
2475
2476 <dt><i>debuggerId</i> (str)</dt>
2477 <dd>
2478 ID of the debugger backend
2479 </dd>
2480 </dl>
2481 <a NAME="DebugServer.remoteUTDiscover" ID="DebugServer.remoteUTDiscover"></a>
2482 <h4>DebugServer.remoteUTDiscover</h4>
2483 <b>remoteUTDiscover</b>(<i>clientType, forProject, venvName, syspath, workdir, discoveryStart</i>)
2484
2485 <p>
2486 Public method to perform a test case discovery.
2487 </p>
2488 <dl>
2489
2490 <dt><i>clientType</i> (str)</dt>
2491 <dd>
2492 client type to be used
2493 </dd>
2494 <dt><i>forProject</i> (bool)</dt>
2495 <dd>
2496 flag indicating a project related action
2497 </dd>
2498 <dt><i>venvName</i> (str)</dt>
2499 <dd>
2500 name of a virtual environment
2501 </dd>
2502 <dt><i>syspath</i> (list of str)</dt>
2503 <dd>
2504 list of directories to be added to sys.path on the
2505 remote side
2506 </dd>
2507 <dt><i>workdir</i> (str)</dt>
2508 <dd>
2509 path name of the working directory
2510 </dd>
2511 <dt><i>discoveryStart</i> (str)</dt>
2512 <dd>
2513 directory to start auto-discovery at
2514 </dd>
2515 </dl>
2516 <a NAME="DebugServer.remoteUTPrepare" ID="DebugServer.remoteUTPrepare"></a>
2517 <h4>DebugServer.remoteUTPrepare</h4>
2518 <b>remoteUTPrepare</b>(<i>fn, tn, tfn, failed, cov, covname, coverase, clientType="", forProject=False, venvName="", syspath=None, workdir="", discover=False, discoveryStart="", testCases=None, debug=False</i>)
2519
2520 <p>
2521 Public method to prepare a new unittest run.
2522 </p>
2523 <dl>
2524
2525 <dt><i>fn</i> (str)</dt>
2526 <dd>
2527 the filename to load
2528 </dd>
2529 <dt><i>tn</i> (str)</dt>
2530 <dd>
2531 the testname to load
2532 </dd>
2533 <dt><i>tfn</i> (str)</dt>
2534 <dd>
2535 the test function name to load tests from
2536 </dd>
2537 <dt><i>failed</i> (list of str)</dt>
2538 <dd>
2539 list of failed test, if only failed test should be run
2540 </dd>
2541 <dt><i>cov</i> (bool)</dt>
2542 <dd>
2543 flag indicating collection of coverage data is requested
2544 </dd>
2545 <dt><i>covname</i> (str)</dt>
2546 <dd>
2547 filename to be used to assemble the coverage caches
2548 filename
2549 </dd>
2550 <dt><i>coverase</i> (bool)</dt>
2551 <dd>
2552 flag indicating erasure of coverage data is requested
2553 </dd>
2554 <dt><i>clientType</i> (str)</dt>
2555 <dd>
2556 client type to be used
2557 </dd>
2558 <dt><i>forProject</i> (bool)</dt>
2559 <dd>
2560 flag indicating a project related action
2561 </dd>
2562 <dt><i>venvName</i> (str)</dt>
2563 <dd>
2564 name of a virtual environment
2565 </dd>
2566 <dt><i>syspath</i> (list of str)</dt>
2567 <dd>
2568 list of directories to be added to sys.path on the
2569 remote side
2570 </dd>
2571 <dt><i>workdir</i> (str)</dt>
2572 <dd>
2573 path name of the working directory
2574 </dd>
2575 <dt><i>discover</i> (bool)</dt>
2576 <dd>
2577 flag indicating to discover the tests automatically
2578 </dd>
2579 <dt><i>discoveryStart</i> (str)</dt>
2580 <dd>
2581 directory to start auto-discovery at
2582 </dd>
2583 <dt><i>testCases</i> (list of str)</dt>
2584 <dd>
2585 list of test cases to be loaded
2586 </dd>
2587 <dt><i>debug</i> (bool)</dt>
2588 <dd>
2589 flag indicating to run unittest with debugging
2590 </dd>
2591 </dl>
2592 <a NAME="DebugServer.remoteUTRun" ID="DebugServer.remoteUTRun"></a>
2593 <h4>DebugServer.remoteUTRun</h4>
2594 <b>remoteUTRun</b>(<i>debug=False, failfast=False</i>)
2595
2596 <p>
2597 Public method to start a unittest run.
2598 </p>
2599 <dl>
2600
2601 <dt><i>debug</i> (bool)</dt>
2602 <dd>
2603 flag indicating to run unittest with debugging
2604 </dd>
2605 <dt><i>failfast</i> (bool)</dt>
2606 <dd>
2607 flag indicating to stop at the first error
2608 </dd>
2609 </dl>
2610 <a NAME="DebugServer.remoteUTStop" ID="DebugServer.remoteUTStop"></a>
2611 <h4>DebugServer.remoteUTStop</h4>
2612 <b>remoteUTStop</b>(<i></i>)
2613
2614 <p>
2615 public method to stop a unittest run.
2616 </p>
2617 <a NAME="DebugServer.setCallTraceEnabled" ID="DebugServer.setCallTraceEnabled"></a>
2618 <h4>DebugServer.setCallTraceEnabled</h4>
2619 <b>setCallTraceEnabled</b>(<i>debuggerId, on</i>)
2620
2621 <p>
2622 Public method to set the call trace state.
2623 </p>
2624 <dl>
2625
2626 <dt><i>debuggerId</i> (str)</dt>
2627 <dd>
2628 ID of the debugger backend
2629 </dd>
2630 <dt><i>on</i> (bool)</dt>
2631 <dd>
2632 flag indicating to enable the call trace function
2633 </dd>
2634 </dl>
2635 <a NAME="DebugServer.setDebugging" ID="DebugServer.setDebugging"></a>
2636 <h4>DebugServer.setDebugging</h4>
2637 <b>setDebugging</b>(<i>on</i>)
2638
2639 <p>
2640 Public method to set the debugging state.
2641 </p>
2642 <dl>
2643
2644 <dt><i>on</i> (bool)</dt>
2645 <dd>
2646 flag indicating the new debugging state
2647 </dd>
2648 </dl>
2649 <a NAME="DebugServer.shutdownServer" ID="DebugServer.shutdownServer"></a>
2650 <h4>DebugServer.shutdownServer</h4>
2651 <b>shutdownServer</b>(<i></i>)
2652
2653 <p>
2654 Public method to cleanly shut down.
2655 </p>
2656 <p>
2657 It closes our socket and shuts down
2658 the debug client. (Needed on Win OS)
2659 </p>
2660 <a NAME="DebugServer.signalClientBanner" ID="DebugServer.signalClientBanner"></a>
2661 <h4>DebugServer.signalClientBanner</h4>
2662 <b>signalClientBanner</b>(<i>version, platform, venvName</i>)
2663
2664 <p>
2665 Public method to process the client banner info.
2666 </p>
2667 <dl>
2668
2669 <dt><i>version</i> (str)</dt>
2670 <dd>
2671 interpreter version info
2672 </dd>
2673 <dt><i>platform</i> (str)</dt>
2674 <dd>
2675 hostname of the client
2676 </dd>
2677 <dt><i>venvName</i> (str)</dt>
2678 <dd>
2679 name of the virtual environment
2680 </dd>
2681 </dl>
2682 <a NAME="DebugServer.signalClientBreakConditionError" ID="DebugServer.signalClientBreakConditionError"></a>
2683 <h4>DebugServer.signalClientBreakConditionError</h4>
2684 <b>signalClientBreakConditionError</b>(<i>filename, lineno, debuggerId</i>)
2685
2686 <p>
2687 Public method to process the client breakpoint condition error info.
2688 </p>
2689 <dl>
2690
2691 <dt><i>filename</i> (str)</dt>
2692 <dd>
2693 filename of the breakpoint
2694 </dd>
2695 <dt><i>lineno</i> (int)</dt>
2696 <dd>
2697 line umber of the breakpoint
2698 </dd>
2699 <dt><i>debuggerId</i> (str)</dt>
2700 <dd>
2701 ID of the debugger backend
2702 </dd>
2703 </dl>
2704 <a NAME="DebugServer.signalClientCallTrace" ID="DebugServer.signalClientCallTrace"></a>
2705 <h4>DebugServer.signalClientCallTrace</h4>
2706 <b>signalClientCallTrace</b>(<i>isCall, fromFile, fromLine, fromFunction, toFile, toLine, toFunction, debuggerId</i>)
2707
2708 <p>
2709 Public method to process the client call trace data.
2710 </p>
2711 <dl>
2712
2713 <dt><i>isCall</i> (bool)</dt>
2714 <dd>
2715 flag indicating a 'call'
2716 </dd>
2717 <dt><i>fromFile</i> (str)</dt>
2718 <dd>
2719 name of the originating file
2720 </dd>
2721 <dt><i>fromLine</i> (str)</dt>
2722 <dd>
2723 line number in the originating file
2724 </dd>
2725 <dt><i>fromFunction</i> (str)</dt>
2726 <dd>
2727 name of the originating function
2728 </dd>
2729 <dt><i>toFile</i> (str)</dt>
2730 <dd>
2731 name of the target file
2732 </dd>
2733 <dt><i>toLine</i> (str)</dt>
2734 <dd>
2735 line number in the target file
2736 </dd>
2737 <dt><i>toFunction</i> (str)</dt>
2738 <dd>
2739 name of the target function
2740 </dd>
2741 <dt><i>debuggerId</i> (str)</dt>
2742 <dd>
2743 ID of the debugger backend
2744 </dd>
2745 </dl>
2746 <a NAME="DebugServer.signalClientCapabilities" ID="DebugServer.signalClientCapabilities"></a>
2747 <h4>DebugServer.signalClientCapabilities</h4>
2748 <b>signalClientCapabilities</b>(<i>capabilities, clientType, venvName</i>)
2749
2750 <p>
2751 Public method to process the client capabilities info.
2752 </p>
2753 <dl>
2754
2755 <dt><i>capabilities</i> (int)</dt>
2756 <dd>
2757 bitmaks with the client capabilities
2758 </dd>
2759 <dt><i>clientType</i> (str)</dt>
2760 <dd>
2761 type of the debug client
2762 </dd>
2763 <dt><i>venvName</i> (str)</dt>
2764 <dd>
2765 name of the virtual environment
2766 </dd>
2767 </dl>
2768 <a NAME="DebugServer.signalClientClearBreak" ID="DebugServer.signalClientClearBreak"></a>
2769 <h4>DebugServer.signalClientClearBreak</h4>
2770 <b>signalClientClearBreak</b>(<i>filename, lineno, debuggerId</i>)
2771
2772 <p>
2773 Public method to process the client clear breakpoint command.
2774 </p>
2775 <dl>
2776
2777 <dt><i>filename</i> (str)</dt>
2778 <dd>
2779 filename of the breakpoint
2780 </dd>
2781 <dt><i>lineno</i> (int)</dt>
2782 <dd>
2783 line umber of the breakpoint
2784 </dd>
2785 <dt><i>debuggerId</i> (str)</dt>
2786 <dd>
2787 ID of the debugger backend
2788 </dd>
2789 </dl>
2790 <a NAME="DebugServer.signalClientClearWatch" ID="DebugServer.signalClientClearWatch"></a>
2791 <h4>DebugServer.signalClientClearWatch</h4>
2792 <b>signalClientClearWatch</b>(<i>condition, debuggerId</i>)
2793
2794 <p>
2795 Public slot to handle the clientClearWatch signal.
2796 </p>
2797 <dl>
2798
2799 <dt><i>condition</i> (str)</dt>
2800 <dd>
2801 expression of watch expression to clear
2802 </dd>
2803 <dt><i>debuggerId</i> (str)</dt>
2804 <dd>
2805 ID of the debugger backend
2806 </dd>
2807 </dl>
2808 <a NAME="DebugServer.signalClientCompletionList" ID="DebugServer.signalClientCompletionList"></a>
2809 <h4>DebugServer.signalClientCompletionList</h4>
2810 <b>signalClientCompletionList</b>(<i>completionList, text, debuggerId</i>)
2811
2812 <p>
2813 Public method to process the client auto completion info.
2814 </p>
2815 <dl>
2816
2817 <dt><i>completionList</i> (list of str)</dt>
2818 <dd>
2819 list of possible completions
2820 </dd>
2821 <dt><i>text</i> (str)</dt>
2822 <dd>
2823 the text to be completed
2824 </dd>
2825 <dt><i>debuggerId</i> (str)</dt>
2826 <dd>
2827 ID of the debugger backend
2828 </dd>
2829 </dl>
2830 <a NAME="DebugServer.signalClientDebuggerId" ID="DebugServer.signalClientDebuggerId"></a>
2831 <h4>DebugServer.signalClientDebuggerId</h4>
2832 <b>signalClientDebuggerId</b>(<i>debuggerId</i>)
2833
2834 <p>
2835 Public method to signal the receipt of a new debugger ID.
2836 </p>
2837 <p>
2838 This signal indicates, that a new debugger backend has connected.
2839 </p>
2840 <dl>
2841
2842 <dt><i>debuggerId</i> (str)</dt>
2843 <dd>
2844 ID of the newly connected debugger backend
2845 </dd>
2846 </dl>
2847 <a NAME="DebugServer.signalClientDisassembly" ID="DebugServer.signalClientDisassembly"></a>
2848 <h4>DebugServer.signalClientDisassembly</h4>
2849 <b>signalClientDisassembly</b>(<i>disassembly, debuggerId</i>)
2850
2851 <p>
2852 Public method to process the disassembly info from the client.
2853 </p>
2854 <dl>
2855
2856 <dt><i>disassembly</i> (dict)</dt>
2857 <dd>
2858 dictionary containing the disassembly information
2859 </dd>
2860 <dt><i>debuggerId</i> (str)</dt>
2861 <dd>
2862 ID of the debugger backend
2863 </dd>
2864 </dl>
2865 <a NAME="DebugServer.signalClientDisconnected" ID="DebugServer.signalClientDisconnected"></a>
2866 <h4>DebugServer.signalClientDisconnected</h4>
2867 <b>signalClientDisconnected</b>(<i>debuggerId</i>)
2868
2869 <p>
2870 Public method to send a signal when a debug client has closed its
2871 connection.
2872 </p>
2873 <dl>
2874
2875 <dt><i>debuggerId</i> (str)</dt>
2876 <dd>
2877 ID of the debugger backend
2878 </dd>
2879 </dl>
2880 <a NAME="DebugServer.signalClientException" ID="DebugServer.signalClientException"></a>
2881 <h4>DebugServer.signalClientException</h4>
2882 <b>signalClientException</b>(<i>exceptionType, exceptionMessage, stackTrace, debuggerId, threadName=""</i>)
2883
2884 <p>
2885 Public method to process the exception info from the client.
2886 </p>
2887 <dl>
2888
2889 <dt><i>exceptionType</i> (str)</dt>
2890 <dd>
2891 type of exception raised
2892 </dd>
2893 <dt><i>exceptionMessage</i> (str)</dt>
2894 <dd>
2895 message given by the exception
2896 </dd>
2897 <dt><i>stackTrace</i> (list)</dt>
2898 <dd>
2899 list of stack entries with the exception position
2900 first. Each stack entry is a list giving the filename and the
2901 linenumber.
2902 </dd>
2903 <dt><i>debuggerId</i> (str)</dt>
2904 <dd>
2905 ID of the debugger backend
2906 </dd>
2907 <dt><i>threadName</i> (str)</dt>
2908 <dd>
2909 name of the thread signaling the event
2910 </dd>
2911 </dl>
2912 <a NAME="DebugServer.signalClientExit" ID="DebugServer.signalClientExit"></a>
2913 <h4>DebugServer.signalClientExit</h4>
2914 <b>signalClientExit</b>(<i>program, status, message, debuggerId</i>)
2915
2916 <p>
2917 Public method to process the client exit status.
2918 </p>
2919 <dl>
2920
2921 <dt><i>program</i> (str)</dt>
2922 <dd>
2923 name of the exited program
2924 </dd>
2925 <dt><i>status</i> (int)</dt>
2926 <dd>
2927 exit code
2928 </dd>
2929 <dt><i>message</i> (str)</dt>
2930 <dd>
2931 message sent with the exit
2932 </dd>
2933 <dt><i>debuggerId</i> (str)</dt>
2934 <dd>
2935 ID of the debugger backend
2936 </dd>
2937 </dl>
2938 <a NAME="DebugServer.signalClientLine" ID="DebugServer.signalClientLine"></a>
2939 <h4>DebugServer.signalClientLine</h4>
2940 <b>signalClientLine</b>(<i>filename, lineno, debuggerId, forStack=False, threadName=""</i>)
2941
2942 <p>
2943 Public method to process client position feedback.
2944 </p>
2945 <dl>
2946
2947 <dt><i>filename</i> (str)</dt>
2948 <dd>
2949 name of the file currently being executed
2950 </dd>
2951 <dt><i>lineno</i> (int)</dt>
2952 <dd>
2953 line of code currently being executed
2954 </dd>
2955 <dt><i>debuggerId</i> (str)</dt>
2956 <dd>
2957 ID of the debugger backend
2958 </dd>
2959 <dt><i>forStack</i> (bool)</dt>
2960 <dd>
2961 flag indicating this is for a stack dump
2962 </dd>
2963 <dt><i>threadName</i> (str)</dt>
2964 <dd>
2965 name of the thread signaling the event
2966 </dd>
2967 </dl>
2968 <a NAME="DebugServer.signalClientOutput" ID="DebugServer.signalClientOutput"></a>
2969 <h4>DebugServer.signalClientOutput</h4>
2970 <b>signalClientOutput</b>(<i>line, debuggerId</i>)
2971
2972 <p>
2973 Public method to process a line of client output.
2974 </p>
2975 <dl>
2976
2977 <dt><i>line</i> (str)</dt>
2978 <dd>
2979 client output
2980 </dd>
2981 <dt><i>debuggerId</i> (str)</dt>
2982 <dd>
2983 ID of the debugger backend
2984 </dd>
2985 </dl>
2986 <a NAME="DebugServer.signalClientRawInput" ID="DebugServer.signalClientRawInput"></a>
2987 <h4>DebugServer.signalClientRawInput</h4>
2988 <b>signalClientRawInput</b>(<i>prompt, echo, debuggerId</i>)
2989
2990 <p>
2991 Public method to process the client raw input command.
2992 </p>
2993 <dl>
2994
2995 <dt><i>prompt</i> (str)</dt>
2996 <dd>
2997 the input prompt
2998 </dd>
2999 <dt><i>echo</i> (bool)</dt>
3000 <dd>
3001 flag indicating an echoing of the input
3002 </dd>
3003 <dt><i>debuggerId</i> (str)</dt>
3004 <dd>
3005 ID of the debugger backend
3006 </dd>
3007 </dl>
3008 <a NAME="DebugServer.signalClientSignal" ID="DebugServer.signalClientSignal"></a>
3009 <h4>DebugServer.signalClientSignal</h4>
3010 <b>signalClientSignal</b>(<i>message, filename, lineNo, funcName, funcArgs, debuggerId</i>)
3011
3012 <p>
3013 Public method to process a signal generated on the client side.
3014 </p>
3015 <dl>
3016
3017 <dt><i>message</i> (str)</dt>
3018 <dd>
3019 message of the syntax error
3020 </dd>
3021 <dt><i>filename</i> (str)</dt>
3022 <dd>
3023 translated filename of the syntax error position
3024 </dd>
3025 <dt><i>lineNo</i> (int)</dt>
3026 <dd>
3027 line number of the syntax error position
3028 </dd>
3029 <dt><i>funcName</i> (str)</dt>
3030 <dd>
3031 name of the function causing the signal
3032 </dd>
3033 <dt><i>funcArgs</i> (str)</dt>
3034 <dd>
3035 function arguments
3036 </dd>
3037 <dt><i>debuggerId</i> (str)</dt>
3038 <dd>
3039 ID of the debugger backend
3040 </dd>
3041 </dl>
3042 <a NAME="DebugServer.signalClientStack" ID="DebugServer.signalClientStack"></a>
3043 <h4>DebugServer.signalClientStack</h4>
3044 <b>signalClientStack</b>(<i>stack, debuggerId, threadName=""</i>)
3045
3046 <p>
3047 Public method to process a client's stack information.
3048 </p>
3049 <dl>
3050
3051 <dt><i>stack</i> (list of lists of (string, integer, string))</dt>
3052 <dd>
3053 list of stack entries. Each entry is a tuple of three
3054 values giving the filename, linenumber and method
3055 </dd>
3056 <dt><i>debuggerId</i> (str)</dt>
3057 <dd>
3058 ID of the debugger backend
3059 </dd>
3060 <dt><i>threadName</i> (str)</dt>
3061 <dd>
3062 name of the thread signaling the event
3063 </dd>
3064 </dl>
3065 <a NAME="DebugServer.signalClientStatement" ID="DebugServer.signalClientStatement"></a>
3066 <h4>DebugServer.signalClientStatement</h4>
3067 <b>signalClientStatement</b>(<i>more, debuggerId</i>)
3068
3069 <p>
3070 Public method to process the input response from the client.
3071 </p>
3072 <dl>
3073
3074 <dt><i>more</i> (bool)</dt>
3075 <dd>
3076 flag indicating that more user input is required
3077 </dd>
3078 <dt><i>debuggerId</i> (str)</dt>
3079 <dd>
3080 ID of the debugger backend
3081 </dd>
3082 </dl>
3083 <a NAME="DebugServer.signalClientSyntaxError" ID="DebugServer.signalClientSyntaxError"></a>
3084 <h4>DebugServer.signalClientSyntaxError</h4>
3085 <b>signalClientSyntaxError</b>(<i>message, filename, lineNo, characterNo, debuggerId, threadName=""</i>)
3086
3087 <p>
3088 Public method to process a syntax error info from the client.
3089 </p>
3090 <dl>
3091
3092 <dt><i>message</i> (str)</dt>
3093 <dd>
3094 message of the syntax error
3095 </dd>
3096 <dt><i>filename</i> (str)</dt>
3097 <dd>
3098 translated filename of the syntax error position
3099 </dd>
3100 <dt><i>lineNo</i> (int)</dt>
3101 <dd>
3102 line number of the syntax error position
3103 </dd>
3104 <dt><i>characterNo</i> (int)</dt>
3105 <dd>
3106 character number of the syntax error position
3107 </dd>
3108 <dt><i>debuggerId</i> (str)</dt>
3109 <dd>
3110 ID of the debugger backend
3111 </dd>
3112 <dt><i>threadName</i> (str)</dt>
3113 <dd>
3114 name of the thread signaling the event
3115 </dd>
3116 </dl>
3117 <a NAME="DebugServer.signalClientThreadList" ID="DebugServer.signalClientThreadList"></a>
3118 <h4>DebugServer.signalClientThreadList</h4>
3119 <b>signalClientThreadList</b>(<i>currentId, threadList, debuggerId</i>)
3120
3121 <p>
3122 Public method to process the client thread list info.
3123 </p>
3124 <dl>
3125
3126 <dt><i>currentId</i> (int)</dt>
3127 <dd>
3128 id of the current thread
3129 </dd>
3130 <dt><i>threadList</i> (list of dict)</dt>
3131 <dd>
3132 list of dictionaries containing the thread data
3133 </dd>
3134 <dt><i>debuggerId</i> (str)</dt>
3135 <dd>
3136 ID of the debugger backend
3137 </dd>
3138 </dl>
3139 <a NAME="DebugServer.signalClientThreadSet" ID="DebugServer.signalClientThreadSet"></a>
3140 <h4>DebugServer.signalClientThreadSet</h4>
3141 <b>signalClientThreadSet</b>(<i>debuggerId</i>)
3142
3143 <p>
3144 Public method to handle the change of the client thread.
3145 </p>
3146 <dl>
3147
3148 <dt><i>debuggerId</i> (str)</dt>
3149 <dd>
3150 ID of the debugger backend
3151 </dd>
3152 </dl>
3153 <a NAME="DebugServer.signalClientVariable" ID="DebugServer.signalClientVariable"></a>
3154 <h4>DebugServer.signalClientVariable</h4>
3155 <b>signalClientVariable</b>(<i>scope, variables, debuggerId</i>)
3156
3157 <p>
3158 Public method to process the client variable info.
3159 </p>
3160 <dl>
3161
3162 <dt><i>scope</i> (int)</dt>
3163 <dd>
3164 scope of the variables (-1 = empty global, 1 = global,
3165 0 = local)
3166 </dd>
3167 <dt><i>variables</i> (list)</dt>
3168 <dd>
3169 the list of members of a classvariable from the client
3170 </dd>
3171 <dt><i>debuggerId</i> (str)</dt>
3172 <dd>
3173 ID of the debugger backend
3174 </dd>
3175 </dl>
3176 <a NAME="DebugServer.signalClientVariables" ID="DebugServer.signalClientVariables"></a>
3177 <h4>DebugServer.signalClientVariables</h4>
3178 <b>signalClientVariables</b>(<i>scope, variables, debuggerId</i>)
3179
3180 <p>
3181 Public method to process the client variables info.
3182 </p>
3183 <dl>
3184
3185 <dt><i>scope</i> (int)</dt>
3186 <dd>
3187 scope of the variables
3188 (-2 = no frame found, -1 = empty locals, 1 = global, 0 = local)
3189 </dd>
3190 <dt><i>variables</i> (list)</dt>
3191 <dd>
3192 the list of variables from the client
3193 </dd>
3194 <dt><i>debuggerId</i> (str)</dt>
3195 <dd>
3196 ID of the debugger backend
3197 </dd>
3198 </dl>
3199 <a NAME="DebugServer.signalClientWatchConditionError" ID="DebugServer.signalClientWatchConditionError"></a>
3200 <h4>DebugServer.signalClientWatchConditionError</h4>
3201 <b>signalClientWatchConditionError</b>(<i>condition, debuggerId</i>)
3202
3203 <p>
3204 Public method to process the client watch expression error info.
3205 </p>
3206 <dl>
3207
3208 <dt><i>condition</i> (str)</dt>
3209 <dd>
3210 expression of watch expression to clear
3211 </dd>
3212 <dt><i>debuggerId</i> (str)</dt>
3213 <dd>
3214 ID of the debugger backend
3215 </dd>
3216 </dl>
3217 <a NAME="DebugServer.signalLastClientExited" ID="DebugServer.signalLastClientExited"></a>
3218 <h4>DebugServer.signalLastClientExited</h4>
3219 <b>signalLastClientExited</b>(<i></i>)
3220
3221 <p>
3222 Public method to process the last client exit event.
3223 </p>
3224 <a NAME="DebugServer.signalMainClientExit" ID="DebugServer.signalMainClientExit"></a>
3225 <h4>DebugServer.signalMainClientExit</h4>
3226 <b>signalMainClientExit</b>(<i></i>)
3227
3228 <p>
3229 Public method to process the main client exiting.
3230 </p>
3231 <a NAME="DebugServer.startClient" ID="DebugServer.startClient"></a>
3232 <h4>DebugServer.startClient</h4>
3233 <b>startClient</b>(<i>unplanned=True, clType=None, forProject=False, runInConsole=False, venvName="", workingDir=None, configOverride=None</i>)
3234
3235 <p>
3236 Public method to start a debug client.
3237 </p>
3238 <dl>
3239
3240 <dt><i>unplanned</i> (bool)</dt>
3241 <dd>
3242 flag indicating that the client has died
3243 </dd>
3244 <dt><i>clType</i> (str)</dt>
3245 <dd>
3246 type of client to be started
3247 </dd>
3248 <dt><i>forProject</i> (bool)</dt>
3249 <dd>
3250 flag indicating a project related action
3251 </dd>
3252 <dt><i>runInConsole</i> (bool)</dt>
3253 <dd>
3254 flag indicating to start the debugger in a
3255 console window
3256 </dd>
3257 <dt><i>venvName</i> (str)</dt>
3258 <dd>
3259 name of the virtual environment to be used
3260 </dd>
3261 <dt><i>workingDir</i> (str)</dt>
3262 <dd>
3263 directory to start the debugger client in
3264 </dd>
3265 <dt><i>configOverride</i> (dict)</dt>
3266 <dd>
3267 dictionary containing the global config override
3268 data
3269 </dd>
3270 </dl>
3271 <a NAME="DebugServer.unregisterDebuggerInterface" ID="DebugServer.unregisterDebuggerInterface"></a>
3272 <h4>DebugServer.unregisterDebuggerInterface</h4>
3273 <b>unregisterDebuggerInterface</b>(<i>interfaceName</i>)
3274
3275 <p>
3276 Public method to unregister a debugger interface.
3277 </p>
3278 <dl>
3279
3280 <dt><i>interfaceName</i> (str)</dt>
3281 <dd>
3282 interfaceName of the debugger interface
3283 </dd>
3284 </dl>
3285 <div align="right"><a href="#top">Up</a></div>
3286 <hr />
3287 </body></html>

eric ide

mercurial