refactor: disallow python 3.9 for functions api (#2354)

Co-authored-by: Jonas Blanc <jonas.blanc@cognite.com>

Author: jonasblanc

cognite/client/_api/functions.py

@@ -246,7 +246,7 @@ def create(
             env_vars (dict[str, str] | None): Environment variables as key/value pairs. Keys can contain only letters, numbers or the underscore character. You can create at most 100 environment variables.
             cpu (float | None): Number of CPU cores per function. Allowed range and default value are given by the `limits endpoint. <https://developer.cognite.com/api#tag/Functions/operation/functionsLimits>`_, and None translates to the API default. On Azure, only the default value is used.
             memory (float | None): Memory per function measured in GB. Allowed range and default value are given by the `limits endpoint. <https://developer.cognite.com/api#tag/Functions/operation/functionsLimits>`_, and None translates to the API default. On Azure, only the default value is used.
-            runtime (RunTime | None): The function runtime. Valid values are ["py39", "py310", "py311", "py312", `None`], and `None` translates to the API default which will change over time. The runtime "py312" resolves to the latest version of the Python 3.12 series.
+            runtime (RunTime | None): The function runtime. Valid values are ["py310", "py311", "py312", `None`], and `None` translates to the API default which will change over time. The runtime "py312" resolves to the latest version of the Python 3.12 series.
             metadata (dict[str, str] | None): Metadata for the function as key/value pairs. Key & values can be at most 32, 512 characters long respectively. You can have at the most 16 key-value pairs, with a maximum size of 512 bytes.
             index_url (str | None): Index URL for Python Package Manager to use. Be aware of the intrinsic security implications of using the `index_url` option. `More information can be found on official docs, <https://docs.cognite.com/cdf/functions/#additional-arguments>`_
             extra_index_urls (list[str] | None): Extra Index URLs for Python Package Manager to use. Be aware of the intrinsic security implications of using the `extra_index_urls` option. `More information can be found on official docs, <https://docs.cognite.com/cdf/functions/#additional-arguments>`_

cognite/client/data_classes/functions.py

@@ -23,7 +23,7 @@
 if TYPE_CHECKING:
     from cognite.client import CogniteClient
 
-RunTime: TypeAlias = Literal["py39", "py310", "py311", "py312"]
+RunTime: TypeAlias = Literal["py310", "py311", "py312"]
 FunctionStatus: TypeAlias = Literal["Queued", "Deploying", "Ready", "Failed"]
 HANDLER_FILE_NAME = "handler.py"
 
@@ -90,7 +90,7 @@ class FunctionCore(WriteableCogniteResource["FunctionWrite"], ABC):
         env_vars (dict[str, str] | None): User specified environment variables on the function ((key, value) pairs).
         cpu (float | None): Number of CPU cores per function. Allowed range and default value are given by the `limits endpoint. <https://developer.cognite.com/api#tag/Functions/operation/functionsLimits>`_, and None translates to the API default. On Azure, only the default value is used.
         memory (float | None): Memory per function measured in GB. Allowed range and default value are given by the `limits endpoint. <https://developer.cognite.com/api#tag/Functions/operation/functionsLimits>`_, and None translates to the API default. On Azure, only the default value is used.
-        runtime (str | None): Runtime of the function. Allowed values are ["py39","py310", "py311", "py312"]. The runtime "py312" resolves to the latest version of the Python 3.12 series.
+        runtime (RunTime | None): Runtime of the function. Allowed values are ["py310", "py311", "py312"]. The runtime "py312" resolves to the latest version of the Python 3.12 series.
         metadata (dict[str, str] | None): Metadata associated with a function as a set of key:value pairs.
     """
 
@@ -106,7 +106,7 @@ def __init__(
         env_vars: dict[str, str] | None = None,
         cpu: float | None = None,
         memory: float | None = None,
-        runtime: str | None = None,
+        runtime: RunTime | None = None,
         metadata: dict[str, str] | None = None,
     ) -> None:
         # name/file_id are required when using the class to read,
@@ -124,7 +124,7 @@ def __init__(
         self.env_vars = env_vars
         self.cpu = cpu
         self.memory = memory
-        self.runtime = runtime
+        self.runtime: RunTime | None = runtime
         self.metadata = metadata
 
 
@@ -146,7 +146,7 @@ class Function(FunctionCore):
         env_vars (dict[str, str] | None): User specified environment variables on the function ((key, value) pairs).
         cpu (float | None): Number of CPU cores per function. Allowed range and default value are given by the `limits endpoint. <https://developer.cognite.com/api#tag/Functions/operation/functionsLimits>`_, and None translates to the API default. On Azure, only the default value is used.
         memory (float | None): Memory per function measured in GB. Allowed range and default value are given by the `limits endpoint. <https://developer.cognite.com/api#tag/Functions/operation/functionsLimits>`_, and None translates to the API default. On Azure, only the default value is used.
-        runtime (str | None): Runtime of the function. Allowed values are ["py39","py310", "py311", "py312"]. The runtime "py312" resolves to the latest version of the Python 3.12 series.
+        runtime (RunTime | None): Runtime of the function. Allowed values are ["py310", "py311", "py312"]. The runtime "py312" resolves to the latest version of the Python 3.12 series.
         runtime_version (str | None): The complete specification of the function runtime with major, minor and patch version numbers.
         metadata (dict[str, str] | None): Metadata associated with a function as a set of key:value pairs.
         error (dict | None): Dictionary with keys "message" and "trace", which is populated if deployment fails.
@@ -168,7 +168,7 @@ def __init__(
         env_vars: dict[str, str] | None = None,
         cpu: float | None = None,
         memory: float | None = None,
-        runtime: str | None = None,
+        runtime: RunTime | None = None,
         runtime_version: str | None = None,
         metadata: dict[str, str] | None = None,
         error: dict | None = None,
@@ -196,7 +196,7 @@ def __init__(
         self.id: int = id  # type: ignore
         self.created_time: int = created_time  # type: ignore
         self.status: str = status  # type: ignore
-        self.runtime_version = runtime_version
+        self.runtime_version: str | None = runtime_version
         self.error = error
         self._cognite_client = cast("CogniteClient", cognite_client)
 
@@ -215,7 +215,7 @@ def as_write(self) -> FunctionWrite:
             env_vars=self.env_vars,
             cpu=self.cpu,
             memory=self.memory,
-            runtime=cast(RunTime, self.runtime),
+            runtime=self.runtime,
             metadata=self.metadata,
         )
 
@@ -310,7 +310,7 @@ class FunctionWrite(FunctionCore):
         env_vars (dict[str, str] | None): User specified environment variables on the function ((key, value) pairs).
         cpu (float | None): Number of CPU cores per function. Allowed range and default value are given by the `limits endpoint. <https://developer.cognite.com/api#tag/Functions/operation/functionsLimits>`_, and None translates to the API default. On Azure, only the default value is used.
         memory (float | None): Memory per function measured in GB. Allowed range and default value are given by the `limits endpoint. <https://developer.cognite.com/api#tag/Functions/operation/functionsLimits>`_, and None translates to the API default. On Azure, only the default value is used.
-        runtime (RunTime | None): Runtime of the function. Allowed values are ["py39","py310", "py311", "py312"]. The runtime "py312" resolves to the latest version of the Python 3.12 series.
+        runtime (RunTime | None): Runtime of the function. Allowed values are ["py310", "py311", "py312"]. The runtime "py312" resolves to the latest version of the Python 3.12 series.
         metadata (dict[str, str] | None): Metadata associated with a function as a set of key:value pairs.
         index_url (str | None): Specify a different python package index, allowing for packages published in private repositories. Supports basic HTTP authentication as described in pip basic authentication. See the documentation for additional information related to the security risks of using this option.
         extra_index_urls (list[str] | None): Extra package index URLs to use when building the function, allowing for packages published in private repositories. Supports basic HTTP authentication as described in pip basic authentication. See the documentation for additional information related to the security risks of using this option.
@@ -745,7 +745,7 @@ class FunctionsLimits(CogniteResponse):
         timeout_minutes (int): Timeout of each function call.
         cpu_cores (dict[str, float]): The number of CPU cores per function execution (i.e. function call).
         memory_gb (dict[str, float]): The amount of available memory in GB per function execution (i.e. function call).
-        runtimes (list[str]): Available runtimes. For example, "py312" translates to the latest version of the Python 3.12 series.
+        runtimes (list[RunTime]): Available runtimes. For example, "py312" translates to the latest version of the Python 3.12 series.
         response_size_mb (int | None): Maximum response size of function calls.
     """
 
@@ -754,13 +754,13 @@ def __init__(
         timeout_minutes: int,
         cpu_cores: dict[str, float],
         memory_gb: dict[str, float],
-        runtimes: list[str],
+        runtimes: list[RunTime],
         response_size_mb: int | None = None,
     ) -> None:
         self.timeout_minutes = timeout_minutes
         self.cpu_cores = cpu_cores
         self.memory_gb = memory_gb
-        self.runtimes = runtimes
+        self.runtimes: list[RunTime] = runtimes
         self.response_size_mb = response_size_mb
 
     @classmethod

tests/tests_unit/test_api/test_functions.py

@@ -359,7 +359,7 @@ def mock_functions_limit_response(rsps, cognite_client):
         "cpuCores": {"min": 0.1, "max": 0.6, "default": 0.25},
         "memoryGb": {"min": 0.1, "max": 2.5, "default": 1.0},
         "responseSizeMb": 1,
-        "runtimes": ["py39", "py310", "py311"],
+        "runtimes": ["py310", "py311", "py312"],
     }
     url = full_url(cognite_client, "/functions/limits")
     rsps.add(rsps.GET, url, status=200, json=response_body)