5 <link rel="stylesheet" href="styles.css"> |
5 <link rel="stylesheet" href="styles.css"> |
6 </head> |
6 </head> |
7 <body> |
7 <body> |
8 <a NAME="top" ID="top"></a> |
8 <a NAME="top" ID="top"></a> |
9 <h1>eric7.Debugger.DebugServer</h1> |
9 <h1>eric7.Debugger.DebugServer</h1> |
10 |
|
11 <p> |
10 <p> |
12 Module implementing the debug server. |
11 Module implementing the debug server. |
13 </p> |
12 </p> |
|
13 |
14 <h3>Global Attributes</h3> |
14 <h3>Global Attributes</h3> |
15 |
|
16 <table> |
15 <table> |
17 <tr><td>DebuggerInterfaces</td></tr><tr><td>NetworkInterfaceMapping</td></tr> |
16 <tr><td>DebuggerInterfaces</td></tr> |
|
17 <tr><td>NetworkInterfaceMapping</td></tr> |
18 </table> |
18 </table> |
|
19 |
19 <h3>Classes</h3> |
20 <h3>Classes</h3> |
20 |
|
21 <table> |
21 <table> |
22 |
|
23 <tr> |
22 <tr> |
24 <td><a href="#DebugServer">DebugServer</a></td> |
23 <td><a href="#DebugServer">DebugServer</a></td> |
25 <td>Class implementing the debug server embedded within the IDE.</td> |
24 <td>Class implementing the debug server embedded within the IDE.</td> |
26 </tr> |
25 </tr> |
27 </table> |
26 </table> |
|
27 |
28 <h3>Functions</h3> |
28 <h3>Functions</h3> |
29 |
|
30 <table> |
29 <table> |
31 <tr><td>None</td></tr> |
30 <tr><td>None</td></tr> |
32 </table> |
31 </table> |
|
32 |
33 <hr /> |
33 <hr /> |
34 <hr /> |
34 <hr /> |
35 <a NAME="DebugServer" ID="DebugServer"></a> |
35 <a NAME="DebugServer" ID="DebugServer"></a> |
36 <h2>DebugServer</h2> |
36 <h2>DebugServer</h2> |
37 |
|
38 <p> |
37 <p> |
39 Class implementing the debug server embedded within the IDE. |
38 Class implementing the debug server embedded within the IDE. |
40 </p> |
39 </p> |
|
40 |
41 <h3>Signals</h3> |
41 <h3>Signals</h3> |
42 <dl> |
42 <dl> |
43 |
43 |
44 <dt>appendStdout(msg)</dt> |
44 <dt>appendStdout(msg)</dt> |
45 <dd> |
45 <dd> |
640 <tr> |
638 <tr> |
641 <td><a href="#DebugServer.unregisterDebuggerInterface">unregisterDebuggerInterface</a></td> |
639 <td><a href="#DebugServer.unregisterDebuggerInterface">unregisterDebuggerInterface</a></td> |
642 <td>Public method to unregister a debugger interface.</td> |
640 <td>Public method to unregister a debugger interface.</td> |
643 </tr> |
641 </tr> |
644 </table> |
642 </table> |
|
643 |
645 <h3>Static Methods</h3> |
644 <h3>Static Methods</h3> |
646 |
|
647 <table> |
645 <table> |
648 <tr><td>None</td></tr> |
646 <tr><td>None</td></tr> |
649 </table> |
647 </table> |
650 |
648 |
|
649 |
651 <a NAME="DebugServer.__init__" ID="DebugServer.__init__"></a> |
650 <a NAME="DebugServer.__init__" ID="DebugServer.__init__"></a> |
652 <h4>DebugServer (Constructor)</h4> |
651 <h4>DebugServer (Constructor)</h4> |
653 <b>DebugServer</b>(<i>originalPathString, preventPassiveDebugging=False, project=None, parent=None, </i>) |
652 <b>DebugServer</b>(<i>originalPathString, preventPassiveDebugging=False, project=None, parent=None, </i>) |
654 |
|
655 <p> |
653 <p> |
656 Constructor |
654 Constructor |
657 </p> |
655 </p> |
|
656 |
658 <dl> |
657 <dl> |
659 |
658 |
660 <dt><i>originalPathString</i> (str)</dt> |
659 <dt><i>originalPathString</i> (str)</dt> |
661 <dd> |
660 <dd> |
662 original PATH environment variable |
661 original PATH environment variable |
730 </dd> |
729 </dd> |
731 </dl> |
730 </dl> |
732 <a NAME="DebugServer.__breakPointDataAboutToBeChanged" ID="DebugServer.__breakPointDataAboutToBeChanged"></a> |
731 <a NAME="DebugServer.__breakPointDataAboutToBeChanged" ID="DebugServer.__breakPointDataAboutToBeChanged"></a> |
733 <h4>DebugServer.__breakPointDataAboutToBeChanged</h4> |
732 <h4>DebugServer.__breakPointDataAboutToBeChanged</h4> |
734 <b>__breakPointDataAboutToBeChanged</b>(<i>startIndex, endIndex</i>) |
733 <b>__breakPointDataAboutToBeChanged</b>(<i>startIndex, endIndex</i>) |
735 |
|
736 <p> |
734 <p> |
737 Private slot to handle the dataAboutToBeChanged signal of the |
735 Private slot to handle the dataAboutToBeChanged signal of the |
738 breakpoint model. |
736 breakpoint model. |
739 </p> |
737 </p> |
|
738 |
740 <dl> |
739 <dl> |
741 |
740 |
742 <dt><i>startIndex</i> (QModelIndex)</dt> |
741 <dt><i>startIndex</i> (QModelIndex)</dt> |
743 <dd> |
742 <dd> |
744 start index of the rows to be changed |
743 start index of the rows to be changed |
803 </dd> |
802 </dd> |
804 </dl> |
803 </dl> |
805 <a NAME="DebugServer.__clientClearWatchPoint" ID="DebugServer.__clientClearWatchPoint"></a> |
804 <a NAME="DebugServer.__clientClearWatchPoint" ID="DebugServer.__clientClearWatchPoint"></a> |
806 <h4>DebugServer.__clientClearWatchPoint</h4> |
805 <h4>DebugServer.__clientClearWatchPoint</h4> |
807 <b>__clientClearWatchPoint</b>(<i>condition</i>) |
806 <b>__clientClearWatchPoint</b>(<i>condition</i>) |
808 |
|
809 <p> |
807 <p> |
810 Private slot to handle the clientClearWatch signal. |
808 Private slot to handle the clientClearWatch signal. |
811 </p> |
809 </p> |
|
810 |
812 <dl> |
811 <dl> |
813 |
812 |
814 <dt><i>condition</i> (str)</dt> |
813 <dt><i>condition</i> (str)</dt> |
815 <dd> |
814 <dd> |
816 expression of watch expression to clear |
815 expression of watch expression to clear |
817 </dd> |
816 </dd> |
818 </dl> |
817 </dl> |
819 <a NAME="DebugServer.__clientProcessError" ID="DebugServer.__clientProcessError"></a> |
818 <a NAME="DebugServer.__clientProcessError" ID="DebugServer.__clientProcessError"></a> |
820 <h4>DebugServer.__clientProcessError</h4> |
819 <h4>DebugServer.__clientProcessError</h4> |
821 <b>__clientProcessError</b>(<i></i>) |
820 <b>__clientProcessError</b>(<i></i>) |
822 |
|
823 <p> |
821 <p> |
824 Private slot to process client output received via stderr. |
822 Private slot to process client output received via stderr. |
825 </p> |
823 </p> |
|
824 |
826 <a NAME="DebugServer.__clientProcessOutput" ID="DebugServer.__clientProcessOutput"></a> |
825 <a NAME="DebugServer.__clientProcessOutput" ID="DebugServer.__clientProcessOutput"></a> |
827 <h4>DebugServer.__clientProcessOutput</h4> |
826 <h4>DebugServer.__clientProcessOutput</h4> |
828 <b>__clientProcessOutput</b>(<i></i>) |
827 <b>__clientProcessOutput</b>(<i></i>) |
829 |
|
830 <p> |
828 <p> |
831 Private slot to process client output received via stdout. |
829 Private slot to process client output received via stdout. |
832 </p> |
830 </p> |
|
831 |
833 <a NAME="DebugServer.__createDebuggerInterface" ID="DebugServer.__createDebuggerInterface"></a> |
832 <a NAME="DebugServer.__createDebuggerInterface" ID="DebugServer.__createDebuggerInterface"></a> |
834 <h4>DebugServer.__createDebuggerInterface</h4> |
833 <h4>DebugServer.__createDebuggerInterface</h4> |
835 <b>__createDebuggerInterface</b>(<i>clientType=None</i>) |
834 <b>__createDebuggerInterface</b>(<i>clientType=None</i>) |
836 |
|
837 <p> |
835 <p> |
838 Private slot to create the debugger interface object. |
836 Private slot to create the debugger interface object. |
839 </p> |
837 </p> |
|
838 |
840 <dl> |
839 <dl> |
841 |
840 |
842 <dt><i>clientType</i> (str)</dt> |
841 <dt><i>clientType</i> (str)</dt> |
843 <dd> |
842 <dd> |
844 type of the client interface to be created |
843 type of the client interface to be created |
845 </dd> |
844 </dd> |
846 </dl> |
845 </dl> |
847 <a NAME="DebugServer.__deleteBreakPoints" ID="DebugServer.__deleteBreakPoints"></a> |
846 <a NAME="DebugServer.__deleteBreakPoints" ID="DebugServer.__deleteBreakPoints"></a> |
848 <h4>DebugServer.__deleteBreakPoints</h4> |
847 <h4>DebugServer.__deleteBreakPoints</h4> |
849 <b>__deleteBreakPoints</b>(<i>parentIndex, start, end</i>) |
848 <b>__deleteBreakPoints</b>(<i>parentIndex, start, end</i>) |
850 |
|
851 <p> |
849 <p> |
852 Private slot to delete breakpoints. |
850 Private slot to delete breakpoints. |
853 </p> |
851 </p> |
|
852 |
854 <dl> |
853 <dl> |
855 |
854 |
856 <dt><i>parentIndex</i> (QModelIndex)</dt> |
855 <dt><i>parentIndex</i> (QModelIndex)</dt> |
857 <dd> |
856 <dd> |
858 index of parent item |
857 index of parent item |
972 </dd> |
971 </dd> |
973 </dl> |
972 </dl> |
974 <a NAME="DebugServer.__newConnection" ID="DebugServer.__newConnection"></a> |
973 <a NAME="DebugServer.__newConnection" ID="DebugServer.__newConnection"></a> |
975 <h4>DebugServer.__newConnection</h4> |
974 <h4>DebugServer.__newConnection</h4> |
976 <b>__newConnection</b>(<i></i>) |
975 <b>__newConnection</b>(<i></i>) |
977 |
|
978 <p> |
976 <p> |
979 Private slot to handle a new connection. |
977 Private slot to handle a new connection. |
980 </p> |
978 </p> |
|
979 |
981 <a NAME="DebugServer.__passiveShutDown" ID="DebugServer.__passiveShutDown"></a> |
980 <a NAME="DebugServer.__passiveShutDown" ID="DebugServer.__passiveShutDown"></a> |
982 <h4>DebugServer.__passiveShutDown</h4> |
981 <h4>DebugServer.__passiveShutDown</h4> |
983 <b>__passiveShutDown</b>(<i></i>) |
982 <b>__passiveShutDown</b>(<i></i>) |
984 |
|
985 <p> |
983 <p> |
986 Private method to shut down a passive debug connection. |
984 Private method to shut down a passive debug connection. |
987 </p> |
985 </p> |
|
986 |
988 <a NAME="DebugServer.__registerDebuggerInterfaces" ID="DebugServer.__registerDebuggerInterfaces"></a> |
987 <a NAME="DebugServer.__registerDebuggerInterfaces" ID="DebugServer.__registerDebuggerInterfaces"></a> |
989 <h4>DebugServer.__registerDebuggerInterfaces</h4> |
988 <h4>DebugServer.__registerDebuggerInterfaces</h4> |
990 <b>__registerDebuggerInterfaces</b>(<i></i>) |
989 <b>__registerDebuggerInterfaces</b>(<i></i>) |
991 |
|
992 <p> |
990 <p> |
993 Private method to register the available internal debugger interfaces. |
991 Private method to register the available internal debugger interfaces. |
994 </p> |
992 </p> |
|
993 |
995 <a NAME="DebugServer.__remoteBreakpointEnable" ID="DebugServer.__remoteBreakpointEnable"></a> |
994 <a NAME="DebugServer.__remoteBreakpointEnable" ID="DebugServer.__remoteBreakpointEnable"></a> |
996 <h4>DebugServer.__remoteBreakpointEnable</h4> |
995 <h4>DebugServer.__remoteBreakpointEnable</h4> |
997 <b>__remoteBreakpointEnable</b>(<i>debuggerId, fn, line, enable</i>) |
996 <b>__remoteBreakpointEnable</b>(<i>debuggerId, fn, line, enable</i>) |
998 |
|
999 <p> |
997 <p> |
1000 Private method to enable or disable a breakpoint. |
998 Private method to enable or disable a breakpoint. |
1001 </p> |
999 </p> |
|
1000 |
1002 <dl> |
1001 <dl> |
1003 |
1002 |
1004 <dt><i>debuggerId</i> (str)</dt> |
1003 <dt><i>debuggerId</i> (str)</dt> |
1005 <dd> |
1004 <dd> |
1006 ID of the debugger backend |
1005 ID of the debugger backend |
1019 </dd> |
1018 </dd> |
1020 </dl> |
1019 </dl> |
1021 <a NAME="DebugServer.__remoteBreakpointIgnore" ID="DebugServer.__remoteBreakpointIgnore"></a> |
1020 <a NAME="DebugServer.__remoteBreakpointIgnore" ID="DebugServer.__remoteBreakpointIgnore"></a> |
1022 <h4>DebugServer.__remoteBreakpointIgnore</h4> |
1021 <h4>DebugServer.__remoteBreakpointIgnore</h4> |
1023 <b>__remoteBreakpointIgnore</b>(<i>debuggerId, fn, line, count</i>) |
1022 <b>__remoteBreakpointIgnore</b>(<i>debuggerId, fn, line, count</i>) |
1024 |
|
1025 <p> |
1023 <p> |
1026 Private method to ignore a breakpoint the next couple of occurrences. |
1024 Private method to ignore a breakpoint the next couple of occurrences. |
1027 </p> |
1025 </p> |
|
1026 |
1028 <dl> |
1027 <dl> |
1029 |
1028 |
1030 <dt><i>debuggerId</i> (str)</dt> |
1029 <dt><i>debuggerId</i> (str)</dt> |
1031 <dd> |
1030 <dd> |
1032 ID of the debugger backend |
1031 ID of the debugger backend |
1045 </dd> |
1044 </dd> |
1046 </dl> |
1045 </dl> |
1047 <a NAME="DebugServer.__remoteWatchpoint" ID="DebugServer.__remoteWatchpoint"></a> |
1046 <a NAME="DebugServer.__remoteWatchpoint" ID="DebugServer.__remoteWatchpoint"></a> |
1048 <h4>DebugServer.__remoteWatchpoint</h4> |
1047 <h4>DebugServer.__remoteWatchpoint</h4> |
1049 <b>__remoteWatchpoint</b>(<i>debuggerId, cond, setWatch, temp=False</i>) |
1048 <b>__remoteWatchpoint</b>(<i>debuggerId, cond, setWatch, temp=False</i>) |
1050 |
|
1051 <p> |
1049 <p> |
1052 Private method to set or clear a watch expression. |
1050 Private method to set or clear a watch expression. |
1053 </p> |
1051 </p> |
|
1052 |
1054 <dl> |
1053 <dl> |
1055 |
1054 |
1056 <dt><i>debuggerId</i> (str)</dt> |
1055 <dt><i>debuggerId</i> (str)</dt> |
1057 <dd> |
1056 <dd> |
1058 ID of the debugger backend |
1057 ID of the debugger backend |
1162 </dd> |
1161 </dd> |
1163 </dl> |
1162 </dl> |
1164 <a NAME="DebugServer.__setClientType" ID="DebugServer.__setClientType"></a> |
1163 <a NAME="DebugServer.__setClientType" ID="DebugServer.__setClientType"></a> |
1165 <h4>DebugServer.__setClientType</h4> |
1164 <h4>DebugServer.__setClientType</h4> |
1166 <b>__setClientType</b>(<i>clType</i>) |
1165 <b>__setClientType</b>(<i>clType</i>) |
1167 |
|
1168 <p> |
1166 <p> |
1169 Private method to set the client type. |
1167 Private method to set the client type. |
1170 </p> |
1168 </p> |
|
1169 |
1171 <dl> |
1170 <dl> |
1172 |
1171 |
1173 <dt><i>clType</i> (str)</dt> |
1172 <dt><i>clType</i> (str)</dt> |
1174 <dd> |
1173 <dd> |
1175 type of client to be started |
1174 type of client to be started |
1176 </dd> |
1175 </dd> |
1177 </dl> |
1176 </dl> |
1178 <a NAME="DebugServer.__splitWatchCondition" ID="DebugServer.__splitWatchCondition"></a> |
1177 <a NAME="DebugServer.__splitWatchCondition" ID="DebugServer.__splitWatchCondition"></a> |
1179 <h4>DebugServer.__splitWatchCondition</h4> |
1178 <h4>DebugServer.__splitWatchCondition</h4> |
1180 <b>__splitWatchCondition</b>(<i>cond</i>) |
1179 <b>__splitWatchCondition</b>(<i>cond</i>) |
1181 |
|
1182 <p> |
1180 <p> |
1183 Private method to split a remote watch expression. |
1181 Private method to split a remote watch expression. |
1184 </p> |
1182 </p> |
|
1183 |
1185 <dl> |
1184 <dl> |
1186 |
1185 |
1187 <dt><i>cond</i> (str)</dt> |
1186 <dt><i>cond</i> (str)</dt> |
1188 <dd> |
1187 <dd> |
1189 remote expression |
1188 remote expression |
1202 </dd> |
1201 </dd> |
1203 </dl> |
1202 </dl> |
1204 <a NAME="DebugServer.__watchPointDataAboutToBeChanged" ID="DebugServer.__watchPointDataAboutToBeChanged"></a> |
1203 <a NAME="DebugServer.__watchPointDataAboutToBeChanged" ID="DebugServer.__watchPointDataAboutToBeChanged"></a> |
1205 <h4>DebugServer.__watchPointDataAboutToBeChanged</h4> |
1204 <h4>DebugServer.__watchPointDataAboutToBeChanged</h4> |
1206 <b>__watchPointDataAboutToBeChanged</b>(<i>startIndex, endIndex</i>) |
1205 <b>__watchPointDataAboutToBeChanged</b>(<i>startIndex, endIndex</i>) |
1207 |
|
1208 <p> |
1206 <p> |
1209 Private slot to handle the dataAboutToBeChanged signal of the |
1207 Private slot to handle the dataAboutToBeChanged signal of the |
1210 watch expression model. |
1208 watch expression model. |
1211 </p> |
1209 </p> |
|
1210 |
1212 <dl> |
1211 <dl> |
1213 |
1212 |
1214 <dt><i>startIndex</i> (QModelIndex)</dt> |
1213 <dt><i>startIndex</i> (QModelIndex)</dt> |
1215 <dd> |
1214 <dd> |
1216 start index of the rows to be changed |
1215 start index of the rows to be changed |
1441 </dd> |
1440 </dd> |
1442 </dl> |
1441 </dl> |
1443 <a NAME="DebugServer.initializeClient" ID="DebugServer.initializeClient"></a> |
1442 <a NAME="DebugServer.initializeClient" ID="DebugServer.initializeClient"></a> |
1444 <h4>DebugServer.initializeClient</h4> |
1443 <h4>DebugServer.initializeClient</h4> |
1445 <b>initializeClient</b>(<i>debuggerId</i>) |
1444 <b>initializeClient</b>(<i>debuggerId</i>) |
1446 |
|
1447 <p> |
1445 <p> |
1448 Public method to initialize a freshly connected debug client. |
1446 Public method to initialize a freshly connected debug client. |
1449 </p> |
1447 </p> |
|
1448 |
1450 <dl> |
1449 <dl> |
1451 |
1450 |
1452 <dt><i>debuggerId</i> (str)</dt> |
1451 <dt><i>debuggerId</i> (str)</dt> |
1453 <dd> |
1452 <dd> |
1454 ID of the connected debugger |
1453 ID of the connected debugger |
1455 </dd> |
1454 </dd> |
1456 </dl> |
1455 </dl> |
1457 <a NAME="DebugServer.isClientProcessUp" ID="DebugServer.isClientProcessUp"></a> |
1456 <a NAME="DebugServer.isClientProcessUp" ID="DebugServer.isClientProcessUp"></a> |
1458 <h4>DebugServer.isClientProcessUp</h4> |
1457 <h4>DebugServer.isClientProcessUp</h4> |
1459 <b>isClientProcessUp</b>(<i></i>) |
1458 <b>isClientProcessUp</b>(<i></i>) |
1460 |
|
1461 <p> |
1459 <p> |
1462 Public method to check, if the debug client process is up. |
1460 Public method to check, if the debug client process is up. |
1463 </p> |
1461 </p> |
|
1462 |
1464 <dl> |
1463 <dl> |
1465 <dt>Return:</dt> |
1464 <dt>Return:</dt> |
1466 <dd> |
1465 <dd> |
1467 flag indicating a running debug client process |
1466 flag indicating a running debug client process |
1468 </dd> |
1467 </dd> |
1512 </dd> |
1511 </dd> |
1513 </dl> |
1512 </dl> |
1514 <a NAME="DebugServer.mainClientConnected" ID="DebugServer.mainClientConnected"></a> |
1513 <a NAME="DebugServer.mainClientConnected" ID="DebugServer.mainClientConnected"></a> |
1515 <h4>DebugServer.mainClientConnected</h4> |
1514 <h4>DebugServer.mainClientConnected</h4> |
1516 <b>mainClientConnected</b>(<i></i>) |
1515 <b>mainClientConnected</b>(<i></i>) |
1517 |
|
1518 <p> |
1516 <p> |
1519 Public method to perform actions after the main client has finally |
1517 Public method to perform actions after the main client has finally |
1520 established the connection. |
1518 established the connection. |
1521 </p> |
1519 </p> |
|
1520 |
1522 <a NAME="DebugServer.passiveStartUp" ID="DebugServer.passiveStartUp"></a> |
1521 <a NAME="DebugServer.passiveStartUp" ID="DebugServer.passiveStartUp"></a> |
1523 <h4>DebugServer.passiveStartUp</h4> |
1522 <h4>DebugServer.passiveStartUp</h4> |
1524 <b>passiveStartUp</b>(<i>fn, reportAllExceptions, debuggerId</i>) |
1523 <b>passiveStartUp</b>(<i>fn, reportAllExceptions, debuggerId</i>) |
1525 |
|
1526 <p> |
1524 <p> |
1527 Public method to handle a passive debug connection. |
1525 Public method to handle a passive debug connection. |
1528 </p> |
1526 </p> |
|
1527 |
1529 <dl> |
1528 <dl> |
1530 |
1529 |
1531 <dt><i>fn</i> (str)</dt> |
1530 <dt><i>fn</i> (str)</dt> |
1532 <dd> |
1531 <dd> |
1533 filename of the debugged script |
1532 filename of the debugged script |
1542 </dd> |
1541 </dd> |
1543 </dl> |
1542 </dl> |
1544 <a NAME="DebugServer.preferencesChanged" ID="DebugServer.preferencesChanged"></a> |
1543 <a NAME="DebugServer.preferencesChanged" ID="DebugServer.preferencesChanged"></a> |
1545 <h4>DebugServer.preferencesChanged</h4> |
1544 <h4>DebugServer.preferencesChanged</h4> |
1546 <b>preferencesChanged</b>(<i></i>) |
1545 <b>preferencesChanged</b>(<i></i>) |
1547 |
|
1548 <p> |
1546 <p> |
1549 Public slot to handle the preferencesChanged signal. |
1547 Public slot to handle the preferencesChanged signal. |
1550 </p> |
1548 </p> |
|
1549 |
1551 <a NAME="DebugServer.registerDebuggerInterface" ID="DebugServer.registerDebuggerInterface"></a> |
1550 <a NAME="DebugServer.registerDebuggerInterface" ID="DebugServer.registerDebuggerInterface"></a> |
1552 <h4>DebugServer.registerDebuggerInterface</h4> |
1551 <h4>DebugServer.registerDebuggerInterface</h4> |
1553 <b>registerDebuggerInterface</b>(<i>interfaceName, getRegistryData, reregister=False</i>) |
1552 <b>registerDebuggerInterface</b>(<i>interfaceName, getRegistryData, reregister=False</i>) |
1554 |
|
1555 <p> |
1553 <p> |
1556 Public method to register a debugger interface. |
1554 Public method to register a debugger interface. |
1557 </p> |
1555 </p> |
|
1556 |
1558 <dl> |
1557 <dl> |
1559 |
1558 |
1560 <dt><i>interfaceName</i> (str)</dt> |
1559 <dt><i>interfaceName</i> (str)</dt> |
1561 <dd> |
1560 <dd> |
1562 name of the debugger interface |
1561 name of the debugger interface |
1575 </dd> |
1574 </dd> |
1576 </dl> |
1575 </dl> |
1577 <a NAME="DebugServer.remoteBanner" ID="DebugServer.remoteBanner"></a> |
1576 <a NAME="DebugServer.remoteBanner" ID="DebugServer.remoteBanner"></a> |
1578 <h4>DebugServer.remoteBanner</h4> |
1577 <h4>DebugServer.remoteBanner</h4> |
1579 <b>remoteBanner</b>(<i></i>) |
1578 <b>remoteBanner</b>(<i></i>) |
1580 |
|
1581 <p> |
1579 <p> |
1582 Public slot to get the banner info of the remote client. |
1580 Public slot to get the banner info of the remote client. |
1583 </p> |
1581 </p> |
|
1582 |
1584 <a NAME="DebugServer.remoteBreakpoint" ID="DebugServer.remoteBreakpoint"></a> |
1583 <a NAME="DebugServer.remoteBreakpoint" ID="DebugServer.remoteBreakpoint"></a> |
1585 <h4>DebugServer.remoteBreakpoint</h4> |
1584 <h4>DebugServer.remoteBreakpoint</h4> |
1586 <b>remoteBreakpoint</b>(<i>debuggerId, fn, line, setBreakpoint, cond=None, temp=False</i>) |
1585 <b>remoteBreakpoint</b>(<i>debuggerId, fn, line, setBreakpoint, cond=None, temp=False</i>) |
1587 |
|
1588 <p> |
1586 <p> |
1589 Public method to set or clear a breakpoint. |
1587 Public method to set or clear a breakpoint. |
1590 </p> |
1588 </p> |
|
1589 |
1591 <dl> |
1590 <dl> |
1592 |
1591 |
1593 <dt><i>debuggerId</i> (str)</dt> |
1592 <dt><i>debuggerId</i> (str)</dt> |
1594 <dd> |
1593 <dd> |
1595 ID of the debugger backend |
1594 ID of the debugger backend |
1616 </dd> |
1615 </dd> |
1617 </dl> |
1616 </dl> |
1618 <a NAME="DebugServer.remoteCapabilities" ID="DebugServer.remoteCapabilities"></a> |
1617 <a NAME="DebugServer.remoteCapabilities" ID="DebugServer.remoteCapabilities"></a> |
1619 <h4>DebugServer.remoteCapabilities</h4> |
1618 <h4>DebugServer.remoteCapabilities</h4> |
1620 <b>remoteCapabilities</b>(<i></i>) |
1619 <b>remoteCapabilities</b>(<i></i>) |
1621 |
|
1622 <p> |
1620 <p> |
1623 Public slot to get the debug clients capabilities. |
1621 Public slot to get the debug clients capabilities. |
1624 </p> |
1622 </p> |
|
1623 |
1625 <a NAME="DebugServer.remoteClientDisassembly" ID="DebugServer.remoteClientDisassembly"></a> |
1624 <a NAME="DebugServer.remoteClientDisassembly" ID="DebugServer.remoteClientDisassembly"></a> |
1626 <h4>DebugServer.remoteClientDisassembly</h4> |
1625 <h4>DebugServer.remoteClientDisassembly</h4> |
1627 <b>remoteClientDisassembly</b>(<i>debuggerId</i>) |
1626 <b>remoteClientDisassembly</b>(<i>debuggerId</i>) |
1628 |
|
1629 <p> |
1627 <p> |
1630 Public method to ask the client for the latest traceback disassembly. |
1628 Public method to ask the client for the latest traceback disassembly. |
1631 </p> |
1629 </p> |
|
1630 |
1632 <dl> |
1631 <dl> |
1633 |
1632 |
1634 <dt><i>debuggerId</i> (str)</dt> |
1633 <dt><i>debuggerId</i> (str)</dt> |
1635 <dd> |
1634 <dd> |
1636 ID of the debugger backend |
1635 ID of the debugger backend |
1637 </dd> |
1636 </dd> |
1638 </dl> |
1637 </dl> |
1639 <a NAME="DebugServer.remoteClientSetFilter" ID="DebugServer.remoteClientSetFilter"></a> |
1638 <a NAME="DebugServer.remoteClientSetFilter" ID="DebugServer.remoteClientSetFilter"></a> |
1640 <h4>DebugServer.remoteClientSetFilter</h4> |
1639 <h4>DebugServer.remoteClientSetFilter</h4> |
1641 <b>remoteClientSetFilter</b>(<i>debuggerId, scope, filterStr</i>) |
1640 <b>remoteClientSetFilter</b>(<i>debuggerId, scope, filterStr</i>) |
1642 |
|
1643 <p> |
1641 <p> |
1644 Public method to set a variables filter list. |
1642 Public method to set a variables filter list. |
1645 </p> |
1643 </p> |
|
1644 |
1646 <dl> |
1645 <dl> |
1647 |
1646 |
1648 <dt><i>debuggerId</i> (str)</dt> |
1647 <dt><i>debuggerId</i> (str)</dt> |
1649 <dd> |
1648 <dd> |
1650 ID of the debugger backend |
1649 ID of the debugger backend |
1659 </dd> |
1658 </dd> |
1660 </dl> |
1659 </dl> |
1661 <a NAME="DebugServer.remoteClientStack" ID="DebugServer.remoteClientStack"></a> |
1660 <a NAME="DebugServer.remoteClientStack" ID="DebugServer.remoteClientStack"></a> |
1662 <h4>DebugServer.remoteClientStack</h4> |
1661 <h4>DebugServer.remoteClientStack</h4> |
1663 <b>remoteClientStack</b>(<i>debuggerId</i>) |
1662 <b>remoteClientStack</b>(<i>debuggerId</i>) |
1664 |
|
1665 <p> |
1663 <p> |
1666 Public method to request the stack of the main thread. |
1664 Public method to request the stack of the main thread. |
1667 </p> |
1665 </p> |
|
1666 |
1668 <dl> |
1667 <dl> |
1669 |
1668 |
1670 <dt><i>debuggerId</i> (str)</dt> |
1669 <dt><i>debuggerId</i> (str)</dt> |
1671 <dd> |
1670 <dd> |
1672 ID of the debugger backend |
1671 ID of the debugger backend |
1673 </dd> |
1672 </dd> |
1674 </dl> |
1673 </dl> |
1675 <a NAME="DebugServer.remoteClientVariable" ID="DebugServer.remoteClientVariable"></a> |
1674 <a NAME="DebugServer.remoteClientVariable" ID="DebugServer.remoteClientVariable"></a> |
1676 <h4>DebugServer.remoteClientVariable</h4> |
1675 <h4>DebugServer.remoteClientVariable</h4> |
1677 <b>remoteClientVariable</b>(<i>debuggerId, scope, filterList, var, framenr=0, maxSize=0</i>) |
1676 <b>remoteClientVariable</b>(<i>debuggerId, scope, filterList, var, framenr=0, maxSize=0</i>) |
1678 |
|
1679 <p> |
1677 <p> |
1680 Public method to request the variables of the debugged program. |
1678 Public method to request the variables of the debugged program. |
1681 </p> |
1679 </p> |
|
1680 |
1682 <dl> |
1681 <dl> |
1683 |
1682 |
1684 <dt><i>debuggerId</i> (str)</dt> |
1683 <dt><i>debuggerId</i> (str)</dt> |
1685 <dd> |
1684 <dd> |
1686 ID of the debugger backend |
1685 ID of the debugger backend |
1709 </dd> |
1708 </dd> |
1710 </dl> |
1709 </dl> |
1711 <a NAME="DebugServer.remoteClientVariables" ID="DebugServer.remoteClientVariables"></a> |
1710 <a NAME="DebugServer.remoteClientVariables" ID="DebugServer.remoteClientVariables"></a> |
1712 <h4>DebugServer.remoteClientVariables</h4> |
1711 <h4>DebugServer.remoteClientVariables</h4> |
1713 <b>remoteClientVariables</b>(<i>debuggerId, scope, filterList, framenr=0</i>) |
1712 <b>remoteClientVariables</b>(<i>debuggerId, scope, filterList, framenr=0</i>) |
1714 |
|
1715 <p> |
1713 <p> |
1716 Public method to request the variables of the debugged program. |
1714 Public method to request the variables of the debugged program. |
1717 </p> |
1715 </p> |
|
1716 |
1718 <dl> |
1717 <dl> |
1719 |
1718 |
1720 <dt><i>debuggerId</i> (str)</dt> |
1719 <dt><i>debuggerId</i> (str)</dt> |
1721 <dd> |
1720 <dd> |
1722 ID of the debugger backend |
1721 ID of the debugger backend |
1735 </dd> |
1734 </dd> |
1736 </dl> |
1735 </dl> |
1737 <a NAME="DebugServer.remoteCompletion" ID="DebugServer.remoteCompletion"></a> |
1736 <a NAME="DebugServer.remoteCompletion" ID="DebugServer.remoteCompletion"></a> |
1738 <h4>DebugServer.remoteCompletion</h4> |
1737 <h4>DebugServer.remoteCompletion</h4> |
1739 <b>remoteCompletion</b>(<i>debuggerId, text</i>) |
1738 <b>remoteCompletion</b>(<i>debuggerId, text</i>) |
1740 |
|
1741 <p> |
1739 <p> |
1742 Public slot to get the a list of possible commandline completions |
1740 Public slot to get the a list of possible commandline completions |
1743 from the remote client. |
1741 from the remote client. |
1744 </p> |
1742 </p> |
|
1743 |
1745 <dl> |
1744 <dl> |
1746 |
1745 |
1747 <dt><i>debuggerId</i> (str)</dt> |
1746 <dt><i>debuggerId</i> (str)</dt> |
1748 <dd> |
1747 <dd> |
1749 ID of the debugger backend |
1748 ID of the debugger backend |
1772 </dd> |
1771 </dd> |
1773 </dl> |
1772 </dl> |
1774 <a NAME="DebugServer.remoteContinueUntil" ID="DebugServer.remoteContinueUntil"></a> |
1773 <a NAME="DebugServer.remoteContinueUntil" ID="DebugServer.remoteContinueUntil"></a> |
1775 <h4>DebugServer.remoteContinueUntil</h4> |
1774 <h4>DebugServer.remoteContinueUntil</h4> |
1776 <b>remoteContinueUntil</b>(<i>debuggerId, line</i>) |
1775 <b>remoteContinueUntil</b>(<i>debuggerId, line</i>) |
1777 |
|
1778 <p> |
1776 <p> |
1779 Public method to continue the debugged program to the given line |
1777 Public method to continue the debugged program to the given line |
1780 or until returning from the current frame. |
1778 or until returning from the current frame. |
1781 </p> |
1779 </p> |
|
1780 |
1782 <dl> |
1781 <dl> |
1783 |
1782 |
1784 <dt><i>debuggerId</i> (str)</dt> |
1783 <dt><i>debuggerId</i> (str)</dt> |
1785 <dd> |
1784 <dd> |
1786 ID of the debugger backend |
1785 ID of the debugger backend |
1791 </dd> |
1790 </dd> |
1792 </dl> |
1791 </dl> |
1793 <a NAME="DebugServer.remoteCoverage" ID="DebugServer.remoteCoverage"></a> |
1792 <a NAME="DebugServer.remoteCoverage" ID="DebugServer.remoteCoverage"></a> |
1794 <h4>DebugServer.remoteCoverage</h4> |
1793 <h4>DebugServer.remoteCoverage</h4> |
1795 <b>remoteCoverage</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, erase=False, forProject=False, runInConsole=False, clientType="", configOverride=None, </i>) |
1794 <b>remoteCoverage</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, erase=False, forProject=False, runInConsole=False, clientType="", configOverride=None, </i>) |
1796 |
|
1797 <p> |
1795 <p> |
1798 Public method to load a new program to collect coverage data. |
1796 Public method to load a new program to collect coverage data. |
1799 </p> |
1797 </p> |
|
1798 |
1800 <dl> |
1799 <dl> |
1801 |
1800 |
1802 <dt><i>venvName</i> (str)</dt> |
1801 <dt><i>venvName</i> (str)</dt> |
1803 <dd> |
1802 <dd> |
1804 name of the virtual environment to be used |
1803 name of the virtual environment to be used |
1870 </dd> |
1869 </dd> |
1871 </dl> |
1870 </dl> |
1872 <a NAME="DebugServer.remoteLoad" ID="DebugServer.remoteLoad"></a> |
1871 <a NAME="DebugServer.remoteLoad" ID="DebugServer.remoteLoad"></a> |
1873 <h4>DebugServer.remoteLoad</h4> |
1872 <h4>DebugServer.remoteLoad</h4> |
1874 <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, reportAllExceptions=False, </i>) |
1873 <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, reportAllExceptions=False, </i>) |
1875 |
|
1876 <p> |
1874 <p> |
1877 Public method to load a new program to debug. |
1875 Public method to load a new program to debug. |
1878 </p> |
1876 </p> |
|
1877 |
1879 <dl> |
1878 <dl> |
1880 |
1879 |
1881 <dt><i>venvName</i> (str)</dt> |
1880 <dt><i>venvName</i> (str)</dt> |
1882 <dd> |
1881 <dd> |
1883 name of the virtual environment to be used |
1882 name of the virtual environment to be used |
1971 </dd> |
1970 </dd> |
1972 </dl> |
1971 </dl> |
1973 <a NAME="DebugServer.remoteProfile" ID="DebugServer.remoteProfile"></a> |
1972 <a NAME="DebugServer.remoteProfile" ID="DebugServer.remoteProfile"></a> |
1974 <h4>DebugServer.remoteProfile</h4> |
1973 <h4>DebugServer.remoteProfile</h4> |
1975 <b>remoteProfile</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, erase=False, forProject=False, runInConsole=False, clientType="", configOverride=None, </i>) |
1974 <b>remoteProfile</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, erase=False, forProject=False, runInConsole=False, clientType="", configOverride=None, </i>) |
1976 |
|
1977 <p> |
1975 <p> |
1978 Public method to load a new program to collect profiling data. |
1976 Public method to load a new program to collect profiling data. |
1979 </p> |
1977 </p> |
|
1978 |
1980 <dl> |
1979 <dl> |
1981 |
1980 |
1982 <dt><i>venvName</i> (str)</dt> |
1981 <dt><i>venvName</i> (str)</dt> |
1983 <dd> |
1982 <dd> |
1984 name of the virtual environment to be used |
1983 name of the virtual environment to be used |
2047 </dd> |
2046 </dd> |
2048 </dl> |
2047 </dl> |
2049 <a NAME="DebugServer.remoteRun" ID="DebugServer.remoteRun"></a> |
2048 <a NAME="DebugServer.remoteRun" ID="DebugServer.remoteRun"></a> |
2050 <h4>DebugServer.remoteRun</h4> |
2049 <h4>DebugServer.remoteRun</h4> |
2051 <b>remoteRun</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, forProject=False, runInConsole=False, clientType="", configOverride=None, </i>) |
2050 <b>remoteRun</b>(<i>venvName, fn, argv, wd, env, autoClearShell=True, forProject=False, runInConsole=False, clientType="", configOverride=None, </i>) |
2052 |
|
2053 <p> |
2051 <p> |
2054 Public method to load a new program to run. |
2052 Public method to load a new program to run. |
2055 </p> |
2053 </p> |
|
2054 |
2056 <dl> |
2055 <dl> |
2057 |
2056 |
2058 <dt><i>venvName</i> (str)</dt> |
2057 <dt><i>venvName</i> (str)</dt> |
2059 <dd> |
2058 <dd> |
2060 name of the virtual environment to be used |
2059 name of the virtual environment to be used |
2136 </dd> |
2135 </dd> |
2137 </dl> |
2136 </dl> |
2138 <a NAME="DebugServer.remoteStep" ID="DebugServer.remoteStep"></a> |
2137 <a NAME="DebugServer.remoteStep" ID="DebugServer.remoteStep"></a> |
2139 <h4>DebugServer.remoteStep</h4> |
2138 <h4>DebugServer.remoteStep</h4> |
2140 <b>remoteStep</b>(<i>debuggerId</i>) |
2139 <b>remoteStep</b>(<i>debuggerId</i>) |
2141 |
|
2142 <p> |
2140 <p> |
2143 Public method to single step the debugged program. |
2141 Public method to single step the debugged program. |
2144 </p> |
2142 </p> |
|
2143 |
2145 <dl> |
2144 <dl> |
2146 |
2145 |
2147 <dt><i>debuggerId</i> (str)</dt> |
2146 <dt><i>debuggerId</i> (str)</dt> |
2148 <dd> |
2147 <dd> |
2149 ID of the debugger backend |
2148 ID of the debugger backend |
2150 </dd> |
2149 </dd> |
2151 </dl> |
2150 </dl> |
2152 <a NAME="DebugServer.remoteStepOut" ID="DebugServer.remoteStepOut"></a> |
2151 <a NAME="DebugServer.remoteStepOut" ID="DebugServer.remoteStepOut"></a> |
2153 <h4>DebugServer.remoteStepOut</h4> |
2152 <h4>DebugServer.remoteStepOut</h4> |
2154 <b>remoteStepOut</b>(<i>debuggerId</i>) |
2153 <b>remoteStepOut</b>(<i>debuggerId</i>) |
2155 |
|
2156 <p> |
2154 <p> |
2157 Public method to step out the debugged program. |
2155 Public method to step out the debugged program. |
2158 </p> |
2156 </p> |
|
2157 |
2159 <dl> |
2158 <dl> |
2160 |
2159 |
2161 <dt><i>debuggerId</i> (str)</dt> |
2160 <dt><i>debuggerId</i> (str)</dt> |
2162 <dd> |
2161 <dd> |
2163 ID of the debugger backend |
2162 ID of the debugger backend |
2164 </dd> |
2163 </dd> |
2165 </dl> |
2164 </dl> |
2166 <a NAME="DebugServer.remoteStepOver" ID="DebugServer.remoteStepOver"></a> |
2165 <a NAME="DebugServer.remoteStepOver" ID="DebugServer.remoteStepOver"></a> |
2167 <h4>DebugServer.remoteStepOver</h4> |
2166 <h4>DebugServer.remoteStepOver</h4> |
2168 <b>remoteStepOver</b>(<i>debuggerId</i>) |
2167 <b>remoteStepOver</b>(<i>debuggerId</i>) |
2169 |
|
2170 <p> |
2168 <p> |
2171 Public method to step over the debugged program. |
2169 Public method to step over the debugged program. |
2172 </p> |
2170 </p> |
|
2171 |
2173 <dl> |
2172 <dl> |
2174 |
2173 |
2175 <dt><i>debuggerId</i> (str)</dt> |
2174 <dt><i>debuggerId</i> (str)</dt> |
2176 <dd> |
2175 <dd> |
2177 ID of the debugger backend |
2176 ID of the debugger backend |
2178 </dd> |
2177 </dd> |
2179 </dl> |
2178 </dl> |
2180 <a NAME="DebugServer.remoteStepQuit" ID="DebugServer.remoteStepQuit"></a> |
2179 <a NAME="DebugServer.remoteStepQuit" ID="DebugServer.remoteStepQuit"></a> |
2181 <h4>DebugServer.remoteStepQuit</h4> |
2180 <h4>DebugServer.remoteStepQuit</h4> |
2182 <b>remoteStepQuit</b>(<i>debuggerId</i>) |
2181 <b>remoteStepQuit</b>(<i>debuggerId</i>) |
2183 |
|
2184 <p> |
2182 <p> |
2185 Public method to stop the debugged program. |
2183 Public method to stop the debugged program. |
2186 </p> |
2184 </p> |
|
2185 |
2187 <dl> |
2186 <dl> |
2188 |
2187 |
2189 <dt><i>debuggerId</i> (str)</dt> |
2188 <dt><i>debuggerId</i> (str)</dt> |
2190 <dd> |
2189 <dd> |
2191 ID of the debugger backend |
2190 ID of the debugger backend |
2192 </dd> |
2191 </dd> |
2193 </dl> |
2192 </dl> |
2194 <a NAME="DebugServer.remoteThreadList" ID="DebugServer.remoteThreadList"></a> |
2193 <a NAME="DebugServer.remoteThreadList" ID="DebugServer.remoteThreadList"></a> |
2195 <h4>DebugServer.remoteThreadList</h4> |
2194 <h4>DebugServer.remoteThreadList</h4> |
2196 <b>remoteThreadList</b>(<i>debuggerId</i>) |
2195 <b>remoteThreadList</b>(<i>debuggerId</i>) |
2197 |
|
2198 <p> |
2196 <p> |
2199 Public method to request the list of threads from the client. |
2197 Public method to request the list of threads from the client. |
2200 </p> |
2198 </p> |
|
2199 |
2201 <dl> |
2200 <dl> |
2202 |
2201 |
2203 <dt><i>debuggerId</i> (str)</dt> |
2202 <dt><i>debuggerId</i> (str)</dt> |
2204 <dd> |
2203 <dd> |
2205 ID of the debugger backend |
2204 ID of the debugger backend |
2206 </dd> |
2205 </dd> |
2207 </dl> |
2206 </dl> |
2208 <a NAME="DebugServer.setCallTraceEnabled" ID="DebugServer.setCallTraceEnabled"></a> |
2207 <a NAME="DebugServer.setCallTraceEnabled" ID="DebugServer.setCallTraceEnabled"></a> |
2209 <h4>DebugServer.setCallTraceEnabled</h4> |
2208 <h4>DebugServer.setCallTraceEnabled</h4> |
2210 <b>setCallTraceEnabled</b>(<i>debuggerId, on</i>) |
2209 <b>setCallTraceEnabled</b>(<i>debuggerId, on</i>) |
2211 |
|
2212 <p> |
2210 <p> |
2213 Public method to set the call trace state. |
2211 Public method to set the call trace state. |
2214 </p> |
2212 </p> |
|
2213 |
2215 <dl> |
2214 <dl> |
2216 |
2215 |
2217 <dt><i>debuggerId</i> (str)</dt> |
2216 <dt><i>debuggerId</i> (str)</dt> |
2218 <dd> |
2217 <dd> |
2219 ID of the debugger backend |
2218 ID of the debugger backend |
2224 </dd> |
2223 </dd> |
2225 </dl> |
2224 </dl> |
2226 <a NAME="DebugServer.setDebugging" ID="DebugServer.setDebugging"></a> |
2225 <a NAME="DebugServer.setDebugging" ID="DebugServer.setDebugging"></a> |
2227 <h4>DebugServer.setDebugging</h4> |
2226 <h4>DebugServer.setDebugging</h4> |
2228 <b>setDebugging</b>(<i>on</i>) |
2227 <b>setDebugging</b>(<i>on</i>) |
2229 |
|
2230 <p> |
2228 <p> |
2231 Public method to set the debugging state. |
2229 Public method to set the debugging state. |
2232 </p> |
2230 </p> |
|
2231 |
2233 <dl> |
2232 <dl> |
2234 |
2233 |
2235 <dt><i>on</i> (bool)</dt> |
2234 <dt><i>on</i> (bool)</dt> |
2236 <dd> |
2235 <dd> |
2237 flag indicating the new debugging state |
2236 flag indicating the new debugging state |
2238 </dd> |
2237 </dd> |
2239 </dl> |
2238 </dl> |
2240 <a NAME="DebugServer.shutdownServer" ID="DebugServer.shutdownServer"></a> |
2239 <a NAME="DebugServer.shutdownServer" ID="DebugServer.shutdownServer"></a> |
2241 <h4>DebugServer.shutdownServer</h4> |
2240 <h4>DebugServer.shutdownServer</h4> |
2242 <b>shutdownServer</b>(<i></i>) |
2241 <b>shutdownServer</b>(<i></i>) |
2243 |
|
2244 <p> |
2242 <p> |
2245 Public method to cleanly shut down. |
2243 Public method to cleanly shut down. |
2246 </p> |
2244 </p> |
2247 <p> |
2245 <p> |
2248 It closes our socket and shuts down |
2246 It closes our socket and shuts down |
2249 the debug client. (Needed on Win OS) |
2247 the debug client. (Needed on Win OS) |
2250 </p> |
2248 </p> |
|
2249 |
2251 <a NAME="DebugServer.signalClientBanner" ID="DebugServer.signalClientBanner"></a> |
2250 <a NAME="DebugServer.signalClientBanner" ID="DebugServer.signalClientBanner"></a> |
2252 <h4>DebugServer.signalClientBanner</h4> |
2251 <h4>DebugServer.signalClientBanner</h4> |
2253 <b>signalClientBanner</b>(<i>version, platform, venvName</i>) |
2252 <b>signalClientBanner</b>(<i>version, platform, venvName</i>) |
2254 |
|
2255 <p> |
2253 <p> |
2256 Public method to process the client banner info. |
2254 Public method to process the client banner info. |
2257 </p> |
2255 </p> |
|
2256 |
2258 <dl> |
2257 <dl> |
2259 |
2258 |
2260 <dt><i>version</i> (str)</dt> |
2259 <dt><i>version</i> (str)</dt> |
2261 <dd> |
2260 <dd> |
2262 interpreter version info |
2261 interpreter version info |
2271 </dd> |
2270 </dd> |
2272 </dl> |
2271 </dl> |
2273 <a NAME="DebugServer.signalClientBreakConditionError" ID="DebugServer.signalClientBreakConditionError"></a> |
2272 <a NAME="DebugServer.signalClientBreakConditionError" ID="DebugServer.signalClientBreakConditionError"></a> |
2274 <h4>DebugServer.signalClientBreakConditionError</h4> |
2273 <h4>DebugServer.signalClientBreakConditionError</h4> |
2275 <b>signalClientBreakConditionError</b>(<i>filename, lineno, debuggerId</i>) |
2274 <b>signalClientBreakConditionError</b>(<i>filename, lineno, debuggerId</i>) |
2276 |
|
2277 <p> |
2275 <p> |
2278 Public method to process the client breakpoint condition error info. |
2276 Public method to process the client breakpoint condition error info. |
2279 </p> |
2277 </p> |
|
2278 |
2280 <dl> |
2279 <dl> |
2281 |
2280 |
2282 <dt><i>filename</i> (str)</dt> |
2281 <dt><i>filename</i> (str)</dt> |
2283 <dd> |
2282 <dd> |
2284 filename of the breakpoint |
2283 filename of the breakpoint |
2293 </dd> |
2292 </dd> |
2294 </dl> |
2293 </dl> |
2295 <a NAME="DebugServer.signalClientCallTrace" ID="DebugServer.signalClientCallTrace"></a> |
2294 <a NAME="DebugServer.signalClientCallTrace" ID="DebugServer.signalClientCallTrace"></a> |
2296 <h4>DebugServer.signalClientCallTrace</h4> |
2295 <h4>DebugServer.signalClientCallTrace</h4> |
2297 <b>signalClientCallTrace</b>(<i>isCall, fromFile, fromLine, fromFunction, toFile, toLine, toFunction, debuggerId, </i>) |
2296 <b>signalClientCallTrace</b>(<i>isCall, fromFile, fromLine, fromFunction, toFile, toLine, toFunction, debuggerId, </i>) |
2298 |
|
2299 <p> |
2297 <p> |
2300 Public method to process the client call trace data. |
2298 Public method to process the client call trace data. |
2301 </p> |
2299 </p> |
|
2300 |
2302 <dl> |
2301 <dl> |
2303 |
2302 |
2304 <dt><i>isCall</i> (bool)</dt> |
2303 <dt><i>isCall</i> (bool)</dt> |
2305 <dd> |
2304 <dd> |
2306 flag indicating a 'call' |
2305 flag indicating a 'call' |
2335 </dd> |
2334 </dd> |
2336 </dl> |
2335 </dl> |
2337 <a NAME="DebugServer.signalClientCapabilities" ID="DebugServer.signalClientCapabilities"></a> |
2336 <a NAME="DebugServer.signalClientCapabilities" ID="DebugServer.signalClientCapabilities"></a> |
2338 <h4>DebugServer.signalClientCapabilities</h4> |
2337 <h4>DebugServer.signalClientCapabilities</h4> |
2339 <b>signalClientCapabilities</b>(<i>capabilities, clientType, venvName</i>) |
2338 <b>signalClientCapabilities</b>(<i>capabilities, clientType, venvName</i>) |
2340 |
|
2341 <p> |
2339 <p> |
2342 Public method to process the client capabilities info. |
2340 Public method to process the client capabilities info. |
2343 </p> |
2341 </p> |
|
2342 |
2344 <dl> |
2343 <dl> |
2345 |
2344 |
2346 <dt><i>capabilities</i> (int)</dt> |
2345 <dt><i>capabilities</i> (int)</dt> |
2347 <dd> |
2346 <dd> |
2348 bitmaks with the client capabilities |
2347 bitmaks with the client capabilities |
2397 </dd> |
2396 </dd> |
2398 </dl> |
2397 </dl> |
2399 <a NAME="DebugServer.signalClientCompletionList" ID="DebugServer.signalClientCompletionList"></a> |
2398 <a NAME="DebugServer.signalClientCompletionList" ID="DebugServer.signalClientCompletionList"></a> |
2400 <h4>DebugServer.signalClientCompletionList</h4> |
2399 <h4>DebugServer.signalClientCompletionList</h4> |
2401 <b>signalClientCompletionList</b>(<i>completionList, text, debuggerId</i>) |
2400 <b>signalClientCompletionList</b>(<i>completionList, text, debuggerId</i>) |
2402 |
|
2403 <p> |
2401 <p> |
2404 Public method to process the client auto completion info. |
2402 Public method to process the client auto completion info. |
2405 </p> |
2403 </p> |
|
2404 |
2406 <dl> |
2405 <dl> |
2407 |
2406 |
2408 <dt><i>completionList</i> (list of str)</dt> |
2407 <dt><i>completionList</i> (list of str)</dt> |
2409 <dd> |
2408 <dd> |
2410 list of possible completions |
2409 list of possible completions |
2419 </dd> |
2418 </dd> |
2420 </dl> |
2419 </dl> |
2421 <a NAME="DebugServer.signalClientDebuggerId" ID="DebugServer.signalClientDebuggerId"></a> |
2420 <a NAME="DebugServer.signalClientDebuggerId" ID="DebugServer.signalClientDebuggerId"></a> |
2422 <h4>DebugServer.signalClientDebuggerId</h4> |
2421 <h4>DebugServer.signalClientDebuggerId</h4> |
2423 <b>signalClientDebuggerId</b>(<i>debuggerId</i>) |
2422 <b>signalClientDebuggerId</b>(<i>debuggerId</i>) |
2424 |
|
2425 <p> |
2423 <p> |
2426 Public method to signal the receipt of a new debugger ID. |
2424 Public method to signal the receipt of a new debugger ID. |
2427 </p> |
2425 </p> |
2428 <p> |
2426 <p> |
2429 This signal indicates, that a new debugger backend has connected. |
2427 This signal indicates, that a new debugger backend has connected. |
2430 </p> |
2428 </p> |
|
2429 |
2431 <dl> |
2430 <dl> |
2432 |
2431 |
2433 <dt><i>debuggerId</i> (str)</dt> |
2432 <dt><i>debuggerId</i> (str)</dt> |
2434 <dd> |
2433 <dd> |
2435 ID of the newly connected debugger backend |
2434 ID of the newly connected debugger backend |
2436 </dd> |
2435 </dd> |
2437 </dl> |
2436 </dl> |
2438 <a NAME="DebugServer.signalClientDisassembly" ID="DebugServer.signalClientDisassembly"></a> |
2437 <a NAME="DebugServer.signalClientDisassembly" ID="DebugServer.signalClientDisassembly"></a> |
2439 <h4>DebugServer.signalClientDisassembly</h4> |
2438 <h4>DebugServer.signalClientDisassembly</h4> |
2440 <b>signalClientDisassembly</b>(<i>disassembly, debuggerId</i>) |
2439 <b>signalClientDisassembly</b>(<i>disassembly, debuggerId</i>) |
2441 |
|
2442 <p> |
2440 <p> |
2443 Public method to process the disassembly info from the client. |
2441 Public method to process the disassembly info from the client. |
2444 </p> |
2442 </p> |
|
2443 |
2445 <dl> |
2444 <dl> |
2446 |
2445 |
2447 <dt><i>disassembly</i> (dict)</dt> |
2446 <dt><i>disassembly</i> (dict)</dt> |
2448 <dd> |
2447 <dd> |
2449 dictionary containing the disassembly information |
2448 dictionary containing the disassembly information |
2454 </dd> |
2453 </dd> |
2455 </dl> |
2454 </dl> |
2456 <a NAME="DebugServer.signalClientDisconnected" ID="DebugServer.signalClientDisconnected"></a> |
2455 <a NAME="DebugServer.signalClientDisconnected" ID="DebugServer.signalClientDisconnected"></a> |
2457 <h4>DebugServer.signalClientDisconnected</h4> |
2456 <h4>DebugServer.signalClientDisconnected</h4> |
2458 <b>signalClientDisconnected</b>(<i>debuggerId</i>) |
2457 <b>signalClientDisconnected</b>(<i>debuggerId</i>) |
2459 |
|
2460 <p> |
2458 <p> |
2461 Public method to send a signal when a debug client has closed its |
2459 Public method to send a signal when a debug client has closed its |
2462 connection. |
2460 connection. |
2463 </p> |
2461 </p> |
|
2462 |
2464 <dl> |
2463 <dl> |
2465 |
2464 |
2466 <dt><i>debuggerId</i> (str)</dt> |
2465 <dt><i>debuggerId</i> (str)</dt> |
2467 <dd> |
2466 <dd> |
2468 ID of the debugger backend |
2467 ID of the debugger backend |
2469 </dd> |
2468 </dd> |
2470 </dl> |
2469 </dl> |
2471 <a NAME="DebugServer.signalClientException" ID="DebugServer.signalClientException"></a> |
2470 <a NAME="DebugServer.signalClientException" ID="DebugServer.signalClientException"></a> |
2472 <h4>DebugServer.signalClientException</h4> |
2471 <h4>DebugServer.signalClientException</h4> |
2473 <b>signalClientException</b>(<i>exceptionType, exceptionMessage, stackTrace, debuggerId, threadName=""</i>) |
2472 <b>signalClientException</b>(<i>exceptionType, exceptionMessage, stackTrace, debuggerId, threadName=""</i>) |
2474 |
|
2475 <p> |
2473 <p> |
2476 Public method to process the exception info from the client. |
2474 Public method to process the exception info from the client. |
2477 </p> |
2475 </p> |
|
2476 |
2478 <dl> |
2477 <dl> |
2479 |
2478 |
2480 <dt><i>exceptionType</i> (str)</dt> |
2479 <dt><i>exceptionType</i> (str)</dt> |
2481 <dd> |
2480 <dd> |
2482 type of exception raised |
2481 type of exception raised |
2501 </dd> |
2500 </dd> |
2502 </dl> |
2501 </dl> |
2503 <a NAME="DebugServer.signalClientExit" ID="DebugServer.signalClientExit"></a> |
2502 <a NAME="DebugServer.signalClientExit" ID="DebugServer.signalClientExit"></a> |
2504 <h4>DebugServer.signalClientExit</h4> |
2503 <h4>DebugServer.signalClientExit</h4> |
2505 <b>signalClientExit</b>(<i>program, status, message, debuggerId</i>) |
2504 <b>signalClientExit</b>(<i>program, status, message, debuggerId</i>) |
2506 |
|
2507 <p> |
2505 <p> |
2508 Public method to process the client exit status. |
2506 Public method to process the client exit status. |
2509 </p> |
2507 </p> |
|
2508 |
2510 <dl> |
2509 <dl> |
2511 |
2510 |
2512 <dt><i>program</i> (str)</dt> |
2511 <dt><i>program</i> (str)</dt> |
2513 <dd> |
2512 <dd> |
2514 name of the exited program |
2513 name of the exited program |
2527 </dd> |
2526 </dd> |
2528 </dl> |
2527 </dl> |
2529 <a NAME="DebugServer.signalClientLine" ID="DebugServer.signalClientLine"></a> |
2528 <a NAME="DebugServer.signalClientLine" ID="DebugServer.signalClientLine"></a> |
2530 <h4>DebugServer.signalClientLine</h4> |
2529 <h4>DebugServer.signalClientLine</h4> |
2531 <b>signalClientLine</b>(<i>filename, lineno, debuggerId, forStack=False, threadName=""</i>) |
2530 <b>signalClientLine</b>(<i>filename, lineno, debuggerId, forStack=False, threadName=""</i>) |
2532 |
|
2533 <p> |
2531 <p> |
2534 Public method to process client position feedback. |
2532 Public method to process client position feedback. |
2535 </p> |
2533 </p> |
|
2534 |
2536 <dl> |
2535 <dl> |
2537 |
2536 |
2538 <dt><i>filename</i> (str)</dt> |
2537 <dt><i>filename</i> (str)</dt> |
2539 <dd> |
2538 <dd> |
2540 name of the file currently being executed |
2539 name of the file currently being executed |
2597 </dd> |
2596 </dd> |
2598 </dl> |
2597 </dl> |
2599 <a NAME="DebugServer.signalClientSignal" ID="DebugServer.signalClientSignal"></a> |
2598 <a NAME="DebugServer.signalClientSignal" ID="DebugServer.signalClientSignal"></a> |
2600 <h4>DebugServer.signalClientSignal</h4> |
2599 <h4>DebugServer.signalClientSignal</h4> |
2601 <b>signalClientSignal</b>(<i>message, filename, lineNo, funcName, funcArgs, debuggerId</i>) |
2600 <b>signalClientSignal</b>(<i>message, filename, lineNo, funcName, funcArgs, debuggerId</i>) |
2602 |
|
2603 <p> |
2601 <p> |
2604 Public method to process a signal generated on the client side. |
2602 Public method to process a signal generated on the client side. |
2605 </p> |
2603 </p> |
|
2604 |
2606 <dl> |
2605 <dl> |
2607 |
2606 |
2608 <dt><i>message</i> (str)</dt> |
2607 <dt><i>message</i> (str)</dt> |
2609 <dd> |
2608 <dd> |
2610 message of the syntax error |
2609 message of the syntax error |
2631 </dd> |
2630 </dd> |
2632 </dl> |
2631 </dl> |
2633 <a NAME="DebugServer.signalClientStack" ID="DebugServer.signalClientStack"></a> |
2632 <a NAME="DebugServer.signalClientStack" ID="DebugServer.signalClientStack"></a> |
2634 <h4>DebugServer.signalClientStack</h4> |
2633 <h4>DebugServer.signalClientStack</h4> |
2635 <b>signalClientStack</b>(<i>stack, debuggerId, threadName=""</i>) |
2634 <b>signalClientStack</b>(<i>stack, debuggerId, threadName=""</i>) |
2636 |
|
2637 <p> |
2635 <p> |
2638 Public method to process a client's stack information. |
2636 Public method to process a client's stack information. |
2639 </p> |
2637 </p> |
|
2638 |
2640 <dl> |
2639 <dl> |
2641 |
2640 |
2642 <dt><i>stack</i> (list of lists of (string, integer, string))</dt> |
2641 <dt><i>stack</i> (list of lists of (string, integer, string))</dt> |
2643 <dd> |
2642 <dd> |
2644 list of stack entries. Each entry is a tuple of three |
2643 list of stack entries. Each entry is a tuple of three |
2672 </dd> |
2671 </dd> |
2673 </dl> |
2672 </dl> |
2674 <a NAME="DebugServer.signalClientSyntaxError" ID="DebugServer.signalClientSyntaxError"></a> |
2673 <a NAME="DebugServer.signalClientSyntaxError" ID="DebugServer.signalClientSyntaxError"></a> |
2675 <h4>DebugServer.signalClientSyntaxError</h4> |
2674 <h4>DebugServer.signalClientSyntaxError</h4> |
2676 <b>signalClientSyntaxError</b>(<i>message, filename, lineNo, characterNo, debuggerId, threadName=""</i>) |
2675 <b>signalClientSyntaxError</b>(<i>message, filename, lineNo, characterNo, debuggerId, threadName=""</i>) |
2677 |
|
2678 <p> |
2676 <p> |
2679 Public method to process a syntax error info from the client. |
2677 Public method to process a syntax error info from the client. |
2680 </p> |
2678 </p> |
|
2679 |
2681 <dl> |
2680 <dl> |
2682 |
2681 |
2683 <dt><i>message</i> (str)</dt> |
2682 <dt><i>message</i> (str)</dt> |
2684 <dd> |
2683 <dd> |
2685 message of the syntax error |
2684 message of the syntax error |
2728 </dd> |
2727 </dd> |
2729 </dl> |
2728 </dl> |
2730 <a NAME="DebugServer.signalClientThreadSet" ID="DebugServer.signalClientThreadSet"></a> |
2729 <a NAME="DebugServer.signalClientThreadSet" ID="DebugServer.signalClientThreadSet"></a> |
2731 <h4>DebugServer.signalClientThreadSet</h4> |
2730 <h4>DebugServer.signalClientThreadSet</h4> |
2732 <b>signalClientThreadSet</b>(<i>debuggerId</i>) |
2731 <b>signalClientThreadSet</b>(<i>debuggerId</i>) |
2733 |
|
2734 <p> |
2732 <p> |
2735 Public method to handle the change of the client thread. |
2733 Public method to handle the change of the client thread. |
2736 </p> |
2734 </p> |
|
2735 |
2737 <dl> |
2736 <dl> |
2738 |
2737 |
2739 <dt><i>debuggerId</i> (str)</dt> |
2738 <dt><i>debuggerId</i> (str)</dt> |
2740 <dd> |
2739 <dd> |
2741 ID of the debugger backend |
2740 ID of the debugger backend |
2742 </dd> |
2741 </dd> |
2743 </dl> |
2742 </dl> |
2744 <a NAME="DebugServer.signalClientVariable" ID="DebugServer.signalClientVariable"></a> |
2743 <a NAME="DebugServer.signalClientVariable" ID="DebugServer.signalClientVariable"></a> |
2745 <h4>DebugServer.signalClientVariable</h4> |
2744 <h4>DebugServer.signalClientVariable</h4> |
2746 <b>signalClientVariable</b>(<i>scope, variables, debuggerId</i>) |
2745 <b>signalClientVariable</b>(<i>scope, variables, debuggerId</i>) |
2747 |
|
2748 <p> |
2746 <p> |
2749 Public method to process the client variable info. |
2747 Public method to process the client variable info. |
2750 </p> |
2748 </p> |
|
2749 |
2751 <dl> |
2750 <dl> |
2752 |
2751 |
2753 <dt><i>scope</i> (int)</dt> |
2752 <dt><i>scope</i> (int)</dt> |
2754 <dd> |
2753 <dd> |
2755 scope of the variables (-1 = empty global, 1 = global, |
2754 scope of the variables (-1 = empty global, 1 = global, |
2806 </dd> |
2805 </dd> |
2807 </dl> |
2806 </dl> |
2808 <a NAME="DebugServer.signalLastClientExited" ID="DebugServer.signalLastClientExited"></a> |
2807 <a NAME="DebugServer.signalLastClientExited" ID="DebugServer.signalLastClientExited"></a> |
2809 <h4>DebugServer.signalLastClientExited</h4> |
2808 <h4>DebugServer.signalLastClientExited</h4> |
2810 <b>signalLastClientExited</b>(<i></i>) |
2809 <b>signalLastClientExited</b>(<i></i>) |
2811 |
|
2812 <p> |
2810 <p> |
2813 Public method to process the last client exit event. |
2811 Public method to process the last client exit event. |
2814 </p> |
2812 </p> |
|
2813 |
2815 <a NAME="DebugServer.signalMainClientExit" ID="DebugServer.signalMainClientExit"></a> |
2814 <a NAME="DebugServer.signalMainClientExit" ID="DebugServer.signalMainClientExit"></a> |
2816 <h4>DebugServer.signalMainClientExit</h4> |
2815 <h4>DebugServer.signalMainClientExit</h4> |
2817 <b>signalMainClientExit</b>(<i></i>) |
2816 <b>signalMainClientExit</b>(<i></i>) |
2818 |
|
2819 <p> |
2817 <p> |
2820 Public method to process the main client exiting. |
2818 Public method to process the main client exiting. |
2821 </p> |
2819 </p> |
|
2820 |
2822 <a NAME="DebugServer.startClient" ID="DebugServer.startClient"></a> |
2821 <a NAME="DebugServer.startClient" ID="DebugServer.startClient"></a> |
2823 <h4>DebugServer.startClient</h4> |
2822 <h4>DebugServer.startClient</h4> |
2824 <b>startClient</b>(<i>unplanned=True, clType=None, forProject=False, runInConsole=False, venvName="", workingDir=None, configOverride=None, </i>) |
2823 <b>startClient</b>(<i>unplanned=True, clType=None, forProject=False, runInConsole=False, venvName="", workingDir=None, configOverride=None, </i>) |
2825 |
|
2826 <p> |
2824 <p> |
2827 Public method to start a debug client. |
2825 Public method to start a debug client. |
2828 </p> |
2826 </p> |
|
2827 |
2829 <dl> |
2828 <dl> |
2830 |
2829 |
2831 <dt><i>unplanned</i> (bool)</dt> |
2830 <dt><i>unplanned</i> (bool)</dt> |
2832 <dd> |
2831 <dd> |
2833 flag indicating that the client has died |
2832 flag indicating that the client has died |