modAL 1.3.1.dev12__py3-none-any.whl → 1.3.1.dev14__py3-none-any.whl

modal/_utils/grpc_utils.py

@@ -92,8 +92,7 @@ class ConnectionManager:
 
     def __init__(self, client: "modal.client._Client", metadata: dict[str, str] = {}):
         self._client = client
-        # Warning: This metadata is shared across all channels! If the metadata is mutated
-        # in one `create_channel` call, the mutation will be reflected in all channels.
+        # This metadata is injected into all requests on all channels created by this manager.
         self._metadata = metadata
         self._channels: dict[str, grpclib.client.Channel] = {}
 
@@ -168,8 +167,7 @@ def create_channel(
 ) -> grpclib.client.Channel:
     """Creates a grpclib.Channel to be used by a GRPC stub.
 
-    Note that this function mutates the given metadata argument by adding an x-modal-auth-token
-    if one is present in the trailing metadata of any response.
+    The given metadata dict is injected into all outgoing requests on this channel.
     """
     o = urllib.parse.urlparse(server_url)
 

modal/client.pyi

@@ -33,7 +33,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.3.1.dev12",
+        version: str = "1.3.1.dev14",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.
@@ -163,7 +163,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.3.1.dev12",
+        version: str = "1.3.1.dev14",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

modal/image.py

@@ -74,8 +74,8 @@ ImageBuilderVersion = Literal["2023.12", "2024.04", "2024.10", "2025.06", "PREVI
 # Python versions in mount.py where we specify the "standalone Python versions" we create mounts for.
 # Consider consolidating these multiple sources of truth?
 SUPPORTED_PYTHON_SERIES: dict[ImageBuilderVersion, list[str]] = {
-    "PREVIEW": ["3.10", "3.11", "3.12", "3.13", "3.14"],
-    "2025.06": ["3.10", "3.11", "3.12", "3.13", "3.14"],
+    "PREVIEW": ["3.10", "3.11", "3.12", "3.13", "3.14", "3.14t"],
+    "2025.06": ["3.10", "3.11", "3.12", "3.13", "3.14", "3.14t"],
     "2024.10": ["3.10", "3.11", "3.12", "3.13"],
     "2024.04": ["3.10", "3.11", "3.12"],
     "2023.12": ["3.10", "3.11", "3.12"],
@@ -104,15 +104,22 @@ See https://modal.com/docs/guide/modal-1-0-migration for more details.
 
 
 def _validate_python_version(
-    python_version: Optional[str], builder_version: ImageBuilderVersion, allow_micro_granularity: bool = True
+    python_version: Optional[str],
+    builder_version: ImageBuilderVersion,
+    allow_micro_granularity: bool = True,
+    allow_free_threading: bool = False,
+    caller_name: str = "",
 ) -> str:
     if python_version is None:
         # If Python version is unspecified, match the local version, up to the minor component
         python_version = series_version = "{}.{}".format(*sys.version_info)
     elif not isinstance(python_version, str):
         raise InvalidError(f"Python version must be specified as a string, not {type(python_version).__name__}")
-    elif not re.match(r"^3(?:\.\d{1,2}){1,2}(rc\d*)?$", python_version):
+    elif not re.match(r"^3(?:\.\d{1,2}){1,2}(rc\d*)?t?$", python_version):
         raise InvalidError(f"Invalid Python version: {python_version!r}")
+    elif not allow_free_threading and python_version.endswith("t"):
+        context = f"with {caller_name}" if caller_name else ""
+        raise InvalidError(f"Free threaded Python is not supported {context}")
     else:
         components = python_version.split(".")
         if len(components) == 3 and not allow_micro_granularity:
@@ -120,7 +127,8 @@ def _validate_python_version(
                 "Python version must be specified as 'major.minor' for this interface;"
                 f" micro-level specification ({python_version!r}) is not valid."
             )
-        series_version = "{}.{}".format(*components)
+        suffix = "t" if len(components) == 3 and python_version.endswith("t") else ""
+        series_version = f"{components[0]}.{components[1]}{suffix}"
 
     supported_series = SUPPORTED_PYTHON_SERIES[builder_version]
     if series_version not in supported_series:
@@ -132,8 +140,15 @@ def _validate_python_version(
     return python_version
 
 
-def _dockerhub_python_version(builder_version: ImageBuilderVersion, python_version: Optional[str] = None) -> str:
-    python_version = _validate_python_version(python_version, builder_version)
+def _dockerhub_python_version(
+    builder_version: ImageBuilderVersion,
+    python_version: Optional[str] = None,
+    allow_free_threading: bool = False,
+    caller_name: str = "",
+) -> str:
+    python_version = _validate_python_version(
+        python_version, builder_version, allow_free_threading=allow_free_threading, caller_name=caller_name
+    )
     version_components = python_version.split(".")
 
     # When user specifies a full Python version, use that
@@ -1753,7 +1768,9 @@ class _Image(_Object, type_prefix="im"):
         """A Micromamba base image. Micromamba allows for fast building of small Conda-based containers."""
 
         def build_dockerfile(version: ImageBuilderVersion) -> DockerfileSpec:
-            validated_python_version = _validate_python_version(python_version, version)
+            validated_python_version = _validate_python_version(
+                python_version, version, allow_free_threading=False, caller_name="Image.micromamba"
+            )
             micromamba_version = _base_image_config("micromamba", version)
             tag = f"mambaorg/micromamba:{micromamba_version}"
             setup_commands = [
@@ -1833,12 +1850,16 @@ class _Image(_Object, type_prefix="im"):
     ) -> list[str]:
         add_python_commands: list[str] = []
         if add_python:
-            _validate_python_version(add_python, builder_version, allow_micro_granularity=False)
+            _validate_python_version(
+                add_python, builder_version, allow_micro_granularity=False, allow_free_threading=True
+            )
             add_python_commands = [
                 "COPY /python/. /usr/local",
                 "ENV TERMINFO_DIRS=/etc/terminfo:/lib/terminfo:/usr/share/terminfo:/usr/lib/terminfo",
             ]
             python_minor = add_python.split(".")[1]
+            if python_minor.endswith("t"):
+                python_minor = python_minor[:-1]
             if int(python_minor) < 13:
                 # Previous versions did not include the `python` binary, but later ones do.
                 # (The important factor is not the Python version itself, but the standalone dist version.)
@@ -2160,7 +2181,9 @@ class _Image(_Object, type_prefix="im"):
             if version <= "2024.10":
                 requirements_path = _get_modal_requirements_path(version, python_version)
                 context_files = {CONTAINER_REQUIREMENTS_PATH: requirements_path}
-            full_python_version = _dockerhub_python_version(version, python_version)
+            full_python_version = _dockerhub_python_version(
+                version, python_version, allow_free_threading=False, caller_name="Image.debian_slim"
+            )
             debian_codename = _base_image_config("debian", version)
 
             commands = [

modal/image.pyi

@@ -34,10 +34,14 @@ def _validate_python_version(
     python_version: typing.Optional[str],
     builder_version: typing.Literal["2023.12", "2024.04", "2024.10", "2025.06", "PREVIEW"],
     allow_micro_granularity: bool = True,
+    allow_free_threading: bool = False,
+    caller_name: str = "",
 ) -> str: ...
 def _dockerhub_python_version(
     builder_version: typing.Literal["2023.12", "2024.04", "2024.10", "2025.06", "PREVIEW"],
     python_version: typing.Optional[str] = None,
+    allow_free_threading: bool = False,
+    caller_name: str = "",
 ) -> str: ...
 def _base_image_config(
     group: str, builder_version: typing.Literal["2023.12", "2024.04", "2024.10", "2025.06", "PREVIEW"]

modal/mount.py

@@ -23,7 +23,11 @@ from ._load_context import LoadContext
 from ._object import _Object
 from ._resolver import Resolver
 from ._utils.async_utils import TaskContext, aclosing, async_map, synchronize_api
-from ._utils.blob_utils import FileUploadSpec, blob_upload_file, get_file_upload_spec_from_path
+from ._utils.blob_utils import (
+    FileUploadSpec,
+    blob_upload_file,
+    get_file_upload_spec_from_path,
+)
 from ._utils.grpc_utils import Retry
 from ._utils.name_utils import check_object_name
 from ._utils.package_utils import get_module_mount_info
@@ -45,6 +49,7 @@ PYTHON_STANDALONE_VERSIONS: dict[str, tuple[str, str]] = {
     "3.12": ("20240107", "3.12.1"),
     "3.13": ("20241008", "3.13.0"),
     "3.14": ("20251205", "3.14.2"),
+    "3.14t": ("20251209", "3.14.2t"),
 }
 
 MOUNT_DEPRECATION_MESSAGE_PATTERN = """modal.Mount usage will soon be deprecated.
@@ -797,7 +802,7 @@ async def _create_single_client_dependency_mount(
                 tmpd,
                 "--python-platform",
                 uv_python_platform,
-                "--python-version",
+                "--python",
                 python_version,
             ]
         )

modal/mount.pyi

@@ -426,7 +426,7 @@ async def _create_single_client_dependency_mount(
 ): ...
 async def _create_client_dependency_mounts(
     client=None,
-    python_versions: list[str] = ["3.10", "3.11", "3.12", "3.13", "3.14"],
+    python_versions: list[str] = ["3.10", "3.11", "3.12", "3.13", "3.14", "3.14t"],
     builder_versions: list[str] = ["2025.06"],
     check_if_exists=True,
     dry_run=False,
@@ -437,7 +437,7 @@ class __create_client_dependency_mounts_spec(typing_extensions.Protocol):
         self,
         /,
         client=None,
-        python_versions: list[str] = ["3.10", "3.11", "3.12", "3.13", "3.14"],
+        python_versions: list[str] = ["3.10", "3.11", "3.12", "3.13", "3.14", "3.14t"],
         builder_versions: list[str] = ["2025.06"],
         check_if_exists=True,
         dry_run=False,
@@ -446,7 +446,7 @@ class __create_client_dependency_mounts_spec(typing_extensions.Protocol):
         self,
         /,
         client=None,
-        python_versions: list[str] = ["3.10", "3.11", "3.12", "3.13", "3.14"],
+        python_versions: list[str] = ["3.10", "3.11", "3.12", "3.13", "3.14", "3.14t"],
         builder_versions: list[str] = ["2025.06"],
         check_if_exists=True,
         dry_run=False,

{modal-1.3.1.dev12.dist-info → modal-1.3.1.dev14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.3.1.dev12
+Version: 1.3.1.dev14
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License: Apache-2.0

{modal-1.3.1.dev12.dist-info → modal-1.3.1.dev14.dist-info}/RECORD

@@ -26,7 +26,7 @@ modal/app.pyi,sha256=WR0nGSUh8-8OYRHFqEnijGoPp_IbawNY1JW_0pozXsE,50857
 modal/billing.py,sha256=zmQ3bcCJlwa4KD1IA_QgdWpm1pn13c-7qfy79iEauYI,195
 modal/call_graph.py,sha256=1g2DGcMIJvRy-xKicuf63IVE98gJSnQsr8R_NVMptNc,2581
 modal/client.py,sha256=CXnyJYLhY--xaCkjv3tpjYDca8AuXGQG1IiaXQVX4y4,14436
-modal/client.pyi,sha256=18zSEWajEhEpaTNF1oSeELgXY9sTCoeDRv2bLLlNGPM,14473
+modal/client.pyi,sha256=UeAqC6dYlTsxTXkl7RWvxcHUwTH00jWqtb2Xv7bpJzI,14473
 modal/cloud_bucket_mount.py,sha256=cvVj5Rt4nDHoQbTneoJPTaAcnl_Ab_mrsjnnzd0v9OI,6013
 modal/cloud_bucket_mount.pyi,sha256=vXusGMOUk9HjCs4lhxteuCK4xLQclPfugGWKo7LECEA,7539
 modal/cls.py,sha256=DNXcOrd9l2DoX-nLGdpwXm-N9V0BbQEvWA7d2UwFf44,41510
@@ -45,12 +45,12 @@ modal/file_pattern_matcher.py,sha256=A_Kdkej6q7YQyhM_2-BvpFmPqJ0oHb54B6yf9VqvPVE
 modal/functions.py,sha256=kcNHvqeGBxPI7Cgd57NIBBghkfbeFJzXO44WW0jSmao,325
 modal/functions.pyi,sha256=fkjxeYAqh6sX9C84gjUGoLVgHT1IfNB_07h0fpmIyWw,36465
 modal/gpu.py,sha256=Fe5ORvVPDIstSq1xjmM6OoNgLYFWvogP9r5BgmD3hYg,6769
-modal/image.py,sha256=sPaYxx4Dwdod1FjVooDaDDcPbcyyBXY4ChpbQvWe5mc,108197
-modal/image.pyi,sha256=UMwAaYu4feSDzJS9l-5xKYP_yaJm18bY_s3pREOQF6A,78249
+modal/image.py,sha256=HKPUQwdXCwuP7d_KZyEYXMVvtyIQH1_H3_BslQEk6ck,109094
+modal/image.pyi,sha256=x8a6gohK9XD35z8MejOmKHauOnI7JwbQcZhp3bVfB5I,78383
 modal/io_streams.py,sha256=g6H6QAl48qZtN5OY6WIIVwF9TXBj3jMNYCgn7RYYrVg,30697
 modal/io_streams.pyi,sha256=aBxCcbHTprL08FLvPlkzu4bypCTT7xUdelNe5kc7OZY,18506
-modal/mount.py,sha256=5ps0p8dik2McxetRfHakLouzOvBrQPYBFCUCrgNlXik,33856
-modal/mount.pyi,sha256=ISBxzudOyLvw5r2LtzYm6Bh_wMUHrVAans8-u33k8cY,15721
+modal/mount.py,sha256=cw5Goi3rLIUHlRESSMj60TYYO9dyskUGMbXjcCBbgq8,33903
+modal/mount.pyi,sha256=HVNPL8po23Hulaj7Kdl5goakZbirN0ADv2nkLc8Hpn4,15748
 modal/network_file_system.py,sha256=23GUYz2DZ5kCzlUrdWBq1siBse6fP_CeGt2Lo9xHkR8,13598
 modal/network_file_system.pyi,sha256=oRQzPxSF3ZmY8BDtBFU3CCyGwPLl5jkobtN6ekexLog,16161
 modal/object.py,sha256=bTeskuY8JFrESjU4_UL_nTwYlBQdOLmVaOX3X6EMxsg,164
@@ -105,7 +105,7 @@ modal/_utils/docker_utils.py,sha256=h1uETghR40mp_y3fSWuZAfbIASH1HMzuphJHghAL6DU,
 modal/_utils/function_utils.py,sha256=uoOcn_pyl6fOVHr_Q6ci1_5eJqo90so7G9izfs-T-As,28272
 modal/_utils/git_utils.py,sha256=qtUU6JAttF55ZxYq51y55OR58B0tDPZsZWK5dJe6W5g,3182
 modal/_utils/grpc_testing.py,sha256=fZLyfMA5VYmIo-dUCcKQrVCH3ZKPT7K4_6ww373jt0Y,8697
-modal/_utils/grpc_utils.py,sha256=8KxNd8M8ziVTc-FB2mkmesBG9hscJScjjL0VIUB4T8k,16270
+modal/_utils/grpc_utils.py,sha256=1imvFLM9jx2QyHGld0exIQL-LxGYNsMwlTZBblqeVPM,16110
 modal/_utils/hash_utils.py,sha256=zg3J6OGxTFGSFri1qQ12giDz90lWk8bzaxCTUCRtiX4,3034
 modal/_utils/http_utils.py,sha256=yeTFsXYr0rYMEhB7vBP7audG9Uc7OLhzKBANFDZWVt0,2451
 modal/_utils/jwt_utils.py,sha256=fxH9plyrbAemTbjSsQtzIdDXE9QXxvMC4DiUZ16G0aA,1360
@@ -158,7 +158,7 @@ modal/experimental/__init__.py,sha256=GOuo3t4-Le0ZVddiHIOw0MQxkdTJge-bVbhDvgnblm
 modal/experimental/flash.py,sha256=GJZwSr-4OHlP6gCIZdcbsSb8D8WX9xJwMphjwcfsRoU,31262
 modal/experimental/flash.pyi,sha256=W62a0AhmLUuH9a0n8Y3-DYhyEEFH3-bRUQFphOQfKHg,16418
 modal/experimental/ipython.py,sha256=TrCfmol9LGsRZMeDoeMPx3Hv3BFqQhYnmD_iH0pqdhk,2904
-modal-1.3.1.dev12.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.3.1.dev14.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
 modal_docs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal_docs/gen_cli_docs.py,sha256=c1yfBS_x--gL5bs0N4ihMwqwX8l3IBWSkBAKNNIi6bQ,3801
 modal_docs/gen_reference_docs.py,sha256=d_CQUGQ0rfw28u75I2mov9AlS773z9rG40-yq5o7g2U,6359
@@ -180,10 +180,10 @@ modal_proto/task_command_router_pb2.py,sha256=2Y8wRvnq4_7RiQ-5ZAPIgXaxrHv_MXzgS5
 modal_proto/task_command_router_pb2.pyi,sha256=yI4tFteErLlonFA2HyaWtONfhY_VGSe7KCWFIspvmkE,16323
 modal_proto/task_command_router_pb2_grpc.py,sha256=q2VWfK2-4uDcPaPLhAqPZkgxhuQRYnWmwUcnEbPbGuk,13895
 modal_proto/task_command_router_pb2_grpc.pyi,sha256=e1MM10VGUgDkm041v53QeTglGQPzTpA0FUsFtezjp74,4536
-modal_version/__init__.py,sha256=p7Kr6XTekZbafGsmwVCctfFFERuDp3kC2yy1OupdiMQ,121
+modal_version/__init__.py,sha256=v_VLCokNOucn6yuP8lDIQDFS91B5blQUVMFdqW8Mw0I,121
 modal_version/__main__.py,sha256=nLUbubxKx7GXNzJIkTB7M7_u8080LyLM0IS0rzFkC_c,119
-modal-1.3.1.dev12.dist-info/METADATA,sha256=uyQENlqNQddQ3Iq0c4B7WuLAqla8v_vdlrOiptChEVA,2582
-modal-1.3.1.dev12.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-modal-1.3.1.dev12.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.3.1.dev12.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.3.1.dev12.dist-info/RECORD,,
+modal-1.3.1.dev14.dist-info/METADATA,sha256=c_Gv4po5uosH8YHYd_Q0rm6pbiMtrOe7LQZJTfZBBbE,2582
+modal-1.3.1.dev14.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+modal-1.3.1.dev14.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.3.1.dev14.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.3.1.dev14.dist-info/RECORD,,

modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2025
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.3.1.dev12"
+__version__ = "1.3.1.dev14"