modal 0.77.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

modal/mount.pyi

@@ -308,7 +308,6 @@ def _create_client_mount(): ...
 def create_client_mount(): ...
 def _get_client_mount(): ...
 def _is_modal_path(remote_path: pathlib.PurePosixPath): ...
-def get_sys_modules_mounts() -> dict[str, _Mount]: ...
 
 ROOT_DIR: pathlib.PurePosixPath
 

modal/network_file_system.py

@@ -22,7 +22,7 @@ from ._object import (
 from ._resolver import Resolver
 from ._utils.async_utils import TaskContext, aclosing, async_map, sync_or_async_iter, synchronize_api
 from ._utils.blob_utils import LARGE_FILE_LIMIT, blob_iter, blob_upload_file
-from ._utils.deprecation import deprecation_warning, renamed_parameter
+from ._utils.deprecation import deprecation_warning
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.hash_utils import get_sha256_hex
 from ._utils.name_utils import check_object_name
@@ -89,7 +89,6 @@ class _NetworkFileSystem(_Object, type_prefix="sv"):
     """
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     def from_name(
         name: str,
         *,
@@ -166,7 +165,6 @@ class _NetworkFileSystem(_Object, type_prefix="sv"):
             yield cls._new_hydrated(response.shared_volume_id, client, None, is_another_app=True)
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     async def lookup(
         name: str,
         namespace=api_pb2.DEPLOYMENT_NAMESPACE_WORKSPACE,
@@ -174,7 +172,8 @@ class _NetworkFileSystem(_Object, type_prefix="sv"):
         environment_name: Optional[str] = None,
         create_if_missing: bool = False,
     ) -> "_NetworkFileSystem":
-        """Lookup a named NetworkFileSystem.
+        """mdmd:hidden
+        Lookup a named NetworkFileSystem.
 
         DEPRECATED: This method is deprecated in favor of `modal.NetworkFileSystem.from_name`.
 
@@ -222,7 +221,6 @@ class _NetworkFileSystem(_Object, type_prefix="sv"):
         return resp.shared_volume_id
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     async def delete(name: str, client: Optional[_Client] = None, environment_name: Optional[str] = None):
         obj = await _NetworkFileSystem.from_name(name, environment_name=environment_name).hydrate(client)
         req = api_pb2.SharedVolumeDeleteRequest(shared_volume_id=obj.object_id)

modal/object.pyi

@@ -124,12 +124,6 @@ class Object:
     @property
     def deps(self) -> collections.abc.Callable[..., collections.abc.Sequence[Object]]: ...
 
-    class __resolve_spec(typing_extensions.Protocol[SUPERSELF]):
-        def __call__(self, /, client: typing.Optional[modal.client.Client] = None): ...
-        async def aio(self, /, client: typing.Optional[modal.client.Client] = None): ...
-
-    resolve: __resolve_spec[typing_extensions.Self]
-
     class __hydrate_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self, /, client: typing.Optional[modal.client.Client] = None) -> SUPERSELF: ...
         async def aio(self, /, client: typing.Optional[modal.client.Client] = None) -> SUPERSELF: ...

modal/queue.py

@@ -14,7 +14,7 @@ from ._object import EPHEMERAL_OBJECT_HEARTBEAT_SLEEP, _get_environment_name, _O
 from ._resolver import Resolver
 from ._serialization import deserialize, serialize
 from ._utils.async_utils import TaskContext, synchronize_api, warn_if_generator_is_not_consumed
-from ._utils.deprecation import deprecation_warning, renamed_parameter
+from ._utils.deprecation import deprecation_warning
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.name_utils import check_object_name
 from .client import _Client
@@ -145,7 +145,6 @@ class _Queue(_Object, type_prefix="qu"):
             yield cls._new_hydrated(response.queue_id, client, None, is_another_app=True)
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     def from_name(
         name: str,
         *,
@@ -179,7 +178,6 @@ class _Queue(_Object, type_prefix="qu"):
         return _Queue._from_loader(_load, "Queue()", is_another_app=True, hydrate_lazily=True)
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     async def lookup(
         name: str,
         namespace=api_pb2.DEPLOYMENT_NAMESPACE_WORKSPACE,
@@ -187,7 +185,8 @@ class _Queue(_Object, type_prefix="qu"):
         environment_name: Optional[str] = None,
         create_if_missing: bool = False,
     ) -> "_Queue":
-        """Lookup a named Queue.
+        """mdmd:hidden
+        Lookup a named Queue.
 
         DEPRECATED: This method is deprecated in favor of `modal.Queue.from_name`.
 
@@ -215,7 +214,6 @@ class _Queue(_Object, type_prefix="qu"):
         return obj
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     async def delete(name: str, *, client: Optional[_Client] = None, environment_name: Optional[str] = None):
         obj = await _Queue.from_name(name, environment_name=environment_name).hydrate(client)
         req = api_pb2.QueueDeleteRequest(queue_id=obj.object_id)

modal/runner.py

@@ -27,7 +27,6 @@ from ._pty import get_pty_info
 from ._resolver import Resolver
 from ._traceback import print_server_warnings, traceback_contains_remote_call
 from ._utils.async_utils import TaskContext, gather_cancel_on_exc, synchronize_api
-from ._utils.deprecation import deprecation_error
 from ._utils.git_utils import get_git_commit_info
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.name_utils import check_object_name, is_valid_tag
@@ -602,8 +601,9 @@ async def _interactive_shell(
             "MODAL_ENVIRONMENT": _get_environment_name(),
         }
         secrets = kwargs.pop("secrets", []) + [_Secret.from_dict(sandbox_env)]
+
         with enable_output():  # show any image build logs
-            sandbox = await _Sandbox.create(
+            sandbox = await _Sandbox._create(
                 "sleep",
                 "100000",
                 app=_app,
@@ -632,24 +632,7 @@ async def _interactive_shell(
                 raise
 
 
-def _run_stub(*args: Any, **kwargs: Any):
-    """mdmd:hidden
-    `run_stub` has been renamed to `run_app` and is deprecated. Please update your code.
-    """
-    deprecation_error(
-        (2024, 5, 1), "`run_stub` has been renamed to `run_app` and is deprecated. Please update your code."
-    )
-
-
-def _deploy_stub(*args: Any, **kwargs: Any):
-    """mdmd:hidden"""
-    message = "`deploy_stub` has been renamed to `deploy_app`. Please update your code."
-    deprecation_error((2024, 5, 1), message)
-
-
 run_app = synchronize_api(_run_app)
 serve_update = synchronize_api(_serve_update)
 deploy_app = synchronize_api(_deploy_app)
 interactive_shell = synchronize_api(_interactive_shell)
-run_stub = synchronize_api(_run_stub)
-deploy_stub = synchronize_api(_deploy_stub)

modal/runner.pyi

@@ -83,8 +83,6 @@ async def _deploy_app(
 async def _interactive_shell(
     _app: _App, cmds: list[str], environment_name: str = "", pty: bool = True, **kwargs: typing.Any
 ) -> None: ...
-def _run_stub(*args: typing.Any, **kwargs: typing.Any): ...
-def _deploy_stub(*args: typing.Any, **kwargs: typing.Any): ...
 
 class __run_app_spec(typing_extensions.Protocol):
     def __call__(
@@ -153,6 +151,3 @@ class __interactive_shell_spec(typing_extensions.Protocol):
     ) -> None: ...
 
 interactive_shell: __interactive_shell_spec
-
-def run_stub(*args: typing.Any, **kwargs: typing.Any): ...
-def deploy_stub(*args: typing.Any, **kwargs: typing.Any): ...

modal/sandbox.py

@@ -12,6 +12,7 @@ from grpclib import GRPCError, Status
 
 from modal._tunnel import Tunnel
 from modal.cloud_bucket_mount import _CloudBucketMount, cloud_bucket_mounts_to_proto
+from modal.mount import _Mount
 from modal.volume import _Volume
 from modal_proto import api_pb2
 
@@ -19,7 +20,6 @@ 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_error
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.mount_utils import validate_network_file_systems, validate_volumes
 from .client import _Client
@@ -30,7 +30,6 @@ from .file_io import FileWatchEvent, FileWatchEventType, _FileIO
 from .gpu import GPU_T
 from .image import _Image
 from .io_streams import StreamReader, StreamWriter, _StreamReader, _StreamWriter
-from .mount import _Mount
 from .network_file_system import _NetworkFileSystem, network_file_system_mount_protos
 from .proxy import _Proxy
 from .scheduler_placement import SchedulerPlacement
@@ -86,7 +85,6 @@ class _Sandbox(_Object, type_prefix="sb"):
     def _new(
         entrypoint_args: Sequence[str],
         image: _Image,
-        mounts: Sequence[_Mount],
         secrets: Sequence[_Secret],
         timeout: Optional[int] = None,
         workdir: Optional[str] = None,
@@ -95,6 +93,7 @@ class _Sandbox(_Object, type_prefix="sb"):
         region: Optional[Union[str, Sequence[str]]] = None,
         cpu: Optional[float] = None,
         memory: Optional[Union[int, tuple[int, int]]] = None,
+        mounts: Sequence[_Mount] = (),
         network_file_systems: dict[Union[str, os.PathLike], _NetworkFileSystem] = {},
         block_network: bool = False,
         cidr_allowlist: Optional[Sequence[str]] = None,
@@ -218,7 +217,6 @@ class _Sandbox(_Object, type_prefix="sb"):
         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.
-        mounts: Sequence[_Mount] = (),  # Mounts to attach to the sandbox.
         secrets: Sequence[_Secret] = (),  # Environment variables to inject into the sandbox.
         network_file_systems: dict[Union[str, os.PathLike], _NetworkFileSystem] = {},
         timeout: Optional[int] = None,  # Maximum execution time of the sandbox in seconds.
@@ -265,6 +263,76 @@ class _Sandbox(_Object, type_prefix="sb"):
         sandbox.wait()
         ```
         """
+        return await _Sandbox._create(
+            *entrypoint_args,
+            app=app,
+            environment_name=environment_name,
+            image=image,
+            secrets=secrets,
+            network_file_systems=network_file_systems,
+            timeout=timeout,
+            workdir=workdir,
+            gpu=gpu,
+            cloud=cloud,
+            region=region,
+            cpu=cpu,
+            memory=memory,
+            block_network=block_network,
+            cidr_allowlist=cidr_allowlist,
+            volumes=volumes,
+            pty_info=pty_info,
+            encrypted_ports=encrypted_ports,
+            unencrypted_ports=unencrypted_ports,
+            proxy=proxy,
+            _experimental_enable_snapshot=_experimental_enable_snapshot,
+            _experimental_scheduler_placement=_experimental_scheduler_placement,
+            client=client,
+        )
+
+    @staticmethod
+    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] = (),
+        network_file_systems: dict[Union[str, os.PathLike], _NetworkFileSystem] = {},
+        timeout: Optional[int] = None,  # Maximum execution time of the sandbox in seconds.
+        workdir: Optional[str] = None,  # Working directory of the sandbox.
+        gpu: GPU_T = None,
+        cloud: Optional[str] = None,
+        region: Optional[Union[str, Sequence[str]]] = None,  # Region or regions to run the sandbox on.
+        # Specify, in fractional CPU cores, how many CPU cores to request.
+        # Or, pass (request, limit) to additionally specify a hard limit in fractional CPU cores.
+        # CPU throttling will prevent a container from exceeding its specified limit.
+        cpu: Optional[Union[float, tuple[float, float]]] = None,
+        # Specify, in MiB, a memory request which is the minimum memory required.
+        # Or, pass (request, limit) to additionally specify a hard limit in MiB.
+        memory: Optional[Union[int, tuple[int, int]]] = None,
+        block_network: bool = False,  # Whether to block network access
+        # List of CIDRs the sandbox is allowed to access. If None, all CIDRs are allowed.
+        cidr_allowlist: Optional[Sequence[str]] = None,
+        volumes: dict[
+            Union[str, os.PathLike], Union[_Volume, _CloudBucketMount]
+        ] = {},  # Mount points for Modal Volumes and CloudBucketMounts
+        pty_info: Optional[api_pb2.PTYInfo] = None,
+        # List of ports to tunnel into the sandbox. Encrypted ports are tunneled with TLS.
+        encrypted_ports: Sequence[int] = [],
+        # List of ports to tunnel into the sandbox without encryption.
+        unencrypted_ports: Sequence[int] = [],
+        # Reference to a Modal Proxy to use in front of this Sandbox.
+        proxy: Optional[_Proxy] = None,
+        # Enable memory snapshots.
+        _experimental_enable_snapshot: bool = False,
+        _experimental_scheduler_placement: Optional[
+            SchedulerPlacement
+        ] = None,  # Experimental controls over fine-grained scheduling (alpha).
+        client: Optional[_Client] = None,
+    ):
+        # This method exposes some internal arguments (currently `mounts`) which are not in the public API
+        # `mounts` is currently only used by modal shell (cli) to provide a function's mounts to the
+        # sandbox that runs the shell session
         from .app import _App
 
         environment_name = _get_environment_name(environment_name)
@@ -275,7 +343,6 @@ class _Sandbox(_Object, type_prefix="sb"):
         obj = _Sandbox._new(
             entrypoint_args,
             image=image or _default_image,
-            mounts=mounts,
             secrets=secrets,
             timeout=timeout,
             workdir=workdir,
@@ -284,6 +351,7 @@ class _Sandbox(_Object, type_prefix="sb"):
             region=region,
             cpu=cpu,
             memory=memory,
+            mounts=mounts,
             network_file_systems=network_file_systems,
             block_network=block_network,
             cidr_allowlist=cidr_allowlist,
@@ -315,14 +383,12 @@ class _Sandbox(_Object, type_prefix="sb"):
             app_id = container_app.app_id
             app_client = container_app._client
         else:
-            arglist = ", ".join(repr(s) for s in entrypoint_args)
-            deprecation_error(
-                (2024, 9, 14),
-                "Creating a `Sandbox` without an `App` is deprecated.\n\n"
-                "You may pass in an `App` object, or reference one by name with `App.lookup`:\n\n"
+            raise InvalidError(
+                "Sandboxes require an App when created outside of a Modal container.\n\n"
+                "Run an ephemeral App (`with app.run(): ...`), or reference a deployed App using `App.lookup`:\n\n"
                 "```\n"
-                "app = modal.App.lookup('sandbox-app', create_if_missing=True)\n"
-                f"sb = modal.Sandbox.create({arglist}, app=app)\n"
+                'app = modal.App.lookup("sandbox-app", create_if_missing=True)\n'
+                "sb = modal.Sandbox.create(..., app=app)\n"
                 "```",
             )
 
@@ -762,23 +828,3 @@ class _Sandbox(_Object, type_prefix="sb"):
 
 
 Sandbox = synchronize_api(_Sandbox)
-
-
-def __getattr__(name):
-    if name == "LogsReader":
-        deprecation_error(
-            (2024, 8, 12),
-            "`modal.sandbox.LogsReader` is deprecated. Please import `modal.io_streams.StreamReader` instead.",
-        )
-        from .io_streams import StreamReader
-
-        return StreamReader
-    elif name == "StreamWriter":
-        deprecation_error(
-            (2024, 8, 12),
-            "`modal.sandbox.StreamWriter` is deprecated. Please import `modal.io_streams.StreamWriter` instead.",
-        )
-        from .io_streams import StreamWriter
-
-        return StreamWriter
-    raise AttributeError(f"module {__name__} has no attribute {name}")

modal/sandbox.pyi

@@ -40,7 +40,6 @@ class _Sandbox(modal._object._Object):
     def _new(
         entrypoint_args: collections.abc.Sequence[str],
         image: modal.image._Image,
-        mounts: collections.abc.Sequence[modal.mount._Mount],
         secrets: collections.abc.Sequence[modal.secret._Secret],
         timeout: typing.Optional[int] = None,
         workdir: typing.Optional[str] = None,
@@ -49,6 +48,7 @@ class _Sandbox(modal._object._Object):
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
         cpu: typing.Optional[float] = 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] = {},
         block_network: bool = False,
         cidr_allowlist: typing.Optional[collections.abc.Sequence[str]] = None,
@@ -69,7 +69,6 @@ class _Sandbox(modal._object._Object):
         app: typing.Optional[modal.app._App] = None,
         environment_name: typing.Optional[str] = None,
         image: typing.Optional[modal.image._Image] = None,
-        mounts: collections.abc.Sequence[modal.mount._Mount] = (),
         secrets: collections.abc.Sequence[modal.secret._Secret] = (),
         network_file_systems: dict[typing.Union[str, os.PathLike], modal.network_file_system._NetworkFileSystem] = {},
         timeout: typing.Optional[int] = None,
@@ -93,6 +92,36 @@ class _Sandbox(modal._object._Object):
         _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
         client: typing.Optional[modal.client._Client] = None,
     ) -> _Sandbox: ...
+    @staticmethod
+    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] = (),
+        network_file_systems: dict[typing.Union[str, os.PathLike], modal.network_file_system._NetworkFileSystem] = {},
+        timeout: typing.Optional[int] = None,
+        workdir: typing.Optional[str] = None,
+        gpu: typing.Union[None, str, modal.gpu._GPUConfig] = None,
+        cloud: typing.Optional[str] = None,
+        region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        cpu: typing.Union[float, tuple[float, float], None] = None,
+        memory: typing.Union[int, tuple[int, int], None] = None,
+        block_network: bool = False,
+        cidr_allowlist: typing.Optional[collections.abc.Sequence[str]] = None,
+        volumes: dict[
+            typing.Union[str, os.PathLike],
+            typing.Union[modal.volume._Volume, modal.cloud_bucket_mount._CloudBucketMount],
+        ] = {},
+        pty_info: typing.Optional[modal_proto.api_pb2.PTYInfo] = None,
+        encrypted_ports: collections.abc.Sequence[int] = [],
+        unencrypted_ports: collections.abc.Sequence[int] = [],
+        proxy: typing.Optional[modal.proxy._Proxy] = None,
+        _experimental_enable_snapshot: bool = False,
+        _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+        client: typing.Optional[modal.client._Client] = None,
+    ): ...
     def _hydrate_metadata(self, handle_metadata: typing.Optional[google.protobuf.message.Message]): ...
     @staticmethod
     async def from_id(sandbox_id: str, client: typing.Optional[modal.client._Client] = None) -> _Sandbox: ...
@@ -182,7 +211,6 @@ class Sandbox(modal.object.Object):
     def _new(
         entrypoint_args: collections.abc.Sequence[str],
         image: modal.image.Image,
-        mounts: collections.abc.Sequence[modal.mount.Mount],
         secrets: collections.abc.Sequence[modal.secret.Secret],
         timeout: typing.Optional[int] = None,
         workdir: typing.Optional[str] = None,
@@ -191,6 +219,7 @@ class Sandbox(modal.object.Object):
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
         cpu: typing.Optional[float] = 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] = {},
         block_network: bool = False,
         cidr_allowlist: typing.Optional[collections.abc.Sequence[str]] = None,
@@ -213,7 +242,6 @@ class Sandbox(modal.object.Object):
             app: typing.Optional[modal.app.App] = None,
             environment_name: typing.Optional[str] = None,
             image: typing.Optional[modal.image.Image] = None,
-            mounts: collections.abc.Sequence[modal.mount.Mount] = (),
             secrets: collections.abc.Sequence[modal.secret.Secret] = (),
             network_file_systems: dict[
                 typing.Union[str, os.PathLike], modal.network_file_system.NetworkFileSystem
@@ -246,7 +274,6 @@ class Sandbox(modal.object.Object):
             app: typing.Optional[modal.app.App] = None,
             environment_name: typing.Optional[str] = None,
             image: typing.Optional[modal.image.Image] = None,
-            mounts: collections.abc.Sequence[modal.mount.Mount] = (),
             secrets: collections.abc.Sequence[modal.secret.Secret] = (),
             network_file_systems: dict[
                 typing.Union[str, os.PathLike], modal.network_file_system.NetworkFileSystem
@@ -275,6 +302,76 @@ class Sandbox(modal.object.Object):
 
     create: __create_spec
 
+    class ___create_spec(typing_extensions.Protocol):
+        def __call__(
+            self,
+            /,
+            *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] = (),
+            network_file_systems: dict[
+                typing.Union[str, os.PathLike], modal.network_file_system.NetworkFileSystem
+            ] = {},
+            timeout: typing.Optional[int] = None,
+            workdir: typing.Optional[str] = None,
+            gpu: typing.Union[None, str, modal.gpu._GPUConfig] = None,
+            cloud: typing.Optional[str] = None,
+            region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+            cpu: typing.Union[float, tuple[float, float], None] = None,
+            memory: typing.Union[int, tuple[int, int], None] = None,
+            block_network: bool = False,
+            cidr_allowlist: typing.Optional[collections.abc.Sequence[str]] = None,
+            volumes: dict[
+                typing.Union[str, os.PathLike],
+                typing.Union[modal.volume.Volume, modal.cloud_bucket_mount.CloudBucketMount],
+            ] = {},
+            pty_info: typing.Optional[modal_proto.api_pb2.PTYInfo] = None,
+            encrypted_ports: collections.abc.Sequence[int] = [],
+            unencrypted_ports: collections.abc.Sequence[int] = [],
+            proxy: typing.Optional[modal.proxy.Proxy] = None,
+            _experimental_enable_snapshot: bool = False,
+            _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+            client: typing.Optional[modal.client.Client] = None,
+        ): ...
+        async def aio(
+            self,
+            /,
+            *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] = (),
+            network_file_systems: dict[
+                typing.Union[str, os.PathLike], modal.network_file_system.NetworkFileSystem
+            ] = {},
+            timeout: typing.Optional[int] = None,
+            workdir: typing.Optional[str] = None,
+            gpu: typing.Union[None, str, modal.gpu._GPUConfig] = None,
+            cloud: typing.Optional[str] = None,
+            region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+            cpu: typing.Union[float, tuple[float, float], None] = None,
+            memory: typing.Union[int, tuple[int, int], None] = None,
+            block_network: bool = False,
+            cidr_allowlist: typing.Optional[collections.abc.Sequence[str]] = None,
+            volumes: dict[
+                typing.Union[str, os.PathLike],
+                typing.Union[modal.volume.Volume, modal.cloud_bucket_mount.CloudBucketMount],
+            ] = {},
+            pty_info: typing.Optional[modal_proto.api_pb2.PTYInfo] = None,
+            encrypted_ports: collections.abc.Sequence[int] = [],
+            unencrypted_ports: collections.abc.Sequence[int] = [],
+            proxy: typing.Optional[modal.proxy.Proxy] = None,
+            _experimental_enable_snapshot: bool = False,
+            _experimental_scheduler_placement: typing.Optional[modal.scheduler_placement.SchedulerPlacement] = None,
+            client: typing.Optional[modal.client.Client] = None,
+        ): ...
+
+    _create: ___create_spec
+
     def _hydrate_metadata(self, handle_metadata: typing.Optional[google.protobuf.message.Message]): ...
 
     class __from_id_spec(typing_extensions.Protocol):
@@ -484,6 +581,4 @@ class Sandbox(modal.object.Object):
 
     list: __list_spec
 
-def __getattr__(name): ...
-
 _default_image: modal.image._Image

modal/secret.py

@@ -10,7 +10,7 @@ from ._object import _get_environment_name, _Object
 from ._resolver import Resolver
 from ._runtime.execution_context import is_local
 from ._utils.async_utils import synchronize_api
-from ._utils.deprecation import deprecation_warning, renamed_parameter
+from ._utils.deprecation import deprecation_warning
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.name_utils import check_object_name
 from .client import _Client
@@ -162,7 +162,6 @@ class _Secret(_Object, type_prefix="st"):
         return _Secret._from_loader(_load, "Secret.from_dotenv()", hydrate_lazily=True)
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     def from_name(
         name: str,
         *,
@@ -206,7 +205,6 @@ class _Secret(_Object, type_prefix="st"):
         return _Secret._from_loader(_load, "Secret()", hydrate_lazily=True)
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     async def lookup(
         name: str,
         namespace=api_pb2.DEPLOYMENT_NAMESPACE_WORKSPACE,

modal/serving.py

@@ -11,7 +11,6 @@ from synchronicity.async_wrap import asynccontextmanager
 from modal._output import OutputManager
 
 from ._utils.async_utils import TaskContext, asyncify, synchronize_api, synchronizer
-from ._utils.deprecation import deprecation_error
 from ._utils.logger import logger
 from ._watcher import watch
 from .cli.import_refs import ImportRef, import_app_from_ref
@@ -122,9 +121,4 @@ async def _serve_app(
             yield app
 
 
-def _serve_stub(*args, **kwargs):
-    deprecation_error((2024, 5, 1), "`serve_stub` is deprecated. Please use `serve_app` instead.")
-
-
 serve_app = synchronize_api(_serve_app)
-serve_stub = synchronize_api(_serve_stub)

modal/serving.pyi

@@ -33,7 +33,6 @@ def _serve_app(
     _watcher: typing.Optional[collections.abc.AsyncGenerator[set[str], None]] = None,
     environment_name: typing.Optional[str] = None,
 ) -> typing.AsyncContextManager[_App]: ...
-def _serve_stub(*args, **kwargs): ...
 
 class __serve_app_spec(typing_extensions.Protocol):
     def __call__(
@@ -56,5 +55,3 @@ class __serve_app_spec(typing_extensions.Protocol):
     ) -> typing.AsyncContextManager[_App]: ...
 
 serve_app: __serve_app_spec
-
-def serve_stub(*args, **kwargs): ...

modal/volume.py

@@ -27,7 +27,7 @@ from grpclib import GRPCError, Status
 from synchronicity.async_wrap import asynccontextmanager
 
 import modal_proto.api_pb2
-from modal.exception import VolumeUploadTimeoutError
+from modal.exception import InvalidError, VolumeUploadTimeoutError
 from modal_proto import api_pb2
 
 from ._object import EPHEMERAL_OBJECT_HEARTBEAT_SLEEP, _get_environment_name, _Object, live_method, live_method_gen
@@ -49,7 +49,7 @@ from ._utils.blob_utils import (
     get_file_upload_spec_from_fileobj,
     get_file_upload_spec_from_path,
 )
-from ._utils.deprecation import deprecation_error, deprecation_warning, renamed_parameter
+from ._utils.deprecation import deprecation_warning
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.http_utils import ClientSessionRegistry
 from ._utils.name_utils import check_object_name
@@ -149,7 +149,6 @@ class _Volume(_Object, type_prefix="vo"):
         return self._lock
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     def from_name(
         name: str,
         *,
@@ -244,7 +243,6 @@ class _Volume(_Object, type_prefix="vo"):
             yield cls._new_hydrated(response.volume_id, client, response.metadata, is_another_app=True)
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     async def lookup(
         name: str,
         namespace=api_pb2.DEPLOYMENT_NAMESPACE_WORKSPACE,
@@ -253,7 +251,8 @@ class _Volume(_Object, type_prefix="vo"):
         create_if_missing: bool = False,
         version: "typing.Optional[modal_proto.api_pb2.VolumeFsVersion.ValueType]" = None,
     ) -> "_Volume":
-        """Lookup a named Volume.
+        """mdmd:hidden
+        Lookup a named Volume.
 
         DEPRECATED: This method is deprecated in favor of `modal.Volume.from_name`.
 
@@ -366,21 +365,14 @@ class _Volume(_Object, type_prefix="vo"):
         recursively.
         """
         if path.endswith("**"):
-            msg = (
+            raise InvalidError(
                 "Glob patterns in `volume get` and `Volume.listdir()` are deprecated. "
                 "Please pass recursive=True instead. For the CLI, just remove the glob suffix."
             )
-            deprecation_error(
-                (2024, 4, 23),
-                msg,
-            )
         elif path.endswith("*"):
-            deprecation_error(
-                (2024, 4, 23),
-                (
-                    "Glob patterns in `volume get` and `Volume.listdir()` are deprecated. "
-                    "Please remove the glob `*` suffix."
-                ),
+            raise InvalidError(
+                "Glob patterns in `volume get` and `Volume.listdir()` are deprecated. "
+                "Please remove the glob `*` suffix."
             )
 
         req = api_pb2.VolumeListFilesRequest(volume_id=self.object_id, path=path, recursive=recursive)
@@ -595,7 +587,6 @@ class _Volume(_Object, type_prefix="vo"):
         )
 
     @staticmethod
-    @renamed_parameter((2024, 12, 18), "label", "name")
     async def delete(name: str, client: Optional[_Client] = None, environment_name: Optional[str] = None):
         obj = await _Volume.from_name(name, environment_name=environment_name).hydrate(client)
         req = api_pb2.VolumeDeleteRequest(volume_id=obj.object_id)

{modal-0.77.0.dist-info → modal-1.0.0.dist-info}/METADATA

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