[agntcy-automation]

This PR contains the following updates:

Package	Change	Age	Confidence
griffe (changelog)	==1.7.2 → ==1.15.0
griffe-pydantic (changelog)	==1.1.4 → ==1.3.2
mkdocs-llmstxt (changelog)	==0.5.0 → ==0.5.1
mkdocstrings-python (changelog)	==1.16.10 → ==1.19.0

---

Release Notes

mkdocstrings/griffe (griffe)

v1.15.0

Compare Source

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

v1.14.0

Compare Source

Compare with 1.14.0

Features

• Prefer stub over target object if not the same kind (196bcf4 by Kattni). Discussion-mkdocstrings-803, PR-422
• Parse keywords in class declarations (0709f0d by Timothée Mazzucotelli).
• Support unpacking typed dicts in signatures and docstrings (60cbb5f by Timothée Mazzucotelli). Issue-mkdocstrings-python-207, Issue-284
• Support checking packages from PyPI directly (e04a5cf by Timothée Mazzucotelli).
• Support expression modernization (4ae5d25 by Timothée Mazzucotelli).
• Support auto docstring style (infer from docstring) (4d0a9ee by Timothée Mazzucotelli).

Bug Fixes

• Make type aliases available at runtime (9debb52 by sgt). Discussion-425, PR-426
• Fix loading namespace packages from JSON (3cccf27 by Bartosz Sławecki). Issue-407, PR-413
• Catch error when computing relative filepath for serialization (92a23d4 by Timothée Mazzucotelli).
• Defer creating module finder until first load (c52dd22 by Bartosz Sławecki). Issue-410, PR-411, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr
• Always return a string or None from ObjectNode.module_path (06c2f2f by Frank David Martínez M). PR-419, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr
• Don't add parentheses around comprehension target (implicit) tuple (cbdb6a9 by Timothée Mazzucotelli). Issue-mkdocstrings-python-311
• Add missing space in dictionary comprehension (3a6dc36 by Nicolas IOOSS). Issue-mkdocstrings-python-311, PR-420
• Do not ignore stderr in case there is a problem in a git call. (#​416) (9a5d014 by Muhammet Soytürk). Issue-415, PR-416

Code Refactoring

• Update code base for Python 3.10 (37aaf06 by Timothée Mazzucotelli).
• Improve handling of typed dicts (5bed1be by Timothée Mazzucotelli). Issue-284, Issue-mkdocstrings-python-207, PR-414
• Reuse private method to append search path to reduce code duplication (0a82cf5 by Timothée Mazzucotelli).
• Don't produce an empty text section when "parsing" an empty unstyled docstring (90bd71c by Timothée Mazzucotelli).
• Don't produce empty text section when parsing an empty Google-style docstring (1cbf2a3 by Timothée Mazzucotelli).
• Use plain ANSI codes, don't import them from Colorama (90978b4 by Timothée Mazzucotelli).

v1.13.0

Compare Source

Compare with 1.13.0

Deprecations

• The on_alias event's signature changed from on_alias(self, *, node: AST | ObjectNode, alias: Alias, agent: Visitor | Inspector, **kwargs) (an [analysis event][analysis-events]) to on_alias(self, *, alias: Alias, loader: GriffeLoader, **kwargs) ([a load event][load-events]). Use the new signature, or rename your method to on_alias_instance to keep the old signature (on_alias_instance is a new analysis event that replaces the old on_alias one). Backward compatibility is maintained until next major version.
• The on_wildcard_expansion event is deprecated. Instead, use the on_alias event, and check the [wildcard_imported][griffe.Alias.wildcard_imported] boolean attribute of aliases.
• The on_package_loaded event is renamed to on_package. Backward compatibility is maintained until next major version.
• The use of previously exposed Git-related utilities (assert_git_repo, get_repo_root, get_latest_tag and tmp_worktree) is deprecated, as they are not a core part of the library's functionality. These utilities are now part of our internal API.

Features

• Add analysis attribute on objects and aliases, telling whether they were loaded through static or dynamic analysis, or created manually (d792a56 by Timothée Mazzucotelli).
• Expose Git info in objects, allowing to compute a new source_link property (see [Source information][source-information] in our docs) (2a8d824 by Timothée Mazzucotelli). Issue-361, Issue-mkdocstrings-python-253
• Add wildcard_imported boolean attribute to aliases, deprecate on_wildcard_expansion event (821300d by Timothée Mazzucotelli).
• Add load events that run once a tree is fully constructed, matching analysis events but safer to hook onto (see [Load events][load-events] in our docs) (77f928a by Timothée Mazzucotelli). Issue-346

Code Refactoring

• Provide typed dicts for docstring options (945880a by Timothée Mazzucotelli). Issue-370
• Allow parenthesized type to be glued (no space) to parameter name in Google-style docstrings (4b6f939 by Timothée Mazzucotelli). Issue-375
• Improve deprecation warnings for on_alias and on_package_loaded (d3e50db by Timothée Mazzucotelli).

v1.12.1

Compare Source

Compare with 1.12.1

Features

• Add is_init_method property (5417b70 by Timothée Mazzucotelli).

Bug Fixes

• Increase maximum recursion limit when calling as a CLI (5f0d9e6 by Timothée Mazzucotelli). Issue-402

v1.12.0

Compare Source

Compare with 1.12.0

Code Refactoring

• Reduce size of JSON dumps by removing keys with null values (58227eb by Timothée Mazzucotelli). Issue-403
• Add fields to aliases when serializing (5c9fee2 by Timothée Mazzucotelli).
• Also add the option to ignore missing type to the Sphinx parser (8c9f803 by Timothée Mazzucotelli).

v1.11.1

Compare Source

Compare with 1.11.1

Features

• Allow disabling "missing type/annotation" warnings (07564b4 by Timothée Mazzucotelli). Issue-mkdocstrings-437

v1.11.0

Compare Source

Compare with 1.11.0

Bug Fixes

• Fix type parameters loading (ce41279 by Timothée Mazzucotelli).

Code Refactoring

• Move private _griffe package under griffe._internal (8f37158 by Timothée Mazzucotelli).

v1.10.0

Compare Source

Compare with 1.10.0

Features

• Add data to dict/json output (9731afc by Timothée Mazzucotelli).

v1.9.0

Compare Source

Compare with 1.9.0

Features

• Allow adding sys.path to search paths when temporary visiting/inspecting package (42983bc by Timothée Mazzucotelli).

v1.8.0

Compare Source

Compare with 1.8.0

Features

• Support PEP 695 generics (be28e9c by Victor Westerhuis). Issue-342, PR-348, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr

v1.7.3

Compare Source

Compare with 1.7.3

Features

• Add method to functions and classes to build and return a stringified signature (8ef1486 by ISOREX). Discussion-376, PR-381, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr
• Enhance Sphinx-style parameter parsing to handle invalid type info (cbce5a2 by Edouard Choinière). PR-396
• Parse Sphinx parameter types as expressions (70dda21 by Edouard Choinière). PR-392

Bug Fixes

• Avoid SyntaxError when loading modules encoded in UTF8 with BOM (b346190 by John Hennig). Issue-386, PR-387, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr
• Correctly parenthesize expressions (a8c5585 by Abraham Cheung). PR-389, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr

Code Refactoring

• Be more consistent regarding not overriding submodules with aliases (be1963c by Timothée Mazzucotelli).
• Allow ExprName.parent to be of type griffe.Function (acafbd8 by Edouard Choinière). Issue-391, PR-395
• Normalize labels for attributes (1b376cd by Timothée Mazzucotelli).

mkdocstrings/griffe-pydantic (griffe-pydantic)

v1.3.2

Compare Source

Compare with 1.3.1

Build

• Drop support for Python 3.10 (68d824a by Timothée Mazzucotelli).

Bug Fixes

• Support fields defined via typing_extensions.Annotated (2c701f9 by Ilya Siamionau). PR-58

v1.3.1

Compare Source

Compare with 1.3.1

Build

• Drop support for Python 3.10 (68d824a by Timothée Mazzucotelli).

Bug Fixes

• Support fields defined via typing_extensions.Annotated (2c701f9 by Ilya Siamionau). PR-58

v1.3.0

Compare Source

Compare with 1.3.0

Build

• Depend on griffelib instead of griffe (b4ad01b by Timothée Mazzucotelli).

v1.2.0

Compare Source

Compare with 1.2.0

Features

• Support dedent/cleandoc for Field description (ab6c0dc by Christopher Barber). Issue-50, PR-52
• Support Pydantic's PrivateAttr (9491921 by Daniel Gafni). Issue-43, PR-49

v1.1.8

Compare Source

Compare with 1.1.8

Features

• Support Pydantic Field defined via Annotated (5021332 by Michele Dolfi). Issue-37, PR-46

v1.1.7

Compare Source

Compare with 1.1.7

Bug Fixes

• Don't process module aliases (all modules eventually get processed) (87ab586 by Timothée Mazzucotelli). Issue-45
• Prevent crashes while computing JSON schemas (ec1b424 by Timothée Mazzucotelli).

v1.1.6

Compare Source

Compare with 1.1.6

Build

• Depend on Griffe 1.14 (08f955c by Timothée Mazzucotelli).

v1.1.5

Compare Source

Compare with 1.1.5

Bug Fixes

• Make Pydantic imports lazy (5df7a47 by Timothée Mazzucotelli). Issue-39

pawamoy/mkdocs-llmstxt (mkdocs-llmstxt)

v0.5.1

Compare Source

Compare with 0.5.0

Build

• Drop support for Python 3.10 (53623ce by Timothée Mazzucotelli).

mkdocstrings/python (mkdocstrings-python)

v1.19.0

Compare Source

Compare with 1.18.2

Features

• Release scoped and relative cross-references (872afc5 by Timothée Mazzucotelli).
• Release __all__ ordering feature (84aaebc by Timothée Mazzucotelli).
• Release public filter feature (3be14cc by Timothée Mazzucotelli).
• Release backlinks feature (ae7cc2d by Timothée Mazzucotelli).
• Release expression modernization feature (dbadd1e by Timothée Mazzucotelli).
• Release visually-lighter admonitions for source code blocks (fdaeb48 by Timothée Mazzucotelli).
• Release inheritance diagram features (669b42e by Timothée Mazzucotelli).

Code Refactoring

• Update code base for Python 3.10 (b696ed2 by Timothée Mazzucotelli).

v1.18.2

Compare Source

Compare with 1.18.1

Bug Fixes

• Normalize spaces to underscores when passing object to rendering context using its kind as key (6f79be0 by Timothée Mazzucotelli). Issue-mkdocstrings-791

v1.18.1

Compare Source

Compare with 1.18.0

Bug Fixes

• Don't show implementation signature of __init__ method when overloads_only is true and it is merged into the class (9ef620f by Timothée Mazzucotelli). Issue-308

v1.18.0

Compare Source

Compare with 1.17.0

Features

• Support PEP 695 generics (dc8c3ad by Victor Westerhuis). PR-221, Co-authored-by: Timothée Mazzucotelli dev@pawamoy.fr

Bug Fixes

• Increase maximum recursion limit in case of deeply nested ASTs (rare occurrence) (6004ccf by Timothée Mazzucotelli). Issue-griffe-402

v1.17.0

Compare Source

Compare with 1.16.12

Features

• Support new Griffe parsing options warn_missing_types and warnings (0e3bdb8 by Timothée Mazzucotelli). Issue-mkdocstrings-437
• Add skip_local_inventory option to prevent objects from being registered in the local objects inventory (e82c24f by Bartosz Sławecki). Issue-296, Issue-mkdocstrings-671, PR-297
• Support hiding attribute values (6cf34b9 by Bartosz Sławecki). Issue-292: #​292, PR-293: #​293
• Support hiding implementation signature (showing overload only) (d3b35e1 by Bartosz Sławecki). Issue-213, PR-286

Code Refactoring

• Deprecate locale option in favor of mkdocstrings' (17f71ba by Timothée Mazzucotelli). PR-288

v1.16.12

Compare Source

Compare with 1.16.11

Bug Fixes

• Only replace CSS class in first highlighting span (d57740f by Timothée Mazzucotelli). Issue-281

v1.16.11

Compare Source

Compare with 1.16.10

Bug Fixes

• Fix highlighting for signature with known special names like __init__ (7f95686 by Timothée Mazzucotelli). Issue-mkdocstrings-757
• Use default font-size for parameter headings (0a35b20 by Timothée Mazzucotelli). Issue-mkdocstrings-697
• Prevent uppercasing H5 titles (by Material for MkDocs) (ba66969 by Timothée Mazzucotelli). Issue-mkdocstrings-697, Issue-276
• Use configured heading even when signature is not separated (096960a by Timothée Mazzucotelli). Issue-mkdocstrings-767, PR-278
• Render attribute names without full path in ToC (d4e618a by David Lee). Issue-271, PR-272