modal 0.72.55__py3-none-any.whl → 0.72.56__py3-none-any.whl

modal/cli/config.py

@@ -40,7 +40,7 @@ when running a command that requires an environment.
 @config_cli.command(help=SET_DEFAULT_ENV_HELP)
 def set_environment(environment_name: str):
     # Confirm that the environment exists by looking it up
-    Environment.lookup(environment_name)
+    Environment.from_name(environment_name).hydrate()
     _store_user_config({"environment": environment_name})
     typer.echo(f"New default environment for profile {_profile}: {environment_name}")
 

modal/cli/dict.py

@@ -51,7 +51,7 @@ async def list_(*, json: bool = False, env: Optional[str] = ENV_OPTION):
 @synchronizer.create_blocking
 async def clear(name: str, *, yes: bool = YES_OPTION, env: Optional[str] = ENV_OPTION):
     """Clear the contents of a named Dict by deleting all of its data."""
-    d = await _Dict.lookup(name, environment_name=env)
+    d = _Dict.from_name(name, environment_name=env)
     if not yes:
         typer.confirm(
             f"Are you sure you want to irrevocably delete the contents of modal.Dict '{name}'?",
@@ -66,7 +66,7 @@ async def clear(name: str, *, yes: bool = YES_OPTION, env: Optional[str] = ENV_O
 async def delete(name: str, *, yes: bool = YES_OPTION, env: Optional[str] = ENV_OPTION):
     """Delete a named Dict and all of its data."""
     # Lookup first to validate the name, even though delete is a staticmethod
-    await _Dict.lookup(name, environment_name=env)
+    await _Dict.from_name(name, environment_name=env).hydrate()
     if not yes:
         typer.confirm(
             f"Are you sure you want to irrevocably delete the modal.Dict '{name}'?",
@@ -83,7 +83,7 @@ async def get(name: str, key: str, *, env: Optional[str] = ENV_OPTION):
 
     Note: When using the CLI, keys are always interpreted as having a string type.
     """
-    d = await _Dict.lookup(name, environment_name=env)
+    d = _Dict.from_name(name, environment_name=env)
     console = Console()
     val = await d.get(key)
     console.print(val)
@@ -110,7 +110,7 @@ async def items(
     Note: By default, this command truncates the contents. Use the `N` argument to control the
     amount of data shown or the `--all` option to retrieve the entire Dict, which may be slow.
     """
-    d = await _Dict.lookup(name, environment_name=env)
+    d = _Dict.from_name(name, environment_name=env)
 
     i, items = 0, []
     async for key, val in d.items():

modal/cli/network_file_system.py

@@ -71,15 +71,6 @@ def create(
     console.print(usage)
 
 
-async def _volume_from_name(deployment_name: str) -> _NetworkFileSystem:
-    network_file_system = await _NetworkFileSystem.lookup(
-        deployment_name, environment_name=None
-    )  # environment None will take value from config
-    if not isinstance(network_file_system, _NetworkFileSystem):
-        raise Exception("The specified app entity is not a network file system")
-    return network_file_system
-
-
 @nfs_cli.command(
     name="ls",
     help="List files and directories in a network file system.",
@@ -92,7 +83,7 @@ async def ls(
     env: Optional[str] = ENV_OPTION,
 ):
     ensure_env(env)
-    volume = await _volume_from_name(volume_name)
+    volume = _NetworkFileSystem.from_name(volume_name)
     try:
         entries = await volume.listdir(path)
     except GRPCError as exc:
@@ -136,7 +127,7 @@ async def put(
     env: Optional[str] = ENV_OPTION,
 ):
     ensure_env(env)
-    volume = await _volume_from_name(volume_name)
+    volume = _NetworkFileSystem.from_name(volume_name)
     if remote_path.endswith("/"):
         remote_path = remote_path + os.path.basename(local_path)
     console = Console()
@@ -191,7 +182,7 @@ async def get(
     """
     ensure_env(env)
     destination = Path(local_destination)
-    volume = await _volume_from_name(volume_name)
+    volume = _NetworkFileSystem.from_name(volume_name)
     console = Console()
     progress_handler = ProgressHandler(type="download", console=console)
     with progress_handler.live:
@@ -210,7 +201,7 @@ async def rm(
     env: Optional[str] = ENV_OPTION,
 ):
     ensure_env(env)
-    volume = await _volume_from_name(volume_name)
+    volume = _NetworkFileSystem.from_name(volume_name)
     try:
         await volume.remove_file(remote_path, recursive=recursive)
     except GRPCError as exc:
@@ -230,6 +221,8 @@ async def delete(
     yes: bool = YES_OPTION,
     env: Optional[str] = ENV_OPTION,
 ):
+    # Lookup first to validate the name, even though delete is a staticmethod
+    await _NetworkFileSystem.from_name(nfs_name, environment_name=env).hydrate()
     if not yes:
         typer.confirm(
             f"Are you sure you want to irrevocably delete the modal.NetworkFileSystem '{nfs_name}'?",

modal/cli/queues.py

@@ -46,7 +46,7 @@ async def create(name: str, *, env: Optional[str] = ENV_OPTION):
 async def delete(name: str, *, yes: bool = YES_OPTION, env: Optional[str] = ENV_OPTION):
     """Delete a named Queue and all of its data."""
     # Lookup first to validate the name, even though delete is a staticmethod
-    await _Queue.lookup(name, environment_name=env)
+    await _Queue.from_name(name, environment_name=env).hydrate()
     if not yes:
         typer.confirm(
             f"Are you sure you want to irrevocably delete the modal.Queue '{name}'?",
@@ -90,7 +90,7 @@ async def clear(
     env: Optional[str] = ENV_OPTION,
 ):
     """Clear the contents of a queue by removing all of its data."""
-    q = await _Queue.lookup(name, environment_name=env)
+    q = _Queue.from_name(name, environment_name=env)
     if not yes:
         typer.confirm(
             f"Are you sure you want to irrevocably delete the contents of modal.Queue '{name}'?",
@@ -106,7 +106,7 @@ async def peek(
     name: str, n: int = Argument(1), partition: Optional[str] = PARTITION_OPTION, *, env: Optional[str] = ENV_OPTION
 ):
     """Print the next N items in the queue or queue partition (without removal)."""
-    q = await _Queue.lookup(name, environment_name=env)
+    q = _Queue.from_name(name, environment_name=env)
     console = Console()
     i = 0
     async for item in q.iterate(partition=partition):
@@ -126,6 +126,6 @@ async def len(
     env: Optional[str] = ENV_OPTION,
 ):
     """Print the length of a queue partition or the total length of all partitions."""
-    q = await _Queue.lookup(name, environment_name=env)
+    q = _Queue.from_name(name, environment_name=env)
     console = Console()
     console.print(await q.len(partition=partition, total=total))

modal/cli/run.py

@@ -359,7 +359,7 @@ def deploy(
     stream_logs: bool = typer.Option(False, help="Stream logs from the app upon deployment."),
     tag: str = typer.Option("", help="Tag the deployment with a version."),
 ):
-    # this ensures that `modal.lookup()` without environment specification uses the same env as specified
+    # this ensures that lookups without environment specification use the same env as specified
     env = ensure_env(env)
 
     app = import_app(app_ref)

modal/cli/volume.py

@@ -94,7 +94,7 @@ async def get(
     """
     ensure_env(env)
     destination = Path(local_destination)
-    volume = await _Volume.lookup(volume_name, environment_name=env)
+    volume = _Volume.from_name(volume_name, environment_name=env)
     console = Console()
     progress_handler = ProgressHandler(type="download", console=console)
     with progress_handler.live:
@@ -133,9 +133,7 @@ async def ls(
     env: Optional[str] = ENV_OPTION,
 ):
     ensure_env(env)
-    vol = await _Volume.lookup(volume_name, environment_name=env)
-    if not isinstance(vol, _Volume):
-        raise UsageError("The specified app entity is not a modal.Volume")
+    vol = _Volume.from_name(volume_name, environment_name=env)
 
     try:
         entries = await vol.listdir(path)
@@ -190,9 +188,7 @@ async def put(
     env: Optional[str] = ENV_OPTION,
 ):
     ensure_env(env)
-    vol = await _Volume.lookup(volume_name, environment_name=env)
-    if not isinstance(vol, _Volume):
-        raise UsageError("The specified app entity is not a modal.Volume")
+    vol = await _Volume.from_name(volume_name, environment_name=env).hydrate()
 
     if remote_path.endswith("/"):
         remote_path = remote_path + os.path.basename(local_path)
@@ -235,9 +231,7 @@ async def rm(
     env: Optional[str] = ENV_OPTION,
 ):
     ensure_env(env)
-    volume = await _Volume.lookup(volume_name, environment_name=env)
-    if not isinstance(volume, _Volume):
-        raise UsageError("The specified app entity is not a modal.Volume")
+    volume = _Volume.from_name(volume_name, environment_name=env)
     try:
         await volume.remove_file(remote_path, recursive=recursive)
     except GRPCError as exc:
@@ -261,9 +255,7 @@ async def cp(
     env: Optional[str] = ENV_OPTION,
 ):
     ensure_env(env)
-    volume = await _Volume.lookup(volume_name, environment_name=env)
-    if not isinstance(volume, _Volume):
-        raise UsageError("The specified app entity is not a modal.Volume")
+    volume = _Volume.from_name(volume_name, environment_name=env)
     *src_paths, dst_path = paths
     await volume.copy_files(src_paths, dst_path)
 
@@ -279,6 +271,8 @@ async def delete(
     yes: bool = YES_OPTION,
     env: Optional[str] = ENV_OPTION,
 ):
+    # Lookup first to validate the name, even though delete is a staticmethod
+    await _Volume.from_name(volume_name, environment_name=env).hydrate()
     if not yes:
         typer.confirm(
             f"Are you sure you want to irrevocably delete the modal.Volume '{volume_name}'?",

modal/client.pyi

@@ -27,7 +27,7 @@ class _Client:
     _snapshotted: bool
 
     def __init__(
-        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "0.72.55"
+        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "0.72.56"
     ): ...
     def is_closed(self) -> bool: ...
     @property
@@ -85,7 +85,7 @@ class Client:
     _snapshotted: bool
 
     def __init__(
-        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "0.72.55"
+        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "0.72.56"
     ): ...
     def is_closed(self) -> bool: ...
     @property

modal/cls.py

@@ -228,7 +228,7 @@ class _Obj:
 
         ```python notest
         # Usage on a parametrized function.
-        Model = modal.Cls.lookup("my-app", "Model")
+        Model = modal.Cls.from_name("my-app", "Model")
         Model("fine-tuned-model").keep_warm(2)
         ```
         """
@@ -620,7 +620,7 @@ class _Cls(_Object, type_prefix="cs"):
         **Usage:**
 
         ```python notest
-        Model = modal.Cls.lookup("my_app", "Model")
+        Model = modal.Cls.from_name("my_app", "Model")
         ModelUsingGPU = Model.with_options(gpu="A100")
         ModelUsingGPU().generate.remote(42)  # will run with an A100 GPU
         ```
@@ -669,15 +669,23 @@ class _Cls(_Object, type_prefix="cs"):
     ) -> "_Cls":
         """Lookup a Cls from a deployed App by its name.
 
+        DEPRECATED: This method is deprecated in favor of `modal.Cls.from_name`.
+
         In contrast to `modal.Cls.from_name`, this is an eager method
         that will hydrate the local object with metadata from Modal servers.
 
         ```python notest
-        Model = modal.Cls.lookup("other-app", "Model")
+        Model = modal.Cls.from_name("other-app", "Model")
         model = Model()
         model.inference(...)
         ```
         """
+        deprecation_warning(
+            (2025, 1, 27),
+            "`modal.Cls.lookup` is deprecated and will be removed in a future release."
+            " It can be replaced with `modal.Cls.from_name`."
+            "\n\nSee https://modal.com/docs/guide/modal-1-0-migration for more information.",
+        )
         obj = _Cls.from_name(
             app_name, name, namespace=namespace, environment_name=environment_name, workspace=workspace
         )

modal/dict.py

@@ -11,7 +11,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
-from ._utils.deprecation import renamed_parameter
+from ._utils.deprecation import deprecation_warning, renamed_parameter
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.name_utils import check_object_name
 from .client import _Client
@@ -151,14 +151,22 @@ class _Dict(_Object, type_prefix="di"):
     ) -> "_Dict":
         """Lookup a named Dict.
 
+        DEPRECATED: This method is deprecated in favor of `modal.Dict.from_name`.
+
         In contrast to `modal.Dict.from_name`, this is an eager method
         that will hydrate the local object with metadata from Modal servers.
 
         ```python
-        d = modal.Dict.lookup("my-dict")
+        d = modal.Dict.from_name("my-dict")
         d["xyz"] = 123
         ```
         """
+        deprecation_warning(
+            (2025, 1, 27),
+            "`modal.Dict.lookup` is deprecated and will be removed in a future release."
+            " It can be replaced with `modal.Dict.from_name`."
+            "\n\nSee https://modal.com/docs/guide/modal-1-0-migration for more information.",
+        )
         obj = _Dict.from_name(
             name,
             data=data,
@@ -180,7 +188,7 @@ class _Dict(_Object, type_prefix="di"):
         client: Optional[_Client] = None,
         environment_name: Optional[str] = None,
     ):
-        obj = await _Dict.lookup(name, client=client, environment_name=environment_name)
+        obj = await _Dict.from_name(name, environment_name=environment_name).hydrate(client)
         req = api_pb2.DictDeleteRequest(dict_id=obj.object_id)
         await retry_transient_errors(obj._client.stub.DictDelete, req)
 

modal/environments.py

@@ -11,7 +11,7 @@ from modal_proto import api_pb2
 from ._object import _Object
 from ._resolver import Resolver
 from ._utils.async_utils import synchronize_api, synchronizer
-from ._utils.deprecation import renamed_parameter
+from ._utils.deprecation import deprecation_warning, renamed_parameter
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.name_utils import check_object_name
 from .client import _Client
@@ -30,8 +30,7 @@ class _Environment(_Object, type_prefix="en"):
     def __init__(self):
         """mdmd:hidden"""
         raise RuntimeError(
-            "`Environment(...)` constructor is not allowed."
-            " Please use `Environment.from_name` or `Environment.lookup` instead."
+            "`Environment(...)` constructor is not allowed." " Please use `Environment.from_name` instead."
         )
 
     # TODO(michael) Keeping this private for now until we decide what else should be in it
@@ -54,7 +53,7 @@ class _Environment(_Object, type_prefix="en"):
 
     @staticmethod
     @renamed_parameter((2024, 12, 18), "label", "name")
-    async def from_name(
+    def from_name(
         name: str,
         create_if_missing: bool = False,
     ):
@@ -89,7 +88,13 @@ class _Environment(_Object, type_prefix="en"):
         client: Optional[_Client] = None,
         create_if_missing: bool = False,
     ):
-        obj = await _Environment.from_name(name, create_if_missing=create_if_missing)
+        deprecation_warning(
+            (2025, 1, 27),
+            "`modal.Environment.lookup` is deprecated and will be removed in a future release."
+            " It can be replaced with `modal.Environment.from_name`."
+            "\n\nSee https://modal.com/docs/guide/modal-1-0-migration for more information.",
+        )
+        obj = _Environment.from_name(name, create_if_missing=create_if_missing)
         if client is None:
             client = await _Client.from_env()
         resolver = Resolver(client=client)
@@ -107,7 +112,7 @@ ENVIRONMENT_CACHE: dict[str, _Environment] = {}
 async def _get_environment_cached(name: str, client: _Client) -> _Environment:
     if name in ENVIRONMENT_CACHE:
         return ENVIRONMENT_CACHE[name]
-    environment = await _Environment.lookup(name, client)
+    environment = await _Environment.from_name(name).hydrate(client)
     ENVIRONMENT_CACHE[name] = environment
     return environment
 
@@ -164,9 +169,9 @@ async def list_environments(client: Optional[_Client] = None) -> list[api_pb2.En
 def ensure_env(environment_name: Optional[str] = None) -> str:
     """Override config environment with environment from environment_name
 
-    This is necessary since a cli command that runs Modal code, e.g. `modal.lookup()` without
-    explicit environment specification wouldn't pick up the environment specified in a command
-    line flag otherwise, e.g. when doing `modal run --env=foo`
+    This is necessary since a cli command that runs Modal code, without explicit
+    environment specification wouldn't pick up the environment specified in a
+    command line flag otherwise, e.g. when doing `modal run --env=foo`
     """
     if environment_name is not None:
         config.override_locally("environment", environment_name)

modal/environments.pyi

@@ -23,7 +23,7 @@ class _Environment(modal._object._Object):
     def __init__(self): ...
     def _hydrate_metadata(self, metadata: google.protobuf.message.Message): ...
     @staticmethod
-    async def from_name(name: str, create_if_missing: bool = False): ...
+    def from_name(name: str, create_if_missing: bool = False): ...
     @staticmethod
     async def lookup(
         name: str, client: typing.Optional[modal.client._Client] = None, create_if_missing: bool = False
@@ -34,12 +34,8 @@ class Environment(modal.object.Object):
 
     def __init__(self): ...
     def _hydrate_metadata(self, metadata: google.protobuf.message.Message): ...
-
-    class __from_name_spec(typing_extensions.Protocol):
-        def __call__(self, name: str, create_if_missing: bool = False): ...
-        async def aio(self, name: str, create_if_missing: bool = False): ...
-
-    from_name: __from_name_spec
+    @staticmethod
+    def from_name(name: str, create_if_missing: bool = False): ...
 
     class __lookup_spec(typing_extensions.Protocol):
         def __call__(

modal/functions.py

@@ -1019,11 +1019,11 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
 
         ```python notest
         # Usage on a regular function.
-        f = modal.Function.lookup("my-app", "function")
+        f = modal.Function.from_name("my-app", "function")
         f.keep_warm(2)
 
         # Usage on a parametrized function.
-        Model = modal.Cls.lookup("my-app", "Model")
+        Model = modal.Cls.from_name("my-app", "Model")
         Model("fine-tuned-model").keep_warm(2)
         ```
         """
@@ -1096,6 +1096,8 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
     ) -> "_Function":
         """Lookup a Function from a deployed App by its name.
 
+        DEPRECATED: This method is deprecated in favor of `modal.Function.from_name`.
+
         In contrast to `modal.Function.from_name`, this is an eager method
         that will hydrate the local object with metadata from Modal servers.
 
@@ -1103,6 +1105,12 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         f = modal.Function.lookup("other-app", "function")
         ```
         """
+        deprecation_warning(
+            (2025, 1, 27),
+            "`modal.Function.lookup` is deprecated and will be removed in a future release."
+            " It can be replaced with `modal.Function.from_name`."
+            "\n\nSee https://modal.com/docs/guide/modal-1-0-migration for more information.",
+        )
         obj = _Function.from_name(app_name, name, namespace=namespace, environment_name=environment_name)
         if client is None:
             client = await _Client.from_env()

modal/mount.py

@@ -709,6 +709,12 @@ class _Mount(_Object, type_prefix="mo"):
         environment_name: Optional[str] = None,
     ) -> "_Mount":
         """mdmd:hidden"""
+        deprecation_warning(
+            (2025, 1, 27),
+            "`modal.Mount.lookup` is deprecated and will be removed in a future release."
+            " It can be replaced with `modal.Mount.from_name`."
+            "\n\nSee https://modal.com/docs/guide/modal-1-0-migration for more information.",
+        )
         obj = _Mount.from_name(name, namespace=namespace, environment_name=environment_name)
         if client is None:
             client = await _Client.from_env()

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 renamed_parameter
+from ._utils.deprecation import deprecation_warning, renamed_parameter
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.hash_utils import get_sha256_hex
 from ._utils.name_utils import check_object_name
@@ -84,7 +84,7 @@ class _NetworkFileSystem(_Object, type_prefix="sv"):
     A `NetworkFileSystem` can also be useful for some local scripting scenarios, e.g.:
 
     ```python notest
-    nfs = modal.NetworkFileSystem.lookup("my-network-file-system")
+    nfs = modal.NetworkFileSystem.from_name("my-network-file-system")
     for chunk in nfs.read_file("my_db_dump.csv"):
         ...
     ```
@@ -177,6 +177,8 @@ class _NetworkFileSystem(_Object, type_prefix="sv"):
     ) -> "_NetworkFileSystem":
         """Lookup a named NetworkFileSystem.
 
+        DEPRECATED: This method is deprecated in favor of `modal.NetworkFileSystem.from_name`.
+
         In contrast to `modal.NetworkFileSystem.from_name`, this is an eager method
         that will hydrate the local object with metadata from Modal servers.
 
@@ -185,6 +187,12 @@ class _NetworkFileSystem(_Object, type_prefix="sv"):
         print(nfs.listdir("/"))
         ```
         """
+        deprecation_warning(
+            (2025, 1, 27),
+            "`modal.NetworkFileSystem.lookup` is deprecated and will be removed in a future release."
+            " It can be replaced with `modal.NetworkFileSystem.from_name`."
+            "\n\nSee https://modal.com/docs/guide/modal-1-0-migration for more information.",
+        )
         obj = _NetworkFileSystem.from_name(
             name, namespace=namespace, environment_name=environment_name, create_if_missing=create_if_missing
         )
@@ -217,7 +225,7 @@ class _NetworkFileSystem(_Object, type_prefix="sv"):
     @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.lookup(name, client=client, environment_name=environment_name)
+        obj = await _NetworkFileSystem.from_name(name, environment_name=environment_name).hydrate(client)
         req = api_pb2.SharedVolumeDeleteRequest(shared_volume_id=obj.object_id)
         await retry_transient_errors(obj._client.stub.SharedVolumeDelete, req)
 

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 renamed_parameter
+from ._utils.deprecation import deprecation_warning, renamed_parameter
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.name_utils import check_object_name
 from .client import _Client
@@ -188,14 +188,22 @@ class _Queue(_Object, type_prefix="qu"):
     ) -> "_Queue":
         """Lookup a named Queue.
 
+        DEPRECATED: This method is deprecated in favor of `modal.Queue.from_name`.
+
         In contrast to `modal.Queue.from_name`, this is an eager method
         that will hydrate the local object with metadata from Modal servers.
 
-        ```python
+        ```python notest
         q = modal.Queue.lookup("my-queue")
         q.put(123)
         ```
         """
+        deprecation_warning(
+            (2025, 1, 27),
+            "`modal.Queue.lookup` is deprecated and will be removed in a future release."
+            " It can be replaced with `modal.Queue.from_name`."
+            "\n\nSee https://modal.com/docs/guide/modal-1-0-migration for more information.",
+        )
         obj = _Queue.from_name(
             name, namespace=namespace, environment_name=environment_name, create_if_missing=create_if_missing
         )
@@ -208,7 +216,7 @@ class _Queue(_Object, type_prefix="qu"):
     @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.lookup(name, client=client, environment_name=environment_name)
+        obj = await _Queue.from_name(name, environment_name=environment_name).hydrate(client)
         req = api_pb2.QueueDeleteRequest(queue_id=obj.object_id)
         await retry_transient_errors(obj._client.stub.QueueDelete, req)
 

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 renamed_parameter
+from ._utils.deprecation import deprecation_warning, renamed_parameter
 from ._utils.grpc_utils import retry_transient_errors
 from ._utils.name_utils import check_object_name
 from .client import _Client
@@ -214,6 +214,12 @@ class _Secret(_Object, type_prefix="st"):
         required_keys: list[str] = [],
     ) -> "_Secret":
         """mdmd:hidden"""
+        deprecation_warning(
+            (2025, 1, 27),
+            "`modal.Secret.lookup` is deprecated and will be removed in a future release."
+            " It can be replaced with `modal.Secret.from_name`."
+            "\n\nSee https://modal.com/docs/guide/modal-1-0-migration for more information.",
+        )
         obj = _Secret.from_name(
             name, namespace=namespace, environment_name=environment_name, required_keys=required_keys
         )

modal/volume.py

@@ -223,14 +223,22 @@ class _Volume(_Object, type_prefix="vo"):
     ) -> "_Volume":
         """Lookup a named Volume.
 
+        DEPRECATED: This method is deprecated in favor of `modal.Volume.from_name`.
+
         In contrast to `modal.Volume.from_name`, this is an eager method
         that will hydrate the local object with metadata from Modal servers.
 
         ```python notest
-        vol = modal.Volume.lookup("my-volume")
+        vol = modal.Volume.from_name("my-volume")
         print(vol.listdir("/"))
         ```
         """
+        deprecation_warning(
+            (2025, 1, 27),
+            "`modal.Volume.lookup` is deprecated and will be removed in a future release."
+            " It can be replaced with `modal.Volume.from_name`."
+            "\n\nSee https://modal.com/docs/guide/modal-1-0-migration for more information.",
+        )
         obj = _Volume.from_name(
             name,
             namespace=namespace,
@@ -370,7 +378,7 @@ class _Volume(_Object, type_prefix="vo"):
         **Example:**
 
         ```python notest
-        vol = modal.Volume.lookup("my-modal-volume")
+        vol = modal.Volume.from_name("my-modal-volume")
         data = b""
         for chunk in vol.read_file("1mb.csv"):
             data += chunk
@@ -459,7 +467,7 @@ class _Volume(_Object, type_prefix="vo"):
         **Usage**
 
         ```python notest
-        vol = modal.Volume.lookup("my-modal-volume")
+        vol = modal.Volume.from_name("my-modal-volume")
 
         vol.copy_files(["bar/example.txt"], "bar2")  # Copy files to another directory
         vol.copy_files(["bar/example.txt"], "bar/example2.txt")  # Rename a file by copying
@@ -483,7 +491,7 @@ class _Volume(_Object, type_prefix="vo"):
         **Example:**
 
         ```python notest
-        vol = modal.Volume.lookup("my-modal-volume")
+        vol = modal.Volume.from_name("my-modal-volume")
 
         with vol.batch_upload() as batch:
             batch.put_file("local-path.txt", "/remote-path.txt")
@@ -502,7 +510,7 @@ 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.lookup(name, client=client, environment_name=environment_name)
+        obj = await _Volume.from_name(name, environment_name=environment_name).hydrate(client)
         req = api_pb2.VolumeDeleteRequest(volume_id=obj.object_id)
         await retry_transient_errors(obj._client.stub.VolumeDelete, req)
 
@@ -514,7 +522,7 @@ class _Volume(_Object, type_prefix="vo"):
         client: Optional[_Client] = None,
         environment_name: Optional[str] = None,
     ):
-        obj = await _Volume.lookup(old_name, client=client, environment_name=environment_name)
+        obj = await _Volume.from_name(old_name, environment_name=environment_name).hydrate(client)
         req = api_pb2.VolumeRenameRequest(volume_id=obj.object_id, name=new_name)
         await retry_transient_errors(obj._client.stub.VolumeRename, req)
 

{modal-0.72.55.dist-info → modal-0.72.56.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: modal
-Version: 0.72.55
+Version: 0.72.56
 Summary: Python client library for Modal
 Author: Modal Labs
 Author-email: support@modal.com

{modal-0.72.55.dist-info → modal-0.72.56.dist-info}/RECORD

@@ -20,34 +20,34 @@ modal/app.py,sha256=KNfzLlkI2dJPl9LY8AgW76whZpwIvYKi2E2p9u4F3N4,43659
 modal/app.pyi,sha256=vnQhENaQBhJO6el-ieOcw3NEeYQ314SFXRDtjij4DM8,25324
 modal/call_graph.py,sha256=1g2DGcMIJvRy-xKicuf63IVE98gJSnQsr8R_NVMptNc,2581
 modal/client.py,sha256=8SQawr7P1PNUCq1UmJMUQXG2jIo4Nmdcs311XqrNLRE,15276
-modal/client.pyi,sha256=mkyAthnHrMG3LZQmb_7P4B8QJ4fJm3pSHOv57FqL-h8,7593
+modal/client.pyi,sha256=NZx1nJFmYTW04T1oPNJV3AmG_tWl8yRAwQSyD2wFnS0,7593
 modal/cloud_bucket_mount.py,sha256=YOe9nnvSr4ZbeCn587d7_VhE9IioZYRvF9VYQTQux08,5914
 modal/cloud_bucket_mount.pyi,sha256=30T3K1a89l6wzmEJ_J9iWv9SknoGqaZDx59Xs-ZQcmk,1607
-modal/cls.py,sha256=OOvGFL0k4njSrApUpwh3y398KHUXlanCbJmWzN021Vk,32282
+modal/cls.py,sha256=7k3_FwhPUzewRXRZP8bcVJA9AZstoxGJuHKQ5Db-YoY,32683
 modal/cls.pyi,sha256=LIoQrf96E2eZXTsO-o87jf2ppGAnYwQ8nVxsDmx7QHs,9040
 modal/config.py,sha256=BzhZYUUwOmvVwf6x5kf0ywMC257s648dmuhsnB6g3gk,11041
 modal/container_process.py,sha256=WTqLn01dJPVkPpwR_0w_JH96ceN5mV4TGtiu1ZR2RRA,6108
 modal/container_process.pyi,sha256=Hf0J5JyDdCCXBJSKx6gvkPOo0XrztCm78xzxamtzUjQ,2828
-modal/dict.py,sha256=lKxvBcbcFZRARiqfolyRUW08x3RcozWL3MZuW2-Eu4U,12498
+modal/dict.py,sha256=vc5lQVqzeDUCb4fRjnOlqYK2GmBb0fIhZmvB0xIBG0U,12921
 modal/dict.pyi,sha256=kKb0Kc6RUabtQ5Hwslg_vwL_OIrwIAJ2NXrJTepTtp4,7684
-modal/environments.py,sha256=20doFhRnm1fae30LMOp8hSYbIfR7yFZTtbLdo5PrSj4,6661
-modal/environments.pyi,sha256=RXE3slyEr9tWpfS84Fj7iUzNJy-SujlqWOQTE8A4Qaw,3537
+modal/environments.py,sha256=Q1MpUt4SmBUaLFPzrYxCgGkMaqNBLxRDSLzNxK_Abe4,6949
+modal/environments.pyi,sha256=JvSroVOIXDIILL40Z5G4HyY16bmih2YMWMvWL-SFTwo,3373
 modal/exception.py,sha256=4JyO-SACaLNDe2QC48EjsK8GMkZ8AgEurZ8j1YdRu8E,5263
 modal/experimental.py,sha256=H9FXT3kshbjPLovshT10DicyOkGFrPqILy-qdTX-P7s,4015
 modal/experimental.pyi,sha256=24tIYu_w9RLwFrz1cIsgYuqmDCtV8eg6-bQNz3zjhDo,939
 modal/file_io.py,sha256=lcMs_E9Xfm0YX1t9U2wNIBPnqHRxmImqjLW1GHqVmyg,20945
 modal/file_io.pyi,sha256=NTRft1tbPSWf9TlWVeZmTlgB5AZ_Zhu2srWIrWr7brk,9445
 modal/file_pattern_matcher.py,sha256=dSo7BMQGZBAuoBFOX-e_72HxmF3FLzjQlEtnGtJiaD4,6506
-modal/functions.py,sha256=BrqbgeKpuoiA3-waNfdmUJfAGF7BsbQHvlTfAS1eHNQ,69046
+modal/functions.py,sha256=VTAsXnE-tje8z4ZFgxg-j8XdzAz4iAgr0DDD8TV8yE8,69459
 modal/functions.pyi,sha256=m2a2ZnjqZFC6REG1_uhA5LM0O1etkFbQH3KnsLSXUKs,26533
 modal/gpu.py,sha256=2qZMNnoMrjU-5Bu7fx68pANUAKTtZq0EWEEeBA9OUVQ,7426
 modal/image.py,sha256=leeY7fLfFjS0IqTi3D4cRxIDOb80BPtb3jsQfqvVJ8c,90912
 modal/image.pyi,sha256=QMKS6E3CsZr5DoyNqGpcJPBYJTJZSvtAQIsAhPVd_E4,26347
 modal/io_streams.py,sha256=QkQiizKRzd5bnbKQsap31LJgBYlAnj4-XkV_50xPYX0,15079
 modal/io_streams.pyi,sha256=bJ7ZLmSmJ0nKoa6r4FJpbqvzdUVa0lEe0Fa-MMpMezU,5071
-modal/mount.py,sha256=JuZZ2IJuypv1_9qK8R_LepX5oEWFTALdjIVA7_9HNC0,31802
+modal/mount.py,sha256=zk5hncXdiHiO2ZqKUIuan_ON8GZ-ZYnxqqVA7yVHRxY,32116
 modal/mount.pyi,sha256=dvdr4joSpW7oKnKyg9eDD0obFfekwZtW65j4NEomivQ,12523
-modal/network_file_system.py,sha256=Jcr5Whar0MgA2YItJLJWmzHDnkkDlcOzO63TRkA64zA,14407
+modal/network_file_system.py,sha256=WXdyL7du_fvjvuG6hSAREyJ83sSEP2xSLAIAhBsisdI,14869
 modal/network_file_system.pyi,sha256=4N3eqMbTSlqmS8VV_aJK-uvrgJC8xnf_YtW5FHfRfc8,8156
 modal/object.py,sha256=bTeskuY8JFrESjU4_UL_nTwYlBQdOLmVaOX3X6EMxsg,164
 modal/object.pyi,sha256=kyJkRQcVv3ct7zSAxvvXcuhBVeH914v80uSlqeS7cA4,5632
@@ -59,7 +59,7 @@ modal/partial_function.pyi,sha256=Dj4WDxbGkXjxAbucSBSqr2_vrNbEWEAwdXnMzh2d80Y,99
 modal/proxy.py,sha256=NrOevrWxG3G7-zlyRzG6BcIvop7AWLeyahZxitbBaOk,1418
 modal/proxy.pyi,sha256=1OEKIVUyC-xb7fHMzngakQso0nTsK60TVhXtlcMj6Wk,390
 modal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-modal/queue.py,sha256=HPnyJuX-THDEl2ak-xqf2lxYJMiQw4e37y4vHz6FRCg,18557
+modal/queue.py,sha256=02HUroxLIiWQemHYS6PDXH2eM51CUeFP7nQ6Usb1V04,18987
 modal/queue.pyi,sha256=sgvELCK4bJXMZIZw7gllooGFZNipGjI3BT4rmUuyD9M,10282
 modal/retries.py,sha256=HKR2Q9aNPWkMjQ5nwobqYTuZaSuw0a8lI2zrtY5IW98,5230
 modal/runner.py,sha256=0SCMgKO8lZ9W1C7le1EcgViKERMXpi_-QBd6PF_MH0Q,24450
@@ -69,7 +69,7 @@ modal/sandbox.py,sha256=QJTK-IUHe_SOvq-mv337xcVs2zct-I6ngwOqLkYDvoQ,31773
 modal/sandbox.pyi,sha256=qncEvzK76h_ehrs03vlroQyLThWiMsjKhD0DnCNc6zI,22663
 modal/schedule.py,sha256=0ZFpKs1bOxeo5n3HZjoL7OE2ktsb-_oGtq-WJEPO4tY,2615
 modal/scheduler_placement.py,sha256=BAREdOY5HzHpzSBqt6jDVR6YC_jYfHMVqOzkyqQfngU,1235
-modal/secret.py,sha256=XTqrpR4rnkuUb-bth3qM_xxPqqEWorSoN9qDwjWRcXo,10118
+modal/secret.py,sha256=U2Jivqdb94eI_BrGCMVbCots8F2gDcbXLMia_gVlej0,10455
 modal/secret.pyi,sha256=W4g_BOSxafYm-K9PvFc7-li3a-rsCFNkYgHTZXr1AFA,2974
 modal/serving.py,sha256=MnVuTsimN05LfNPxuJZ4sr5s1_BPUkIsOP_VC-bkp78,4464
 modal/serving.pyi,sha256=ncV-9jY_vZYFnGs5ZnMb3ffrX8LmcLdIMHBC56xRbtE,1711
@@ -78,7 +78,7 @@ modal/snapshot.pyi,sha256=Ypd4NKsjOTnnnqXyTGGLKq5lkocRrUURYjY5Pi67_qA,670
 modal/stream_type.py,sha256=A6320qoAAWhEfwOCZfGtymQTu5AfLfJXXgARqooTPvY,417
 modal/token_flow.py,sha256=LcgSce_MSQ2p7j55DPwpVRpiAtCDe8GRSEwzO7muNR8,6774
 modal/token_flow.pyi,sha256=0XV3d-9CGQL3qjPdw3RgwIFVqqxo8Z-u044_mkgAM3o,2064
-modal/volume.py,sha256=DdM9NhqNkqrk4BbAZdAgzI1jZws7NN2tYANO4OuM8hQ,29675
+modal/volume.py,sha256=JAWeDvoAG95tMBv-fYIERyHsJPS_X_xGpxRRmYtb6j0,30096
 modal/volume.pyi,sha256=kTsXarphjZILXci84LQy7EyC84eXUs5-7D62IM5q3eE,12491
 modal/_runtime/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0VESpjWR0fc,28
 modal/_runtime/asgi.py,sha256=c4hmaMW1pLo-cm7ouriJjieuFm4ZF6D2LMy0638sfOs,22139
@@ -113,21 +113,21 @@ modal/cli/__init__.py,sha256=waLjl5c6IPDhSsdWAm9Bji4e2PVxamYABKAze6CHVXY,28
 modal/cli/_download.py,sha256=t6BXZwjTd9MgznDvbsV8rp0FZWggdzC-lUAGZU4xx1g,3984
 modal/cli/_traceback.py,sha256=QlLa_iw3fAOA-mqCqjS8qAxvNT48J3YY3errtVVc2cw,7316
 modal/cli/app.py,sha256=TmUiFKAE1yc6ll8pfl-wZ2lh9crC31Fu_8_YKCX8NJc,7818
-modal/cli/config.py,sha256=pXPLmX0bIoV57rQNqIPK7V-yllj-GPRY4jiBO_EklGg,1667
+modal/cli/config.py,sha256=QvFsqO4eUOtI7d_pQAOAyfq_ZitjhPtav3C6GIDQcZM,1680
 modal/cli/container.py,sha256=FYwEgjf93j4NMorAjGbSV98i1wpebqdAeNU1wfrFp1k,3668
-modal/cli/dict.py,sha256=HaEcjfll7i3Uj3Fg56aj4407if5UljsYfr6fIq-D2W8,4589
+modal/cli/dict.py,sha256=8Wq3w-UDaywk8EVNdj-ECCNV9TYHqh4kzhUqhhulatM,4593
 modal/cli/entry_point.py,sha256=aaNxFAqZcmtSjwzkYIA_Ba9CkL4cL4_i2gy5VjoXxkM,4228
 modal/cli/environment.py,sha256=Ayddkiq9jdj3XYDJ8ZmUqFpPPH8xajYlbexRkzGtUcg,4334
 modal/cli/import_refs.py,sha256=-FVm5nBv8LdEelgKdVEPOoqrdzKzYH48Vvwaq5B9Vyw,11869
 modal/cli/launch.py,sha256=pzQt2QlcrbIUU0MVzWWPAvMQ6MCyqsHZ0X9JcV-sY04,3242
-modal/cli/network_file_system.py,sha256=o6VLTgN4xn5XUiNPBfxYec-5uWCgYrDmfFFLM1ZW_eE,8180
+modal/cli/network_file_system.py,sha256=eq3JnwjbfFNsJodIyANHL06ByYc3BSavzdmu8C96cHA,7948
 modal/cli/profile.py,sha256=rLXfjJObfPNjaZvNfHGIKqs7y9bGYyGe-K7V0w-Ni0M,3110
-modal/cli/queues.py,sha256=MIh2OsliNE2QeL1erubfsRsNuG4fxqcqWA2vgIfQ4Mg,4494
-modal/cli/run.py,sha256=1rIfCRuCJb5fJQPW2j9huHh9h72u45g708IXf3QXKB8,20051
+modal/cli/queues.py,sha256=6gTu76dzBtPN5eQVsLrvQpuru5jI9ZCWK5Eh8J8XhaM,4498
+modal/cli/run.py,sha256=v9qtijHyDqT7cDRc5NOFBzhtsBIT75lfA3xnVRsbP4E,20041
 modal/cli/secret.py,sha256=uQpwYrMY98iMCWeZOQTcktOYhPTZ8IHnyealDc2CZqo,4206
 modal/cli/token.py,sha256=mxSgOWakXG6N71hQb1ko61XAR9ZGkTMZD-Txn7gmTac,1924
 modal/cli/utils.py,sha256=hZmjyzcPjDnQSkLvycZD2LhGdcsfdZshs_rOU78EpvI,3717
-modal/cli/volume.py,sha256=Jrm-1R9u92JbbUM62bkB9RzAM_jO8wi7T2-i6Cb2XG0,10568
+modal/cli/volume.py,sha256=zVZTTRSi1iWy9Rnwx7WyoLSq73Jd_n1z8fx-QlDkNIQ,10266
 modal/cli/programs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal/cli/programs/run_jupyter.py,sha256=1X8eQ3gB_IqkJn11Q4dQ9KdIqFVwQQlwkrrSqlFWfPQ,2685
 modal/cli/programs/vscode.py,sha256=c5jKk1ruuC03X1D-hNc2jtTQqofCBweEZH_qxHjkHGo,3383
@@ -150,7 +150,7 @@ modal_global_objects/images/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0
 modal_global_objects/images/base_images.py,sha256=tFc7tzQRJHtq23kURd6DTrnnO4Yp5ujr34WdJOM5ubI,775
 modal_global_objects/mounts/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0VESpjWR0fc,28
 modal_global_objects/mounts/modal_client_package.py,sha256=W0E_yShsRojPzWm6LtIQqNVolapdnrZkm2hVEQuZK_4,767
-modal_global_objects/mounts/python_standalone.py,sha256=pEML5GaV2_0ahci_1vpfc_FnySpsfi2fhYmFF5I7IiQ,1837
+modal_global_objects/mounts/python_standalone.py,sha256=EsC-hdPtiAPOwgW9emHN6muNUkrJwR8dYxroVArxHxM,1841
 modal_proto/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0VESpjWR0fc,28
 modal_proto/api.proto,sha256=wI8-SbbAGRYqlWa5yv26MyrOC7VdF4hwSON_WqRMlCA,85215
 modal_proto/api_grpc.py,sha256=FYGqDegM_w_qxdtlxum8k31mDibKoMvmNxv_p9cKdKs,109056
@@ -169,10 +169,10 @@ modal_proto/options_pb2_grpc.pyi,sha256=CImmhxHsYnF09iENPoe8S4J-n93jtgUYD2JPAc0y
 modal_proto/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 modal_version/__init__.py,sha256=kGya2ZlItX2zB7oHORs-wvP4PG8lg_mtbi1QIK3G6SQ,470
 modal_version/__main__.py,sha256=2FO0yYQQwDTh6udt1h-cBnGd1c4ZyHnHSI4BksxzVac,105
-modal_version/_version_generated.py,sha256=vkG-K0SNNSwqQYGsxm5bi-3t3k0dMAhohaIXPf8hkyM,149
-modal-0.72.55.dist-info/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
-modal-0.72.55.dist-info/METADATA,sha256=wnRa02BaCAsivaLSLXY3zjHO4-fFS63yZDCqo2xlAyc,2329
-modal-0.72.55.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-modal-0.72.55.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-0.72.55.dist-info/top_level.txt,sha256=1nvYbOSIKcmU50fNrpnQnrrOpj269ei3LzgB6j9xGqg,64
-modal-0.72.55.dist-info/RECORD,,
+modal_version/_version_generated.py,sha256=iPX_Knegz9ad2KngLCBJJp1uIDoBCu3PX04r6mMrbN0,149
+modal-0.72.56.dist-info/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-0.72.56.dist-info/METADATA,sha256=MOw0ZgsW4nPdUP8nvuQWHTOHktBm1PgtGciJvx1C1is,2329
+modal-0.72.56.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
+modal-0.72.56.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-0.72.56.dist-info/top_level.txt,sha256=1nvYbOSIKcmU50fNrpnQnrrOpj269ei3LzgB6j9xGqg,64
+modal-0.72.56.dist-info/RECORD,,

modal_global_objects/mounts/python_standalone.py

@@ -26,7 +26,7 @@ def publish_python_standalone_mount(client, version: str) -> None:
     profile_environment = config.get("environment")
     mount_name = python_standalone_mount_name(f"{version}-{libc}")
     try:
-        Mount.lookup(mount_name, namespace=api_pb2.DEPLOYMENT_NAMESPACE_GLOBAL, client=client)
+        Mount.from_name(mount_name, namespace=api_pb2.DEPLOYMENT_NAMESPACE_GLOBAL).hydrate(client)
         print(f"✅ Found existing mount {mount_name} in global namespace.")
     except NotFoundError:
         print(f"📦 Unpacking python-build-standalone for {version}-{libc}.")

modal_version/_version_generated.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2025
 
 # Note: Reset this value to -1 whenever you make a minor `0.X` release of the client.
-build_number = 55  # git: 0503a38
+build_number = 56  # git: 14e9043