From f7d4d419ef7495611a42506f8db0773979e921f2 Mon Sep 17 00:00:00 2001 From: Theron Luhn Date: Tue, 10 Nov 2026 22:30:33 -0800 Subject: [PATCH 1/3] Deprecate `pyramid.util.DottedNameResolver`. Remove top-level `pyramid.resolver` import to prevent future circular dependencies. --- src/pyramid/scripts/pshell.py | 3 ++- src/pyramid/util.py | 27 ++++++++++++++++++++------- tests/test_util.py | 35 +++++++++++++++++++++++++++++++++++ 3 files changed, 57 insertions(+), 8 deletions(-) diff --git a/src/pyramid/scripts/pshell.py b/src/pyramid/scripts/pshell.py index 0ac3871c7..003dc322f 100644 --- a/src/pyramid/scripts/pshell.py +++ b/src/pyramid/scripts/pshell.py @@ -7,9 +7,10 @@ import textwrap from pyramid.paster import bootstrap +from pyramid.path import DottedNameResolver from pyramid.scripts.common import get_config_loader, parse_vars from pyramid.settings import aslist -from pyramid.util import DottedNameResolver, make_contextmanager +from pyramid.util import make_contextmanager def main(argv=sys.argv, quiet=False): diff --git a/src/pyramid/util.py b/src/pyramid/util.py index 288867c12..a517abe0c 100644 --- a/src/pyramid/util.py +++ b/src/pyramid/util.py @@ -4,8 +4,7 @@ import inspect import platform import weakref - -from pyramid.path import DottedNameResolver as _DottedNameResolver +from zope.deprecation import deprecated _marker = object() @@ -20,11 +19,25 @@ PYPY = False -class DottedNameResolver(_DottedNameResolver): - def __init__( - self, package=None - ): # default to package = None for bw compat - _DottedNameResolver.__init__(self, package) +def DottedNameResolver(package=None): + """ + .. deprecated:: 2.2 + + Please use :class:`pyramid.resolver.DottedNameResolver` instead. + + """ + from pyramid.path import DottedNameResolver as _DottedNameResolver + + return _DottedNameResolver(package) + + +deprecated( + 'DottedNameResolver', + ( + '`pyramid.util.DottedNameResolver` has been moved to ' + '`pyramid.resolver.DottedNameResolver`.' + ), +) def text_(s, encoding='latin-1', errors='strict'): diff --git a/tests/test_util.py b/tests/test_util.py index c96e7bb1f..11afe8c12 100644 --- a/tests/test_util.py +++ b/tests/test_util.py @@ -4,6 +4,41 @@ from pyramid.util import bytes_, text_ +class TestDottedNameResolver(unittest.TestCase): + def _makeOne(self, *args): + from pyramid.util import DottedNameResolver + + return DottedNameResolver(*args) + + def test_resolve(self): + """ + Test that basic resolver functionality works as expected. + """ + import tests.test_util + + resolver = self._makeOne() + result = resolver.resolve('tests.test_util') + self.assertEqual(result, tests.test_util) + + def test_package_none(self): + """ + Test that package defaults to ``None``, rather than new behavior of + ``caller_package``. + """ + resolver = self._makeOne() + self.assertRaises(ValueError, resolver.resolve, '.test_util') + + def test_package_explicit(self): + """ + Test that package argument is honored. + """ + import tests.test_util + + resolver = self._makeOne('tests') + result = resolver.resolve('.test_util') + self.assertEqual(result, tests.test_util) + + class Test_InstancePropertyHelper(unittest.TestCase): def _makeOne(self): cls = self._getTargetClass() From 7f85dd663473edf2dbd2e29adbe295371bb20624 Mon Sep 17 00:00:00 2001 From: Theron Luhn Date: Wed, 11 Nov 2026 00:18:05 -0800 Subject: [PATCH 2/3] Update CHANGES.rst --- CHANGES.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/CHANGES.rst b/CHANGES.rst index c4ca57431..7948934f7 100644 --- a/CHANGES.rst +++ b/CHANGES.rst @@ -21,9 +21,17 @@ Bug Fixes Backward Incompatibilities -------------------------- +- Replace ``pyramid.util.DottedNameResolver`` with a shim. Users should use + ``pyramid.path.DottedNameResolver`` instead. See + https://github.com/Pylons/pyramid/pull/3837. + Deprecations ------------ +- Deprecate ``pyramid.util.DottedNameResolver`` in favor of + ``pyramid.path.DottedNameResolver``. See + https://github.com/Pylons/pyramid/pull/3837. + Documentation Changes --------------------- From dd087aa110e0eabfbee43ac7fcdb35331852dc67 Mon Sep 17 00:00:00 2001 From: Theron Luhn Date: Wed, 11 Nov 2026 12:00:49 -0800 Subject: [PATCH 3/3] Fix paths. --- src/pyramid/util.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/pyramid/util.py b/src/pyramid/util.py index a517abe0c..74677c59e 100644 --- a/src/pyramid/util.py +++ b/src/pyramid/util.py @@ -23,7 +23,7 @@ def DottedNameResolver(package=None): """ .. deprecated:: 2.2 - Please use :class:`pyramid.resolver.DottedNameResolver` instead. + Please use :class:`pyramid.path.DottedNameResolver` instead. """ from pyramid.path import DottedNameResolver as _DottedNameResolver @@ -35,7 +35,7 @@ def DottedNameResolver(package=None): 'DottedNameResolver', ( '`pyramid.util.DottedNameResolver` has been moved to ' - '`pyramid.resolver.DottedNameResolver`.' + '`pyramid.path.DottedNameResolver`.' ), )