Raise TypeError instead of RuntimeError if __classcell__ is used in typed namedtuples

Author: johnslavik

Doc/library/typing.rst

@@ -2359,10 +2359,6 @@ types.
        # A functional syntax is also supported
        Employee = NamedTuple('Employee', [('name', str), ('id', int)])
 
-   .. note::
-      Using :func:`super` (and the ``__class__`` :term:`closure variable`) in methods of ``NamedTuple`` subclasses
-      is unsupported and causes a :class:`RuntimeError`.
-
    .. versionchanged:: 3.6
       Added support for :pep:`526` variable annotation syntax.
 
@@ -2380,6 +2376,10 @@ types.
    .. versionchanged:: 3.11
       Added support for generic namedtuples.
 
+   .. versionchanged:: next
+      Using :func:`super` (and the ``__class__`` :term:`closure variable`) in methods of ``NamedTuple`` subclasses
+      is unsupported and causes a :class:`TypeError`.
+
    .. deprecated-removed:: 3.13 3.15
       The undocumented keyword argument syntax for creating NamedTuple classes
       (``NT = NamedTuple("NT", x=int)``) is deprecated, and will be disallowed

Lib/test/test_typing.py

@@ -8365,12 +8365,12 @@ def test_super_explicitly_disallowed(self):
             "in methods of NamedTuple subclasses"
         )
 
-        with self.assertRaises(RuntimeError, msg=expected_message):
+        with self.assertRaises(TypeError, msg=expected_message):
             class ThisWontWork(NamedTuple):
                 def __repr__(self):
                     return super().__repr__()
 
-        with self.assertRaises(RuntimeError, msg=expected_message):
+        with self.assertRaises(TypeError, msg=expected_message):
             class ThisWontWorkEither(NamedTuple):
                 @property
                 def name(self):

Lib/typing.py

@@ -2962,7 +2962,7 @@ class NamedTupleMeta(type):
     def __new__(cls, typename, bases, ns):
         assert _NamedTuple in bases
         if "__classcell__" in ns:
-            raise RuntimeError(
+            raise TypeError(
                 "uses of super() and __class__ are unsupported in methods of NamedTuple subclasses")
         for base in bases:
             if base is not _NamedTuple and base is not Generic:

Misc/NEWS.d/next/Library/2025-02-13-15-10-56.gh-issue-85795.jeXXI9.rst

@@ -1,3 +1,3 @@
 Using :func:`super` and ``__class__`` :term:`closure variable` in
 user-defined methods of :class:`typing.NamedTuple` subclasses is now
-explicitly prevented at runtime.
+explicitly prohibited at runtime.