pystack 1.5.1__tar.gz → 1.7.0__tar.gz

{pystack-1.5.1 → pystack-1.7.0}/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.5.1
+current_version = 1.7.0
 commit = True
 message = 
 	Prepare for {new_version} release

pystack-1.7.0/.clang-format

@@ -0,0 +1,97 @@
+BasedOnStyle: LLVM
+Language: Cpp
+AccessModifierOffset: -2
+AlignAfterOpenBracket: AlwaysBreak
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+AlignEscapedNewlines: Right
+AlignOperands: true
+AlignTrailingComments: false
+AllowAllArgumentsOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: None
+AllowShortIfStatementsOnASingleLine: WithoutElse
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterReturnType: TopLevel
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: Yes
+BinPackArguments: false
+BinPackParameters: false
+BraceWrapping:
+  AfterClass: true
+  AfterControlStatement: MultiLine
+  AfterEnum: false
+  AfterFunction: true
+  AfterNamespace: false
+  AfterStruct: true
+  AfterUnion: false
+  AfterExternBlock: false
+  BeforeCatch: false
+  BeforeElse: false
+  IndentBraces: false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+BreakBeforeBinaryOperators: NonAssignment
+BreakBeforeBraces: Custom
+BreakBeforeInheritanceComma: false
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializers: BeforeComma
+BreakInheritanceList: BeforeComma
+BreakStringLiterals: true
+ColumnLimit: 105
+CompactNamespaces: false
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
+ConstructorInitializerIndentWidth: 0
+ContinuationIndentWidth: 8
+Cpp11BracedListStyle: true
+DerivePointerAlignment: false
+FixNamespaceComments: true
+IncludeBlocks: Preserve
+IncludeCategories:
+  - Regex: '^"(llvm|llvm-c|clang|clang-c)/'
+    Priority: 2
+  - Regex: '^(<|"(gtest|gmock|isl|json)/)'
+    Priority: 3
+  - Regex: ".*"
+    Priority: 1
+IndentCaseLabels: true
+IndentGotoLabels: false
+IndentPPDirectives: AfterHash
+IndentWidth: 4
+IndentWrappedFunctionNames: false
+KeepEmptyLinesAtTheStartOfBlocks: false
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 19
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyBreakTemplateDeclaration: 10
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 60
+PointerAlignment: Left
+ReflowComments: true
+SortIncludes: true
+SortUsingDeclarations: true
+SpaceAfterCStyleCast: false
+SpaceAfterTemplateKeyword: false
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCpp11BracedList: false
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 2
+SpacesInAngles: false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+Standard: Auto
+TabWidth: 8
+UseTab: Never

pystack-1.7.0/.gitattributes

@@ -0,0 +1,2 @@
+# Normalize line-endings for all text files.
+* text=auto

pystack-1.7.0/.gitignore

@@ -0,0 +1,167 @@
+# IDE stuff
+
+.idea/*
+
+# Cmake stuff
+
+CMakeLists.txt.user
+CMakeCache.txt
+CMakeFiles
+CMakeScripts
+Testing
+Makefile
+cmake_install.cmake
+install_manifest.txt
+compile_commands.json
+CTestTestfile.cmake
+_deps
+*.cbp
+cmake-build-*/
+
+# pip stuff
+pip-wheel-metadata/
+
+# Cython specific files
+src/pystack/*.cpp
+src/pystack/_pystack_api.h
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+pystack-coverage
+*coverage.lcov
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/

{pystack-1.5.1 → pystack-1.7.0}/.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: 3e8a8703264a2f4a69428a0aa4dcb512790b2c8c  # frozen: v6.0.0
     hooks:
       - id: check-added-large-files
       - id: check-json
@@ -12,41 +12,41 @@ repos:
         exclude: "^[.]bumpversion[.]cfg"
 
   - repo: https://github.com/pre-commit/pygrep-hooks
-    rev: v1.10.0
+    rev: 3a6eb0fadf60b3cccfd80bad9dbb6fae7e47b316  # frozen: v1.10.0
     hooks:
       - id: rst-directive-colons
       - id: rst-inline-touching-normal
 
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: "v0.0.262"
+    rev: "5e2fb545eba1ea9dc051f6f962d52fe8f76a9794"  # frozen: v0.15.13
     hooks:
       - id: ruff
         args: [--fix, --exit-non-zero-on-fix]
         stages: [pre-commit]
 
   - repo: https://github.com/psf/black
-    rev: 23.3.0
+    rev: 87928e6d6761a4a6d22250e1fee5601b3998086e  # frozen: 26.5.1
     hooks:
       - id: black
 
   - repo: https://github.com/pycqa/isort
-    rev: 5.12.0
+    rev: dac090ce4d9ee313d086e2e89ab1acb8c2664fa1  # frozen: 9.0.0a3
     hooks:
       - id: isort
         exclude_types: [python]
 
   - repo: https://github.com/sphinx-contrib/sphinx-lint
-    rev: v0.6.7
+    rev: c883505f64b59c3c5c9375191e4ad9f98e727ccd  # frozen: v1.0.2
     hooks:
       - id: sphinx-lint
 
   - repo: https://github.com/executablebooks/mdformat/
-    rev: 0.7.16
+    rev: 82912cdaea4fb830f751504486a7879c70526547  # frozen: 1.0.0
     hooks:
       - id: mdformat
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v16.0.2
+    rev: dd18dad857d6133e90bbe478f4f2f22ec0030269  # frozen: v22.1.5
     hooks:
       - id: clang-format
         args: [--Werror, -i]

pystack-1.7.0/CMakeLists.txt

@@ -0,0 +1,24 @@
+cmake_minimum_required(VERSION 3.17...3.27)
+
+project(pystack LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+# Find Python
+find_package(Python 3.9 COMPONENTS Interpreter Development.Module REQUIRED)
+
+# Find nanobind
+execute_process(
+    COMMAND "${Python_EXECUTABLE}" -m nanobind --cmake_dir
+    OUTPUT_STRIP_TRAILING_WHITESPACE OUTPUT_VARIABLE nanobind_ROOT)
+find_package(nanobind CONFIG REQUIRED)
+
+# Find libelf and libdw via pkg-config
+find_package(PkgConfig REQUIRED)
+pkg_check_modules(LIBELF REQUIRED libelf)
+pkg_check_modules(LIBDW REQUIRED libdw)
+
+# Add the extension module subdirectory
+add_subdirectory(src/pystack/_pystack)

{pystack-1.5.1 → pystack-1.7.0}/MANIFEST.in

@@ -3,7 +3,6 @@ exclude CONTRIBUTING.md
 exclude Dockerfile
 exclude src/pystack/*.cpp
 exclude src/pystack/*.h
-exclude requirements-*.txt
 exclude tox.ini
 exclude valgrind.supp
 

{pystack-1.5.1 → pystack-1.7.0}/NEWS.rst

@@ -8,6 +8,44 @@ Changelog
 
 .. towncrier release notes start
 
+pystack 1.7.0 (2026-07-09)
+--------------------------
+
+Features
+~~~~~~~~
+
+- Replace Cython with nanobind for Python bindings, improving performance by eliminating round-trips between Python and C++. (#272)
+- Add :ref:`support for Python subinterpreters <multiple-interpreters>`. When a process uses multiple interpreters (e.g. via Python 3.14's `concurrent.interpreters` module), stacks for all interpreters are now reported instead of just the main one. (#279)
+- Python 3.15 is now supported. The wheels are not yet published because the ABI is not yet frozen. (#289)
+- PyStack is now built against elfutils 0.195, up from 0.193. (#315)
+
+
+Bug Fixes
+~~~~~~~~~
+
+- Fix compatibility with the Python 3.14 JIT compiler. (#277)
+- Fix native mode stacks for Python 3.14's LLVM-generated ``*_TAIL_CALL_*`` frames. (#277)
+- Fix ``IndexError`` in traceback formatting when the source file has fewer lines than expected. (#191)
+- Fix an extra blank line sometimes being printed in the middle of a traceback. (#298)
+
+
+pystack 1.6.0 (2026-01-25)
+--------------------------
+
+Features
+~~~~~~~~
+
+- Provide wheels for free-threaded builds of Python 3.13 (#271)
+- Add the Python 3.14 trove classifier to our package metadata (#269)
+- Improve some error messages and log messages (#260, #258)
+
+
+Bug Fixes
+~~~~~~~~~
+
+- Fix handling of duplicate ``_PyRuntime`` symbols when ctypes mmaps a statically linked Python interpreter's binary in order to create a trampoline. Previously this led to "Invalid address in remote process" errors. (#258)
+
+
 pystack 1.5.1 (2025-08-18)
 --------------------------
 

{pystack-1.5.1 → pystack-1.7.0}/PKG-INFO

@@ -1,31 +1,24 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.2
 Name: pystack
-Version: 1.5.1
+Version: 1.7.0
 Summary: Analysis of the stack of remote python processes
-Home-page: https://github.com/bloomberg/pystack
 Author: Pablo Galindo Salgado
+License: Apache-2.0
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Debuggers
-Requires-Python: >=3.7.0
+Project-URL: Homepage, https://github.com/bloomberg/pystack
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-Dynamic: summary
 
 <p align="center">
 <img src="https://user-images.githubusercontent.com/11718525/226942590-de015c9a-4d5b-4960-9c42-8c1eac0845c1.png" width="70%">
@@ -57,6 +50,7 @@ PyStack has the following amazing features:
 - 🧵 Shows if each thread currently holds the Python GIL, is waiting to acquire it, or is currently
   dropping it.
 - 🗑️ Shows if a thread is running a garbage collection cycle.
+- 🪆 Reports on multiple interpreters in the same process.
 - 🐍 Optionally shows native function calls, as well as Python ones. In this mode, PyStack prints
   the native stack trace (C/C++/Rust function calls), except that the calls to Python callables are
   replaced with frames showing the Python code being executed, instead of showing the internal C
@@ -113,18 +107,17 @@ cd pystack
 python3 -m venv ../pystack-env/  # just an example, put this wherever you want
 source ../pystack-env/bin/activate
 python3 -m pip install --upgrade pip
-python3 -m pip install -e .
-python3 -m pip install -r requirements-test.txt -r requirements-extra.txt
+python3 -m pip install -e . --group test --group extra
 ```
 
 This will install PyStack in the virtual environment in development mode (the `-e` of the last
 `pip install` command), and then install the Python libraries needed to test it, lint it, and
 generate its documentation.
 
-If you plan to contribute back, you should install the pre-commit hooks:
+If you plan to contribute back, you should install the prek (pre-commit) hooks:
 
 ```shell
-pre-commit install
+prek install
 ```
 
 This will ensure that your contribution passes our linting checks.
@@ -307,3 +300,5 @@ You must use your real name (sorry, no pseudonyms, and no anonymous contribution
 - Submit the Issue.
 - Submit a Pull Request and link it to the Issue by including "#<issue number>" in the Pull Request
   summary.
+
+Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for more info.

{pystack-1.5.1 → pystack-1.7.0}/README.md

@@ -28,6 +28,7 @@ PyStack has the following amazing features:
 - 🧵 Shows if each thread currently holds the Python GIL, is waiting to acquire it, or is currently
   dropping it.
 - 🗑️ Shows if a thread is running a garbage collection cycle.
+- 🪆 Reports on multiple interpreters in the same process.
 - 🐍 Optionally shows native function calls, as well as Python ones. In this mode, PyStack prints
   the native stack trace (C/C++/Rust function calls), except that the calls to Python callables are
   replaced with frames showing the Python code being executed, instead of showing the internal C
@@ -84,18 +85,17 @@ cd pystack
 python3 -m venv ../pystack-env/  # just an example, put this wherever you want
 source ../pystack-env/bin/activate
 python3 -m pip install --upgrade pip
-python3 -m pip install -e .
-python3 -m pip install -r requirements-test.txt -r requirements-extra.txt
+python3 -m pip install -e . --group test --group extra
 ```
 
 This will install PyStack in the virtual environment in development mode (the `-e` of the last
 `pip install` command), and then install the Python libraries needed to test it, lint it, and
 generate its documentation.
 
-If you plan to contribute back, you should install the pre-commit hooks:
+If you plan to contribute back, you should install the prek (pre-commit) hooks:
 
 ```shell
-pre-commit install
+prek install
 ```
 
 This will ensure that your contribution passes our linting checks.
@@ -278,3 +278,5 @@ You must use your real name (sorry, no pseudonyms, and no anonymous contribution
 - Submit the Issue.
 - Submit a Pull Request and link it to the Issue by including "#<issue number>" in the Pull Request
   summary.
+
+Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for more info.

pystack-1.7.0/news/.gitignore

@@ -0,0 +1 @@
+!.gitignore

{pystack-1.5.1 → pystack-1.7.0}/pyproject.toml

@@ -1,19 +1,88 @@
 [build-system]
+requires = ["scikit-build-core>=0.4", "nanobind>=1.8"]
+build-backend = "scikit_build_core.build"
 
-requires = [
-     "setuptools",
-     "wheel",
-     "Cython",
-     "pkgconfig"
+[project]
+name = "pystack"
+dynamic = ["version"]
+description = "Analysis of the stack of remote python processes"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "Apache-2.0"}
+authors = [
+    {name = "Pablo Galindo Salgado"}
+]
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Topic :: Software Development :: Debuggers",
+]
+
+[dependency-groups]
+docs = [
+    "recommonmark",
+    "sphinx",
+    "sphinx-autobuild",
+    "sphinx-argparse",
+    "furo",
+]
+extra = [
+    "mypy",
+    "bump2version",
+    "towncrier",
+    "prek",
+    {include-group = "docs"},
+]
+test = [
+    "coverage[toml]",
+    "pyinstaller",
+    "pytest",
+    "pytest-cov",
+    "pytest-xdist",
+    "setuptools",
 ]
 
-build-backend = 'setuptools.build_meta'
+[project.urls]
+Homepage = "https://github.com/bloomberg/pystack"
+
+[project.scripts]
+pystack = "pystack.__main__:main"
+
+[tool.scikit-build]
+wheel.packages = ["src/pystack"]
+wheel.install-dir = "pystack"
+wheel.exclude = ["pystack/_pystack/**"]
+metadata.version.provider = "scikit_build_core.metadata.regex"
+metadata.version.input = "src/pystack/_version.py"
+sdist.include = ["src/pystack/_version.py"]
+sdist.exclude = [
+  ".devcontainer/**",
+  ".github/**",
+  ".vscode/**",
+  "CONTRIBUTING.md",
+  "Dockerfile",
+  "docs/**",
+  "tests/**",
+  "uv.lock",
+]
+
+[tool.scikit-build.cmake.define]
+CMAKE_BUILD_TYPE = "Release"
 
 [tool.ruff]
 line-length = 95
-select = ["F", "E", "W", "I001"]
+lint.select = ["F", "E", "W", "I001"]
 
-[tool.ruff.isort]
+[tool.ruff.lint.isort]
 force-single-line = true
 known-first-party = ["pystack"]
 known-third-party=["rich", "elftools", "pytest"]
@@ -43,7 +112,7 @@ type = [
 underlines = "-~"
 
 [tool.cibuildwheel]
-build = ["cp38-*", "cp39-*", "cp310-*", "cp311-*"]
+build = ["cp39-*", "cp310-*", "cp311-*", "cp312-*", "cp313-*", "cp314-*"]
 manylinux-x86_64-image = "manylinux2014"
 manylinux-i686-image = "manylinux2014"
 musllinux-x86_64-image = "musllinux_1_2"
@@ -51,14 +120,15 @@ skip = "*-musllinux_aarch64"
 
 [tool.cibuildwheel.linux]
 before-all = [
-  "yum install -y libzstd-devel",
+  "yum install -y libzstd-devel cmake",
+  "yum install -y devtoolset-10-make || true",  # Install a new enough GNU make on manylinux2014
   "cd /",
-  "VERS=0.193",
+  "VERS=0.195",
   "curl https://sourceware.org/elfutils/ftp/$VERS/elfutils-$VERS.tar.bz2 > ./elfutils.tar.bz2",
   "tar -xf elfutils.tar.bz2",
   "cd elfutils-$VERS",
   "CFLAGS='-Wno-error -g -O3' CXXFLAGS='-Wno-error -g -O3' ./configure --disable-nls --enable-libdebuginfod=dummy --disable-debuginfod --with-zstd",
-  "make install"
+  'PATH="/opt/rh/devtoolset-10/root/usr/bin/:$PATH" make install',  # Ensure we pick up gnu make 4.x on manylinux2014
 ]
 
 # Override the default linux before-all for musl linux
@@ -74,8 +144,8 @@ before-all = [
   # set the FNM_EXTMATCH macro to get the build to succeed is seen here:
   # https://git.alpinelinux.org/aports/tree/main/elfutils/musl-macros.patch
   "cd /",
-  "apk add --update argp-standalone bison bsd-compat-headers bzip2-dev flex-dev libtool linux-headers musl-fts-dev musl-libintl musl-obstack-dev xz-dev zlib-dev zstd-dev",
-  "VERS=0.193",
+  "apk add --update argp-standalone bison bsd-compat-headers bzip2-dev flex-dev libtool linux-headers musl-fts-dev musl-libintl musl-obstack-dev xz-dev zlib-dev zstd-dev cmake",
+  "VERS=0.195",
   "curl https://sourceware.org/elfutils/ftp/$VERS/elfutils-$VERS.tar.bz2 > ./elfutils.tar.bz2",
   "tar -xf elfutils.tar.bz2",
   "cd elfutils-$VERS",
@@ -88,16 +158,12 @@ before-all = [
 ]
 
 [tool.coverage.run]
-plugins = [
-  "Cython.Coverage",
-]
 source = [
   "src/pystack",
 ]
 branch = true
 parallel = true
 omit = [
-  "stringsource",
   "tests/integration/*program*.py",
 ]
 

{pystack-1.5.1 → pystack-1.7.0}/src/pystack/__init__.py

@@ -1,7 +1,7 @@
 from ._version import __version__
-from .traceback_formatter import print_thread
+from .traceback_formatter import print_threads
 
 __all__ = [
     "__version__",
-    "print_thread",
+    "print_threads",
 ]