PyPI · #4484 most downloaded on PyPI

pybind11-stubgen

3.0.0799K downloads/mopybind/pybind11-stubgen ↗New releases in your daily digest, changelog included.

PEP 561 type stubs generator for pybind11 modules

Last release 9 days ago
25 Sep 2026
Ships unpredictably
gaps range from 8 days to 1.1 years
Some releases are documented
notes for 27 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
79 releases · first in 2019

Release timeline

79 releases since 2019

20192020202120222023202420252026

Releases

3.0.025 Sept 20262 sources agree
Maintainership has passed from @sizmailov to @ax3l , @skarndev , and @virtuald , and the repository has been transferred to the pybind11 organization.
Maintainership has passed from @sizmailov to @ax3l, @skarndev, and @virtuald,
and the repository has been transferred to the pybind11 organization.
Many thanks to @sizmailov for creating pybind11-stubgen and maintaining it over the years!

Breaking changes:

❗️ Require Python 3.10 or newer; drop support for Python 3.7–3.9 (#284, #285) by @ax3l and @gentlegiantJGC

❗️ Disable # value = ... comments by default; use --print-value-comments to restore them (#251) by @dyollb and @ax3l

Changes:

✨ Support generating stubs for multiple modules in a single CLI invocation (#292) by @birgerbr

✨ Add basic support for PEP 695 function type parameters in docstring signatures on Python 3.12+;
class type parameters, variadics, and constraints are not supported (#291) by @gentlegiantJGC

✨ Preserve docstrings for static properties exposed as fields, with Python 3.12+ and pybind11 2.10.1+ (#308) by @markuspi

🐛 Order classes by dependencies rather than alphabetically, so base classes and class-body references
appear before their dependents, including nested classes (#238)
by @ax3l, @juelg, @daltairwalter, @skarndev, and @sizmailov

🐛 Fix nested qualified names in pybind11 docstring signatures (#280) by @ax3l, @gentlegiantJGC, @sarlinpe, and @skarndev

🐛 Strip current-module prefixes from nested type annotations and correctly parse runtime generic annotations (#301) by @ax3l

🐛 Resolve hidden builtin types, such as mappingproxy, to their importable names in types (#278) by @skarndev and @ax3l

🐛 Filter internal members of pybind11 native enums (#303) by @ax3l

🐛 Avoid RuntimeError: dictionary changed size during iteration when attribute access modifies a class dictionary (#310) by @htruscott

🐛 Make ordering of aliased and non-aliased imports deterministic (#293) by @cjwatson

🐛 Remove unstable memory addresses from additional object representations, including WeakKeyDictionary (#295) by @ax3l

🐛 Remove leading newlines from docstrings to avoid extra blank lines in generated stubs (#274) by @gentlegiantJGC

Development:

🔧 Move package metadata from setup.py to pyproject.toml (#281) by @gentlegiantJGC

🔧 Add pybind11 3.0 test coverage and update expected stubs for pybind11 3.0.3 (#289, #296) by @gentlegiantJGC and @ax3l

🔧 Add local test-stub regeneration via tox and fix demo builds on Clang/macOS (#287) by @skarndev and @ax3l

🔧 Modernize CI and publishing, migrate development tooling to uv and Ruff, and automate pre-commit updates (#279, #283, #290, #307, #314)
by @virtuald, @gentlegiantJGC, @skarndev, and @ax3l

One column per quarter.

2.5.59 Aug 20252 sources agree

🐛 Fix the type annotation for __all__ ( #261 ) by @sarlinpe

Changes:

🐛 Fix the type annotation for __all__ (#261) by @sarlinpe
🐛 Handle boolean numpy arrays (#260) by @sarlinpe
🐛 Fix qualname prefix in pybind11 3.0.0 (#259) by @gentlegiantJGC

Open source →

2.5.414 May 20252 sources agree

✨ Add argv to main() to simplify use as a library ( #252 ) by @gentlegiantJGC

Changes:

✨ Add argv to main() to simplify use as a library (#252) by @gentlegiantJGC
🐛 Improve package detection (#253) by @gentlegiantJGC

Open source →

2.5.324 Feb 20252 sources agree

✨ Ignore technical dunder Python 3.13 fields ( __static_attributes__ and __firstlineno__ ): ( #243 ) by @nim65s

Changes:

✨ Ignore technical dunder Python 3.13 fields (__static_attributes__
and __firstlineno__): (#243) by @nim65s
🔧 CI: Drop Python 3.7, add Python 3.13 (#243) by @nim65s

Open source →

Additional notes

Changes:

✨ Ignore technical dunder Python 3.13 fields (__static_attributes__ and __firstlineno__): (https://github.com/sizmailov/pybind11-stubgen/pull/243) by @nim65s
🔧 CI: Drop Python 3.7, add Python 3.13 (https://github.com/sizmailov/pybind11-stubgen/pull/243) by @nim65s

Open source →

2.5.129 Mar 20242 sources agree

Changes: 🐛 Fixed: Missed numpy unsigned int types ( #219 ) by @Yc7521

Changes:
🐛 Fixed: Missed numpy unsigned int types (#219) by @Yc7521

Open source →

2.55 Mar 20242 sources agree

🐛 Fixed: Don't render pybind11 KeysView, ValuesView, ItemsView class definitions (#211) 🐛 Fixed: Escape backslashes in stub output

🐛 Fixed: Don't render pybind11 KeysView, ValuesView, ItemsView class definitions (#211)
🐛 Fixed: Escape backslashes in stub output (#208)

Open source →

2.4.227 Nov 20232 sources agree

🔁 Revert #196 due to poor review

Changes:

🔁 Revert #196 due to poor review

Open source →

2.4.125 Nov 20232 sources agree

✨ Automatically replace invalid enum expressions with corresponding valid expression & import (#196) contributed by @ringohoffman

Version 2.4.1 (Nov 25, 2023)

Changes:

✨ Automatically replace invalid enum expressions with corresponding valid expression & import (#196) contributed by @ringohoffman
🐛 Fixed: do not remove self parameter annotation when types do not match (#195) contributed by @ringohoffman

Open source →

2.421 Nov 20232 sources agree

✨ Added --numpy-array-use-type-var flag which reformats the pybind11-generated numpy.ndarray[numpy.float32[m, 1]] annotation as numpy.ndarray[tuple[M,

Changes:

✨ Added --numpy-array-use-type-var flag which reformats the pybind11-generated numpy.ndarray[numpy.float32[m, 1]]
annotation as numpy.ndarray[tuple[M, Literal[1]], numpy.dtype[numpy.float32]] contributed by @ringohoffman (#188)

Open source →

2.3.718 Nov 20232 sources agree

🐛 fix: Handle top-level list-like annotations as types

Changes:

🐛 fix: Handle top-level list-like annotations as types (#183)

Open source →

2.3.624 Oct 20232 sources agree

🐛 fix: Missing py::dtype translation

Changes:

🐛 fix: Missing py::dtype translation (#179)

Open source →

2.3.524 Oct 20232 sources agree

🐛 fix: Wrong import for lowercase buffer (#175), issue

Changes:

🐛 fix: Wrong import for lowercase buffer (#175), issue (#173)

Open source →

2.3.423 Oct 20232 sources agree

🐛 fix: Misleading warning that referred to ignored errors

Changes:

🐛 fix: Misleading warning that referred to ignored errors (#171)

Open source →

2.3.322 Oct 20232 sources agree

🐛 fix: The typing.Annotated does not exist in python < 3.9, use typing_extensions

Changes:

🐛 fix: The typing.Annotated does not exist in python < 3.9, use typing_extensions (#168)

Open source →

2.3.221 Oct 2023

🐛 fix: Missing function name in error message

Changes:

🐛 fix: Missing function name in error message (#165)

Open source →

2.3.121 Oct 20232 sources agree

🐛 fix: Crash on None-valued docstring of property getter

Changes:

🐛 fix: Crash on None-valued docstring of property getter (#161)

Open source →

2.327 Sept 20232 sources agree

🐛 fix: Inconsistent --enum-class-locations behaviour

Changes:

🐛 fix: Inconsistent --enum-class-locations behaviour (#158)

Open source →

2.2.226 Sept 2023

🐛 fix: Missing -? in eum representation regex

Changes:

🐛 fix: Missing -? in eum representation regex

Open source →

2.2.123 Sept 20232 sources agree

📝 Update --print-invalid-expressions-as-is description

Changes:

📝 Update --print-invalid-expressions-as-is description

Open source →

2.220 Sept 20232 sources agree

🐛 Fix: Python literals as default arg rendered as ...

Changes:

🐛 Fix: Python literals as default arg rendered as ... (#147)
✨ Add --print-safe-value-reprs=REGEX CLI option to override the print-safe flag of Value (for custom default value representations provided via pybind11::arg_v()) (#147)
✨ Add --enum-class-locations=REGEX:LOC CLI option to rewrite enum values as valid Python expressions with correct imports. (#147)

⚠️ This release detects more invalid expressions in bindings code. Previously, Enum-like representations (e.g., <MyEnum.Zero: 0>) were always treated as non-printable values and were rendered as .... The invalid expressions should be acknowledged by --enum-class-locations or --ignore-invalid-expressions.

Open source →

2.16 Sept 20232 sources agree

✨ Add --stub-extension CLI option

Changes:

✨ Add --stub-extension CLI option (#142)

Open source →

2.0.24 Sept 20232 sources agree

🐛 Fix: missing isinstance check

Changes:

🐛 Fix: missing isinstance check (#138)

Open source →

2.0.12 Sept 20232 sources agree

🐛 Fix: missing subdirectories for top-level submodules

Changes:

🐛 Fix: missing subdirectories for top-level submodules (#136)

Open source →

2.01 Sept 20232 sources agree

🐛 Explicitly set encoding of stubs to utf-8

Changes:

🐛 Explicitly set encoding of stubs to utf-8 (#133)
🐛 Fix value representation for collections with print-unsafe elements (#132)
🐛 Fix missing remap of numpy.ndarray.flags (#128)
✨ Process scipy.sparse.* types the same as numpy.ndarray with --numpy-array-wrap-with-annotated (#128)
✨ Support dynamic array size with --numpy-array-wrap-with-annotated (#128)
❗️ Renamed CLI argument --numpy-array-wrap-with-annotated-fixed-size to --numpy-array-wrap-with-annotated (#128)

Open source →

2.0.dev11 Sept 2023pre-release2 sources agree

🐛 Fix missing remap of numpy.ndarray.flags

Changes:

🐛 Fix missing remap of numpy.ndarray.flags (#128)
✨ Process scipy.sparse.* types the same as numpy.ndarray with --numpy-array-wrap-with-annotated (#128)
✨ Support dynamic array size with --numpy-array-wrap-with-annotated (#128)
❗️ Renamed CLI argument --numpy-array-wrap-with-annotated-fixed-size to --numpy-array-wrap-with-annotated (#128)

Open source →

1.231 Aug 20232 sources agree

🐛 Fix compatibility with Python 3.7..3.9

Changes:

🐛 Fix compatibility with Python 3.7..3.9 (#124)
🐛 Fix incorrect list of base classes (#123)
✨ Replace typing collections with builtin types (e.g. typing.List -> list) according to PEP 585 (#122)
✨ Add missing translations of pybind types: function -> Callable, object/handle -> typing.Any (#121)
✨ Support function-valued default arguments (#119)
🐛 Fix missing properties docstrings (#118)

Open source →

1.130 Aug 20232 sources agree

Added --dry-run CLI option to skip writing stubs stage

Changes:

Added --dry-run CLI option to skip writing stubs stage (#114 )

Open source →

1.030 Aug 2023

The project was rewritten from scratch for 1.0.

The project was rewritten from scratch for 1.0.

Changes:

Updated CLI interface, some options were removed, please see pybind11-stubgen --help for details
Replaced regex-based signature parsing with more robust procedure which enables to produce partially degraded signatures
Added type parsing/replacing, including deeply annotated types
Support implicit imports required for static analysis
Add introspection of pure python functions
Improved structure of test binary pybind module

Open source →

1.0.dev129 Aug 2023pre-release

⚠️ Project was rewritten from scratch for 1.x.

⚠️ Project was rewritten from scratch for 1.x.

Changes:

Updated CLI interface, some options were removed, please see pybind11-stubgen --help for details
Replaced regex-based signature parsing with more robust procedure which enables to produce partially degraded signatures
Added type parsing/replacing, including deeply annotated types
Support implicit imports required for static analysis
Add introspection of pure python functions
Improved structure of test binary pybind module

Open source →

0.16.215 Jul 2023