modAL 1.4.3.dev30__py3-none-any.whl → 1.4.4.dev0__py3-none-any.whl

modal/_function_variants.py

@@ -18,7 +18,7 @@ from ._utils.mount_utils import validate_volumes, validate_volumes_by_object_id
 from .cloud_bucket_mount import _CloudBucketMount, cloud_bucket_mounts_to_proto
 from .retries import Retries
 from .secret import _Secret
-from .volume import _Volume
+from .volume import _Volume, _volume_to_mount_proto
 
 if TYPE_CHECKING:
     from ._functions import _Function
@@ -162,15 +162,7 @@ class _FunctionOptions:
         # Needs to be called late so that volumes are hydrated
         validate_volumes_by_object_id(self.validated_volumes)
 
-        volume_mounts = [
-            api_pb2.VolumeMount(
-                mount_path=path,
-                volume_id=volume.object_id,
-                allow_background_commits=True,
-                read_only=volume._read_only,
-            )
-            for path, volume in self.validated_volumes
-        ]
+        volume_mounts = [_volume_to_mount_proto(path, volume) for path, volume in self.validated_volumes]
         return api_pb2.FunctionOptions(
             secret_ids=[secret.object_id for secret in self.secrets],
             replace_secret_ids=bool(self.secrets),

modal/_functions.py

@@ -89,7 +89,7 @@ from .proxy import _Proxy
 from .retries import Retries, RetryManager
 from .schedule import Schedule
 from .secret import _Secret
-from .volume import _Volume
+from .volume import _Volume, _volume_to_mount_proto
 
 if TYPE_CHECKING:
     import modal.app
@@ -667,6 +667,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
         batch_wait_ms: Optional[int] = None,
         cloud: Optional[str] = None,
         region: Optional[Union[str, Sequence[str]]] = None,
+        routing_region: Optional[str] = None,
         nonpreemptible: bool = False,
         is_builder_function: bool = False,
         is_auto_snapshot: bool = False,
@@ -946,13 +947,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
 
                 # Relies on dicts being ordered (true as of Python 3.6).
                 volume_mounts = [
-                    api_pb2.VolumeMount(
-                        mount_path=path,
-                        volume_id=volume.object_id,
-                        allow_background_commits=True,
-                        read_only=volume._read_only,
-                    )
-                    for path, volume in validated_volumes_no_cloud_buckets
+                    _volume_to_mount_proto(path, volume) for path, volume in validated_volumes_no_cloud_buckets
                 ]
                 loaded_mount_ids = {m.object_id for m in all_mounts} | {m.object_id for m in image._mount_layers}
 
@@ -1033,6 +1028,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
                     supported_output_formats=supported_output_formats,
                     http_config=http_config,
                     is_server=is_server,
+                    routing_region=routing_region or "",
                 )
 
                 if isinstance(gpu, list):
@@ -1072,6 +1068,7 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
                         supported_output_formats=supported_output_formats,
                         http_config=http_config,
                         is_server=function_definition.is_server,
+                        routing_region=function_definition.routing_region,
                     )
 
                     ranked_functions = []

modal/_grpc_client.py

@@ -44,10 +44,6 @@ _STATUS_TO_EXCEPTION: dict[Status, type[exception._GRPCErrorWrapper]] = {
 
 
 class grpc_error_converter:
-    def __init__(self, *, expect_timeouts: bool = False):
-        """expect_timeouts: if this is set we convert cancelled/deadline_exceeded statuses to exception.TimeoutError"""
-        self._expect_timeouts = expect_timeouts
-
     def __enter__(self):
         pass
 
@@ -56,9 +52,6 @@ class grpc_error_converter:
         use_full_traceback = config.get("traceback")
         with suppress_tb_frame():
             if isinstance(exc, GRPCError):
-                if self._expect_timeouts and exc.status in (Status.CANCELLED, Status.DEADLINE_EXCEEDED):
-                    raise exception.TimeoutError("Timeout expired")
-
                 modal_exc = _STATUS_TO_EXCEPTION[exc.status](exc.message)
                 modal_exc._grpc_message = exc.message
                 modal_exc._grpc_status = exc.status

modal/_utils/mount_utils.py

@@ -68,7 +68,7 @@ def validate_volumes(
     for path, volume in validated_volumes:
         if not isinstance(volume, (_Volume, _CloudBucketMount)):
             raise InvalidError(f"Object of type {type(volume)} mounted at '{path}' is not usable as a volume.")
-        elif isinstance(volume, (_Volume)):
+        elif isinstance(volume, _Volume):
             volume_to_paths.setdefault(volume, []).append(path)
     for paths in volume_to_paths.values():
         if len(paths) > 1:

modal/_utils/task_command_router_client.py

@@ -74,7 +74,7 @@ async def call_with_retries_on_transient_errors(
     delay_factor: float = 2,
     max_retries: Optional[int] = 10,
     exclude_status_codes: Optional[list[Status]] = None,
-    expect_timeouts: bool = False,  # when True we convert TimeoutError to exception.TimeoutError and don't retry"""
+    timeout_deadline: Optional[float] = None,
 ):
     """Call func() with transient error retries and exponential backoff.
 
@@ -84,6 +84,13 @@ async def call_with_retries_on_transient_errors(
         exclude_status_codes: gRPC status codes to exclude from retry logic even if
             they are in RETRYABLE_GRPC_STATUS_CODES. Use this to let certain errors
             (e.g. DEADLINE_EXCEEDED) propagate immediately rather than being retried.
+        timeout_deadline: Optional monotonic deadline (`time.monotonic()` value).
+            When set, retries are not attempted once the deadline is reached and
+            the backoff sleep is clamped so we don't sleep past it. It's up to
+            the caller to decide whether to further translate the surfaced
+            exception (e.g., into a TimeoutError) based on the deadline check.
+            The caller is also responsible for propagating the remaining budget
+            into `func()` (typically as the per-call gRPC timeout).
     """
     delay_secs = base_delay_secs
     num_retries = 0
@@ -92,10 +99,22 @@ async def call_with_retries_on_transient_errors(
     def is_retryable_status(status: Status) -> bool:
         return status in RETRYABLE_GRPC_STATUS_CODES and status not in exclude_status_codes
 
-    async def sleep_and_update_delay_and_num_retries_remaining(e: Exception):
+    def can_retry() -> bool:
+        if max_retries is not None and num_retries >= max_retries:
+            return False
+        if timeout_deadline is not None and time.monotonic() >= timeout_deadline:
+            return False
+        return True
+
+    async def sleep_and_advance(e: Exception):
         nonlocal delay_secs, num_retries
-        logger.debug(f"Retrying RPC with delay {delay_secs}s due to error: {e}")
-        await asyncio.sleep(delay_secs)
+        # Clamp the backoff sleep to the remaining deadline so we don't sleep
+        # past it just to fail on the next iteration's deadline check.
+        sleep_for = delay_secs
+        if timeout_deadline is not None:
+            sleep_for = min(sleep_for, max(0.0, timeout_deadline - time.monotonic()))
+        logger.debug(f"Retrying RPC with delay {sleep_for}s due to error: {e}")
+        await asyncio.sleep(sleep_for)
         delay_secs *= delay_factor
         num_retries += 1
 
@@ -103,37 +122,28 @@ async def call_with_retries_on_transient_errors(
         try:
             return await func()
         except GRPCError as e:
-            if (max_retries is None or num_retries < max_retries) and is_retryable_status(e.status):
-                await sleep_and_update_delay_and_num_retries_remaining(e)
-            else:
-                raise e
+            if not is_retryable_status(e.status) or not can_retry():
+                raise
+            await sleep_and_advance(e)
         except AttributeError as e:
             # StreamTerminatedError are not properly raised in grpclib<=0.4.7
             # fixed in https://github.com/vmagamedov/grpclib/issues/185
             # TODO: update to newer version (>=0.4.8) once stable
-            if (max_retries is None or num_retries < max_retries) and "_write_appdata" in str(e):
-                await sleep_and_update_delay_and_num_retries_remaining(e)
-            else:
-                raise e
+            if "_write_appdata" not in str(e) or not can_retry():
+                raise
+            await sleep_and_advance(e)
         except StreamTerminatedError as e:
-            if max_retries is None or num_retries < max_retries:
-                await sleep_and_update_delay_and_num_retries_remaining(e)
-            else:
-                raise e
-        except asyncio.TimeoutError as e:
-            if expect_timeouts:
-                # grpclib raises TimeoutError for the client-side timeout/deadlines
-                raise ModalTimeoutError("Timeout expired")
-
-            if max_retries is None or num_retries < max_retries:
-                await sleep_and_update_delay_and_num_retries_remaining(e)
-            else:
-                raise ConnectionError(str(e))
-        except OSError as e:
-            if max_retries is None or num_retries < max_retries:
-                await sleep_and_update_delay_and_num_retries_remaining(e)
-            else:
+            if not can_retry():
+                raise
+            await sleep_and_advance(e)
+        except (asyncio.TimeoutError, OSError) as e:
+            if not can_retry():
+                # Client-side timeout / network OSError surfaces as a generic
+                # ConnectionError once we stop retrying. Callers that pass
+                # `timeout_deadline` can further translate this based on
+                # whether the deadline has elapsed.
                 raise ConnectionError(str(e))
+            await sleep_and_advance(e)
 
 
 async def fetch_command_router_access(server_client, task_id: str) -> api_pb2.TaskGetCommandRouterAccessResponse:
@@ -656,20 +666,34 @@ class TaskCommandRouterClient:
             )
 
     async def snapshot_filesystem(
-        self, request: sr_pb2.TaskSnapshotFilesystemRequest, *, timeout: Optional[int] = None, **kwargs
+        self, request: sr_pb2.TaskSnapshotFilesystemRequest, *, timeout: float, **kwargs
     ) -> sr_pb2.TaskSnapshotFilesystemResponse:
-        expect_timeouts = timeout is not None
-        with grpc_error_converter(expect_timeouts=expect_timeouts):
-            # note: TaskSnapshotFilesystem has a timeout concept with multiple variants:
-            # * Normally it would time out on the client side inside of grpclib - this causes an asyncio.TimeoutError
-            # * It also propagates the timeout to the server however, which could potentially trigger, in particular
-            #   if an in-progress requests is idempotently rejoined as a retry. These errors appear to be propagated
-            #   as Status.CANCELLED at the time of writing this, but we may change the backend to return
-            #   DEADLINE_EXCEEDED in the future, so we want to make the code compatible with both here:
-            return await call_with_retries_on_transient_errors(
-                lambda: self._call_with_auth_retry(
-                    self._stub.TaskSnapshotFilesystem, request, timeout=timeout, **kwargs
-                ),
-                exclude_status_codes=[Status.DEADLINE_EXCEEDED, Status.CANCELLED],
-                expect_timeouts=expect_timeouts,  # client wanted a timeout - raise as such immediately
+        # Compute the overall deadline once; each retry attempt passes the
+        # remaining budget as the per-call gRPC timeout so we honor the
+        # caller-specified `timeout` across retries instead of giving each
+        # attempt a fresh full window.
+        timeout_deadline = time.monotonic() + timeout
+
+        def call():
+            call_timeout = timeout_deadline - time.monotonic()
+            if call_timeout <= 0.0:
+                # doesn't matter which exception type this is
+                # as it will be caught by the catch all below
+                raise ModalTimeoutError("Timeout expired")
+
+            return self._call_with_auth_retry(
+                self._stub.TaskSnapshotFilesystem, request, timeout=call_timeout, **kwargs
             )
+
+        # Any failure observed at or after the deadline is treated as a timeout
+        try:
+            with grpc_error_converter():
+                return await call_with_retries_on_transient_errors(
+                    call,
+                    exclude_status_codes=[Status.DEADLINE_EXCEEDED, Status.CANCELLED],
+                    timeout_deadline=timeout_deadline,
+                )
+        except Exception:
+            if time.monotonic() >= timeout_deadline:
+                raise ModalTimeoutError("Timeout expired")
+            raise

modal/app.py

@@ -743,6 +743,7 @@ class _App:
         ] = None,  # Set this to True if it's a non-generator function returning a [sync/async] generator object
         cloud: Optional[str] = None,  # Cloud provider to run the function on. Possible values are aws, gcp, oci, auto.
         region: Optional[Union[str, Sequence[str]]] = None,  # Region or regions to run the function on.
+        routing_region: Optional[str] = None,  # Region to route inputs to the function through.
         nonpreemptible: bool = False,  # Whether to run the function on a nonpreemptible instance.
         enable_memory_snapshot: bool = False,  # Enable memory checkpointing for faster cold starts.
         block_network: bool = False,  # Whether to block network access
@@ -902,6 +903,7 @@ class _App:
                 startup_timeout=startup_timeout or timeout,
                 cloud=cloud,
                 region=region,
+                routing_region=routing_region,
                 nonpreemptible=nonpreemptible,
                 webhook_config=webhook_config,
                 enable_memory_snapshot=enable_memory_snapshot,
@@ -957,6 +959,7 @@ class _App:
         startup_timeout: Optional[int] = None,  # Maximum startup time in seconds with higher precedence than `timeout`.
         cloud: Optional[str] = None,  # Cloud provider to run the function on. Possible values are aws, gcp, oci, auto.
         region: Optional[Union[str, Sequence[str]]] = None,  # Region or regions to run the function on.
+        routing_region: Optional[str] = None,  # Region to route inputs to the function through.
         nonpreemptible: bool = False,  # Whether to run the function on a non-preemptible instance.
         enable_memory_snapshot: bool = False,  # Enable memory checkpointing for faster cold starts.
         block_network: bool = False,  # Whether to block network access
@@ -1100,6 +1103,7 @@ class _App:
                 startup_timeout=startup_timeout or timeout,
                 cloud=cloud,
                 region=region,
+                routing_region=routing_region,
                 nonpreemptible=nonpreemptible,
                 enable_memory_snapshot=enable_memory_snapshot,
                 block_network=block_network,

modal/app.pyi

@@ -490,6 +490,7 @@ class _App:
         is_generator: typing.Optional[bool] = None,
         cloud: typing.Optional[str] = None,
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        routing_region: typing.Optional[str] = None,
         nonpreemptible: bool = False,
         enable_memory_snapshot: bool = False,
         block_network: bool = False,
@@ -537,6 +538,7 @@ class _App:
         startup_timeout: typing.Optional[int] = None,
         cloud: typing.Optional[str] = None,
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        routing_region: typing.Optional[str] = None,
         nonpreemptible: bool = False,
         enable_memory_snapshot: bool = False,
         block_network: bool = False,
@@ -1208,6 +1210,7 @@ class App:
         is_generator: typing.Optional[bool] = None,
         cloud: typing.Optional[str] = None,
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        routing_region: typing.Optional[str] = None,
         nonpreemptible: bool = False,
         enable_memory_snapshot: bool = False,
         block_network: bool = False,
@@ -1255,6 +1258,7 @@ class App:
         startup_timeout: typing.Optional[int] = None,
         cloud: typing.Optional[str] = None,
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        routing_region: typing.Optional[str] = None,
         nonpreemptible: bool = False,
         enable_memory_snapshot: bool = False,
         block_network: bool = False,

modal/cli/shell.py

@@ -58,6 +58,23 @@ def _passed_forbidden_args(
     return passed_forbidden
 
 
+def _parse_experimental_options(options: Iterable[str]) -> dict[str, bool]:
+    parsed: dict[str, bool] = {}
+    for option in options:
+        key, sep, raw_value = option.partition("=")
+        if not key or not sep:
+            raise click.BadParameter("must use KEY=VALUE")
+
+        value = raw_value.lower()
+        if value in {"1", "true"}:
+            parsed[key] = True
+        elif value in {"0", "false"}:
+            parsed[key] = False
+        else:
+            raise click.BadParameter("BOOL must be one of true, false, 1, or 0")
+    return parsed
+
+
 def _is_valid_modal_id(ref: str, prefix: str) -> bool:
     assert prefix.endswith("-")
     return ref.startswith(prefix) and len(ref[len(prefix) :]) > 0 and ref[len(prefix) :].isalnum()
@@ -180,6 +197,7 @@ def _start_shell_from_function_spec(
     timeout: int,
     function_spec: _FunctionSpec,
     pty: bool,
+    experimental_options: dict[str, bool],
 ) -> None:
     interactive_shell(
         app,
@@ -198,6 +216,7 @@ def _start_shell_from_function_spec(
         region=function_spec.scheduler_placement.regions if function_spec.scheduler_placement else None,
         pty=pty,
         proxy=function_spec.proxy,
+        experimental_options=experimental_options,
     )
 
 
@@ -216,6 +235,7 @@ def _start_shell_from_image(
     cloud: Optional[str],
     region: Optional[str],
     pty: bool,
+    experimental_options: dict[str, bool],
 ) -> None:
     volumes = {f"/mnt/{vol}": Volume.from_name(vol) for vol in volume}
     secrets = [Secret.from_name(s) for s in secret]
@@ -246,6 +266,7 @@ def _start_shell_from_image(
         secrets=secrets,
         region=region.split(",") if region else [],
         pty=pty,
+        experimental_options=experimental_options,
     )
 
 
@@ -298,6 +319,14 @@ def _start_shell_from_image(
     default=False,
     help="Interpret argument as a Python module path instead of a file/script path",
 )
+@click.option(
+    "--experimental-option",
+    "experimental_options",
+    multiple=True,
+    default=(),
+    hidden=True,
+    metavar="KEY=VALUE",
+)
 def shell(
     ref: Optional[str] = None,
     cmd: str = "/bin/bash",
@@ -314,6 +343,7 @@ def shell(
     region: Optional[str] = None,
     pty: Optional[bool] = None,
     use_module_mode: bool = False,
+    experimental_options: tuple[str, ...] = (),
 ):
     """Run a command or interactive shell inside a Modal container.
 
@@ -384,12 +414,16 @@ def shell(
     # NB: invoking under bash makes --cmd a lot more flexible.
     cmds = shlex.split(f'/bin/bash -c "{cmd}"')
     timeout = 3600
+    parsed_experimental_options = _parse_experimental_options(experimental_options)
 
     if ref is not None and not _is_valid_modal_id(ref, "im-"):
         # If ref it not a Modal Image ID, then it's a function reference, and we'll start a new container from its spec.
         ctx = click.get_current_context()
         if passed_forbidden := _passed_forbidden_args(
-            shell.params, ctx, locals(), allowed=lambda p: p in {"cmd", "env", "pty", "ref", "use_module_mode"}
+            shell.params,
+            ctx,
+            locals(),
+            allowed=lambda p: p in {"cmd", "env", "pty", "ref", "use_module_mode", "experimental_options"},
         ):
             raise ClickException(
                 f"Cannot specify container configuration arguments ({', '.join(passed_forbidden)}) "
@@ -397,7 +431,7 @@ def shell(
             )
 
         function_spec = _function_spec_from_ref(ref, use_module_mode)
-        _start_shell_from_function_spec(app, cmds, env, timeout, function_spec, pty)
+        _start_shell_from_function_spec(app, cmds, env, timeout, function_spec, pty, parsed_experimental_options)
         return
 
     if ref is not None and _is_valid_modal_id(ref, "im-"):
@@ -428,4 +462,5 @@ def shell(
         cloud,
         region,
         pty,
+        parsed_experimental_options,
     )

modal/client.pyi

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

modal/functions.pyi

@@ -97,6 +97,7 @@ class Function(
         batch_wait_ms: typing.Optional[int] = None,
         cloud: typing.Optional[str] = None,
         region: typing.Union[str, collections.abc.Sequence[str], None] = None,
+        routing_region: typing.Optional[str] = None,
         nonpreemptible: bool = False,
         is_builder_function: bool = False,
         is_auto_snapshot: bool = False,

modal/image.py

@@ -59,7 +59,7 @@ from .mount import _Mount, python_standalone_mount_name
 from .network_file_system import _NetworkFileSystem
 from .output import OutputManager
 from .secret import _Secret
-from .volume import _Volume
+from .volume import _Volume, _volume_to_mount_proto
 
 if typing.TYPE_CHECKING:
     import modal._functions
@@ -631,15 +631,7 @@ class _Image(_Object, type_prefix="im"):
             validate_volumes_by_object_id(validated_volumes)
 
             # Relies on dicts being ordered (true as of Python 3.6).
-            volume_mounts = [
-                api_pb2.VolumeMount(
-                    mount_path=path,
-                    volume_id=volume.object_id,
-                    allow_background_commits=True,
-                    read_only=volume._read_only,
-                )
-                for path, volume in validated_volumes
-            ]
+            volume_mounts = [_volume_to_mount_proto(path, volume) for path, volume in validated_volumes]
 
             image_definition = api_pb2.Image(
                 base_images=base_images_pb2s,

modal/sandbox.py

@@ -21,7 +21,7 @@ from google.protobuf.message import Message
 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.volume import _Volume, _volume_to_mount_proto
 from modal_proto import api_pb2, task_command_router_pb2 as sr_pb2
 
 from ._load_context import LoadContext
@@ -301,15 +301,7 @@ class _Sandbox(_Object, type_prefix="sb"):
             validate_volumes_by_object_id(validated_volumes)
 
             # Relies on dicts being ordered (true as of Python 3.6).
-            volume_mounts = [
-                api_pb2.VolumeMount(
-                    mount_path=path,
-                    volume_id=volume.object_id,
-                    allow_background_commits=True,
-                    read_only=volume._read_only,
-                )
-                for path, volume in validated_volumes
-            ]
+            volume_mounts = [_volume_to_mount_proto(path, volume) for path, volume in validated_volumes]
 
             open_ports = [api_pb2.PortSpec(port=port, unencrypted=False) for port in encrypted_ports]
             open_ports.extend([api_pb2.PortSpec(port=port, unencrypted=True) for port in unencrypted_ports])

modal/volume.py

@@ -340,6 +340,24 @@ class _VolumeManager:
 VolumeManager = synchronize_api(_VolumeManager)
 
 
+@dataclass(frozen=True)
+class _VolumeMountOptions:
+    read_only: bool = False
+    sub_path: Optional[str] = None
+
+
+def _volume_to_mount_proto(path: str, volume: "_Volume") -> api_pb2.VolumeMount:
+    """Convert a Volume to a VolumeMount proto for use in Function/Sandbox definitions."""
+    mount_options = volume._mount_options or _VolumeMountOptions()
+    return api_pb2.VolumeMount(
+        mount_path=path,
+        volume_id=volume.object_id,
+        allow_background_commits=True,
+        read_only=mount_options.read_only,
+        sub_path=mount_options.sub_path,
+    )
+
+
 class _Volume(_Object, type_prefix="vo"):
     """A writeable volume that can be used to share files between one or more Modal functions.
 
@@ -384,8 +402,24 @@ class _Volume(_Object, type_prefix="vo"):
 
     _lock: Optional[asyncio.Lock] = None
     _metadata: "typing.Optional[api_pb2.VolumeMetadata]"
+    _mount_options: Optional[_VolumeMountOptions] = None
+    # Client-side read-only flag from the deprecated .read_only() method. Unlike
+    # _mount_options.read_only (which only configures the server-side mount), this
+    # flag triggers client-side InvalidError on mutating calls like batch_upload().
     _read_only: bool = False
 
+    def _initialize_from_empty(self):
+        self._metadata = None
+        self._mount_options = None
+        self._read_only = False
+
+    def _initialize_from_other(self, other):
+        super()._initialize_from_other(other)
+        self._metadata = other._metadata
+        self._mount_options = other._mount_options
+        self._read_only = other._read_only
+        self._name = other._name
+
     @classproperty
     @classmethod
     def objects(cls) -> _VolumeManager:
@@ -396,41 +430,105 @@ class _Volume(_Object, type_prefix="vo"):
         return self._name
 
     def read_only(self) -> "_Volume":
-        """Configure Volume to mount as read-only.
+        """mdmd:hidden"""
+
+        # Silently deprecated in favor of `with_mount_options(read_only=True)`.
+        if self._mount_options is not None:
+            raise InvalidError(
+                "Cannot call read_only() on a Volume that has with_mount_options() applied. "
+                "Use with_mount_options(read_only=True, ...) instead. Note that with_mount_options(read_only=True) "
+                "only configures the server-side mount and does not block client-side Volume SDK methods."
+            )
+        mount_options = _VolumeMountOptions(read_only=True)
 
-        **Example**
+        async def _load(
+            new_volume: _Volume, resolver: Resolver, load_context: LoadContext, existing_object_id: Optional[str]
+        ):
+            new_volume._initialize_from_other(self)
+            new_volume._mount_options = mount_options
+            new_volume._read_only = True
 
+        new_volume = _Volume._from_loader(
+            _load,
+            "Volume()",
+            hydrate_lazily=True,
+            deps=lambda: [self],
+            load_context_overrides=self._load_context_overrides,
+        )
+        new_volume._initialize_from_other(self)
+        new_volume._mount_options = mount_options
+        new_volume._read_only = True
+        return new_volume
+
+    def with_mount_options(
+        self,
+        *,
+        read_only: Optional[bool] = None,
+        sub_path: Optional[Union[str, PurePosixPath]] = None,
+    ) -> "_Volume":
+        """Configure options used when mounting this Volume.
+
+        Note that these options are not properties stored with the Volume itself - they can be individually configured
+        for each Volume - container association.
+
+        read_only: bool (optional) - set this to True to make the Volume read only from within containers
+        sub_path: str | PurePosixPath (optional) - only mount this sub_path directory from the Volume.
+            If the directory doesn't exist in the Volume, it will be created when the container starts up
+
+
+        **Mount Volume in read-only mode**
         ```python
         import modal
 
-        volume = modal.Volume.from_name("my-volume", create_if_missing=True)
+        volume = modal.Volume.from_name("my-volume")
 
-        @app.function(volumes={"/mnt/items": volume.read_only()})
+        @app.function(volumes={"/mnt": volume.with_mount_options(read_only=True)})
         def f():
-            with open("/mnt/items/my-file.txt") as f:
-                return f.read()
+            return os.mkdir("/mnt/foo")  # not possible!
         ```
 
-        The Volume is mounted as a read-only volume in a function. Any file system write operation into the
-        mounted volume will result in an error.
+        **Mount only part of a Volume using sub_path**
+        ```python
+        import modal
+
+        volume = modal.Volume.from_name("my-volume")
 
-        Added in v1.0.5.
+        @app.function(volumes={"/user_data": volume.with_mount_options(sub_path="/users/my_user")})
+        def f():
+            return os.listdir("/user_data")  # lists data from /users/my_user
+        ```
         """
+        if self._read_only:
+            raise InvalidError(
+                "Cannot call with_mount_options() on a Volume that has .read_only() applied. "
+                "Use with_mount_options(read_only=True, ...) instead. Note that with_mount_options(read_only=True) "
+                "only configures the server-side mount and does not block client-side Volume SDK methods."
+            )
+        current_mount_options = self._mount_options or _VolumeMountOptions()
+        normalized_sub_path = current_mount_options.sub_path
+        if sub_path is not None:
+            # Normalize sub_path: "/" means whole volume (same as None)
+            path_str = PurePosixPath(sub_path).as_posix()
+            normalized_sub_path = None if path_str == "/" else path_str
+        read_only = current_mount_options.read_only if read_only is None else read_only
+        mount_options = _VolumeMountOptions(read_only=read_only, sub_path=normalized_sub_path)
 
         async def _load(
             new_volume: _Volume, resolver: Resolver, load_context: LoadContext, existing_object_id: Optional[str]
         ):
             new_volume._initialize_from_other(self)
-            new_volume._read_only = True
+            new_volume._mount_options = mount_options
 
-        obj = _Volume._from_loader(
+        new_volume = _Volume._from_loader(
             _load,
             "Volume()",
             hydrate_lazily=True,
             deps=lambda: [self],
             load_context_overrides=self._load_context_overrides,
         )
-        return obj
+        new_volume._initialize_from_other(self)
+        new_volume._mount_options = mount_options
+        return new_volume
 
     def _hydrate_metadata(self, metadata: Optional[Message]):
         if metadata:

modal/volume.pyi

@@ -416,6 +416,40 @@ class VolumeManager:
 
     delete: __delete_spec
 
+class _VolumeMountOptions:
+    """_VolumeMountOptions(read_only: bool = False, sub_path: Optional[str] = None)"""
+
+    read_only: bool
+    sub_path: typing.Optional[str]
+
+    def __init__(self, read_only: bool = False, sub_path: typing.Optional[str] = None) -> None:
+        """Initialize self.  See help(type(self)) for accurate signature."""
+        ...
+
+    def __repr__(self):
+        """Return repr(self)."""
+        ...
+
+    def __eq__(self, other):
+        """Return self==value."""
+        ...
+
+    def __setattr__(self, name, value):
+        """Implement setattr(self, name, value)."""
+        ...
+
+    def __delattr__(self, name):
+        """Implement delattr(self, name)."""
+        ...
+
+    def __hash__(self):
+        """Return hash(self)."""
+        ...
+
+def _volume_to_mount_proto(path: str, volume: _Volume) -> modal_proto.api_pb2.VolumeMount:
+    """Convert a Volume to a VolumeMount proto for use in Function/Sandbox definitions."""
+    ...
+
 class _Volume(modal._object._Object):
     """A writeable volume that can be used to share files between one or more Modal functions.
 
@@ -460,33 +494,57 @@ class _Volume(modal._object._Object):
 
     _lock: typing.Optional[asyncio.locks.Lock]
     _metadata: typing.Optional[modal_proto.api_pb2.VolumeMetadata]
+    _mount_options: typing.Optional[_VolumeMountOptions]
     _read_only: bool
 
+    def _initialize_from_empty(self): ...
+    def _initialize_from_other(self, other): ...
     @synchronicity.classproperty
     @classmethod
     def objects(cls) -> _VolumeManager: ...
     @property
     def name(self) -> typing.Optional[str]: ...
     def read_only(self) -> _Volume:
-        """Configure Volume to mount as read-only.
+        """mdmd:hidden"""
+        ...
+
+    def with_mount_options(
+        self,
+        *,
+        read_only: typing.Optional[bool] = None,
+        sub_path: typing.Union[str, pathlib.PurePosixPath, None] = None,
+    ) -> _Volume:
+        """Configure options used when mounting this Volume.
+
+        Note that these options are not properties stored with the Volume itself - they can be individually configured
+        for each Volume - container association.
 
-        **Example**
+        read_only: bool (optional) - set this to True to make the Volume read only from within containers
+        sub_path: str | PurePosixPath (optional) - only mount this sub_path directory from the Volume.
+            If the directory doesn't exist in the Volume, it will be created when the container starts up
 
+
+        **Mount Volume in read-only mode**
         ```python
         import modal
 
-        volume = modal.Volume.from_name("my-volume", create_if_missing=True)
+        volume = modal.Volume.from_name("my-volume")
 
-        @app.function(volumes={"/mnt/items": volume.read_only()})
+        @app.function(volumes={"/mnt": volume.with_mount_options(read_only=True)})
         def f():
-            with open("/mnt/items/my-file.txt") as f:
-                return f.read()
+            return os.mkdir("/mnt/foo")  # not possible!
         ```
 
-        The Volume is mounted as a read-only volume in a function. Any file system write operation into the
-        mounted volume will result in an error.
+        **Mount only part of a Volume using sub_path**
+        ```python
+        import modal
+
+        volume = modal.Volume.from_name("my-volume")
 
-        Added in v1.0.5.
+        @app.function(volumes={"/user_data": volume.with_mount_options(sub_path="/users/my_user")})
+        def f():
+            return os.listdir("/user_data")  # lists data from /users/my_user
+        ```
         """
         ...
 
@@ -792,37 +850,61 @@ class Volume(modal.object.Object):
 
     _lock: typing.Optional[asyncio.locks.Lock]
     _metadata: typing.Optional[modal_proto.api_pb2.VolumeMetadata]
+    _mount_options: typing.Optional[_VolumeMountOptions]
     _read_only: bool
 
     def __init__(self, *args, **kwargs):
         """mdmd:hidden"""
         ...
 
+    def _initialize_from_empty(self): ...
+    def _initialize_from_other(self, other): ...
     @synchronicity.classproperty
     @classmethod
     def objects(cls) -> VolumeManager: ...
     @property
     def name(self) -> typing.Optional[str]: ...
     def read_only(self) -> Volume:
-        """Configure Volume to mount as read-only.
+        """mdmd:hidden"""
+        ...
+
+    def with_mount_options(
+        self,
+        *,
+        read_only: typing.Optional[bool] = None,
+        sub_path: typing.Union[str, pathlib.PurePosixPath, None] = None,
+    ) -> Volume:
+        """Configure options used when mounting this Volume.
+
+        Note that these options are not properties stored with the Volume itself - they can be individually configured
+        for each Volume - container association.
 
-        **Example**
+        read_only: bool (optional) - set this to True to make the Volume read only from within containers
+        sub_path: str | PurePosixPath (optional) - only mount this sub_path directory from the Volume.
+            If the directory doesn't exist in the Volume, it will be created when the container starts up
 
+
+        **Mount Volume in read-only mode**
         ```python
         import modal
 
-        volume = modal.Volume.from_name("my-volume", create_if_missing=True)
+        volume = modal.Volume.from_name("my-volume")
 
-        @app.function(volumes={"/mnt/items": volume.read_only()})
+        @app.function(volumes={"/mnt": volume.with_mount_options(read_only=True)})
         def f():
-            with open("/mnt/items/my-file.txt") as f:
-                return f.read()
+            return os.mkdir("/mnt/foo")  # not possible!
         ```
 
-        The Volume is mounted as a read-only volume in a function. Any file system write operation into the
-        mounted volume will result in an error.
+        **Mount only part of a Volume using sub_path**
+        ```python
+        import modal
+
+        volume = modal.Volume.from_name("my-volume")
 
-        Added in v1.0.5.
+        @app.function(volumes={"/user_data": volume.with_mount_options(sub_path="/users/my_user")})
+        def f():
+            return os.listdir("/user_data")  # lists data from /users/my_user
+        ```
         """
         ...
 

{modal-1.4.3.dev30.dist-info → modal-1.4.4.dev0.dist-info}/METADATA

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

{modal-1.4.3.dev30.dist-info → modal-1.4.4.dev0.dist-info}/RECORD

@@ -5,9 +5,9 @@ modal/_clustered_functions.py,sha256=7amiOxErtlciWeBJBL2KvaxerUomJpTAJ3qElflFHQA
 modal/_clustered_functions.pyi,sha256=JmYwAGOLEnD5AF-gYF9O5tu-SgGjeoJz-X1j48b1Ijg,1157
 modal/_container_entrypoint.py,sha256=_dyBqh_3KFn1M8S2Z4upvHT1rAYvxggz8-uCb3N6w5Q,20994
 modal/_environments.py,sha256=uEjww31OATuKS-AYvxRjvbkSy_zRnraN9H5GkJJ6Xno,17625
-modal/_function_variants.py,sha256=lvmF5a6pTNPHMkEipHBjjvId0jtxB3iTiNTwSwzp38I,11166
-modal/_functions.py,sha256=yVHaFEb9_el0XrbLKA-hoHI1xUtc1O639-GM4b1RUsY,89061
-modal/_grpc_client.py,sha256=TQ5LYcdMIVybijv8xCHPjsm3BDa7OT9EfHU1cUJcj4w,7325
+modal/_function_variants.py,sha256=Xmet85lFEv2rT_nTPvlbfw8T09GzeN5Rx5JDdMXbhCU,10989
+modal/_functions.py,sha256=qhi23PoA8JgH0XGfxZL5b6adUcSS7s8FmuzshlcCor8,89036
+modal/_grpc_client.py,sha256=G8gWQXChtsuRgyXK9kcPiPNYXOYbl_m9Bz2AVBJb-zs,6924
 modal/_ipython.py,sha256=Bu9fc3hm3xt2O47qLe_d-Mu2jS81LwMsmXNJ1sawBA0,575
 modal/_load_context.py,sha256=DvfOWNTevEmHqdlu0-AeO_03JChrmAjoupgppPVW2Pc,4867
 modal/_location.py,sha256=joiX-0ZeutEUDTrrqLF1GHXCdVLF-rHzstocbMcd_-k,366
@@ -23,12 +23,12 @@ modal/_tunnel.py,sha256=ixQGklCn6eV2TekgET8o0ZD9dEo36Iw_grUsg-S5Bhg,7084
 modal/_tunnel.pyi,sha256=FoedJzHymbPk4Bmnbszm6uhay2rMq1JS9mIiHELYf3k,13804
 modal/_type_manager.py,sha256=DWjgmjYJuOagw2erin506UUbG2H5UzZCFEekS-7hmfA,9087
 modal/_watcher.py,sha256=LerzeKqyGKOlPw9caRGnIyjcZTFXe5YvmeZ2grT2_q8,3539
-modal/app.py,sha256=WYfJySrzxSoV2yThLTBMTBar6aNFJRuYIeYyUb4_TK8,62548
-modal/app.pyi,sha256=1Ghrrc5suME_WUXYjdBTYDlkv41u3BKD9778KAtGWbc,53864
+modal/app.py,sha256=s9AZNpis2NwTFnmb1InK-Y4qPHCYXrgEoB69EsM3J-s,62836
+modal/app.pyi,sha256=NP1ni_ljQ8uxgywJFuNnTTLvAUPz1Cij1gVSrtptVX0,54076
 modal/billing.py,sha256=B2zXa7KeMnpqi2AQINycEk-KSXVYaLTTTAQTtuf2Gfs,257
 modal/call_graph.py,sha256=1g2DGcMIJvRy-xKicuf63IVE98gJSnQsr8R_NVMptNc,2581
 modal/client.py,sha256=jjT4eLFHGcvIF6Xw4kPptIx-VmExtphRN8XJ1JA7fWI,15502
-modal/client.pyi,sha256=edFNUAAMiVsVXuNwqPHveI90oh9dO6R2nBWJEHdG2Jw,15703
+modal/client.pyi,sha256=3QdGRynAOZ7EI_54u3Ic0oSNaoK2Q3x1WhJ7ElEf88Y,15701
 modal/cloud_bucket_mount.py,sha256=KkaJVy5vpO_u2NtDYtv1JM-M3y4J0UtWBapTDKpQRcA,6034
 modal/cloud_bucket_mount.pyi,sha256=mGDeEd1XvxGpCE6O5jRBSfIvMXvZ5AtIybea5k-0w9w,7560
 modal/cls.py,sha256=UTtp9W3SuFIbkYEE2D94SUzKiMXM5BYgfHGzBQD6CEk,38304
@@ -45,8 +45,8 @@ modal/file_io.py,sha256=DYQXrPUNkKG-0lyzc81E3rh7g56Fg5y6eIQkTqhfqbU,22015
 modal/file_io.pyi,sha256=DPaq0BhySaiCX3g56QHhyIMdU1izbfWsjpSp30JoJUU,15745
 modal/file_pattern_matcher.py,sha256=A_Kdkej6q7YQyhM_2-BvpFmPqJ0oHb54B6yf9VqvPVE,8116
 modal/functions.py,sha256=EZRcHFfnoYbvawUJnAHF5nIvoo9GX2Djy7mUmOCXmXc,258
-modal/functions.pyi,sha256=olNUSsi5dgrvbQAWQzJeuUziI5wSFp7r0P_46WLdcZ0,37887
-modal/image.py,sha256=K-105RcY39Kq8uC4toG6WOMTnAVlPn_6P8J_DiNxiyQ,113430
+modal/functions.pyi,sha256=oQbuXhpMhPmOvDK5YvDaC19iGqa_gbtPG8yTe8MOhz4,37940
+modal/image.py,sha256=1iHT8KmdWtvIfusupTf_AJGBMUI4PQuAciBp-f_uYL0,113221
 modal/image.pyi,sha256=FUAY23rnaUmpRBVazrzh3Z3b9tYTMikbyk2SbuIpihI,81004
 modal/io_streams.py,sha256=15dSqTktIFvqANRDO8pjFjuwgybGAdRBorEM-3ag-fw,25000
 modal/io_streams.pyi,sha256=xCXvb8MxXwytsh2cKXQ3ZUizOOYlXJbEc_2qRiB8DZw,19232
@@ -70,7 +70,7 @@ modal/retries.py,sha256=vPWWKP-FRolJwTBuLPXdWqHV7aJfSQFgEW7vhlBBXRQ,5067
 modal/runner.py,sha256=GLx_JwZ2hpA5yuHMY2b2Gt8Ri-KxJZHF2Zp1N_qVLD4,30144
 modal/runner.pyi,sha256=7QHbZawq1P5N9DiSrrEYtXtBCDAWlRibNonBO0q6MdM,9570
 modal/running_app.py,sha256=v61mapYNV1-O-Uaho5EfJlryMLvIT9We0amUOSvSGx8,1188
-modal/sandbox.py,sha256=DpnLovZwNgluZgjhCYy5ImbjfwEOeWsSFA4UIk4u6vc,83630
+modal/sandbox.py,sha256=QLksqBwaKO3Qbon0B9teIS1Ssns16reQIuXecR-vojY,83421
 modal/sandbox.pyi,sha256=aetTQ_YcMh4YF3NIdJs76gaY7LL72SVeQYN_ge-yDmU,85909
 modal/sandbox_fs.py,sha256=3EGten2nvZ7H451FnH0gbFXcdLvQtQNVX-7qI0TtT3c,22472
 modal/sandbox_fs.pyi,sha256=01VyLN0AIplD45qh8F6NJXYj5YxGPaqRETMp4rDLZcQ,35036
@@ -87,8 +87,8 @@ modal/snapshot.pyi,sha256=vMYDx1s9Ds4qtH-PXgB_9RzVuS5wsTchVcclR5Q-mmM,2014
 modal/stream_type.py,sha256=A6320qoAAWhEfwOCZfGtymQTu5AfLfJXXgARqooTPvY,417
 modal/token_flow.py,sha256=muvMsYAcLB2X1s61K-ChGNnu-vPpQUW1N8IYOrA8eho,7036
 modal/token_flow.pyi,sha256=5zdXJ5SLLHM4j6xSPuEvnpSeEJBbzE6NkSX-MSyE5wM,2282
-modal/volume.py,sha256=YFfzcGRA41pZk6gJSd7VYqVxNWJWubjVv2cJpBHcLOc,56414
-modal/volume.pyi,sha256=nOTgO1HThjldwxcUSw8S534BMNYooDGK1sI4ySnHQ6o,56189
+modal/volume.py,sha256=d8nQVfSJqW7d3NFjJ6aJyXrrH71j6fKJjN5KFLwpWBM,60864
+modal/volume.pyi,sha256=jymbcDonHUk2W4phnP9bF-fzyQpdaPGR02rdeYk3oEk,59220
 modal/_output/__init__.py,sha256=xtGN6SPv2zvByrJ32JPao0yJKpxyCIZ-2JMTScrisuQ,28
 modal/_output/manager.py,sha256=8JGUm8S1PfiibvyI1t_pcniktZbe8KAV1TvLtoZ80rk,18161
 modal/_output/pty.py,sha256=wniYe_MW9_pEhCjDgRyrruYJNNtZoAJ0MuOOl3UrGI0,10174
@@ -121,14 +121,14 @@ modal/_utils/hash_utils.py,sha256=zg3J6OGxTFGSFri1qQ12giDz90lWk8bzaxCTUCRtiX4,30
 modal/_utils/http_utils.py,sha256=yeTFsXYr0rYMEhB7vBP7audG9Uc7OLhzKBANFDZWVt0,2451
 modal/_utils/jwt_utils.py,sha256=fxH9plyrbAemTbjSsQtzIdDXE9QXxvMC4DiUZ16G0aA,1360
 modal/_utils/logger.py,sha256=NgbMKFT9chYYt_TU01DdIior5ByYr2gZtrWIk1SFRLc,1782
-modal/_utils/mount_utils.py,sha256=YlWhO_aaQjl_yDK-Fo0dzbGQav5-tHL1H5FDEIT9bxo,5082
+modal/_utils/mount_utils.py,sha256=9Cl2JHJ_nxKt4t0W7UC8lidAwD486q78wnVY8-OaqWs,5080
 modal/_utils/name_utils.py,sha256=Im2A4zeberAAfTxPRSx46ILE_pIWIE1f-GxIYulFOSE,2517
 modal/_utils/package_utils.py,sha256=jYE7WFVzYWIfO0ZJhno_BYHb6Skp48uupOiw1a3yWzw,2056
 modal/_utils/pattern_utils.py,sha256=ZUffaECfe2iYBhH6cvCB-0-UWhmEBTZEl_TwG_So3ag,6714
 modal/_utils/rand_pb_testing.py,sha256=OYfbSeEXNMgwy-nAi4hHbgZdb08Ss3BV6TyJp6-gwNs,4360
 modal/_utils/sandbox_fs_utils.py,sha256=lfYcYA8wQgnUWtSC0UxRzrEThFWOY5ppuA0GJeYzhrg,13914
 modal/_utils/shell_utils.py,sha256=GjMrO1YxnBr4_UlpA2ZYQKCHxV78QTg0mqxAMHWGTE4,3427
-modal/_utils/task_command_router_client.py,sha256=s1Ni3cyke1LHCIAsXONA_mQZXvjGU-dSbWd08csatE8,30870
+modal/_utils/task_command_router_client.py,sha256=O116m39h569JgpF8w5zA3g9UzWJcsRKYKNG08Wcyaac,31510
 modal/_utils/time_utils.py,sha256=PBMHCGzysBVaEnsjc0BSf0bPdSOSXeV11rtTAu5vvus,8451
 modal/_vendor/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0VESpjWR0fc,28
 modal/_vendor/a2wsgi_wsgi.py,sha256=Q1AsjpV_Q_vzQsz_cSqmP9jWzsGsB-ARFU6vpQYml8k,21878
@@ -167,7 +167,7 @@ modal/cli/queues.py,sha256=Nz_gkmlz8c2DqbL3GZnIcdmaHjC8Sj5wl55qq17kty4,6565
 modal/cli/run.py,sha256=aTfa5P44_W2LbUVdjYND4kvr8-G1qLHCSYUNilHkLwA,22656
 modal/cli/secret.py,sha256=_YEeQ0HSRXXZgf7Bx990D4B7kzRamNDLlEd92uqK6O4,8252
 modal/cli/selector.py,sha256=OJr9Ua3K_l-qu3N3-I8z8oVq8lBakws2-XgfheR5p-c,4741
-modal/cli/shell.py,sha256=tzcNuCCZk_0nhUT-jQK824BzDQYuWc_N73nhmwwmROU,14970
+modal/cli/shell.py,sha256=2oD_MtbkazowubdryGWfhHqO44Sa3Lv7bpENmF68ghc,16132
 modal/cli/token.py,sha256=Km7V7pHXsNKyjOCEdioQT8-o04Rh2-PzmNpiL1_i8tw,4352
 modal/cli/utils.py,sha256=CUNFXLcV8EJymZCTXettHDJTDBJi73uHMywayr0ytow,6305
 modal/cli/volume.py,sha256=pP1yqWCwzy1IP-_BbUKZKysdx7sMI5RT5jZUkj1DPsc,11514
@@ -178,7 +178,7 @@ modal/experimental/__init__.py,sha256=Wb1YoAKAnNxH_0c2wA0T12I7bSu9PSO2nS_LuLska7
 modal/experimental/flash.py,sha256=M-mDFR02V57EzXMuetG_DIkeqe-FATZbh29JAIcLxwU,33361
 modal/experimental/flash.pyi,sha256=RiJXdAUnKmLWpdDzeFhXzClMc5mIr_inbn_cptm_wOI,17003
 modal/experimental/ipython.py,sha256=TrCfmol9LGsRZMeDoeMPx3Hv3BFqQhYnmD_iH0pqdhk,2904
-modal-1.4.3.dev30.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.4.4.dev0.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
 modal_docs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal_docs/gen_cli_docs.py,sha256=bfUSLscHfoQoKkKjIqJvQMe3fURzqcQK7gF1h9WQLtM,3742
 modal_docs/gen_cli_docs_main.py,sha256=UPGr7O1DYTIRLwfINe2rbdh89J3cPVTU1OWL-SjxnOQ,198
@@ -190,7 +190,7 @@ modal_docs/mdmd/signatures.py,sha256=XJaZrK7Mdepk5fdX51A8uENiLFNil85Ud0d4MH8H5f0
 modal_proto/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0VESpjWR0fc,28
 modal_proto/api_grpc.py,sha256=m0qewo8OuWxTAQkTN0-_mBX9V3DJTWJ0Gw-jo4Ug_x8,153908
 modal_proto/api_pb2.py,sha256=X5MKLTgGelUZOUY0tfiCT9MbKIHOFcHZOeAANHDY8Ko,432024
-modal_proto/api_pb2.pyi,sha256=5ooPDCEwivBFNVBGdj5yAIiNcgSp8OZdf77o5Qa3i5U,606061
+modal_proto/api_pb2.pyi,sha256=h4Gnl57ovADVWo9keEnSmE8O44py3RBKlnCEjZ_YXhw,606063
 modal_proto/api_pb2_grpc.py,sha256=-ulRQTC92M00MDa7O2OKABgwgq3w5MYKbQAem9QLBTg,331488
 modal_proto/api_pb2_grpc.pyi,sha256=R3HeGMYv8cTBuzohYodGZf63g_1EILXUj9IfuWdQJMQ,77441
 modal_proto/modal_api_grpc.py,sha256=uLaaPRcnDBe_MQkShJ2Zpw1MtcbF10yjMEF5YNFtjmw,24293
@@ -200,10 +200,10 @@ modal_proto/task_command_router_pb2.py,sha256=-K4H-C7N-ILpdvFyM4PQMZcGZvXV1J89mf
 modal_proto/task_command_router_pb2.pyi,sha256=KNM7lPtngiv0_Ni_1zRg1rl65ynyjN8vpzd3XISxMGo,37281
 modal_proto/task_command_router_pb2_grpc.py,sha256=368j8b_h19L7bidFTRGSdSG4bK0zU9Y_Oq46_B2ACDg,34666
 modal_proto/task_command_router_pb2_grpc.pyi,sha256=PbzkCj-uSlN1inYSdhncPQ1-04vhBnj3Wzvb-D2pLHY,11226
-modal_version/__init__.py,sha256=GWSnPzlxpsx5SoO7zuyk-a4fyTGrrv4G9Twri6HwLFs,121
+modal_version/__init__.py,sha256=PDlj-Uj0cww12-YJ8DVmqiHyARKWhHEhET6YgIsmqXc,120
 modal_version/__main__.py,sha256=nLUbubxKx7GXNzJIkTB7M7_u8080LyLM0IS0rzFkC_c,119
-modal-1.4.3.dev30.dist-info/METADATA,sha256=z4YKSLlNvO7RDpVrBD_3m9mWp_zfYYhOCn16_i0xGVc,2339
-modal-1.4.3.dev30.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-modal-1.4.3.dev30.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.4.3.dev30.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.4.3.dev30.dist-info/RECORD,,
+modal-1.4.4.dev0.dist-info/METADATA,sha256=ebODN8NcflHVOrVzI6sqwPMyhjW_9Sio_9FP0rdWdZc,2338
+modal-1.4.4.dev0.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+modal-1.4.4.dev0.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.4.4.dev0.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.4.4.dev0.dist-info/RECORD,,

modal_proto/api_pb2.pyi

@@ -5614,7 +5614,7 @@ class Function(google.protobuf.message.Message):
     is_server: builtins.bool
     """When True, the function is a server function"""
     routing_region: builtins.str
-    """Where calls to a function should be routed through."""
+    """Where inputs to a function should be routed through."""
     def __init__(
         self,
         *,
@@ -6247,7 +6247,7 @@ class FunctionData(google.protobuf.message.Message):
     is_server: builtins.bool
     """When True, the function is a server function"""
     routing_region: builtins.str
-    """Where calls to a function should be routed through."""
+    """Where inputs to a function should be routed through."""
     def __init__(
         self,
         *,

modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2026
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.4.3.dev30"
+__version__ = "1.4.4.dev0"