modAL 1.6.3.dev5__tar.gz → 1.6.3.dev7__tar.gz

{modal-1.6.3.dev5 → modal-1.6.3.dev7}/PKG-INFO

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

{modal-1.6.3.dev5 → modal-1.6.3.dev7}/modal/_image.py

@@ -57,7 +57,7 @@ from .exception import (
     VersionError,
 )
 from .file_pattern_matcher import NON_PYTHON_FILES, FilePatternMatcher, _ignore_fn
-from .mount import _Mount, python_standalone_mount_name
+from .mount import PYTHON_STANDALONE_VERSIONS, _Mount, python_standalone_mount_name
 from .network_file_system import _NetworkFileSystem
 from .output import OutputManager
 from .secret import _Secret
@@ -70,6 +70,7 @@ if typing.TYPE_CHECKING:
 
 # This is used for both type checking and runtime validation
 ImageBuilderVersion = Literal["2023.12", "2024.04", "2024.10", "2025.06", "PREVIEW"]
+LATEST_IMAGE_BUILDER_VERSION: ImageBuilderVersion = "2025.06"
 
 # Note: we also define supported Python versions via logic at the top of the package __init__.py
 # so that we fail fast / clearly in unsupported containers. Additionally, we enumerate the supported
@@ -402,7 +403,7 @@ def _create_context_mount_function(
 
     if ignore is AUTO_DOCKERIGNORE:
 
-        def auto_created_context_mount_fn() -> _Mount | None:
+        def auto_created_context_mount_fn(builder_version: ImageBuilderVersion) -> _Mount | None:
             nonlocal context_dir
             context_dir = Path.cwd() if context_dir is None else Path(context_dir).absolute()
             dockerignore_file = find_dockerignore_file(context_dir, dockerfile_path)
@@ -419,7 +420,7 @@ def _create_context_mount_function(
 
     else:
 
-        def auto_created_context_mount_fn() -> _Mount | None:
+        def auto_created_context_mount_fn(builder_version: ImageBuilderVersion) -> _Mount | None:
             # use COPY commands and ignore patterns to construct implicit context mount
             nonlocal context_dir
             context_dir = Path.cwd() if context_dir is None else Path(context_dir).absolute()
@@ -622,7 +623,7 @@ class _Image(_Object, type_prefix="im"):
         build_function: "modal._functions._Function | None" = None,
         build_function_input: api_pb2.FunctionInput | None = None,
         image_registry_config: _ImageRegistryConfig | None = None,
-        context_mount_function: Callable[[], _Mount | None] | None = None,
+        context_mount_function: Callable[[ImageBuilderVersion], _Mount | None] | None = None,
         force_build: bool = False,
         build_args: dict[str, str] = {},
         validated_volumes: Sequence[tuple[str, _Volume]] | None = None,
@@ -661,7 +662,13 @@ class _Image(_Object, type_prefix="im"):
             return deps
 
         async def _load(self: _Image, resolver: Resolver, load_context: LoadContext, existing_object_id: str | None):
-            context_mount = context_mount_function() if context_mount_function else None
+            assert load_context.app_id  # type narrowing
+            environment = await _get_environment_cached(load_context.environment_name or "", load_context.client)
+            # A bit hacky,but assume that the environment provides a valid builder version
+            image_builder_version = cast(ImageBuilderVersion, environment._settings.image_builder_version)
+            builder_version = _get_image_builder_version(image_builder_version)
+
+            context_mount = context_mount_function(builder_version) if context_mount_function else None
             if context_mount:
                 await resolver.load(context_mount, load_context)
 
@@ -670,12 +677,6 @@ class _Image(_Object, type_prefix="im"):
                     # base images can't have
                     image._assert_no_mount_layers()
 
-            assert load_context.app_id  # type narrowing
-            environment = await _get_environment_cached(load_context.environment_name or "", load_context.client)
-            # A bit hacky,but assume that the environment provides a valid builder version
-            image_builder_version = cast(ImageBuilderVersion, environment._settings.image_builder_version)
-            builder_version = _get_image_builder_version(image_builder_version)
-
             if dockerfile_function is None:
                 dockerfile = DockerfileSpec(commands=[], context_files={})
             else:
@@ -847,7 +848,7 @@ class _Image(_Object, type_prefix="im"):
         return _Image._from_args(
             base_images={"base": self},
             dockerfile_function=build_dockerfile,
-            context_mount_function=lambda: mount,
+            context_mount_function=lambda builder_version: mount,
         )
 
     @_requires_image_instance
@@ -2191,12 +2192,9 @@ class _Image(_Object, type_prefix="im"):
                 "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.)
+            release, _ = PYTHON_STANDALONE_VERSIONS[builder_version][add_python]
+            if release < "20241008":
+                # Older standalone releases do not include the `python` binary.
                 # We insert the command in the list at the position it was previously always added
                 # for backwards compatibility with existing images.
                 add_python_commands.insert(1, "RUN ln -s /usr/local/bin/python3 /usr/local/bin/python")
@@ -2271,10 +2269,10 @@ class _Image(_Object, type_prefix="im"):
             ```
         """
 
-        def context_mount_function() -> _Mount | None:
+        def context_mount_function(builder_version: ImageBuilderVersion) -> _Mount | None:
             return (
                 _Mount.from_name(
-                    python_standalone_mount_name(add_python),
+                    python_standalone_mount_name(add_python, builder_version),
                     namespace=api_pb2.DEPLOYMENT_NAMESPACE_GLOBAL,
                 )
                 if add_python
@@ -2516,16 +2514,17 @@ class _Image(_Object, type_prefix="im"):
             gpu_config=gpu_config,
             secrets=secrets,
             build_args=build_args,
+            force_build=force_build,
         )
 
         # --- Now add in the modal dependencies, and, optionally a Python distribution
         # This happening in two steps is probably a vestigial consequence of previous limitations,
         # but it will be difficult to merge them without forcing rebuilds of images.
 
-        def add_python_mount():
+        def add_python_mount(builder_version: ImageBuilderVersion) -> _Mount | None:
             return (
                 _Mount.from_name(
-                    python_standalone_mount_name(add_python),
+                    python_standalone_mount_name(add_python, builder_version),
                     namespace=api_pb2.DEPLOYMENT_NAMESPACE_GLOBAL,
                 )
                 if add_python

{modal-1.6.3.dev5 → modal-1.6.3.dev7}/modal/_utils/grpc_testing.py

@@ -116,7 +116,7 @@ class InterceptionContext:
         """Adds one response payload to an expected queue of responses for a method.
 
         These responses will be used once each instead of calling the MockServicer's
-        implementation of the method.
+        implementation of the method. An exception payload is raised instead of being sent.
 
         The interception context will throw an exception on exit if not all of the added
         responses have been consumed.
@@ -184,6 +184,8 @@ class InterceptionContext:
         async def responder(servicer_self, stream):
             await stream.recv_message()  # get the input message so we can track that
             for msg in next_response_messages:
+                if isinstance(msg, Exception):
+                    raise msg
                 await stream.send_message(msg)
 
         return responder

modal-1.6.3.dev7/modal/builder/PREVIEW.txt

@@ -0,0 +1,18 @@
+aiohappyeyeballs==2.7.1
+aiohttp==3.14.5
+aiosignal==1.4.0
+async-timeout==5.0.1 ; python_version < "3.11"
+attrs==26.1.0
+cbor2==5.9.0
+certifi==2026.10.19
+frozenlist==1.8.0
+grpclib==0.4.9
+h2==4.4.1
+hpack==4.2.0
+hyperframe==6.1.0
+idna==3.20
+multidict==7.1.0
+propcache==0.5.4
+protobuf==7.36.2
+typing_extensions==4.16.0
+yarl==1.25.1

{modal-1.6.3.dev5 → modal-1.6.3.dev7}/modal/client.pyi

@@ -80,7 +80,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.6.3.dev5",
+        version: str = "1.6.3.dev7",
         *,
         oauth_credentials: typing.Optional[_OAuthCredentials] = None,
     ):
@@ -290,7 +290,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.6.3.dev5",
+        version: str = "1.6.3.dev7",
         *,
         oauth_credentials: typing.Optional[_OAuthCredentials] = None,
     ):

{modal-1.6.3.dev5 → modal-1.6.3.dev7}/modal/image.pyi

@@ -74,7 +74,10 @@ class Image(modal.object.Object):
         build_function_input: typing.Optional[modal_proto.api_pb2.FunctionInput] = None,
         image_registry_config: typing.Optional[modal._image._ImageRegistryConfig] = None,
         context_mount_function: typing.Optional[
-            collections.abc.Callable[[], typing.Optional[modal.mount.Mount]]
+            collections.abc.Callable[
+                [typing.Literal["2023.12", "2024.04", "2024.10", "2025.06", "PREVIEW"]],
+                typing.Optional[modal.mount.Mount],
+            ]
         ] = None,
         force_build: bool = False,
         build_args: dict[str, str] = {},

{modal-1.6.3.dev5 → modal-1.6.3.dev7}/modal/mount.py

@@ -39,11 +39,11 @@ from .file_pattern_matcher import FilePatternMatcher
 ROOT_DIR: PurePosixPath = PurePosixPath("/root")
 MOUNT_PUT_FILE_CLIENT_TIMEOUT = 10 * 60  # 10 min max for transferring files
 
-# Supported releases and versions for python-build-standalone.
+# Supported releases and versions for python-build-standalone, keyed by image builder version.
 #
-# These can be updated safely, but changes will trigger a rebuild for all images
-# that rely on `add_python()` in their constructor.
-PYTHON_STANDALONE_VERSIONS: dict[str, tuple[str, str]] = {
+# Changing the versions for a builder version triggers a rebuild for all images on that builder
+# version that rely on `add_python()` in their constructor, so only "PREVIEW" should be updated.
+_PYTHON_STANDALONE_VERSIONS_2025_06: dict[str, tuple[str, str]] = {
     "3.10": ("20230826", "3.10.13"),
     "3.11": ("20230826", "3.11.5"),
     "3.12": ("20240107", "3.12.1"),
@@ -53,6 +53,22 @@ PYTHON_STANDALONE_VERSIONS: dict[str, tuple[str, str]] = {
     "3.15": ("20261009", "3.15.0"),
     "3.15t": ("20261009", "3.15.0t"),
 }
+PYTHON_STANDALONE_VERSIONS: dict[str, dict[str, tuple[str, str]]] = {
+    "PREVIEW": {
+        "3.10": ("20261009", "3.10.22"),
+        "3.11": ("20261021", "3.11.17"),
+        "3.12": ("20261021", "3.12.15"),
+        "3.13": ("20261021", "3.13.17"),
+        "3.14": ("20261021", "3.14.9"),
+        "3.14t": ("20261021", "3.14.9t"),
+        "3.15": ("20261021", "3.15.1"),
+        "3.15t": ("20261021", "3.15.1t"),
+    },
+    "2025.06": _PYTHON_STANDALONE_VERSIONS_2025_06,
+    "2024.10": _PYTHON_STANDALONE_VERSIONS_2025_06,
+    "2024.04": _PYTHON_STANDALONE_VERSIONS_2025_06,
+    "2023.12": _PYTHON_STANDALONE_VERSIONS_2025_06,
+}
 
 MOUNT_DEPRECATION_MESSAGE_PATTERN = """modal.Mount usage will soon be deprecated.
 
@@ -72,20 +88,20 @@ def client_mount_name() -> str:
     return f"modal-client-mount-{version}"
 
 
-def python_standalone_mount_name(version: str) -> str:
+def python_standalone_mount_name(version: str, builder_version: str) -> str:
     """Get the deployed name of the python-build-standalone mount."""
     if "-" in version:  # default to glibc
         version, libc = version.split("-")
     else:
         libc = "gnu"
-    if version not in PYTHON_STANDALONE_VERSIONS:
+    standalone_versions = PYTHON_STANDALONE_VERSIONS[builder_version]
+    if version not in standalone_versions:
         raise modal.exception.InvalidError(
-            f"Unsupported standalone python version: {version!r}, supported values are "
-            f"{list(PYTHON_STANDALONE_VERSIONS)}"
+            f"Unsupported standalone python version: {version!r}, supported values are {list(standalone_versions)}"
         )
     if libc != "gnu":
         raise modal.exception.InvalidError(f"Unsupported libc identifier: {libc}")
-    release, full_version = PYTHON_STANDALONE_VERSIONS[version]
+    release, full_version = standalone_versions[version]
     return f"python-build-standalone.{release}.{full_version}-{libc}"
 
 
@@ -950,19 +966,25 @@ async def _create_single_client_dependency_mount(
 
 async def _create_client_dependency_mounts(
     client=None,
-    python_versions: list[str] = list(PYTHON_STANDALONE_VERSIONS),
-    builder_versions: list[str] = ["2025.06"],  # Reenable "PREVIEW" during testing
+    python_versions: list[str] | None = None,
+    builder_versions: list[str] | None = None,  # Pass "PREVIEW" during testing
     check_if_exists=True,
     dry_run=False,
 ):
+    from ._image import LATEST_IMAGE_BUILDER_VERSION, SUPPORTED_PYTHON_SERIES
+
     arch = "x86_64"
     platform_tags = [
         ("manylinux_2_17", f"{arch}-manylinux_2_17"),  # glibc >= 2.17
         ("musllinux_1_2", f"{arch}-unknown-linux-musl"),  # musl >= 1.2
     ]
     coros = []
-    for python_version in python_versions:
-        for builder_version in builder_versions:
+    for builder_version in builder_versions or [LATEST_IMAGE_BUILDER_VERSION]:
+        if python_versions is None:
+            builder_python_versions = SUPPORTED_PYTHON_SERIES[builder_version]
+        else:
+            builder_python_versions = python_versions
+        for python_version in builder_python_versions:
             for platform, uv_python_platform in platform_tags:
                 coros.append(
                     _create_single_client_dependency_mount(

{modal-1.6.3.dev5 → modal-1.6.3.dev7}/modal/mount.pyi

@@ -16,7 +16,7 @@ def client_mount_name() -> str:
     """Get the deployed name of the client package mount."""
     ...
 
-def python_standalone_mount_name(version: str) -> str:
+def python_standalone_mount_name(version: str, builder_version: str) -> str:
     """Get the deployed name of the python-build-standalone mount."""
     ...
 
@@ -444,8 +444,8 @@ 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", "3.14t", "3.15", "3.15t"],
-    builder_versions: list[str] = ["2025.06"],
+    python_versions: typing.Optional[list[str]] = None,
+    builder_versions: typing.Optional[list[str]] = None,
     check_if_exists=True,
     dry_run=False,
 ): ...
@@ -455,8 +455,8 @@ 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", "3.14t", "3.15", "3.15t"],
-        builder_versions: list[str] = ["2025.06"],
+        python_versions: typing.Optional[list[str]] = None,
+        builder_versions: typing.Optional[list[str]] = None,
         check_if_exists=True,
         dry_run=False,
     ): ...
@@ -464,8 +464,8 @@ 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", "3.14t", "3.15", "3.15t"],
-        builder_versions: list[str] = ["2025.06"],
+        python_versions: typing.Optional[list[str]] = None,
+        builder_versions: typing.Optional[list[str]] = None,
         check_if_exists=True,
         dry_run=False,
     ): ...
@@ -474,4 +474,6 @@ create_client_dependency_mounts: __create_client_dependency_mounts_spec
 
 ROOT_DIR: pathlib.PurePosixPath
 
-PYTHON_STANDALONE_VERSIONS: dict[str, tuple[str, str]]
+_PYTHON_STANDALONE_VERSIONS_2025_06: dict[str, tuple[str, str]]
+
+PYTHON_STANDALONE_VERSIONS: dict[str, dict[str, tuple[str, str]]]

{modal-1.6.3.dev5 → modal-1.6.3.dev7}/modal/sandbox/_common.py

@@ -386,7 +386,7 @@ class SandboxCreateArgs:
     secrets: Collection[_Secret] | None = None
     env: dict[str, str | None] | None = None
     name: str | None = None
-    timeout: int = 300
+    timeout: int | None = 300
     idle_timeout: int | None = None
     workdir: str | None = None
     gpu: str | None = None
@@ -417,6 +417,7 @@ class SandboxCreateArgs:
     custom_domain: str | None = None
     include_oidc_identity_token: bool = False
     runtime: SandboxRuntime | None = None
+    persistent: bool = False
 
 
 class SandboxCreateCommon:
@@ -428,6 +429,8 @@ class SandboxCreateCommon:
 
     def __init__(self, create_args: SandboxCreateArgs, *, secrets: Sequence[_Secret]) -> None:
         a = create_args
+        if a.timeout is None:
+            raise InvalidError("`timeout=None` is only supported for experimental persistent Sandboxes.")
         _validate_exec_args(a.args)
         if a.name is not None:
             check_object_name(a.name, "Sandbox")
@@ -452,6 +455,7 @@ class SandboxCreateCommon:
             raise InvalidError("`inbound_cidr_allowlist` cannot be used when `block_network` is enabled")
 
         self.create_args = a
+        self.timeout = a.timeout
         self.secrets = secrets
         self.image = a.image or _default_image
         self.network_file_systems = validate_network_file_systems(a.network_file_systems)
@@ -503,7 +507,7 @@ class SandboxCreateCommon:
             secret_ids=[secret.object_id for secret in self.secrets],
             # Ephemeral disk requests are not supported on Sandboxes.
             resources=convert_fn_config_to_resources_config(cpu=a.cpu, memory=a.memory, gpu=a.gpu, ephemeral_disk=None),
-            timeout_secs=a.timeout,
+            timeout_secs=self.timeout,
             idle_timeout_secs=a.idle_timeout,
             workdir=a.workdir,
             cloud_provider_str=a.cloud if a.cloud else None,  # pyright: ignore[reportArgumentType]
@@ -637,6 +641,10 @@ class SandboxImpl(Protocol):
         """
         ...
 
+    def clone(self) -> "SandboxImpl":
+        """Create an implementation of the same type for another handle to the same Sandbox."""
+        ...
+
     @classmethod
     async def lookup_by_name(
         cls, client: _Client, req: api_pb2.SandboxGetFromNameRequest
@@ -674,6 +682,10 @@ class SandboxImpl(Protocol):
 
     async def terminate(self) -> None: ...
 
+    async def pause(self) -> None: ...
+
+    async def resume(self) -> None: ...
+
     async def close(self) -> None:
         """Release connections held for the Sandbox once in-flight operations complete."""
         ...
@@ -907,6 +919,9 @@ async def snapshot_filesystem_via_tcr(
     return _Image._new_hydrated(res.image_id, client, None)
 
 
+_PERSISTENT_ONLY_MESSAGE = "`{}` requires a persistent Sandbox, created with `_experimental_persistent=True`."
+
+
 async def mount_image_via_tcr(
     impl: SandboxImpl,
     path: PurePosixPath | str,