Attach to process
PyCharm provides a way to attach the debugger to a Python local process, while running a Python script launched either from your operating system or using the PyCharm terminal, but NOT in the debug mode. Note that you cannot attach to a remote process.
Prerequisites for Ubuntu
On Ubuntu and some other Linux distributions, you might get the ptrace: Operation not permitted error message upon the first attempt to attach to a process. Do one of the following:
To disable this restriction temporarily, enter the command:
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scopeTo disable this restriction permanently, open the /etc/sysctl.d/10-ptrace.conf file for editing and change the line
kernel.yama.ptrace_scope = 1tokernel.yama.ptrace_scope = 0.To apply the changes immediately, enter the above command
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope.Alternatively, run
sudo service procps restartor restart your system.
You can find more details here.
Attach to a local process
Press Ctrl+Alt+F5 or select from the main menu.
PyCharm will show the list of the running local processes. Select the process to attach to.
When there are too many processes, you can narrow down the list by typing the first letters of the process name or PID.
You might want to show only specific processes in the Attach to Process list. Add the required pattern to the corresponding field on the Build, Execution, Deployment | Python Debugger settings page Ctrl+Alt+S For example, put "Scientific" if you want to attach only processes matching this string.
Proceed with debugging the same way as you usually do it in PyCharm (set breakpoints, step through, pause and resume the process, evaluate expressions, and so on).
Note that in case the process you have attached to does not provide debug information, breakpoints will be unavailable and stepping will be performed in the disassembly view.
Detach from a process
The steps to detach from a remote process are the same as for stopping a local debug session. However, unlike local sessions, the target process continues to run after the debugger detaches.
Click the Stop
button on the main toolbar on in the Debug tool window.Alternatively, click Stop
on the main toolbar or press Ctrl+F2, then select the session to be closed.