modal 1.4.2.dev8__tar.gz → 1.4.2.dev9__tar.gz

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/PKG-INFO

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

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/modal/_utils/task_command_router_client.py

@@ -617,6 +617,12 @@ class TaskCommandRouterClient:
                 lambda: self._call_with_auth_retry(self._stub.TaskMountDirectory, request)
             )
 
+    async def unmount_image(self, request: sr_pb2.TaskUnmountDirectoryRequest):
+        with grpc_error_converter():
+            return await call_with_retries_on_transient_errors(
+                lambda: self._call_with_auth_retry(self._stub.TaskUnmountDirectory, request)
+            )
+
     async def snapshot_directory(
         self, request: sr_pb2.TaskSnapshotDirectoryRequest
     ) -> sr_pb2.TaskSnapshotDirectoryResponse:

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/modal/client.py

@@ -239,6 +239,10 @@ class _Client:
         """
         Constructor based on token credentials; useful for managing Modal on behalf of third-party users.
 
+        Also useful when it's necessary to explicitly manage the lifecycle of the client
+        (e.g. when running Modal in a forked subprocess) — see
+        [troubleshooting](/docs/guide/troubleshooting#connection-issues-in-forked-processes).
+
         **Usage:**
 
         ```python notest
@@ -309,6 +313,9 @@ class _Client:
             return await coro
 
     async def _reset_on_pid_change(self):
+        # Best-effort recovery after os.fork(). The client singleton may be inherited
+        # from the parent with stale gRPC state. For reliable post-fork usage, create
+        # a fresh client via Client.from_credentials() instead of relying on this.
         if self._owner_pid and self._owner_pid != os.getpid():
             # not calling .close() since that would also interact with stale resources
             # just reset the internal state

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/modal/client.pyi

@@ -35,7 +35,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.4.2.dev8",
+        version: str = "1.4.2.dev9",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.
@@ -97,6 +97,10 @@ class _Client:
     async def from_credentials(cls, token_id: str, token_secret: str) -> _Client:
         """Constructor based on token credentials; useful for managing Modal on behalf of third-party users.
 
+        Also useful when it's necessary to explicitly manage the lifecycle of the client
+        (e.g. when running Modal in a forked subprocess) — see
+        [troubleshooting](/docs/guide/troubleshooting#connection-issues-in-forked-processes).
+
         **Usage:**
 
         ```python notest
@@ -171,7 +175,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.4.2.dev8",
+        version: str = "1.4.2.dev9",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.
@@ -283,6 +287,10 @@ class Client:
         def __call__(self, /, token_id: str, token_secret: str) -> Client:
             """Constructor based on token credentials; useful for managing Modal on behalf of third-party users.
 
+            Also useful when it's necessary to explicitly manage the lifecycle of the client
+            (e.g. when running Modal in a forked subprocess) — see
+            [troubleshooting](/docs/guide/troubleshooting#connection-issues-in-forked-processes).
+
             **Usage:**
 
             ```python notest
@@ -296,6 +304,10 @@ class Client:
         async def aio(self, /, token_id: str, token_secret: str) -> Client:
             """Constructor based on token credentials; useful for managing Modal on behalf of third-party users.
 
+            Also useful when it's necessary to explicitly manage the lifecycle of the client
+            (e.g. when running Modal in a forked subprocess) — see
+            [troubleshooting](/docs/guide/troubleshooting#connection-issues-in-forked-processes).
+
             **Usage:**
 
             ```python notest

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/modal/functions.pyi

@@ -348,7 +348,7 @@ class Function(
 
     _call_generator: ___call_generator_spec
 
-    class __remote_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
+    class __remote_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> ReturnType_INNER:
             """Calls the function remotely, executing it with the given arguments and returning the execution's result."""
             ...
@@ -357,7 +357,7 @@ class Function(
             """Calls the function remotely, executing it with the given arguments and returning the execution's result."""
             ...
 
-    remote: __remote_spec[modal._functions.ReturnType, modal._functions.P]
+    remote: __remote_spec[modal._functions.P, modal._functions.ReturnType]
 
     class __remote_gen_spec(typing_extensions.Protocol):
         def __call__(self, /, *args, **kwargs) -> typing.Generator[typing.Any, None, None]:
@@ -384,7 +384,7 @@ class Function(
         """
         ...
 
-    class ___experimental_spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
+    class ___experimental_spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> FunctionCall[ReturnType_INNER]:
             """[Experimental] Calls the function with the given arguments, without waiting for the results.
 
@@ -407,7 +407,7 @@ class Function(
             """
             ...
 
-    _experimental_spawn: ___experimental_spawn_spec[modal._functions.ReturnType, modal._functions.P]
+    _experimental_spawn: ___experimental_spawn_spec[modal._functions.P, modal._functions.ReturnType]
 
     class ___spawn_map_inner_spec(typing_extensions.Protocol[P_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> None: ...
@@ -415,7 +415,7 @@ class Function(
 
     _spawn_map_inner: ___spawn_map_inner_spec[modal._functions.P]
 
-    class __spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
+    class __spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> FunctionCall[ReturnType_INNER]:
             """Calls the function with the given arguments, without waiting for the results.
 
@@ -436,7 +436,7 @@ class Function(
             """
             ...
 
-    spawn: __spawn_spec[modal._functions.ReturnType, modal._functions.P]
+    spawn: __spawn_spec[modal._functions.P, modal._functions.ReturnType]
 
     def get_raw_f(self) -> collections.abc.Callable[..., typing.Any]:
         """Return the inner Python object wrapped by this Modal Function."""

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/modal/sandbox.py

@@ -923,14 +923,15 @@ class _Sandbox(_Object, type_prefix="sb"):
     async def mount_image(self, path: Union[PurePosixPath, str], image: _Image):
         """Mount an Image at a specified path in a running Sandbox.
 
-        `path` should be a directory. If it doesn't exist it will be created. If it exists and contains
-        data, the previous directory will be replaced by the mount.
+        `path` should be a directory that is **not** the root path (`/`). If the path doesn't exist
+        it will be created. If it exists and contains data, the previous directory will be replaced
+        by the mount.
 
-        The `image` argument currently only supports Images that are either:
-        - prebuilt using `image.build()`
-        - referenced by image id, e.g. `Image.from_id(...)`
-        - filesystem/directory snapshots e.g. created by `.snapshot_directory()`
-        or `.snapshot_filesystem()`"
+        The `image` argument supports any Image that has an object ID, including:
+        - Images built using `image.build()`
+        - Images referenced by ID, e.g. `Image.from_id(...)`
+        - Filesystem/directory snapshots, e.g. created by `.snapshot_directory()` or `.snapshot_filesystem()`
+        - Empty images created with `Image.from_scratch()`
 
         Usage:
         ```py notest
@@ -982,6 +983,27 @@ class _Sandbox(_Object, type_prefix="sb"):
         req = sr_pb2.TaskMountDirectoryRequest(task_id=task_id, path=path_bytes, image_id=image_id)
         await command_router_client.mount_image(req)
 
+    async def unmount_image(self, path: Union[PurePosixPath, str]):
+        """Unmount a previously mounted Image from a running Sandbox.
+
+        `path` must be the exact mount point that was passed to `.mount_image()`.
+        After unmounting, the underlying Sandbox filesystem at that path becomes
+        visible again.
+        """
+        self._ensure_v1("unmount_image")
+
+        task_id = await self._get_task_id()
+        if (command_router_client := await self._get_command_router_client(task_id)) is None:
+            raise InvalidError("Unmounting directories requires direct Sandbox control - please contact Modal support.")
+
+        posix_path = PurePosixPath(path)
+        if not posix_path.is_absolute():
+            raise InvalidError(f"Unmount path must be absolute; got: {posix_path}")
+        path_bytes = posix_path.as_posix().encode("utf8")
+
+        req = sr_pb2.TaskUnmountDirectoryRequest(task_id=task_id, path=path_bytes)
+        await command_router_client.unmount_image(req)
+
     async def snapshot_directory(self, path: Union[PurePosixPath, str]) -> _Image:
         """Snapshot a directory in a running Sandbox, creating a new Image with its content.
 

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/modal/sandbox.pyi

@@ -384,14 +384,15 @@ class _Sandbox(modal._object._Object):
     async def mount_image(self, path: typing.Union[pathlib.PurePosixPath, str], image: modal.image._Image):
         """Mount an Image at a specified path in a running Sandbox.
 
-        `path` should be a directory. If it doesn't exist it will be created. If it exists and contains
-        data, the previous directory will be replaced by the mount.
+        `path` should be a directory that is **not** the root path (`/`). If the path doesn't exist
+        it will be created. If it exists and contains data, the previous directory will be replaced
+        by the mount.
 
-        The `image` argument currently only supports Images that are either:
-        - prebuilt using `image.build()`
-        - referenced by image id, e.g. `Image.from_id(...)`
-        - filesystem/directory snapshots e.g. created by `.snapshot_directory()`
-        or `.snapshot_filesystem()`"
+        The `image` argument supports any Image that has an object ID, including:
+        - Images built using `image.build()`
+        - Images referenced by ID, e.g. `Image.from_id(...)`
+        - Filesystem/directory snapshots, e.g. created by `.snapshot_directory()` or `.snapshot_filesystem()`
+        - Empty images created with `Image.from_scratch()`
 
         Usage:
         ```py notest
@@ -405,6 +406,15 @@ class _Sandbox(modal._object._Object):
         """
         ...
 
+    async def unmount_image(self, path: typing.Union[pathlib.PurePosixPath, str]):
+        """Unmount a previously mounted Image from a running Sandbox.
+
+        `path` must be the exact mount point that was passed to `.mount_image()`.
+        After unmounting, the underlying Sandbox filesystem at that path becomes
+        visible again.
+        """
+        ...
+
     async def snapshot_directory(self, path: typing.Union[pathlib.PurePosixPath, str]) -> modal.image._Image:
         """Snapshot a directory in a running Sandbox, creating a new Image with its content.
 
@@ -1351,14 +1361,15 @@ class Sandbox(modal.object.Object):
         def __call__(self, /, path: typing.Union[pathlib.PurePosixPath, str], image: modal.image.Image):
             """Mount an Image at a specified path in a running Sandbox.
 
-            `path` should be a directory. If it doesn't exist it will be created. If it exists and contains
-            data, the previous directory will be replaced by the mount.
+            `path` should be a directory that is **not** the root path (`/`). If the path doesn't exist
+            it will be created. If it exists and contains data, the previous directory will be replaced
+            by the mount.
 
-            The `image` argument currently only supports Images that are either:
-            - prebuilt using `image.build()`
-            - referenced by image id, e.g. `Image.from_id(...)`
-            - filesystem/directory snapshots e.g. created by `.snapshot_directory()`
-            or `.snapshot_filesystem()`"
+            The `image` argument supports any Image that has an object ID, including:
+            - Images built using `image.build()`
+            - Images referenced by ID, e.g. `Image.from_id(...)`
+            - Filesystem/directory snapshots, e.g. created by `.snapshot_directory()` or `.snapshot_filesystem()`
+            - Empty images created with `Image.from_scratch()`
 
             Usage:
             ```py notest
@@ -1375,14 +1386,15 @@ class Sandbox(modal.object.Object):
         async def aio(self, /, path: typing.Union[pathlib.PurePosixPath, str], image: modal.image.Image):
             """Mount an Image at a specified path in a running Sandbox.
 
-            `path` should be a directory. If it doesn't exist it will be created. If it exists and contains
-            data, the previous directory will be replaced by the mount.
+            `path` should be a directory that is **not** the root path (`/`). If the path doesn't exist
+            it will be created. If it exists and contains data, the previous directory will be replaced
+            by the mount.
 
-            The `image` argument currently only supports Images that are either:
-            - prebuilt using `image.build()`
-            - referenced by image id, e.g. `Image.from_id(...)`
-            - filesystem/directory snapshots e.g. created by `.snapshot_directory()`
-            or `.snapshot_filesystem()`"
+            The `image` argument supports any Image that has an object ID, including:
+            - Images built using `image.build()`
+            - Images referenced by ID, e.g. `Image.from_id(...)`
+            - Filesystem/directory snapshots, e.g. created by `.snapshot_directory()` or `.snapshot_filesystem()`
+            - Empty images created with `Image.from_scratch()`
 
             Usage:
             ```py notest
@@ -1398,6 +1410,27 @@ class Sandbox(modal.object.Object):
 
     mount_image: __mount_image_spec
 
+    class __unmount_image_spec(typing_extensions.Protocol):
+        def __call__(self, /, path: typing.Union[pathlib.PurePosixPath, str]):
+            """Unmount a previously mounted Image from a running Sandbox.
+
+            `path` must be the exact mount point that was passed to `.mount_image()`.
+            After unmounting, the underlying Sandbox filesystem at that path becomes
+            visible again.
+            """
+            ...
+
+        async def aio(self, /, path: typing.Union[pathlib.PurePosixPath, str]):
+            """Unmount a previously mounted Image from a running Sandbox.
+
+            `path` must be the exact mount point that was passed to `.mount_image()`.
+            After unmounting, the underlying Sandbox filesystem at that path becomes
+            visible again.
+            """
+            ...
+
+    unmount_image: __unmount_image_spec
+
     class __snapshot_directory_spec(typing_extensions.Protocol):
         def __call__(self, /, path: typing.Union[pathlib.PurePosixPath, str]) -> modal.image.Image:
             """Snapshot a directory in a running Sandbox, creating a new Image with its content.

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/modal.egg-info/PKG-INFO

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

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2026
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.4.2.dev8"
+__version__ = "1.4.2.dev9"

{modal-1.4.2.dev8 → modal-1.4.2.dev9}/pyproject.toml

@@ -50,7 +50,7 @@ dev = [
     "mypy~=1.18.2",
     "packaging>=23.1",
     "pytest~=8.4.0",
-    "pytest-asyncio @ git+https://github.com/modal-labs/pytest-asyncio.git@af3f2d721b842309749cd26e5bbdd210e17d80c8",
+    "pytest-asyncio~=1.3.0",
     "pytest-env~=1.1.5",
     "pytest-markdown-docs==0.9.1",
     "pytest-timeout~=2.4.0",
@@ -119,6 +119,8 @@ module = [
 ignore_errors = true
 
 [tool.pytest.ini_options]
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"
 timeout = 300
 addopts = "--ignore=modal/cli/programs"
 filterwarnings = [
@@ -126,9 +128,7 @@ filterwarnings = [
     "ignore:Type google._upb.*MapContainer uses PyType_Spec.*Python 3.14:DeprecationWarning",
     "error::modal.exception.DeprecationError",
     "error::modal.exception.AsyncUsageWarning",
-    "ignore:There is no current event loop:DeprecationWarning",  # pytest-asyncio internals
     "ignore:distutils Version classes are deprecated:DeprecationWarning",  # pytest-freezegun internals
-    "ignore:'asyncio.iscoroutinefunction' is deprecated:DeprecationWarning",  # pytest-asyncio internals
 ]
 
 [tool.ruff]