Update ForwardRef._evaluate for Python 3.11 (#8600)

recursive_guard argument was added in python/cpython#21553

Author: aronbierbaum

stdlib/typing.pyi

@@ -820,7 +820,13 @@ class ForwardRef:
     else:
         def __init__(self, arg: str, is_argument: bool = ...) -> None: ...
 
-    def _evaluate(self, globalns: dict[str, Any] | None, localns: dict[str, Any] | None) -> Any | None: ...
+    if sys.version_info >= (3, 9):
+        def _evaluate(
+            self, globalns: dict[str, Any] | None, localns: dict[str, Any] | None, recursive_guard: frozenset[str]
+        ) -> Any | None: ...
+    else:
+        def _evaluate(self, globalns: dict[str, Any] | None, localns: dict[str, Any] | None) -> Any | None: ...
+
     def __eq__(self, other: object) -> bool: ...
     if sys.version_info >= (3, 11):
         def __or__(self, other: Any) -> _SpecialForm: ...

tests/stubtest_allowlists/py310.txt

@@ -36,7 +36,6 @@ types.GenericAlias.__getattr__
 types.GenericAlias.__mro_entries__
 types.GenericAlias.__call__  # Would be complicated to fix properly, Any could silence problems. #6392
 typing._SpecialForm.__mro_entries__
-typing.ForwardRef._evaluate
 typing._TypedDict.__delitem__
 typing._TypedDict.__ior__
 typing._TypedDict.__or__

tests/stubtest_allowlists/py311.txt

@@ -42,7 +42,6 @@ platform.uname_result.processor
 queue.SimpleQueue.__init__
 sys.UnraisableHookArgs  # Not exported from sys
 tkinter._VersionInfoType.__doc__
-typing.ForwardRef._evaluate
 typing.NewType.__call__
 typing.NewType.__mro_entries__
 weakref.WeakValueDictionary.update

tests/stubtest_allowlists/py39.txt

@@ -55,7 +55,6 @@ tkinter.Tk.split
 types.CodeType.replace  # stubtest thinks default values are None but None doesn't work at runtime
 types.GenericAlias.__getattr__
 types.GenericAlias.__call__  # Would be complicated to fix properly, Any could silence problems. #6392
-typing.ForwardRef._evaluate
 typing.SupportsAbs.__init__
 typing.SupportsBytes.__init__
 typing.SupportsComplex.__init__