modAL 1.5.6.dev7__py3-none-any.whl → 1.5.6.dev9__py3-none-any.whl

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.dev9",
         *,
         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.dev9",
         *,
         oauth_credentials: typing.Optional[_OAuthCredentials] = None,
     ):

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/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/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.dist-info → modal-1.5.6.dev9.dist-info}/METADATA

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

{modal-1.5.6.dev7.dist-info → modal-1.5.6.dev9.dist-info}/RECORD

@@ -34,7 +34,7 @@ modal/billing.py,sha256=E1-P_P8bJFLp-bTaggYd4BaaViImPB5UdtXiY8VeAZQ,390
 modal/billing.pyi,sha256=4m7VLYNS8IiJ2I3CJx0awvrOM6BILWRVLfdeqtAYr8M,7189
 modal/call_graph.py,sha256=XGALIDn1bLchWo_goyX23bcPjzCZcfqKUo8INIfDapo,1775
 modal/client.py,sha256=CiBsT2XuUuKps5RYc3jwJcfI_VQKK09cbkqeHfHpx3E,21476
-modal/client.pyi,sha256=cvANMaQaZzmzH3-LI3hcC-HIA70qwMhWKnk5n_g1Hv0,22281
+modal/client.pyi,sha256=DFL2DypzS-vsW5bZcH0Xhn2GbL3ZL29K6Dy7UfAKBSk,22281
 modal/cloud_bucket_mount.py,sha256=UlLYi8M-5FY64uGiTZwb3R4UlJAqHZHDdByaakPzrjU,6886
 modal/cloud_bucket_mount.pyi,sha256=cAkMjjochpV1QLyDa5cPsqAse1_uNBsEH0ivawJFQew,8188
 modal/cls.py,sha256=JE5KfVyQEvlc40Sjsn3lwaU5Ue0Zs4esQ5QBLxmxqBU,42508
@@ -46,7 +46,7 @@ modal/dict.py,sha256=Lzf3mo16wkV5tPucbRyjr2XQEoB8tH2-1-9dU6q-pBA,24072
 modal/dict.pyi,sha256=SPafrdRoStNJFt3YtO2H6PucXfbP-rDPB9zAWgY91sY,38253
 modal/environments.py,sha256=gKxjaaMS6YzVhl_rHgDqFZy6qlTgBkX9FOTSVVuCvds,1694
 modal/environments.pyi,sha256=DMoXQhzuiJ46cGq6hO69Z6rg8gPuuBSMhFx32Q4Igrs,21732
-modal/exception.py,sha256=2AwHPwv9vTAG4sxMCI5vrbaT5JfKq2l9TfS9k2KUeP4,12288
+modal/exception.py,sha256=mCeYo0Kl-fDa3qTW3TK4ookvc88H6VlcP0xve1AgyNs,12338
 modal/file_io.py,sha256=GYTa67mrmbTTTBsYQnb51VmwGIo0YY-1qQ3YBhagkmA,21795
 modal/file_io.pyi,sha256=3181-DS07flFWLf2BKjqCOiWIjieEOolf33wx6fBp5c,15377
 modal/file_pattern_matcher.py,sha256=CpaNNj7oBlOSewX-AAUZCF8KDxH0_DmgwzfpVGbPYJ4,8138
@@ -76,8 +76,8 @@ modal/retries.py,sha256=tSGB5bGM5xZZUDXMkuelIEoQJY0vOukOssZhwc6tXAo,5014
 modal/runner.py,sha256=5auTijqKFvMleYfVaK01sRdXd1dWQLilXlSqWx9gMAM,31344
 modal/runner.pyi,sha256=jIdnTwYv5AH-c8weyeCFzJ0hIekw81QqUsxVzXbgkcc,9954
 modal/running_app.py,sha256=xSR1VVlhxEFytmjx2x697_0GpD25Vc9crhp6r117_QY,1145
-modal/sandbox.py,sha256=AOvNw9Uoz40UtHmx2tGZ5B84PEDv6lWbiA-qBT8FBIM,134876
-modal/sandbox.pyi,sha256=shhenvSkuFYqrozmY6AbnmEuS0-Sp-zbNgeNTTQr378,157117
+modal/sandbox.py,sha256=reBAg1ddT8p8ZXr2kYwzerKVfbvYvhOKyZtqBJ6JVVg,135273
+modal/sandbox.pyi,sha256=nqBDpNYbyS5NOqXZ7gKf20-3PtY3hkXPnFqMNp7CBcA,158348
 modal/sandbox_fs.py,sha256=GSuPlrLSdQ7fG7c_TGMd-VWs_s6RqQxMvLivdvC6s4s,27002
 modal/sandbox_fs.pyi,sha256=TJWx8h7x3yRC7KUxeF7q62_0a7w1IHufnJL7AYEojAg,45285
 modal/schedule.py,sha256=wsOrZEKOWH6lw2H50AERFsxSd_DafDH6blME1ukkf8U,3260
@@ -198,7 +198,7 @@ modal/experimental/flash.py,sha256=m803RsPvMgLCSNJfT_11da1sz9l1BIr1MDxAA_qtK2k,1
 modal/experimental/flash.pyi,sha256=tHS2un-PxndcxV27l7CAWnPhRPmiIs2cCNzKLXBNxJA,8520
 modal/experimental/ipython.py,sha256=kJ6o9wkAY_MiSb7paewI7f1MJAeqdi8TX5pBdhr_mUI,2925
 modal/skills/modal/SKILL.md,sha256=ERhA-zss3OoPXU_d3Qo8-PNrK2QI_ctyhGavou3egd0,5276
-modal-1.5.6.dev7.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.5.6.dev9.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
 modal_docs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal_docs/gen_cli_docs.py,sha256=9-b8vl2EsLWD9zJqpCK8IUi5h44Bjn3i3rSdedZV4bA,6415
 modal_docs/gen_cli_docs_main.py,sha256=UPGr7O1DYTIRLwfINe2rbdh89J3cPVTU1OWL-SjxnOQ,198
@@ -222,10 +222,10 @@ modal_proto/task_command_router_pb2.py,sha256=rMwEVv6DV1Hpv8_hi7SE0zxCkrv6elWgwK
 modal_proto/task_command_router_pb2.pyi,sha256=OQ2jBFSduSEPtP3llAhFhW2dZJJxsqBy3Y5s8Yj40nA,47640
 modal_proto/task_command_router_pb2_grpc.py,sha256=zuFkJgKcswB2ftjnyEgs70dp61VMA7gK0h0uzR3gYFw,42563
 modal_proto/task_command_router_pb2_grpc.pyi,sha256=UjAJFqz9DpOFXP04fVm5lB2eAyTtjOg3oKjfWei8yLU,14262
-modal_version/__init__.py,sha256=1skhWBFkW3rhWtAL_PsFZELSWQjFajxAjFVH7eMskp4,120
+modal_version/__init__.py,sha256=FfH6Y2Xy5qWZtz0MbIe4-xPYvHZuKHtli4CIHwOe4kw,120
 modal_version/__main__.py,sha256=nLUbubxKx7GXNzJIkTB7M7_u8080LyLM0IS0rzFkC_c,119
-modal-1.5.6.dev7.dist-info/METADATA,sha256=eYL6tFJetskj-gTc753a_qxnRVJ7jTAkzJnCoidWEWk,2512
-modal-1.5.6.dev7.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-modal-1.5.6.dev7.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.5.6.dev7.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.5.6.dev7.dist-info/RECORD,,
+modal-1.5.6.dev9.dist-info/METADATA,sha256=6Wrd_pahgljNRPA8qYHqYnIl0W5fjAY2AIEgRuKvCNw,2512
+modal-1.5.6.dev9.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+modal-1.5.6.dev9.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.5.6.dev9.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.5.6.dev9.dist-info/RECORD,,

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.dev9"