modal 1.5.3.dev1__tar.gz → 1.5.3.dev3__tar.gz

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/PKG-INFO

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

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/_functions.py

@@ -627,6 +627,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
     _metadata: api_pb2.FunctionHandleMetadata | None = None
     _options: _FunctionOptions
     _base_function: "_Function | None" = None
+    _app_id: str | None = None
 
     @staticmethod
     def from_local(
@@ -671,6 +672,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         # Experimental: Clustered functions
         cluster_size: int | None = None,
         rdma: bool | None = None,
+        fabric_size: int | None = None,
         single_use_containers: bool = False,
         ephemeral_disk: int | None = None,
         include_source: bool = True,
@@ -1009,6 +1011,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
                     mount_client_dependencies=mount_client_dependencies,
                     # ---
                     _experimental_group_size=cluster_size or 0,  # Experimental: Clustered functions
+                    _experimental_fabric_size=fabric_size or 0,  # Experimental: Clustered functions
                     _experimental_concurrent_cancellations=True,
                     # --- These are deprecated in favor of autoscaler_settings
                     warm_pool_size=min_containers or 0,
@@ -1051,6 +1054,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
                         method_definitions_set=function_definition.method_definitions_set,
                         experimental_options=experimental_options or {},
                         _experimental_group_size=function_definition._experimental_group_size,
+                        _experimental_fabric_size=function_definition._experimental_fabric_size,
                         _experimental_buffer_containers=function_definition._experimental_buffer_containers,
                         _experimental_custom_scaling=function_definition._experimental_custom_scaling,
                         snapshot_debug=function_definition.snapshot_debug,
@@ -1400,6 +1404,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
             metadata.max_object_size_bytes if metadata.HasField("max_object_size_bytes") else MAX_OBJECT_SIZE_BYTES
         )
         self._experimental_flash_urls = metadata._experimental_flash_urls
+        self._app_id = metadata.app_id or None
 
         # Invalidate the Function variant cache when we load new metadata, since the base Function handle
         # is now in sync with the server but any previously-cached variants may be stale.
@@ -1409,6 +1414,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         # Overridden concrete implementation of base class method
         assert self._function_name, f"Function name must be set before metadata can be retrieved for {self}"
         return api_pb2.FunctionHandleMetadata(
+            app_id=self._app_id or "",
             function_name=self._function_name,
             function_type=get_function_type(self._is_generator),
             web_url=self._web_url or "",
@@ -1670,6 +1676,8 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         )
         fc: _FunctionCall[ReturnType] = _FunctionCall._new_hydrated(function_call_id, self.client, None)
         fc._num_inputs = num_inputs  # set the cached value of num_inputs
+        fc._app_id = self._app_id
+        fc._function_id = self.object_id
         return fc
 
     async def _call_function(self, args, kwargs) -> ReturnType:
@@ -1881,6 +1889,8 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
             invocation.function_call_id, invocation.client, None
         )
         fc._is_generator = self._is_generator if self._is_generator else False
+        fc._app_id = self._app_id
+        fc._function_id = self.object_id
         return fc
 
     @synchronizer.no_input_translation
@@ -1917,6 +1927,8 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         fc: _FunctionCall[ReturnType] = _FunctionCall._new_hydrated(
             invocation.function_call_id, invocation.client, None
         )
+        fc._app_id = self._app_id
+        fc._function_id = self.object_id
         return fc
 
     def get_raw_f(self) -> Callable[..., Any]:
@@ -1976,10 +1988,18 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
 
     _is_generator: bool = False
     _num_inputs: int | None = None
+    _app_id: str | None = None
+    _function_id: str | None = None
 
     def _invocation(self):
         return _Invocation(self.client.stub, self.object_id, self.client)
 
+    async def _hydrate_from_id_metadata(self) -> None:
+        """Hydrate metadata only when needed for FunctionCall fields."""
+        request = api_pb2.FunctionCallFromIdRequest(function_call_id=self.object_id)
+        resp = await self.client.stub.FunctionCallFromId(request)
+        self._hydrate_metadata(resp)
+
     @live_method
     async def num_inputs(self) -> int:
         """Get the number of inputs in the function call.
@@ -1988,9 +2008,8 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
             How many inputs this function call includes (e.g. `1` for `.spawn()`, more for `.spawn_map()`).
         """
         if self._num_inputs is None:
-            request = api_pb2.FunctionCallFromIdRequest(function_call_id=self.object_id)
-            resp = await self.client.stub.FunctionCallFromId(request)
-            self._num_inputs = resp.num_inputs  # cached
+            await self._hydrate_from_id_metadata()
+        assert self._num_inputs is not None
         return self._num_inputs
 
     @live_method
@@ -2132,6 +2151,13 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         )
         return typing.cast("modal.functions.FunctionCall[Any]", synchronizer._translate_out(impl_instance))
 
+    def _hydrate_metadata(self, metadata: Message | None):
+        # Overridden concrete implementation of base class method
+        if isinstance(metadata, api_pb2.FunctionCallFromIdResponse):
+            self._num_inputs = metadata.num_inputs
+            self._app_id = metadata.metadata.app_id or None
+            self._function_id = metadata.metadata.function_id or None
+
     @staticmethod
     async def gather(*function_calls: "_FunctionCall[T]") -> typing.Sequence[T]:
         """Wait until all Modal FunctionCall objects have results before returning.

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/_partial_function.py

@@ -74,6 +74,7 @@ class _PartialFunctionParams:
     target_concurrent_inputs: int | None = None
     build_timeout: int | None = None
     rdma: bool | None = None
+    fabric_size: int | None = None
     http_config: api_pb2.HTTPConfig | None = None
 
     def update(self, other: "_PartialFunctionParams") -> None:
@@ -777,7 +778,7 @@ def _concurrent(
 
 # NOTE: clustered is currently exposed through modal.experimental, not the top-level namespace
 def _clustered(
-    size: int, broadcast: bool = True, rdma: bool = False
+    size: int, broadcast: bool = True, rdma: bool = False, fabric_size: int | None = None
 ) -> Callable[
     [Callable[P, ReturnType] | _PartialFunction[P, ReturnType, ReturnType]],
     _PartialFunction[P, ReturnType, ReturnType],
@@ -791,6 +792,11 @@ def _clustered(
         If True, inputs will be sent simultaneously to each container. Otherwise,
         inputs will be sent only to the rank-0 container, which is responsible for
         delegating to the workers.
+    fabric_size: int | None = None
+        Experimental: constrains placement across GPU-memory fabrics. The cluster
+        is placed in co-fabric blocks of `fabric_size` containers, so every block
+        of `fabric_size` consecutive ranks shares a fabric (the scale-up domain)
+        and communicates over cross-node NVLink. Must evenly divide `size`.
     """
 
     assert broadcast, "broadcast=False has not been implemented yet!"
@@ -798,8 +804,14 @@ def _clustered(
     if size <= 0:
         raise ValueError("cluster size must be greater than 0")
 
+    if fabric_size is not None:
+        if not isinstance(fabric_size, int) or fabric_size <= 0:
+            raise ValueError("fabric_size must be a positive integer")
+        if size % fabric_size != 0:
+            raise ValueError(f"fabric_size must evenly divide the cluster size ({size} % {fabric_size} != 0)")
+
     flags = _PartialFunctionFlags.CLUSTERED
-    params = _PartialFunctionParams(cluster_size=size, rdma=rdma)
+    params = _PartialFunctionParams(cluster_size=size, rdma=rdma, fabric_size=fabric_size)
 
     def wrapper(
         obj: _PartialFunction[P, ReturnType, ReturnType] | Callable[P, ReturnType],

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/_utils/grpc_utils.py

@@ -325,7 +325,7 @@ def create_channel(
 async def create_channel_with_fallbacks(
     server_url: str,
     metadata: dict[str, str] = {},
-    stagger_delay: float = 1.0,
+    stagger_delay: float = 3.0,
 ) -> grpclib.client.Channel:
     """Create a connected channel, supporting comma-separated fallback URLs.
 

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/app.py

@@ -920,6 +920,7 @@ class _App:
                 i6pn_enabled = i6pn or (f.flags & _PartialFunctionFlags.CLUSTERED)
                 cluster_size = f.params.cluster_size  # Experimental: Clustered functions
                 rdma = f.params.rdma
+                fabric_size = f.params.fabric_size
 
                 info = FunctionInfo(f.raw_f, serialized=serialized, name_override=name)
                 raw_f = f.raw_f
@@ -974,6 +975,7 @@ class _App:
 
                 cluster_size = None  # Experimental: Clustered functions
                 rdma = None
+                fabric_size = None
                 i6pn_enabled = i6pn
 
             if is_generator is None:
@@ -1016,6 +1018,7 @@ class _App:
                 i6pn_enabled=i6pn_enabled,
                 cluster_size=cluster_size,  # Experimental: Clustered functions
                 rdma=rdma,
+                fabric_size=fabric_size,  # Experimental: Clustered functions
                 include_source=include_source if include_source is not None else local_state.include_source_default,
                 experimental_options={k: str(v) for k, v in (experimental_options or {}).items()},
                 restrict_output=_experimental_restrict_output,
@@ -1151,16 +1154,19 @@ class _App:
                 if wrapped_cls.flags & _PartialFunctionFlags.CLUSTERED:
                     cluster_size = wrapped_cls.params.cluster_size
                     rdma = wrapped_cls.params.rdma
+                    fabric_size = wrapped_cls.params.fabric_size
 
                 else:
                     cluster_size = None
                     rdma = None
+                    fabric_size = None
             else:
                 user_cls = wrapped_cls
                 max_concurrent_inputs = None
                 target_concurrent_inputs = None
                 cluster_size = None
                 rdma = None
+                fabric_size = None
             if not inspect.isclass(user_cls):
                 raise TypeError("The @app.cls decorator must be used on a class.")
 
@@ -1246,6 +1252,7 @@ class _App:
                 i6pn_enabled=i6pn_enabled,
                 cluster_size=cluster_size,
                 rdma=rdma,
+                fabric_size=fabric_size,
                 include_source=include_source if include_source is not None else local_state.include_source_default,
                 experimental_options={k: str(v) for k, v in (experimental_options or {}).items()},
                 restrict_output=_experimental_restrict_output,
@@ -1403,6 +1410,7 @@ class _App:
             # Extract the underlying class if wrapped in a _PartialFunction (e.g., from @modal.clustered())
             cluster_size = None
             rdma = None
+            fabric_size = None
             user_cls = wrapped_user_cls
 
             if isinstance(wrapped_user_cls, _PartialFunction):
@@ -1410,6 +1418,7 @@ class _App:
                 if wrapped_user_cls.flags & _PartialFunctionFlags.CLUSTERED:
                     cluster_size = wrapped_user_cls.params.cluster_size
                     rdma = wrapped_user_cls.params.rdma
+                    fabric_size = wrapped_user_cls.params.fabric_size
 
             local_state = self._local_state
 
@@ -1449,6 +1458,7 @@ class _App:
                 i6pn_enabled=i6pn or (cluster_size is not None),
                 cluster_size=cluster_size,
                 rdma=rdma,
+                fabric_size=fabric_size,
                 include_source=include_source if include_source is not None else local_state.include_source_default,
                 experimental_options={k: str(v) for k, v in (experimental_options or {}).items()},
                 restrict_output=False,

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/client.pyi

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

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/cls.py

@@ -86,6 +86,8 @@ def _bind_instance_method(cls: "_Cls", service_function: _Function, method_name:
 
         method_metadata = service_function._method_handle_metadata[method_name]
         new_function._hydrate(service_function.object_id, service_function.client, method_metadata)
+        if not new_function._app_id:
+            new_function._app_id = service_function._app_id
 
     async def _load(fun: "_Function", resolver: Resolver, load_context: LoadContext, existing_object_id: str | None):
         # there is currently no actual loading logic executed to create each method on
@@ -426,6 +428,7 @@ class _Obj:
                 )
             await resolver.load(method_function, load_context)  # get the appropriate method handle (lazy)
             fun._hydrate_from_other(method_function)
+            fun._app_id = method_function._app_id
 
         # The reason we don't *always* use this lazy loader is because it precludes attribute access
         # on local classes.

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/config.py

@@ -106,7 +106,8 @@ from modal_proto import api_pb2
 from ._utils.logger import configure_logger
 from .exception import InvalidError, NotFoundError
 
-DEFAULT_SERVER_URL = "https://api.modal.com"  # TODO(erikbern): add modal2.com
+# By default, try api.modal.com and fail over to api.modal2.com
+DEFAULT_SERVER_URL = "https://api.modal.com,https://api.modal2.com"
 
 
 # Locate config file and read it

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/functions.pyi

@@ -58,6 +58,7 @@ class Function(
     _metadata: typing.Optional[modal_proto.api_pb2.FunctionHandleMetadata]
     _options: modal._function_variants._FunctionOptions
     _base_function: typing.Optional[Function]
+    _app_id: typing.Optional[str]
 
     def __init__(self, *args, **kwargs):
         """mdmd:hidden"""
@@ -109,6 +110,7 @@ class Function(
         i6pn_enabled: bool = False,
         cluster_size: typing.Optional[int] = None,
         rdma: typing.Optional[bool] = None,
+        fabric_size: typing.Optional[int] = None,
         single_use_containers: bool = False,
         ephemeral_disk: typing.Optional[int] = None,
         include_source: bool = True,
@@ -491,7 +493,7 @@ class Function(
 
     _call_generator: ___call_generator_spec
 
-    class __remote_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
+    class __remote_spec(typing_extensions.Protocol[ReturnType_INNER, P_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.
 
@@ -516,7 +518,7 @@ class Function(
             """
             ...
 
-    remote: __remote_spec[modal._functions.P, modal._functions.ReturnType]
+    remote: __remote_spec[modal._functions.ReturnType, modal._functions.P]
 
     class __remote_gen_spec(typing_extensions.Protocol):
         def __call__(self, /, *args, **kwargs) -> typing.Generator[typing.Any, None, None]:
@@ -566,7 +568,7 @@ class Function(
         """
         ...
 
-    class ___experimental_spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
+    class ___experimental_spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_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.
 
@@ -599,7 +601,7 @@ class Function(
             """
             ...
 
-    _experimental_spawn: ___experimental_spawn_spec[modal._functions.P, modal._functions.ReturnType]
+    _experimental_spawn: ___experimental_spawn_spec[modal._functions.ReturnType, modal._functions.P]
 
     class ___spawn_map_inner_spec(typing_extensions.Protocol[P_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> None: ...
@@ -607,7 +609,7 @@ class Function(
 
     _spawn_map_inner: ___spawn_map_inner_spec[modal._functions.P]
 
-    class __spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
+    class __spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_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.
 
@@ -640,7 +642,7 @@ class Function(
             """
             ...
 
-    spawn: __spawn_spec[modal._functions.P, modal._functions.ReturnType]
+    spawn: __spawn_spec[modal._functions.ReturnType, modal._functions.P]
 
     def get_raw_f(self) -> collections.abc.Callable[..., typing.Any]:
         """Return the inner Python object wrapped by this Modal Function.
@@ -891,6 +893,8 @@ class FunctionCall(typing.Generic[modal._functions.ReturnType], modal.object.Obj
 
     _is_generator: bool
     _num_inputs: typing.Optional[int]
+    _app_id: typing.Optional[str]
+    _function_id: typing.Optional[str]
 
     def __init__(self, *args, **kwargs):
         """mdmd:hidden"""
@@ -898,6 +902,17 @@ class FunctionCall(typing.Generic[modal._functions.ReturnType], modal.object.Obj
 
     def _invocation(self): ...
 
+    class ___hydrate_from_id_metadata_spec(typing_extensions.Protocol):
+        def __call__(self, /) -> None:
+            """Hydrate metadata only when needed for FunctionCall fields."""
+            ...
+
+        async def aio(self, /) -> None:
+            """Hydrate metadata only when needed for FunctionCall fields."""
+            ...
+
+    _hydrate_from_id_metadata: ___hydrate_from_id_metadata_spec
+
     class __num_inputs_spec(typing_extensions.Protocol):
         def __call__(self, /) -> int:
             """Get the number of inputs in the function call.
@@ -1114,6 +1129,8 @@ class FunctionCall(typing.Generic[modal._functions.ReturnType], modal.object.Obj
 
     from_id: typing.ClassVar[__from_id_spec]
 
+    def _hydrate_metadata(self, metadata: typing.Optional[google.protobuf.message.Message]): ...
+
     class __gather_spec(typing_extensions.Protocol):
         def __call__(self, /, *function_calls: FunctionCall[modal._functions.T]) -> typing.Sequence[modal._functions.T]:
             """Wait until all Modal FunctionCall objects have results before returning.

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/sandbox.py

@@ -349,7 +349,7 @@ class _Sandbox(_Object, type_prefix="sb"):
         gpu: str | None = None,
         cloud: str | None = None,
         region: str | Sequence[str] | None = None,
-        cpu: float | None = None,
+        cpu: float | tuple[float, float] | None = None,
         memory: int | tuple[int, int] | None = None,
         mounts: Sequence[_Mount] = (),
         network_file_systems: dict[str | os.PathLike, _NetworkFileSystem] = {},
@@ -823,8 +823,8 @@ class _Sandbox(_Object, type_prefix="sb"):
         timeout: int = 300,
         idle_timeout: int | None = None,
         workdir: str | None = None,
-        cpu: float | None = None,
-        memory: int | None = None,
+        cpu: float | tuple[float, float] | None = None,
+        memory: int | tuple[int, int] | None = None,
         cloud: str | None = None,
         region: str | Sequence[str] | None = None,
         block_network: bool = False,
@@ -852,6 +852,10 @@ class _Sandbox(_Object, type_prefix="sb"):
         `secret=...` or `oidc_auth_role_arn`), OIDC identity tokens, proxies, and
         filesystem snapshots.
 
+        `cpu` and `memory` accept either a scalar request or a `(request, limit)`
+        tuple that additionally sets a hard limit (fractional CPU cores; memory
+        in MiB), matching `Sandbox.create()`.
+
         Features like memory snapshots, network file systems, GPUs, and custom
         domains are not supported.
 

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal/sandbox.pyi

@@ -165,7 +165,7 @@ class _Sandbox(modal._object._Object):
         gpu: typing.Optional[str] = None,
         cloud: typing.Optional[str] = None,
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
-        cpu: typing.Optional[float] = None,
+        cpu: typing.Union[float, tuple[float, float], None] = None,
         memory: typing.Union[int, tuple[int, int], None] = None,
         mounts: collections.abc.Sequence[modal.mount._Mount] = (),
         network_file_systems: dict[typing.Union[str, os.PathLike], modal.network_file_system._NetworkFileSystem] = {},
@@ -368,8 +368,8 @@ class _Sandbox(modal._object._Object):
         timeout: int = 300,
         idle_timeout: typing.Optional[int] = None,
         workdir: typing.Optional[str] = None,
-        cpu: typing.Optional[float] = None,
-        memory: typing.Optional[int] = None,
+        cpu: typing.Union[float, tuple[float, float], None] = None,
+        memory: typing.Union[int, tuple[int, int], None] = None,
         cloud: typing.Optional[str] = None,
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
         block_network: bool = False,
@@ -400,6 +400,10 @@ class _Sandbox(modal._object._Object):
         `secret=...` or `oidc_auth_role_arn`), OIDC identity tokens, proxies, and
         filesystem snapshots.
 
+        `cpu` and `memory` accept either a scalar request or a `(request, limit)`
+        tuple that additionally sets a hard limit (fractional CPU cores; memory
+        in MiB), matching `Sandbox.create()`.
+
         Features like memory snapshots, network file systems, GPUs, and custom
         domains are not supported.
 
@@ -1337,7 +1341,7 @@ class Sandbox(modal.object.Object):
         gpu: typing.Optional[str] = None,
         cloud: typing.Optional[str] = None,
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
-        cpu: typing.Optional[float] = None,
+        cpu: typing.Union[float, tuple[float, float], None] = None,
         memory: typing.Union[int, tuple[int, int], None] = None,
         mounts: collections.abc.Sequence[modal.mount.Mount] = (),
         network_file_systems: dict[typing.Union[str, os.PathLike], modal.network_file_system.NetworkFileSystem] = {},
@@ -1721,8 +1725,8 @@ class Sandbox(modal.object.Object):
             timeout: int = 300,
             idle_timeout: typing.Optional[int] = None,
             workdir: typing.Optional[str] = None,
-            cpu: typing.Optional[float] = None,
-            memory: typing.Optional[int] = None,
+            cpu: typing.Union[float, tuple[float, float], None] = None,
+            memory: typing.Union[int, tuple[int, int], None] = None,
             cloud: typing.Optional[str] = None,
             region: typing.Union[str, collections.abc.Sequence[str], None] = None,
             block_network: bool = False,
@@ -1753,6 +1757,10 @@ class Sandbox(modal.object.Object):
             `secret=...` or `oidc_auth_role_arn`), OIDC identity tokens, proxies, and
             filesystem snapshots.
 
+            `cpu` and `memory` accept either a scalar request or a `(request, limit)`
+            tuple that additionally sets a hard limit (fractional CPU cores; memory
+            in MiB), matching `Sandbox.create()`.
+
             Features like memory snapshots, network file systems, GPUs, and custom
             domains are not supported.
 
@@ -1783,8 +1791,8 @@ class Sandbox(modal.object.Object):
             timeout: int = 300,
             idle_timeout: typing.Optional[int] = None,
             workdir: typing.Optional[str] = None,
-            cpu: typing.Optional[float] = None,
-            memory: typing.Optional[int] = None,
+            cpu: typing.Union[float, tuple[float, float], None] = None,
+            memory: typing.Union[int, tuple[int, int], None] = None,
             cloud: typing.Optional[str] = None,
             region: typing.Union[str, collections.abc.Sequence[str], None] = None,
             block_network: bool = False,
@@ -1815,6 +1823,10 @@ class Sandbox(modal.object.Object):
             `secret=...` or `oidc_auth_role_arn`), OIDC identity tokens, proxies, and
             filesystem snapshots.
 
+            `cpu` and `memory` accept either a scalar request or a `(request, limit)`
+            tuple that additionally sets a hard limit (fractional CPU cores; memory
+            in MiB), matching `Sandbox.create()`.
+
             Features like memory snapshots, network file systems, GPUs, and custom
             domains are not supported.
 

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal.egg-info/PKG-INFO

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

{modal-1.5.3.dev1 → modal-1.5.3.dev3}/modal_proto/api_grpc.py

@@ -639,6 +639,10 @@ class ModalClientBase(abc.ABC):
     async def SandboxRestore(self, stream: 'grpclib.server.Stream[modal_proto.api_pb2.SandboxRestoreRequest, modal_proto.api_pb2.SandboxRestoreResponse]') -> None:
         pass
 
+    @abc.abstractmethod
+    async def SandboxSetName(self, stream: 'grpclib.server.Stream[modal_proto.api_pb2.SandboxSetNameRequest, modal_proto.api_pb2.SandboxSetNameResponse]') -> None:
+        pass
+
     @abc.abstractmethod
     async def SandboxSnapshot(self, stream: 'grpclib.server.Stream[modal_proto.api_pb2.SandboxSnapshotRequest, modal_proto.api_pb2.SandboxSnapshotResponse]') -> None:
         pass
@@ -1871,6 +1875,12 @@ class ModalClientBase(abc.ABC):
                 modal_proto.api_pb2.SandboxRestoreRequest,
                 modal_proto.api_pb2.SandboxRestoreResponse,
             ),
+            '/modal.client.ModalClient/SandboxSetName': grpclib.const.Handler(
+                self.SandboxSetName,
+                grpclib.const.Cardinality.UNARY_UNARY,
+                modal_proto.api_pb2.SandboxSetNameRequest,
+                modal_proto.api_pb2.SandboxSetNameResponse,
+            ),
             '/modal.client.ModalClient/SandboxSnapshot': grpclib.const.Handler(
                 self.SandboxSnapshot,
                 grpclib.const.Cardinality.UNARY_UNARY,
@@ -3257,6 +3267,12 @@ class ModalClientStub:
             modal_proto.api_pb2.SandboxRestoreRequest,
             modal_proto.api_pb2.SandboxRestoreResponse,
         )
+        self.SandboxSetName = grpclib.client.UnaryUnaryMethod(
+            channel,
+            '/modal.client.ModalClient/SandboxSetName',
+            modal_proto.api_pb2.SandboxSetNameRequest,
+            modal_proto.api_pb2.SandboxSetNameResponse,
+        )
         self.SandboxSnapshot = grpclib.client.UnaryUnaryMethod(
             channel,
             '/modal.client.ModalClient/SandboxSnapshot',