modal 1.5.6.dev7__tar.gz → 1.5.6.dev8__tar.gz

{modal-1.5.6.dev7 → modal-1.5.6.dev8}/PKG-INFO

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

{modal-1.5.6.dev7 → modal-1.5.6.dev8}/modal/client.pyi

@@ -77,7 +77,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.5.6.dev7",
+        version: str = "1.5.6.dev8",
         *,
         oauth_credentials: typing.Optional[_OAuthCredentials] = None,
     ):
@@ -277,7 +277,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.5.6.dev7",
+        version: str = "1.5.6.dev8",
         *,
         oauth_credentials: typing.Optional[_OAuthCredentials] = None,
     ):

{modal-1.5.6.dev7 → modal-1.5.6.dev8}/modal/exception.py

@@ -195,7 +195,7 @@ class SandboxTimeoutError(TimeoutError):
 
 
 class SnapshotCreationError(Error):
-    """Raised when a Sandbox fails to create an exit snapshot."""
+    """Snapshot operation is done and failed. Polling again will not produce an Image; filesystem state is gone."""
 
 
 class ExecTimeoutError(TimeoutError):

{modal-1.5.6.dev7 → modal-1.5.6.dev8}/modal/sandbox.py

@@ -1462,6 +1462,11 @@ class _Sandbox(_Object, type_prefix="sb"):
     async def _experimental_get_exit_snapshot(self, timeout: float | None = None) -> _Image:
         """Get the exit filesystem snapshot image.
 
+        An exit snapshot captures the Sandbox filesystem when the Sandbox exits,
+        whether its entrypoint finishes gracefully, abruptly, or it is stopped with
+        `terminate()`. Exit snapshots are opt-in: the Sandbox must have been
+        created with `experimental_options={"enable_exit_snapshot": True}`.
+
         Args:
             timeout: Total time to wait in seconds, spread across repeated long
                 polls of at most `_EXIT_SNAPSHOT_LONG_POLL_TIMEOUT` seconds each.
@@ -1477,7 +1482,8 @@ class _Sandbox(_Object, type_prefix="sb"):
             TimeoutError: If `timeout` elapses before the snapshot reaches a
                 terminal state. This includes `timeout=0` when the snapshot is
                 still pending.
-            SnapshotCreationError: If no exit snapshot image will be produced.
+            SnapshotCreationError: Snapshot operation is done and failed.
+                Polling again will not produce an Image; filesystem state is gone.
             NotFoundError: If the sandbox does not exist.
             PermissionDeniedError: If the caller cannot access the sandbox.
         """

{modal-1.5.6.dev7 → modal-1.5.6.dev8}/modal/sandbox.pyi

@@ -597,6 +597,11 @@ class _Sandbox(modal._object._Object):
     async def _experimental_get_exit_snapshot(self, timeout: typing.Optional[float] = None) -> modal._image._Image:
         """Get the exit filesystem snapshot image.
 
+        An exit snapshot captures the Sandbox filesystem when the Sandbox exits,
+        whether its entrypoint finishes gracefully, abruptly, or it is stopped with
+        `terminate()`. Exit snapshots are opt-in: the Sandbox must have been
+        created with `experimental_options={"enable_exit_snapshot": True}`.
+
         Args:
             timeout: Total time to wait in seconds, spread across repeated long
                 polls of at most `_EXIT_SNAPSHOT_LONG_POLL_TIMEOUT` seconds each.
@@ -612,7 +617,8 @@ class _Sandbox(modal._object._Object):
             TimeoutError: If `timeout` elapses before the snapshot reaches a
                 terminal state. This includes `timeout=0` when the snapshot is
                 still pending.
-            SnapshotCreationError: If no exit snapshot image will be produced.
+            SnapshotCreationError: Snapshot operation is done and failed.
+                Polling again will not produce an Image; filesystem state is gone.
             NotFoundError: If the sandbox does not exist.
             PermissionDeniedError: If the caller cannot access the sandbox.
         """
@@ -2457,6 +2463,11 @@ class Sandbox(modal.object.Object):
         def __call__(self, /, timeout: typing.Optional[float] = None) -> modal.image.Image:
             """Get the exit filesystem snapshot image.
 
+            An exit snapshot captures the Sandbox filesystem when the Sandbox exits,
+            whether its entrypoint finishes gracefully, abruptly, or it is stopped with
+            `terminate()`. Exit snapshots are opt-in: the Sandbox must have been
+            created with `experimental_options={"enable_exit_snapshot": True}`.
+
             Args:
                 timeout: Total time to wait in seconds, spread across repeated long
                     polls of at most `_EXIT_SNAPSHOT_LONG_POLL_TIMEOUT` seconds each.
@@ -2472,7 +2483,8 @@ class Sandbox(modal.object.Object):
                 TimeoutError: If `timeout` elapses before the snapshot reaches a
                     terminal state. This includes `timeout=0` when the snapshot is
                     still pending.
-                SnapshotCreationError: If no exit snapshot image will be produced.
+                SnapshotCreationError: Snapshot operation is done and failed.
+                    Polling again will not produce an Image; filesystem state is gone.
                 NotFoundError: If the sandbox does not exist.
                 PermissionDeniedError: If the caller cannot access the sandbox.
             """
@@ -2481,6 +2493,11 @@ class Sandbox(modal.object.Object):
         async def aio(self, /, timeout: typing.Optional[float] = None) -> modal.image.Image:
             """Get the exit filesystem snapshot image.
 
+            An exit snapshot captures the Sandbox filesystem when the Sandbox exits,
+            whether its entrypoint finishes gracefully, abruptly, or it is stopped with
+            `terminate()`. Exit snapshots are opt-in: the Sandbox must have been
+            created with `experimental_options={"enable_exit_snapshot": True}`.
+
             Args:
                 timeout: Total time to wait in seconds, spread across repeated long
                     polls of at most `_EXIT_SNAPSHOT_LONG_POLL_TIMEOUT` seconds each.
@@ -2496,7 +2513,8 @@ class Sandbox(modal.object.Object):
                 TimeoutError: If `timeout` elapses before the snapshot reaches a
                     terminal state. This includes `timeout=0` when the snapshot is
                     still pending.
-                SnapshotCreationError: If no exit snapshot image will be produced.
+                SnapshotCreationError: Snapshot operation is done and failed.
+                    Polling again will not produce an Image; filesystem state is gone.
                 NotFoundError: If the sandbox does not exist.
                 PermissionDeniedError: If the caller cannot access the sandbox.
             """

{modal-1.5.6.dev7 → modal-1.5.6.dev8}/modal.egg-info/PKG-INFO

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

{modal-1.5.6.dev7 → modal-1.5.6.dev8}/modal_version/__init__.py

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