/pystack

Tool to dump python thread and greenlet stacks.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

PyPI

pystack-debugger

The pystack-debugger is to python as jstack is to java.

It's a debug tool to print python threads or greenlet stacks.

Idea stolen from pyrasite.

Install

$ pip install pystack-debugger

Usage

You may need to run it with sudo.

$ sudo pystack [--include-greenlet] <pid>

Compatibility

PyPI - Python Version PyPI - Implementation

The pystack is compatible with CPython 3.8+ in both client side (the debugger) and server side (the destination process).

Using PyPy may work in client side (the debugger) but it is untested. Do not attempt to attach a PyPy process as destination. It may lead to unexpected and undefined behavior, because the pystack debugger uses gdb/lldb to invoke the CPython ABI.

Development

Run testing on a container environment:

$ podman machine start
$ ./test.sh
$ ./test.sh coverage html