modal 1.1.1.dev7__tar.gz → 1.1.1.dev10__tar.gz

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/PKG-INFO

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

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/modal/client.pyi

@@ -33,7 +33,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.1.1.dev7",
+        version: str = "1.1.1.dev10",
     ):
         """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.1.1.dev7",
+        version: str = "1.1.1.dev10",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/modal/exception.py

@@ -26,6 +26,10 @@ class Error(Exception):
     """
 
 
+class AlreadyExistsError(Error):
+    """Raised when a resource creation conflicts with an existing resource."""
+
+
 class RemoteError(Error):
     """Raised when an error occurs on the Modal server."""
 

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/modal/experimental/__init__.py

@@ -20,7 +20,7 @@ from ..cls import _Cls, _Obj
 from ..exception import InvalidError
 from ..image import DockerfileSpec, ImageBuilderVersion, _Image, _ImageRegistryConfig
 from ..secret import _Secret
-from .flash import flash_forward, flash_prometheus_autoscaler  # noqa: F401
+from .flash import flash_forward, flash_get_containers, flash_prometheus_autoscaler  # noqa: F401
 
 
 def stop_fetching_inputs():

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/modal/experimental/flash.py

@@ -447,3 +447,20 @@ async def flash_prometheus_autoscaler(
     )
     await autoscaler.start()
     return autoscaler
+
+
+@synchronizer.create_blocking
+async def flash_get_containers(app_name: str, cls_name: str) -> list[dict[str, Any]]:
+    """
+    Return a list of flash containers for a deployed Flash service.
+
+    This is a highly experimental method that can break or be removed at any time without warning.
+    Do not use this method unless explicitly instructed to do so by Modal support.
+    """
+    client = await _Client.from_env()
+    fn = _Cls.from_name(app_name, cls_name)._class_service_function
+    assert fn is not None
+    await fn.hydrate(client=client)
+    req = api_pb2.FlashContainerListRequest(function_id=fn.object_id)
+    resp = await retry_transient_errors(client.stub.FlashContainerList, req)
+    return resp.containers

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/modal/experimental/flash.pyi

@@ -250,3 +250,22 @@ class __flash_prometheus_autoscaler_spec(typing_extensions.Protocol):
         ...
 
 flash_prometheus_autoscaler: __flash_prometheus_autoscaler_spec
+
+class __flash_get_containers_spec(typing_extensions.Protocol):
+    def __call__(self, /, app_name: str, cls_name: str) -> list[dict[str, typing.Any]]:
+        """Return a list of flash containers for a deployed Flash service.
+
+        This is a highly experimental method that can break or be removed at any time without warning.
+        Do not use this method unless explicitly instructed to do so by Modal support.
+        """
+        ...
+
+    async def aio(self, /, app_name: str, cls_name: str) -> list[dict[str, typing.Any]]:
+        """Return a list of flash containers for a deployed Flash service.
+
+        This is a highly experimental method that can break or be removed at any time without warning.
+        Do not use this method unless explicitly instructed to do so by Modal support.
+        """
+        ...
+
+flash_get_containers: __flash_get_containers_spec

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/modal/sandbox.py

@@ -27,7 +27,7 @@ from ._utils.mount_utils import validate_network_file_systems, validate_volumes
 from .client import _Client
 from .config import config
 from .container_process import _ContainerProcess
-from .exception import ExecutionError, InvalidError, SandboxTerminatedError, SandboxTimeoutError
+from .exception import AlreadyExistsError, ExecutionError, InvalidError, SandboxTerminatedError, SandboxTimeoutError
 from .file_io import FileWatchEvent, FileWatchEventType, _FileIO
 from .gpu import GPU_T
 from .image import _Image
@@ -236,7 +236,12 @@ class _Sandbox(_Object, type_prefix="sb"):
             )
 
             create_req = api_pb2.SandboxCreateRequest(app_id=resolver.app_id, definition=definition)
-            create_resp = await retry_transient_errors(resolver.client.stub.SandboxCreate, create_req)
+            try:
+                create_resp = await retry_transient_errors(resolver.client.stub.SandboxCreate, create_req)
+            except GRPCError as exc:
+                if exc.status == Status.ALREADY_EXISTS:
+                    raise AlreadyExistsError(exc.message)
+                raise exc
 
             sandbox_id = create_resp.sandbox_id
             self._hydrate(sandbox_id, resolver.client, None)
@@ -475,8 +480,8 @@ class _Sandbox(_Object, type_prefix="sb"):
     ) -> "_Sandbox":
         """Get a running Sandbox by name from the given app.
 
-        Raises an error if no running sandbox is found with the given name. A Sandbox's name
-        is the `name` argument passed to `Sandbox.create`.
+        Raises a modal.exception.NotFoundError if no running sandbox is found with the given name.
+        A Sandbox's name is the `name` argument passed to `Sandbox.create`.
         """
         if client is None:
             client = await _Client.from_env()
@@ -786,10 +791,15 @@ class _Sandbox(_Object, type_prefix="sb"):
                 sandbox_name_override=name,
                 sandbox_name_override_type=api_pb2.SandboxRestoreRequest.SANDBOX_NAME_OVERRIDE_TYPE_STRING,
             )
+        try:
+            restore_resp: api_pb2.SandboxRestoreResponse = await retry_transient_errors(
+                client.stub.SandboxRestore, restore_req
+            )
+        except GRPCError as exc:
+            if exc.status == Status.ALREADY_EXISTS:
+                raise AlreadyExistsError(exc.message)
+            raise exc
 
-        restore_resp: api_pb2.SandboxRestoreResponse = await retry_transient_errors(
-            client.stub.SandboxRestore, restore_req
-        )
         sandbox = await _Sandbox.from_id(restore_resp.sandbox_id, client)
 
         task_id_req = api_pb2.SandboxGetTaskIdRequest(

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/modal/sandbox.pyi

@@ -178,8 +178,8 @@ class _Sandbox(modal._object._Object):
     ) -> _Sandbox:
         """Get a running Sandbox by name from the given app.
 
-        Raises an error if no running sandbox is found with the given name. A Sandbox's name
-        is the `name` argument passed to `Sandbox.create`.
+        Raises a modal.exception.NotFoundError if no running sandbox is found with the given name.
+        A Sandbox's name is the `name` argument passed to `Sandbox.create`.
         """
         ...
 
@@ -588,8 +588,8 @@ class Sandbox(modal.object.Object):
         ) -> Sandbox:
             """Get a running Sandbox by name from the given app.
 
-            Raises an error if no running sandbox is found with the given name. A Sandbox's name
-            is the `name` argument passed to `Sandbox.create`.
+            Raises a modal.exception.NotFoundError if no running sandbox is found with the given name.
+            A Sandbox's name is the `name` argument passed to `Sandbox.create`.
             """
             ...
 
@@ -604,8 +604,8 @@ class Sandbox(modal.object.Object):
         ) -> Sandbox:
             """Get a running Sandbox by name from the given app.
 
-            Raises an error if no running sandbox is found with the given name. A Sandbox's name
-            is the `name` argument passed to `Sandbox.create`.
+            Raises a modal.exception.NotFoundError if no running sandbox is found with the given name.
+            A Sandbox's name is the `name` argument passed to `Sandbox.create`.
             """
             ...
 

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/modal.egg-info/PKG-INFO

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

{modal-1.1.1.dev7 → modal-1.1.1.dev10}/modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2025
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.1.1.dev7"
+__version__ = "1.1.1.dev10"