271 <td>Public method to close the session with the debugger and optionally terminate.</td> |
271 <td>Public method to close the session with the debugger and optionally terminate.</td> |
272 </tr> |
272 </tr> |
273 <tr> |
273 <tr> |
274 <td><a href="#DebugClientBase.setDisassembly">setDisassembly</a></td> |
274 <td><a href="#DebugClientBase.setDisassembly">setDisassembly</a></td> |
275 <td>Public method to store a disassembly of the code object raising an exception.</td> |
275 <td>Public method to store a disassembly of the code object raising an exception.</td> |
|
276 </tr> |
|
277 <tr> |
|
278 <td><a href="#DebugClientBase.skipMultiProcessDebugging">skipMultiProcessDebugging</a></td> |
|
279 <td>Public method to check, if the given script is eligible for debugging.</td> |
276 </tr> |
280 </tr> |
277 <tr> |
281 <tr> |
278 <td><a href="#DebugClientBase.startDebugger">startDebugger</a></td> |
282 <td><a href="#DebugClientBase.startDebugger">startDebugger</a></td> |
279 <td>Public method used to start the remote debugger.</td> |
283 <td>Public method used to start the remote debugger.</td> |
280 </tr> |
284 </tr> |
338 |
342 |
339 <p> |
343 <p> |
340 Private method to determine the clients capabilities. |
344 Private method to determine the clients capabilities. |
341 </p> |
345 </p> |
342 <dl> |
346 <dl> |
343 <dt>Returns:</dt> |
347 <dt>Return:</dt> |
344 <dd> |
348 <dd> |
345 client capabilities (integer) |
349 client capabilities (integer) |
|
350 </dd> |
|
351 </dl> |
|
352 <a NAME="DebugClientBase.__compileCommand" ID="DebugClientBase.__compileCommand"></a> |
|
353 <h4>DebugClientBase.__compileCommand</h4> |
|
354 <b>__compileCommand</b>(<i>statement, filename="<string>", mode="exec"</i>) |
|
355 |
|
356 <p> |
|
357 Private method to compile source code. |
|
358 </p> |
|
359 <dl> |
|
360 |
|
361 <dt><i>statement</i> (str)</dt> |
|
362 <dd> |
|
363 source code string to be compiled |
|
364 </dd> |
|
365 <dt><i>filename</i> (str)</dt> |
|
366 <dd> |
|
367 name of the source file |
|
368 </dd> |
|
369 <dt><i>mode</i> (str)</dt> |
|
370 <dd> |
|
371 kind of code to be generated (exec or eval) |
|
372 </dd> |
|
373 </dl> |
|
374 <dl> |
|
375 <dt>Return:</dt> |
|
376 <dd> |
|
377 compiled code object (None in case of errors) |
346 </dd> |
378 </dd> |
347 </dl> |
379 </dl> |
348 <a NAME="DebugClientBase.__compileFileSource" ID="DebugClientBase.__compileFileSource"></a> |
380 <a NAME="DebugClientBase.__compileFileSource" ID="DebugClientBase.__compileFileSource"></a> |
349 <h4>DebugClientBase.__compileFileSource</h4> |
381 <h4>DebugClientBase.__compileFileSource</h4> |
350 <b>__compileFileSource</b>(<i>filename, mode='exec'</i>) |
382 <b>__compileFileSource</b>(<i>filename, mode='exec'</i>) |
404 <dd> |
436 <dd> |
405 1 to report global variables, 0 for local variables |
437 1 to report global variables, 0 for local variables |
406 </dd> |
438 </dd> |
407 <dt><i>filterList</i> (list of int)</dt> |
439 <dt><i>filterList</i> (list of int)</dt> |
408 <dd> |
440 <dd> |
409 the indices of variable types to be filtered |
441 list of variable types to be filtered |
410 </dd> |
442 </dd> |
411 </dl> |
443 </dl> |
412 <a NAME="DebugClientBase.__dumpVariables" ID="DebugClientBase.__dumpVariables"></a> |
444 <a NAME="DebugClientBase.__dumpVariables" ID="DebugClientBase.__dumpVariables"></a> |
413 <h4>DebugClientBase.__dumpVariables</h4> |
445 <h4>DebugClientBase.__dumpVariables</h4> |
414 <b>__dumpVariables</b>(<i>frmnr, scope, filterList</i>) |
446 <b>__dumpVariables</b>(<i>frmnr, scope, filterList</i>) |
424 </dd> |
456 </dd> |
425 <dt><i>scope</i> (int)</dt> |
457 <dt><i>scope</i> (int)</dt> |
426 <dd> |
458 <dd> |
427 1 to report global variables, 0 for local variables |
459 1 to report global variables, 0 for local variables |
428 </dd> |
460 </dd> |
429 <dt><i>filterList</i> (list of int)</dt> |
461 <dt><i>filterList</i> (list of str)</dt> |
430 <dd> |
462 <dd> |
431 the indices of variable types to be filtered |
463 list of variable types to be filtered |
432 </dd> |
464 </dd> |
433 </dl> |
465 </dl> |
434 <a NAME="DebugClientBase.__extractIndicators" ID="DebugClientBase.__extractIndicators"></a> |
466 <a NAME="DebugClientBase.__extractIndicators" ID="DebugClientBase.__extractIndicators"></a> |
435 <h4>DebugClientBase.__extractIndicators</h4> |
467 <h4>DebugClientBase.__extractIndicators</h4> |
436 <b>__extractIndicators</b>(<i>var</i>) |
468 <b>__extractIndicators</b>(<i>var</i>) |
509 1 to filter using the globals filter, 0 using the locals |
541 1 to filter using the globals filter, 0 using the locals |
510 filter. |
542 filter. |
511 Variables are only added to the list, if their name do not match |
543 Variables are only added to the list, if their name do not match |
512 any of the filter expressions. |
544 any of the filter expressions. |
513 </dd> |
545 </dd> |
514 <dt><i>filterList</i> (list of int)</dt> |
546 <dt><i>filterList</i> (list of str)</dt> |
515 <dd> |
547 <dd> |
516 the indices of variable types to be filtered. |
548 list of variable types to be filtered. |
517 Variables are only added to the list, if their type is not |
549 Variables are only added to the list, if their type is not |
518 contained in the filter list. |
550 contained in the filter list. |
519 </dd> |
551 </dd> |
520 </dl> |
552 </dl> |
521 <dl> |
553 <dl> |
522 <dt>Returns:</dt> |
554 <dt>Return:</dt> |
523 <dd> |
555 <dd> |
524 A tuple consisting of a list of formatted variables. Each |
556 A tuple consisting of a list of formatted variables. Each |
525 variable entry is a tuple of three elements, the variable name, |
557 variable entry is a tuple of three elements, the variable name, |
526 its type and value. |
558 its type and value. |
527 </dd> |
559 </dd> |
736 stdout and stderr and saves these file objects in case the application |
768 stdout and stderr and saves these file objects in case the application |
737 being debugged redirects them itself. |
769 being debugged redirects them itself. |
738 </p> |
770 </p> |
739 <dl> |
771 <dl> |
740 |
772 |
741 <dt><i>port</i></dt> |
773 <dt><i>port</i> (int)</dt> |
742 <dd> |
774 <dd> |
743 the port number to connect to (int) |
775 the port number to connect to |
744 </dd> |
776 </dd> |
745 <dt><i>remoteAddress</i></dt> |
777 <dt><i>remoteAddress</i> (str)</dt> |
746 <dd> |
778 <dd> |
747 the network address of the debug server host |
779 the network address of the debug server host |
748 (string) |
780 </dd> |
749 </dd> |
781 <dt><i>redirect</i> (bool)</dt> |
750 <dt><i>redirect</i></dt> |
|
751 <dd> |
782 <dd> |
752 flag indicating redirection of stdin, stdout and |
783 flag indicating redirection of stdin, stdout and |
753 stderr (boolean) |
784 stderr |
|
785 </dd> |
|
786 <dt><i>name</i> (str)</dt> |
|
787 <dd> |
|
788 name to be attached to the debugger ID |
754 </dd> |
789 </dd> |
755 </dl> |
790 </dl> |
756 <a NAME="DebugClientBase.eventLoop" ID="DebugClientBase.eventLoop"></a> |
791 <a NAME="DebugClientBase.eventLoop" ID="DebugClientBase.eventLoop"></a> |
757 <h4>DebugClientBase.eventLoop</h4> |
792 <h4>DebugClientBase.eventLoop</h4> |
758 <b>eventLoop</b>(<i>disablePolling=False</i>) |
793 <b>eventLoop</b>(<i>disablePolling=False</i>) |
773 <b>eventPoll</b>(<i></i>) |
808 <b>eventPoll</b>(<i></i>) |
774 |
809 |
775 <p> |
810 <p> |
776 Public method to poll for events like 'set break point'. |
811 Public method to poll for events like 'set break point'. |
777 </p> |
812 </p> |
778 <a NAME="DebugClientBase.fork" ID="DebugClientBase.fork"></a> |
|
779 <h4>DebugClientBase.fork</h4> |
|
780 <b>fork</b>(<i></i>) |
|
781 |
|
782 <p> |
|
783 Public method implementing a fork routine deciding which branch |
|
784 to follow. |
|
785 </p> |
|
786 <dl> |
|
787 <dt>Returns:</dt> |
|
788 <dd> |
|
789 process ID (integer) |
|
790 </dd> |
|
791 </dl> |
|
792 <a NAME="DebugClientBase.getCoding" ID="DebugClientBase.getCoding"></a> |
813 <a NAME="DebugClientBase.getCoding" ID="DebugClientBase.getCoding"></a> |
793 <h4>DebugClientBase.getCoding</h4> |
814 <h4>DebugClientBase.getCoding</h4> |
794 <b>getCoding</b>(<i></i>) |
815 <b>getCoding</b>(<i></i>) |
795 |
816 |
796 <p> |
817 <p> |
797 Public method to return the current coding. |
818 Public method to return the current coding. |
798 </p> |
819 </p> |
799 <dl> |
820 <dl> |
800 <dt>Returns:</dt> |
821 <dt>Return:</dt> |
801 <dd> |
822 <dd> |
802 codec name (string) |
823 codec name (string) |
803 </dd> |
824 </dd> |
804 </dl> |
825 </dl> |
805 <a NAME="DebugClientBase.getRunning" ID="DebugClientBase.getRunning"></a> |
826 <a NAME="DebugClientBase.getRunning" ID="DebugClientBase.getRunning"></a> |
986 <dt><i>condition</i> (str)</dt> |
1011 <dt><i>condition</i> (str)</dt> |
987 <dd> |
1012 <dd> |
988 condition of the watch expression to be cleared |
1013 condition of the watch expression to be cleared |
989 </dd> |
1014 </dd> |
990 </dl> |
1015 </dl> |
|
1016 <a NAME="DebugClientBase.sendDebuggerId" ID="DebugClientBase.sendDebuggerId"></a> |
|
1017 <h4>DebugClientBase.sendDebuggerId</h4> |
|
1018 <b>sendDebuggerId</b>(<i>debuggerId</i>) |
|
1019 |
|
1020 <p> |
|
1021 Public method to send the debug client id. |
|
1022 </p> |
|
1023 <dl> |
|
1024 |
|
1025 <dt><i>debuggerId</i> (str)</dt> |
|
1026 <dd> |
|
1027 id of this debug client instance (made up of |
|
1028 hostname and process ID) |
|
1029 </dd> |
|
1030 </dl> |
991 <a NAME="DebugClientBase.sendException" ID="DebugClientBase.sendException"></a> |
1031 <a NAME="DebugClientBase.sendException" ID="DebugClientBase.sendException"></a> |
992 <h4>DebugClientBase.sendException</h4> |
1032 <h4>DebugClientBase.sendException</h4> |
993 <b>sendException</b>(<i>exceptionType, exceptionMessage, stack</i>) |
1033 <b>sendException</b>(<i>exceptionType, exceptionMessage, stack, threadName</i>) |
994 |
1034 |
995 <p> |
1035 <p> |
996 Public method to send information for an exception. |
1036 Public method to send information for an exception. |
997 </p> |
1037 </p> |
998 <dl> |
1038 <dl> |
1006 message of the exception |
1046 message of the exception |
1007 </dd> |
1047 </dd> |
1008 <dt><i>stack</i> (list)</dt> |
1048 <dt><i>stack</i> (list)</dt> |
1009 <dd> |
1049 <dd> |
1010 stack trace information |
1050 stack trace information |
|
1051 </dd> |
|
1052 <dt><i>threadName</i> (str)</dt> |
|
1053 <dd> |
|
1054 name of the thread sending the event |
1011 </dd> |
1055 </dd> |
1012 </dl> |
1056 </dl> |
1013 <a NAME="DebugClientBase.sendJsonCommand" ID="DebugClientBase.sendJsonCommand"></a> |
1057 <a NAME="DebugClientBase.sendJsonCommand" ID="DebugClientBase.sendJsonCommand"></a> |
1014 <h4>DebugClientBase.sendJsonCommand</h4> |
1058 <h4>DebugClientBase.sendJsonCommand</h4> |
1015 <b>sendJsonCommand</b>(<i>method, params</i>) |
1059 <b>sendJsonCommand</b>(<i>method, params</i>) |
1047 flag to enable exception reporting of the IDE |
1091 flag to enable exception reporting of the IDE |
1048 </dd> |
1092 </dd> |
1049 </dl> |
1093 </dl> |
1050 <a NAME="DebugClientBase.sendResponseLine" ID="DebugClientBase.sendResponseLine"></a> |
1094 <a NAME="DebugClientBase.sendResponseLine" ID="DebugClientBase.sendResponseLine"></a> |
1051 <h4>DebugClientBase.sendResponseLine</h4> |
1095 <h4>DebugClientBase.sendResponseLine</h4> |
1052 <b>sendResponseLine</b>(<i>stack</i>) |
1096 <b>sendResponseLine</b>(<i>stack, threadName</i>) |
1053 |
1097 |
1054 <p> |
1098 <p> |
1055 Public method to send the current call stack. |
1099 Public method to send the current call stack. |
1056 </p> |
1100 </p> |
1057 <dl> |
1101 <dl> |
1058 |
1102 |
1059 <dt><i>stack</i> (list)</dt> |
1103 <dt><i>stack</i> (list)</dt> |
1060 <dd> |
1104 <dd> |
1061 call stack |
1105 call stack |
|
1106 </dd> |
|
1107 <dt><i>threadName</i> (str)</dt> |
|
1108 <dd> |
|
1109 name of the thread sending the event |
1062 </dd> |
1110 </dd> |
1063 </dl> |
1111 </dl> |
1064 <a NAME="DebugClientBase.sendSyntaxError" ID="DebugClientBase.sendSyntaxError"></a> |
1112 <a NAME="DebugClientBase.sendSyntaxError" ID="DebugClientBase.sendSyntaxError"></a> |
1065 <h4>DebugClientBase.sendSyntaxError</h4> |
1113 <h4>DebugClientBase.sendSyntaxError</h4> |
1066 <b>sendSyntaxError</b>(<i>message, filename, lineno, charno</i>) |
1114 <b>sendSyntaxError</b>(<i>message, filename, lineno, charno, threadName</i>) |
1067 |
1115 |
1068 <p> |
1116 <p> |
1069 Public method to send information for a syntax error. |
1117 Public method to send information for a syntax error. |
1070 </p> |
1118 </p> |
1071 <dl> |
1119 <dl> |
1115 <dt><i>disassembly</i> (dict)</dt> |
1167 <dt><i>disassembly</i> (dict)</dt> |
1116 <dd> |
1168 <dd> |
1117 dictionary containing the disassembly information |
1169 dictionary containing the disassembly information |
1118 </dd> |
1170 </dd> |
1119 </dl> |
1171 </dl> |
|
1172 <a NAME="DebugClientBase.skipMultiProcessDebugging" ID="DebugClientBase.skipMultiProcessDebugging"></a> |
|
1173 <h4>DebugClientBase.skipMultiProcessDebugging</h4> |
|
1174 <b>skipMultiProcessDebugging</b>(<i>scriptName</i>) |
|
1175 |
|
1176 <p> |
|
1177 Public method to check, if the given script is eligible for debugging. |
|
1178 </p> |
|
1179 <dl> |
|
1180 |
|
1181 <dt><i>scriptName</i> (str)</dt> |
|
1182 <dd> |
|
1183 name of the script to check |
|
1184 </dd> |
|
1185 </dl> |
|
1186 <dl> |
|
1187 <dt>Return:</dt> |
|
1188 <dd> |
|
1189 flag indicating eligibility |
|
1190 </dd> |
|
1191 </dl> |
|
1192 <dl> |
|
1193 <dt>Return Type:</dt> |
|
1194 <dd> |
|
1195 bool |
|
1196 </dd> |
|
1197 </dl> |
1120 <a NAME="DebugClientBase.startDebugger" ID="DebugClientBase.startDebugger"></a> |
1198 <a NAME="DebugClientBase.startDebugger" ID="DebugClientBase.startDebugger"></a> |
1121 <h4>DebugClientBase.startDebugger</h4> |
1199 <h4>DebugClientBase.startDebugger</h4> |
1122 <b>startDebugger</b>(<i>filename=None, host=None, port=None, enableTrace=True, exceptions=True, tracePython=False, redirect=True</i>) |
1200 <b>startDebugger</b>(<i>filename=None, host=None, port=None, enableTrace=True, exceptions=True, tracePython=False, redirect=True, passive=True, multiprocessSupport=False</i>) |
1123 |
1201 |
1124 <p> |
1202 <p> |
1125 Public method used to start the remote debugger. |
1203 Public method used to start the remote debugger. |
1126 </p> |
1204 </p> |
1127 <dl> |
1205 <dl> |
1128 |
1206 |
1129 <dt><i>filename</i></dt> |
1207 <dt><i>filename</i> (str)</dt> |
1130 <dd> |
1208 <dd> |
1131 the program to be debugged (string) |
1209 the program to be debugged |
|
1210 </dd> |
|
1211 <dt><i>host</i> (str)</dt> |
|
1212 <dd> |
|
1213 hostname of the debug server |
|
1214 </dd> |
|
1215 <dt><i>port</i> (int)</dt> |
|
1216 <dd> |
|
1217 portnumber of the debug server |
|
1218 </dd> |
|
1219 <dt><i>enableTrace</i> (bool)</dt> |
|
1220 <dd> |
|
1221 flag to enable the tracing function |
|
1222 </dd> |
|
1223 <dt><i>exceptions</i> (bool)</dt> |
|
1224 <dd> |
|
1225 flag to enable exception reporting of the IDE |
|
1226 </dd> |
|
1227 <dt><i>tracePython</i> (bool)</dt> |
|
1228 <dd> |
|
1229 flag to enable tracing into the Python library |
|
1230 </dd> |
|
1231 <dt><i>redirect</i> (bool)</dt> |
|
1232 <dd> |
|
1233 flag indicating redirection of stdin, stdout and |
|
1234 stderr |
|
1235 </dd> |
|
1236 <dt><i>passive</i> (bool)</dt> |
|
1237 <dd> |
|
1238 flag indicating a passive debugging session |
|
1239 </dd> |
|
1240 <dt><i>multiprocessSupport</i> (bool)</dt> |
|
1241 <dd> |
|
1242 flag indicating to enable multiprocess |
|
1243 debugging support |
|
1244 </dd> |
|
1245 </dl> |
|
1246 <a NAME="DebugClientBase.startProgInDebugger" ID="DebugClientBase.startProgInDebugger"></a> |
|
1247 <h4>DebugClientBase.startProgInDebugger</h4> |
|
1248 <b>startProgInDebugger</b>(<i>progargs, wd='', host=None, port=None, exceptions=True, tracePython=False, redirect=True, passive=True, multiprocessSupport=False, codeStr="", scriptModule=""</i>) |
|
1249 |
|
1250 <p> |
|
1251 Public method used to start the remote debugger. |
|
1252 </p> |
|
1253 <dl> |
|
1254 |
|
1255 <dt><i>progargs</i></dt> |
|
1256 <dd> |
|
1257 commandline for the program to be debugged |
|
1258 (list of strings) |
|
1259 </dd> |
|
1260 <dt><i>wd</i></dt> |
|
1261 <dd> |
|
1262 working directory for the program execution (string) |
1132 </dd> |
1263 </dd> |
1133 <dt><i>host</i></dt> |
1264 <dt><i>host</i></dt> |
1134 <dd> |
1265 <dd> |
1135 hostname of the debug server (string) |
1266 hostname of the debug server (string) |
1136 </dd> |
1267 </dd> |
1137 <dt><i>port</i></dt> |
1268 <dt><i>port</i></dt> |
1138 <dd> |
1269 <dd> |
1139 portnumber of the debug server (int) |
1270 portnumber of the debug server (int) |
1140 </dd> |
|
1141 <dt><i>enableTrace</i></dt> |
|
1142 <dd> |
|
1143 flag to enable the tracing function (boolean) |
|
1144 </dd> |
1271 </dd> |
1145 <dt><i>exceptions</i></dt> |
1272 <dt><i>exceptions</i></dt> |
1146 <dd> |
1273 <dd> |
1147 flag to enable exception reporting of the IDE |
1274 flag to enable exception reporting of the IDE |
1148 (boolean) |
1275 (boolean) |
1155 <dt><i>redirect</i></dt> |
1282 <dt><i>redirect</i></dt> |
1156 <dd> |
1283 <dd> |
1157 flag indicating redirection of stdin, stdout and |
1284 flag indicating redirection of stdin, stdout and |
1158 stderr (boolean) |
1285 stderr (boolean) |
1159 </dd> |
1286 </dd> |
1160 </dl> |
1287 <dt><i>passive</i> (bool)</dt> |
1161 <a NAME="DebugClientBase.startProgInDebugger" ID="DebugClientBase.startProgInDebugger"></a> |
1288 <dd> |
1162 <h4>DebugClientBase.startProgInDebugger</h4> |
1289 flag indicating a passive debugging session |
1163 <b>startProgInDebugger</b>(<i>progargs, wd='', host=None, port=None, exceptions=True, tracePython=False, redirect=True</i>) |
1290 </dd> |
1164 |
1291 <dt><i>multiprocessSupport</i> (bool)</dt> |
1165 <p> |
1292 <dd> |
1166 Public method used to start the remote debugger. |
1293 flag indicating to enable multiprocess |
1167 </p> |
1294 debugging support |
1168 <dl> |
1295 </dd> |
1169 |
1296 <dt><i>codeStr</i> (str)</dt> |
1170 <dt><i>progargs</i></dt> |
1297 <dd> |
1171 <dd> |
1298 string containing Python code to execute |
1172 commandline for the program to be debugged |
1299 </dd> |
1173 (list of strings) |
1300 <dt><i>scriptModule</i> (str)</dt> |
1174 </dd> |
1301 <dd> |
1175 <dt><i>wd</i></dt> |
1302 name of a module to be executed as a script |
1176 <dd> |
1303 </dd> |
1177 working directory for the program execution (string) |
1304 </dl> |
1178 </dd> |
1305 <dl> |
1179 <dt><i>host</i></dt> |
1306 <dt>Return:</dt> |
1180 <dd> |
1307 <dd> |
1181 hostname of the debug server (string) |
1308 exit code of the debugged program |
1182 </dd> |
1309 </dd> |
1183 <dt><i>port</i></dt> |
1310 </dl> |
1184 <dd> |
1311 <dl> |
1185 portnumber of the debug server (int) |
1312 <dt>Return Type:</dt> |
1186 </dd> |
1313 <dd> |
1187 <dt><i>exceptions</i></dt> |
1314 int |
1188 <dd> |
|
1189 flag to enable exception reporting of the IDE |
|
1190 (boolean) |
|
1191 </dd> |
|
1192 <dt><i>tracePython</i></dt> |
|
1193 <dd> |
|
1194 flag to enable tracing into the Python library |
|
1195 (boolean) |
|
1196 </dd> |
|
1197 <dt><i>redirect</i></dt> |
|
1198 <dd> |
|
1199 flag indicating redirection of stdin, stdout and |
|
1200 stderr (boolean) |
|
1201 </dd> |
1315 </dd> |
1202 </dl> |
1316 </dl> |
1203 <a NAME="DebugClientBase.writeReady" ID="DebugClientBase.writeReady"></a> |
1317 <a NAME="DebugClientBase.writeReady" ID="DebugClientBase.writeReady"></a> |
1204 <h4>DebugClientBase.writeReady</h4> |
1318 <h4>DebugClientBase.writeReady</h4> |
1205 <b>writeReady</b>(<i>stream</i>) |
1319 <b>writeReady</b>(<i>stream</i>) |