pstack

Tool to dump python thread and greenlet stacks.

https://github.com/wooparadog/pystack

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (7.4%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

Tool to dump python thread and greenlet stacks.

Basic Info
  • Host: GitHub
  • Owner: wooparadog
  • License: bsd-3-clause
  • Language: Python
  • Default Branch: master
  • Size: 74.2 KB
Statistics
  • Stars: 163
  • Watchers: 2
  • Forks: 25
  • Open Issues: 0
  • Releases: 2
Created about 10 years ago · Last pushed 12 months ago
Metadata Files
Readme Changelog License

README.md

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.

Requirements

  • Python 3.8+ (CPython implementation)
  • Debugger: Either gdb (Linux) or lldb (macOS/Linux)
  • Privileges: Root access (sudo) to attach to other processes

Note: On some Linux systems, you may need to adjust the ptrace_scope setting to allow debugger attachment.

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

Owner

  • Name: Haochuan Guo
  • Login: wooparadog
  • Kind: user
  • Location: China

GitHub Events

Total
  • Issues event: 1
  • Watch event: 1
  • Push event: 1
Last Year
  • Issues event: 1
  • Watch event: 1
  • Push event: 1

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 45
  • Total Committers: 5
  • Avg Commits per committer: 9.0
  • Development Distribution Score (DDS): 0.178
Past Year
  • Commits: 10
  • Committers: 2
  • Avg Commits per committer: 5.0
  • Development Distribution Score (DDS): 0.1
Top Committers
Name Email Commits
Jiangge Zhang t****k@g****m 37
WooParadog h****o@e****e 5
Jonathan Lassoff j****f@t****m 1
damnever d****f@g****m 1
Haochuan Guo w****g 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 4
  • Total pull requests: 14
  • Average time to close issues: about 1 year
  • Average time to close pull requests: 4 months
  • Total issue authors: 4
  • Total pull request authors: 5
  • Average comments per issue: 1.5
  • Average comments per pull request: 0.14
  • Merged pull requests: 13
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 2
  • Average time to close issues: N/A
  • Average time to close pull requests: about 3 hours
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • abc19899 (1)
  • kanglue (1)
  • honglei (1)
  • Xinshiyou (1)
Pull Request Authors
  • tonyseek (12)
  • wooparadog (1)
  • jiangruocheng (1)
  • damnever (1)
  • jof (1)
Top Labels
Issue Labels
bug (1)
Pull Request Labels
enhancement (2) bug (1)

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 3,313 last-month
  • Total docker downloads: 60
  • Total dependent packages: 1
    (may contain duplicates)
  • Total dependent repositories: 7
    (may contain duplicates)
  • Total versions: 15
  • Total maintainers: 3
pypi.org: pystack-debugger

Tool to print python thread and greenlet stacks

  • Versions: 6
  • Dependent Packages: 1
  • Dependent Repositories: 6
  • Downloads: 654 Last month
  • Docker Downloads: 60
Rankings
Docker downloads count: 3.6%
Dependent packages count: 4.8%
Stargazers count: 5.7%
Dependent repos count: 6.0%
Average: 6.1%
Forks count: 7.7%
Downloads: 8.9%
Maintainers (2)
Last synced: 11 months ago
pypi.org: pstack

Tool to print python thread and greenlet stacks

  • Versions: 8
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 135 Last month
Rankings
Stargazers count: 5.7%
Forks count: 7.7%
Dependent packages count: 10.1%
Average: 15.2%
Dependent repos count: 21.6%
Downloads: 30.8%
Maintainers (2)
Last synced: 11 months ago
pypi.org: pystack-debugger-custom

Tool to print python thread and greenlet stacks

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 2,524 Last month
Rankings
Dependent packages count: 10.7%
Average: 35.3%
Dependent repos count: 60.0%
Maintainers (1)
Last synced: 11 months ago

Dependencies

setup.py pypi
  • click >=5.1,<6.0