gh-128661: Remove DeprecationWarning in evaluate_forward_ref

It doesn't make sense to use a deprecation for evaluate_forward_ref,
as it is a new function in Python 3.14 and doesn't have compatibility
guarantees.

I considered making it throw an error if type_params it not passed and
there is no owner. However, I think this is too unfriendly for users. The
case where this param is really needed is fairly esoteric and I don't think
this case is worth the pain of forcing users to write "type_params=()".

Author: JelleZijlstra

Doc/library/annotationlib.rst

@@ -192,7 +192,10 @@ Classes
       the global and local namespaces in which the name is evaluated.
       *type_params*, if given, must be a tuple of
       :ref:`type parameters <type-params>` that are in scope while the forward
-      reference is being evaluated. *owner* is the object that owns the
+      reference is being evaluated. This parameter should be provided (though it
+      may be an empty tuple) if the *owner* parameter is not given and the
+      :class:`~ForwardRef` instance does not have an owner set.
+      *owner* is the object that owns the
       annotation from which the forward reference derives, usually a function,
       class, or module.
 

Doc/library/typing.rst

@@ -3439,7 +3439,7 @@ Introspection helpers
    the global and local namespaces.
    *type_params* is a tuple of :ref:`type parameters <type-params>` that
    are in scope when evaluating the forward reference.
-   This parameter must be provided (though it may be an empty tuple) if *owner*
+   This parameter should be provided (though it may be an empty tuple) if *owner*
    is not given and the forward reference does not already have an owner set.
    *format* specifies the format of the annotation and is a member of
    the :class:`annotationlib.Format` enum.

Lib/test/test_typing.py

@@ -7284,20 +7284,7 @@ def test_evaluate_forward_ref(self):
 
     def test_evaluate_forward_ref_no_type_params(self):
         ref = ForwardRef('int')
-        with self.assertWarnsRegex(
-            DeprecationWarning,
-            (
-                "Failing to pass a value to the 'type_params' parameter "
-                "of 'typing.evaluate_forward_ref' is deprecated, "
-                "as it leads to incorrect behaviour"
-            ),
-        ):
-            typing.evaluate_forward_ref(ref)
-
-        # No warnings when `type_params` is passed:
-        with warnings.catch_warnings(record=True) as w:
-            typing.evaluate_forward_ref(ref, type_params=())
-        self.assertEqual(w, [])
+        self.assertIs(typing.evaluate_forward_ref(ref), int)
 
 
 class CollectionsAbcTests(BaseTestCase):

Lib/typing.py

@@ -1024,7 +1024,7 @@ def evaluate_forward_ref(
     owner=None,
     globals=None,
     locals=None,
-    type_params=_sentinel,
+    type_params=None,
     format=annotationlib.Format.VALUE,
     _recursive_guard=frozenset(),
 ):
@@ -1044,15 +1044,12 @@ def evaluate_forward_ref(
     infer the namespaces to use for looking up names. *globals* and *locals*
     can also be explicitly given to provide the global and local namespaces.
     *type_params* is a tuple of type parameters that are in scope when
-    evaluating the forward reference. This parameter must be provided (though
+    evaluating the forward reference. This parameter should be provided (though
     it may be an empty tuple) if *owner* is not given and the forward reference
     does not already have an owner set. *format* specifies the format of the
     annotation and is a member of the annotationlib.Format enum.
 
     """
-    if type_params is _sentinel:
-        _deprecation_warning_for_no_type_params_passed("typing.evaluate_forward_ref")
-        type_params = ()
     if format == annotationlib.Format.STRING:
         return forward_ref.__forward_arg__
     if forward_ref.__forward_arg__ in _recursive_guard: