PyPI · #1077 most downloaded on PyPI

griffecli

2.3.012M downloads/moNew releases in your daily digest, changelog included.

Signatures for entire Python programs. Extract the structure, the frame, the skeleton of your project, to generate API documentation or find breaking changes in your API.

Last release 1 months ago
04 Sep 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 6 of 6 stable releases
Nothing withdrawn
no release was ever pulled
7 months old
6 releases · first in 2026

Release timeline

6 releases since 2026

2026

20262026

One column per month.

Releases

2.3.04 Sept 2026
Add option to give precedence to docstrings in stubs vs. source (09a2a13 by Timothée Mazzucotelli). Issue-447, PR-481
Compare with 2.2.0

Features

Add option to give precedence to docstrings in stubs vs. source (09a2a13 by Timothée Mazzucotelli). Issue-447, PR-481

Bug Fixes

Preserve nested tuple parentheses (e095a7c by Alperen). PR-487, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr

Preserve nested f-string format specs (38921b7 by Alperen). PR-486

Disable all docstring warnings when passing warnings=False (5cb0ae2 by Timothée Mazzucotelli).

Performance Improvements

Reuse computed parent in is_imported (092ac31 by Timothée Mazzucotelli).

Only build debug messages at debug level (8f05a4a by Timothée Mazzucotelli).

Avoid creating new sets when handling labels (06cd02e by Timothée Mazzucotelli).

Maintain map of AST node type to visitor function (e21851e by Timothée Mazzucotelli).

Avoid cyclic refs in ASTs to allow garbage-collecting them (b968de0 by Timothée Mazzucotelli).

Cache per-module path-related properties during serialization (8bd6cc4 by Timothée Mazzucotelli).

Do not fire load events when no extension has hooked them (0e2ae7c by Timothée Mazzucotelli).

Compute costly message lazily in alias resolution errors (1e391b8 by Timothée Mazzucotelli).

Avoid iterating many times over function parameters when merging stubs (03cae74 by Timothée Mazzucotelli).

Avoid iterating many times over function parameters when diff'ing (d3cf2c4 by Timothée Mazzucotelli).

Improve efficiency of AST parameter extraction (1e37cd4 by Timothée Mazzucotelli).

Cache serializable expression fields (f9e48c1 by Timothée Mazzucotelli).

Use maps to make JSON encoder faster (b7de96f by Timothée Mazzucotelli).

Avoid recomputing inherited members when diff'ing (a29e028 by Timothée Mazzucotelli).

Make Google, Numpy and Sphinx docstring parsers faster (7f39373 by Timothée Mazzucotelli).

Pre-compile patterns for docstring style detection (ad58ad5 by Timothée Mazzucotelli).

LRU-cache parsing of type annotations in docstrings (1671e59 by Timothée Mazzucotelli).

2.2.016 Aug 2026

Support await expressions (6b3caab by Vincent Gao). PR-479

Compare with 2.1.0

Features

Support await expressions (6b3caab by Vincent Gao). PR-479
Support unpacking in dict comprehensions (2d39391 by mushitoriami). PR-475

Bug Fixes

Forward warn_missing_types to Sphinx return section reader (a15e782 by Timothée Mazzucotelli). Issue-mkdocstrings-python-337
Make stringified expressions valid and faithful Python (eb85f0d by Vincent Gao). PR-478
Empty tuples can never be implicit (82e728d by Vincent Gao). PR-474, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr
Render f-strings and t-strings with correct quote delimiters (90e28d4 by Bartosz Sławecki). Issue-444, PR-455
Detect basic admonitions 'example', 'note' and 'warning' in Google/Numpy docstrings when inferring style (f30306f by Timothée Mazzucotelli).
Render dict **-unpacking as **value instead of None: value (74ddbbf by Vincent Gao). PR-467

Open source →

2.1.019 Jun 2026

Add tests to source distributions for griffecli and griffelib packages. Issue-452

Compare with 2.0.2

Build

Add tests to source distributions for griffecli and griffelib packages. Issue-452

Features

Add logging format for Azure Devops (82526e4 by Carsten Igel). PR-457, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr

Bug Fixes

Rename tests module to avoid exclusion by packagers (5b3e392 by Timothée Mazzucotelli). Issue-461
Don't try merging overload annotations into non-function objects (1b6b053 by Timothée Mazzucotelli). Issue-451

Open source →

2.0.09 Feb 2026Deprecated

This version removes previously deprecated API:

Compare with 1.15.0

Breaking Changes

This version removes previously deprecated API:

ExportedName: Public object was removed
infer_docstring_style(options): Parameter was removed
parse_auto(options): Parameter was removed
parse_google(options): Parameter was removed
parse_numpy(options): Parameter was removed
parse_sphinx(options): Parameter was removed
assert_git_repo: Public object was removed
get_latest_tag: Public object was removed
get_repo_root: Public object was removed
tmp_worktree: Public object was removed

Features

Support merging overload annotations into implementation (584cdb5 by Timothée Mazzucotelli). Issue-442, PR-443
Add support for PEP 750 template strings (59266a9 by ellie). PR-440

Bug Fixes

Keep newlines in parameter (and other multiline directives) descriptions in Sphinx docstrings (1fde0d2 by Timothée Mazzucotelli). Issue-mkdocstrings-808, PR-438

Code Refactoring

Make griffe imports lazy in CLI (4772456 by Timothée Mazzucotelli).
Split to griffe, griffecli and griffelib uv workspaces (162c31c by Bartosz Sławecki). Issue-408, PR-434, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr
Remove deprecated code (dcb075e by Bartosz Sławecki). PR-433, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr

Build

Declare tag pattern for uv-dynamic-versioning (no v prefix) (c869c97 by Timothée Mazzucotelli). Upstream-issue
Change build system to hatchling (09b0682 by Bartosz Sławecki). PR-430

Open source →

griffecli

Release timeline

Releases

Features

Bug Fixes

Performance Improvements

Features

Bug Fixes

Build

Features

Bug Fixes

Build

Bug Fixes

Breaking Changes

Features

Bug Fixes

Code Refactoring

Build