1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
|
Debugging PySide with VSCode (Linux + Windows)
**********************************************
VSCode enables you to use more than one debugger in a single debugging session.
This means that we can use Python PDB and GDB (or the MSVC debugger for Windows)
in a single session. With VSCode you would be able to do the following:
* See the call stacks for both Python and C++ together.
* Put breakpoints in both the Python and the C++ code.
* Step from Python to C++ code and vice versa.
For Windows, see :ref:`creating_windows_debug_builds`.
Let's get started with setting up everything and debugging a Python process.
Setting the Python interpreter
------------------------------
In order to debug Python code, it is necessary to set the correct Python
interpreter in VSCode - this will ensure that all Python integrations of VSCode
use the same interpreter. However, this does not affect C++ debugging, and the
Python executable path must be set for the corresponding launch target
separately (see the section below).
To set the Python interpreter, open a Python file and click the corresponding
option on the right side of the VSCode status bar, which should look similar to
this:
.. image:: python_set_interpreter.png
:alt: set Python interpreter
:align: center
Alternatively, open the VSCode command palette (F1 or Ctrl + Shift + P) and
search for "Python: Select Interpreter".
Creating Configurations in launch.json
--------------------------------------
``Run -> Add Configuration -> Python -> Python File``
This should create a launch.json file which looks like this:
.. code-block:: javascript
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal"
}
]
}
It should already consist of a configuration named "Python: Current File",
which allows us to debug the current open Python file.
Now, we need to add a configuration to attach the C++ debugger to the Python
process that is already running in debug mode. If you have the C/C++ extension
installed and the appropriate debugger for your system, VSCode should be able
to automatically offer to add a configuration. On Linux, this is suggested with
the name
* "C/C++: (gdb) Attach"
and on Windows with the name
* "C/C++: (Windows) Attach"
Your launch.json should now look like this on Linux:
.. code-block:: javascript
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal"
},
{
"name": "(gdb) Attach",
"type": "cppdbg",
"request": "attach",
"program": "/path/to/python",
"processId": "${command:pickProcess}",
"MIMode": "gdb", "setupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
]
}
]
}
And like this on Windows:
.. code-block:: javascript
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal"
},
{
"name": "(Windows) Attach",
"type": "cppvsdbg",
"request": "attach",
"processId": "${command:pickProcess}",
}
]
}
For Linux, also make sure that the value of "program" refers to your Python
interpreter inside your virtual environment (for Windows this is not needed).
We need the processId to attach the gdb debugger to the process. With
"${command:pickProcess}", we find the processId on the go, as we will see later.
Now, we are ready to debug.
Debug The Process
-----------------
1. Set a breakpoint in the Python code.
2. Go to ``Run And Debug`` (Ctrl + Shift + D) and run the "Python: Current File"
by clicking the run symbol (green right-arrow). This will hit the breakpoint
and will halt the Python debugger.
3. Using the drop-down menu change from "Python:
Current File" to "(gdb) Attach" or "(Windows) Attach". Your setup should now
look like this.
.. image:: breakpoint_gdb.png
:alt: breakpoint before attach gdb
:align: center
4. Run "(gdb) Attach" or "(Windows) Attach" and this should ask you for the
processId of the Python process to which you want to attach the C++ debugger.
VSCode also lets you search for the process by its name.
.. tip:: You can find the processId by running ``ps aux | grep python``
.. image:: find_process_gdb.png
:alt: find process vscode
:align: center
5. VSCode might now ask you for superuser permissions. In that case, type 'y'
and enter your password.
.. code-block:: bash
Superuser access is required to attach to a process. Attaching as
superuser can potentially harm your computer. Do you want to continue?
[y/N]_
6. That is it. You should now be able to hit the breakpoints that you have set
on the C++ counterparts.
.. figure:: audioformat_wrapper.png
:alt: Breakpoint set on the shiboken wrapper class
:align: left
Breakpoint set on the shiboken wrapper class
.. figure:: audioformat_cpp.png
:alt: Breakpoint set on C++ implementation
:align: left
Breakpoint set on C++ implementation
|
