mkdocstrings-python 1.16.7__tar.gz → 1.16.8__tar.gz

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/CHANGELOG.md

@@ -5,6 +5,19 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 <!-- insertion marker -->
+## [1.16.8](https://github.com/mkdocstrings/python/releases/tag/1.16.8) - 2025-03-24
+
+<small>[Compare with 1.16.7](https://github.com/mkdocstrings/python/compare/1.16.7...1.16.8)</small>
+
+### Bug Fixes
+
+- Prevent infinite recursion by detecting parent-member cycles ([f3917e9](https://github.com/mkdocstrings/python/commit/f3917e9dd50ca7f94d0dd22b6e4e11885b4617e7) by Timothée Mazzucotelli). [Issue-griffe-368](https://github.com/mkdocstrings/griffe/issues/368)
+
+### Code Refactoring
+
+- Prepare feature for ordering by `__all__` value ([bfb5b30](https://github.com/mkdocstrings/python/commit/bfb5b303f4ea2187c15bccc688f7eba25e7edfcc) by Timothée Mazzucotelli). [Issue-219](https://github.com/mkdocstrings/python/issues/219)
+- Sort objects without line numbers last instead of first ([681afb1](https://github.com/mkdocstrings/python/commit/681afb146225d98350a8eb2178aab07aec95fe6b) by Timothée Mazzucotelli).
+
 ## [1.16.7](https://github.com/mkdocstrings/python/releases/tag/1.16.7) - 2025-03-20
 
 <small>[Compare with 1.16.6](https://github.com/mkdocstrings/python/compare/1.16.6...1.16.7)</small>

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocstrings-python
-Version: 1.16.7
+Version: 1.16.8
 Summary: A Python handler for mkdocstrings.
 Author-Email: =?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>
 License-Expression: ISC
@@ -32,7 +32,7 @@ Project-URL: Funding, https://github.com/sponsors/pawamoy
 Requires-Python: >=3.9
 Requires-Dist: mkdocstrings>=0.28.3
 Requires-Dist: mkdocs-autorefs>=1.4
-Requires-Dist: griffe>=0.49
+Requires-Dist: griffe>=1.6.2
 Requires-Dist: typing-extensions>=4.0; python_version < "3.11"
 Description-Content-Type: text/markdown
 

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/docs/insiders/changelog.md

@@ -2,6 +2,10 @@
 
 ## mkdocstrings-python Insiders
 
+### 1.12.0 <small>March 22, 2025</small> { id="1.12.0" }
+
+- [Ordering method: `__all__`][option-members_order]
+
 ### 1.11.0 <small>March 20, 2025</small> { id="1.11.0" }
 
 - [Filtering method: `public`][option-filters-public]

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/docs/insiders/goals.yml

@@ -48,3 +48,6 @@ goals:
     - name: "Filtering method: `public`"
       ref: /usage/configuration/members/#option-filters-public
       since: 2025/03/20
+    - name: "Ordering method: `__all__`"
+      ref: /usage/configuration/members/#option-members_order
+      since: 2025/03/22

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/docs/usage/configuration/members.md

@@ -264,13 +264,14 @@ class Main(Base):
 [](){#option-members_order}
 ## `members_order`
 
-- **:octicons-package-24: Type [`str`][] :material-equal: `"alphabetical"`{ title="default value" }**
+- **:octicons-package-24: Type `str | list[str]` :material-equal: `"alphabetical"`{ title="default value" }**
 <!-- - **:octicons-project-template-24: Template :material-null:** (N/A) -->
 
 The members ordering to use. Possible values:
 
-- `alphabetical`: order by the members names.
-- `source`: order members as they appear in the source file.
+- `__all__` ([:octicons-heart-fill-24:{ .pulse } Sponsors only](../../insiders/index.md){ .insiders } &mdash; [:octicons-tag-24: Insiders 1.12.0](../../insiders/changelog.md#1.12.0)): Order according to `__all__` attributes. Since classes do not define `__all__` attributes, you can specify a second ordering method by using a list.
+- `alphabetical`: Order by the members names.
+- `source`: Order members as they appear in the source file.
 
 The order applies for all members, recursively.
 The order will be ignored for members that are explicitely sorted using the [`members`][] option.
@@ -292,6 +293,12 @@ plugins:
       members_order: source
 ```
 
+```md title="or in docs/some_page.md (local configuration)"
+::: package.module
+    options:
+      members_order: [__all__, source]
+```
+
 ```python title="package/module.py"
 """Module docstring."""
 

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/docs/usage/index.md

@@ -87,8 +87,8 @@ plugins:
 - mkdocstrings:
     handlers:
       python:
-        import:
-        - https://docs.python-requests.org/en/master/objects.inv
+        inventories:
+        - https://docs.python.org/3/objects.inv
 ```
 
 When loading an inventory, you enable automatic cross-references

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/pyproject.toml

@@ -39,10 +39,10 @@ classifiers = [
 dependencies = [
     "mkdocstrings>=0.28.3",
     "mkdocs-autorefs>=1.4",
-    "griffe>=0.49",
+    "griffe>=1.6.2",
     "typing-extensions>=4.0; python_version < '3.11'",
 ]
-version = "1.16.7"
+version = "1.16.8"
 
 [project.urls]
 Homepage = "https://mkdocstrings.github.io/python"

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/src/mkdocstrings_handlers/python/_internal/config.py

@@ -9,6 +9,8 @@ from typing import TYPE_CHECKING, Annotated, Any, Literal
 
 from mkdocstrings import get_logger
 
+from mkdocstrings_handlers.python._internal.rendering import Order  # noqa: TC001
+
 # YORE: EOL 3.10: Replace block with line 2.
 if sys.version_info >= (3, 11):
     from typing import Self
@@ -520,13 +522,18 @@ class PythonInputOptions:
     ] = None
 
     members_order: Annotated[
-        Literal["alphabetical", "source"],
+        Order | list[Order],
         _Field(
             group="members",
             description="""The members ordering to use.
 
-            - `alphabetical`: order by the members names,
+            - `__all__`: order members according to `__all__` module attributes, if declared;
+            - `alphabetical`: order members alphabetically;
             - `source`: order members as they appear in the source file.
+
+            Since `__all__` is a module-only attribute, it can't be used to sort class members,
+            therefore the `members_order` option accepts a list of ordering methods,
+            indicating ordering preferences.
             """,
         ),
     ] = "alphabetical"

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/src/mkdocstrings_handlers/python/_internal/rendering.py

@@ -9,6 +9,7 @@ import subprocess
 import sys
 import warnings
 from collections import defaultdict
+from contextlib import suppress
 from dataclasses import replace
 from functools import lru_cache
 from pathlib import Path
@@ -17,6 +18,8 @@ from typing import TYPE_CHECKING, Any, Callable, ClassVar, Literal, TypeVar
 
 from griffe import (
     Alias,
+    AliasResolutionError,
+    CyclicAliasError,
     DocstringAttribute,
     DocstringClass,
     DocstringFunction,
@@ -43,26 +46,35 @@ if TYPE_CHECKING:
 _logger = get_logger(__name__)
 
 
-def _sort_key_alphabetical(item: CollectorItem) -> Any:
-    # chr(sys.maxunicode) is a string that contains the final unicode
-    # character, so if 'name' isn't found on the object, the item will go to
-    # the end of the list.
+def _sort_key_alphabetical(item: CollectorItem) -> str:
+    # `chr(sys.maxunicode)` is a string that contains the final unicode character,
+    # so if `name` isn't found on the object, the item will go to the end of the list.
     return item.name or chr(sys.maxunicode)
 
 
-def _sort_key_source(item: CollectorItem) -> Any:
-    # if 'lineno' is none, the item will go to the start of the list.
+def _sort_key_source(item: CollectorItem) -> float:
+    # If `lineno` is none, the item will go to the end of the list.
     if item.is_alias:
-        return item.alias_lineno if item.alias_lineno is not None else -1
-    return item.lineno if item.lineno is not None else -1
+        return item.alias_lineno if item.alias_lineno is not None else float("inf")
+    return item.lineno if item.lineno is not None else float("inf")
 
 
-Order = Literal["alphabetical", "source"]
-"""Ordering methods."""
+def _sort__all__(item: CollectorItem) -> float:  # noqa: ARG001
+    raise ValueError("Not implemented in public version of mkdocstrings-python")
 
-_order_map = {
+
+Order = Literal["__all__", "alphabetical", "source"]
+"""Ordering methods.
+
+- `__all__`: order members according to `__all__` module attributes, if declared;
+- `alphabetical`: order members alphabetically;
+- `source`: order members as they appear in the source file.
+"""
+
+_order_map: dict[str, Callable[[Object | Alias], str | float]] = {
     "alphabetical": _sort_key_alphabetical,
     "source": _sort_key_source,
+    "__all__": _sort__all__,
 }
 
 
@@ -246,7 +258,7 @@ def do_format_attribute(
 
 def do_order_members(
     members: Sequence[Object | Alias],
-    order: Order,
+    order: Order | list[Order],
     members_list: bool | list[str] | None,
 ) -> Sequence[Object | Alias]:
     """Order members given an ordering method.
@@ -266,7 +278,12 @@ def do_order_members(
             if name in members_dict:
                 sorted_members.append(members_dict[name])
         return sorted_members
-    return sorted(members, key=_order_map[order])
+    if isinstance(order, str):
+        order = [order]
+    for method in order:
+        with suppress(ValueError):
+            return sorted(members, key=_order_map[method])
+    return members
 
 
 # YORE: Bump 2: Remove block.
@@ -396,6 +413,29 @@ def _keep_object(name: str, filters: Sequence[tuple[Pattern, bool]]) -> bool:
     return keep
 
 
+def _parents(obj: Alias) -> set[str]:
+    parent: Object | Alias = obj.parent  # type: ignore[assignment]
+    parents = {obj.path, parent.path}
+    if parent.is_alias:
+        parents.add(parent.final_target.path)  # type: ignore[union-attr]
+    while parent.parent:
+        parent = parent.parent
+        parents.add(parent.path)
+        if parent.is_alias:
+            parents.add(parent.final_target.path)  # type: ignore[union-attr]
+    return parents
+
+
+def _remove_cycles(objects: list[Object | Alias]) -> Iterator[Object | Alias]:
+    suppress_errors = suppress(AliasResolutionError, CyclicAliasError)
+    for obj in objects:
+        if obj.is_alias:
+            with suppress_errors:
+                if obj.final_target.path in _parents(obj):  # type: ignore[arg-type,union-attr]
+                    continue
+        yield obj
+
+
 def do_filter_objects(
     objects_dictionary: dict[str, Object | Alias],
     *,
@@ -455,10 +495,14 @@ def do_filter_objects(
         objects = [
             obj for obj in objects if _keep_object(obj.name, filters) or (inherited_members_specified and obj.inherited)
         ]
-    if keep_no_docstrings:
-        return objects
+    if not keep_no_docstrings:
+        objects = [obj for obj in objects if obj.has_docstrings or (inherited_members_specified and obj.inherited)]
+
+    # Prevent infinite recursion.
+    if objects:
+        objects = list(_remove_cycles(objects))
 
-    return [obj for obj in objects if obj.has_docstrings or (inherited_members_specified and obj.inherited)]
+    return objects
 
 
 @lru_cache(maxsize=1)

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/tests/test_handler.py

@@ -10,7 +10,14 @@ from textwrap import dedent
 from typing import TYPE_CHECKING
 
 import pytest
-from griffe import Docstring, DocstringSectionExamples, DocstringSectionKind, Module, temporary_visited_module
+from griffe import (
+    Docstring,
+    DocstringSectionExamples,
+    DocstringSectionKind,
+    Module,
+    temporary_inspected_module,
+    temporary_visited_module,
+)
 from mkdocstrings import CollectionError
 
 from mkdocstrings_handlers.python import PythonConfig, PythonHandler, PythonOptions
@@ -275,3 +282,19 @@ def test_deduplicate_summary_sections(handler: PythonHandler, section: str, code
             ),
         )
         assert html.count(f"{section}:") == 1
+
+
+def test_inheriting_self_from_parent_class(handler: PythonHandler) -> None:
+    """Inspect self only once when inheriting it from parent class."""
+    with temporary_inspected_module(
+        """
+        class A: ...
+        class B(A): ...
+        A.B = B
+        """,
+    ) as module:
+        # Assert no recusrion error.
+        handler.render(
+            module,
+            handler.get_options({"inherited_members": True}),
+        )

{mkdocstrings_python-1.16.7 → mkdocstrings_python-1.16.8}/tests/test_rendering.py

@@ -58,6 +58,8 @@ def test_format_signature(name: Markup, signature: str) -> None:
 class _FakeObject:
     name: str
     inherited: bool = False
+    parent: None = None
+    is_alias: bool = False
 
 
 @pytest.mark.parametrize(

mkdocstrings_python-1.16.7/src/mkdocstrings_handlers/python/_internal/.mypy_cache/.gitignore

@@ -1,2 +0,0 @@
-# Automatically created by mypy
-*

mkdocstrings_python-1.16.7/src/mkdocstrings_handlers/python/_internal/.mypy_cache/3.13/@plugins_snapshot.json

@@ -1 +0,0 @@
-{}

mkdocstrings_python-1.16.7/src/mkdocstrings_handlers/python/_internal/.mypy_cache/3.13/__future__.data.json

@@ -1 +0,0 @@
-{".class":"MypyFile","_fullname":"__future__","future_import_flags":[],"is_partial_stub_package":false,"is_stub":true,"names":{".class":"SymbolTable","TypeAlias":{".class":"SymbolTableNode","cross_ref":"typing.TypeAlias","kind":"Gdef","module_hidden":true,"module_public":false},"_Feature":{".class":"SymbolTableNode","kind":"Gdef","module_public":false,"node":{".class":"TypeInfo","_promote":[],"abstract_attributes":[],"alt_promote":null,"bases":["builtins.object"],"dataclass_transform_spec":null,"declared_metaclass":null,"defn":{".class":"ClassDef","fullname":"__future__._Feature","name":"_Feature","type_vars":[]},"deletable_attributes":[],"deprecated":null,"flags":[],"fullname":"__future__._Feature","has_param_spec_type":false,"metaclass_type":null,"metadata":{},"module_name":"__future__","mro":["__future__._Feature","builtins.object"],"names":{".class":"SymbolTable","__init__":{".class":"SymbolTableNode","kind":"Mdef","node":{".class":"FuncDef","abstract_status":0,"arg_kinds":[0,0,0,0],"arg_names":["self","optionalRelease","mandatoryRelease","compiler_flag"],"dataclass_transform_spec":null,"deprecated":null,"flags":[],"fullname":"__future__._Feature.__init__","name":"__init__","type":{".class":"CallableType","arg_kinds":[0,0,0,0],"arg_names":["self","optionalRelease","mandatoryRelease","compiler_flag"],"arg_types":["__future__._Feature",{".class":"TypeAliasType","args":[],"type_ref":"__future__._VersionInfo"},{".class":"UnionType","items":[{".class":"TypeAliasType","args":[],"type_ref":"__future__._VersionInfo"},{".class":"NoneType"}],"uses_pep604_syntax":true},"builtins.int"],"bound_args":[],"def_extras":{"first_arg":"self"},"fallback":"builtins.function","from_concatenate":false,"implicit":false,"imprecise_arg_kinds":false,"is_ellipsis_args":false,"name":"__init__ of _Feature","ret_type":{".class":"NoneType"},"type_guard":null,"type_is":null,"unpack_kwargs":false,"variables":[]}}},"compiler_flag":{".class":"SymbolTableNode","kind":"Mdef","node":{".class":"Var","flags":["is_initialized_in_class","is_ready"],"fullname":"__future__._Feature.compiler_flag","name":"compiler_flag","type":"builtins.int"}},"getMandatoryRelease":{".class":"SymbolTableNode","kind":"Mdef","node":{".class":"FuncDef","abstract_status":0,"arg_kinds":[0],"arg_names":["self"],"dataclass_transform_spec":null,"deprecated":null,"flags":[],"fullname":"__future__._Feature.getMandatoryRelease","name":"getMandatoryRelease","type":{".class":"CallableType","arg_kinds":[0],"arg_names":["self"],"arg_types":["__future__._Feature"],"bound_args":[],"def_extras":{"first_arg":"self"},"fallback":"builtins.function","from_concatenate":false,"implicit":false,"imprecise_arg_kinds":false,"is_ellipsis_args":false,"name":"getMandatoryRelease of _Feature","ret_type":{".class":"UnionType","items":[{".class":"TypeAliasType","args":[],"type_ref":"__future__._VersionInfo"},{".class":"NoneType"}],"uses_pep604_syntax":true},"type_guard":null,"type_is":null,"unpack_kwargs":false,"variables":[]}}},"getOptionalRelease":{".class":"SymbolTableNode","kind":"Mdef","node":{".class":"FuncDef","abstract_status":0,"arg_kinds":[0],"arg_names":["self"],"dataclass_transform_spec":null,"deprecated":null,"flags":[],"fullname":"__future__._Feature.getOptionalRelease","name":"getOptionalRelease","type":{".class":"CallableType","arg_kinds":[0],"arg_names":["self"],"arg_types":["__future__._Feature"],"bound_args":[],"def_extras":{"first_arg":"self"},"fallback":"builtins.function","from_concatenate":false,"implicit":false,"imprecise_arg_kinds":false,"is_ellipsis_args":false,"name":"getOptionalRelease of _Feature","ret_type":{".class":"TypeAliasType","args":[],"type_ref":"__future__._VersionInfo"},"type_guard":null,"type_is":null,"unpack_kwargs":false,"variables":[]}}}},"self_type":{".class":"TypeVarType","default":{".class":"AnyType","missing_import_name":null,"source_any":null,"type_of_any":4},"fullname":"__future__._Feature.Self","id":0,"name":"Self","namespace":"","upper_bound":"__future__._Feature","values":[],"variance":0},"slots":null,"tuple_type":null,"type_vars":[],"typeddict_type":null}},"_VersionInfo":{".class":"SymbolTableNode","kind":"Gdef","module_public":false,"node":{".class":"TypeAlias","alias_tvars":[],"column":0,"fullname":"__future__._VersionInfo","line":3,"no_args":false,"normalized":false,"python_3_12_type_alias":false,"target":{".class":"TupleType","implicit":false,"items":["builtins.int","builtins.int","builtins.int","builtins.str","builtins.int"],"partial_fallback":{".class":"Instance","args":[{".class":"AnyType","missing_import_name":null,"source_any":null,"type_of_any":6}],"extra_attrs":null,"type_ref":"builtins.tuple"}}}},"__all__":{".class":"SymbolTableNode","kind":"Gdef","module_public":false,"node":{".class":"Var","flags":["is_inferred","has_explicit_value"],"fullname":"__future__.__all__","name":"__all__","type":{".class":"Instance","args":["builtins.str"],"extra_attrs":null,"type_ref":"builtins.list"}}},"__annotations__":{".class":"SymbolTableNode","kind":"Gdef","module_public":false,"node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.__annotations__","name":"__annotations__","type":{".class":"Instance","args":["builtins.str",{".class":"AnyType","missing_import_name":null,"source_any":null,"type_of_any":6}],"extra_attrs":null,"type_ref":"builtins.dict"}}},"__doc__":{".class":"SymbolTableNode","kind":"Gdef","module_public":false,"node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.__doc__","name":"__doc__","type":"builtins.str"}},"__file__":{".class":"SymbolTableNode","kind":"Gdef","module_public":false,"node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.__file__","name":"__file__","type":"builtins.str"}},"__name__":{".class":"SymbolTableNode","kind":"Gdef","module_public":false,"node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.__name__","name":"__name__","type":"builtins.str"}},"__package__":{".class":"SymbolTableNode","kind":"Gdef","module_public":false,"node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.__package__","name":"__package__","type":"builtins.str"}},"__spec__":{".class":"SymbolTableNode","kind":"Gdef","module_public":false,"node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.__spec__","name":"__spec__","type":"_frozen_importlib.ModuleSpec"}},"absolute_import":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.absolute_import","name":"absolute_import","type":"__future__._Feature"}},"all_feature_names":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.all_feature_names","name":"all_feature_names","type":{".class":"Instance","args":["builtins.str"],"extra_attrs":null,"type_ref":"builtins.list"}}},"annotations":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.annotations","name":"annotations","type":"__future__._Feature"}},"barry_as_FLUFL":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.barry_as_FLUFL","name":"barry_as_FLUFL","type":"__future__._Feature"}},"division":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.division","name":"division","type":"__future__._Feature"}},"generator_stop":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.generator_stop","name":"generator_stop","type":"__future__._Feature"}},"generators":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.generators","name":"generators","type":"__future__._Feature"}},"nested_scopes":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.nested_scopes","name":"nested_scopes","type":"__future__._Feature"}},"print_function":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.print_function","name":"print_function","type":"__future__._Feature"}},"unicode_literals":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.unicode_literals","name":"unicode_literals","type":"__future__._Feature"}},"with_statement":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"__future__.with_statement","name":"with_statement","type":"__future__._Feature"}}},"path":"/home/pawamoy/.vscode/extensions/ms-python.mypy-type-checker-2025.2.0/bundled/libs/mypy/typeshed/stdlib/__future__.pyi"}

mkdocstrings_python-1.16.7/src/mkdocstrings_handlers/python/_internal/.mypy_cache/3.13/__future__.meta.json

@@ -1 +0,0 @@
-{"data_mtime":1742398211,"dep_lines":[1,1,1,1,1,1],"dep_prios":[5,5,30,30,30,30],"dependencies":["typing_extensions","builtins","_frozen_importlib","abc","types","typing"],"hash":"8da8f50dac0209ecf1254aa54bebb93f2ca11823","id":"__future__","ignore_all":true,"interface_hash":"3b287462bd2fc574fa2d31ba666f1ad9e979ebb0","mtime":1741275133,"options":{"allow_redefinition":false,"allow_untyped_globals":false,"always_false":[],"always_true":[],"bazel":false,"check_untyped_defs":false,"disable_bytearray_promotion":false,"disable_error_code":[],"disable_memoryview_promotion":false,"disabled_error_codes":[],"disallow_any_decorated":false,"disallow_any_explicit":false,"disallow_any_expr":false,"disallow_any_generics":false,"disallow_any_unimported":false,"disallow_incomplete_defs":false,"disallow_subclassing_any":false,"disallow_untyped_calls":false,"disallow_untyped_decorators":false,"disallow_untyped_defs":false,"enable_error_code":[],"enabled_error_codes":[],"extra_checks":false,"follow_imports":"normal","follow_imports_for_stubs":false,"follow_untyped_imports":false,"ignore_errors":false,"ignore_missing_imports":false,"implicit_optional":false,"implicit_reexport":true,"local_partial_types":false,"mypyc":false,"old_type_inference":false,"platform":"linux","plugins":[],"strict_bytes":false,"strict_concatenate":false,"strict_equality":false,"strict_optional":true,"warn_no_return":true,"warn_return_any":false,"warn_unreachable":false,"warn_unused_ignores":false},"path":"/home/pawamoy/.vscode/extensions/ms-python.mypy-type-checker-2025.2.0/bundled/libs/mypy/typeshed/stdlib/__future__.pyi","plugin_data":null,"size":915,"suppressed":[],"version_id":"1.15.0"}

mkdocstrings_python-1.16.7/src/mkdocstrings_handlers/python/_internal/.mypy_cache/3.13/_ast.data.json

@@ -1 +0,0 @@
-{".class":"MypyFile","_fullname":"_ast","future_import_flags":[],"is_partial_stub_package":false,"is_stub":true,"names":{".class":"SymbolTable","AST":{".class":"SymbolTableNode","cross_ref":"ast.AST","kind":"Gdef"},"Add":{".class":"SymbolTableNode","cross_ref":"ast.Add","kind":"Gdef"},"And":{".class":"SymbolTableNode","cross_ref":"ast.And","kind":"Gdef"},"AnnAssign":{".class":"SymbolTableNode","cross_ref":"ast.AnnAssign","kind":"Gdef"},"Assert":{".class":"SymbolTableNode","cross_ref":"ast.Assert","kind":"Gdef"},"Assign":{".class":"SymbolTableNode","cross_ref":"ast.Assign","kind":"Gdef"},"AsyncFor":{".class":"SymbolTableNode","cross_ref":"ast.AsyncFor","kind":"Gdef"},"AsyncFunctionDef":{".class":"SymbolTableNode","cross_ref":"ast.AsyncFunctionDef","kind":"Gdef"},"AsyncWith":{".class":"SymbolTableNode","cross_ref":"ast.AsyncWith","kind":"Gdef"},"Attribute":{".class":"SymbolTableNode","cross_ref":"ast.Attribute","kind":"Gdef"},"AugAssign":{".class":"SymbolTableNode","cross_ref":"ast.AugAssign","kind":"Gdef"},"Await":{".class":"SymbolTableNode","cross_ref":"ast.Await","kind":"Gdef"},"BinOp":{".class":"SymbolTableNode","cross_ref":"ast.BinOp","kind":"Gdef"},"BitAnd":{".class":"SymbolTableNode","cross_ref":"ast.BitAnd","kind":"Gdef"},"BitOr":{".class":"SymbolTableNode","cross_ref":"ast.BitOr","kind":"Gdef"},"BitXor":{".class":"SymbolTableNode","cross_ref":"ast.BitXor","kind":"Gdef"},"BoolOp":{".class":"SymbolTableNode","cross_ref":"ast.BoolOp","kind":"Gdef"},"Break":{".class":"SymbolTableNode","cross_ref":"ast.Break","kind":"Gdef"},"Call":{".class":"SymbolTableNode","cross_ref":"ast.Call","kind":"Gdef"},"ClassDef":{".class":"SymbolTableNode","cross_ref":"ast.ClassDef","kind":"Gdef"},"Compare":{".class":"SymbolTableNode","cross_ref":"ast.Compare","kind":"Gdef"},"Constant":{".class":"SymbolTableNode","cross_ref":"ast.Constant","kind":"Gdef"},"Continue":{".class":"SymbolTableNode","cross_ref":"ast.Continue","kind":"Gdef"},"Del":{".class":"SymbolTableNode","cross_ref":"ast.Del","kind":"Gdef"},"Delete":{".class":"SymbolTableNode","cross_ref":"ast.Delete","kind":"Gdef"},"Dict":{".class":"SymbolTableNode","cross_ref":"ast.Dict","kind":"Gdef"},"DictComp":{".class":"SymbolTableNode","cross_ref":"ast.DictComp","kind":"Gdef"},"Div":{".class":"SymbolTableNode","cross_ref":"ast.Div","kind":"Gdef"},"Eq":{".class":"SymbolTableNode","cross_ref":"ast.Eq","kind":"Gdef"},"ExceptHandler":{".class":"SymbolTableNode","cross_ref":"ast.ExceptHandler","kind":"Gdef"},"Expr":{".class":"SymbolTableNode","cross_ref":"ast.Expr","kind":"Gdef"},"Expression":{".class":"SymbolTableNode","cross_ref":"ast.Expression","kind":"Gdef"},"FloorDiv":{".class":"SymbolTableNode","cross_ref":"ast.FloorDiv","kind":"Gdef"},"For":{".class":"SymbolTableNode","cross_ref":"ast.For","kind":"Gdef"},"FormattedValue":{".class":"SymbolTableNode","cross_ref":"ast.FormattedValue","kind":"Gdef"},"FunctionDef":{".class":"SymbolTableNode","cross_ref":"ast.FunctionDef","kind":"Gdef"},"FunctionType":{".class":"SymbolTableNode","cross_ref":"ast.FunctionType","kind":"Gdef"},"GeneratorExp":{".class":"SymbolTableNode","cross_ref":"ast.GeneratorExp","kind":"Gdef"},"Global":{".class":"SymbolTableNode","cross_ref":"ast.Global","kind":"Gdef"},"Gt":{".class":"SymbolTableNode","cross_ref":"ast.Gt","kind":"Gdef"},"GtE":{".class":"SymbolTableNode","cross_ref":"ast.GtE","kind":"Gdef"},"If":{".class":"SymbolTableNode","cross_ref":"ast.If","kind":"Gdef"},"IfExp":{".class":"SymbolTableNode","cross_ref":"ast.IfExp","kind":"Gdef"},"Import":{".class":"SymbolTableNode","cross_ref":"ast.Import","kind":"Gdef"},"ImportFrom":{".class":"SymbolTableNode","cross_ref":"ast.ImportFrom","kind":"Gdef"},"In":{".class":"SymbolTableNode","cross_ref":"ast.In","kind":"Gdef"},"Interactive":{".class":"SymbolTableNode","cross_ref":"ast.Interactive","kind":"Gdef"},"Invert":{".class":"SymbolTableNode","cross_ref":"ast.Invert","kind":"Gdef"},"Is":{".class":"SymbolTableNode","cross_ref":"ast.Is","kind":"Gdef"},"IsNot":{".class":"SymbolTableNode","cross_ref":"ast.IsNot","kind":"Gdef"},"JoinedStr":{".class":"SymbolTableNode","cross_ref":"ast.JoinedStr","kind":"Gdef"},"LShift":{".class":"SymbolTableNode","cross_ref":"ast.LShift","kind":"Gdef"},"Lambda":{".class":"SymbolTableNode","cross_ref":"ast.Lambda","kind":"Gdef"},"List":{".class":"SymbolTableNode","cross_ref":"ast.List","kind":"Gdef"},"ListComp":{".class":"SymbolTableNode","cross_ref":"ast.ListComp","kind":"Gdef"},"Literal":{".class":"SymbolTableNode","cross_ref":"typing.Literal","kind":"Gdef","module_hidden":true,"module_public":false},"Load":{".class":"SymbolTableNode","cross_ref":"ast.Load","kind":"Gdef"},"Lt":{".class":"SymbolTableNode","cross_ref":"ast.Lt","kind":"Gdef"},"LtE":{".class":"SymbolTableNode","cross_ref":"ast.LtE","kind":"Gdef"},"MatMult":{".class":"SymbolTableNode","cross_ref":"ast.MatMult","kind":"Gdef"},"MatchAs":{".class":"SymbolTableNode","cross_ref":"ast.MatchAs","kind":"Gdef"},"MatchClass":{".class":"SymbolTableNode","cross_ref":"ast.MatchClass","kind":"Gdef"},"MatchMapping":{".class":"SymbolTableNode","cross_ref":"ast.MatchMapping","kind":"Gdef"},"MatchOr":{".class":"SymbolTableNode","cross_ref":"ast.MatchOr","kind":"Gdef"},"MatchSequence":{".class":"SymbolTableNode","cross_ref":"ast.MatchSequence","kind":"Gdef"},"MatchSingleton":{".class":"SymbolTableNode","cross_ref":"ast.MatchSingleton","kind":"Gdef"},"MatchStar":{".class":"SymbolTableNode","cross_ref":"ast.MatchStar","kind":"Gdef"},"MatchValue":{".class":"SymbolTableNode","cross_ref":"ast.MatchValue","kind":"Gdef"},"Mod":{".class":"SymbolTableNode","cross_ref":"ast.Mod","kind":"Gdef"},"Module":{".class":"SymbolTableNode","cross_ref":"ast.Module","kind":"Gdef"},"Mult":{".class":"SymbolTableNode","cross_ref":"ast.Mult","kind":"Gdef"},"Name":{".class":"SymbolTableNode","cross_ref":"ast.Name","kind":"Gdef"},"NamedExpr":{".class":"SymbolTableNode","cross_ref":"ast.NamedExpr","kind":"Gdef"},"Nonlocal":{".class":"SymbolTableNode","cross_ref":"ast.Nonlocal","kind":"Gdef"},"Not":{".class":"SymbolTableNode","cross_ref":"ast.Not","kind":"Gdef"},"NotEq":{".class":"SymbolTableNode","cross_ref":"ast.NotEq","kind":"Gdef"},"NotIn":{".class":"SymbolTableNode","cross_ref":"ast.NotIn","kind":"Gdef"},"Or":{".class":"SymbolTableNode","cross_ref":"ast.Or","kind":"Gdef"},"ParamSpec":{".class":"SymbolTableNode","cross_ref":"ast.ParamSpec","kind":"Gdef"},"Pass":{".class":"SymbolTableNode","cross_ref":"ast.Pass","kind":"Gdef"},"Pow":{".class":"SymbolTableNode","cross_ref":"ast.Pow","kind":"Gdef"},"PyCF_ALLOW_TOP_LEVEL_AWAIT":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.PyCF_ALLOW_TOP_LEVEL_AWAIT","name":"PyCF_ALLOW_TOP_LEVEL_AWAIT","type":{".class":"LiteralType","fallback":"builtins.int","value":8192}}},"PyCF_ONLY_AST":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.PyCF_ONLY_AST","name":"PyCF_ONLY_AST","type":{".class":"LiteralType","fallback":"builtins.int","value":1024}}},"PyCF_OPTIMIZED_AST":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.PyCF_OPTIMIZED_AST","name":"PyCF_OPTIMIZED_AST","type":{".class":"LiteralType","fallback":"builtins.int","value":33792}}},"PyCF_TYPE_COMMENTS":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.PyCF_TYPE_COMMENTS","name":"PyCF_TYPE_COMMENTS","type":{".class":"LiteralType","fallback":"builtins.int","value":4096}}},"RShift":{".class":"SymbolTableNode","cross_ref":"ast.RShift","kind":"Gdef"},"Raise":{".class":"SymbolTableNode","cross_ref":"ast.Raise","kind":"Gdef"},"Return":{".class":"SymbolTableNode","cross_ref":"ast.Return","kind":"Gdef"},"Set":{".class":"SymbolTableNode","cross_ref":"ast.Set","kind":"Gdef"},"SetComp":{".class":"SymbolTableNode","cross_ref":"ast.SetComp","kind":"Gdef"},"Slice":{".class":"SymbolTableNode","cross_ref":"ast.Slice","kind":"Gdef"},"Starred":{".class":"SymbolTableNode","cross_ref":"ast.Starred","kind":"Gdef"},"Store":{".class":"SymbolTableNode","cross_ref":"ast.Store","kind":"Gdef"},"Sub":{".class":"SymbolTableNode","cross_ref":"ast.Sub","kind":"Gdef"},"Subscript":{".class":"SymbolTableNode","cross_ref":"ast.Subscript","kind":"Gdef"},"Try":{".class":"SymbolTableNode","cross_ref":"ast.Try","kind":"Gdef"},"TryStar":{".class":"SymbolTableNode","cross_ref":"ast.TryStar","kind":"Gdef"},"Tuple":{".class":"SymbolTableNode","cross_ref":"ast.Tuple","kind":"Gdef"},"TypeIgnore":{".class":"SymbolTableNode","cross_ref":"ast.TypeIgnore","kind":"Gdef"},"TypeVar":{".class":"SymbolTableNode","cross_ref":"ast.TypeVar","kind":"Gdef"},"TypeVarTuple":{".class":"SymbolTableNode","cross_ref":"ast.TypeVarTuple","kind":"Gdef"},"UAdd":{".class":"SymbolTableNode","cross_ref":"ast.UAdd","kind":"Gdef"},"USub":{".class":"SymbolTableNode","cross_ref":"ast.USub","kind":"Gdef"},"UnaryOp":{".class":"SymbolTableNode","cross_ref":"ast.UnaryOp","kind":"Gdef"},"While":{".class":"SymbolTableNode","cross_ref":"ast.While","kind":"Gdef"},"With":{".class":"SymbolTableNode","cross_ref":"ast.With","kind":"Gdef"},"Yield":{".class":"SymbolTableNode","cross_ref":"ast.Yield","kind":"Gdef"},"YieldFrom":{".class":"SymbolTableNode","cross_ref":"ast.YieldFrom","kind":"Gdef"},"__annotations__":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.__annotations__","name":"__annotations__","type":{".class":"Instance","args":["builtins.str",{".class":"AnyType","missing_import_name":null,"source_any":null,"type_of_any":6}],"extra_attrs":null,"type_ref":"builtins.dict"}}},"__doc__":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.__doc__","name":"__doc__","type":"builtins.str"}},"__file__":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.__file__","name":"__file__","type":"builtins.str"}},"__name__":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.__name__","name":"__name__","type":"builtins.str"}},"__package__":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.__package__","name":"__package__","type":"builtins.str"}},"__spec__":{".class":"SymbolTableNode","kind":"Gdef","node":{".class":"Var","flags":["is_ready"],"fullname":"_ast.__spec__","name":"__spec__","type":"_frozen_importlib.ModuleSpec"}},"alias":{".class":"SymbolTableNode","cross_ref":"ast.alias","kind":"Gdef"},"arg":{".class":"SymbolTableNode","cross_ref":"ast.arg","kind":"Gdef"},"arguments":{".class":"SymbolTableNode","cross_ref":"ast.arguments","kind":"Gdef"},"boolop":{".class":"SymbolTableNode","cross_ref":"ast.boolop","kind":"Gdef"},"cmpop":{".class":"SymbolTableNode","cross_ref":"ast.cmpop","kind":"Gdef"},"comprehension":{".class":"SymbolTableNode","cross_ref":"ast.comprehension","kind":"Gdef"},"excepthandler":{".class":"SymbolTableNode","cross_ref":"ast.excepthandler","kind":"Gdef"},"expr":{".class":"SymbolTableNode","cross_ref":"ast.expr","kind":"Gdef"},"expr_context":{".class":"SymbolTableNode","cross_ref":"ast.expr_context","kind":"Gdef"},"keyword":{".class":"SymbolTableNode","cross_ref":"ast.keyword","kind":"Gdef"},"match_case":{".class":"SymbolTableNode","cross_ref":"ast.match_case","kind":"Gdef"},"mod":{".class":"SymbolTableNode","cross_ref":"ast.mod","kind":"Gdef"},"operator":{".class":"SymbolTableNode","cross_ref":"ast.operator","kind":"Gdef"},"pattern":{".class":"SymbolTableNode","cross_ref":"ast.pattern","kind":"Gdef"},"stmt":{".class":"SymbolTableNode","cross_ref":"ast.stmt","kind":"Gdef"},"sys":{".class":"SymbolTableNode","cross_ref":"sys","kind":"Gdef","module_hidden":true,"module_public":false},"type_ignore":{".class":"SymbolTableNode","cross_ref":"ast.type_ignore","kind":"Gdef"},"type_param":{".class":"SymbolTableNode","cross_ref":"ast.type_param","kind":"Gdef"},"unaryop":{".class":"SymbolTableNode","cross_ref":"ast.unaryop","kind":"Gdef"},"withitem":{".class":"SymbolTableNode","cross_ref":"ast.withitem","kind":"Gdef"}},"path":"/home/pawamoy/.vscode/extensions/ms-python.mypy-type-checker-2025.2.0/bundled/libs/mypy/typeshed/stdlib/_ast.pyi"}

mkdocstrings_python-1.16.7/src/mkdocstrings_handlers/python/_internal/.mypy_cache/3.13/_ast.meta.json

@@ -1 +0,0 @@
-{"data_mtime":1742398209,"dep_lines":[1,2,111,1,1,1,1],"dep_prios":[10,5,5,5,30,30,30],"dependencies":["sys","ast","typing","builtins","_frozen_importlib","_typeshed","abc"],"hash":"506bc583306f4b94d727fb61708c1873cb3b3fdf","id":"_ast","ignore_all":true,"interface_hash":"543cf81b4e87894d9c07b228379f32a6dc64e861","mtime":1741275133,"options":{"allow_redefinition":false,"allow_untyped_globals":false,"always_false":[],"always_true":[],"bazel":false,"check_untyped_defs":false,"disable_bytearray_promotion":false,"disable_error_code":[],"disable_memoryview_promotion":false,"disabled_error_codes":[],"disallow_any_decorated":false,"disallow_any_explicit":false,"disallow_any_expr":false,"disallow_any_generics":false,"disallow_any_unimported":false,"disallow_incomplete_defs":false,"disallow_subclassing_any":false,"disallow_untyped_calls":false,"disallow_untyped_decorators":false,"disallow_untyped_defs":false,"enable_error_code":[],"enabled_error_codes":[],"extra_checks":false,"follow_imports":"normal","follow_imports_for_stubs":false,"follow_untyped_imports":false,"ignore_errors":false,"ignore_missing_imports":false,"implicit_optional":false,"implicit_reexport":true,"local_partial_types":false,"mypyc":false,"old_type_inference":false,"platform":"linux","plugins":[],"strict_bytes":false,"strict_concatenate":false,"strict_equality":false,"strict_optional":true,"warn_no_return":true,"warn_return_any":false,"warn_unreachable":false,"warn_unused_ignores":false},"path":"/home/pawamoy/.vscode/extensions/ms-python.mypy-type-checker-2025.2.0/bundled/libs/mypy/typeshed/stdlib/_ast.pyi","plugin_data":null,"size":3496,"suppressed":[],"version_id":"1.15.0"}