Skip to content

Conversation

@pyup-bot
Copy link
Collaborator

@pyup-bot pyup-bot commented Nov 3, 2025

Update sphinx from 7.3.7 to 8.3.0.

Changelog

8.3.0

==============================

Dependencies
------------

Incompatible changes
--------------------

Deprecated
----------

Features added
--------------

Bugs fixed
----------

Testing
-------
Links

Update furo from 2024.5.6 to 2025.9.25.

The bot wasn't able to find a changelog for this release. Got an idea?

Links

Update sphinx-autobuild from 2024.4.16 to 2025.8.25.

Changelog

2025.08.25

-----------------------

* Drop support for Python 3.9-3.10 to match Sphinx.
* Declare support for Python 3.14.
* Add an optional ``--post-build`` flag to run additional commands
after building the documentation.
* Add support for the ``SPHINX_AUTOBUILD_DEBUG`` environment variable
to help with debugging.

2024.10.03

-----------------------

* Improve error handling for failures in pre-build commands.

2024.10.02

-----------------------

* Show the changed paths that triggered the rebuild.

2024.09.19

-----------------------

* Fix path filtering on Windows by normalising path separators.
* Filter various directories by default (``.git``, ``venv``, etc).
* Serve the correct directory when using make mode (``-M``).

2024.09.18

-----------------------

* Run Sphinx through the Python entry point rather than the binary on PATH.

2024.09.17

-----------------------

* Relax checks for paths that aren't required to exist.

2024.09.03

-----------------------

* Fix support for Python 3.9.
* Fix running ``sphinx-autobuild`` via entry point scripts.
* Run ``sphinx-build`` in a subprocess to mitigate autdoc issues.
* Support the ``-M`` 'make mode' option for ``sphinx-build``.
Links

Update sphinx-sitemap from 2.6.0 to 2.9.0.

Changelog

2.9.0

-----

- |:sparkles:| NEW: Add :confval:`sitemap_indent` configuration value to control XML indentation
`112 <https://github.com/jdillard/sphinx-sitemap/pull/112>`_

2.8.0

-----

- |:sparkles:| NEW: Add support for wildcard patterns to :confval:`sitemap_excludes`
`113 <https://github.com/jdillard/sphinx-sitemap/pull/113>`_

2.7.2

-----

*Release date: 2025-06-26*

- |:bug:| FIX: Change :confval:`sitemap_show_lastmod` to default of ``False``

2.7.1

-----

*Release date: 2025-06-20*

- Remove support for Python 3.8

2.7.0

-----

*Release date: 2025-06-20*

* |:sparkles:| NEW: Add support for ``lastmod`` using `sphinx-last-updated-by-git`_
`95 <https://github.com/jdillard/sphinx-sitemap/pull/95>`_
Links

Update sphinx-click from 5.0.1 to 6.1.0.

The bot wasn't able to find a changelog for this release. Got an idea?

Links

Update sphinx-autodoc-typehints from 2.3.0 to 3.5.2.

Changelog

3.5.2

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Preserve type information from docstrings if no type annotation is present and parameter has default value. by christianaguilera-foundry in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/576

New Contributors
* christianaguilera-foundry made their first contribution in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/576

**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.5.1...3.5.2

3.5.1

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Declare 3.14 support by gaborbernat in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/571


**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.5.0...3.5.1

3.5.0

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Support Union type on its own by gaborbernat in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/570


**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.4.0...3.5.0

3.4.0

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Python 3.14 support by gaborbernat in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/569


**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.3.0...3.4.0

3.3.0

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

* Warning types and subtypes by fajpunk in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/562

New Contributors
* fajpunk made their first contribution in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/562

**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.2.0...3.3.0

3.2.0

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Fixed broken changelog link by agronholm in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/530
* Fix issue 481 by nineteendo in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/533
* Don't add :rtype: None by grayjk in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/538
* Place rtype after directive by grayjk in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/537

New Contributors
* agronholm made their first contribution in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/530
* nineteendo made their first contribution in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/533
* grayjk made their first contribution in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/538

**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.1.0...3.2.0

3.1.0

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Support Sphinx 8.2.0 - drop 3.10 support because Sphinx does by b-kamphorst in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/525

New Contributors
* b-kamphorst made their first contribution in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/525

**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.0.1...3.1.0

3.0.1

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Fix roles for `types` module by flying-sheep in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/516
* Update Ruff to 0.9.1 by flying-sheep in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/517


**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/3.0.0...3.0.1

3.0.0

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* 🐛 Replace docutils private API use w/ public by webknjaz in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/507
* Drop support for nptyping by gaborbernat in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/514

New Contributors
* webknjaz made their first contribution in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/507

**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/2.5.0...3.0.0

2.5.0

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Fix the type checker by gaborbernat in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/493
* Apply typehints_formatter to signature by Priyansh121096 in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/494

New Contributors
* Priyansh121096 made their first contribution in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/494

**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/2.4.4...2.5.0

2.4.4

<!-- Release notes generated using configuration in .github/release.yml at main -->



**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/2.4.3...2.4.4

2.4.3

<!-- Release notes generated using configuration in .github/release.yml at main -->



**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/2.4.2...2.4.3

2.4.2

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Improve the CI by gaborbernat in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/485


**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/2.4.1...2.4.2

2.4.1

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed
* Fix placement of return type when there is a doctest by hoodmane in https://github.com/tox-dev/sphinx-autodoc-typehints/pull/482


**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/2.4.0...2.4.1

2.4.0

<!-- Release notes generated using configuration in .github/release.yml at main -->

- Drop 3.9 support
- Add 3.13 support
- Bump dependencies

**Full Changelog**: https://github.com/tox-dev/sphinx-autodoc-typehints/compare/2.3.0...2.4.0
Links

Update pytest from 8.3.5 to 8.4.2.

Changelog

8.4.1

=========================

Bug fixes
---------

- `13461 <https://github.com/pytest-dev/pytest/issues/13461>`_: Corrected ``_pytest.terminal.TerminalReporter.isatty`` to support
being called as a method. Before it was just a boolean which could
break correct code when using ``-o log_cli=true``).


- `13477 <https://github.com/pytest-dev/pytest/issues/13477>`_: Reintroduced :class:`pytest.PytestReturnNotNoneWarning` which was removed by accident in pytest `8.4`.

This warning is raised when a test functions returns a value other than ``None``, which is often a mistake made by beginners.

See :ref:`return-not-none` for more information.


- `13497 <https://github.com/pytest-dev/pytest/issues/13497>`_: Fixed compatibility with ``Twisted 25+``.



Improved documentation
----------------------

- `13492 <https://github.com/pytest-dev/pytest/issues/13492>`_: Fixed outdated warning about ``faulthandler`` not working on Windows.

8.4.0

=========================

Removals and backward incompatible breaking changes
---------------------------------------------------

- `11372 <https://github.com/pytest-dev/pytest/issues/11372>`_: Async tests will now fail, instead of warning+skipping, if you don't have any suitable plugin installed.


- `12346 <https://github.com/pytest-dev/pytest/issues/12346>`_: Tests will now fail, instead of raising a warning, if they return any value other than None.


- `12874 <https://github.com/pytest-dev/pytest/issues/12874>`_: We dropped support for Python 3.8 following its end of life (2024-10-07).


- `12960 <https://github.com/pytest-dev/pytest/issues/12960>`_: Test functions containing a yield now cause an explicit error. They have not been run since pytest 4.0, and were previously marked as an expected failure and deprecation warning.

See :ref:`the docs <yield tests deprecated>` for more information.



Deprecations (removal in next major release)
--------------------------------------------

- `10839 <https://github.com/pytest-dev/pytest/issues/10839>`_: Requesting an asynchronous fixture without a `pytest_fixture_setup` hook that resolves it will now give a DeprecationWarning. This most commonly happens if a sync test requests an async fixture. This should have no effect on a majority of users with async tests or fixtures using async pytest plugins, but may affect non-standard hook setups or ``autouse=True``. For guidance on how to work around this warning see :ref:`sync-test-async-fixture`.



New features
------------

- `11538 <https://github.com/pytest-dev/pytest/issues/11538>`_: Added :class:`pytest.RaisesGroup` as an equivalent to :func:`pytest.raises` for expecting :exc:`ExceptionGroup`. Also adds :class:`pytest.RaisesExc` which is now the logic behind :func:`pytest.raises` and used as parameter to :class:`pytest.RaisesGroup`. ``RaisesGroup`` includes the ability to specify multiple different expected exceptions, the structure of nested exception groups, and flags for emulating :ref:`except* <except_star>`. See :ref:`assert-matching-exception-groups` and docstrings for more information.


- `12081 <https://github.com/pytest-dev/pytest/issues/12081>`_: Added :fixture:`capteesys` to capture AND pass output to next handler set by ``--capture=``.


- `12504 <https://github.com/pytest-dev/pytest/issues/12504>`_: :func:`pytest.mark.xfail` now accepts :class:`pytest.RaisesGroup` for the ``raises`` parameter when you expect an exception group. You can also pass a :class:`pytest.RaisesExc` if you e.g. want to make use of the ``check`` parameter.


- `12713 <https://github.com/pytest-dev/pytest/issues/12713>`_: New `--force-short-summary` option to force condensed summary output regardless of verbosity level.

This lets users still see condensed summary output of failures for quick reference in log files from job outputs, being especially useful if non-condensed output is very verbose.


- `12749 <https://github.com/pytest-dev/pytest/issues/12749>`_: pytest traditionally collects classes/functions in the test module namespace even if they are imported from another file.

For example:

.. code-block:: python

    contents of src/domain.py
   class Testament: ...


    contents of tests/test_testament.py
   from domain import Testament


   def test_testament(): ...

In this scenario with the default options, pytest will collect the class `Testament` from `tests/test_testament.py` because it starts with `Test`, even though in this case it is a production class being imported in the test module namespace.

This behavior can now be prevented by setting the new :confval:`collect_imported_tests` configuration option to ``false``, which will make pytest collect classes/functions from test files **only** if they are defined in that file.

-- by :user:`FreerGit`


- `12765 <https://github.com/pytest-dev/pytest/issues/12765>`_: Thresholds to trigger snippet truncation can now be set with :confval:`truncation_limit_lines` and :confval:`truncation_limit_chars`.

See :ref:`truncation-params` for more information.


- `13125 <https://github.com/pytest-dev/pytest/issues/13125>`_: :confval:`console_output_style` now supports ``times`` to show execution time of each test.


- `13192 <https://github.com/pytest-dev/pytest/issues/13192>`_: :func:`pytest.raises` will now raise a warning when passing an empty string to ``match``, as this will match against any value. Use ``match="^$"`` if you want to check that an exception has no message.


- `13192 <https://github.com/pytest-dev/pytest/issues/13192>`_: :func:`pytest.raises` will now print a helpful string diff if matching fails and the match parameter has ``^`` and ``$`` and is otherwise escaped.


- `13192 <https://github.com/pytest-dev/pytest/issues/13192>`_: You can now pass :func:`with pytest.raises(check=fn): <pytest.raises>`, where ``fn`` is a function which takes a raised exception and returns a boolean. The ``raises`` fails if no exception was raised (as usual), passes if an exception is raised and ``fn`` returns ``True`` (as well as ``match`` and the type matching, if specified, which are checked before), and propagates the exception if ``fn`` returns ``False`` (which likely also fails the test).


- `13228 <https://github.com/pytest-dev/pytest/issues/13228>`_: :ref:`hidden-param` can now be used in ``id`` of :func:`pytest.param` or in
``ids`` of :py:func:`Metafunc.parametrize <pytest.Metafunc.parametrize>`.
It hides the parameter set from the test name.


- `13253 <https://github.com/pytest-dev/pytest/issues/13253>`_: New flag: :ref:`--disable-plugin-autoload <disable_plugin_autoload>` which works as an alternative to :envvar:`PYTEST_DISABLE_PLUGIN_AUTOLOAD` when setting environment variables is inconvenient; and allows setting it in config files with :confval:`addopts`.



Improvements in existing functionality
--------------------------------------

- `10224 <https://github.com/pytest-dev/pytest/issues/10224>`_: pytest's ``short`` and ``long`` traceback styles (:ref:`how-to-modifying-python-tb-printing`)
now have partial :pep:`657` support and will show specific code segments in the
traceback.

.. code-block:: pytest

   ================================= FAILURES =================================
   _______________________ test_gets_correct_tracebacks _______________________

   test_tracebacks.py:12: in test_gets_correct_tracebacks
       assert manhattan_distance(p1, p2) == 1
              ^^^^^^^^^^^^^^^^^^^^^^^^^^
   test_tracebacks.py:6: in manhattan_distance
       return abs(point_1.x - point_2.x) + abs(point_1.y - point_2.y)
                              ^^^^^^^^^
   E   AttributeError: 'NoneType' object has no attribute 'x'

-- by :user:`ammaraskar`


- `11118 <https://github.com/pytest-dev/pytest/issues/11118>`_: Now :confval:`pythonpath` configures `$PYTHONPATH` earlier than before during the initialization process, which now also affects plugins loaded via the `-p` command-line option.

-- by :user:`millerdev`


- `11381 <https://github.com/pytest-dev/pytest/issues/11381>`_: The ``type`` parameter of the ``parser.addini`` method now accepts `"int"` and ``"float"`` parameters, facilitating the parsing of configuration values in the configuration file.

Example:

.. code-block:: python

 def pytest_addoption(parser):
     parser.addini("int_value", type="int", default=2, help="my int value")
     parser.addini("float_value", type="float", default=4.2, help="my float value")

The `pytest.ini` file:

.. code-block:: ini

 [pytest]
 int_value = 3
 float_value = 5.4


- `11525 <https://github.com/pytest-dev/pytest/issues/11525>`_: Fixtures are now clearly represented in the output as a "fixture object", not as a normal function as before, making it easy for beginners to catch mistakes such as referencing a fixture declared in the same module but not requested in the test function.

-- by :user:`the-compiler` and :user:`glyphack`


- `12426 <https://github.com/pytest-dev/pytest/issues/12426>`_: A warning is now issued when :ref:`pytest.mark.usefixtures ref` is used without specifying any fixtures. Previously, empty usefixtures markers were silently ignored.


- `12707 <https://github.com/pytest-dev/pytest/issues/12707>`_: Exception chains can be navigated when dropped into Pdb in Python 3.13+.


- `12736 <https://github.com/pytest-dev/pytest/issues/12736>`_: Added a new attribute `name` with the fixed value `"pytest tests"` to the root tag `testsuites` of the junit-xml generated by pytest.

This attribute is part of many junit-xml specifications and is even part of the `junit-10.xsd` specification that pytest's implementation is based on.


- `12943 <https://github.com/pytest-dev/pytest/issues/12943>`_: If a test fails with an exceptiongroup with a single exception, the contained exception will now be displayed in the short test summary info.


- `12958 <https://github.com/pytest-dev/pytest/issues/12958>`_: A number of :ref:`unraisable <unraisable>` enhancements:

* Set the unraisable hook as early as possible and unset it as late as possible, to collect the most possible number of unraisable exceptions.
* Call the garbage collector just before unsetting the unraisable hook, to collect any straggling exceptions.
* Collect multiple unraisable exceptions per test phase.
* Report the :mod:`tracemalloc` allocation traceback (if available).
* Avoid using a generator based hook to allow handling :class:`StopIteration` in test failures.
* Report the unraisable exception as the cause of the :class:`pytest.PytestUnraisableExceptionWarning` exception if raised.
* Compute the ``repr`` of the unraisable object in the unraisable hook so you get the latest information if available, and should help with resurrection of the object.


- `13010 <https://github.com/pytest-dev/pytest/issues/13010>`_: :func:`pytest.approx` now can compare collections that contain numbers and non-numbers mixed.


- `13016 <https://github.com/pytest-dev/pytest/issues/13016>`_: A number of :ref:`threadexception <unraisable>` enhancements:

* Set the excepthook as early as possible and unset it as late as possible, to collect the most possible number of unhandled exceptions from threads.
* Collect multiple thread exceptions per test phase.
* Report the :mod:`tracemalloc` allocation traceback (if available).
* Avoid using a generator based hook to allow handling :class:`StopIteration` in test failures.
* Report the thread exception as the cause of the :class:`pytest.PytestUnhandledThreadExceptionWarning` exception if raised.
* Extract the ``name`` of the thread object in the excepthook which should help with resurrection of the thread.


- `13031 <https://github.com/pytest-dev/pytest/issues/13031>`_: An empty parameter set as in ``pytest.mark.parametrize([], ids=idfunc)`` will no longer trigger a call to ``idfunc`` with internal objects.


- `13115 <https://github.com/pytest-dev/pytest/issues/13115>`_: Allows supplying ``ExceptionGroup[Exception]`` and ``BaseExceptionGroup[BaseException]`` to ``pytest.raises`` to keep full typing on :class:`ExceptionInfo <pytest.ExceptionInfo>`:

.. code-block:: python

   with pytest.raises(ExceptionGroup[Exception]) as exc_info:
       some_function()

Parametrizing with other exception types remains an error - we do not check the types of child exceptions and thus do not permit code that might look like we do.


- `13122 <https://github.com/pytest-dev/pytest/issues/13122>`_: The ``--stepwise`` mode received a number of improvements:

* It no longer forgets the last failed test in case pytest is executed later without the flag.

 This enables the following workflow:

 1. Execute pytest with ``--stepwise``, pytest then stops at the first failing test;
 2. Iteratively update the code and run the test in isolation, without the ``--stepwise`` flag (for example in an IDE), until it is fixed.
 3. Execute pytest with ``--stepwise`` again and pytest will continue from the previously failed test, and if it passes, continue on to the next tests.

 Previously, at step 3, pytest would start from the beginning, forgetting the previously failed test.

 This change however might cause issues if the ``--stepwise`` mode is used far apart in time, as the state might get stale, so the internal state will be reset automatically in case the test suite changes (for now only the number of tests are considered for this, we might change/improve this on the future).

* New ``--stepwise-reset``/``--sw-reset`` flag, allowing the user to explicitly reset the stepwise state and restart the workflow from the beginning.


- `13308 <https://github.com/pytest-dev/pytest/issues/13308>`_: Added official support for Python 3.14.


- `13380 <https://github.com/pytest-dev/pytest/issues/13380>`_: Fix :class:`ExceptionGroup` traceback filtering to exclude pytest internals.


- `13415 <https://github.com/pytest-dev/pytest/issues/13415>`_: The author metadata of the BibTex example is now correctly formatted with last names following first names.
An example of BibLaTex has been added.
BibTex and BibLaTex examples now clearly indicate that what is cited is software.

-- by :user:`willynilly`


- `13420 <https://github.com/pytest-dev/pytest/issues/13420>`_: Improved test collection performance by optimizing path resolution used in ``FSCollector``.


- `13457 <https://github.com/pytest-dev/pytest/issues/13457>`_: The error message about duplicate parametrization no longer displays an internal stack trace.


- `4112 <https://github.com/pytest-dev/pytest/issues/4112>`_: Using :ref:`pytest.mark.usefixtures <pytest.mark.usefixtures ref>` on :func:`pytest.param` now produces an error instead of silently doing nothing.


- `5473 <https://github.com/pytest-dev/pytest/issues/5473>`_: Replace `:` with `;` in the assertion rewrite warning message so it can be filtered using standard Python warning filters before calling :func:`pytest.main`.


- `6985 <https://github.com/pytest-dev/pytest/issues/6985>`_: Improved :func:`pytest.approx` to enhance the readability of value ranges and tolerances between 0.001 and 1000.
 * The `repr` method now provides clearer output for values within those ranges, making it easier to interpret the results.
 * Previously, the output for those ranges of values and tolerances was displayed in scientific notation (e.g., `42 ± 1.0e+00`). The updated method now presents the tolerance as a decimal for better readability (e.g., `42 ± 1`).

   Example:

   **Previous Output:**

   .. code-block:: console

       >>> pytest.approx(42, abs=1)
       42 ± 1.0e+00

   **Current Output:**

   .. code-block:: console

       >>> pytest.approx(42, abs=1)
       42 ± 1

 -- by :user:`fazeelghafoor`


- `7683 <https://github.com/pytest-dev/pytest/issues/7683>`_: The formerly optional ``pygments`` dependency is now required, causing output always to be source-highlighted (unless disabled via the ``--code-highlight=no`` CLI option).



Bug fixes
---------

- `10404 <https://github.com/pytest-dev/pytest/issues/10404>`_: Apply filterwarnings from config/cli as soon as possible, and revert them as late as possible
so that warnings as errors are collected throughout the pytest run and before the
unraisable and threadexcept hooks are removed.

This allows very late warnings and unraisable/threadexcept exceptions to fail the test suite.

This also changes the warning that the lsof plugin issues from PytestWarning to the new warning PytestFDWarning so it can be more easily filtered.


- `11067 <https://github.com/pytest-dev/pytest/issues/11067>`_: The test report is now consistent regardless if the test xfailed via :ref:`pytest.mark.xfail <pytest.mark.xfail ref>` or :func:`pytest.fail`.

Previously, *xfailed* tests via the marker would have the string ``"reason: "`` prefixed to the message, while those *xfailed* via the function did not. The prefix has been removed.


- `12008 <https://github.com/pytest-dev/pytest/issues/12008>`_: In :pr:`11220`, an unintended change in reordering was introduced by changing the way indices were assigned to direct params. More specifically, before that change, the indices of direct params to metafunc's callspecs were assigned after all parametrizations took place. Now, that change is reverted.


- `12863 <https://github.com/pytest-dev/pytest/issues/12863>`_: Fix applying markers, including :ref:`pytest.mark.parametrize <pytest.mark.parametrize ref>` when placed above `staticmethod` or `classmethod`.


- `12929 <https://github.com/pytest-dev/pytest/issues/12929>`_: Handle StopIteration from test cases, setup and teardown correctly.


- `12938 <https://github.com/pytest-dev/pytest/issues/12938>`_: Fixed ``--durations-min`` argument not respected if ``-vv`` is used.


- `12946 <https://github.com/pytest-dev/pytest/issues/12946>`_: Fixed missing help for :mod:`pdb` commands wrapped by pytest -- by :user:`adamchainz`.


- `12981 <https://github.com/pytest-dev/pytest/issues/12981>`_: Prevent exceptions in :func:`pytest.Config.add_cleanup` callbacks preventing further cleanups.


- `13047 <https://github.com/pytest-dev/pytest/issues/13047>`_: Restore :func:`pytest.approx` handling of equality checks between `bool` and `numpy.bool_` types.

Comparing `bool` and `numpy.bool_` using :func:`pytest.approx` accidentally changed in version `8.3.4` and `8.3.5` to no longer match:

.. code-block:: pycon

   >>> import numpy as np
   >>> from pytest import approx
   >>> [np.True_, np.True_] == pytest.approx([True, True])
   False

This has now been fixed:

.. code-block:: pycon

   >>> [np.True_, np.True_] == pytest.approx([True, True])
   True


- `13119 <https://github.com/pytest-dev/pytest/issues/13119>`_: Improved handling of invalid regex patterns for filter warnings by providing a clear error message.


- `13175 <https://github.com/pytest-dev/pytest/issues/13175>`_: The diff is now also highlighted correctly when comparing two strings.


- `13248 <https://github.com/pytest-dev/pytest/issues/13248>`_: Fixed an issue where passing a ``scope`` in :py:func:`Metafunc.parametrize <pytest.Metafunc.parametrize>` with ``indirect=True``
could result in other fixtures being unable to depend on the parametrized fixture.


- `13291 <https://github.com/pytest-dev/pytest/issues/13291>`_: Fixed ``repr`` of ``attrs`` objects in assertion failure messages when using ``attrs>=25.2``.


- `13312 <https://github.com/pytest-dev/pytest/issues/13312>`_: Fixed a possible ``KeyError`` crash on PyPy during collection of tests involving higher-scoped parameters.


- `13345 <https://github.com/pytest-dev/pytest/issues/13345>`_: Fix type hints for :attr:`pytest.TestReport.when` and :attr:`pytest.TestReport.location`.


- `13377 <https://github.com/pytest-dev/pytest/issues/13377>`_: Fixed handling of test methods with positional-only parameter syntax.

Now, methods are supported that formally define ``self`` as positional-only
and/or fixture parameters as keyword-only, e.g.:

.. code-block:: python

   class TestClass:

       def test_method(self, /, *, fixture): ...

Before, this caused an internal error in pytest.


- `13384 <https://github.com/pytest-dev/pytest/issues/13384>`_: Fixed an issue where pytest could report negative durations.


- `13420 <https://github.com/pytest-dev/pytest/issues/13420>`_: Added ``lru_cache`` to ``nodes._check_initialpaths_for_relpath``.


- `9037 <https://github.com/pytest-dev/pytest/issues/9037>`_: Honor :confval:`disable_test_id_escaping_and_forfeit_all_rights_to_community_support` when escaping ids in parametrized tests.



Improved documentation
----------------------

- `12535 <https://github.com/pytest-dev/pytest/issues/12535>`_: `This
example`<https://docs.pytest.org/en/latest/example/simple.html#making-test-result-information-available-in-fixtures>
showed ``print`` statements that do not exactly reflect what the
different branches actually do.  The fix makes the example more precise.


- `13218 <https://github.com/pytest-dev/pytest/issues/13218>`_: Pointed out in the :func:`pytest.approx` documentation that it considers booleans unequal to numeric zero or one.


- `13221 <https://github.com/pytest-dev/pytest/issues/13221>`_: Improved grouping of CLI options in the ``--help`` output.


- `6649 <https://github.com/pytest-dev/pytest/issues/6649>`_: Added :class:`~pytest.TerminalReporter` to the :ref:`api-reference` documentation page.


- `8612 <https://github.com/pytest-dev/pytest/issues/8612>`_: Add a recipe for handling abstract test classes in the documentation.

A new example has been added to the documentation to demonstrate how to use a mixin class to handle abstract
test classes without manually setting the ``__test__`` attribute for subclasses.
This ensures that subclasses of abstract test classes are automatically collected by pytest.



Packaging updates and notes for downstreams
-------------------------------------------

- `13317 <https://github.com/pytest-dev/pytest/issues/13317>`_: Specified minimum allowed versions of ``colorama``, ``iniconfig``,
and ``packaging``; and bumped the minimum allowed version
of ``exceptiongroup`` for ``python_version<'3.11'`` from a release
candidate to a full release.



Contributor-facing changes
--------------------------

- `12017 <https://github.com/pytest-dev/pytest/issues/12017>`_: Mixed internal improvements:

* Migrate formatting to f-strings in some tests.
* Use type-safe constructs in JUnitXML tests.
* Moved`` MockTiming`` into ``_pytest.timing``.

-- by :user:`RonnyPfannschmidt`


- `12647 <https://github.com/pytest-dev/pytest/issues/12647>`_: Fixed running the test suite with the ``hypothesis`` pytest plugin.



Miscellaneous internal changes
------------------------------

- `6649 <https://github.com/pytest-dev/pytest/issues/6649>`_: Added :class:`~pytest.TerminalReporter` to the public pytest API, as it is part of the signature of the :hook:`pytest_terminal_summary` hook.
Links

Update pytest-env from 1.1.5 to 1.2.0.

The bot wasn't able to find a changelog for this release. Got an idea?

Links

Update pytest-mock from 3.14.0 to 3.15.1.

Changelog

3.15.1

------

*2025-09-16*

* `529 <https://github.com/pytest-dev/pytest-mock/issues/529>`_: Fixed ``itertools._tee object has no attribute error`` -- now ``duplicate_iterators=True`` must be passed to ``mocker.spy`` to duplicate iterators.

3.15.0

------

*2025-09-04*

* Python 3.8 (EOL) is no longer supported.
* `524 <https://github.com/pytest-dev/pytest-mock/pull/524>`_: Added ``spy_return_iter`` to ``mocker.spy``, which contains a duplicate of the return value of the spied method if it is an ``Iterator``.

3.14.1

-------------------

* `503 <https://github.com/pytest-dev/pytest-mock/pull/503>`_: Python 3.14 is now officially supported.
Links

Update fiftyone from 1.5.2 to 1.10.0.

Changelog

1.10.0

Please see the official [Voxel51 Release Notes](https://docs.voxel51.com/release-notes.html#fiftyone-1-10-0) for details.

1.9.0

Please see the official [Voxel51 Release Notes](https://docs.voxel51.com/release-notes.html#fiftyone-1-9-0) for details.

1.8.1

Please see the official [Voxel51 Release Notes](https://docs.voxel51.com/release-notes.html#fiftyone-1-8-1) for details.

1.8.0

Please see the official [Voxel51 Release Notes](https://docs.voxel51.com/release-notes.html#fiftyone-1-8-0) for details.

1.7.2

Please see the official [Voxel51 Release Notes](https://docs.voxel51.com/release-notes.html#fiftyone-1-7-2) for details.

1.7.1

Please see the official [Voxel51 Release Notes](https://docs.voxel51.com/release-notes.html#fiftyone-1-7-1) for details.

1.7.0

Please see the official [Voxel51 Release Notes](https://docs.voxel51.com/release-notes.html#fiftyone-1-7-0) for details!

1.6.0

Please see the official [Voxel51 Release Notes](https://docs.voxel51.com/release-notes.html#fiftyone-1-6-0) for details.
Links

Update datasets from 3.6.0 to 4.3.0.

Changelog

4.3.0

Added

-   [API] `dataset.info.splits['train'].num_shards` to expose the number of
 shards to the user.
-   [API] `tfds.features.Dataset` to have a field containing sub-datasets (e.g.
 used in RL datasets).
-   [API] dtype and `tf.uint16` support in `tfds.features.Video`.
-   [API] `DatasetInfo.license` field to add redistributing information.
-   [API] `.copy`, `.format` methods to GPath objects.
-   [Performances] `tfds.benchmark(ds)` (compatible with any iterator, not just
 `tf.data`, better colab representation).
-   [Performances] Faster `tfds.as_numpy()` (avoid extra `tf.Tensor` <>
 `np.array` copy).
-   [Testing] Support for custom `BuilderConfig` in `DatasetBuilderTest`.
-   [Testing] `DatasetBuilderTest` now has a `dummy_data` class property which
 can be used in `setUpClass`.
-   [Testing] `add_tfds_id` and cardinality support to `tfds.testing.mock_data`.
-   [Documentation] Better `tfds.as_dataframe` visualisation (Sequence, ragged
 tensor, semantic masks with `use_colormap`).
-   [Experimental] Community datasets support. To allow dynamically import
 datasets defined outside the TFDS repository.
-   [Experimental] Hugging-face compatibility wrapper to use Hugging-face
 datasets directly in TFDS.
-   [Experimental] Riegeli format support.
-   [Experimental] `DatasetInfo.disable_shuffling` to force examples to be read
 in generation order.
-   New datasets.

Fixed

-   Many bugs.

4.2.0

Added

-   [CLI] `tfds build` to the CLI. See
 [documentation](https://www.tensorflow.org/datasets/cli#tfds_build_download_and_prepare_a_dataset).
-   [API] `tfds.features.Dataset` to represent nested datasets.
-   [API] `tfds.ReadConfig(add_tfds_id=True)` to add a unique id to the example
 `ex['tfds_id']` (e.g. `b'train.tfrecord-00012-of-01024__123'`).
-   [API] `num_parallel_calls` option to `tfds.ReadConfig` to overwrite to
 default `AUTOTUNE` option.
-   [API] `tfds.ImageFolder` support for `tfds.decode.SkipDecoder`.
-   [API] Multichannel audio support to `tfds.features.Audio`.
-   [API] `try_gcs` to `tfds.builder(..., try_gcs=True)`
-   Better `tfds.as_dataframe` visualization (ffmpeg video if installed,
 bounding boxes,...).
-   [TESTING] Allow `max_examples_per_splits=0` in `tfds build
 --max_examples_per_splits=0` to test `_split_generators` only (without
 `_generate_examples`).
-   New datasets.

Changed

-   [API] DownloadManager now returns
 [Pathlib-like](https://docs.python.org/3/library/pathlib.html#basic-use)
 objects.
-   [API] Simpler `BuilderConfig` definition: class `VERSION` and
 `RELEASE_NOTES` are applied to all `BuilderConfig`. Config description is
 now optional.
-   [API] To guarantee better deterministic, new validations are performed on
 the keys when creating a dataset (to avoid filenames as keys
 (non-deterministic) and restrict key to `str`, `bytes` and `int`). New
 errors likely indicates an issue in the dataset implementation.
-   [API] `tfds.core.benchmark` now returns a `pd.DataFrame` (instead of a
 `dict`).
-   [API] `tfds.units` is not visible anymore from the public API.
-   Datasets updates.

Deprecated

Removed

-   Configs for all text datasets. Only plain text version is kept. For example:
 `multi_nli/plain_text` -> `multi_nli`.

Fixed

-   [API] Datasets returned by `tfds.as_numpy` are compatible with `len(ds)`.
-   Support 0-len sequence with images of dynamic shape (Fix 2616).
-   Progression bar correctly updated when copying files.
-   Better debugging and error message (e.g. human readable size,...).
-   Many bug fixes (GPath consistency with pathlib, s3 compatibility, TQDM
 visual artifacts, GCS crash on windows, re-download when checksums updated,
 ...).

4.1.0

Added

-   It is now easier to create datasets outside TFDS repository (see our updated
 [dataset creation guide](https://www.tensorflow.org/datasets/add_dataset)).
-   When generating a dataset, if download fails for any reason, it is now
 possible to manually download the data. See
 [doc](https://www.tensorflow.org/datasets/overview#manual_download_if_download_fails).
-   `tfds.core.as_path` to create pathlib.Path-like objects compatible with GCS
 (e.g. `tfds.core.as_path('gs://my-bucket/labels.csv').read_text()`).
-   `verify_ssl=` option to `tfds.download.DownloadConfig` to disable SSH
 certificate during download.
-   New datasets.  Changed
-   All dataset inherit from `tfds.core.GeneratorBasedBuilder`. Converting a
 dataset to beam now only require changing `_generate_examples` (see
 [example and doc](https://www.tensorflow.org/datasets/beam_datasets#instructions)).
-   `_split_generators` should now returns `{'split_name':
 self._generate_examples(), ...}` (but current datasets are backward
 compatible).
-   Better `pathlib.Path`, `os.PathLike` compatibility: `dl_manager.manual_dir`
 now returns a pathlib-Like object. Example: `python text =
 (dl_manager.manual_dir / 'downloaded-text.txt').read_text()` Note: Other
 `dl_manager.download`, `.extract`,... will return pathlib-like objects in
 future versions. `FeatureConnector`,... and most functions should accept
 `PathLike` objects. Let us know if some functions you need are missing.
-   `--record_checksums` now assume the new dataset-as-folder model.

Deprecated

-   `tfds.core.SplitGenerator`, `tfds.core.BeamBasedBuilder` are deprecated and
 will be removed in a future version.

Fixed

-   `BuilderConfig` are now compatible with Beam datasets 2348
-   `tfds.features.Images` can accept encoded `bytes` images directly (useful
 when used with `img_name, img_bytes =
 dl_manager.iter_archive('images.zip')`).
-   Doc API now show deprecated methods, abstract methods to overwrite are now
 documented.
-   You can generate `imagenet2012` with only a single split (e.g. only the
 validation data). Other split will be skipped if not present.

4.0.1

Fixed

-   `tfds.load` when generation code isn't present.
-   GCS compatibility.

4.0.0

Added

-   Dataset-as-folder: Dataset can now be self-contained module in a folder with
 checksums, dummy data,... This simplify implementing datasets outside the
 TFDS repository.
-   `tfds.load` can now load dataset without using the generation class. So
 `tfds.load('my_dataset:1.0.0')` can work even if `MyDataset.VERSION ==
 '2.0.0'` (See 2493).
-   TFDS CLI (see https://www.tensorflow.org/datasets/cli for detail).
-   `tfds.testing.mock_data` does not require metadata files anymore!
-   `tfds.as_dataframe(ds, ds_info)` with custom visualisation
 ([example](https://www.tensorflow.org/datasets/overview#tfdsas_dataframe)).
-   `tfds.even_splits` to generate subsplits (e.g. `tfds.even_splits('train',
 n=3) == ['train[0%:33%]', 'train[33%:67%]', ...]`.
-   `DatasetBuilder.RELEASE_NOTES` property.
-   `tfds.features.Image` now supports PNG with 4-channels.
-   `tfds.ImageFolder` now supports custom shape, dtype.
-   Downloaded URLs are available through `MyDataset.url_infos`.
-   `skip_prefetch` option to `tfds.ReadConfig`.
-   `as_supervised=True` support for `tfds.show_examples`, `tfds.as_dataframe`.
-   tfds.features can now be saved/loaded, you may have to overwrite
 [FeatureConnector.from_json_content](https://www.tensorflow.org/datasets/api_docs/python/tfds/features/FeatureConnector?version=nightly#from_json_content)
 and `FeatureConnector.to_json_content` to support this feature.
-   Script to detect dead-urls.
-   New datasets.

Changed

-   `tfds.as_numpy()` now returns an iterable which can be iterated multiple
 times. To migrate: `next(ds)` -> `next(iter(ds))`.
-   Rename `tfds.features.text.Xyz` -> `tfds.deprecated.text.Xyz`.

Removed

-   `DatasetBuilder.IN_DEVELOPMENT` property.
-   `tfds.core.disallow_positional_args` (should use Py3 `*,` instead).
-   Testing against TF 1.15. Requires Python 3.6.8+.

Fixed

-   Better archive extension detection for `dl_manager.download_and_extract`.
-   Fix `tfds.__version__` in TFDS nightly to be PEP440 compliant
-   Fix crash when GCS not available.
-   Improved open-source workflow, contributor guide, documentation.
-   Many other internal cleanups, bugs, dead code removal, py2->py3 cleanup,
 pytype annotations,...
-   Datasets updates.
Links

Update ultralytics from 8.3.132 to 8.3.223.

Changelog

8.3.223

📊 Key Changes
- FastNMS fix (priority) 🔧
- Sorts and writes back `scores` in-place when `use_triu=False`, ensuring alignment with sorted indices for consistent outputs in downstream consumers like NMSModel.
- PR: Sort scores in FastNMS by Y-T-G ([22537](https://github.com/ultralytics/ultralytics/pull/22537)).

- RT-DETR validation stability ✅
- Ensures `ratio_pad` is correctly formatted during validation to prevent crashes and stabilize evaluation.
- PR: RTDETRDataset ratio_pad fix by Y-T-G ([22525](https://github.com/ultralytics/ultralytics/pull/22525)).

- Export refactor: TensorFlow/TFLite/Edge TPU/TFJS ♻️
- Modular export utilities split into `ultralytics.utils.export.engine` and `ultralytics.utils.export.tensorflow` with wrappers to avoid fragile ops and improve reliability.
- Cleaner exporter code paths for SavedModel, .pb, TFLite (INT8), Edge TPU, and TFJS.
- PR: Refactor exports by Laughing-q ([22115](https://github.com/ultralytics/ultralytics/pull/22115)).

- Accurate FLOPs reporting 📈
- Dependency bump: `ultralytics-thop>=2.0.18` for better FLOPs calculations, improving benchmarking across models (e.g., YOLO11/YOLO26).
- PR: Update dependency by glenn-jocher ([22526](https://github.com/ultralytics/ultralytics/pull/22526)).

- IMX export message clarity 🧭
- Error message now correctly states IMX export supports detection, pose, and classification.
- PR: Update IMX message by lakshanthad ([22533](https://github.com/ultralytics/ultralytics/pull/22533)).

- Standardized dataset class names 🇺🇸
- American English naming in dataset YAMLs (e.g., “doughnut” → “donut”, “armour” → “armor”). Display-only; no impact on training indices.
- PR: Remove British class names by glenn-jocher ([22517](https://github.com/ultralytics/ultralytics/pull/22517)).

🎯 Purpose & Impact
- More correct and stable NMS outputs 🛡️
- The FastNMS fix eliminates mismatches between sorted indices and `scores`, preventing subtle ranking issues and improving result consistency for all users relying on FastNMS.

- Fewer validation crashes for RT-DETR 📏
- Proper `ratio_pad` handling avoids runtime errors and increases reliability during validation and metrics computation.

- Easier, more reliable exports across ecosystems 🌐
- Export refactor reduces edge-case failures in SavedModel/.pb/TFLite/Edge TPU/TFJS flows and centralizes TF-specific logic for cleaner maintenance and future improvements.

- Better, more consistent benchmarks 🔬
- Updated `ultralytics-thop` improves FLOPs accuracy and compatibility, leading to more trustworthy comparisons across models and environments.

- Clearer developer experience ✨
- IMX messaging prevents confusion; dataset naming standardization improves consistency in visualizations and docs.

Quick tip to upgrade:
bash
pip install -U ultralytics


Thanks to contributors Y-T-G, Laughing-q, glenn-jocher, and lakshanthad! 🙌

What's Changed
* Remove British class names by glenn-jocher in https://github.com/ultralytics/ultralytics/pull/22517
* Update IMX export error message with classification models support by lakshanthad in https://github.com/ultralytics/ultralytics/pull/22533
* Update `ultralytics-thop>=2.0.18` by glenn-jocher in https://github.com/ultralytics/ultralytics/pull/22526
* Refactor exports for `saved_model/pb/edgetpu/tfjs` formats by Laughing-q in https://github.com/ultralytics/ultralytics/pull/22115
* Return correctly formatted `ratio_pad` in `RTDETRDataset` by Y-T-G in https://github.com/ultralytics/ultralytics/pull/22525
* `ultralytics 8.3.223` Sort `scores` inplace in `FastNMS` with `use_triu=False` by Y-T-G in https://github.com/ultralytics/ultralytics/pull/22537


**Full Changelog**: https://github.com/ultralytics/ultralytics/compare/v8.3.222...v8.3.223

8.3.222

🌟 Summary
TFLite INT8 export is now enabled for end2end models, plus improved quantized NMS accuracy and full IMX500 Classification support—expanding fast, small-footprint deployments across mobile and edge devices. 🚀📱

📊 Key Changes
- TFLite INT8 for end2end models ✅  
- Enables exporting quantized TFLite INT8 models even when `model.end2end=True` ([Enable TFLite INT8 export for end2end models – PR 22503](https://github.com/ultralytics/ultralytics/pull/22503)).  
- Works with simple commands like:
 - `yolo export model=yolov10n.pt format=tflite int8`
 - `yolo val task=detect model=yolov10n_saved_model/yolov10n_int8.tflite data=coco128.yaml`
- More accurate NMS with quantization 🧠  
- Improves NMS stability and accuracy for quantized exports, especially with TFLite INT8 ([Improve accuracy of NMS export with quantization – PR 22487](https://github.com/ultralytics/ultralytics/pull/22487)).
- IMX500: Classification export + inference 🎛️  
- Adds full Classification task support for IMX500, docs, examples, and benchmarks ([Support IMX export and inference for classification – PR 21405](https://github.com/ultralytics/ultralytics/pull/21405)).
- Documentation and DX polish ✨  
- Consistent US English across docs, logs, tests (e.g., grey→gray, labelled→labeled) ([Standardize American English – PR 22508](https://github.com/ultralytics/ultralytics/pull/22508)).  
- Clearer hyperparameter tuning guidance ([Clarify tuning limitations – PR 22513](https://github.com/ultralytics/ultralytics/pull/22513)).  
- Fixed a segmentation docs snippet variable name ([Fix variable name – PR 22501](https://github.com/ultralytics/ultralytics/pull/22501)).  
- Added a Construction-PPE training video to the dataset page ([Add PPE video – PR 22485](https://github.com/ultralytics/ultralytics/pull/22485)).  
- Shorter docs banner copy ([Update Banner Text – PR 22486](https://github.com/ultralytics/ultralytics/pull/22486)).
- CI and tooling upgrades 🧰  
- Expanded Ruff rules in docs CI ([Update docs.yml with RUF and FA – PR 22480](https://github.com/ultralytics/ultralytics/pull/22480)).  
- Cleaner Codespell config to reduce false positives ([Update codespell settings – PR 22509](https://github.com/ultralytics/ultralytics/pull/22509)).  
- GitHub Actions artifact steps bumped to latest ([download-artifact v6 – PR 22489](https://github.com/ultralytics/ultralytics/pull/22489), [upload-artifact v5 – PR #22490](https://github.com/ultralytics/ultralytics/pull/22490)).

🎯 Purpose & Impact
- Broader edge deployment options 🌍  
- INT8 TFLite for end2end models unlocks smaller, faster models on mobile and embedded devices with minimal friction.
- Better accuracy under quantization 📈  
- Improved NMS logic helps retain performance when using INT8 exports—meaning more reliable results on constrained hardware.
- IMX500 across tasks 🧩  
- With Classification now supported alongside Detection and Pose, teams can cover more use cases on the Raspberry Pi AI Camera and similar devices.
- Smoother onboarding and contributor experience 🧑‍💻  
- Clearer docs, fewer CI false positives, and corrected examples reduce confusion and speed up development.

Happy exporting and deploying! ⚡

What's Changed
* Update docs.yml with `RUF` and `FA` ruff formatting by glenn-jocher in https://github.com/ultralytics/ultralytics/pull/22480
* Update Banner Text by sergiuwaxmann in https://github.com/ultralytics/ultralytics/pull/22486
* Bump actions/download-artifact from 5 to 6 in /.github/workflows by dependabot[bot] in https://github.com/ultralytics/ultralytics/pull/22489
* Bump actions/upload-artifact from 4 to 5 in /.github/workflows by dependabot[bot] in https://github.com/ultralytics/ultralytics/pull/22490
* Add https://youtu.be/lFaVnrhMmaE to docs by RizwanMunawar in https://github.com/ultralytics/ultralytics/pull/22485
* Improve accuracy of NMS export with quantization by Y-T-G in https://github.com/ultralytics/ultralytics/pull/22487
* Fix British english by glenn-jocher in https://github.com/ultralytics/ultralytics/pull/22508
* Update pyproject.toml codespell settings by glenn-jocher in https://github.com/ultralytics/ultralytics/pull/22509
* Support IMX export and inference for classification by ambitious-octopus in https://github.com/ultralytics/ultralytics/pull/21405
* Clarify hyperparameter tuning limitations in guide by amm1111 in https://github.com/ultralytics/ultralytics/pull/22513
* Fix variable name from `res` to `results` by RizwanMunawar in https://github.com/ultralytics/ultralytics/pull/22501
* `ultralytics 8.3.222` Enable TFLite INT8 export for end2end models by Y-T-G in https://github.com/ultralytics/ultralytics/pull/22503


**Full Changelog**: https://github.com/ultralytics/ultralytics/compare/v8.3.221...v8.3.222

8.3.221

📊 Key Changes
- Codebase-wide Ruff refactor (current PR) by glenn-jocher:
- Modern type hints using PEP 604 unions (e.g., `Path | None`, `dict | None`).
- Cleanup of unused variables, fewer ` noqa`, standardized imports, safer disk-usage vars.
- More Pythonic constructs (iterable unpacking, `next(...)` for first matches, clearer f-string formatting with `!s`, `!r`).
- Consistent rounding in image padding/letterbox flows: `int(round(...))` → `round(...)`.
- Reordered `__all__` exports and minor logging/output polish.
- Docs and CI improvements:
- Stricter Ruff rules (Pyflakes F) enabled in docs workflow to catch undefined names and unused imports earlier. See the updated workflow in docs CI.
- Exception logging simplified from `str(e)` to `f"{e}"` across code and docs for cleaner messages.
- ExecuTorch docs link updated to the correct backend setup page. See the updated ExecuTorch docs.
- Testing reliability:
- Test suite now uses pytest’s built-in `tmp_path` for better isolation and parallel test stability, replacing ad-hoc TMP dir usage.

References:
- Current PR: ultralytics 8.3.221 Ruff RUF refactor
- Docs CI linting: Use --extend-select F in docs.yml
- Exception logging cleanup: Use f"{e}"
- ExecuTorch doc fix: Fix ExecuTorch docs URL

🎯 Purpose & Impact
- Developer experience 🧑‍💻
- Cleaner, more consistent codebase and type hints improve IDE assistance, readability, and maintenance.
- Stricter CI linting catches common issues earlier, leading to higher-quality contributions.
- User experience 🚀
- No model or API changes; performance and results remain consistent for YOLO11 and other models.
- Slightly more consistent image padding behavior from rounding standardization in examples/utilities; impact should be negligible.
- Documentation & reliability 📚🔧
- Correct ExecuTorch links reduce setup confusion.
- Test isolation via `tmp_path` improves CI stability and confidence in releases.

Upgrade note: No action required. If contributing, ensure your PRs pass the stricter Ruff checks and follow the updated exception/logging patterns. ✅

What's Changed
* Fix ExecuTorch docs URL by lakshanthad in https://github.com/ultralytics/ultralytics/pull/22468
* Use `f"{e}"` by glenn-jocher in https://github.com/ultralytics/ultralytics/pull/22473
* Use `--extend-select F` in docs.yml by glenn-jocher in https://github.com/ultralytics/ultralytics/pull/22474
* Replace TMP dir usage with builtin `tmp_path` for improved test isolation by Borda in https://github.com/ultralytics/ultralytics/pull/22456
* `ultralytics 8.3.221` Ruff `RUF` refactor by glenn-jocher in https://github.com/ultralytics/ultralytics/pull/22475


**Full Changelog**: https://github.com/ultralytics/ultralytics/compare/v8.3.220...v8.3.221

8.3.220

🌟 Summary
ExecuTorch export lands! You can now export YOLO11/YOLO26 models to .pte with XNNPACK acceleration for fast, native on-device inference on mobile and edge devices. Plus, a stability fix for CLIP embedding extraction in VisualAI. 📱⚡🧠

📊 Key Changes
- ExecuTorch export (primary update)
- New export target: `format=executorch` → outputs a `.pte` model inside a `<name>_executorch_model/` directory
- Integrated into `export_formats()` and the exporter flow
- New `export_executorch()` method using `torch.export`, `XnnpackPartitioner`, and `to_edge_transform_and_lower`
- Saves model metadata alongside the .pte file for easy integration
- Backend/runtime support added in AutoBackend for `.pte` loading and inference dispatch
- Docs: New ExecuTorch integration guide and export tables updated
- Tests: Added CLI and matrix export tests (skipped on Windows)
- VisualAI stability improvement
- Safely detaches CLIP embeddings before converting to NumPy to avoid autograd errors and reduce memory overhead

Minimal usage:
- CLI: `yolo export model=yolo11n.pt format=executorch`
- Python:
python
from ultralytics import YOLO
YOLO("yolo11n.pt").export(format="executorch")


Helpful links:
- Learn more in the ExecuTorch integration docs
- ExecuTorch overview and usage: [Deploy YOLO11 with ExecuTorch](https://docs.ultralytics.com/integrations/executorch/)
- ExecuTorch project: [Meta’s ExecuTorch](https://pytorch.org/executorch/)

🎯 Purpose & Impact
- Mobile and edge deployment made easy 🚀
- One-line export to `.pte` for running models on iOS, Android, and embedded Linux devices via ExecuTorch
- Uses XNNPACK by default for optimized CPU performance on mobile
- Early benchmarks on devices like Raspberry Pi indicate notable speedups (around 2x in example tests), with accuracy parity
- Streamlined developer workflow ✅
- Feels like any other Ultralytics export target; consistent UX and metadata packaging
- Clear docs and examples for integrating on mobile and embedded platforms
- Compatibility notes 🧩
- Requires Python 3.10+, PyTorch ≥ 2.9, `executorch` and `flatbuffers` installed
- Export writes both `.pte` and `metadata.yaml`; inference via ExecuTorch runtime (not standard Python `YOLO()` loading)
- Improved stability for VisualAI 🔒
- Detaching CLIP embeddings prevents gradient-related errors and reduces memory use during similarity search

Overall, this release expands deployment options for YOLO11/YOLO26—especially for mobile and edge users—while improving robustness in VisualAI workflows. 🎉

What's Changed
* Fix `VisualAI` clip feature extraction numpy() grad error by RizwanMunawar in https://github.com/ultralytics/ultralytics/pull/22463
* `ultralytics 8.3.220` Add ExecuTorch export (.pte) with XNNPACK by ambitious-octopus in https://github.com/ultralytics/ultralytics/pull/22244


**Full Changelog**: https://github.com/ultralytics/ultralytics/compare/v8.3.219...v8.3.220

8.3.219

🌟 Summary
FastSAM gets a reliable mask-resizing fix and a cleaner, built-in CLIP integration for prompt-based segmentation—improving accuracy, stability, and ease of use. 🚀🖼️

📊 Key Changes
- 🧩 FastSAM mask upsampling fix
- Masks are now converted to float before upsampling and then thresholded back to byte: ensures accurate, error-free resizing during prompts.
- 🤖 Built-in CLIP integration
- Replaced external CLIP dependency with the internal `ultralytics.nn.text_model.CLIP`, standardizing image/text feature extraction and similarity scoring.
- 🔧 Version bump
- Updated package version to `8.3.219`.

Reference: See the current PR [FastSAM masks .float() upsampling fix (PR 22460)](https://github.com/ultralytics/ultralytics/pull/22460) by Y-T-G.

🎯 Purpose & Impact
- ✅ More accurate segmentation prompts
- Prevents artifacts and type-related errors during mask resizing, yielding cleaner, more reliable masks in FastSAM workflows.
- 🛡️ Improved robustness and compatibility
- Reduces issues across different PyTorch versions and image sizes by using correct tensor types and thresholding.
- 🧱 Simpler, more reliable text prompts
- Built-in CLIP removes ad-hoc installs and runtime imports, improving setup speed, offline usability, and consistency across environments.
- 💼 No action needed for most users
- Existing FastSAM usage benefits automatically; prompt-based segmentation should be more stable out of the box.

What's Changed
* `ultralytics 8.3.219` FastSAM masks `.float()` upsampling fix by Y-T-G in https://github.com/ultralytics/ultralytics/pull/22460


**Full Changelog**: https://github.com/ultralytics/ultralytics/compare/v8.3.218...v8.3.219

8.3.218

🌟 Summary
Better, faster multi-GPU training: v8.3.218 enables true multi-GPU validation during training with correct cross-GPU metric aggregation and a new contiguous sampler for stable evaluation. 🚀

📊 Key Changes
- Multi-GPU validation during training ✅
- Validation DataLoader and Validator are now created on all ranks for proper DistributedDataParallel (DDP) execution.
- Rank-aware device selection ensures each process validates on its own GPU.
- New ContiguousDistributedSampler 🧩
- Preserves dataset ordering by assigning contiguous, batch-aligned chunks per GPU.
- Automatically used when `shuffle=False` (e.g., rect/size-grouped evaluation) to prevent interleaved indices.
- Falls back to PyTorch’s `DistributedSampler` when `shuffle=True`.
- Correct cross-GPU metric aggregation 📈
- Validation losses are reduced across GPUs.
- Detection/classification validators gather stats from all ranks and compute results on rank 0 only.
- EMA buffers are synchronized from rank 0 to all GPUs to keep validation consistent.
- Trainer flow improvements 🛠️
- Validation is executed outside the inner training step for cleaner DDP behavior.
- Final evaluation flow streamlined; only necessary work is done on rank 0, with safe synchronization for others.
- Documentation update 📚
- Added reference docs for `ContiguousDistribut

@pyup-bot
Copy link
Collaborator Author

Closing this in favor of #632

@pyup-bot pyup-bot closed this Nov 10, 2025
@guysmoilov guysmoilov deleted the pyup-scheduled-update-2025-11-03 branch November 10, 2025 14:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants