modal 1.0.6.dev51__py3-none-any.whl → 1.0.6.dev52__py3-none-any.whl

modal/client.pyi

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

modal/sandbox.py

@@ -21,6 +21,7 @@ from ._object import _get_environment_name, _Object
 from ._resolver import Resolver
 from ._resources import convert_fn_config_to_resources_config
 from ._utils.async_utils import TaskContext, synchronize_api
+from ._utils.deprecation import deprecation_warning
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.mount_utils import validate_network_file_systems, validate_volumes
 from .client import _Client
@@ -216,10 +217,7 @@ class _Sandbox(_Object, type_prefix="sb"):
                 verbose=verbose,
             )
 
-            # Note - `resolver.app_id` will be `None` for app-less sandboxes
-            create_req = api_pb2.SandboxCreateRequest(
-                app_id=resolver.app_id, definition=definition, environment_name=resolver.environment_name
-            )
+            create_req = api_pb2.SandboxCreateRequest(app_id=resolver.app_id, definition=definition)
             create_resp = await retry_transient_errors(resolver.client.stub.SandboxCreate, create_req)
 
             sandbox_id = create_resp.sandbox_id
@@ -231,7 +229,6 @@ class _Sandbox(_Object, type_prefix="sb"):
     async def create(
         *entrypoint_args: str,
         app: Optional["modal.app._App"] = None,  # Optionally associate the sandbox with an app
-        environment_name: Optional[str] = None,  # Optionally override the default environment
         image: Optional[_Image] = None,  # The image to run as the container for the sandbox.
         secrets: Sequence[_Secret] = (),  # Environment variables to inject into the sandbox.
         network_file_systems: dict[Union[str, os.PathLike], _NetworkFileSystem] = {},
@@ -270,6 +267,7 @@ class _Sandbox(_Object, type_prefix="sb"):
             SchedulerPlacement
         ] = None,  # Experimental controls over fine-grained scheduling (alpha).
         client: Optional[_Client] = None,
+        environment_name: Optional[str] = None,  # *DEPRECATED* Optionally override the default environment
     ) -> "_Sandbox":
         """
         Create a new Sandbox to run untrusted, arbitrary code. The Sandbox's corresponding container
@@ -284,10 +282,16 @@ class _Sandbox(_Object, type_prefix="sb"):
         sandbox.wait()
         ```
         """
+        if environment_name is not None:
+            deprecation_warning(
+                (2025, 7, 16),
+                "Passing `environment_name` to `Sandbox.create` is deprecated and will be removed in a future release.",
+                "A sandbox's environment is determined by the app it is associated with.",
+            )
+
         return await _Sandbox._create(
             *entrypoint_args,
             app=app,
-            environment_name=environment_name,
             image=image,
             secrets=secrets,
             network_file_systems=network_file_systems,
@@ -316,7 +320,6 @@ class _Sandbox(_Object, type_prefix="sb"):
     async def _create(
         *entrypoint_args: str,
         app: Optional["modal.app._App"] = None,  # Optionally associate the sandbox with an app
-        environment_name: Optional[str] = None,  # Optionally override the default environment
         image: Optional[_Image] = None,  # The image to run as the container for the sandbox.
         secrets: Sequence[_Secret] = (),  # Environment variables to inject into the sandbox.
         mounts: Sequence[_Mount] = (),
@@ -361,8 +364,6 @@ class _Sandbox(_Object, type_prefix="sb"):
         # sandbox that runs the shell session
         from .app import _App
 
-        environment_name = _get_environment_name(environment_name)
-
         _validate_exec_args(entrypoint_args)
 
         # TODO(erikbern): Get rid of the `_new` method and create an already-hydrated object
@@ -422,7 +423,7 @@ class _Sandbox(_Object, type_prefix="sb"):
 
         client = client or app_client or await _Client.from_env()
 
-        resolver = Resolver(client, environment_name=environment_name, app_id=app_id)
+        resolver = Resolver(client, app_id=app_id)
         await resolver.load(obj)
         return obj
 

modal/sandbox.pyi

@@ -78,7 +78,6 @@ class _Sandbox(modal._object._Object):
     async def create(
         *entrypoint_args: str,
         app: typing.Optional[modal.app._App] = None,
-        environment_name: typing.Optional[str] = None,
         image: typing.Optional[modal.image._Image] = None,
         secrets: collections.abc.Sequence[modal.secret._Secret] = (),
         network_file_systems: dict[typing.Union[str, os.PathLike], modal.network_file_system._NetworkFileSystem] = {},
@@ -104,6 +103,7 @@ class _Sandbox(modal._object._Object):
         _experimental_enable_snapshot: bool = False,
         _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
         client: typing.Optional[modal.client._Client] = None,
+        environment_name: typing.Optional[str] = None,
     ) -> _Sandbox:
         """Create a new Sandbox to run untrusted, arbitrary code. The Sandbox's corresponding container
         will be created asynchronously.
@@ -123,7 +123,6 @@ class _Sandbox(modal._object._Object):
     async def _create(
         *entrypoint_args: str,
         app: typing.Optional[modal.app._App] = None,
-        environment_name: typing.Optional[str] = None,
         image: typing.Optional[modal.image._Image] = None,
         secrets: collections.abc.Sequence[modal.secret._Secret] = (),
         mounts: collections.abc.Sequence[modal.mount._Mount] = (),
@@ -362,7 +361,6 @@ class Sandbox(modal.object.Object):
             /,
             *entrypoint_args: str,
             app: typing.Optional[modal.app.App] = None,
-            environment_name: typing.Optional[str] = None,
             image: typing.Optional[modal.image.Image] = None,
             secrets: collections.abc.Sequence[modal.secret.Secret] = (),
             network_file_systems: dict[
@@ -390,6 +388,7 @@ class Sandbox(modal.object.Object):
             _experimental_enable_snapshot: bool = False,
             _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
             client: typing.Optional[modal.client.Client] = None,
+            environment_name: typing.Optional[str] = None,
         ) -> Sandbox:
             """Create a new Sandbox to run untrusted, arbitrary code. The Sandbox's corresponding container
             will be created asynchronously.
@@ -410,7 +409,6 @@ class Sandbox(modal.object.Object):
             /,
             *entrypoint_args: str,
             app: typing.Optional[modal.app.App] = None,
-            environment_name: typing.Optional[str] = None,
             image: typing.Optional[modal.image.Image] = None,
             secrets: collections.abc.Sequence[modal.secret.Secret] = (),
             network_file_systems: dict[
@@ -438,6 +436,7 @@ class Sandbox(modal.object.Object):
             _experimental_enable_snapshot: bool = False,
             _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
             client: typing.Optional[modal.client.Client] = None,
+            environment_name: typing.Optional[str] = None,
         ) -> Sandbox:
             """Create a new Sandbox to run untrusted, arbitrary code. The Sandbox's corresponding container
             will be created asynchronously.
@@ -461,7 +460,6 @@ class Sandbox(modal.object.Object):
             /,
             *entrypoint_args: str,
             app: typing.Optional[modal.app.App] = None,
-            environment_name: typing.Optional[str] = None,
             image: typing.Optional[modal.image.Image] = None,
             secrets: collections.abc.Sequence[modal.secret.Secret] = (),
             mounts: collections.abc.Sequence[modal.mount.Mount] = (),
@@ -496,7 +494,6 @@ class Sandbox(modal.object.Object):
             /,
             *entrypoint_args: str,
             app: typing.Optional[modal.app.App] = None,
-            environment_name: typing.Optional[str] = None,
             image: typing.Optional[modal.image.Image] = None,
             secrets: collections.abc.Sequence[modal.secret.Secret] = (),
             mounts: collections.abc.Sequence[modal.mount.Mount] = (),

{modal-1.0.6.dev51.dist-info → modal-1.0.6.dev52.dist-info}/METADATA

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

{modal-1.0.6.dev51.dist-info → modal-1.0.6.dev52.dist-info}/RECORD

@@ -22,7 +22,7 @@ modal/app.py,sha256=U0sPiHpphcRHLnoLYh2IrU2RSpRFX9BE5uHb7h42STs,47478
 modal/app.pyi,sha256=cXiSTu2bwu6csAUdkOlh7mr9tPvtaS2qWSEhlC1UxAg,43787
 modal/call_graph.py,sha256=1g2DGcMIJvRy-xKicuf63IVE98gJSnQsr8R_NVMptNc,2581
 modal/client.py,sha256=5QyM7VJjsFbHf6E91ar3A2KY9mx03wdtGlNJvfTKUVs,17087
-modal/client.pyi,sha256=55x6Dnv6_SRFBUy8ypQk222KrtPkt_gwNh3H0xv_ZH8,15270
+modal/client.pyi,sha256=lmGPzV9ouW3RV7oT8CfmFuQdRbirKUv6ZEUDb4kEBNo,15270
 modal/cloud_bucket_mount.py,sha256=YOe9nnvSr4ZbeCn587d7_VhE9IioZYRvF9VYQTQux08,5914
 modal/cloud_bucket_mount.pyi,sha256=-qSfYAQvIoO_l2wsCCGTG5ZUwQieNKXdAO00yP1-LYU,7394
 modal/cls.py,sha256=B5EtzpBXemH718YvgXaYjuTKvairvqfXJ7IwLZ_6vVA,40034
@@ -65,8 +65,8 @@ modal/retries.py,sha256=IvNLDM0f_GLUDD5VgEDoN09C88yoxSrCquinAuxT1Sc,5205
 modal/runner.py,sha256=ostdzYpQb-20tlD6dIq7bpWTkZkOhjJBNuMNektqnJA,24068
 modal/runner.pyi,sha256=lbwLljm1cC8d6PcNvmYQhkE8501V9fg0bYqqKX6G4r4,8489
 modal/running_app.py,sha256=v61mapYNV1-O-Uaho5EfJlryMLvIT9We0amUOSvSGx8,1188
-modal/sandbox.py,sha256=hKuGVBB-JTn-Oq4hCxNS3rR6ismQ_TgcSKZv5--iDz8,37584
-modal/sandbox.pyi,sha256=AyROza8ZUUxs6MO1f3l8zDjTkp6O46H132xUwBUixIc,38565
+modal/sandbox.py,sha256=77dRA1JTuohI4sONDMdpvDv8QGnQ-yd96baJmMyxEhg,37585
+modal/sandbox.pyi,sha256=hOcdNZ3j5MlPaNZ4NAnoc31BQ1fZqQrEBWnD3m7ZxJg,38392
 modal/schedule.py,sha256=ng0g0AqNY5GQI9KhkXZQ5Wam5G42glbkqVQsNpBtbDE,3078
 modal/scheduler_placement.py,sha256=BAREdOY5HzHpzSBqt6jDVR6YC_jYfHMVqOzkyqQfngU,1235
 modal/secret.py,sha256=bpgtv0urwaBOmmJpMTZIwVWUraQlpeu4hW8pbJiGcOA,10546
@@ -151,7 +151,7 @@ modal/requirements/2025.06.txt,sha256=KxDaVTOwatHvboDo4lorlgJ7-n-MfAwbPwxJ0zcJqr
 modal/requirements/PREVIEW.txt,sha256=KxDaVTOwatHvboDo4lorlgJ7-n-MfAwbPwxJ0zcJqrs,312
 modal/requirements/README.md,sha256=9tK76KP0Uph7O0M5oUgsSwEZDj5y-dcUPsnpR0Sc-Ik,854
 modal/requirements/base-images.json,sha256=JYSDAgHTl-WrV_TZW5icY-IJEnbe2eQ4CZ_KN6EOZKU,1304
-modal-1.0.6.dev51.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.0.6.dev52.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
 modal_docs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal_docs/gen_cli_docs.py,sha256=c1yfBS_x--gL5bs0N4ihMwqwX8l3IBWSkBAKNNIi6bQ,3801
 modal_docs/gen_reference_docs.py,sha256=d_CQUGQ0rfw28u75I2mov9AlS773z9rG40-yq5o7g2U,6359
@@ -159,10 +159,10 @@ modal_docs/mdmd/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,2
 modal_docs/mdmd/mdmd.py,sha256=eW5MzrEl7mSclDo4Uv64sQ1-4IyLggldbgUJdBVLDdI,6449
 modal_docs/mdmd/signatures.py,sha256=XJaZrK7Mdepk5fdX51A8uENiLFNil85Ud0d4MH8H5f0,3218
 modal_proto/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0VESpjWR0fc,28
-modal_proto/api.proto,sha256=lKYbgeyu0zzBT-WhJfBE7C3fbSddqn-5UnOtOJ6SYRw,99610
+modal_proto/api.proto,sha256=ZtaJsKz1QBSoLPFfQlm4wWfzA4nwfmLrBX5JUoJaGoI,99686
 modal_proto/api_grpc.py,sha256=F7Hu-1Yg7p5a2SbKw9yR4AgpyU0ntvgZTaVbIJMR0DE,122366
-modal_proto/api_pb2.py,sha256=MgRY5QKtmpFspfXDIbV02haf85AaajQZb-1XMetwz2I,349756
-modal_proto/api_pb2.pyi,sha256=28oUvJCAp8ehfBPP_Mw-v0Sh8sA__o3ioB8eLLlKJBs,476854
+modal_proto/api_pb2.py,sha256=55fetV2PE1yQ2eChjhd9ACXqApBR-gYfkzFx4z9tjr8,349839
+modal_proto/api_pb2.pyi,sha256=cNkDtLG_wv-Etkr_hJAwl1zqCPEmuOZPI3xdVNP3k6U,477167
 modal_proto/api_pb2_grpc.py,sha256=pIFrNmCOgRRcIW8A1Ekja9Po6fHcsj54ExDZFzTpYe4,264347
 modal_proto/api_pb2_grpc.pyi,sha256=vtxrQ9xnQG6ZRXjp2uk43Mb7wV7F4qGYuVl5JUBc8jI,61968
 modal_proto/modal_api_grpc.py,sha256=Yl_fGbSIuX2FAEnURkYpKqshs7kbNqtz5HlTJEXkbhE,18487
@@ -174,10 +174,10 @@ modal_proto/options_pb2.pyi,sha256=l7DBrbLO7q3Ir-XDkWsajm0d0TQqqrfuX54i4BMpdQg,1
 modal_proto/options_pb2_grpc.py,sha256=1oboBPFxaTEXt9Aw7EAj8gXHDCNMhZD2VXqocC9l_gk,159
 modal_proto/options_pb2_grpc.pyi,sha256=CImmhxHsYnF09iENPoe8S4J-n93jtgUYD2JPAc0yJSI,247
 modal_proto/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-modal_version/__init__.py,sha256=2v61QuSe8pQj__81WjWlBsFvbT8sURDSbfWlGv0YX8c,121
+modal_version/__init__.py,sha256=1Khd-4yRHbEhjcI-2bNwD3ryd9flpcpG8FnJneY0Uj8,121
 modal_version/__main__.py,sha256=2FO0yYQQwDTh6udt1h-cBnGd1c4ZyHnHSI4BksxzVac,105
-modal-1.0.6.dev51.dist-info/METADATA,sha256=mC9aGJCHfAlK5fgKkZXdC8AiZnS4EPJLCNyxfv4FzLU,2462
-modal-1.0.6.dev51.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-modal-1.0.6.dev51.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.0.6.dev51.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.0.6.dev51.dist-info/RECORD,,
+modal-1.0.6.dev52.dist-info/METADATA,sha256=C7oTd14MU6My_N8EI_EXH73P9VTX7Q_DW0IOhgn5dT4,2462
+modal-1.0.6.dev52.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+modal-1.0.6.dev52.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.0.6.dev52.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.0.6.dev52.dist-info/RECORD,,

modal_proto/api.proto

@@ -2525,7 +2525,7 @@ message Sandbox {
 message SandboxCreateRequest {
   string app_id = 1 [ (modal.options.audit_target_attr) = true ];
   Sandbox definition = 2;
-  string environment_name = 3;
+  string environment_name = 3; // *DEPRECATED* 7/16/2025
 }
 
 message SandboxCreateResponse {
@@ -2535,6 +2535,7 @@ message SandboxCreateResponse {
 message SandboxGetFromNameRequest {
   string sandbox_name = 1;
   string environment_name = 2;
+  string app_name = 3;
 }
 
 message SandboxGetFromNameResponse {
@@ -2609,6 +2610,7 @@ message SandboxListResponse {
 
 message SandboxRestoreRequest {
   string snapshot_id = 1;
+  string sandbox_name = 2;
 }
 
 message SandboxRestoreResponse {