Test for deferred evaluation of annotations in library.

pekkaklarck · pekkaklarck · commit cca331cccbe6 · 2025-03-20T12:07:28.000+02:00
See PEP 649 for details. Part of Python 3.14 support (#5352).
diff --git a/atest/interpreter.py b/atest/interpreter.py
@@ -57,7 +57,7 @@ def excludes(self):
         if self.is_pypy:
             yield 'no-pypy'
             yield 'require-lxml'
-        for require in [(3, 8), (3, 9), (3, 10)]:
+        for require in [(3, 9), (3, 10), (3, 14)]:
             if self.version_info < require:
                 yield 'require-py%d.%d' % require
         if self.is_windows:
diff --git a/atest/robot/cli/dryrun/type_conversion.robot b/atest/robot/cli/dryrun/type_conversion.robot
@@ -3,7 +3,9 @@ Resource    atest_resource.robot
 
 *** Test Cases ***
 Annotations
-    Run Tests    --dryrun    keywords/type_conversion/annotations.robot
+    # Exclude test requiring Python 3.14 unconditionally to avoid a failure with
+    # older versions. It can be included once Python 3.14 is our minimum versoin.
+    Run Tests    --dryrun --exclude require-py3.14    keywords/type_conversion/annotations.robot
     Should be equal    ${SUITE.status}    PASS
 
 Keyword Decorator
diff --git a/atest/robot/keywords/type_conversion/annotations.robot b/atest/robot/keywords/type_conversion/annotations.robot
@@ -239,3 +239,8 @@ Default value is used if explicit type conversion fails
 
 Explicit conversion failure is used if both conversions fail
     Check Test Case    ${TESTNAME}
+
+Deferred evaluation of annotations
+    [Documentation]    https://peps.python.org/pep-0649
+    [Tags]    require-py3.14
+    Check Test Case    ${TESTNAME}
diff --git a/atest/testdata/keywords/type_conversion/DeferredAnnotations.py b/atest/testdata/keywords/type_conversion/DeferredAnnotations.py
@@ -0,0 +1,21 @@
+from robot.api.deco import library
+
+
+class Library:
+
+    def deferred_evaluation_of_annotations(self, arg: Argument) -> str:
+        return arg.value
+
+
+class Argument:
+
+    def __init__(self, value: str):
+        self.value = value
+
+    @classmethod
+    def from_string(cls, value: str) -> Argument:
+        return cls(value)
+
+
+Library = library(converters={Argument: Argument.from_string},
+                  auto_keywords=True)(Library)
diff --git a/atest/testdata/keywords/type_conversion/annotations.robot b/atest/testdata/keywords/type_conversion/annotations.robot
@@ -1,5 +1,6 @@
 *** Settings ***
 Library                  Annotations.py
+Library                  DeferredAnnotations.py
 Library                  OperatingSystem
 Resource                 conversion.resource
 
@@ -634,3 +635,8 @@ Explicit conversion failure is used if both conversions fail
     [Template]    Conversion Should Fail
     Type and default 4    BANG!    type=list         error=Invalid expression.
     Type and default 3    BANG!    type=timedelta    error=Invalid time string 'BANG!'.
+
+Deferred evaluation of annotations
+    [Tags]    require-py3.14
+    ${value} =    Deferred evaluation of annotations    PEP 649
+    Should be equal    ${value}    PEP 649
