modal 1.5.3.dev7__tar.gz → 1.5.3.dev11__tar.gz

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/PKG-INFO

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

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/_environments.py

@@ -414,7 +414,7 @@ class _EnvironmentBillingManager:
             - [`modal environment billing report`](https://modal.com/docs/cli/latest/environment#modal-environment-billing-report):
               An environment report CLI that has convenience features around relative time range queries
               and JSON/CSV output.
-            - [`Workspace.billing.report()`](https://modal.com/docs/sdk/py/latest/modal.Workspace#billingreport):
+            - [`Workspace.billing.report()`](https://modal.com/docs/sdk/py/latest/Workspace#billingreport):
               An analogous report API for the entire Workspace.
 
         """

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/_function_variants.py

@@ -171,7 +171,7 @@ class _FunctionOptions:
             replace_secret_ids=bool(self.secrets),
             replace_volume_mounts=len(volume_mounts) > 0,
             volume_mounts=volume_mounts,
-            cloud_bucket_mounts=cloud_bucket_mounts_to_proto(self.cloud_bucket_mounts),
+            cloud_bucket_mounts=cloud_bucket_mounts_to_proto(self.cloud_bucket_mounts)[0],
             replace_cloud_bucket_mounts=bool(self.cloud_bucket_mounts),
             resources=self.resources,
             retry_policy=self.retry_policy,

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/_functions.py

@@ -1000,7 +1000,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
                     untrusted=restrict_modal_access,
                     single_use_containers=single_use_containers,
                     max_inputs=int(single_use_containers),  # TODO(michael) remove after worker rollover
-                    cloud_bucket_mounts=cloud_bucket_mounts_to_proto(cloud_bucket_mounts),
+                    cloud_bucket_mounts=cloud_bucket_mounts_to_proto(cloud_bucket_mounts)[0],
                     scheduler_placement=scheduler_placement,
                     is_class=info.is_service_class(),
                     class_parameter_info=info.class_parameter_info(),
@@ -1914,9 +1914,9 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
             **kwargs: Keyword arguments forwarded to the remote function.
 
         Returns:
-            A [`modal.FunctionCall`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall) object
+            A [`modal.FunctionCall`](https://modal.com/docs/sdk/py/latest/FunctionCall) object
             that can later be polled or waited for using
-            [`.get(timeout=...)`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall#get).
+            [`.get(timeout=...)`](https://modal.com/docs/sdk/py/latest/FunctionCall#get).
         """
         self._check_no_web_url("spawn")
         if self._is_generator:
@@ -2078,7 +2078,7 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         Note: the call graph data is not populated in real-time, and its capture is best-effort.
         We do not recommend relying on this method for critical use cases.
 
-        See the [`modal.types`](/docs/sdk/py/latest/modal.types) reference for information
+        See the [`modal.types`](/docs/sdk/py/latest/types) reference for information
         on the return values.
 
         Returns:

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/_partial_function.py

@@ -478,7 +478,7 @@ def _wsgi_app(
     Web Server Gateway Interface (WSGI) is a standard for synchronous Python web apps.
     It has been [succeeded by the ASGI interface](https://asgi.readthedocs.io/en/latest/introduction.html#wsgi-compatibility)
     which is compatible with ASGI and supports additional functionality such as web sockets.
-    Modal supports ASGI via [`asgi_app`](https://modal.com/docs/sdk/py/latest/modal.asgi_app).
+    Modal supports ASGI via [`asgi_app`](https://modal.com/docs/sdk/py/latest/asgi_app).
 
     Examples:
         ```python

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/_server.py

@@ -49,7 +49,7 @@ class _Server:
     See the [guide](https://modal.com/docs/guide/servers) for more information.
 
     Generally, you will not construct a Server directly.
-    Instead, use the [`@app.server()`](https://modal.com/docs/sdk/py/latest/modal.App#server) decorator.
+    Instead, use the [`@app.server()`](https://modal.com/docs/sdk/py/latest/App#server) decorator.
 
     ```python notest
     @app.server(port=8080, routing_region="us-east")

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/_utils/task_command_router_client.py

@@ -974,3 +974,8 @@ class TaskCommandRouterClient:
         return await self._unary_call_with_deadline(
             self._stub.TaskSnapshotFilesystem, request, timeout=timeout, **kwargs
         )
+
+    async def snapshot_memory(
+        self, request: sr_pb2.TaskSnapshotMemoryRequest, *, timeout: float, **kwargs
+    ) -> sr_pb2.TaskSnapshotMemoryResponse:
+        return await self._unary_call_with_deadline(self._stub.TaskSnapshotMemory, request, timeout=timeout, **kwargs)

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/_workspace.py

@@ -283,7 +283,7 @@ class _WorkspaceBillingManager:
             - [`modal billing report`](https://modal.com/docs/cli/latest/billing#modal-billing-report):
               A workspace report CLI that has convenience features around relative time range queries
               and JSON/CSV output.
-            - [`Environment.billing.report()`](https://modal.com/docs/sdk/py/latest/modal.Environment#billingreport):
+            - [`Environment.billing.report()`](https://modal.com/docs/sdk/py/latest/Environment#billingreport):
               An analogous report API that is scoped to a specific Environment.
 
         """

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/app.py

@@ -710,7 +710,7 @@ class _App:
         Modal functions can also be used as CLI entrypoints, but unlike `local_entrypoint`,
         those functions are executed remotely directly.
 
-        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/modal.App#run) is not needed, as an
+        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/App#run) is not needed, as an
         [app](https://modal.com/docs/guide/apps) is automatically created for you.
 
         Args:
@@ -1069,7 +1069,7 @@ class _App:
         max_inputs: int | None = None,
     ) -> Callable[[CLS_T | _PartialFunction], CLS_T]:
         """
-        Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/modal.Cls) with this App.
+        Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/Cls) with this App.
 
         Args:
             image: The image to run as the container for the class service.

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/app.pyi

@@ -494,7 +494,7 @@ class _App:
         Modal functions can also be used as CLI entrypoints, but unlike `local_entrypoint`,
         those functions are executed remotely directly.
 
-        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/modal.App#run) is not needed, as an
+        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/App#run) is not needed, as an
         [app](https://modal.com/docs/guide/apps) is automatically created for you.
 
         Args:
@@ -683,7 +683,7 @@ class _App:
         _experimental_restrict_output: bool = False,
         max_inputs: typing.Optional[int] = None,
     ) -> collections.abc.Callable[[typing.Union[CLS_T, modal._partial_function._PartialFunction]], CLS_T]:
-        """Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/modal.Cls) with this App.
+        """Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/Cls) with this App.
 
         Args:
             image: The image to run as the container for the class service.
@@ -1498,7 +1498,7 @@ class App:
         Modal functions can also be used as CLI entrypoints, but unlike `local_entrypoint`,
         those functions are executed remotely directly.
 
-        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/modal.App#run) is not needed, as an
+        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/App#run) is not needed, as an
         [app](https://modal.com/docs/guide/apps) is automatically created for you.
 
         Args:
@@ -1687,7 +1687,7 @@ class App:
         _experimental_restrict_output: bool = False,
         max_inputs: typing.Optional[int] = None,
     ) -> collections.abc.Callable[[typing.Union[CLS_T, modal.partial_function.PartialFunction]], CLS_T]:
-        """Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/modal.Cls) with this App.
+        """Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/Cls) with this App.
 
         Args:
             image: The image to run as the container for the class service.

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/cli/billing.py

@@ -107,7 +107,7 @@ async def report(
     or by requesting a date range using `--for` (e.g., `--for today`, `--for 'last month'`).
 
     This command provides a CLI frontend for the
-    [`Workspace.billing.report`](https://modal.com/docs/sdk/py/latest/modal.Workspace#billingreport) API.
+    [`Workspace.billing.report`](https://modal.com/docs/sdk/py/latest/Workspace#billingreport) API.
 
     Note that, as with the API, the start date is inclusive and the end date is exclusive.
     Data will be reported for full intervals only. Using `--for` is a convenient way to define a

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/cli/config.py

@@ -14,7 +14,7 @@ config_cli = ModalGroup(
     help="""
     Manage client configuration for the current profile.
 
-    Refer to https://modal.com/docs/sdk/py/latest/modal.config for a full explanation
+    Refer to https://modal.com/docs/sdk/py/latest/config for a full explanation
     of what these options mean, and how to set them.
     """,
 )

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/cli/environment.py

@@ -229,7 +229,7 @@ async def environment_billing(
     or by requesting a date range using `--for` (e.g., `--for today`, `--for 'last month'`).
 
     This command provides a CLI frontend for the
-    [`Environment.billing.report`](https://modal.com/docs/sdk/py/latest/modal.Environment#billingreport)
+    [`Environment.billing.report`](https://modal.com/docs/sdk/py/latest/Environment#billingreport)
     API.
 
     Note that, as with the API, the start date is inclusive and the end date is exclusive.

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/cli/shell.py

@@ -373,7 +373,7 @@ def shell(
     modal shell hello_world.py::my_function
     ```
 
-    Or, if you're using a [modal.Cls](https://modal.com/docs/sdk/py/latest/modal.Cls)
+    Or, if you're using a [modal.Cls](https://modal.com/docs/sdk/py/latest/Cls)
     you can refer to a `@modal.method` directly:
 
     ```

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/client.py

@@ -241,7 +241,7 @@ class _Client:
             else:
                 raise AuthError(
                     "Token missing. Could not authenticate client."
-                    " If you have token credentials, see modal.com/docs/sdk/py/latest/modal.config for setup help."
+                    " If you have token credentials, see modal.com/docs/sdk/py/latest/config for setup help."
                     " If you are a new user, register an account at modal.com, then run `modal token new`."
                 )
 

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/client.pyi

@@ -37,7 +37,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.5.3.dev7",
+        version: str = "1.5.3.dev11",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.
@@ -207,7 +207,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.5.3.dev7",
+        version: str = "1.5.3.dev11",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/cloud_bucket_mount.py

@@ -121,11 +121,14 @@ class _CloudBucketMount:
     force_path_style: bool = False
 
 
-def cloud_bucket_mounts_to_proto(mounts: Sequence[tuple[str, _CloudBucketMount]]) -> list[api_pb2.CloudBucketMount]:
+def cloud_bucket_mounts_to_proto(
+    mounts: Sequence[tuple[str, _CloudBucketMount]], split_ephemeral_credentials: bool = False
+) -> tuple[list[api_pb2.CloudBucketMount], dict[str, api_pb2.StringMap]]:
     """mdmd:hidden
     Helper function to convert `CloudBucketMount` to a list of protobufs that can be passed to the server.
     """
     cloud_bucket_mounts: list[api_pb2.CloudBucketMount] = []
+    cloud_bucket_credentials: dict[str, api_pb2.StringMap] = {}
 
     for path, mount in mounts:
         # crude mapping from mount arguments to type.
@@ -153,11 +156,20 @@ def cloud_bucket_mounts_to_proto(mounts: Sequence[tuple[str, _CloudBucketMount]]
         else:
             key_prefix = mount.key_prefix
 
+        credentials_secret_id = ""
+        if secret := mount.secret:
+            if split_ephemeral_credentials and secret._load_env_dict:
+                env_dict = secret._load_env_dict()
+                credientials = api_pb2.StringMap(contents=env_dict)
+                cloud_bucket_credentials[path] = credientials
+            else:
+                credentials_secret_id = secret.object_id
+
         cloud_bucket_mount = api_pb2.CloudBucketMount(
             bucket_name=mount.bucket_name,
             bucket_endpoint_url=mount.bucket_endpoint_url,
             mount_path=path,
-            credentials_secret_id=mount.secret.object_id if mount.secret else "",
+            credentials_secret_id=credentials_secret_id,
             read_only=mount.read_only,
             bucket_type=bucket_type,
             requester_pays=mount.requester_pays,
@@ -167,7 +179,7 @@ def cloud_bucket_mounts_to_proto(mounts: Sequence[tuple[str, _CloudBucketMount]]
         )
         cloud_bucket_mounts.append(cloud_bucket_mount)
 
-    return cloud_bucket_mounts
+    return cloud_bucket_mounts, cloud_bucket_credentials
 
 
 CloudBucketMount = synchronize_api(_CloudBucketMount)

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/cloud_bucket_mount.pyi

@@ -126,8 +126,8 @@ class _CloudBucketMount:
         ...
 
 def cloud_bucket_mounts_to_proto(
-    mounts: collections.abc.Sequence[tuple[str, _CloudBucketMount]],
-) -> list[modal_proto.api_pb2.CloudBucketMount]:
+    mounts: collections.abc.Sequence[tuple[str, _CloudBucketMount]], split_ephemeral_credentials: bool = False
+) -> tuple[list[modal_proto.api_pb2.CloudBucketMount], dict[str, modal_proto.api_pb2.StringMap]]:
     """mdmd:hidden
     Helper function to convert `CloudBucketMount` to a list of protobufs that can be passed to the server.
     """

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/cls.py

@@ -447,10 +447,10 @@ Obj = synchronize_api(_Obj)
 class _Cls(_Object, type_prefix="cs"):
     """
     Cls adds method pooling and [lifecycle hook](https://modal.com/docs/guide/lifecycle-functions) behavior
-    to [modal.Function](https://modal.com/docs/sdk/py/latest/modal.Function).
+    to [modal.Function](https://modal.com/docs/sdk/py/latest/Function).
 
     Generally, you will not construct a Cls directly.
-    Instead, use the [`@app.cls()`](https://modal.com/docs/sdk/py/latest/modal.App#cls) decorator on the App object.
+    Instead, use the [`@app.cls()`](https://modal.com/docs/sdk/py/latest/App#cls) decorator on the App object.
     """
 
     _class_service_function: _Function | None  # The _Function (read "service") serving *all* methods of the class

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/cls.pyi

@@ -241,10 +241,10 @@ class Obj:
 
 class _Cls(modal._object._Object):
     """Cls adds method pooling and [lifecycle hook](https://modal.com/docs/guide/lifecycle-functions) behavior
-    to [modal.Function](https://modal.com/docs/sdk/py/latest/modal.Function).
+    to [modal.Function](https://modal.com/docs/sdk/py/latest/Function).
 
     Generally, you will not construct a Cls directly.
-    Instead, use the [`@app.cls()`](https://modal.com/docs/sdk/py/latest/modal.App#cls) decorator on the App object.
+    Instead, use the [`@app.cls()`](https://modal.com/docs/sdk/py/latest/App#cls) decorator on the App object.
     """
 
     _class_service_function: typing.Optional[modal._functions._Function]
@@ -446,10 +446,10 @@ class _Cls(modal._object._Object):
 
 class Cls(modal.object.Object):
     """Cls adds method pooling and [lifecycle hook](https://modal.com/docs/guide/lifecycle-functions) behavior
-    to [modal.Function](https://modal.com/docs/sdk/py/latest/modal.Function).
+    to [modal.Function](https://modal.com/docs/sdk/py/latest/Function).
 
     Generally, you will not construct a Cls directly.
-    Instead, use the [`@app.cls()`](https://modal.com/docs/sdk/py/latest/modal.App#cls) decorator on the App object.
+    Instead, use the [`@app.cls()`](https://modal.com/docs/sdk/py/latest/App#cls) decorator on the App object.
     """
 
     _class_service_function: typing.Optional[modal.functions.Function]

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/environments.pyi

@@ -288,7 +288,7 @@ class EnvironmentBillingManager:
                 - [`modal environment billing report`](https://modal.com/docs/cli/latest/environment#modal-environment-billing-report):
                   An environment report CLI that has convenience features around relative time range queries
                   and JSON/CSV output.
-                - [`Workspace.billing.report()`](https://modal.com/docs/sdk/py/latest/modal.Workspace#billingreport):
+                - [`Workspace.billing.report()`](https://modal.com/docs/sdk/py/latest/Workspace#billingreport):
                   An analogous report API for the entire Workspace.
             """
             ...
@@ -325,7 +325,7 @@ class EnvironmentBillingManager:
                 - [`modal environment billing report`](https://modal.com/docs/cli/latest/environment#modal-environment-billing-report):
                   An environment report CLI that has convenience features around relative time range queries
                   and JSON/CSV output.
-                - [`Workspace.billing.report()`](https://modal.com/docs/sdk/py/latest/modal.Workspace#billingreport):
+                - [`Workspace.billing.report()`](https://modal.com/docs/sdk/py/latest/Workspace#billingreport):
                   An analogous report API for the entire Workspace.
             """
             ...

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/exception.py

@@ -47,7 +47,7 @@ UserCodeException = synchronicity.exceptions.UserCodeException  # Deprecated typ
 
 class Error(Exception):
     """
-    Base class for all Modal errors. See [`modal.exception`](https://modal.com/docs/sdk/py/latest/modal.exception)
+    Base class for all Modal errors. See [`modal.exception`](https://modal.com/docs/sdk/py/latest/exception)
     for the specialized error classes.
 
     Examples:
@@ -188,6 +188,10 @@ class SandboxTimeoutError(TimeoutError):
     """Raised when a Sandbox exceeds its execution duration limit and times out."""
 
 
+class SnapshotCreationError(Error):
+    """Raised when a Sandbox fails to create an exit snapshot."""
+
+
 class ExecTimeoutError(TimeoutError):
     """Raised when a container process exceeds its execution duration limit and times out."""
 

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/functions.pyi

@@ -620,9 +620,9 @@ class Function(
                 **kwargs: Keyword arguments forwarded to the remote function.
 
             Returns:
-                A [`modal.FunctionCall`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall) object
+                A [`modal.FunctionCall`](https://modal.com/docs/sdk/py/latest/FunctionCall) object
                 that can later be polled or waited for using
-                [`.get(timeout=...)`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall#get).
+                [`.get(timeout=...)`](https://modal.com/docs/sdk/py/latest/FunctionCall#get).
             """
             ...
 
@@ -636,9 +636,9 @@ class Function(
                 **kwargs: Keyword arguments forwarded to the remote function.
 
             Returns:
-                A [`modal.FunctionCall`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall) object
+                A [`modal.FunctionCall`](https://modal.com/docs/sdk/py/latest/FunctionCall) object
                 that can later be polled or waited for using
-                [`.get(timeout=...)`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall#get).
+                [`.get(timeout=...)`](https://modal.com/docs/sdk/py/latest/FunctionCall#get).
             """
             ...
 
@@ -1049,7 +1049,7 @@ class FunctionCall(typing.Generic[modal._functions.ReturnType], modal.object.Obj
             Note: the call graph data is not populated in real-time, and its capture is best-effort.
             We do not recommend relying on this method for critical use cases.
 
-            See the [`modal.types`](/docs/sdk/py/latest/modal.types) reference for information
+            See the [`modal.types`](/docs/sdk/py/latest/types) reference for information
             on the return values.
 
             Returns:
@@ -1063,7 +1063,7 @@ class FunctionCall(typing.Generic[modal._functions.ReturnType], modal.object.Obj
             Note: the call graph data is not populated in real-time, and its capture is best-effort.
             We do not recommend relying on this method for critical use cases.
 
-            See the [`modal.types`](/docs/sdk/py/latest/modal.types) reference for information
+            See the [`modal.types`](/docs/sdk/py/latest/types) reference for information
             on the return values.
 
             Returns:

{modal-1.5.3.dev7 → modal-1.5.3.dev11}/modal/partial_function.pyi

@@ -169,7 +169,7 @@ def wsgi_app(
     Web Server Gateway Interface (WSGI) is a standard for synchronous Python web apps.
     It has been [succeeded by the ASGI interface](https://asgi.readthedocs.io/en/latest/introduction.html#wsgi-compatibility)
     which is compatible with ASGI and supports additional functionality such as web sockets.
-    Modal supports ASGI via [`asgi_app`](https://modal.com/docs/sdk/py/latest/modal.asgi_app).
+    Modal supports ASGI via [`asgi_app`](https://modal.com/docs/sdk/py/latest/asgi_app).
 
     Examples:
         ```python