nti.testing 4.4.0__tar.gz → 4.5.1__tar.gz

{nti_testing-4.4.0 → nti_testing-4.5.1}/CHANGES.rst

@@ -2,6 +2,19 @@
  Changes
 =========
 
+4.5.1 (2026-07-15)
+==================
+
+- Make ``patch_object`` really return the mock object, as documented.
+
+
+4.5.0 (2026-07-07)
+==================
+
+- Add ``patch_object`` to the test bases.
+- Add support for Python 3.15.
+
+
 4.4.0 (2025-11-14)
 ==================
 

{nti_testing-4.4.0 → nti_testing-4.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nti.testing
-Version: 4.4.0
+Version: 4.5.1
 Summary: Support for testing code
 Home-page: https://github.com/OpenNTI/nti.testing
 Author: Jason Madden
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development :: Testing
@@ -322,6 +323,19 @@ ZODB in `nti.testing.zodb`. See the API documentation for details.
  Changes
 =========
 
+4.5.1 (2026-07-15)
+==================
+
+- Make ``patch_object`` really return the mock object, as documented.
+
+
+4.5.0 (2026-07-07)
+==================
+
+- Add ``patch_object`` to the test bases.
+- Add support for Python 3.15.
+
+
 4.4.0 (2025-11-14)
 ==================
 

{nti_testing-4.4.0 → nti_testing-4.5.1}/docs/conf.py

@@ -21,9 +21,9 @@
 # sys.path.insert(0, os.path.abspath('.'))
 import os
 import sys
-import pkg_resources
+from importlib.metadata import version as pkg_version
 sys.path.append(os.path.abspath('../src'))
-rqmt = pkg_resources.require('nti.testing')[0]
+nti_ver = pkg_version('nti.testing')
 
 # -- General configuration ------------------------------------------------
 
@@ -65,9 +65,9 @@ author = u'NextThought'
 # built documents.
 #
 # The short X.Y version.
-version = '%s.%s' % tuple(map(int, rqmt.version.split('.')[:2]))
+version = '%s.%s' % tuple(map(int, nti_ver.split('.')[:2]))
 # The full version, including alpha/beta/rc tags.
-release = rqmt.version
+release = nti_ver
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

{nti_testing-4.4.0 → nti_testing-4.5.1}/setup.py

@@ -6,7 +6,7 @@ from setuptools import setup
 from setuptools import find_namespace_packages
 
 
-version = '4.4.0'
+version = '4.5.1'
 
 entry_points = {
 }
@@ -47,6 +47,7 @@ setup(
         'Programming Language :: Python :: 3.12',
         'Programming Language :: Python :: 3.13',
         'Programming Language :: Python :: 3.14',
+        'Programming Language :: Python :: 3.15',
         'Programming Language :: Python :: Implementation :: CPython',
         'Programming Language :: Python :: Implementation :: PyPy',
         'Topic :: Software Development :: Testing',

{nti_testing-4.4.0 → nti_testing-4.5.1}/src/nti/testing/base.py

@@ -7,32 +7,29 @@ In some cases, you may be better off using :mod:`zope.component.testlayer`.
 
 """
 
-from __future__ import absolute_import
-from __future__ import division
-from __future__ import print_function
-
 # stdlib imports
 import gc
+import logging
 import os
 import platform
 import sys
 import unittest
 from unittest.mock import patch as Patch
 
+import zope.testing.cleanup
 from zope import component
 from zope.component import eventtesting
 from zope.component.hooks import setHooks
 from zope.configuration import config
 from zope.configuration import xmlconfig
 from zope.dottedname import resolve as dottedname
-import zope.testing.cleanup
 
 from hamcrest import assert_that
 from hamcrest import is_
 
 from . import transactionCleanUp
 
-logger = __import__('logging').getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 _marker = object()
@@ -94,7 +91,7 @@ class AbstractConfiguringObject(object):
             package=obj.get_configuration_package())
 
     @staticmethod
-    def _do_configure_packages(obj, # pylint:disable=too-many-positional-arguments
+    def _do_configure_packages(obj, # pylint: disable=too-many-positional-arguments
                                set_up_packages=(),
                                features=(),
                                context=_marker,
@@ -166,6 +163,22 @@ class PatchingMixin:
         """
         return self._install_patch(Patch(*args, **kwargs))
 
+    def patch_object(self, target, attribute, *args, **kwargs):
+        """
+        API for subclasses. All args are passed through to :obj:`unittest.mock.patch.object`
+        which is then started and registered for cleanup.
+
+        This is intended to be used in ``setUp`` or individual test methods
+        when what you might need to patch is dynamic.
+
+        Returns the result of ``patch.start()``, i.e., a mock object.
+
+        .. versionadded:: 4.5.0
+        .. versionchanged:: 4.5.1
+           Actually return the mock object.
+        """
+        return self._install_patch(Patch.object(target, attribute, *args, **kwargs))
+
     def _install_patch(self, patcher):
         """
         Starts the *patcher*, and registers a test tear down cleanup

{nti_testing-4.4.0 → nti_testing-4.5.1}/src/nti/testing/tests/test_base.py

@@ -3,13 +3,8 @@
 """
 Tests for base.py.
 
-.. $Id$
 """
 
-from __future__ import absolute_import
-from __future__ import division
-from __future__ import print_function
-
 # stdlib imports
 import unittest
 
@@ -21,8 +16,6 @@ from hamcrest import is_
 
 __docformat__ = "restructuredtext en"
 
-logger = __import__('logging').getLogger(__name__)
-
 #disable: accessing protected members, too many methods
 #pylint: disable=W0212,R0904
 
@@ -164,3 +157,17 @@ class TestBase(unittest.TestCase):
         X().tearDown()
         Y().setUp()
         Y().tearDown()
+
+
+class TestPatchingMixin(base.PatchingMixin, unittest.TestCase):
+
+    def test_patch_object(self):
+        class ToPatch:
+            def meth(self):
+                return -1
+
+        to_patch = ToPatch()
+        patch_result = self.patch_object(to_patch, 'meth', return_value=42)
+
+        self.assertEqual(to_patch.meth(), 42)
+        self.assertIsNotNone(patch_result)

{nti_testing-4.4.0 → nti_testing-4.5.1}/src/nti.testing.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nti.testing
-Version: 4.4.0
+Version: 4.5.1
 Summary: Support for testing code
 Home-page: https://github.com/OpenNTI/nti.testing
 Author: Jason Madden
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development :: Testing
@@ -322,6 +323,19 @@ ZODB in `nti.testing.zodb`. See the API documentation for details.
  Changes
 =========
 
+4.5.1 (2026-07-15)
+==================
+
+- Make ``patch_object`` really return the mock object, as documented.
+
+
+4.5.0 (2026-07-07)
+==================
+
+- Add ``patch_object`` to the test bases.
+- Add support for Python 3.15.
+
+
 4.4.0 (2025-11-14)
 ==================
 

{nti_testing-4.4.0 → nti_testing-4.5.1}/tox.ini

@@ -33,3 +33,5 @@ commands =
 extras =
     docs
     test
+    zodb
+    test-zodb