https://github.com/python/cpython/commit/29f8a67ae00081a36fdc97f2f2f96f971393a22a
commit: 29f8a67ae00081a36fdc97f2f2f96f971393a22a
branch: main
author: Tian Gao <[email protected]>
committer: gaogaotiantian <[email protected]>
date: 2025-02-08T23:35:28Z
summary:
Provide curframe_locals for backward compatibility but deprecate it (#125951)
files:
A Misc/NEWS.d/next/Library/2024-11-23-21-17-28.gh-issue-124369.Z0hQFQ.rst
M Doc/whatsnew/3.14.rst
M Lib/pdb.py
M Lib/test/test_pyclbr.py
diff --git a/Doc/whatsnew/3.14.rst b/Doc/whatsnew/3.14.rst
index ba7e8b42ef1f24..23b1f5f2e0c67c 100644
--- a/Doc/whatsnew/3.14.rst
+++ b/Doc/whatsnew/3.14.rst
@@ -932,6 +932,14 @@ Deprecated
write new code. The :mod:`subprocess` module is recommended instead.
(Contributed by Victor Stinner in :gh:`120743`.)
+* :mod:`pdb`:
+ The undocumented ``pdb.Pdb.curframe_locals`` attribtue is now a deprecated
+ read-only property. The low overhead dynamic frame locals access added in
+ Python 3.13 by PEP 667 means the frame locals cache reference previously
+ stored in this attribute is no longer needed. Derived debuggers should access
+ ``pdb.Pdb.curframe.f_locals`` directly in Python 3.13 and later versions.
+ (Contributed by Tian Gao in :gh:`124369` and :gh:`125951`.)
+
* :mod:`symtable`:
Deprecate :meth:`symtable.Class.get_methods` due to the lack of interest.
(Contributed by Bénédikt Tran in :gh:`119698`.)
diff --git a/Lib/pdb.py b/Lib/pdb.py
index beef74d792250b..4abf216b773780 100644
--- a/Lib/pdb.py
+++ b/Lib/pdb.py
@@ -90,6 +90,7 @@
from contextlib import contextmanager
from rlcompleter import Completer
from types import CodeType
+from warnings import deprecated
class Restart(Exception):
@@ -421,6 +422,16 @@ def setup(self, f, tb):
]
self.rcLines = []
+ @property
+ @deprecated("The frame locals reference is no longer cached. Use
'curframe.f_locals' instead.")
+ def curframe_locals(self):
+ return self.curframe.f_locals
+
+ @curframe_locals.setter
+ @deprecated("Setting 'curframe_locals' no longer has any effect. Update
the contents of 'curframe.f_locals' instead.")
+ def curframe_locals(self, value):
+ pass
+
# Override Bdb methods
def user_call(self, frame, argument_list):
diff --git a/Lib/test/test_pyclbr.py b/Lib/test/test_pyclbr.py
index 25b313f6c25a4e..74910980567763 100644
--- a/Lib/test/test_pyclbr.py
+++ b/Lib/test/test_pyclbr.py
@@ -226,7 +226,7 @@ def test_others(self):
cm(
'pdb',
# pyclbr does not handle elegantly `typing` or properties
- ignore=('Union', '_ModuleTarget', '_ScriptTarget', '_ZipTarget'),
+ ignore=('Union', '_ModuleTarget', '_ScriptTarget', '_ZipTarget',
'curframe_locals'),
)
cm('pydoc', ignore=('input', 'output',)) # properties
diff --git
a/Misc/NEWS.d/next/Library/2024-11-23-21-17-28.gh-issue-124369.Z0hQFQ.rst
b/Misc/NEWS.d/next/Library/2024-11-23-21-17-28.gh-issue-124369.Z0hQFQ.rst
new file mode 100644
index 00000000000000..31840da74a2dea
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2024-11-23-21-17-28.gh-issue-124369.Z0hQFQ.rst
@@ -0,0 +1 @@
+Deprecate ``pdb.Pdb.curframe_locals``
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]
