modal 1.5.2.dev13__tar.gz → 1.5.2.dev14__tar.gz

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/PKG-INFO

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

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/_utils/grpc_utils.py

@@ -31,7 +31,7 @@ from modal_version import __version__
 
 from .._traceback import suppress_tb_frame
 from ..config import config
-from .async_utils import retry
+from .async_utils import TaskContext, retry
 from .logger import logger
 
 RequestType = TypeVar("RequestType", bound=Message)
@@ -190,14 +190,7 @@ class ConnectionManager:
 
     async def get_or_create_channel(self, server_url: str) -> grpclib.client.Channel:
         if server_url not in self._channels:
-            self._channels[server_url] = create_channel(
-                server_url,
-                self._metadata,
-            )
-            try:
-                await connect_channel(self._channels[server_url])
-            except (OSError, asyncio.TimeoutError) as exc:
-                raise ConnectionError("Could not connect to the Modal server.") from exc
+            self._channels[server_url] = await create_channel_with_fallbacks(server_url, self._metadata)
         return self._channels[server_url]
 
     def close(self):
@@ -296,6 +289,12 @@ def create_channel(
         for k, v in metadata.items():
             event.metadata[k] = v
 
+        if o.hostname is not None:
+            # GRPC actually injects a :authority pseudo-header containing the hostname.
+            # But this gets stripped out by the C/C++ extension server-side and is hard to fix.
+            # So let's just add a separate header we can parse easily.
+            event.metadata["x-modal-host"] = o.hostname
+
         idempotency_key = typing.cast(Optional[str], event.metadata.get("x-idempotency-key"))
         if idempotency_key is None:
             logger.debug(f"Sending request to {event.method_name}")
@@ -314,6 +313,47 @@ async def connect_channel(channel: grpclib.client.Channel):
     await channel.__connect__()
 
 
+async def create_channel_with_fallbacks(
+    server_url: str,
+    metadata: dict[str, str] = {},
+    stagger_delay: float = 1.0,
+) -> grpclib.client.Channel:
+    """Create a connected channel, supporting comma-separated fallback URLs.
+
+    `server_url` may be a single URL or a comma-separated list of URLs. The connection attempts
+    are raced against each other and the first one to connect wins, which lets the client fail
+    over to a secondary endpoint when the primary is unreachable (e.g. a DNS outage on the
+    primary's domain). Attempts are staggered: the candidate at index `i` waits `i * stagger_delay`
+    seconds before starting, so earlier URLs (e.g. the primary) get a head start and are preferred
+    when reachable. Losing attempts are cancelled and their channels closed.
+    """
+    urls = [url.strip() for url in server_url.split(",")]
+
+    async def connect(index: int, url: str) -> grpclib.client.Channel:
+        # Stagger the start so earlier URLs are preferred; once started, all attempts race.
+        await asyncio.sleep(index * stagger_delay)
+        channel = create_channel(url, metadata)
+        try:
+            await connect_channel(channel)
+        except BaseException:
+            # Close the channel of a losing/cancelled attempt so its socket doesn't leak.
+            channel.close()
+            raise
+        return channel
+
+    first_exc: BaseException | None = None
+    async with TaskContext() as tc:
+        tasks = [tc.create_task(connect(i, url)) for i, url in enumerate(urls)]
+        for attempt in asyncio.as_completed(tasks):
+            try:
+                return await attempt
+            except Exception as exc:
+                if first_exc is None:
+                    first_exc = exc
+
+    raise ConnectionError("Could not connect to the Modal server.") from first_exc
+
+
 if typing.TYPE_CHECKING:
     import modal.client
 

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/_utils/task_command_router_client.py

@@ -811,13 +811,25 @@ class TaskCommandRouterClient:
                 lambda: self._call_with_auth_retry(self._stub.TaskSetNetworkAccess, request)
             )
 
-    async def reload_volumes(self, task_id: str) -> sr_pb2.TaskReloadVolumesResponse:
-        """Reload all Volumes mounted in the task to reflect their latest committed state."""
+    async def reload_volumes(self, task_id: str, timeout: float) -> sr_pb2.TaskReloadVolumesResponse:
+        """Reload all Volumes mounted in the task to reflect their latest committed state.
+
+        Args:
+            task_id: The task whose mounted Volumes should be reloaded.
+            timeout: Client-side deadline in seconds. If the reload does not complete within this
+                window, the call is cancelled and a `modal.exception.TimeoutError` is raised.
+        """
         request = sr_pb2.TaskReloadVolumesRequest(task_id=task_id)
         with grpc_error_converter():
-            return await call_with_retries_on_transient_errors(
-                lambda: self._call_with_auth_retry(self._stub.TaskReloadVolumes, request)
-            )
+            try:
+                return await asyncio.wait_for(
+                    call_with_retries_on_transient_errors(
+                        lambda: self._call_with_auth_retry(self._stub.TaskReloadVolumes, request, timeout=timeout),
+                    ),
+                    timeout=timeout,
+                )
+            except asyncio.TimeoutError:
+                raise ModalTimeoutError("Timeout expired")
 
     async def _snapshot_with_deadline(self, rpc, request, *, timeout: float, **kwargs):
         # helper method for snapshot_directory and snapshot_filesystem to handle grpc

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/_workspace.py

@@ -125,6 +125,10 @@ class _Workspace(_Object, type_prefix="ac"):
     def proxy_tokens(self) -> "_WorkspaceProxyTokenManager":
         return _WorkspaceProxyTokenManager(self)
 
+    @property
+    def settings(self) -> "_WorkspaceSettingsManager":
+        return _WorkspaceSettingsManager(self)
+
 
 @dataclass(frozen=True)
 class TokenData:
@@ -340,3 +344,79 @@ class _WorkspaceBillingManager:
             BillingReportItem._from_proto(pb_item)
             async for pb_item in self._workspace.client.stub.WorkspaceBillingReport.unary_stream(request)
         ]
+
+
+@dataclass(frozen=True)
+class WorkspaceSettings:
+    """Current settings for the workspace."""
+
+    default_environment: str
+    image_builder_version: str
+
+
+class _WorkspaceSettingsManager:
+    """mdmd:namespace
+    Namespace for Workspace settings APIs.
+    """
+
+    @classmethod
+    def valid_settings(cls):
+        return ("default-environment", "image-builder-version")
+
+    def __init__(self, workspace: _Workspace):
+        """mdmd:hidden"""
+        self._workspace = workspace
+
+    async def list(self):
+        """Return a the current workspace settings.
+
+        Returns:
+            A `WorkspaceSettings` dataclass.
+        """
+        if not self._workspace.is_hydrated:
+            await self._workspace.hydrate()
+        resp = await self._workspace.client.stub.WorkspaceSettings(Empty())
+        return WorkspaceSettings(
+            default_environment=resp.default_environment_name, image_builder_version=resp.image_builder_version
+        )
+
+    async def _set_image_builder_version(self, version: str) -> None:
+        """mdmd:hidden
+        Set the image builder version for the Workspace.
+        """
+        if not self._workspace.is_hydrated:
+            await self._workspace.hydrate()
+        req = api_pb2.WorkspaceSetImageBuilderVersionRequest(new_image_builder_version=version)
+        await self._workspace.client.stub.WorkspaceSetImageBuilderVersion(req)
+
+    async def _set_default_environment(self, name: str) -> None:
+        """Set the default environment for the Workspace."""
+        if not self._workspace.is_hydrated:
+            await self._workspace.hydrate()
+        req = api_pb2.WorkspaceSetDefaultEnvironmentRequest(environment_name=name)
+        await self._workspace.client.stub.WorkspaceSetDefaultEnvironment(req)
+
+    async def set(self, name: str, value: str) -> None:
+        """Set a workspace setting to a new value. Must be workspace manager or owner.
+
+        The following settings can be updated:
+
+        - image-builder-version: The image builder version determines the software included in our base images.
+        - default-environment: The default environment when the environment is omitted from SDK or CLI methods.
+
+        Args:
+            name: The name of the setting.
+            value: The new value of the setting.
+
+        Examples:
+            ```python notest
+            modal.Workspace.from_context().settings.set("default-environment", "dev")
+            ```
+        """
+        match name:
+            case "image-builder-version":
+                await self._set_image_builder_version(value)
+            case "default-environment":
+                await self._set_default_environment(value)
+            case _:
+                raise ValueError(f"Unknown setting {name!r}. Valid settings: {', '.join(self.valid_settings())}")

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/cli/container.py

@@ -332,14 +332,25 @@ def exec(
 
 @container_cli.command("stop")
 @click.argument("container_id")
+@click.option(
+    "--graceful",
+    is_flag=True,
+    default=False,
+    help="Let the container finish its current inputs before exiting, instead of cancelling them.",
+)
 @yes_option
 @synchronizer.create_blocking
-async def stop(container_id: str = "", *, yes: bool = False):
+async def stop(container_id: str = "", *, graceful: bool = False, yes: bool = False):
     """Terminate a running container.
 
-    This will send the container a SIGINT signal that Modal will handle.
-    Any inputs that are currently running on the container will be cancelled and rescheduled
-    on other containers.
+    By default, this will send the container a SIGINT signal that Modal will handle.
+    For Functions, any inputs that are currently running on the container will be cancelled
+    and rescheduled on other containers.
+
+    With `--graceful`, the container will be allowed to finish the inputs it is currently
+    running, exiting once they complete. Graceful stops are only supported for containers
+    running a Modal Function.
+
     """
     client = await _Client.from_env()
     resp = await client.stub.TaskGetInfo(api_pb2.TaskGetInfoRequest(task_id=container_id))
@@ -347,5 +358,5 @@ async def stop(container_id: str = "", *, yes: bool = False):
         raise SystemExit(f"Container '{container_id}' is already stopped.")
     if not yes:
         confirm_or_suggest_yes(f"Are you sure you want to stop container '{container_id}'?")
-    request = api_pb2.ContainerStopRequest(task_id=container_id)
+    request = api_pb2.ContainerStopRequest(task_id=container_id, graceful=graceful)
     await client.stub.ContainerStop(request)

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/cli/workspace.py

@@ -127,3 +127,49 @@ def proxy_tokens_delete(token_id: str, yes: bool = False):
         confirm_or_suggest_yes(message)
     Workspace.from_context().proxy_tokens.delete(token_id)
     rich.print(f"[green]✓[/green] Deleted proxy token {token_id!r}")
+
+
+settings_cli = ModalGroup(name="settings", help="Manage workspace settings. Must be workspace manager or owner.")
+workspace_cli.add_command(settings_cli)
+
+
+@settings_cli.command("list")
+@click.option("--json", is_flag=True, default=False)
+@click.pass_context
+def settings_group(
+    ctx: click.Context,
+    json: bool,
+):
+    """View the current settings for the workspace."""
+    if ctx.invoked_subcommand is not None:
+        return
+    s = Workspace.from_context().settings.list()
+    rows = [
+        ["default-environment", s.default_environment],
+        ["image-builder-version", s.image_builder_version],
+    ]
+    display_table(["Setting", "Value"], rows, json=json)
+
+
+@settings_cli.command("set", no_args_is_help=True)
+@click.argument("setting")
+@click.argument("value")
+def settings_set(setting: str, value: str):
+    """Update a workspace setting. Must be workspace manager or owner.
+
+    The following settings can be updated:
+    - `image-builder-version`: The image builder version determines the software included in our base images.
+    - `default-environment`: The default environment to use when the environment is omitted from SDK or CLI methods.
+
+    Usage:
+    - `modal workspace settings set image-builder-version 2025.06`
+    - `modal workspace settings set default-environment main`
+    """
+    ws = Workspace.from_context().hydrate()
+    s = ws.settings.list()
+    try:
+        ws.settings.set(setting, value)
+        rich.print(f"[green]✓[/green] {setting}: updated from {getattr(s, setting.replace('-', '_'))} to {value}")
+    except Exception as e:
+        rich.print(f"[red]✗[/red] {setting}: {e}")
+        raise SystemExit(1)

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/client.pyi

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

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/config.py

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

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/functions.pyi

@@ -491,7 +491,7 @@ class Function(
 
     _call_generator: ___call_generator_spec
 
-    class __remote_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
+    class __remote_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> ReturnType_INNER:
             """Calls the function remotely, executing it with the given arguments and returning the execution's result.
 
@@ -516,7 +516,7 @@ class Function(
             """
             ...
 
-    remote: __remote_spec[modal._functions.ReturnType, modal._functions.P]
+    remote: __remote_spec[modal._functions.P, modal._functions.ReturnType]
 
     class __remote_gen_spec(typing_extensions.Protocol):
         def __call__(self, /, *args, **kwargs) -> typing.Generator[typing.Any, None, None]:
@@ -566,7 +566,7 @@ class Function(
         """
         ...
 
-    class ___experimental_spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
+    class ___experimental_spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> FunctionCall[ReturnType_INNER]:
             """[Experimental] Calls the function with the given arguments, without waiting for the results.
 
@@ -599,7 +599,7 @@ class Function(
             """
             ...
 
-    _experimental_spawn: ___experimental_spawn_spec[modal._functions.ReturnType, modal._functions.P]
+    _experimental_spawn: ___experimental_spawn_spec[modal._functions.P, modal._functions.ReturnType]
 
     class ___spawn_map_inner_spec(typing_extensions.Protocol[P_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> None: ...
@@ -607,7 +607,7 @@ class Function(
 
     _spawn_map_inner: ___spawn_map_inner_spec[modal._functions.P]
 
-    class __spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
+    class __spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> FunctionCall[ReturnType_INNER]:
             """Calls the function with the given arguments, without waiting for the results.
 
@@ -640,7 +640,7 @@ class Function(
             """
             ...
 
-    spawn: __spawn_spec[modal._functions.ReturnType, modal._functions.P]
+    spawn: __spawn_spec[modal._functions.P, modal._functions.ReturnType]
 
     def get_raw_f(self) -> collections.abc.Callable[..., typing.Any]:
         """Return the inner Python object wrapped by this Modal Function.

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/sandbox.py

@@ -1637,22 +1637,23 @@ class _Sandbox(_Object, type_prefix="sb"):
         resp = await self._client.stub.SandboxCreateConnectToken(req)
         return SandboxConnectCredentials(resp.url, resp.token)
 
-    async def reload_volumes(self) -> None:
+    async def reload_volumes(self, *, timeout: int = 55) -> None:
         """Reload all Volumes mounted in the Sandbox.
 
         Added in v1.1.0.
 
+        Blocks until the Volumes have been reloaded, bounded by `timeout` (55 seconds by default). If the reload
+        does not complete within that window, `modal.exception.TimeoutError` is raised; note that the reload may
+        still complete in the background.
+
+        Args:
+            timeout: Maximum time in seconds to wait for the reload. Must be positive.
         """
+        if timeout <= 0:
+            raise InvalidError("The `timeout` argument to `Sandbox.reload_volumes` must be positive.")
         task_id = await self._get_task_id()
-        if self._is_v2:
-            command_router_client = await self._get_command_router_client(task_id)
-            await command_router_client.reload_volumes(task_id)
-        else:
-            await self._client.stub.ContainerReloadVolumes(
-                api_pb2.ContainerReloadVolumesRequest(
-                    task_id=task_id,
-                ),
-            )
+        command_router_client = await self._get_command_router_client(task_id)
+        await command_router_client.reload_volumes(task_id, timeout=float(timeout))
 
     @overload
     async def terminate(

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/sandbox.pyi

@@ -711,10 +711,17 @@ class _Sandbox(modal._object._Object):
         """
         ...
 
-    async def reload_volumes(self) -> None:
+    async def reload_volumes(self, *, timeout: int = 55) -> None:
         """Reload all Volumes mounted in the Sandbox.
 
         Added in v1.1.0.
+
+        Blocks until the Volumes have been reloaded, bounded by `timeout` (55 seconds by default). If the reload
+        does not complete within that window, `modal.exception.TimeoutError` is raised; note that the reload may
+        still complete in the background.
+
+        Args:
+            timeout: Maximum time in seconds to wait for the reload. Must be positive.
         """
         ...
 
@@ -2389,17 +2396,31 @@ class Sandbox(modal.object.Object):
     create_connect_token: __create_connect_token_spec
 
     class __reload_volumes_spec(typing_extensions.Protocol):
-        def __call__(self, /) -> None:
+        def __call__(self, /, *, timeout: int = 55) -> None:
             """Reload all Volumes mounted in the Sandbox.
 
             Added in v1.1.0.
+
+            Blocks until the Volumes have been reloaded, bounded by `timeout` (55 seconds by default). If the reload
+            does not complete within that window, `modal.exception.TimeoutError` is raised; note that the reload may
+            still complete in the background.
+
+            Args:
+                timeout: Maximum time in seconds to wait for the reload. Must be positive.
             """
             ...
 
-        async def aio(self, /) -> None:
+        async def aio(self, /, *, timeout: int = 55) -> None:
             """Reload all Volumes mounted in the Sandbox.
 
             Added in v1.1.0.
+
+            Blocks until the Volumes have been reloaded, bounded by `timeout` (55 seconds by default). If the reload
+            does not complete within that window, `modal.exception.TimeoutError` is raised; note that the reload may
+            still complete in the background.
+
+            Args:
+                timeout: Maximum time in seconds to wait for the reload. Must be positive.
             """
             ...
 

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/workspace.py

@@ -4,16 +4,19 @@ from ._workspace import (
     ProxyTokenInfo,
     TokenData,
     WorkspaceMemberInfo,
+    WorkspaceSettings,
     _Workspace,
     _WorkspaceBillingManager,
     _WorkspaceMembersManager,
     _WorkspaceProxyTokenManager,
+    _WorkspaceSettingsManager,
 )
 
 Workspace = synchronize_api(_Workspace, target_module=__name__)
 WorkspaceMembersManager = synchronize_api(_WorkspaceMembersManager, target_module=__name__)
 WorkspaceBillingManager = synchronize_api(_WorkspaceBillingManager, target_module=__name__)
 WorkspaceProxyTokenManager = synchronize_api(_WorkspaceProxyTokenManager, target_module=__name__)
+WorkspaceSettingsManager = synchronize_api(_WorkspaceSettingsManager, target_module=__name__)
 
 __all__ = [
     "ProxyTokenInfo",
@@ -22,4 +25,6 @@ __all__ = [
     "WorkspaceMemberInfo",
     "WorkspaceMembersManager",
     "WorkspaceProxyTokenManager",
+    "WorkspaceSettingsManager",
+    "WorkspaceSettings",
 ]

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal/workspace.pyi

@@ -109,6 +109,36 @@ class WorkspaceMemberInfo:
         """Return hash(self)."""
         ...
 
+class WorkspaceSettings:
+    """Current settings for the workspace."""
+
+    default_environment: str
+    image_builder_version: str
+
+    def __init__(self, default_environment: str, image_builder_version: str) -> 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)."""
+        ...
+
 class Workspace(modal.object.Object):
     _name: typing.Optional[str]
 
@@ -135,6 +165,8 @@ class Workspace(modal.object.Object):
     def billing(self) -> WorkspaceBillingManager: ...
     @property
     def proxy_tokens(self) -> WorkspaceProxyTokenManager: ...
+    @property
+    def settings(self) -> WorkspaceSettingsManager: ...
 
 class WorkspaceMembersManager:
     """mdmd:namespace
@@ -448,3 +480,100 @@ class WorkspaceProxyTokenManager:
         async def aio(self, /, environment_name: str) -> str: ...
 
     _environment_id: ___environment_id_spec
+
+class WorkspaceSettingsManager:
+    """mdmd:namespace
+    Namespace for Workspace settings APIs.
+    """
+    def __init__(self, workspace: Workspace):
+        """mdmd:hidden"""
+        ...
+
+    @classmethod
+    def valid_settings(cls): ...
+
+    class __list_spec(typing_extensions.Protocol):
+        def __call__(self, /):
+            """Return a the current workspace settings.
+
+            Returns:
+                A `WorkspaceSettings` dataclass.
+            """
+            ...
+
+        async def aio(self, /):
+            """Return a the current workspace settings.
+
+            Returns:
+                A `WorkspaceSettings` dataclass.
+            """
+            ...
+
+    list: __list_spec
+
+    class ___set_image_builder_version_spec(typing_extensions.Protocol):
+        def __call__(self, /, version: str) -> None:
+            """mdmd:hidden
+            Set the image builder version for the Workspace.
+            """
+            ...
+
+        async def aio(self, /, version: str) -> None:
+            """mdmd:hidden
+            Set the image builder version for the Workspace.
+            """
+            ...
+
+    _set_image_builder_version: ___set_image_builder_version_spec
+
+    class ___set_default_environment_spec(typing_extensions.Protocol):
+        def __call__(self, /, name: str) -> None:
+            """Set the default environment for the Workspace."""
+            ...
+
+        async def aio(self, /, name: str) -> None:
+            """Set the default environment for the Workspace."""
+            ...
+
+    _set_default_environment: ___set_default_environment_spec
+
+    class __set_spec(typing_extensions.Protocol):
+        def __call__(self, /, name: str, value: str) -> None:
+            """Set a workspace setting to a new value. Must be workspace manager or owner.
+
+            The following settings can be updated:
+
+            - image-builder-version: The image builder version determines the software included in our base images.
+            - default-environment: The default environment when the environment is omitted from SDK or CLI methods.
+
+            Args:
+                name: The name of the setting.
+                value: The new value of the setting.
+
+            Examples:
+                ```python notest
+                modal.Workspace.from_context().settings.set("default-environment", "dev")
+                ```
+            """
+            ...
+
+        async def aio(self, /, name: str, value: str) -> None:
+            """Set a workspace setting to a new value. Must be workspace manager or owner.
+
+            The following settings can be updated:
+
+            - image-builder-version: The image builder version determines the software included in our base images.
+            - default-environment: The default environment when the environment is omitted from SDK or CLI methods.
+
+            Args:
+                name: The name of the setting.
+                value: The new value of the setting.
+
+            Examples:
+                ```python notest
+                modal.Workspace.from_context().settings.set("default-environment", "dev")
+                ```
+            """
+            ...
+
+    set: __set_spec

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal.egg-info/PKG-INFO

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

{modal-1.5.2.dev13 → modal-1.5.2.dev14}/modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2026
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.5.2.dev13"
+__version__ = "1.5.2.dev14"