fix(deps): update all non-major dependencies #51

Open
renovate-bot wants to merge 1 commit from renovate/all-minor-patch into main
Collaborator

This PR contains the following updates:

Package Change Age Confidence
faiss-cpu ==1.15.1 → ==1.16.0 age confidence
pytest (changelog) ==9.1.1 → ==9.2.0 age confidence
pytest-asyncio (changelog) ==1.4.1.post1 → ==1.5.0 age confidence
sphinx-autodoc-typehints (changelog) <3.13.11 → <3.17.6 age confidence

Release Notes

facebookresearch/faiss (faiss-cpu)

v1.16.0

Compare Source

Added

Changed

  • f34c0b8 Move the macOS arm64 CI jobs from macos-14 to macos-15 (#​5875)
  • 741138a E-means: quality batch at d <= 16 and no revival at d <= 2 by default (#​5854)
  • 731286f e-means: faiss-style verbose output that reports epochs and asks for a citation (#​5841)
  • 277b3c7 e-means: rename niter to nepochs (#​5848)
  • a15797a Compute the coarse distances in search_preassigned when they are not given (#​5748)
  • b955264 Replace the e-means README with a user guide (#​5842)
  • e4500c2 Use BF16 defaults and share quantized rows across E-means sharding (#​5844)
  • 0a6f936 Emeans ssd speedups (#​5839)
  • 9246aa7 Rename e-means operating_point to batch_law, allow batch_size without alpha0, and default niter to 5 (#​5833)
  • 22a0cb7 Separate Emeans implementations (#​5840)
  • 1d40eeb Speed up the x86 8-bit scalar quantizer inner-product distance (#​5829)
  • efd79c9 Upgrade CPU CMake CI to PyTorch 2.15 (#​5827)
  • 0b0250d SQ fp16 and bf16: four accumulators per code at d >= 384, any d at AVX-512 (#​5806)
  • a3217cb Give each SIMD level its own copy of the 65 shared functions (#​5810)
  • 2a6e785 Define the AVX-512 SQ specializations once for AVX512 and AVX512_SPR (#​5808)
  • c2d27c6 Search only the sample vectors at sinks after each round of HNSW level-0 links (#​5804)
  • 9d5b442 Codify the Faiss SIMD guard rules and check them with a test (#​5793)
  • 0d3c380 Move SIMD code to dedicated translation units and align guards (#​5792)
  • 03aa1bd Give fvec_L2sqr_ny_y_transposed_D internal linkage in the AVX2 and AVX512 files (#​5788)
  • 167f443 Prefetch graph rows and vectors in PiPNN search (#​5805)
  • ea99cbc SVS 0.5.0 (#​5785)
  • 0c2cad8 Run the Windows conda CI steps in bash (#​5795)
  • 35a4ec2 Use 3 sample vectors per node by default for HNSW level-0 links (#​5789)
  • 1ec0011 Hamming: vector popcount for the default computer at AVX512 and AVX512_VPOPCNT (#​5787)
  • fc65960 Use a SIMD masked sum for the fp32 RaBitQ 1-bit estimate (#​5782)
  • d37bede Train ProductQuantizer subquantizers in parallel (#​5783)
  • 386c96b Default alpha to 1.2 for all metrics (#​5786)
  • 0a32a42 Scale the HNSW and PiPNN search check period by the thread count (#​5784)
  • c919a60 Dispatch RaBitQ scans once per inverted list (#​5597)
  • 6907ed1 Prune inner-product graphs on cosines when norms vary (#​5774)
  • e353ed7 8-bit PQ code distance: 4-sum scalar kernel instead of gathers on AMD Zen 3/4/5 (#​5751)
  • 9e16309 Build PiPNN graphs over distinct codes (#​5768)
  • 7834aba Size IVF fast-scan slice LUTs on the calling thread (#​5721)
  • 2732125 Dispatch more dimensions to the SIMD fvec_L2sqr_ny_transposed kernels (#​5757)
  • ee6927d ivflib::search_with_distance_to_code: search through InvertedListScanner::distance_to_code (#​5755)
  • 56c96d5 Move Faiss C++ tests to Python (#​5743)
  • a55e0b2 Upgrade cuVS to 26.10 (#​5633)
  • 494330f Speed up the NEON 8-bit scalar quantizer L2 distance (#​5733)
  • 1a9ddc6 Use monotonic dynamic scheduling so libomp 12 does not take its static-steal path (#​5723)
  • 3fc6bcd On ROCm, stage pageable host copies in pinned memory (#​5712)
  • cec5702 DD: give fvec_L2sqr_ny_nearest_y_transposed_D internal linkage (#​5720)
  • db6aa06 Hoist per-list allocations out of the IVF fast-scan search loops (#​5717)
  • 3907966 Select OpenBLAS OMP build in conda for AArch64 + Linux (#​5669)
  • 44afa77 Stop allocating per (query, probe) on OpenMP workers in IVF RaBitQ fast-scan (#​5716)
  • 6692d7a Stop copying QueryFactorsData per block in RaBitQHeapHandler
  • 3a98062 faiss/conda: extend LSQ NEON-flaky test skip to all arm64 (#​5713)
  • 2839c39 Make the GPU IVF search return the same neighbours on every run (#​5682)
  • a2f7943 Optimize 4-bit PQ fastscan accumulation on Arm CPUs (#​5709)
  • 83ae8b0 Move the RVV distance kernels into free-standing headers (#​5697)
  • 1dab0c1 Quarantine unstable cuVS Python GPU tests (#​5699)
  • ae4466d Avoid widening fp16 data for k-means++ initialization (#​5693)
  • ea9151d RaBitQ: broadcast one sign word per 32 dims in the AVX2 RBQ9 kernel (#​5696)
  • 4102312 Defer IVF list scan setup until needed (#​5595)
  • fdb9535 Make search stats collection configurable (#​5670)
  • 7f6bf10 Halve IndexSQFastScan rerank memory with a split-nibble layout (#​5662)
  • b1c1496 migrate from bit-manipulation builtins in fbcode/faiss (#​5667)
  • 2496f63 Avoid search stats contention during concurrent search (#​5663)
  • 3f4838e Batch the IVF ScalarQuantizer scan four codes at a time (#​5456)
  • 1dbb3d2 Update backward compatibility test to v1.15.1 (#​5646)

Fixed

Deprecated

pytest-dev/pytest (pytest)

v9.2.0

Compare Source

pytest 9.2.0 (2026-10-27)

Removals and backward incompatible breaking changes

  • #​14716: -c now raises a usage error for a path that does not exist, is a directory, or is in a format pytest has no loader for. Such paths were previously either ignored or reported as an unhandled FileNotFoundError.

  • #​8593: The indirect, ids and scope arguments of Metafunc.parametrize() <pytest.Metafunc.parametrize> -- and therefore of @pytest.mark.parametrize <pytest.mark.parametrize ref> -- are now keyword-only.

    Passing them positionally was a common source of confusing errors, e.g. parametrize("arg1", "arg2", [(1, 2)]) made the argvalues land in indirect and failed with indirect fixture '(1, 2)' doesn't exist; such mistakes now fail with an understandable TypeError. The type annotations have always declared these arguments as keyword-only.

  • #​993: Plugin import failures at startup are now reported and classified instead of escaping as a raw traceback with the accidental exit code 1:

    • a plugin that cannot be found -- via -p, pytest_plugins or PYTEST_PLUGINS -- exits with pytest.ExitCode USAGE_ERROR (4), like a conftest.py that fails to import;
    • a plugin that is found but raises while importing -- including a broken pytest11 entry point or a missing plugin dependency -- exits with pytest.ExitCode INTERNAL_ERROR (3), with the traceback preserved.

    pytest.main now returns these codes instead of raising ImportError. Also fixed an IndexError from pytest's own internals when the plugin raised an exception with no arguments.

Deprecations (removal in next major release)

  • #​14742: The private _pytest.python.CallSpec2 name has been renamed to CallSpec.
    The old CallSpec2 alias remains available for now and will be removed in pytest 10 or 11.

  • #​14755: Schedule yield_fixture decorator for removal in pytest 10 or 11.

  • #​14774: Similarly to the deprecation of class-scoped fixtures defined as instance methods in pytest 9.1,
    all higher-scoped fixtures (module, package, and session) defined
    as instance methods are now deprecated.

    They suffer from the same issue the original deprecation only fixed for
    class-scoped fixtures, see 10819 and 14011.

  • #​14808: Passing a non-string value to a string-typed ini option now emits a pytest.PytestRemovedIn10Warning. This affects [tool.pytest.ini_options] in pyproject.toml. In pytest 10 this will raise a TypeError, matching the behavior of the corresponding TOML config path.

  • #​7323: Passing bytes to TerminalReporter.write_line() is now deprecated, pass a str instead.

New features

  • #​14743: Full diff: now contains a legend explaining the + & - symbols in diff output.
  • #​2781: When strict_markers is enabled, marker names used in -m expressions are now validated against registered markers.
  • #​6881: Added the parametrize_long_str_id_strategy configuration option to control how long str/bytes parameter values are handled in auto-generated test IDs. Explicit IDs set via ids=[...] or pytest.param(..., id=...) are not affected. Available strategies: short (default, values over 100 chars fall back to argname+index), sha256 (SHA-256 hex digest), legacy (keep full value), and disallow (error requesting explicit IDs).

Improvements in existing functionality

  • #​10745: A RecursionError whose recursion origin cannot be located now shows only the
    first and last 10 stack frames, matching what pytest already did when locating
    the origin failed outright. Previously the full traceback -- often around a
    thousand near-identical frames -- was rendered, which was both slow and
    unreadable. Pass --full-trace to see every frame.

  • #​10745: The line numbers of a module's statements are now computed once per traceback
    instead of once per traceback entry, which noticeably speeds up rendering
    failures raised from large test modules.

  • #​11418: The cached rewritten modules in __pycache__ are now invalidated by a hash of
    the source instead of its modification time, using the checked-hash pyc format
    from 552.

    Timestamps make the cache useless wherever source files get fresh modification
    times, most notably in CI: a checkout gives every file a new mtime, so a
    restored cache is discarded in full and every test module is rewritten again.
    Hashing the source costs roughly 15 microseconds per file and makes the cache
    survive that.

    Existing timestamp based caches are ignored and rewritten once.

  • #​12624: The pytest_plugins variable and the PYTEST_PLUGINS environment variable now also accept entry point names of installed plugins (e.g. xdist), in addition to importable module names, matching the behavior of the -p command-line option.

    As part of this change, plugins specified by entry point name through these mechanisms are now also listed in the plugins: line of the terminal header (12615).

    Based on the original implementation by Marcel Telka in 12616.

  • #​12697: Warnings emitted while importing plugins through -p, PYTEST_PLUGINS, or entry point autoloading are now captured, filtered, and reported like other warnings.

  • #​12860: Assertion diffs for dict.items() and dict.keys() comparisons (>=, <=, >, <, ==) now show which items are missing, the same way set comparisons do.

  • #​13354: Node.get_closest_marker <_pytest.nodes.Node.get_closest_marker> now also accepts a ~pytest.MarkDecorator as its default, for example item.get_closest_marker("foo", pytest.mark.foo(1)), and returns the wrapped ~pytest.Mark.

    Previously the only way to build a default was to instantiate ~pytest.Mark directly, which is private and warns.

  • #​13369: Improved the error from pytest.RunResult.assert_outcomes when a plugin changes or removes pytest's standard terminal summary, and documented how to isolate output-changing plugins.

  • #​13431: Exposed pytest.ParameterSet as the type of the return value of pytest.param().
    This can be used in type annotations and isinstance checks.

  • #​13564: Issue a warning when fixtures are wrapped with a decorator that prevents
    correct discovery, including @classmethod above @pytest.fixture and
    @staticmethod above @pytest.fixture. Put @pytest.fixture above
    those decorators on test classes.

  • #​14164: Exposed pytest.Approx as the type of the return value of pytest.approx().
    This can be used in type annotations and isinstance checks.

  • #​14463: Assertion diffs for mappings now match up keys the way the compared mappings match them themselves.

    Key comparison goes through the mappings' key views instead of plain sets of their keys, so a mapping
    with its own notion of key equivalence, such as case-insensitive header mappings, no longer
    reports its common keys as missing on either side.

  • #​14523: Large assertion comparison diffs are now built lazily and capped to the
    truncation budget, so a huge diff is no longer formatted in full just to
    be truncated. As a consequence, the truncation footer no longer
    reports the exact number of hidden lines.

  • #​14687: The default fd-level output capturing (--capture=fd) now skips reading the capture buffer for tests which produce no output, reducing per-test overhead in large test suites.

  • #​14724: --no-summary now only applies directly to pytest's own summary.

    The flag no longer skips the pytest_terminal_summary hook, so third-party
    plugins (for example coverage) can still write their terminal summaries.

  • #​14751: parser.addini <pytest.Parser.addini> now also accepts type expressions for its type argument, in addition to the existing string tags: the plain Python types str, bool, int, float, a Literal of strings, and unions of these (for example int | str or int | Literal["auto"]).

  • #​14754: pytest.approx() now rejects infinite relative tolerances for datetime.timedelta values with a clear ValueError instead of raising OverflowError.

  • #​14791: The junit_family, junit_logging, junit_duration_report, console_output_style, empty_parameter_set_mark, assertion_text_diff_style and tmp_path_retention_policy configuration options are now registered with the set of values they accept: an invalid value now fails with a clean usage error instead of being silently ignored or crashing later, and pytest --help lists the accepted values.

    config.getini <pytest.Config.getini> now raises pytest.UsageError instead of TypeError or ValueError when the value read from the configuration file does not match the registered type, so a bad value is always reported as a short usage error message instead of an internal error traceback. Asking for an option name that was never registered still raises ValueError.

  • #​15006: pytest.approx now emits pytest.PytestApproxDecimalToleranceWarning when a rel or abs tolerance is given as a float that cannot be represented exactly for a ~decimal.Decimal comparison, since such a tolerance is widened to the float's exact binary value.

  • #​14675, #​14953, #​15153, #​15132: The truncation_limit_lines, truncation_limit_chars, max_warnings, verbosity_assertions, verbosity_test_cases, verbosity_subtests, tmp_path_retention_count, log_level, log_cli_level, log_file_level,log_auto_indent and faulthandler_timeout configuration options now accept native integer (and, for log_auto_indent, boolean) values in TOML configuration files, while still accepting strings for backward compatibility.
    log_file_mode now reports invalid values as a usage error.

  • #​15254: tmp_path and TempPathFactory.mktemp <pytest.TempPathFactory.mktemp> no longer list the whole base temporary directory on every call, which made sessions with many temporary directories quadratically slow. Numbers are now handed out from a per-prefix counter, skipping names that already exist.

  • #​4569: Node.add_marker <_pytest.nodes.Node.add_marker> now stores a ~pytest.Mark in node.keywords, matching what marks applied during collection store. Previously it stored a ~pytest.MarkDecorator.

  • #​9436: Avoided formatting tracebacks for tests marked with xfail(run=False).

Bug fixes

  • #​10128: Configured warning filters now apply to warnings emitted by pytest_configure hooks.

  • #​10210: pytest.approx now raises a TypeError for any nested container, not
    only for one of the same type as its parent. Previously approx([{"k": 1}])
    and approx({"k": [1]}) were accepted and then compared unequal to every
    value, silently ignoring the tolerance, while approx([[1]]) correctly
    reported that nesting is unsupported.

  • #​10644: monkeypatch.setattr() no longer leaves a new entry in the instance __dict__ when it patches an attribute that the instance inherits from its class.

    Previously undo() assigned the inherited value onto the instance, which shadowed the class attribute -- permanently freezing the result for descriptors that resolve dynamically.

  • #​1139: Fixed tracebacks showing ??? instead of source lines for code compiled with a filename relative to a directory other than the current working directory -- e.g. compiled Cython modules, when running pytest from a subdirectory of the project root.
    The source lookup now falls back to searching sys.path for such filenames, as the standard traceback module does.

  • #​11502: The rootdir is no longer derived from a configuration file that is not a regular file, such as --config-file=/dev/null.

  • #​11783: Plugins installed in editable mode (660) are marked for assertion rewriting again.

    Such installs do not record the package's Python files in the distribution metadata, so pytest found nothing to rewrite and assertions inside the plugin lost their introspection. The plugin's entry point is now used to locate the package in that case.

  • #​11933: pytest.warns no longer re-emits unmatched warnings with module="warnings", which caused module-based warning filters to be applied to the wrong warnings. Since warnings.WarningMessage does not record the module a warning was emitted with, re-emitted warnings now use the standard warnings.warn_explicit default of deriving the module from the warning's filename.

  • #​12175: ExceptionInfo.exconly(tryshort=True) <pytest.ExceptionInfo.exconly> now strips the AssertionError: prefix of failed assert statements for ~pytest.ExceptionInfo objects created by pytest.raises, and failures inside unittest.TestCase.subTest report the same short crash line as regular tests.

  • #​12223: The message attribute of <failure> and <error> elements in --junitxml reports is now shortened to whole lines within 500 characters. When something is dropped, it ends with a note pointing to the element text, which still holds the full report. Previously, very verbose assertion output (e.g. with -vv) produced attributes tens of thousands of characters long, which some XML parsers fail on.

  • #​12307: Fixed truncation of long collections (lists, dicts, sets, etc.) in the "message" part of failed assertions (as in assert condition, msg) when using -vv: the message now uses the same unlimited repr as the rest of the assertion output, instead of eliding collection elements with ....

  • #​12824: Custom command-line options now fail with a clear error when their implicit
    destination conflicts with an existing option, avoiding silent overrides of
    built-in options such as -k.

  • #​13292: Fixed a stale rewritten module being used when a test file is modified twice
    within the same second without changing its size -- the pyc header could only
    record whole-second timestamps. The cache is now keyed on a hash of the source.

  • #​14036: __tracebackhide__ is now respected in ExceptionGroup tracebacks, both for the group itself and for its sub-exceptions.

  • #​14189: Nested usage of caplog.filtering <pytest.LogCaptureFixture.filtering> no longer removes filters early if they were already present.

  • #​14412: Fixed incorrect timing information for subtests and parent tests when console_output_style = "times".

  • #​14445: Assertion rewriting no longer evaluates walrus operator (:=) expressions more than once, which reported results the test never computed when the expression had side effects.

    An operand evaluated before a later walrus is now reported with the value it actually saw, so assert value != identity(value := value.lower()) keeps Python's left-to-right order.

  • #​14552: Fixed stale co_filename values after a test module or directory is moved. Assertion-rewrite caches are reused when the source hash still matches, and in-memory code objects are pointed at the current path.

  • #​14586: Negative values passed to log_auto_indent now correctly fall back to no indentation, matching the documented behavior.

  • #​14619: Fixed a crash in pytest.mark.parametrize when a non-sequence value is passed for a parameter set. It now provides a clear error message during collection.

  • #​14635: Fixed fixture resolution failures when specifying multiple test paths on the command line that share common parent directories. Parametrized fixtures defined in a conftest.py could be silently dropped depending on the order of the specified paths.

  • #​14637: Pytest now correctly skips identical trailing characters in assertion text diffs even when the compared strings differ at the beginning.

  • #​14638: Top-level options in pytest.toml and .pytest.toml files now raise an error instead of being silently ignored when no [pytest] table is present.

  • #​14683: Fixed a regression in pytest 9.1 where a conftest.py located in the rootdir was no longer visible to tests and doctests collected from outside the rootdir (for example when passing a parent directory of the rootdir as a collection argument, or setting --rootdir to a subdirectory).

    As a result, fixtures defined in such a conftest -- including doctest_namespace injections -- were not available, causing errors such as NameError in doctests.

  • #​14700: Fixed an internal error on Python 3.12 when a doctest on a fixture-decorated function was skipped.

  • #​14705: TOML configuration files passed via -c now also read their configuration from the [pytest] table, the one pytest's own configuration files use. The [tool.pytest] and [tool.pytest.ini_options] tables such files were previously restricted to keep working; using both styles in one file is an error.

  • #​14828: Exception groups raised from another exception now print their cause chain only once in the traceback output.

  • #​14864: Fixed collection on Windows collecting the whole suite instead of the given path, on file systems which do not support file IDs (st_ino is 0 for every file, as seen for example on sshfs-win/WinFsp mounts).

  • #​14884: Cache.get(), Cache.set() and Cache.mkdir() now reject keys that resolve outside the cache directory, and --cache-show ignores glob matches outside it.

  • #​14909: Fixed MonkeyPatch.delattr <pytest.MonkeyPatch.delattr>, MonkeyPatch.setitem <pytest.MonkeyPatch.setitem> and MonkeyPatch.delitem <pytest.MonkeyPatch.delitem> recording a stale undo entry when the underlying mutation failed, which could cause spurious errors during teardown. The undo entry is now recorded only after the mutation succeeds, matching the behavior of MonkeyPatch.setattr <pytest.MonkeyPatch.setattr>.

  • #​14912: ~pytest.PytestWarning instances defined in _pytest.deprecated are no longer reused across warnings.warn calls, so warnings raised as errors (e.g. with -W error) no longer accumulate stale traceback frames from previous raises.

  • #​14942: Fixed a regression in 9.1.0 that made collection very slow (quadratic) when many fixtures are defined with the same name.
    This can happen particularly when many tests are defined in separate classes which inherit from a base class which defines fixtures (the fixtures are repeated per class).

  • #​15005: pytest.approx no longer treats finite ~decimal.Decimal values outside the float range (such as Decimal("1e400")) as infinite, which made in-tolerance comparisons fail.

  • #​15006: Restored the tolerance shown by pytest.approx for ~decimal.Decimal values, which since 9.0 displayed ??? for the default tolerance and reported the raw rel ratio instead of the absolute tolerance actually compared against.

  • #​15006: The failure message for pytest.approx comparisons of ~decimal.Decimal collections no longer reports Max absolute difference: -inf, or crashes for mappings, when the decimal.FloatOperation trap is set.

  • #​15006: pytest.approx no longer raises AttributeError when comparing numpy.ndarray instances with object dtype, such as arrays of ~decimal.Decimal.

  • #​15032: Help texts for command-line options and configuration options now keep their indentation
    and blank lines. Previously each line was stripped before wrapping, so a wrapped
    list item was indistinguishable from a new one and blank lines were dropped; configuration
    option help lost its line breaks entirely.

  • #​15043: Cache writes now emit pytest.PytestCacheWarning when writing or closing the cache file fails, consistent with errors opening the file.

  • #​15052: Fixed possible off-by-one line numbers in --fixtures and --fixtures-per-test output.

  • #​15145: With console_output_style set to times, durations just below a unit boundary are now shown in the next unit (e.g. 1.000ms instead of 1000.0us).

  • #​15172: Assertion diffs now pretty-print the built-in frozendict (Python 3.15+) across multiple lines, similarly to how dict is displayed.

  • #​4569: -k no longer matches attributes that end up in a test function's __dict__ without being meant as keywords, such as pytest's own pytestmark attribute and the bookkeeping left behind by functools.wraps and functools.lru_cache.

  • #​6750: Fix fixture argument discovery for custom collectors that pass bound methods to pytest.Function.

  • #​6997: XFAIL reports from teardown phases now include the phase in the short test
    summary.

  • #​7940: Fixed cleanup of temporary directories failing when subdirectories have their execute permission removed.

  • #​8321: Fixed exception chains being duplicated in the traceback output when an exception in the chain (__cause__/__context__) has no traceback of its own, and that exception is itself linked to further exceptions.

  • #​8914: Tests parametrized with higher-than-function scope are now reordered by
    parameter value rather than by parameter index, so that items using equal
    parameter values are grouped together and share a single fixture setup, even
    when they are parametrized by separate @pytest.mark.parametrize <pytest.mark.parametrize ref>
    calls. Previously, an expensive higher-scoped fixture could be set up and torn
    down repeatedly for the same parameter value.

    Unhashable parameter values (e.g. dicts) keep the previous index-based
    grouping behavior.

    As a consequence, the order in which parametrized tests run may change
    (fixture setup/teardown counts can only decrease, not increase).

  • #​9924: Fixed doctest option flags leaking between docstrings after a failure, skip, or expected failure.

Improved documentation

  • #​10721: Replaced setup.py usage with pyproject.toml in writing-plugins.
  • #​12658: Moved the fixture setup and finalizer hooks to the test running hooks section in the reference documentation.
  • #​12857: Documented how --confcutdir affects initial conftest.py discovery.
  • #​14157: Added the pytest-flakefighters plugin to the list of flaky test plugins in plugins.rst.
    Added flaky test papers published on the Test FLARE project to the list of flaky papers in plugins.rst.
  • #​15127: Added guidance on typing yield fixtures, including annotating fixture functions with their generator type and fixture consumers with the yielded value type.
  • #​15242: The installation instructions <installation> and install-package-with-pip now show how to install pytest into a virtual environment with venv and pip, uv or virtualenv, and explain the externally-managed-environment error.
  • #​4569: pytest --help, the -k reference entry and select-tests no longer describe -k as a Python expression matched against test names only; keyword expressions now shows marker names being matched as well. The examples that looked up a marker use Node.get_closest_marker <_pytest.nodes.Node.get_closest_marker> rather than item.keywords.
  • #​9614: Clarified that session.items and session.testscollected exclude deselected tests in the pytest_collection documentation.

Packaging updates and notes for downstreams

  • #​11680: Source archives of arbitrary commits -- the tarballs GitHub serves under
    /archive/, not just the ones for tags -- can now be built into an sdist or a
    wheel with a correct version. A .git_archival.txt file, expanded by git archive via export-subst, carries the describe output that
    setuptools-scm would otherwise have to ask git for.

    The archival file deliberately omits ref-names. Recording it would make the
    content of an archive -- and therefore its checksum -- change whenever a branch
    that points at the archived commit is moved afterwards, which is how the
    equivalent tarballs of tagged releases became unstable for other projects.
    Describe output alone depends only on the commit and on the tags reachable from
    it.

    The archival file is not shipped in the sdist -- an sdist carries its version
    in its metadata, and the template is only ever expanded by git archive.

    Building pytest from a git checkout now requires setuptools-scm >= 10.1.

  • #​9236: pluggy>=1.6 is now required.

    Older pluggy versions stopped running the remaining hook wrapper teardowns once an
    old-style hookwrapper raised in its own teardown. The logging plugin's wrapper was
    left suspended, and when it was finalised later it detached the handler that
    caplog of a subsequent test was recording through, so that test saw no records.

Contributor-facing changes

  • #​14813: Added a systematic coverage matrix for assertion rewriting.
  • #​14921: Added scripts/diff-assert-rewrite.py, which diffs the assert-rewritten form of a snippet between the plain source, this checkout and released pytest versions.
  • #​15190: Fixed the documentation build with Pluggy 1.7 by ignoring a reference to its undocumented DistFacade compatibility class.

Miscellaneous internal changes

  • #​13888: FixtureRequest.node <pytest.FixtureRequest.node> is now explicitly annotated as returning Any, so strict pyright no longer reports it as Unknown. The return type stays deliberately broad, see 13888.
  • #​14758: Internal node ids (the ::-separated strings identifying collected items, e.g. path/to/test_file.py::TestClass::test_method[param]) are now represented internally by a single structured ~_pytest.nodeid.NodeId dataclass instead of being repeatedly re-parsed as plain strings. The public nodeid: str attribute on nodes and reports is unchanged and remains fully backward compatible for plugins.
pytest-dev/pytest-asyncio (pytest-asyncio)

v1.5.0: pytest-asyncio v1.5.0

Compare Source

1.5.0 - 2026-11-12

Added

  • A fixture-scope value for asyncio_default_fixture_loop_scope. With it, an asynchronous fixture without loop_scope uses its scope as its loop scope. This is the behavior of an unset option in pytest-asyncio 1.x. (#​1095)

Fixed

  • Invalid arguments to the asyncio marker, including an invalid loop_scope, are reported with a message that names the test instead of a traceback. (#​1584)
tox-dev/sphinx-autodoc-typehints (sphinx-autodoc-typehints)

v3.17.5

Compare Source

🐍 PyPI release

📜 Full Changelog

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

🐍 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

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 by @​gaborbernat.
  • Warnings that point at a definition list, such as a duplicate label placed before one, now name the line the list starts on instead of the line after it. #​1049 by @​gaborbernat.
  • Stop using the deprecated SphinxTransform.app when choosing between an alias and its value, so builds that run Python with -W error::PendingDeprecationWarning no longer fail, and the extension keeps working on Sphinx 11. #​1051 by @​gaborbernat.
  • Type the fields napoleon and numpydoc write when they come after sphinx_autodoc_typehints in extensions; the order the two are listed in no longer matters. #​1052 by @​gaborbernat.
  • Keep the choices between a type alias and its expanded value per document, so removing or editing a document no longer leaves its choices in the cached environment. The first build after upgrading re-reads every document once. #​1059 by @​gaborbernat.
  • The return type of a function whose docstring has no :rtype: or :return: now goes where Sphinx puts the types it adds with autodoc_typehints = "description": after the last field of the first list with parameters, else of the last field list, else in a new list at the end of the docstring. It no longer sits before a definition list, a doctest block, a rubric or a section, nor below a table that follows the parameters, and a warning from a docstring reports its own line rather than one counting the lines added above it. #​1060 by @​gaborbernat.
  • Stop a Sphinx build from hanging on a recursive type alias inside a Callable parameter list. #​1064 by @​gaborbernat.
  • Keep a submodule's type binding when a documented alias in its parent package has the same name. #​1065 by @​gaborbernat.
  • Keep napoleon_attr_annotations at its configured boolean value for other Sphinx extensions. #​1067 by @​gaborbernat.

Documentation
  • Publish the documentation on Read the Docs, with tutorials, how-to guides, a reference and every example rendered live by the extension. #​1007 by @​gaborbernat.
  • Add a typing features gallery that renders every public name of typing with the extension, with controls in each example's conf.py tab that switch the options it renders with. #​1029 by @​gaborbernat.
  • Compare both rendered outputs in the README, link the typing examples, and correct the event and return-field descriptions. #​1066 by @​gaborbernat.

Packaging

🐍 PyPI release

📜 Full Changelog


Configuration

📅 Schedule: (in timezone Europe/Berlin)

  • Branch creation
    • Between 12:00 AM and 05:59 AM, only on Monday (* 0-5 * * 1)
  • 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.

👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.


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

This PR has been generated by Mend Renovate CLI.

This PR contains the following updates: | Package | Change | [Age](https://docs.renovatebot.com/merge-confidence/) | [Confidence](https://docs.renovatebot.com/merge-confidence/) | |---|---|---|---| | [faiss-cpu](https://github.com/facebookresearch/faiss) | `==1.15.1` → `==1.16.0` | ![age](https://developer.mend.io/api/mc/badges/age/pypi/faiss-cpu/1.16.0?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/faiss-cpu/1.15.1/1.16.0?slim=true) | | [pytest](https://github.com/pytest-dev/pytest) ([changelog](https://docs.pytest.org/en/stable/changelog.html)) | `==9.1.1` → `==9.2.0` | ![age](https://developer.mend.io/api/mc/badges/age/pypi/pytest/9.2.0?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/pytest/9.1.1/9.2.0?slim=true) | | [pytest-asyncio](https://github.com/pytest-dev/pytest-asyncio) ([changelog](https://pytest-asyncio.readthedocs.io/en/stable/reference/changelog.html)) | `==1.4.1.post1` → `==1.5.0` | ![age](https://developer.mend.io/api/mc/badges/age/pypi/pytest-asyncio/1.5.0?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/pytest-asyncio/1.4.1.post1/1.5.0?slim=true) | | [sphinx-autodoc-typehints](https://github.com/tox-dev/sphinx-autodoc-typehints) ([changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/blob/main/docs/changelog.rst)) | `<3.13.11` → `<3.17.6` | ![age](https://developer.mend.io/api/mc/badges/age/pypi/sphinx-autodoc-typehints/3.17.5?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/sphinx-autodoc-typehints/3.13.10/3.17.5?slim=true) | --- ### Release Notes <details> <summary>facebookresearch/faiss (faiss-cpu)</summary> ### [`v1.16.0`](https://github.com/facebookresearch/faiss/blob/HEAD/CHANGELOG.md#1160---2026-11-09) [Compare Source](https://github.com/facebookresearch/faiss/compare/v1.15.1...v1.16.0) Added - [`fc1095a`](https://github.com/facebookresearch/faiss/commit/fc1095a9314f892938bf83f59e7ac966b5095def) e-means: add benchmarks reproducing the paper ([#&#8203;5845](https://github.com/facebookresearch/faiss/issues/5845)) - [`2079677`](https://github.com/facebookresearch/faiss/commit/2079677d10e5f6cf0823acd5aea453389cc866a2) e-means: add max_points_per_centroid ([#&#8203;5855](https://github.com/facebookresearch/faiss/issues/5855)) - [`8e5843c`](https://github.com/facebookresearch/faiss/commit/8e5843c5ec8697957276401f1acba0ebec58a329) Add regression test for flat search in a nested OpenMP region ([#&#8203;5754](https://github.com/facebookresearch/faiss/issues/5754)) - [`b80093c`](https://github.com/facebookresearch/faiss/commit/b80093c5b290578ed7de1975583e295309b4de81) Add DINO resident and SSD streaming e-means demos ([#&#8203;5815](https://github.com/facebookresearch/faiss/issues/5815)) - [`97fdfb0`](https://github.com/facebookresearch/faiss/commit/97fdfb09848869f0e4bf09537eb814c3bf86bf49) Add optional IVF assignment for centroid-sharded e-means ([#&#8203;5817](https://github.com/facebookresearch/faiss/issues/5817)) - [`f6a82dc`](https://github.com/facebookresearch/faiss/commit/f6a82dc2fa89ebb34ceb7cce8750f9305d2f17db) Add centroid-sharded e-means training ([#&#8203;5823](https://github.com/facebookresearch/faiss/issues/5823)) - [`0136502`](https://github.com/facebookresearch/faiss/commit/0136502d7ae5319a72ad35f7eb62e4eb364d8b1b) Add native INT8 CuTe assignment to e-means ([#&#8203;5816](https://github.com/facebookresearch/faiss/issues/5816)) - [`15b14b2`](https://github.com/facebookresearch/faiss/commit/15b14b2862c06eb779c6c3d8d669b5df4b6b33ea) Add FP8 CuTe assignment to e-means ([#&#8203;5820](https://github.com/facebookresearch/faiss/issues/5820)) - [`13a33bf`](https://github.com/facebookresearch/faiss/commit/13a33bf7f5e27e1bf531e4a21ba47a306dc97d9f) Add CuTe assignment backend to e-means ([#&#8203;5818](https://github.com/facebookresearch/faiss/issues/5818)) - [`7a038e7`](https://github.com/facebookresearch/faiss/commit/7a038e7eb2f8c4c76c19ead6ed9c5485f5030fc5) Add INT8 Triton assignment to e-means ([#&#8203;5821](https://github.com/facebookresearch/faiss/issues/5821)) - [`87b5339`](https://github.com/facebookresearch/faiss/commit/87b533977b9b536c1cc0b96daa191778b3cedd58) Add FP8 Triton assignment to e-means ([#&#8203;5819](https://github.com/facebookresearch/faiss/issues/5819)) - [`c8ab4f5`](https://github.com/facebookresearch/faiss/commit/c8ab4f51ac0703419d7cc6950117d286d37c37ff) Add Triton assignment backend to e-means ([#&#8203;5822](https://github.com/facebookresearch/faiss/issues/5822)) - [`f61f80a`](https://github.com/facebookresearch/faiss/commit/f61f80a2c4ea7420364bd8f9153c8171efb1e1e3) Add reduced-precision assignment to e-means ([#&#8203;5814](https://github.com/facebookresearch/faiss/issues/5814)) - [`8ac2fdc`](https://github.com/facebookresearch/faiss/commit/8ac2fdc014e4f19ba30f617c038fb2719c984031) Add distributed E-means training ([#&#8203;5813](https://github.com/facebookresearch/faiss/issues/5813)) - [`3795ee6`](https://github.com/facebookresearch/faiss/commit/3795ee68fbecc0fa4ad027748735eb7f513948ee) Add reference e-means implementations ([#&#8203;5812](https://github.com/facebookresearch/faiss/issues/5812)) - [`951067d`](https://github.com/facebookresearch/faiss/commit/951067d91521af476ebf0b5c51b26fa4bc98ad80) Print native crash diagnostics in Linux CMake CI ([#&#8203;5828](https://github.com/facebookresearch/faiss/issues/5828)) - [`7648f5f`](https://github.com/facebookresearch/faiss/commit/7648f5ffea474bdbdabab3d5e1a2a528db12c601) InvertedListScanner::distances_to_codes, with a block kernel for 8-bit PQ ([#&#8203;5807](https://github.com/facebookresearch/faiss/issues/5807)) - [`a6505c5`](https://github.com/facebookresearch/faiss/commit/a6505c5c5d76eaf86f9196669564ee766a9a1b69) Expose caller-owned Dataset APIs for CAGRA ([#&#8203;5739](https://github.com/facebookresearch/faiss/issues/5739)) - [`4caf504`](https://github.com/facebookresearch/faiss/commit/4caf5040c34ee16e069b14c24d09631b21a63133) Add MetalIndexBinaryFlat with GPU Hamming search and exact top-k selection ([#&#8203;5759](https://github.com/facebookresearch/faiss/issues/5759)) - [`71c7f48`](https://github.com/facebookresearch/faiss/commit/71c7f482d2da0aa1fbed179485818184a5d7df42) Add remove_ids to IndexShards and IndexReplicas, and add_with_ids to IndexReplicas ([#&#8203;5773](https://github.com/facebookresearch/faiss/issues/5773)) - [`6964ecd`](https://github.com/facebookresearch/faiss/commit/6964ecd829582bfdc9872c0c93acc5bf78696a0f) Make the multi-GPU Python helpers work on the Metal backend ([#&#8203;5747](https://github.com/facebookresearch/faiss/issues/5747)) - [`b156cce`](https://github.com/facebookresearch/faiss/commit/b156cced9160a6e68086f6828692ca69a6dd87f8) feat(rvv): add bit-exact RVV decode_vector for raw-codec quantizers ([#&#8203;5689](https://github.com/facebookresearch/faiss/issues/5689)) - [`8ff93a8`](https://github.com/facebookresearch/faiss/commit/8ff93a84010dabb605dfcb1f30511e80336fc006) Serialization, clone and index_factory support for IndexPiPNN ([#&#8203;5758](https://github.com/facebookresearch/faiss/issues/5758)) - [`840aa1f`](https://github.com/facebookresearch/faiss/commit/840aa1f4aff4b824989cfeee9e74236ad9585f66) Add HNSW level-0 links from a sample to remove search sinks ([#&#8203;5705](https://github.com/facebookresearch/faiss/issues/5705)) - [`89e5eb5`](https://github.com/facebookresearch/faiss/commit/89e5eb519570efbfc5432324735d978c932d4ae3) Add IndexPiPNN, a PiPNN graph index with beam search ([#&#8203;5734](https://github.com/facebookresearch/faiss/issues/5734)) - [`3effdb2`](https://github.com/facebookresearch/faiss/commit/3effdb20dc6bd0ebc38d0b1c46c366f3667751a2) PiPNN build assembly ([#&#8203;5729](https://github.com/facebookresearch/faiss/issues/5729)) - [`07979b1`](https://github.com/facebookresearch/faiss/commit/07979b10e64d39a611196483f103b2d7b349b5f7) Randomized Ball Carving partition ([#&#8203;5714](https://github.com/facebookresearch/faiss/issues/5714)) - [`7069478`](https://github.com/facebookresearch/faiss/commit/7069478c3f027edc8ece507158409208b2652d90) Numeric kernels - [`7a05795`](https://github.com/facebookresearch/faiss/commit/7a057952fdb93fec7865eb5459e3956cd9108b8b) HashPrune reservoir and sketch kernel ([#&#8203;5708](https://github.com/facebookresearch/faiss/issues/5708)) - [`b0074a3`](https://github.com/facebookresearch/faiss/commit/b0074a3fa426027d9ff8575b44386d5922859ac9) Add fp16 support to `SuperKMeans` ([#&#8203;5692](https://github.com/facebookresearch/faiss/issues/5692)) - [`e7c44eb`](https://github.com/facebookresearch/faiss/commit/e7c44eb000bebb16f84be38a115caa5d333a8229) Add AVX-512 fp16 conversion kernels ([#&#8203;5694](https://github.com/facebookresearch/faiss/issues/5694)) - [`ea29bac`](https://github.com/facebookresearch/faiss/commit/ea29bac75d0039ad9f3aa0351ac5cac6aabdb0bb) RaBitQ: add batch-four estimates and 9-bit SIMD scoring ([#&#8203;5647](https://github.com/facebookresearch/faiss/issues/5647)) - [`76c0e01`](https://github.com/facebookresearch/faiss/commit/76c0e01e0f4db5f943b44cf85530e68efe29f355) Add GPU-accelerated IVFPQ search to the Metal backend ([#&#8203;5449](https://github.com/facebookresearch/faiss/issues/5449)) - [`0db2f30`](https://github.com/facebookresearch/faiss/commit/0db2f3088643c2b2d0bc1c3afdba1dc0c40fee1a) rabitq neon kernels ([#&#8203;5532](https://github.com/facebookresearch/faiss/issues/5532)) - [`430a41e`](https://github.com/facebookresearch/faiss/commit/430a41ee4c52cd070470e180c6d0f57888588d6b) Native fp16 k-means training for Faiss IVF ([#&#8203;5671](https://github.com/facebookresearch/faiss/issues/5671)) - [`6c8378e`](https://github.com/facebookresearch/faiss/commit/6c8378e4f1b8d7a3a7986c2ca216923221fe6954) Add RVV implementation for decode_bf16_simd ([#&#8203;5641](https://github.com/facebookresearch/faiss/issues/5641)) - [`e24a371`](https://github.com/facebookresearch/faiss/commit/e24a371a701ddcb7fe460d87fd9c8f400c440848) feat(rvv): add vector arithmetic kernels ([#&#8203;5655](https://github.com/facebookresearch/faiss/issues/5655)) - [`94a4331`](https://github.com/facebookresearch/faiss/commit/94a4331fee6524272a108d8eb5c176133a29c6b2) Add reranked types to IndexSQFastScan and fix flat RaBitQ filtering ([#&#8203;5661](https://github.com/facebookresearch/faiss/issues/5661)) - [`dcf8ebb`](https://github.com/facebookresearch/faiss/commit/dcf8ebb34623c1b3dde08e495ef974c92a179c4e) Support IDSelector in flat fast-scan search ([#&#8203;5660](https://github.com/facebookresearch/faiss/issues/5660)) - [`1768a5a`](https://github.com/facebookresearch/faiss/commit/1768a5a8e988706fcce2306865f18fce5b151115) Add RVV SIMD specialization for product quantizer distance-table computation ([#&#8203;5543](https://github.com/facebookresearch/faiss/issues/5543)) - [`f323c18`](https://github.com/facebookresearch/faiss/commit/f323c18d5afa1bb72211f6ef8618863940cb5ab5) Add RVV encoding for QT_8bit_direct ([#&#8203;5640](https://github.com/facebookresearch/faiss/issues/5640)) - [`5e74b1b`](https://github.com/facebookresearch/faiss/commit/5e74b1bddeb5e554023a044007a4ce22fd19647e) feat: implement RVV optimized scalar quantizer codecs and distance computation ([#&#8203;5535](https://github.com/facebookresearch/faiss/issues/5535)) - [`b0d9e80`](https://github.com/facebookresearch/faiss/commit/b0d9e80288daa678493d46c975ae92d1c6eced6d) Add fast scan variants of SQ indexes - IndexSQFastScan and IndexIVFSQFastScan ([#&#8203;5341](https://github.com/facebookresearch/faiss/issues/5341)) - [`4864f4d`](https://github.com/facebookresearch/faiss/commit/4864f4d42084a56535eb43ba66f27b1ab64d5ff5) SVS: Add ParameterSpace.set_index_parameter support for Vamana ([#&#8203;5644](https://github.com/facebookresearch/faiss/issues/5644)) - [`0f23e6a`](https://github.com/facebookresearch/faiss/commit/0f23e6a2ef2fe1a29c05e6d58b7eae0826f55fff) Add RVV SIMD specialization for scalar quantizer distance compute ([#&#8203;5539](https://github.com/facebookresearch/faiss/issues/5539)) Changed - [`f34c0b8`](https://github.com/facebookresearch/faiss/commit/f34c0b881d9dd5d3a248abea827505f4d700bc02) Move the macOS arm64 CI jobs from macos-14 to macos-15 ([#&#8203;5875](https://github.com/facebookresearch/faiss/issues/5875)) - [`741138a`](https://github.com/facebookresearch/faiss/commit/741138a12befa506e391de1a548f862db801056a) E-means: quality batch at d <= 16 and no revival at d <= 2 by default ([#&#8203;5854](https://github.com/facebookresearch/faiss/issues/5854)) - [`731286f`](https://github.com/facebookresearch/faiss/commit/731286f8bf0aebdb0185e5d00f9cd6f6ceae055c) e-means: faiss-style verbose output that reports epochs and asks for a citation ([#&#8203;5841](https://github.com/facebookresearch/faiss/issues/5841)) - [`277b3c7`](https://github.com/facebookresearch/faiss/commit/277b3c76b7a1507915eb8f5010dcb367cbc95494) e-means: rename niter to nepochs ([#&#8203;5848](https://github.com/facebookresearch/faiss/issues/5848)) - [`a15797a`](https://github.com/facebookresearch/faiss/commit/a15797a21ffa09a927b1db5cea9778778b242a9a) Compute the coarse distances in search_preassigned when they are not given ([#&#8203;5748](https://github.com/facebookresearch/faiss/issues/5748)) - [`b955264`](https://github.com/facebookresearch/faiss/commit/b9552647c3437ded6bcf6b8f10ed82945b4b231b) Replace the e-means README with a user guide ([#&#8203;5842](https://github.com/facebookresearch/faiss/issues/5842)) - [`e4500c2`](https://github.com/facebookresearch/faiss/commit/e4500c2252dacdcb2d5288c05cfeb7950379ec50) Use BF16 defaults and share quantized rows across E-means sharding ([#&#8203;5844](https://github.com/facebookresearch/faiss/issues/5844)) - [`0a6f936`](https://github.com/facebookresearch/faiss/commit/0a6f936730175a4be0c3475359bdb12b39222099) Emeans ssd speedups ([#&#8203;5839](https://github.com/facebookresearch/faiss/issues/5839)) - [`9246aa7`](https://github.com/facebookresearch/faiss/commit/9246aa7dd0a2ff5fa09703b37e674545a7cfded4) Rename e-means operating_point to batch_law, allow batch_size without alpha0, and default niter to 5 ([#&#8203;5833](https://github.com/facebookresearch/faiss/issues/5833)) - [`22a0cb7`](https://github.com/facebookresearch/faiss/commit/22a0cb7edd99e23ae9eabf025c18f115fb02e319) Separate Emeans implementations ([#&#8203;5840](https://github.com/facebookresearch/faiss/issues/5840)) - [`1d40eeb`](https://github.com/facebookresearch/faiss/commit/1d40eebe82718de25e030c092406ebc916c36a0f) Speed up the x86 8-bit scalar quantizer inner-product distance ([#&#8203;5829](https://github.com/facebookresearch/faiss/issues/5829)) - [`efd79c9`](https://github.com/facebookresearch/faiss/commit/efd79c971d21b44970013bdd7dcb9f98d482ebdf) Upgrade CPU CMake CI to PyTorch 2.15 ([#&#8203;5827](https://github.com/facebookresearch/faiss/issues/5827)) - [`0b0250d`](https://github.com/facebookresearch/faiss/commit/0b0250d1eccde136de4e0fbfe85f595e22c59991) SQ fp16 and bf16: four accumulators per code at d >= 384, any d at AVX-512 ([#&#8203;5806](https://github.com/facebookresearch/faiss/issues/5806)) - [`a3217cb`](https://github.com/facebookresearch/faiss/commit/a3217cbb13cc7ecf853f875c391fcad7c3a67a3b) Give each SIMD level its own copy of the 65 shared functions ([#&#8203;5810](https://github.com/facebookresearch/faiss/issues/5810)) - [`2a6e785`](https://github.com/facebookresearch/faiss/commit/2a6e785964d253b99cd38cad70168a3eae9aa67e) Define the AVX-512 SQ specializations once for AVX512 and AVX512_SPR ([#&#8203;5808](https://github.com/facebookresearch/faiss/issues/5808)) - [`c2d27c6`](https://github.com/facebookresearch/faiss/commit/c2d27c620f250f0a4ef5c5a9e6709b1410e9469c) Search only the sample vectors at sinks after each round of HNSW level-0 links ([#&#8203;5804](https://github.com/facebookresearch/faiss/issues/5804)) - [`9d5b442`](https://github.com/facebookresearch/faiss/commit/9d5b44252dc7bd2921303b9f59f171a7fd7b2896) Codify the Faiss SIMD guard rules and check them with a test ([#&#8203;5793](https://github.com/facebookresearch/faiss/issues/5793)) - [`0d3c380`](https://github.com/facebookresearch/faiss/commit/0d3c380b8cc0bd854478e785f1f9ddf67e467ead) Move SIMD code to dedicated translation units and align guards ([#&#8203;5792](https://github.com/facebookresearch/faiss/issues/5792)) - [`03aa1bd`](https://github.com/facebookresearch/faiss/commit/03aa1bd8fb746a6450362020342d54ff5eb17199) Give fvec_L2sqr_ny_y_transposed_D internal linkage in the AVX2 and AVX512 files ([#&#8203;5788](https://github.com/facebookresearch/faiss/issues/5788)) - [`167f443`](https://github.com/facebookresearch/faiss/commit/167f443cef3c55b6cc6b1409b746c4aaf79ee5d2) Prefetch graph rows and vectors in PiPNN search ([#&#8203;5805](https://github.com/facebookresearch/faiss/issues/5805)) - [`ea99cbc`](https://github.com/facebookresearch/faiss/commit/ea99cbce425c7681ae71a66e2134dc9b7f73b272) SVS 0.5.0 ([#&#8203;5785](https://github.com/facebookresearch/faiss/issues/5785)) - [`0c2cad8`](https://github.com/facebookresearch/faiss/commit/0c2cad85a2cf6e2a523115ebb1f539177d0cb435) Run the Windows conda CI steps in bash ([#&#8203;5795](https://github.com/facebookresearch/faiss/issues/5795)) - [`35a4ec2`](https://github.com/facebookresearch/faiss/commit/35a4ec21dcb6036fee1c40bf49afdd5de3cbeb57) Use 3 sample vectors per node by default for HNSW level-0 links ([#&#8203;5789](https://github.com/facebookresearch/faiss/issues/5789)) - [`1ec0011`](https://github.com/facebookresearch/faiss/commit/1ec00116793a35706e4a70abb74052bfcf353406) Hamming: vector popcount for the default computer at AVX512 and AVX512_VPOPCNT ([#&#8203;5787](https://github.com/facebookresearch/faiss/issues/5787)) - [`fc65960`](https://github.com/facebookresearch/faiss/commit/fc6596015001cf5627d4c91782ef16fa50d80517) Use a SIMD masked sum for the fp32 RaBitQ 1-bit estimate ([#&#8203;5782](https://github.com/facebookresearch/faiss/issues/5782)) - [`d37bede`](https://github.com/facebookresearch/faiss/commit/d37bedea3ce2d5cc124d67b71df0c1c5b85a65b9) Train ProductQuantizer subquantizers in parallel ([#&#8203;5783](https://github.com/facebookresearch/faiss/issues/5783)) - [`386c96b`](https://github.com/facebookresearch/faiss/commit/386c96bf975d06abba4cc723dcb24f9edf954545) Default alpha to 1.2 for all metrics ([#&#8203;5786](https://github.com/facebookresearch/faiss/issues/5786)) - [`0a32a42`](https://github.com/facebookresearch/faiss/commit/0a32a42fead593df8d57c7e21fa586099d85013c) Scale the HNSW and PiPNN search check period by the thread count ([#&#8203;5784](https://github.com/facebookresearch/faiss/issues/5784)) - [`c919a60`](https://github.com/facebookresearch/faiss/commit/c919a604e621876c43f33c54dc87a6c2e6eccc97) Dispatch RaBitQ scans once per inverted list ([#&#8203;5597](https://github.com/facebookresearch/faiss/issues/5597)) - [`6907ed1`](https://github.com/facebookresearch/faiss/commit/6907ed11766275b239856bb24381542d664e5265) Prune inner-product graphs on cosines when norms vary ([#&#8203;5774](https://github.com/facebookresearch/faiss/issues/5774)) - [`e353ed7`](https://github.com/facebookresearch/faiss/commit/e353ed74de51d8d28443fae3ca8d2df5da790d7c) 8-bit PQ code distance: 4-sum scalar kernel instead of gathers on AMD Zen 3/4/5 ([#&#8203;5751](https://github.com/facebookresearch/faiss/issues/5751)) - [`9e16309`](https://github.com/facebookresearch/faiss/commit/9e1630901add9f264d3640d2f554447a4e8e8c8d) Build PiPNN graphs over distinct codes ([#&#8203;5768](https://github.com/facebookresearch/faiss/issues/5768)) - [`7834aba`](https://github.com/facebookresearch/faiss/commit/7834abae4f86839f2220dc88fb7b3403d2bb5e00) Size IVF fast-scan slice LUTs on the calling thread ([#&#8203;5721](https://github.com/facebookresearch/faiss/issues/5721)) - [`2732125`](https://github.com/facebookresearch/faiss/commit/273212578948c95ce2681bc7496228fab7079e64) Dispatch more dimensions to the SIMD fvec_L2sqr_ny_transposed kernels ([#&#8203;5757](https://github.com/facebookresearch/faiss/issues/5757)) - [`ee6927d`](https://github.com/facebookresearch/faiss/commit/ee6927dedd66ba57192c65d4de7bff8c69c0f332) ivflib::search_with_distance_to_code: search through InvertedListScanner::distance_to_code ([#&#8203;5755](https://github.com/facebookresearch/faiss/issues/5755)) - [`56c96d5`](https://github.com/facebookresearch/faiss/commit/56c96d5efcfd3b498f70bd3be61e75da4455e491) Move Faiss C++ tests to Python ([#&#8203;5743](https://github.com/facebookresearch/faiss/issues/5743)) - [`a55e0b2`](https://github.com/facebookresearch/faiss/commit/a55e0b2af6fc5c26c68cae363c6e4c734f0f2981) Upgrade cuVS to 26.10 ([#&#8203;5633](https://github.com/facebookresearch/faiss/issues/5633)) - [`494330f`](https://github.com/facebookresearch/faiss/commit/494330fb1f77124814a4a07653b5a1af89cc3af3) Speed up the NEON 8-bit scalar quantizer L2 distance ([#&#8203;5733](https://github.com/facebookresearch/faiss/issues/5733)) - [`1a9ddc6`](https://github.com/facebookresearch/faiss/commit/1a9ddc60d2201c9a44dfca3acead6ee38fbe21dc) Use monotonic dynamic scheduling so libomp 12 does not take its static-steal path ([#&#8203;5723](https://github.com/facebookresearch/faiss/issues/5723)) - [`3fc6bcd`](https://github.com/facebookresearch/faiss/commit/3fc6bcd9560fae13a1d83ae6f1d74c191a32aea6) On ROCm, stage pageable host copies in pinned memory ([#&#8203;5712](https://github.com/facebookresearch/faiss/issues/5712)) - [`cec5702`](https://github.com/facebookresearch/faiss/commit/cec5702b0b1c31f242b9d35d5f193b0d80ccd9dc) DD: give fvec_L2sqr_ny_nearest_y_transposed_D internal linkage ([#&#8203;5720](https://github.com/facebookresearch/faiss/issues/5720)) - [`db6aa06`](https://github.com/facebookresearch/faiss/commit/db6aa06d968084434c8ae270f699d3ba16079300) Hoist per-list allocations out of the IVF fast-scan search loops ([#&#8203;5717](https://github.com/facebookresearch/faiss/issues/5717)) - [`3907966`](https://github.com/facebookresearch/faiss/commit/39079668a8bebcad6a89143df7bf7e9bc542f93e) Select OpenBLAS OMP build in conda for AArch64 + Linux ([#&#8203;5669](https://github.com/facebookresearch/faiss/issues/5669)) - [`44afa77`](https://github.com/facebookresearch/faiss/commit/44afa7729d34c9392d2af62683285e593a28db35) Stop allocating per (query, probe) on OpenMP workers in IVF RaBitQ fast-scan ([#&#8203;5716](https://github.com/facebookresearch/faiss/issues/5716)) - [`6692d7a`](https://github.com/facebookresearch/faiss/commit/6692d7ab3748e95d155c49b7821dc9ef70a2611a) Stop copying QueryFactorsData per block in RaBitQHeapHandler - [`3a98062`](https://github.com/facebookresearch/faiss/commit/3a980624265e442653cd0e74a5b903f7bb32c5e0) faiss/conda: extend LSQ NEON-flaky test skip to all arm64 ([#&#8203;5713](https://github.com/facebookresearch/faiss/issues/5713)) - [`2839c39`](https://github.com/facebookresearch/faiss/commit/2839c39f2058ef49554273c6e98a8244cbe243e1) Make the GPU IVF search return the same neighbours on every run ([#&#8203;5682](https://github.com/facebookresearch/faiss/issues/5682)) - [`a2f7943`](https://github.com/facebookresearch/faiss/commit/a2f79430051d5c8c458300645a15c6efa496d1f4) Optimize 4-bit PQ fastscan accumulation on Arm CPUs ([#&#8203;5709](https://github.com/facebookresearch/faiss/issues/5709)) - [`83ae8b0`](https://github.com/facebookresearch/faiss/commit/83ae8b0908312c1e40734a806a3cc435b64f9496) Move the RVV distance kernels into free-standing headers ([#&#8203;5697](https://github.com/facebookresearch/faiss/issues/5697)) - [`1dab0c1`](https://github.com/facebookresearch/faiss/commit/1dab0c1cdf4dc66fb0f4d0370b02041c4889e8c1) Quarantine unstable cuVS Python GPU tests ([#&#8203;5699](https://github.com/facebookresearch/faiss/issues/5699)) - [`ae4466d`](https://github.com/facebookresearch/faiss/commit/ae4466d57e9a72977c58e79f6ed49d9a905f07ff) Avoid widening fp16 data for k-means++ initialization ([#&#8203;5693](https://github.com/facebookresearch/faiss/issues/5693)) - [`ea9151d`](https://github.com/facebookresearch/faiss/commit/ea9151d71b4da86295a5aa3a2270b9845b46e133) RaBitQ: broadcast one sign word per 32 dims in the AVX2 RBQ9 kernel ([#&#8203;5696](https://github.com/facebookresearch/faiss/issues/5696)) - [`4102312`](https://github.com/facebookresearch/faiss/commit/41023120df6b8f6a41f6f4a9b1d5f6d299f4b4d1) Defer IVF list scan setup until needed ([#&#8203;5595](https://github.com/facebookresearch/faiss/issues/5595)) - [`fdb9535`](https://github.com/facebookresearch/faiss/commit/fdb9535c15b1b2990fd28f76f0641e65b95162f8) Make search stats collection configurable ([#&#8203;5670](https://github.com/facebookresearch/faiss/issues/5670)) - [`7f6bf10`](https://github.com/facebookresearch/faiss/commit/7f6bf10b1c83b1634c3cfd3367ba1e76907c79b9) Halve IndexSQFastScan rerank memory with a split-nibble layout ([#&#8203;5662](https://github.com/facebookresearch/faiss/issues/5662)) - [`b1c1496`](https://github.com/facebookresearch/faiss/commit/b1c149654519857160402bf9d15a69e5bcf8c275) migrate from bit-manipulation builtins in fbcode/faiss ([#&#8203;5667](https://github.com/facebookresearch/faiss/issues/5667)) - [`2496f63`](https://github.com/facebookresearch/faiss/commit/2496f63f764595b10a8c0bc8eeb1ccf54a36b897) Avoid search stats contention during concurrent search ([#&#8203;5663](https://github.com/facebookresearch/faiss/issues/5663)) - [`3f4838e`](https://github.com/facebookresearch/faiss/commit/3f4838ead310c3591ea1f3ad42a6cd97e4f56a4b) Batch the IVF ScalarQuantizer scan four codes at a time ([#&#8203;5456](https://github.com/facebookresearch/faiss/issues/5456)) - [`1dbb3d2`](https://github.com/facebookresearch/faiss/commit/1dbb3d25b07f221585cb335ad071639fc2374d44) Update backward compatibility test to v1.15.1 ([#&#8203;5646](https://github.com/facebookresearch/faiss/issues/5646)) Fixed - [`29782a0`](https://github.com/facebookresearch/faiss/commit/29782a03747addd1122bf040b6c3488c8d669fe9) Fix verbose e-means tests after the `nepochs` rename ([#&#8203;5869](https://github.com/facebookresearch/faiss/issues/5869)) - [`8babd49`](https://github.com/facebookresearch/faiss/commit/8babd49cf041798f36440189de5b74e1d2079c44) Fix assignment after progressive-dimension Kmeans training ([#&#8203;5861](https://github.com/facebookresearch/faiss/issues/5861)) - [`b7c44bc`](https://github.com/facebookresearch/faiss/commit/b7c44bcc92e60e73e5cbc5b40b4c32d24d72652e) Initialize SVS Vamana graph parameters in the default constructor. ([#&#8203;5834](https://github.com/facebookresearch/faiss/issues/5834)) - [`9acf8b0`](https://github.com/facebookresearch/faiss/commit/9acf8b0c16a51aafa12b9d9bcf13998b9138a8c5) Guard fp16 threshold in mock builds \[unused-const-variable] ([#&#8203;5835](https://github.com/facebookresearch/faiss/issues/5835)) - [`0c269ac`](https://github.com/facebookresearch/faiss/commit/0c269acddb19bb77ad1c0d149b71a022c12d857b) Validate codebook size in read_ResidualQuantizer_old and bounds-check IndexBinaryIVF::reconstruct_from_offset ([#&#8203;5764](https://github.com/facebookresearch/faiss/issues/5764)) - [`7ac4a6c`](https://github.com/facebookresearch/faiss/commit/7ac4a6c2b224684608c46f4f4bc7f2ade2176b60) Fix database-parallel kNN when the parallel region gets fewer threads ([#&#8203;5824](https://github.com/facebookresearch/faiss/issues/5824)) - [`98a23e4`](https://github.com/facebookresearch/faiss/commit/98a23e442a3d6adddc025cb810ca0b17e5202d75) Fix OMP exception safety in ProductQuantizer ([#&#8203;5771](https://github.com/facebookresearch/faiss/issues/5771)) - [`d87b58b`](https://github.com/facebookresearch/faiss/commit/d87b58b4b74b08684be8d5b08cb6c93a744d1b7b) fbcode/faiss/tests/test_fast_scan_distance_to_code.cpp ([#&#8203;5772](https://github.com/facebookresearch/faiss/issues/5772)) - [`48f2129`](https://github.com/facebookresearch/faiss/commit/48f21296c9b0b391ba878be3d7ba10ed0e250f13) Drop constants \[unused-const-variable] ([#&#8203;5794](https://github.com/facebookresearch/faiss/issues/5794)) - [`2f890e8`](https://github.com/facebookresearch/faiss/commit/2f890e8488582c84087e23c058c1db6a4ff45db8) Fix train_NonUniform skipping training row 0 and racing on a shared buffer ([#&#8203;5791](https://github.com/facebookresearch/faiss/issues/5791)) - [`d4a6548`](https://github.com/facebookresearch/faiss/commit/d4a6548c9a354bee366c14f39409d399f75c497f) Faiss OSS nightly autofix ([#&#8203;5790](https://github.com/facebookresearch/faiss/issues/5790)) - [`5712d82`](https://github.com/facebookresearch/faiss/commit/5712d8201d90bbf3a184353e69e115c13dffbfcb) Fix cuVS IVF-Flat workspace sizing after CPU-to-GPU cloning ([#&#8203;5763](https://github.com/facebookresearch/faiss/issues/5763)) - [`bce5e24`](https://github.com/facebookresearch/faiss/commit/bce5e24dd753296e241a67dbd0914cb652382fc5) Re-enable the cuVS CAGRA Python tests that hung on cuVS 26.06 ([#&#8203;5770](https://github.com/facebookresearch/faiss/issues/5770)) - [`450dd79`](https://github.com/facebookresearch/faiss/commit/450dd7928c4d3e33b9a8becc6d470063b6a65f7c) Fix AArch64's conda multi output recipe ([#&#8203;5727](https://github.com/facebookresearch/faiss/issues/5727)) - [`55afdff`](https://github.com/facebookresearch/faiss/commit/55afdff94d07e140bb553397617dfdddfbfb66f3) cmake: install utils/popcount.h ([#&#8203;5744](https://github.com/facebookresearch/faiss/issues/5744)) - [`d4a4e3e`](https://github.com/facebookresearch/faiss/commit/d4a4e3ee300dcd26e6e74116de2118a4a10a684f) Fix build for CPUTYPE=znver4 ([#&#8203;5752](https://github.com/facebookresearch/faiss/issues/5752)) - [`56797f9`](https://github.com/facebookresearch/faiss/commit/56797f9d33a172e2b4ac2dca77be28248c81c53d) Match scalar tie-break in AVX2/AVX512 Lloyd-Max encode ([#&#8203;5715](https://github.com/facebookresearch/faiss/issues/5715)) - [`5b4aa46`](https://github.com/facebookresearch/faiss/commit/5b4aa4679ca60cf397119f46d7c70d19b612dc64) fbcode/faiss/gpu/utils ([#&#8203;5737](https://github.com/facebookresearch/faiss/issues/5737)) - [`a643100`](https://github.com/facebookresearch/faiss/commit/a643100c88dbf3a0f06f23fa8d9d7c0b76885200) Faiss OSS nightly autofix ([#&#8203;5731](https://github.com/facebookresearch/faiss/issues/5731)) - [`4f63b42`](https://github.com/facebookresearch/faiss/commit/4f63b42b922a5b41bbc925a7b55043460e548d42) Keep AVX512-TU copies of the AVX2 QBS loop out of the AVX2 path ([#&#8203;5724](https://github.com/facebookresearch/faiss/issues/5724)) - [`c966dab`](https://github.com/facebookresearch/faiss/commit/c966dab152b133411b06687cc8e5888c8ca8ab90) Faiss OSS nightly autofix ([#&#8203;5728](https://github.com/facebookresearch/faiss/issues/5728)) - [`5d635f3`](https://github.com/facebookresearch/faiss/commit/5d635f354ccc22f7a3a9c38d185762cfdfec58fd) DD: give PQCodeDistanceScalar a SIMD level so the AVX2 path cannot run AVX512 code ([#&#8203;5719](https://github.com/facebookresearch/faiss/issues/5719)) - [`f46050e`](https://github.com/facebookresearch/faiss/commit/f46050eb56c6458e368496ff74281630fd462e4c) Deflake test_io TestIVFPQRead.test_reader ([#&#8203;5718](https://github.com/facebookresearch/faiss/issues/5718)) - [`8b884ec`](https://github.com/facebookresearch/faiss/commit/8b884ecc96d19633ab7d8dedd8c6f4efb9597004) Fix IndexFastScan::reset() leaving stale ntotal2 (crash on search) ([#&#8203;5614](https://github.com/facebookresearch/faiss/issues/5614)) - [`d380b7d`](https://github.com/facebookresearch/faiss/commit/d380b7d96c6009bb8d6dbef79222c02fca284df6) Fix IndexFlatCodes::reset on mmap-loaded codes ([#&#8203;5707](https://github.com/facebookresearch/faiss/issues/5707)) - [`6c51305`](https://github.com/facebookresearch/faiss/commit/6c51305e6410d6b682d5f34f7da1c10bb4a37989) Avoid double-advancing HNSW visited tables ([#&#8203;5596](https://github.com/facebookresearch/faiss/issues/5596)) - [`76978ee`](https://github.com/facebookresearch/faiss/commit/76978eee4a2d8a603aefced9ecf0a45f60b4dd45) Fix selector handling for IVF iterator scans ([#&#8203;5592](https://github.com/facebookresearch/faiss/issues/5592)) - [`38460ee`](https://github.com/facebookresearch/faiss/commit/38460ee969aa49990e635853b2d41bf12e3ef235) Fix Faiss fp16 parity tests across architectures ([#&#8203;5695](https://github.com/facebookresearch/faiss/issues/5695)) - [`88a28bc`](https://github.com/facebookresearch/faiss/commit/88a28bcd80aa4469bd15520c510186c98f51d985) Faiss OSS nightly autofix ([#&#8203;5686](https://github.com/facebookresearch/faiss/issues/5686)) - [`ec94295`](https://github.com/facebookresearch/faiss/commit/ec94295adcaaf5d7480ea9ace573eb9e0c8369f9) Bound the fast scan LUT scale by the accumulated sum ([#&#8203;5658](https://github.com/facebookresearch/faiss/issues/5658)) - [`3f08095`](https://github.com/facebookresearch/faiss/commit/3f08095cee9d36698ad5d72bf19fb7b2dfcb1f8c) fix: release SuperKMeans sample buffer after rotation ([#&#8203;5648](https://github.com/facebookresearch/faiss/issues/5648)) - [`02cacc5`](https://github.com/facebookresearch/faiss/commit/02cacc5293e22b800be55c09662e2e22d4c62923) Fix TSAN races in side `hsnw_stats` and `rabitq_stats` ([#&#8203;5657](https://github.com/facebookresearch/faiss/issues/5657)) - [`bf8be4a`](https://github.com/facebookresearch/faiss/commit/bf8be4a79bdc4d1aac60f4ec0c7190123c973a0a) fix(ci): use GCC 14 riscv64 cross-compiler for RVV tuple/zvfhmin intrinsics ([#&#8203;5653](https://github.com/facebookresearch/faiss/issues/5653)) - [`98af2cf`](https://github.com/facebookresearch/faiss/commit/98af2cf627ec8d2f3e149c7d7b60d4ddea7a0ccb) Fix osx-arm64 conda build: drop redundant openblas pin, allow single-platform release dispatch ([#&#8203;5652](https://github.com/facebookresearch/faiss/issues/5652)) - [`3778f58`](https://github.com/facebookresearch/faiss/commit/3778f5892d0c663a6c926609354174b278028321) Fix IDSelector handling in unbounded HNSW search ([#&#8203;5508](https://github.com/facebookresearch/faiss/issues/5508)) Deprecated - [`8f176c3`](https://github.com/facebookresearch/faiss/commit/8f176c3d67bf6846e62ad6ade42afd8060bec749) Remove the replicas parameter ([#&#8203;5809](https://github.com/facebookresearch/faiss/issues/5809)) - [`de495c9`](https://github.com/facebookresearch/faiss/commit/de495c95ab75c0a73e19d0d4f3f5598eabfa4cfe) Remove redundant contrib, torch, Manifold and telemetry tests ([#&#8203;5801](https://github.com/facebookresearch/faiss/issues/5801)) - [`ce25a10`](https://github.com/facebookresearch/faiss/commit/ce25a1036f52a10f5d5faa00212691fa75639b75) Remove redundant Panorama, general index, factory and SWIG tests ([#&#8203;5802](https://github.com/facebookresearch/faiss/issues/5802)) - [`ca60fb5`](https://github.com/facebookresearch/faiss/commit/ca60fb500fada5a1dc77a8909998fe6191c9ea33) Remove redundant clustering, binary index and SIMD distance tests ([#&#8203;5800](https://github.com/facebookresearch/faiss/issues/5800)) - [`4915580`](https://github.com/facebookresearch/faiss/commit/49155804521a7dc32e9049b861bd99a3ba196797) Remove redundant serialization, mmap and deserialization tests ([#&#8203;5798](https://github.com/facebookresearch/faiss/issues/5798)) - [`2f8c1d2`](https://github.com/facebookresearch/faiss/commit/2f8c1d2b75660a269b7df5e0b7c9c2e9cbe6036e) Remove redundant SVS, HNSW, NSG and PiPNN tests ([#&#8203;5799](https://github.com/facebookresearch/faiss/issues/5799)) - [`f2130c2`](https://github.com/facebookresearch/faiss/commit/f2130c2ff4c8c7b9a1c730e5b1030832c9848ff9) Remove redundant IVF and search parameter tests ([#&#8203;5803](https://github.com/facebookresearch/faiss/issues/5803)) - [`1c84f08`](https://github.com/facebookresearch/faiss/commit/1c84f080f25f96a7f1e18e946073101eb886b1cb) Remove redundant PQ, AQ and SQ fast-scan tests ([#&#8203;5797](https://github.com/facebookresearch/faiss/issues/5797)) - [`2010413`](https://github.com/facebookresearch/faiss/commit/20104132da6698dd0e8fa4d35e934ac74e062259) Remove redundant PQ, AQ, SQ and RaBitQ tests ([#&#8203;5796](https://github.com/facebookresearch/faiss/issues/5796)) - [`42aac2f`](https://github.com/facebookresearch/faiss/commit/42aac2fb4e17a66a6b17e7a99e3df229bcf757b8) Remove the cuVS 26.02 compatibility paths from the cuVS GPU code ([#&#8203;5750](https://github.com/facebookresearch/faiss/issues/5750)) </details> <details> <summary>pytest-dev/pytest (pytest)</summary> ### [`v9.2.0`](https://github.com/pytest-dev/pytest/releases/tag/9.2.0) [Compare Source](https://github.com/pytest-dev/pytest/compare/9.1.1...9.2.0) ### pytest 9.2.0 (2026-10-27) #### Removals and backward incompatible breaking changes - [#&#8203;14716](https://github.com/pytest-dev/pytest/issues/14716): `-c` now raises a usage error for a path that does not exist, is a directory, or is in a format pytest has no loader for. Such paths were previously either ignored or reported as an unhandled `FileNotFoundError`. - [#&#8203;8593](https://github.com/pytest-dev/pytest/issues/8593): The `indirect`, `ids` and `scope` arguments of `Metafunc.parametrize() <pytest.Metafunc.parametrize>` -- and therefore of `@pytest.mark.parametrize <pytest.mark.parametrize ref>` -- are now keyword-only. Passing them positionally was a common source of confusing errors, e.g. `parametrize("arg1", "arg2", [(1, 2)])` made the argvalues land in `indirect` and failed with `indirect fixture '(1, 2)' doesn't exist`; such mistakes now fail with an understandable `TypeError`. The type annotations have always declared these arguments as keyword-only. - [#&#8203;993](https://github.com/pytest-dev/pytest/issues/993): Plugin import failures at startup are now reported and classified instead of escaping as a raw traceback with the accidental exit code `1`: - a plugin that cannot be found -- via `-p`, `pytest_plugins` or `PYTEST_PLUGINS` -- exits with `pytest.ExitCode` `USAGE_ERROR` (`4`), like a `conftest.py` that fails to import; - a plugin that is found but raises while importing -- including a broken `pytest11` entry point or a missing plugin dependency -- exits with `pytest.ExitCode` `INTERNAL_ERROR` (`3`), with the traceback preserved. `pytest.main` now returns these codes instead of raising `ImportError`. Also fixed an `IndexError` from pytest's own internals when the plugin raised an exception with no arguments. #### Deprecations (removal in next major release) - [#&#8203;14742](https://github.com/pytest-dev/pytest/issues/14742): The private `_pytest.python.CallSpec2` name has been renamed to `CallSpec`. The old `CallSpec2` alias remains available for now and will be removed in pytest 10 or 11. - [#&#8203;14755](https://github.com/pytest-dev/pytest/issues/14755): Schedule *yield_fixture* decorator for removal in pytest 10 or 11. - [#&#8203;14774](https://github.com/pytest-dev/pytest/issues/14774): Similarly to the deprecation of class-scoped fixtures defined as instance methods in pytest 9.1, *all* higher-scoped fixtures (`module`, `package`, and `session`) defined as instance methods are now deprecated. They suffer from the same issue the original deprecation only fixed for class-scoped fixtures, see `10819` and `14011`. - [#&#8203;14808](https://github.com/pytest-dev/pytest/issues/14808): Passing a non-string value to a `string`-typed ini option now emits a `pytest.PytestRemovedIn10Warning`. This affects `[tool.pytest.ini_options]` in `pyproject.toml`. In pytest 10 this will raise a `TypeError`, matching the behavior of the corresponding TOML config path. - [#&#8203;7323](https://github.com/pytest-dev/pytest/issues/7323): Passing `bytes` to `TerminalReporter.write_line()` is now deprecated, pass a `str` instead. #### New features - [#&#8203;14743](https://github.com/pytest-dev/pytest/issues/14743): <span class="title-ref">Full diff:</span> now contains a legend explaining the <span class="title-ref">+</span> & <span class="title-ref">-</span> symbols in diff output. - [#&#8203;2781](https://github.com/pytest-dev/pytest/issues/2781): When `strict_markers` is enabled, marker names used in `-m` expressions are now validated against registered markers. - [#&#8203;6881](https://github.com/pytest-dev/pytest/issues/6881): Added the `parametrize_long_str_id_strategy` configuration option to control how long `str`/`bytes` parameter values are handled in auto-generated test IDs. Explicit IDs set via `ids=[...]` or `pytest.param(..., id=...)` are not affected. Available strategies: `short` (default, values over 100 chars fall back to `argname+index`), `sha256` (SHA-256 hex digest), `legacy` (keep full value), and `disallow` (error requesting explicit IDs). #### Improvements in existing functionality - [#&#8203;10745](https://github.com/pytest-dev/pytest/issues/10745): A `RecursionError` whose recursion origin cannot be located now shows only the first and last 10 stack frames, matching what pytest already did when locating the origin failed outright. Previously the full traceback -- often around a thousand near-identical frames -- was rendered, which was both slow and unreadable. Pass `--full-trace` to see every frame. - [#&#8203;10745](https://github.com/pytest-dev/pytest/issues/10745): The line numbers of a module's statements are now computed once per traceback instead of once per traceback entry, which noticeably speeds up rendering failures raised from large test modules. - [#&#8203;11418](https://github.com/pytest-dev/pytest/issues/11418): The cached rewritten modules in `__pycache__` are now invalidated by a hash of the source instead of its modification time, using the checked-hash pyc format from `552`. Timestamps make the cache useless wherever source files get fresh modification times, most notably in CI: a checkout gives every file a new mtime, so a restored cache is discarded in full and every test module is rewritten again. Hashing the source costs roughly 15 microseconds per file and makes the cache survive that. Existing timestamp based caches are ignored and rewritten once. - [#&#8203;12624](https://github.com/pytest-dev/pytest/issues/12624): The `pytest_plugins` variable and the `PYTEST_PLUGINS` environment variable now also accept entry point names of installed plugins (e.g. `xdist`), in addition to importable module names, matching the behavior of the `-p` command-line option. As part of this change, plugins specified by entry point name through these mechanisms are now also listed in the `plugins:` line of the terminal header (`12615`). Based on the original implementation by Marcel Telka in `12616`. - [#&#8203;12697](https://github.com/pytest-dev/pytest/issues/12697): Warnings emitted while importing plugins through `-p`, `PYTEST_PLUGINS`, or entry point autoloading are now captured, filtered, and reported like other warnings. - [#&#8203;12860](https://github.com/pytest-dev/pytest/issues/12860): Assertion diffs for `dict.items()` and `dict.keys()` comparisons (`>=`, `<=`, `>`, `<`, `==`) now show which items are missing, the same way set comparisons do. - [#&#8203;13354](https://github.com/pytest-dev/pytest/issues/13354): `Node.get_closest_marker <_pytest.nodes.Node.get_closest_marker>` now also accepts a `~pytest.MarkDecorator` as its `default`, for example `item.get_closest_marker("foo", pytest.mark.foo(1))`, and returns the wrapped `~pytest.Mark`. Previously the only way to build a `default` was to instantiate `~pytest.Mark` directly, which is private and warns. - [#&#8203;13369](https://github.com/pytest-dev/pytest/issues/13369): Improved the error from `pytest.RunResult.assert_outcomes` when a plugin changes or removes pytest's standard terminal summary, and documented how to isolate output-changing plugins. - [#&#8203;13431](https://github.com/pytest-dev/pytest/issues/13431): Exposed `pytest.ParameterSet` as the type of the return value of `pytest.param()`. This can be used in type annotations and `isinstance` checks. - [#&#8203;13564](https://github.com/pytest-dev/pytest/issues/13564): Issue a warning when fixtures are wrapped with a decorator that prevents correct discovery, including `@classmethod` above `@pytest.fixture` and `@staticmethod` above `@pytest.fixture`. Put `@pytest.fixture` above those decorators on test classes. - [#&#8203;14164](https://github.com/pytest-dev/pytest/issues/14164): Exposed `pytest.Approx` as the type of the return value of `pytest.approx()`. This can be used in type annotations and `isinstance` checks. - [#&#8203;14463](https://github.com/pytest-dev/pytest/issues/14463): Assertion diffs for mappings now match up keys the way the compared mappings match them themselves. Key comparison goes through the mappings' key views instead of plain sets of their keys, so a mapping with its own notion of key equivalence, such as case-insensitive header mappings, no longer reports its common keys as missing on either side. - [#&#8203;14523](https://github.com/pytest-dev/pytest/issues/14523): Large assertion comparison diffs are now built lazily and capped to the truncation budget, so a huge diff is no longer formatted in full just to be truncated. As a consequence, the truncation footer no longer reports the exact number of hidden lines. - [#&#8203;14687](https://github.com/pytest-dev/pytest/issues/14687): The default fd-level output capturing (`--capture=fd`) now skips reading the capture buffer for tests which produce no output, reducing per-test overhead in large test suites. - [#&#8203;14724](https://github.com/pytest-dev/pytest/issues/14724): `--no-summary` now only applies directly to pytest's own summary. The flag no longer skips the `pytest_terminal_summary` hook, so third-party plugins (for example coverage) can still write their terminal summaries. - [#&#8203;14751](https://github.com/pytest-dev/pytest/issues/14751): `parser.addini <pytest.Parser.addini>` now also accepts type expressions for its `type` argument, in addition to the existing string tags: the plain Python types `str`, `bool`, `int`, `float`, a `Literal` of strings, and unions of these (for example `int | str` or `int | Literal["auto"]`). - [#&#8203;14754](https://github.com/pytest-dev/pytest/issues/14754): `pytest.approx()` now rejects infinite relative tolerances for `datetime.timedelta` values with a clear `ValueError` instead of raising `OverflowError`. - [#&#8203;14791](https://github.com/pytest-dev/pytest/issues/14791): The `junit_family`, `junit_logging`, `junit_duration_report`, `console_output_style`, `empty_parameter_set_mark`, `assertion_text_diff_style` and `tmp_path_retention_policy` configuration options are now registered with the set of values they accept: an invalid value now fails with a clean usage error instead of being silently ignored or crashing later, and `pytest --help` lists the accepted values. `config.getini <pytest.Config.getini>` now raises `pytest.UsageError` instead of `TypeError` or `ValueError` when the value read from the configuration file does not match the registered type, so a bad value is always reported as a short usage error message instead of an internal error traceback. Asking for an option name that was never registered still raises `ValueError`. - [#&#8203;15006](https://github.com/pytest-dev/pytest/issues/15006): `pytest.approx` now emits `pytest.PytestApproxDecimalToleranceWarning` when a `rel` or `abs` tolerance is given as a `float` that cannot be represented exactly for a `~decimal.Decimal` comparison, since such a tolerance is widened to the float's exact binary value. - [#&#8203;14675](https://github.com/pytest-dev/pytest/issues/14675), [#&#8203;14953](https://github.com/pytest-dev/pytest/issues/14953), [#&#8203;15153](https://github.com/pytest-dev/pytest/issues/15153), [#&#8203;15132](https://github.com/pytest-dev/pytest/issues/15132): The `truncation_limit_lines`, `truncation_limit_chars`, `max_warnings`, `verbosity_assertions`, `verbosity_test_cases`, `verbosity_subtests`, `tmp_path_retention_count`, `log_level`, `log_cli_level`, `log_file_level`,`log_auto_indent` and `faulthandler_timeout` configuration options now accept native integer (and, for `log_auto_indent`, boolean) values in TOML configuration files, while still accepting strings for backward compatibility. `log_file_mode` now reports invalid values as a usage error. - [#&#8203;15254](https://github.com/pytest-dev/pytest/issues/15254): `tmp_path` and `TempPathFactory.mktemp <pytest.TempPathFactory.mktemp>` no longer list the whole base temporary directory on every call, which made sessions with many temporary directories quadratically slow. Numbers are now handed out from a per-prefix counter, skipping names that already exist. - [#&#8203;4569](https://github.com/pytest-dev/pytest/issues/4569): `Node.add_marker <_pytest.nodes.Node.add_marker>` now stores a `~pytest.Mark` in `node.keywords`, matching what marks applied during collection store. Previously it stored a `~pytest.MarkDecorator`. - [#&#8203;9436](https://github.com/pytest-dev/pytest/issues/9436): Avoided formatting tracebacks for tests marked with `xfail(run=False)`. #### Bug fixes - [#&#8203;10128](https://github.com/pytest-dev/pytest/issues/10128): Configured warning filters now apply to warnings emitted by `pytest_configure` hooks. - [#&#8203;10210](https://github.com/pytest-dev/pytest/issues/10210): `pytest.approx` now raises a `TypeError` for any nested container, not only for one of the same type as its parent. Previously `approx([{"k": 1}])` and `approx({"k": [1]})` were accepted and then compared unequal to every value, silently ignoring the tolerance, while `approx([[1]])` correctly reported that nesting is unsupported. - [#&#8203;10644](https://github.com/pytest-dev/pytest/issues/10644): `monkeypatch.setattr()` no longer leaves a new entry in the instance `__dict__` when it patches an attribute that the instance inherits from its class. Previously `undo()` assigned the inherited value onto the instance, which shadowed the class attribute -- permanently freezing the result for descriptors that resolve dynamically. - [#&#8203;1139](https://github.com/pytest-dev/pytest/issues/1139): Fixed tracebacks showing `???` instead of source lines for code compiled with a filename relative to a directory other than the current working directory -- e.g. compiled Cython modules, when running pytest from a subdirectory of the project root. The source lookup now falls back to searching `sys.path` for such filenames, as the standard `traceback` module does. - [#&#8203;11502](https://github.com/pytest-dev/pytest/issues/11502): The `rootdir` is no longer derived from a configuration file that is not a regular file, such as `--config-file=/dev/null`. - [#&#8203;11783](https://github.com/pytest-dev/pytest/issues/11783): Plugins installed in editable mode (`660`) are marked for assertion rewriting again. Such installs do not record the package's Python files in the distribution metadata, so pytest found nothing to rewrite and assertions inside the plugin lost their introspection. The plugin's entry point is now used to locate the package in that case. - [#&#8203;11933](https://github.com/pytest-dev/pytest/issues/11933): `pytest.warns` no longer re-emits unmatched warnings with `module="warnings"`, which caused `module`-based warning filters to be applied to the wrong warnings. Since `warnings.WarningMessage` does not record the module a warning was emitted with, re-emitted warnings now use the standard `warnings.warn_explicit` default of deriving the module from the warning's filename. - [#&#8203;12175](https://github.com/pytest-dev/pytest/issues/12175): `ExceptionInfo.exconly(tryshort=True) <pytest.ExceptionInfo.exconly>` now strips the `AssertionError:` prefix of failed `assert` statements for `~pytest.ExceptionInfo` objects created by `pytest.raises`, and failures inside `unittest.TestCase.subTest` report the same short crash line as regular tests. - [#&#8203;12223](https://github.com/pytest-dev/pytest/issues/12223): The `message` attribute of `<failure>` and `<error>` elements in `--junitxml` reports is now shortened to whole lines within 500 characters. When something is dropped, it ends with a note pointing to the element text, which still holds the full report. Previously, very verbose assertion output (e.g. with `-vv`) produced attributes tens of thousands of characters long, which some XML parsers fail on. - [#&#8203;12307](https://github.com/pytest-dev/pytest/issues/12307): Fixed truncation of long collections (lists, dicts, sets, etc.) in the "message" part of failed assertions (as in `assert condition, msg`) when using `-vv`: the message now uses the same unlimited repr as the rest of the assertion output, instead of eliding collection elements with `...`. - [#&#8203;12824](https://github.com/pytest-dev/pytest/issues/12824): Custom command-line options now fail with a clear error when their implicit destination conflicts with an existing option, avoiding silent overrides of built-in options such as `-k`. - [#&#8203;13292](https://github.com/pytest-dev/pytest/issues/13292): Fixed a stale rewritten module being used when a test file is modified twice within the same second without changing its size -- the pyc header could only record whole-second timestamps. The cache is now keyed on a hash of the source. - [#&#8203;14036](https://github.com/pytest-dev/pytest/issues/14036): `__tracebackhide__` is now respected in `ExceptionGroup` tracebacks, both for the group itself and for its sub-exceptions. - [#&#8203;14189](https://github.com/pytest-dev/pytest/issues/14189): Nested usage of `caplog.filtering <pytest.LogCaptureFixture.filtering>` no longer removes filters early if they were already present. - [#&#8203;14412](https://github.com/pytest-dev/pytest/issues/14412): Fixed incorrect timing information for subtests and parent tests when `console_output_style = "times"`. - [#&#8203;14445](https://github.com/pytest-dev/pytest/issues/14445): Assertion rewriting no longer evaluates walrus operator (`:=`) expressions more than once, which reported results the test never computed when the expression had side effects. An operand evaluated before a later walrus is now reported with the value it actually saw, so `assert value != identity(value := value.lower())` keeps Python's left-to-right order. - [#&#8203;14552](https://github.com/pytest-dev/pytest/issues/14552): Fixed stale `co_filename` values after a test module or directory is moved. Assertion-rewrite caches are reused when the source hash still matches, and in-memory code objects are pointed at the current path. - [#&#8203;14586](https://github.com/pytest-dev/pytest/issues/14586): Negative values passed to `log_auto_indent` now correctly fall back to no indentation, matching the documented behavior. - [#&#8203;14619](https://github.com/pytest-dev/pytest/issues/14619): Fixed a crash in `pytest.mark.parametrize` when a non-sequence value is passed for a parameter set. It now provides a clear error message during collection. - [#&#8203;14635](https://github.com/pytest-dev/pytest/issues/14635): Fixed fixture resolution failures when specifying multiple test paths on the command line that share common parent directories. Parametrized fixtures defined in a `conftest.py` could be silently dropped depending on the order of the specified paths. - [#&#8203;14637](https://github.com/pytest-dev/pytest/issues/14637): Pytest now correctly skips identical trailing characters in assertion text diffs even when the compared strings differ at the beginning. - [#&#8203;14638](https://github.com/pytest-dev/pytest/issues/14638): Top-level options in `pytest.toml` and `.pytest.toml` files now raise an error instead of being silently ignored when no `[pytest]` table is present. - [#&#8203;14683](https://github.com/pytest-dev/pytest/issues/14683): Fixed a regression in pytest 9.1 where a conftest.py located in the rootdir was no longer visible to tests and doctests collected from *outside* the rootdir (for example when passing a parent directory of the rootdir as a collection argument, or setting `--rootdir` to a subdirectory). As a result, fixtures defined in such a conftest -- including `doctest_namespace` injections -- were not available, causing errors such as `NameError` in doctests. - [#&#8203;14700](https://github.com/pytest-dev/pytest/issues/14700): Fixed an internal error on Python 3.12 when a doctest on a fixture-decorated function was skipped. - [#&#8203;14705](https://github.com/pytest-dev/pytest/issues/14705): TOML configuration files passed via `-c` now also read their configuration from the `[pytest]` table, the one pytest's own configuration files use. The `[tool.pytest]` and `[tool.pytest.ini_options]` tables such files were previously restricted to keep working; using both styles in one file is an error. - [#&#8203;14828](https://github.com/pytest-dev/pytest/issues/14828): Exception groups raised from another exception now print their cause chain only once in the traceback output. - [#&#8203;14864](https://github.com/pytest-dev/pytest/issues/14864): Fixed collection on Windows collecting the whole suite instead of the given path, on file systems which do not support file IDs (`st_ino` is `0` for every file, as seen for example on `sshfs-win`/WinFsp mounts). - [#&#8203;14884](https://github.com/pytest-dev/pytest/issues/14884): `Cache.get()`, `Cache.set()` and `Cache.mkdir()` now reject keys that resolve outside the cache directory, and `--cache-show` ignores glob matches outside it. - [#&#8203;14909](https://github.com/pytest-dev/pytest/issues/14909): Fixed `MonkeyPatch.delattr <pytest.MonkeyPatch.delattr>`, `MonkeyPatch.setitem <pytest.MonkeyPatch.setitem>` and `MonkeyPatch.delitem <pytest.MonkeyPatch.delitem>` recording a stale undo entry when the underlying mutation failed, which could cause spurious errors during teardown. The undo entry is now recorded only after the mutation succeeds, matching the behavior of `MonkeyPatch.setattr <pytest.MonkeyPatch.setattr>`. - [#&#8203;14912](https://github.com/pytest-dev/pytest/issues/14912): `~pytest.PytestWarning` instances defined in `_pytest.deprecated` are no longer reused across `warnings.warn` calls, so warnings raised as errors (e.g. with `-W error`) no longer accumulate stale traceback frames from previous raises. - [#&#8203;14942](https://github.com/pytest-dev/pytest/issues/14942): Fixed a regression in 9.1.0 that made collection very slow (quadratic) when many fixtures are defined with the same name. This can happen particularly when many tests are defined in separate classes which inherit from a base class which defines fixtures (the fixtures are repeated per class). - [#&#8203;15005](https://github.com/pytest-dev/pytest/issues/15005): `pytest.approx` no longer treats finite `~decimal.Decimal` values outside the `float` range (such as `Decimal("1e400")`) as infinite, which made in-tolerance comparisons fail. - [#&#8203;15006](https://github.com/pytest-dev/pytest/issues/15006): Restored the tolerance shown by `pytest.approx` for `~decimal.Decimal` values, which since 9.0 displayed `???` for the default tolerance and reported the raw `rel` ratio instead of the absolute tolerance actually compared against. - [#&#8203;15006](https://github.com/pytest-dev/pytest/issues/15006): The failure message for `pytest.approx` comparisons of `~decimal.Decimal` collections no longer reports `Max absolute difference: -inf`, or crashes for mappings, when the `decimal.FloatOperation` trap is set. - [#&#8203;15006](https://github.com/pytest-dev/pytest/issues/15006): `pytest.approx` no longer raises `AttributeError` when comparing `numpy.ndarray` instances with `object` dtype, such as arrays of `~decimal.Decimal`. - [#&#8203;15032](https://github.com/pytest-dev/pytest/issues/15032): Help texts for command-line options and configuration options now keep their indentation and blank lines. Previously each line was stripped before wrapping, so a wrapped list item was indistinguishable from a new one and blank lines were dropped; configuration option help lost its line breaks entirely. - [#&#8203;15043](https://github.com/pytest-dev/pytest/issues/15043): Cache writes now emit `pytest.PytestCacheWarning` when writing or closing the cache file fails, consistent with errors opening the file. - [#&#8203;15052](https://github.com/pytest-dev/pytest/issues/15052): Fixed possible off-by-one line numbers in `--fixtures` and `--fixtures-per-test` output. - [#&#8203;15145](https://github.com/pytest-dev/pytest/issues/15145): With `console_output_style` set to `times`, durations just below a unit boundary are now shown in the next unit (e.g. `1.000ms` instead of `1000.0us`). - [#&#8203;15172](https://github.com/pytest-dev/pytest/issues/15172): Assertion diffs now pretty-print the built-in `frozendict` (Python 3.15+) across multiple lines, similarly to how `dict` is displayed. - [#&#8203;4569](https://github.com/pytest-dev/pytest/issues/4569): `-k` no longer matches attributes that end up in a test function's `__dict__` without being meant as keywords, such as pytest's own `pytestmark` attribute and the bookkeeping left behind by `functools.wraps` and `functools.lru_cache`. - [#&#8203;6750](https://github.com/pytest-dev/pytest/issues/6750): Fix fixture argument discovery for custom collectors that pass bound methods to `pytest.Function`. - [#&#8203;6997](https://github.com/pytest-dev/pytest/issues/6997): XFAIL reports from teardown phases now include the phase in the short test summary. - [#&#8203;7940](https://github.com/pytest-dev/pytest/issues/7940): Fixed cleanup of temporary directories failing when subdirectories have their execute permission removed. - [#&#8203;8321](https://github.com/pytest-dev/pytest/issues/8321): Fixed exception chains being duplicated in the traceback output when an exception in the chain (`__cause__`/`__context__`) has no traceback of its own, and that exception is itself linked to further exceptions. - [#&#8203;8914](https://github.com/pytest-dev/pytest/issues/8914): Tests parametrized with higher-than-function scope are now reordered by parameter *value* rather than by parameter *index*, so that items using equal parameter values are grouped together and share a single fixture setup, even when they are parametrized by separate `@pytest.mark.parametrize <pytest.mark.parametrize ref>` calls. Previously, an expensive higher-scoped fixture could be set up and torn down repeatedly for the same parameter value. Unhashable parameter values (e.g. dicts) keep the previous index-based grouping behavior. As a consequence, the order in which parametrized tests run may change (fixture setup/teardown counts can only decrease, not increase). - [#&#8203;9924](https://github.com/pytest-dev/pytest/issues/9924): Fixed doctest option flags leaking between docstrings after a failure, skip, or expected failure. #### Improved documentation - [#&#8203;10721](https://github.com/pytest-dev/pytest/issues/10721): Replaced `setup.py` usage with `pyproject.toml` in `writing-plugins`. - [#&#8203;12658](https://github.com/pytest-dev/pytest/issues/12658): Moved the fixture setup and finalizer hooks to the test running hooks section in the reference documentation. - [#&#8203;12857](https://github.com/pytest-dev/pytest/issues/12857): Documented how `--confcutdir` affects initial `conftest.py` discovery. - [#&#8203;14157](https://github.com/pytest-dev/pytest/issues/14157): Added the `pytest-flakefighters` plugin to the list of flaky test plugins in `plugins.rst`. Added flaky test papers published on the [Test FLARE](https://test-flare.github.io/) project to the list of flaky papers in `plugins.rst`. - [#&#8203;15127](https://github.com/pytest-dev/pytest/issues/15127): Added guidance on typing yield fixtures, including annotating fixture functions with their generator type and fixture consumers with the yielded value type. - [#&#8203;15242](https://github.com/pytest-dev/pytest/issues/15242): The `installation instructions <installation>` and `install-package-with-pip` now show how to install pytest into a virtual environment with venv and pip, uv or virtualenv, and explain the `externally-managed-environment` error. - [#&#8203;4569](https://github.com/pytest-dev/pytest/issues/4569): `pytest --help`, the `-k` reference entry and `select-tests` no longer describe `-k` as a Python expression matched against test names only; `keyword expressions` now shows marker names being matched as well. The examples that looked up a marker use `Node.get_closest_marker <_pytest.nodes.Node.get_closest_marker>` rather than `item.keywords`. - [#&#8203;9614](https://github.com/pytest-dev/pytest/issues/9614): Clarified that `session.items` and `session.testscollected` exclude deselected tests in the `pytest_collection` documentation. #### Packaging updates and notes for downstreams - [#&#8203;11680](https://github.com/pytest-dev/pytest/issues/11680): Source archives of arbitrary commits -- the tarballs GitHub serves under `/archive/`, not just the ones for tags -- can now be built into an sdist or a wheel with a correct version. A `.git_archival.txt` file, expanded by `git archive` via `export-subst`, carries the describe output that `setuptools-scm` would otherwise have to ask `git` for. The archival file deliberately omits `ref-names`. Recording it would make the content of an archive -- and therefore its checksum -- change whenever a branch that points at the archived commit is moved afterwards, which is how the equivalent tarballs of tagged releases became unstable for other projects. Describe output alone depends only on the commit and on the tags reachable from it. The archival file is not shipped in the sdist -- an sdist carries its version in its metadata, and the template is only ever expanded by `git archive`. Building pytest from a git checkout now requires `setuptools-scm >= 10.1`. - [#&#8203;9236](https://github.com/pytest-dev/pytest/issues/9236): `pluggy>=1.6` is now required. Older pluggy versions stopped running the remaining hook wrapper teardowns once an old-style `hookwrapper` raised in its own teardown. The logging plugin's wrapper was left suspended, and when it was finalised later it detached the handler that `caplog` of a subsequent test was recording through, so that test saw no records. #### Contributor-facing changes - [#&#8203;14813](https://github.com/pytest-dev/pytest/issues/14813): Added a systematic coverage matrix for assertion rewriting. - [#&#8203;14921](https://github.com/pytest-dev/pytest/issues/14921): Added <span class="title-ref">scripts/diff-assert-rewrite.py</span>, which diffs the assert-rewritten form of a snippet between the plain source, this checkout and released pytest versions. - [#&#8203;15190](https://github.com/pytest-dev/pytest/issues/15190): Fixed the documentation build with Pluggy 1.7 by ignoring a reference to its undocumented `DistFacade` compatibility class. #### Miscellaneous internal changes - [#&#8203;13888](https://github.com/pytest-dev/pytest/issues/13888): `FixtureRequest.node <pytest.FixtureRequest.node>` is now explicitly annotated as returning `Any`, so strict pyright no longer reports it as `Unknown`. The return type stays deliberately broad, see `13888`. - [#&#8203;14758](https://github.com/pytest-dev/pytest/issues/14758): Internal node ids (the `::`-separated strings identifying collected items, e.g. `path/to/test_file.py::TestClass::test_method[param]`) are now represented internally by a single structured `~_pytest.nodeid.NodeId` dataclass instead of being repeatedly re-parsed as plain strings. The public `nodeid: str` attribute on nodes and reports is unchanged and remains fully backward compatible for plugins. </details> <details> <summary>pytest-dev/pytest-asyncio (pytest-asyncio)</summary> ### [`v1.5.0`](https://github.com/pytest-dev/pytest-asyncio/releases/tag/v1.5.0): pytest-asyncio v1.5.0 [Compare Source](https://github.com/pytest-dev/pytest-asyncio/compare/v1.4.1.post1...v1.5.0) ### [1.5.0](https://github.com/pytest-dev/pytest-asyncio/tree/1.5.0) - 2026-11-12 #### Added - A `fixture-scope` value for `asyncio_default_fixture_loop_scope`. With it, an asynchronous fixture without `loop_scope` uses its `scope` as its loop scope. This is the behavior of an unset option in pytest-asyncio 1.x. ([#&#8203;1095](https://github.com/pytest-dev/pytest-asyncio/issues/1095)) #### Fixed - Invalid arguments to the `asyncio` marker, including an invalid `loop_scope`, are reported with a message that names the test instead of a traceback. ([#&#8203;1584](https://github.com/pytest-dev/pytest-asyncio/issues/1584)) </details> <details> <summary>tox-dev/sphinx-autodoc-typehints (sphinx-autodoc-typehints)</summary> ### [`v3.17.5`](https://github.com/tox-dev/sphinx-autodoc-typehints/releases/tag/3.17.5) [Compare Source](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.4...3.17.5) [🐍 PyPI release](https://pypi.org/project/sphinx-autodoc-typehints/3.17.5/) [📜 Full Changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.4...3.17.5) ### [`v3.17.4`](https://github.com/tox-dev/sphinx-autodoc-typehints/releases/tag/3.17.4) [Compare Source](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.3...3.17.4) ##### 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 ([#&#8203;1105](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1105)) by [@&#8203;gaborbernat](https://github.com/gaborbernat). [🐍 PyPI release](https://pypi.org/project/sphinx-autodoc-typehints/3.17.4/) [📜 Full Changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.3...3.17.4) ### [`v3.17.3`](https://github.com/tox-dev/sphinx-autodoc-typehints/releases/tag/3.17.3) [Compare Source](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.2...3.17.3) ##### Packaging - Publish categorized GitHub Release notes with PyPI and version-comparison links ([#&#8203;1094](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1094)) by [@&#8203;gaborbernat](https://github.com/gaborbernat). [🐍 PyPI release](https://pypi.org/project/sphinx-autodoc-typehints/3.17.3/) [📜 Full Changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.2...3.17.3) ### [`v3.17.2`](https://github.com/tox-dev/sphinx-autodoc-typehints/releases/tag/3.17.2) [Compare Source](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.1...3.17.2) ##### Bug fixes - Link an overridden method to a documented public owner when its defining class is private and absent from the intersphinx inventory. [#&#8203;1090](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1090) by [@&#8203;gaborbernat](https://github.com/gaborbernat). [🐍 PyPI release](https://pypi.org/project/sphinx-autodoc-typehints/3.17.2/) [📜 Full Changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.1...3.17.2) ### [`v3.17.1`](https://github.com/tox-dev/sphinx-autodoc-typehints/releases/tag/3.17.1) [Compare Source](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.0...3.17.1) ##### Packaging - Describe the package as rendering Python type hints in Sphinx autodoc documentation. [#&#8203;1089](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1089) by [@&#8203;gaborbernat](https://github.com/gaborbernat). [🐍 PyPI release](https://pypi.org/project/sphinx-autodoc-typehints/3.17.1/) [📜 Full Changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.17.0...3.17.1) ### [`v3.17.0`](https://github.com/tox-dev/sphinx-autodoc-typehints/releases/tag/3.17.0) [Compare Source](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.16.0...3.17.0) ##### Features - Add `typehints_modernize_annotations` to render legacy `typing` aliases with current Python spelling. [#&#8203;1085](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1085) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Add an `"optional"` default style that marks parameters callers may omit without printing their default values. [#&#8203;1086](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1086) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Allow a callback to read descriptions from `Annotated` metadata classes other than `Doc`. [#&#8203;1088](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1088) by [@&#8203;gaborbernat](https://github.com/gaborbernat). <a name="release-3-17-0-documentation"></a> ##### Documentation - Explain how Sphinx's `autodoc_preserve_defaults` applies to default values in parameter descriptions. [#&#8203;1087](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1087) by [@&#8203;gaborbernat](https://github.com/gaborbernat). [🐍 PyPI release](https://pypi.org/project/sphinx-autodoc-typehints/3.17.0/) [📜 Full Changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.16.0...3.17.0) ### [`v3.16.0`](https://github.com/tox-dev/sphinx-autodoc-typehints/releases/tag/3.16.0) [Compare Source](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.15.0...3.16.0) ##### Features - Read `Doc` descriptions from annotated-doc as well as typing_extensions. [#&#8203;1083](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1083) by [@&#8203;gaborbernat](https://github.com/gaborbernat). <a name="release-3-16-0-fixed"></a> ##### Bug fixes - Register the value stylesheet through Sphinx's static-directory API, so loading the extension does not change `html_static_path`. [#&#8203;1079](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1079) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Honor `autodoc_use_type_comments = False` when reading types from a function's `# type:` comment. [#&#8203;1080](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1080) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1081](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1081) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep single-word prose in hand-written `:Returns:` fields, and recognize numpydoc return types containing spaces. [#&#8203;1082](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1082) by [@&#8203;gaborbernat](https://github.com/gaborbernat). <a name="release-3-16-0-documentation"></a> ##### Documentation - Document support for both Sphinx autodoc implementations and cover re-exported types and `NamedTuple` references in both modes. [#&#8203;1084](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1084) by [@&#8203;gaborbernat](https://github.com/gaborbernat). [🐍 PyPI release](https://pypi.org/project/sphinx-autodoc-typehints/3.16.0/) [📜 Full Changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.15.0...3.16.0) ### [`v3.15.0`](https://github.com/tox-dev/sphinx-autodoc-typehints/releases/tag/3.15.0) [Compare Source](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.14.0...3.15.0) ##### Features - Allow projects to show selected `Annotated` metadata in rendered types with `typehints_annotated_metadata`. [#&#8203;1071](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1071) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Process method signatures of classes defined inside functions when the module exports the class under a name autodoc can import. [#&#8203;1072](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1072) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Let `typehints_formatter` receive whether a type appears in a parameter, return, attribute or base when `typehints_formatter_pass_context` is enabled. [#&#8203;1073](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1073) by [@&#8203;gaborbernat](https://github.com/gaborbernat). <a name="release-3-15-0-fixed"></a> ##### Bug fixes - Reread documents when `typehints_formatter` changes in an incremental build, so their rendered types update without `sphinx-build -E`. [#&#8203;1069](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1069) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Stop an unchanged incremental build from reporting `html_static_path` as changed after the extension adds its stylesheet. [#&#8203;1070](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1070) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Document inherited special methods of a generic subclass without raising `Cannot subscript already-subscripted typing.Generic`. [#&#8203;1074](https://github.com/tox-dev/sphinx-autodoc-typehints/issues/1074) [#&#8203;1075](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1075) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show a property setter's type when `Annotated` metadata raises during comparison with the getter type, instead of failing the build. [#&#8203;1076](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1076) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep the description in a hand-written `:Returns:` field instead of interpreting it as a numpydoc return type. [#&#8203;1077](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1077) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Skip imports under `if TYPE_CHECKING and False` instead of resolving types the branch never defines. [#&#8203;1078](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1078) by [@&#8203;gaborbernat](https://github.com/gaborbernat). <a name="release-3-15-0-packaging"></a> ##### 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. [#&#8203;1068](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1068) by [@&#8203;gaborbernat](https://github.com/gaborbernat). [🐍 PyPI release](https://pypi.org/project/sphinx-autodoc-typehints/3.15.0/) [📜 Full Changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.14.0...3.15.0) ### [`v3.14.0`](https://github.com/tox-dev/sphinx-autodoc-typehints/releases/tag/3.14.0) [Compare Source](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.13.10...3.14.0) ##### 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. [#&#8203;867](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/867) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Type the keys of `**kwargs: Unpack[TypedDict]` documented as keyword arguments. [#&#8203;869](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/869) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Add an `Overrides` field linking the base class member a `@typing.override` method replaces. [#&#8203;871](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/871) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show `TypedDict` keys a caller may omit as `NotRequired[...]`, and add an `Extra items` field for PEP 728 `extra_items` and `closed` classes. [#&#8203;873](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/873) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show the `@warnings.deprecated` message as a deprecation notice below the summary. [#&#8203;874](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/874) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;888](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/888) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;889](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/889) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;895](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/895) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;912](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/912) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Type `:ivar:`, `:cvar:` and `:var:` fields from class-body and base class annotations, dropping `ClassVar` and `Final` qualifiers. [#&#8203;916](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/916) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show the yielded type in the `Yields` entry of a generator, keeping a type the docstring already states. [#&#8203;917](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/917) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;918](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/918) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Add a `Setter accepts` field to a property whose setter annotation differs from the getter's return type. [#&#8203;919](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/919) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;921](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/921), [#&#8203;926](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/926), [#&#8203;938](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/938) by [@&#8203;gaborbernat](https://github.com/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>`. [#&#8203;922](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/922) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;923](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/923) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - With `typehints_use_signature = True`, show one typed signature line per `@overload` instead of the untyped implementation signature and an `Overloads` field. [#&#8203;927](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/927) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1044](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1044) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1046](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1046) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1047](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1047) by [@&#8203;gaborbernat](https://github.com/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]`. [#&#8203;1054](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1054) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1058](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1058) by [@&#8203;gaborbernat](https://github.com/gaborbernat). <a name="release-3-14-0-fixed"></a> ##### 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. [#&#8203;789](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/789) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;790](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/790) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;791](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/791), [#&#8203;901](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/901) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;792](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/792) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep numpydoc parameter descriptions with several paragraphs or a list, shared type lines such as `x, y : int`, and single `Yields` entries. [#&#8203;793](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/793) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show `typehints_defaults = "braces-after"` defaults on their own parameter when the docstring already has `:type:` lines or napoleon types. [#&#8203;794](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/794) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;795](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/795) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;796](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/796), [#&#8203;966](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/966) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep the first parameter of static methods bound through `staticmethod(func)` and of name-mangled private static methods. [#&#8203;797](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/797) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Link the types in the `Overloads` list, leave out `self` and `cls`, and show constructor overloads. [#&#8203;798](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/798) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Reread the sources when `always_document_param_types` changes, so incremental builds pick up the new setting. [#&#8203;799](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/799) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Strip the `:no-overloads:` marker from the output when `typehints_document_overloads` is `False`. [#&#8203;800](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/800) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Leave the return annotation off class signatures with `typehints_use_signature_return = True`. [#&#8203;801](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/801) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show a backslash in a signature default once, as plain Sphinx does, unless `strip_signature_backslash` is on. [#&#8203;802](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/802) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Report `sphinx.ext.doctest` failures on the line the example starts on instead of one line late. [#&#8203;804](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/804) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Render a `Callable` parameterized by a `ParamSpec` or `Concatenate` as `Callable[P, int]` instead of `Callable[[P], int]`. [#&#8203;805](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/805) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Render `P.args` and `P.kwargs` as `ParamSpecArgs(P)` and `ParamSpecKwargs(P)`, naming the `ParamSpec` they belong to. [#&#8203;806](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/806) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show the PEP 696 default of a `TypeVar` or `ParamSpec` after its bound, as in `TypeVar(T, bound=int, default=bool)`. [#&#8203;807](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/807) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Render a `ParamSpec` argument list of a generic as a list, `Box[[int, str]]`, instead of a tuple. [#&#8203;808](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/808) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Render a `TypeVarTuple` as `TypeVarTuple(Ts)` linking to `typing.TypeVarTuple`, instead of a broken reference that loses its name. [#&#8203;809](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/809) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Fix broken markup and a reference warning for `Optional[Union[...]]` with `simplify_optional_unions = False` on Python before 3.14. [#&#8203;810](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/810) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Render aliases built with `typing_extensions.TypeAliasType` like `type` statement aliases instead of as the `TypeAliasType` class. [#&#8203;811](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/811) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;813](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/813) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Resolve the classes, type variables and aliases a class body defines in its method annotations under `from __future__ import annotations`. [#&#8203;814](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/814), [#&#8203;941](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/941) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Link instance variable types imported under `TYPE_CHECKING` regardless of which class Sphinx documents first. [#&#8203;815](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/815) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Type keyword arguments documented in a napoleon `Keyword Args` section, and stop `always_document_param_types` listing them again under Parameters. [#&#8203;816](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/816) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - With `autoclass_content = "both"`, list each constructor parameter once, including those added through `always_document_param_types` or `Doc()`. [#&#8203;817](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/817), [#&#8203;925](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/925) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Read stub definitions inside `sys.version_info` and `sys.platform` blocks, merge all overload variants of a stub function, and check re-exports. [#&#8203;818](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/818) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;819](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/819) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;820](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/820) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;822](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/822) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Fix an `AttributeError` building man pages for projects that document a function taking a `type` alias. [#&#8203;823](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/823) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Pass the Sphinx config to `typehints_formatter` when rendering signatures with `typehints_use_signature` or `typehints_use_signature_return`. [#&#8203;824](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/824) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;825](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/825) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;826](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/826) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Import the submodules a `.pyi` stub refers to through `import pkg.sub` or `from . import sub`, so their types are no longer dropped. [#&#8203;827](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/827) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Resolve annotations in the module that defines an object, so re-exported objects with a reassigned `__module__` find their `TYPE_CHECKING` imports. [#&#8203;828](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/828) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;829](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/829), [#&#8203;920](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/920) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;830](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/830) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Link a `type` alias to its own entry, not to a different documented alias with the same name. [#&#8203;831](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/831) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Run `TYPE_CHECKING` guards written as `if not TYPE_CHECKING: ... else:` or combined with `and`/`or`, so their imports resolve. [#&#8203;833](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/833) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Read `self.x: T` annotations nested in `if`, `try`, `with`, loop and `match` blocks of `__init__`, and handle a positional-only `self`. [#&#8203;834](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/834) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Strip types from the signature of `functools.cache` and `functools.lru_cache` decorated functions on Python 3.14. [#&#8203;835](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/835) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;836](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/836), [#&#8203;886](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/886) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;837](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/837), [#&#8203;884](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/884) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep the annotations in the signatures of `functools.singledispatch` implementations, so each registered implementation shows the type it dispatches on. [#&#8203;838](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/838) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;839](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/839) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep backslashes in `Literal` values, so `Literal["\n"]` renders as written instead of `Literal['n']`. [#&#8203;840](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/840) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Render `tuple[()]` and `Tuple[()]` as the empty tuple instead of a bare `tuple`. [#&#8203;841](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/841) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Expand a generic `type` alias passed to itself, such as `Pair[Pair[int]]`, instead of dropping the inner arguments. [#&#8203;842](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/842) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show the enum of a `Literal` member, as `Literal[Color.RED, Light.RED]` instead of `Literal[RED, RED]`. [#&#8203;843](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/843) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Render subscripted types from `autodoc_mock_imports` modules, such as `NDArray[float64]`, instead of a garbled name. [#&#8203;844](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/844) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Render `Literal` string values that contain backticks without breaking the surrounding markup. [#&#8203;845](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/845) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;846](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/846) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;847](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/847) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Treat numpydoc's `..` placeholder as no description, so entries without one render as `x (int)` instead of `x (int) -- ..`. [#&#8203;848](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/848) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep the numpydoc `Returns` description of a function without parameters instead of adding a second one from the return annotation's `Doc()`. [#&#8203;849](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/849) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep the text of a napoleon NumPy-style `Returns` section that only describes the value. [#&#8203;850](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/850) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Replace a multi-line docstring `:rtype:` as a whole instead of leaving its continuation lines behind. [#&#8203;851](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/851) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - With `typehints_use_rtype = False`, add the return type to a `:returns:` description that contains `--`. [#&#8203;852](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/852) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;853](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/853) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Place the return type before Sphinx directives such as `versionadded`, `deprecated` and `seealso`, as before docutils directives like `note`. [#&#8203;854](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/854) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Link `autodoc_type_aliases` targets documented as module data or in a document read later. [#&#8203;855](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/855) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Link a documented generic `type` alias even when the docs have no entry for its arguments, instead of expanding it. [#&#8203;856](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/856) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;857](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/857) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Stop hiding `@overload` signatures from other Sphinx apps in the same process that do not load the extension. [#&#8203;858](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/858) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Report warnings about admonition content at the right line in documents that use `.. include::`. [#&#8203;859](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/859) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Report an invalid `typehints_defaults` or `typehints_formatter` value as a configuration error instead of an extension crash with a traceback. [#&#8203;860](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/860) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Stop warning `Unparsable type hint comment` for a lambda assigned with a variable type comment. [#&#8203;861](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/861) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep the name and type of a single numpydoc `Returns` entry, rendering `ratio (float) -- The ratio.`. [#&#8203;862](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/862) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Stop printing docutils errors for docstrings of members left out of the output, such as imported ones under `undoc-members`. [#&#8203;863](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/863) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep a numpydoc `Other Parameters` section under its own heading instead of merging it into `Parameters`. [#&#8203;864](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/864) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep the star of an unpacked `*tuple[...]`, rendering it as `Unpack[tuple[...]]`. [#&#8203;865](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/865) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Render bounded and defaulted type variables as `TypeVar(T, bound=int)` without a gap after the `=`. [#&#8203;866](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/866) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep the type inside `InitVar[...]` instead of rendering a bare `InitVar`. [#&#8203;875](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/875) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Leave `:param:`, `:returns:` and `:yields:` lines inside literal blocks and directives alone instead of treating them as the object's fields. [#&#8203;876](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/876) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Type `functools.partial` objects, `partialmethod` and callable instances from the function they call, moving the annotations from the signature into the fields. [#&#8203;877](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/877) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;878](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/878), [#&#8203;897](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/897) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Stop dropping module data and class attributes that hold an annotated callable with `list assignment index out of range`. [#&#8203;879](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/879) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Drop `cls` from the signature of a `@classmethod` stacked on another decorator such as `functools.cache`. [#&#8203;880](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/880) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;881](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/881), [#&#8203;937](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/937) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Document a class or function that sets `__signature__`, such as a pydantic model, by that signature with its fields typed. [#&#8203;883](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/883) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - With `typehints_use_rtype = False`, keep the inline return type when the docstring had an `:rtype:` field. [#&#8203;885](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/885) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;887](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/887) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;891](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/891) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;892](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/892) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;893](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/893) by [@&#8203;gaborbernat](https://github.com/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 ([#&#8203;903](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/903)). [#&#8203;896](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/896) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;902](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/902) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Reread the pages that use a `.pyi` stub when the stub changes, so an incremental build picks up the edit. [#&#8203;905](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/905) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Place the `Overloads` list after a literal block that the summary introduces with `::`, instead of inside it. [#&#8203;907](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/907) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show the positional-only `/` and keyword-only `*` markers, defaults and the stars of `*args` and `**kwargs` in `Overloads` entries. [#&#8203;910](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/910) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Stop rendering `bound="None"` on an unbound `ParamSpec` on Python 3.12 and early 3.13 releases. [#&#8203;911](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/911) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Show a backslash in a parameter default once in the field instead of doubled, in every `typehints_defaults` mode. [#&#8203;913](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/913) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;914](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/914) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;928](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/928) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;931](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/931), [#&#8203;946](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/946) by [@&#8203;gaborbernat](https://github.com/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, ...]`. [#&#8203;939](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/939) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Stop unwrapping at a Sphinx mock, which cost about two seconds for each mocked object the extension processed. [#&#8203;954](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/954) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;960](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/960), [#&#8203;984](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/984) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;963](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/963) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Resolve names that two modules' `if TYPE_CHECKING:` blocks import from each other to their guarded types, whichever module Sphinx documents first. [#&#8203;969](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/969) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;979](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/979) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;980](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/980) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;985](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/985) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1011](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1011) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1013](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1013) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1014](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1014) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;1017](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1017) by [@&#8203;gaborbernat](https://github.com/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`. [#&#8203;1018](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1018) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1019](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1019) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1020](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1020) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Document a constructor, property setter or overload decorated by something from `autodoc_mock_imports` without aborting the build with `wrapper loop when unwrapping`. [#&#8203;1022](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1022) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1025](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1025) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1026](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1026) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1027](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1027) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1030](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1030) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1035](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1035) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1038](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1038) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - A class whose `__module__` is `None` now renders as its bare name instead of a broken cross-reference to `None.ClassName`. [#&#8203;1039](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1039) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1040](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1040) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1045](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1045) by [@&#8203;gaborbernat](https://github.com/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. [#&#8203;1048](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1048) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Warnings that point at a definition list, such as a duplicate label placed before one, now name the line the list starts on instead of the line after it. [#&#8203;1049](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1049) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Stop using the deprecated `SphinxTransform.app` when choosing between an alias and its value, so builds that run Python with `-W error::PendingDeprecationWarning` no longer fail, and the extension keeps working on Sphinx 11. [#&#8203;1051](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1051) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Type the fields napoleon and numpydoc write when they come after `sphinx_autodoc_typehints` in `extensions`; the order the two are listed in no longer matters. [#&#8203;1052](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1052) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep the choices between a type alias and its expanded value per document, so removing or editing a document no longer leaves its choices in the cached environment. The first build after upgrading re-reads every document once. [#&#8203;1059](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1059) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - The return type of a function whose docstring has no `:rtype:` or `:return:` now goes where Sphinx puts the types it adds with `autodoc_typehints = "description"`: after the last field of the first list with parameters, else of the last field list, else in a new list at the end of the docstring. It no longer sits before a definition list, a doctest block, a rubric or a section, nor below a table that follows the parameters, and a warning from a docstring reports its own line rather than one counting the lines added above it. [#&#8203;1060](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1060) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Stop a Sphinx build from hanging on a recursive type alias inside a `Callable` parameter list. [#&#8203;1064](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1064) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep a submodule's type binding when a documented alias in its parent package has the same name. [#&#8203;1065](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1065) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Keep `napoleon_attr_annotations` at its configured boolean value for other Sphinx extensions. [#&#8203;1067](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1067) by [@&#8203;gaborbernat](https://github.com/gaborbernat). <a name="release-3-14-0-documentation"></a> ##### Documentation - Publish the documentation on Read the Docs, with tutorials, how-to guides, a reference and every example rendered live by the extension. [#&#8203;1007](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1007) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Add a typing features gallery that renders every public name of `typing` with the extension, with controls in each example's `conf.py` tab that switch the options it renders with. [#&#8203;1029](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1029) by [@&#8203;gaborbernat](https://github.com/gaborbernat). - Compare both rendered outputs in the README, link the typing examples, and correct the event and return-field descriptions. [#&#8203;1066](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/1066) by [@&#8203;gaborbernat](https://github.com/gaborbernat). <a name="release-3-14-0-packaging"></a> ##### Packaging - Depend on `typing-extensions>=4.16` on Python versions before 3.15. [#&#8203;986](https://github.com/tox-dev/sphinx-autodoc-typehints/pull/986) by [@&#8203;gaborbernat](https://github.com/gaborbernat). [🐍 PyPI release](https://pypi.org/project/sphinx-autodoc-typehints/3.14.0/) [📜 Full Changelog](https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.13.10...3.14.0) </details> --- ### Configuration 📅 **Schedule**: (in timezone Europe/Berlin) - Branch creation - Between 12:00 AM and 05:59 AM, only on Monday (`* 0-5 * * 1`) - 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. 👻 **Immortal**: This PR will be recreated if closed unmerged. Get [config help](https://github.com/renovatebot/renovate/discussions) if that's undesired. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box --- This PR has been generated by [Mend Renovate CLI](https://github.com/renovatebot/renovate). <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0NC4xNjQuNyIsInVwZGF0ZWRJblZlciI6IjQ0LjIyMi41IiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJkZXBlbmRlbmNpZXMiLCJtaW5vciIsInB5dGhvbiJdfQ==-->
renovate-bot force-pushed renovate/all-minor-patch from acb84724c1 to d7471029f0 2026-10-16 21:26:20 +00:00 Compare
renovate-bot changed title from fix(deps): update dependency sphinx-autodoc-typehints to <3.14.1 to fix(deps): update dependency sphinx-autodoc-typehints to <3.15.1 2026-10-16 21:26:22 +00:00
renovate-bot force-pushed renovate/all-minor-patch from d7471029f0 to e1ebc33b9f 2026-10-17 00:23:20 +00:00 Compare
renovate-bot changed title from fix(deps): update dependency sphinx-autodoc-typehints to <3.15.1 to fix(deps): update dependency sphinx-autodoc-typehints to <3.16.1 2026-10-17 00:23:23 +00:00
renovate-bot force-pushed renovate/all-minor-patch from e1ebc33b9f to 037a550cdd 2026-10-17 03:23:08 +00:00 Compare
renovate-bot changed title from fix(deps): update dependency sphinx-autodoc-typehints to <3.16.1 to fix(deps): update dependency sphinx-autodoc-typehints to <3.17.2 2026-10-17 03:23:10 +00:00
renovate-bot force-pushed renovate/all-minor-patch from 037a550cdd to 9919627efb 2026-10-17 19:23:30 +00:00 Compare
renovate-bot changed title from fix(deps): update dependency sphinx-autodoc-typehints to <3.17.2 to fix(deps): update dependency sphinx-autodoc-typehints to <3.17.3 2026-10-17 19:23:33 +00:00
renovate-bot force-pushed renovate/all-minor-patch from 9919627efb to 137738473e 2026-10-22 18:37:06 +00:00 Compare
renovate-bot changed title from fix(deps): update dependency sphinx-autodoc-typehints to <3.17.3 to fix(deps): update all non-major dependencies 2026-10-22 18:37:31 +00:00
renovate-bot force-pushed renovate/all-minor-patch from 137738473e to ba4b7e1036 2026-11-01 23:37:06 +00:00 Compare
Author
Collaborator

Edited/Blocked Notification

Renovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR.

You can manually request rebase by checking the rebase/retry box above.

⚠️ Warning: custom changes will be lost.

### Edited/Blocked Notification Renovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR. You can manually request rebase by checking the rebase/retry box above. ⚠️ **Warning**: custom changes will be lost.
renovate-bot force-pushed renovate/all-minor-patch from ba4b7e1036 to c081418ccb
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
2026-11-08 23:36:26 +00:00
Compare
renovate-bot force-pushed renovate/all-minor-patch from c081418ccb
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
to e1201cc426
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
Test / test (pull_request) Successful in 3m10s
2026-11-14 21:25:29 +00:00
Compare
renovate-bot force-pushed renovate/all-minor-patch from e1201cc426
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
Test / test (pull_request) Successful in 3m10s
to ab71c29a47
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
Test / test (pull_request) Successful in 3m5s
2026-11-16 00:38:35 +00:00
Compare
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
Test / test (pull_request) Successful in 3m5s
This pull request can be merged automatically.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin 'renovate/all-minor-patch:renovate/all-minor-patch'
git switch 'renovate/all-minor-patch'

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch 'main'
git merge --no-ff 'renovate/all-minor-patch'
git switch 'renovate/all-minor-patch'
git rebase 'main'
git switch 'main'
git merge --ff-only 'renovate/all-minor-patch'
git switch 'renovate/all-minor-patch'
git rebase 'main'
git switch 'main'
git merge --no-ff 'renovate/all-minor-patch'
git switch 'main'
git merge --squash 'renovate/all-minor-patch'
git switch 'main'
git merge --ff-only 'renovate/all-minor-patch'
git switch 'main'
git merge 'renovate/all-minor-patch'
git push origin 'main'
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
dawid/langchain-memvid!51
No description provided.