[renovate]

Note

This PR body was truncated due to platform limits.

This PR contains the following updates:

Package	Change	Age	Confidence
sphinx-autodoc-typehints (changelog)	==3.13.6 → ==3.17.4

---

Release Notes

tox-dev/sphinx-autodoc-typehints (sphinx-autodoc-typehints)

v3.17.4

Compare Source

Bug fixes

• Link each name in the type after an attribute, data or property name with the role its docstring field uses, so a type alias an inventory lists as data, such as numpy.typing.NDArray, resolves through intersphinx (#​1105) by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v3.17.3

Compare Source

Packaging

• Publish categorized GitHub Release notes with PyPI and version-comparison links (#​1094) by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v3.17.2

Compare Source

Bug fixes

• Link an overridden method to a documented public owner when its defining class is private and absent from the intersphinx inventory. #​1090 by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v3.17.1

Compare Source

Packaging

• Describe the package as rendering Python type hints in Sphinx autodoc documentation. #​1089 by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v3.17.0

Compare Source

Features

• Add typehints_modernize_annotations to render legacy typing aliases with current Python spelling. #​1085 by @​gaborbernat.
• Add an "optional" default style that marks parameters callers may omit without printing their default values. #​1086 by @​gaborbernat.
• Allow a callback to read descriptions from Annotated metadata classes other than Doc. #​1088 by @​gaborbernat.

Documentation

• Explain how Sphinx's autodoc_preserve_defaults applies to default values in parameter descriptions. #​1087 by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v3.16.0

Compare Source

Features

• Read Doc descriptions from annotated-doc as well as typing_extensions. #​1083 by @​gaborbernat.

Bug fixes

• Register the value stylesheet through Sphinx's static-directory API, so loading the extension does not change html_static_path. #​1079 by @​gaborbernat.
• Honor autodoc_use_type_comments = False when reading types from a function's # type: comment. #​1080 by @​gaborbernat.
• Use the build platform and false constants when choosing a TYPE_CHECKING guard's branch; skip guards whose other conditions cannot be determined without running code. #​1081 by @​gaborbernat.
• Keep single-word prose in hand-written :Returns: fields, and recognize numpydoc return types containing spaces. #​1082 by @​gaborbernat.

Documentation

• Document support for both Sphinx autodoc implementations and cover re-exported types and NamedTuple references in both modes. #​1084 by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v3.15.0

Compare Source

Features

• Allow projects to show selected Annotated metadata in rendered types with typehints_annotated_metadata. #​1071 by @​gaborbernat.
• Process method signatures of classes defined inside functions when the module exports the class under a name autodoc can import. #​1072 by @​gaborbernat.
• Let typehints_formatter receive whether a type appears in a parameter, return, attribute or base when typehints_formatter_pass_context is enabled. #​1073 by @​gaborbernat.

Bug fixes

• Reread documents when typehints_formatter changes in an incremental build, so their rendered types update without sphinx-build -E. #​1069 by @​gaborbernat.
• Stop an unchanged incremental build from reporting html_static_path as changed after the extension adds its stylesheet. #​1070 by @​gaborbernat.
• Document inherited special methods of a generic subclass without raising Cannot subscript already-subscripted typing.Generic. #​1074 #​1075 by @​gaborbernat.
• Show a property setter's type when Annotated metadata raises during comparison with the getter type, instead of failing the build. #​1076 by @​gaborbernat.
• Keep the description in a hand-written :Returns: field instead of interpreting it as a numpydoc return type. #​1077 by @​gaborbernat.
• Skip imports under if TYPE_CHECKING and False instead of resolving types the branch never defines. #​1078 by @​gaborbernat.

Packaging

• Advertise Sphinx, autodoc and type hints in the PyPI keywords instead of unrelated virtual environment terms, and add classifiers for documentation, OS independence and the package's type annotations. #​1068 by @​gaborbernat.

🐍 PyPI release

📜 Full Changelog

v3.14.0

Compare Source

Features

• Show the type parameters of PEP 695 functions, classes and type aliases and of Generic[T] subclasses in their signature, such as bounded[T: int](value) and class Stack[T], with bounds, constraints and defaults. #​867 by @​gaborbernat.
• Type the keys of **kwargs: Unpack[TypedDict] documented as keyword arguments. #​869 by @​gaborbernat.
• Add an Overrides field linking the base class member a @typing.override method replaces. #​871 by @​gaborbernat.
• Show TypedDict keys a caller may omit as NotRequired[...], and add an Extra items field for PEP 728 extra_items and closed classes. #​873 by @​gaborbernat.
• Show the @warnings.deprecated message as a deprecation notice below the summary. #​874 by @​gaborbernat.
• Render a type parameter that the documented signature declares by its name, such as T instead of TypeVar(T, bound=int), and P.args and P.kwargs of a declared **P as written. #​888 by @​gaborbernat.
• Show the return type of a generator with a Yields section when its docstring has a Returns section and the third argument of its Generator annotation is not None. #​889 by @​gaborbernat.
• With typehints_use_signature, render the types kept in the signature the same way as the fields, so stubs, guarded imports, documented aliases, typehints_fixup_module_name, typehints_fully_qualified and typehints_formatter apply to both. #​895 by @​gaborbernat.
• Render PEP 661 sentinels, the Python 3.15 sentinel builtin and typing_extensions.Sentinel, by their name as a py:data reference instead of linking a nonexistent sentinel class. #​912 by @​gaborbernat.
• Type :ivar:, :cvar: and :var: fields from class-body and base class annotations, dropping ClassVar and Final qualifiers. #​916 by @​gaborbernat.
• Show the yielded type in the Yields entry of a generator, keeping a type the docstring already states. #​917 by @​gaborbernat.
• With napoleon's napoleon_use_ivar = False, type .. attribute:: entries from self.x: T annotations in __init__ unless napoleon_attr_annotations = False; a :type: already in the docstring wins. #​918 by @​gaborbernat.
• Add a Setter accepts field to a property whose setter annotation differs from the getter's return type. #​919 by @​gaborbernat.
• Substitute the type arguments a subclass binds, such as int for T under class IntStore(Store[int]), in what it inherits from a generic base, covering parameter and return fields, overloads, attribute and property headers, :vartype: fields and TypedDict keys. #​921, #​926, #​938 by @​gaborbernat.
• Show a dataclass or attrs default factory as its call, such as list(), in the signature and fields instead of <factory> or NOTHING; lambdas, partials and nested functions keep <factory>. #​922 by @​gaborbernat.
• Render the header type of data, attributes and properties the way fields render, so typehints_fully_qualified, typehints_formatter and typehints_fixup_module_name apply there and the header drops Annotated metadata. #​923 by @​gaborbernat.
• With typehints_use_signature = True, show one typed signature line per @overload instead of the untyped implementation signature and an Overloads field. #​927 by @​gaborbernat.
• Render a module-level TypeVar, ParamSpec or TypeVarTuple in docstring fields by its name, as a PEP 695 type parameter renders, instead of as a TypeVar(B, bound=Sized) call, and P.args as written instead of ParamSpecArgs(P); the name links to the variable's own entry, which shows its bound or constraints, when the docs document it. #​1044 by @​gaborbernat.
• Values in rendered types and defaults, such as 'fill' in Literal["fill", 1, None], now take the colors of the project's Pygments style in light and dark mode, the way a code block does. #​1046 by @​gaborbernat.
• Render an unpacked TypeVarTuple or tuple with the PEP 646 star, *Ts and *tuple[int, ...], instead of Unpack[Ts]; Unpack[TypedDict] for **kwargs keeps its spelling. #​1047 by @​gaborbernat.
• Leave out trailing arguments equal to their type parameter's default, so typing.ContextManager[None] renders as ContextManager[None] instead of ContextManager[None, bool | None] on Python 3.13 and later; a written typing.Generator[int, None, None] renders as Generator[int]. #​1054 by @​gaborbernat.
• Render the Bases: line of a class documented with :show-inheritance: as a docstring field renders a type, so a generic base such as Mapping[str, int] follows typehints_fully_qualified, typehints_fixup_module_name and typehints_formatter, and a PEP 695 base such as Stack[T] keeps its argument where Sphinx left it off. #​1058 by @​gaborbernat.

Bug fixes

• Render a string annotation that is not a Python expression, such as "a positive float", as written with a forward_reference warning instead of aborting the build. #​789 by @​gaborbernat.
• Load sphinx.ext.autodoc before connecting to its events, so listing this extension first or omitting autodoc no longer fails with Unknown event name. #​790 by @​gaborbernat.
• Resolve and link the other annotations of a function when Python cannot evaluate one of them, such as Django's QuerySet[...] without django-stubs-ext, also for a function re-exported with a rewritten __module__, instead of showing them all as plain text. #​791, #​901 by @​gaborbernat.
• Document a class that defines __new__ from __new__, as inspect.signature does, and take a __new__-only class's parameter types from __new__ rather than the class body. #​792 by @​gaborbernat.
• Keep numpydoc parameter descriptions with several paragraphs or a list, shared type lines such as x, y : int, and single Yields entries. #​793 by @​gaborbernat.
• Show typehints_defaults = "braces-after" defaults on their own parameter when the docstring already has :type: lines or napoleon types. #​794 by @​gaborbernat.
• Merge the return type into :returns: with typehints_use_rtype = False when the docstring also has :rtype: or its :returns: text starts on the next line. #​795 by @​gaborbernat.
• Type napoleon Attributes entries from the class, __init__ and module annotations, linked and rendered like other fields with typehints_fully_qualified, type aliases and typehints_formatter applied, unless napoleon_attr_annotations is False. #​796, #​966 by @​gaborbernat.
• Keep the first parameter of static methods bound through staticmethod(func) and of name-mangled private static methods. #​797 by @​gaborbernat.
• Link the types in the Overloads list, leave out self and cls, and show constructor overloads. #​798 by @​gaborbernat.
• Reread the sources when always_document_param_types changes, so incremental builds pick up the new setting. #​799 by @​gaborbernat.
• Strip the :no-overloads: marker from the output when typehints_document_overloads is False. #​800 by @​gaborbernat.
• Leave the return annotation off class signatures with typehints_use_signature_return = True. #​801 by @​gaborbernat.
• Show a backslash in a signature default once, as plain Sphinx does, unless strip_signature_backslash is on. #​802 by @​gaborbernat.
• Report sphinx.ext.doctest failures on the line the example starts on instead of one line late. #​804 by @​gaborbernat.
• Render a Callable parameterized by a ParamSpec or Concatenate as Callable[P, int] instead of Callable[[P], int]. #​805 by @​gaborbernat.
• Render P.args and P.kwargs as ParamSpecArgs(P) and ParamSpecKwargs(P), naming the ParamSpec they belong to. #​806 by @​gaborbernat.
• Show the PEP 696 default of a TypeVar or ParamSpec after its bound, as in TypeVar(T, bound=int, default=bool). #​807 by @​gaborbernat.
• Render a ParamSpec argument list of a generic as a list, Box[[int, str]], instead of a tuple. #​808 by @​gaborbernat.
• Render a TypeVarTuple as TypeVarTuple(Ts) linking to typing.TypeVarTuple, instead of a broken reference that loses its name. #​809 by @​gaborbernat.
• Fix broken markup and a reference warning for Optional[Union[...]] with simplify_optional_unions = False on Python before 3.14. #​810 by @​gaborbernat.
• Render aliases built with typing_extensions.TypeAliasType like type statement aliases instead of as the TypeAliasType class. #​811 by @​gaborbernat.
• Resolve names imported under TYPE_CHECKING guards written through a module alias, on one line, with a comment at column zero, or at the end of the file. #​813 by @​gaborbernat.
• Resolve the classes, type variables and aliases a class body defines in its method annotations under from __future__ import annotations. #​814, #​941 by @​gaborbernat.
• Link instance variable types imported under TYPE_CHECKING regardless of which class Sphinx documents first. #​815 by @​gaborbernat.
• Type keyword arguments documented in a napoleon Keyword Args section, and stop always_document_param_types listing them again under Parameters. #​816 by @​gaborbernat.
• With autoclass_content = "both", list each constructor parameter once, including those added through always_document_param_types or Doc(). #​817, #​925 by @​gaborbernat.
• Read stub definitions inside sys.version_info and sys.platform blocks, merge all overload variants of a stub function, and check re-exports. #​818 by @​gaborbernat.
• Link a type documented in this project to its local entry, even when another project's intersphinx inventory re-exports it under a different name. #​819 by @​gaborbernat.
• Use the role the linked inventory documents for types classes, so references resolve against docs.python.org/3 when building on Python 3.12. #​820 by @​gaborbernat.
• Resolve names imported under TYPE_CHECKING in attrs class fields, fixing a NameError crash on Python 3.14 and a forward-reference warning on older versions. #​822 by @​gaborbernat.
• Fix an AttributeError building man pages for projects that document a function taking a type alias. #​823 by @​gaborbernat.
• Pass the Sphinx config to typehints_formatter when rendering signatures with typehints_use_signature or typehints_use_signature_return. #​824 by @​gaborbernat.
• Parse type text as inline markup, so list-like text such as an unresolvable "* weird" annotation stays inline instead of producing a list or crashing. #​825 by @​gaborbernat.
• Keep a function's other type hints and warn forward_reference when an annotation names a missing module attribute, such as typing.TypeIs on Python 3.12. #​826 by @​gaborbernat.
• Import the submodules a .pyi stub refers to through import pkg.sub or from . import sub, so their types are no longer dropped. #​827 by @​gaborbernat.
• Resolve annotations in the module that defines an object, so re-exported objects with a reassigned __module__ find their TYPE_CHECKING imports. #​828 by @​gaborbernat.
• Show a plain-assignment alias documented with .. py:type:: by name only where the annotation writes that name, whatever order Sphinx reads the entries in, so int parameters no longer render as an alias of int. #​829, #​920 by @​gaborbernat.
• Apply documented aliases following Python name lookup, so methods see their module's aliases and unrelated aliases elsewhere in the package no longer replace a type. #​830 by @​gaborbernat.
• Link a type alias to its own entry, not to a different documented alias with the same name. #​831 by @​gaborbernat.
• Run TYPE_CHECKING guards written as if not TYPE_CHECKING: ... else: or combined with and/or, so their imports resolve. #​833 by @​gaborbernat.
• Read self.x: T annotations nested in if, try, with, loop and match blocks of __init__, and handle a positional-only self. #​834 by @​gaborbernat.
• Strip types from the signature of functools.cache and functools.lru_cache decorated functions on Python 3.14. #​835 by @​gaborbernat.
• With napoleon_use_param = False or napoleon_use_keyword = False, type the entries of napoleon's combined parameter field, add their defaults, and list the parameters the extension adds there instead of in a second list. #​836, #​886 by @​gaborbernat.
• With typehints_defaults, show the default of a parameter typed only in its docstring, whether through a :type: line, a :param str c: field or napoleon's combined parameter field. #​837, #​884 by @​gaborbernat.
• Keep the annotations in the signatures of functools.singledispatch implementations, so each registered implementation shows the type it dispatches on. #​838 by @​gaborbernat.
• With typehints_defaults, render defaults the way the signature does, without memory addresses, with enum members by name and with sets in a stable order. #​839 by @​gaborbernat.
• Keep backslashes in Literal values, so Literal["\n"] renders as written instead of Literal['n']. #​840 by @​gaborbernat.
• Render tuple[()] and Tuple[()] as the empty tuple instead of a bare tuple. #​841 by @​gaborbernat.
• Expand a generic type alias passed to itself, such as Pair[Pair[int]], instead of dropping the inner arguments. #​842 by @​gaborbernat.
• Show the enum of a Literal member, as Literal[Color.RED, Light.RED] instead of Literal[RED, RED]. #​843 by @​gaborbernat.
• Render subscripted types from autodoc_mock_imports modules, such as NDArray[float64], instead of a garbled name. #​844 by @​gaborbernat.
• Render Literal string values that contain backticks without breaking the surrounding markup. #​845 by @​gaborbernat.
• Keep the | of a union around an autodoc_type_aliases name on Python 3.12 and 3.13 instead of rendering Optional or Union. #​846 by @​gaborbernat.
• With typehints_defaults = "braces-after", put the default at the end of the last plain paragraph of the description instead of inside a trailing list, directive or literal block. #​847 by @​gaborbernat.
• Treat numpydoc's .. placeholder as no description, so entries without one render as x (int) instead of x (int) -- ... #​848 by @​gaborbernat.
• Keep the numpydoc Returns description of a function without parameters instead of adding a second one from the return annotation's Doc(). #​849 by @​gaborbernat.
• Keep the text of a napoleon NumPy-style Returns section that only describes the value. #​850 by @​gaborbernat.
• Replace a multi-line docstring :rtype: as a whole instead of leaving its continuation lines behind. #​851 by @​gaborbernat.
• With typehints_use_rtype = False, add the return type to a :returns: description that contains --. #​852 by @​gaborbernat.
• Add parameters documented through always_document_param_types or Doc() in signature order among the documented ones instead of in a second list at the end of the docstring. #​853 by @​gaborbernat.
• Place the return type before Sphinx directives such as versionadded, deprecated and seealso, as before docutils directives like note. #​854 by @​gaborbernat.
• Link autodoc_type_aliases targets documented as module data or in a document read later. #​855 by @​gaborbernat.
• Link a documented generic type alias even when the docs have no entry for its arguments, instead of expanding it. #​856 by @​gaborbernat.
• Link names that only typing_extensions provides on the running Python, such as TypeIs on 3.12 and Doc, to typing_extensions instead of a missing typing target. #​857 by @​gaborbernat.
• Stop hiding @overload signatures from other Sphinx apps in the same process that do not load the extension. #​858 by @​gaborbernat.
• Report warnings about admonition content at the right line in documents that use .. include::. #​859 by @​gaborbernat.
• Report an invalid typehints_defaults or typehints_formatter value as a configuration error instead of an extension crash with a traceback. #​860 by @​gaborbernat.
• Stop warning Unparsable type hint comment for a lambda assigned with a variable type comment. #​861 by @​gaborbernat.
• Keep the name and type of a single numpydoc Returns entry, rendering ratio (float) -- The ratio.. #​862 by @​gaborbernat.
• Stop printing docutils errors for docstrings of members left out of the output, such as imported ones under undoc-members. #​863 by @​gaborbernat.
• Keep a numpydoc Other Parameters section under its own heading instead of merging it into Parameters. #​864 by @​gaborbernat.
• Keep the star of an unpacked *tuple[...], rendering it as Unpack[tuple[...]]. #​865 by @​gaborbernat.
• Render bounded and defaulted type variables as TypeVar(T, bound=int) without a gap after the =. #​866 by @​gaborbernat.
• Keep the type inside InitVar[...] instead of rendering a bare InitVar. #​875 by @​gaborbernat.
• Leave :param:, :returns: and :yields: lines inside literal blocks and directives alone instead of treating them as the object's fields. #​876 by @​gaborbernat.
• Type functools.partial objects, partialmethod and callable instances from the function they call, moving the annotations from the signature into the fields. #​877 by @​gaborbernat.
• Show an annotation whose evaluation raises any exception, including a type alias whose value raises, as written instead of crashing the build or dropping the object. #​878, #​897 by @​gaborbernat.
• Stop dropping module data and class attributes that hold an annotated callable with list assignment index out of range. #​879 by @​gaborbernat.
• Drop cls from the signature of a @classmethod stacked on another decorator such as functools.cache. #​880 by @​gaborbernat.
• Stop the cannot cache unpickleable configuration value warning for typehints_fixup_module_name, and re-read the documents only when that function's source changes instead of on every build. #​881, #​937 by @​gaborbernat.
• Document a class or function that sets __signature__, such as a pydantic model, by that signature with its fields typed. #​883 by @​gaborbernat.
• With typehints_use_rtype = False, keep the inline return type when the docstring had an :rtype: field. #​885 by @​gaborbernat.
• Leave the location out of warnings about code without a source file, such as the __init__ that dataclasses and attrs generate, instead of pointing at a nonexistent <string>.rst. #​887 by @​gaborbernat.
• Honor autodoc_typehints_format = "fully-qualified": typehints_fully_qualified defaults to it, so fields, signatures and type parameters show full paths. An explicit typehints_fully_qualified still wins. #​891 by @​gaborbernat.
• Link pipe unions of mocked types, such as Gen[int] | None under autodoc_mock_imports, which rendered as unlinked text on Python 3.14 or with from __future__ import annotations. #​892 by @​gaborbernat.
• Mock a module that a .pyi stub imports with a plain import but that is not installed, so types like npt.NDArray render as cross-references instead of raising a forward_reference warning. #​893 by @​gaborbernat.
• Keep a signature written in the directive, such as .. autofunction:: mod.f(x, y=3), or read from the docstring through autodoc_docstring_signature, when it names other parameters than the object takes, instead of replacing it with the object's own. One made of *args and **kwargs alone still gets the object's parameters (#​903). #​896 by @​gaborbernat.
• Format the stub type of a C attribute (getset or member descriptor) with the intersphinx role and documented type aliases that parameter types use, fixing broken cross-references. #​902 by @​gaborbernat.
• Reread the pages that use a .pyi stub when the stub changes, so an incremental build picks up the edit. #​905 by @​gaborbernat.
• Place the Overloads list after a literal block that the summary introduces with ::, instead of inside it. #​907 by @​gaborbernat.
• Show the positional-only / and keyword-only * markers, defaults and the stars of *args and **kwargs in Overloads entries. #​910 by @​gaborbernat.
• Stop rendering bound="None" on an unbound ParamSpec on Python 3.12 and early 3.13 releases. #​911 by @​gaborbernat.
• Show a backslash in a parameter default once in the field instead of doubled, in every typehints_defaults mode. #​913 by @​gaborbernat.
• Fix an Explicit markup ends without a blank line warning when numpydoc processes a docstring without a Parameters section and the extension adds parameter types. #​914 by @​gaborbernat.
• Fix a crash on a generator whose return annotation is unhashable, such as Annotated[Iterator[int], {"unit": "m"}], when its docstring has a Yields section. #​928 by @​gaborbernat.
• Follow the __signature__ a decorator sets on its wrapper, so the signature and the parameter fields list the parameters callers pass instead of those of the wrapped function; the signature shows types only under typehints_use_signature. #​931, #​946 by @​gaborbernat.
• Unwrap an Annotated return annotation before checking it, so an Annotated generator types its Yields entry instead of getting a return type, and typehints_document_rtype_none = False hides Annotated[None, ...]. #​939 by @​gaborbernat.
• Stop unwrapping at a Sphinx mock, which cost about two seconds for each mocked object the extension processed. #​954 by @​gaborbernat.
• Run a module's if TYPE_CHECKING: block without writing to the module, so the names it defines, such as @overload stubs or Protocol classes, no longer replace runtime bindings or show up as module members. #​960, #​984 by @​gaborbernat.
• Keep the subscript arguments of a class whose __class_getitem__ returns the class itself, such as SQLAlchemy's TypeEngine[Any], in headers, parameter and return fields, signatures, overloads and :ivar: types. #​963 by @​gaborbernat.
• Resolve names that two modules' if TYPE_CHECKING: blocks import from each other to their guarded types, whichever module Sphinx documents first. #​969 by @​gaborbernat.
• Leave hand-written reST field lists, such as docutils' :Parameters: definition lists, alone instead of converting them as numpydoc output into empty :param : fields. #​979 by @​gaborbernat.
• Keep the signatures and docstrings of the Sphinx, docutils and napoleon methods the extension patches, so a project documenting those libraries shows their own signatures and docstrings. #​980 by @​gaborbernat.
• Resolve annotations that reach a type through a module alias imported under TYPE_CHECKING, such as _t.UriType in requests, instead of dropping the type. #​985 by @​gaborbernat.
• Link a class that a .pyi stub defines to the module the stub describes, such as ext.Config, instead of rendering it as an unresolved bare Config when the function is documented through a re-export. #​1011 by @​gaborbernat.
• Stop aborting the build on a parameter annotated with the bare typing.NewType class or typing.Annotated form; the field names it as a reference, as the signature does. #​1013 by @​gaborbernat.
• Overloads of a class documented with .. autofunction:: no longer list self and -> None, and overloads of a function documented with .. autoclass:: keep their first parameter and return types. #​1014 by @​gaborbernat.
• Link a name in the type of a data, attribute or property header the way the fields do, so the builtin type no longer links to an unrelated documented attribute such as Event.type. #​1017 by @​gaborbernat.
• Link a type an intersphinx inventory lists under both a py:class and a py:data name to the class entry on every build, instead of a name that changed with PYTHONHASHSEED. #​1018 by @​gaborbernat.
• Documenting a NamedTuple's __new__ on its own, with automethod or :special-members: __new__, no longer warns that names its fields use, such as Path or int, are not defined. #​1019 by @​gaborbernat.
• An attribute a generic base annotates in __init__ now shows the type a subclass binds, such as int for class Child(Base[int]), in that subclass's :ivar: fields instead of the bare type parameter. #​1020 by @​gaborbernat.
• Document a constructor, property setter or overload decorated by something from autodoc_mock_imports without aborting the build with wrapper loop when unwrapping. #​1022 by @​gaborbernat.
• Documenting a function typed only by its stub or by type comments no longer writes those types into the function's __annotations__, so the object reads the same after a build as before it. #​1025 by @​gaborbernat.
• A typehints_formatter that returns an empty string now hides the type instead of showing raw :sphinx_autodoc_typehints_type: text in docstring fields or an empty annotation such as attr: = 1 in headers and signatures, and drops the Return type, Extra items and Setter accepts fields it empties. #​1026 by @​gaborbernat.
• Link an alias, whether a type statement or a module-level Count = int, used by an automodule member when its py:type comes later on the page, instead of expanding it to its value. #​1027 by @​gaborbernat.
• A process running more than one Sphinx build now reads the TYPE_CHECKING block of each module again in every build, so a module edited and imported again between builds renders its new types. #​1030 by @​gaborbernat.
• Link an enum member inside Literal to its enum when the member has no entry of its own, such as a member without a docstring under :members:, instead of rendering it unlinked with a nitpicky warning. #​1035 by @​gaborbernat.
• Link None, True and False inside Literal[...] to the Python docs, the same way None links outside it, instead of rendering them as plain text. #​1038 by @​gaborbernat.
• A class whose __module__ is None now renders as its bare name instead of a broken cross-reference to None.ClassName. #​1039 by @​gaborbernat.
• Types a typehints_formatter writes between bare backticks inside an expanded type alias now use the document's default_role, as they do outside an alias, instead of rendering as italic text. #​1040 by @​gaborbernat.
• Stop importing every module an intersphinx inventory lists at the start of the build; the extension now imports only the modules that list a class an annotation names, so mapping the numpy or torch inventory no longer imports them. #​1045 by @​gaborbernat.
• Stop replacing napoleon's attribute annotation lookup for every Sphinx project in the process; the extension now turns napoleon_attr_annotations off for napoleon in its own project only, so the first build after upgrading re-reads every document once. [#​1048](https://redirect.github.com/tox-dev/sphi

[!IMPORTANT]
✂ PR body was truncated to here.

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.