January '25 backporting

.circleci/config.yml

@@ -1,7 +1,7 @@
 version: 2.1
 
 orbs:
-  python: cjw296/python-ci@4
+  python: cjw296/python-ci@5
 
 jobs:
   check-package:
@@ -37,6 +37,7 @@ common: &common
               - cimg/python:3.10
               - cimg/python:3.11
               - cimg/python:3.12
+              - cimg/python:3.13
 
     - python/pip-run-tests:
         python: pypy3
@@ -71,7 +72,7 @@ common: &common
           parameters:
             image:
               - cimg/python:3.6
-              - cimg/python:3.12
+              - cimg/python:3.13
         requires:
           - package
 

.readthedocs.yml

@@ -13,3 +13,4 @@ python:
         - docs
 sphinx:
   fail_on_warning: true
+  configuration: docs/conf.py

NEWS.d/2023-12-22-20-49-52.gh-issue-113407.C_O13_.rst

@@ -0,0 +1 @@
+Fix import of :mod:`unittest.mock` when CPython is built without docstrings.

NEWS.d/2023-12-29-17-57-45.gh-issue-113569.qcRCEI.rst

@@ -0,0 +1,2 @@
+Indicate if there were no actual calls in unittest
+:meth:`~unittest.mock.Mock.assert_has_calls` failure.

NEWS.d/2024-02-27-13-05-51.gh-issue-75988.In6LlB.rst

@@ -0,0 +1 @@
+Fixed :func:`unittest.mock.create_autospec` to pass the call through to the wrapped object to return the real result.

NEWS.d/2024-04-22-21-54-12.gh-issue-90848.5jHEEc.rst

@@ -0,0 +1 @@
+Fixed :func:`unittest.mock.create_autospec` to configure parent mock with keyword arguments.

NEWS.d/2024-06-04-08-57-02.gh-issue-65454.o9j4wF.rst

@@ -0,0 +1 @@
+:func:`unittest.mock.Mock.attach_mock` no longer triggers a call to a ``PropertyMock`` being attached.

NEWS.d/2024-06-10-14-00-40.gh-issue-119600.jJMf4C.rst

@@ -0,0 +1,2 @@
+Fix :func:`unittest.mock.patch` to not read attributes of the target when
+``new_callable`` is set. Patch by Robert Collins.

NEWS.d/2024-06-19-15-06-58.gh-issue-120732.OvYV9b.rst

@@ -0,0 +1,2 @@
+Fix ``name`` passing to :class:`unittest.mock.Mock` object when using
+:func:`unittest.mock.create_autospec`.

NEWS.d/2024-07-14-12-25-53.gh-issue-117765.YFMOUv.rst

@@ -0,0 +1 @@
+Improved documentation for :func:`unittest.mock.patch.dict`

NEWS.d/2024-08-10-10-21-44.gh-issue-122858.ZC1rJD.rst

@@ -0,0 +1,2 @@
+Deprecate :func:`!asyncio.iscoroutinefunction` in favor of
+:func:`inspect.iscoroutinefunction`.

NEWS.d/2024-09-13-10-34-19.gh-issue-123934.yMe7mL.rst

@@ -0,0 +1,2 @@
+Fix :class:`unittest.mock.MagicMock` reseting magic methods return values
+after ``.reset_mock(return_value=True)`` was called.

NEWS.d/2024-09-24-13-32-16.gh-issue-124176.6hmOPz.rst

@@ -0,0 +1,4 @@
+Add support for :func:`dataclasses.dataclass` in
+:func:`unittest.mock.create_autospec`. Now ``create_autospec`` will check
+for potential dataclasses and use :func:`dataclasses.fields` function to
+retrieve the spec information.

NEWS.d/2024-11-10-18-14-51.gh-issue-104745.zAa5Ke.rst

@@ -0,0 +1,3 @@
+Limit starting a patcher (from :func:`unittest.mock.patch` or
+:func:`unittest.mock.patch.object`) more than
+once without stopping it

docs/index.txt

@@ -116,7 +116,7 @@ Backporting rules
   .. code-block:: python
 
       def will_never_be_called():
-          pass  # pragma: no cov
+          pass  # pragma: no cover
 
 - If code such as this causes coverage checking to drop below 100%:
 

lastsync.txt

@@ -1 +1 @@
-e6379f72cbc60f6b3c5676f9e225d4f145d5693f
+04091c083340dde7d4eeb6d945c70f3b37d88f85

mock/backports.py

@@ -1,12 +1,15 @@
 import sys
 
 
-if sys.version_info[:2] < (3, 8):
+if sys.version_info[:2] > (3, 9):
+    from inspect import iscoroutinefunction
+elif sys.version_info[:2] >= (3, 8):
+    from asyncio import iscoroutinefunction
+else:
 
-    import asyncio, functools
+    import functools
     from asyncio.coroutines import _is_coroutine
     from inspect import ismethod, isfunction, CO_COROUTINE
-    from unittest import TestCase
 
     def _unwrap_partial(func):
         while isinstance(func, functools.partial):
@@ -35,6 +38,13 @@ def iscoroutinefunction(obj):
         )
 
 
+try:
+    from unittest import IsolatedAsyncioTestCase
+except ImportError:
+    import asyncio
+    from unittest import TestCase
+
+
     class IsolatedAsyncioTestCase(TestCase):
 
         def __init__(self, methodName='runTest'):
@@ -82,8 +92,7 @@ def run(self, result=None):
                 self._tearDownAsyncioLoop()
 
 
-else:
-
-    from asyncio import iscoroutinefunction
-    from unittest import IsolatedAsyncioTestCase
-
+try:
+    from asyncio import _set_event_loop_policy as set_event_loop_policy
+except ImportError:
+    from asyncio import set_event_loop_policy