[](https://pypi.org/project/pystack-debugger/)
# 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](https://github.com/lmacken/pyrasite).
## Install
$ pip install pystack-debugger
## Usage
You may need to run it with `sudo`.
$ sudo pystack [--include-greenlet] <pid>
## Compatibility
[](https://pypi.org/project/pystack-debugger/)
[](https://pypi.org/project/pystack-debugger/)
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
Raw data
{
"_id": null,
"home_page": "https://github.com/wooparadog/pystack/",
"name": "pystack-debugger",
"maintainer": "Jiangge Zhang",
"docs_url": null,
"requires_python": null,
"maintainer_email": "tonyseek@gmail.com",
"keywords": "pystack, pstack, jstack, gdb, lldb, greenlet",
"author": "Haochuan Guo",
"author_email": "guohaochuan@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b2/11/88852bd4df368c8a98ce68e1b113c538f664d57841a1229341ee77f7344d/pystack_debugger-0.11.0.tar.gz",
"platform": "linux",
"description": "[](https://pypi.org/project/pystack-debugger/)\n\n# pystack-debugger\n\nThe pystack-debugger is to python as jstack is to java.\n\nIt's a debug tool to print python threads or greenlet stacks.\n\nIdea stolen from [pyrasite](https://github.com/lmacken/pyrasite).\n\n## Install\n\n $ pip install pystack-debugger\n\n## Usage\n\nYou may need to run it with `sudo`.\n\n $ sudo pystack [--include-greenlet] <pid>\n\n## Compatibility\n\n[](https://pypi.org/project/pystack-debugger/)\n[](https://pypi.org/project/pystack-debugger/)\n\nThe pystack is compatible with CPython 3.8+ in both client side (the debugger)\nand server side (the destination process).\n\nUsing PyPy may work in client side (the debugger) but it is untested. Do not\nattempt to attach a PyPy process as destination. It may lead to unexpected and\nundefined behavior, because the pystack debugger uses gdb/lldb to invoke the\nCPython ABI.\n\n## Development\n\nRun testing on a container environment:\n\n $ podman machine start\n $ ./test.sh\n $ ./test.sh coverage html\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tool to print python thread and greenlet stacks",
"version": "0.11.0",
"project_urls": {
"Homepage": "https://github.com/wooparadog/pystack/"
},
"split_keywords": [
"pystack",
" pstack",
" jstack",
" gdb",
" lldb",
" greenlet"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e8878e9b47113353a6a976e6d1a22d9af3350baf39f76dfdce9adffdc0c5c7a5",
"md5": "6721609c2112994ebf375abe7c1d4ae1",
"sha256": "2d967eb77cb4c8f4768cc0a54f76a207d499d1a25249069725c052978ad0c2e2"
},
"downloads": -1,
"filename": "pystack_debugger-0.11.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6721609c2112994ebf375abe7c1d4ae1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5296,
"upload_time": "2024-08-12T15:05:08",
"upload_time_iso_8601": "2024-08-12T15:05:08.915801Z",
"url": "https://files.pythonhosted.org/packages/e8/87/8e9b47113353a6a976e6d1a22d9af3350baf39f76dfdce9adffdc0c5c7a5/pystack_debugger-0.11.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b21188852bd4df368c8a98ce68e1b113c538f664d57841a1229341ee77f7344d",
"md5": "8d7ec716583cc331b7eec326a0131f41",
"sha256": "d4fd5d1fb3dc3b4670066cfc46cd093f7c7251626f4f86503470ba30b22e5fbb"
},
"downloads": -1,
"filename": "pystack_debugger-0.11.0.tar.gz",
"has_sig": false,
"md5_digest": "8d7ec716583cc331b7eec326a0131f41",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5038,
"upload_time": "2024-08-12T15:05:10",
"upload_time_iso_8601": "2024-08-12T15:05:10.554849Z",
"url": "https://files.pythonhosted.org/packages/b2/11/88852bd4df368c8a98ce68e1b113c538f664d57841a1229341ee77f7344d/pystack_debugger-0.11.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-12 15:05:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "wooparadog",
"github_project": "pystack",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"tox": true,
"lcname": "pystack-debugger"
}
JSON
