modal 1.5.1.dev8__tar.gz → 1.5.1.dev10__tar.gz

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.5.1.dev8
+Version: 1.5.1.dev10
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License-Expression: Apache-2.0
@@ -23,7 +23,7 @@ Requires-Dist: grpclib<0.4.10,>=0.4.7; python_version < "3.14"
 Requires-Dist: grpclib<0.4.10,>=0.4.9; python_version >= "3.14"
 Requires-Dist: protobuf!=4.24.0,<7.0,>=3.19
 Requires-Dist: rich>=12.0.0
-Requires-Dist: synchronicity~=0.12.3
+Requires-Dist: synchronicity~=0.12.5
 Requires-Dist: toml
 Requires-Dist: types-certifi
 Requires-Dist: types-toml
@@ -45,7 +45,7 @@ access to serverless cloud compute from Python scripts on your local computer.
 See the [online documentation](https://modal.com/docs/guide) for many
 [example applications](https://modal.com/docs/examples),
 a [user guide](https://modal.com/docs/guide), and the detailed
-[API reference](https://modal.com/docs/reference).
+[API reference](https://modal.com/docs/sdk/py/latest).
 
 ## Installation
 

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/README.md

@@ -12,7 +12,7 @@ access to serverless cloud compute from Python scripts on your local computer.
 See the [online documentation](https://modal.com/docs/guide) for many
 [example applications](https://modal.com/docs/examples),
 a [user guide](https://modal.com/docs/guide), and the detailed
-[API reference](https://modal.com/docs/reference).
+[API reference](https://modal.com/docs/sdk/py/latest).
 
 ## Installation
 

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/_billing.py

@@ -80,7 +80,7 @@ class BillingReportItem:
             environment_name=pb_item.environment_name,
             interval_start=pb_item.interval.ToDatetime().replace(tzinfo=timezone.utc),
             cost=Decimal(pb_item.cost),
-            cost_by_resource={k: Decimal(str(v)) for k, v in pb_item.cost_by_resource.items()},
+            cost_by_resource={k: Decimal(v) for k, v in pb_item.cost_by_resource.items()},
             tags=dict(pb_item.tags),
         )
 
@@ -120,7 +120,7 @@ async def _workspace_billing_report(
     case, we recommend leaving a buffer after the end of the query interval.
 
     It's also possible to generate reports using the
-    [`modal billing report`](https://modal.com/docs/reference/cli/billing) CLI command. The CLI
+    [`modal billing report`](https://modal.com/docs/cli/latest/billing) CLI command. The CLI
     has a few convenience features for generating reports across relative time ranges.
 
     """

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/_environments.py

@@ -428,8 +428,9 @@ class _EnvironmentBillingManager:
             Modal's billing model evolves.
 
             It's also possible to generate reports using the
-            [`modal environment billing report`](https://modal.com/docs/reference/cli/environment) CLI command.
-            The CLI has a few convenience features for generating reports across relative time ranges.
+            [`modal environment billing report`](https://modal.com/docs/cli/latest/environment#modal-environment-billing-report)
+            CLI command.  The CLI has a few convenience features for generating
+            reports across relative time ranges.
 
             """
             + BILLING_DOCSTRING

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/_functions.py

@@ -1912,9 +1912,9 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
             **kwargs: Keyword arguments forwarded to the remote function.
 
         Returns:
-            A [`modal.FunctionCall`](https://modal.com/docs/reference/modal.FunctionCall) object
+            A [`modal.FunctionCall`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall) object
             that can later be polled or waited for using
-            [`.get(timeout=...)`](https://modal.com/docs/reference/modal.FunctionCall#get).
+            [`.get(timeout=...)`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall#get).
         """
         self._check_no_web_url("spawn")
         if self._is_generator:
@@ -2065,7 +2065,7 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         """Returns a structure representing the call graph from a given root
         call ID, along with the status of execution for each node.
 
-        See [`modal.call_graph`](https://modal.com/docs/reference/modal.call_graph) reference page
+        See [`modal.call_graph`](https://modal.com/docs/sdk/py/latest/modal.call_graph) reference page
         for documentation on the structure of the returned `InputInfo` items.
 
         Returns:
@@ -2083,7 +2083,7 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         terminate_containers: bool = False,
     ):
         """Cancels the function call, which will stop its execution and mark its inputs as
-        [`TERMINATED`](https://modal.com/docs/reference/modal.call_graph#modalcall_graphinputstatus).
+        [`TERMINATED`](https://modal.com/docs/sdk/py/latest/modal.call_graph#modalcall_graphinputstatus).
 
         If `terminate_containers=True` - the containers running the cancelled inputs are all terminated
         causing any non-cancelled inputs on those containers to be rescheduled in new containers.

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/_image.py

@@ -9,6 +9,7 @@ import typing
 import warnings
 from collections.abc import Callable, Collection, Sequence
 from dataclasses import dataclass, field
+from functools import wraps
 from inspect import isfunction
 from pathlib import Path, PurePosixPath
 from typing import (
@@ -424,6 +425,20 @@ async def _image_await_build_result(image_id: str, client: _Client) -> api_pb2.I
     return result_response
 
 
+def _requires_image_instance(method):
+    @wraps(method)
+    def wrapper(self, *args, **kwargs):
+        if not isinstance(self, _Image):
+            raise InvalidError(
+                "Image has not been constructed yet. "
+                f"Use one of the static factory methods prior to calling {method.__name__} "
+                "like `modal.Image.debian_slim`, `modal.Image.from_registry`, or `modal.Image.micromamba`"
+            )
+        return method(self, *args, **kwargs)
+
+    return wrapper
+
+
 class _Image(_Object, type_prefix="im"):
     """Base class for container images to run functions in.
 
@@ -755,6 +770,7 @@ class _Image(_Object, type_prefix="im"):
             context_mount_function=lambda: mount,
         )
 
+    @_requires_image_instance
     def add_local_file(self, local_path: str | Path, remote_path: str, *, copy: bool = False) -> "_Image":
         """Adds a local file to the image at `remote_path` within the container.
 
@@ -791,6 +807,7 @@ class _Image(_Object, type_prefix="im"):
         mount = _Mount._from_local_file(local_path, remote_path)
         return self._add_mount_layer_or_copy(mount, copy=copy)
 
+    @_requires_image_instance
     def add_local_dir(
         self,
         local_path: str | Path,
@@ -869,6 +886,7 @@ class _Image(_Object, type_prefix="im"):
         mount = _Mount._add_local_dir(Path(local_path), PurePosixPath(remote_path), ignore=_ignore_fn(ignore))
         return self._add_mount_layer_or_copy(mount, copy=copy)
 
+    @_requires_image_instance
     def add_local_python_source(
         self, *modules: str, copy: bool = False, ignore: Sequence[str] | Callable[[Path], bool] = NON_PYTHON_FILES
     ) -> "_Image":
@@ -1012,6 +1030,7 @@ class _Image(_Object, type_prefix="im"):
             await resolver.load(self, load_context)
         return self
 
+    @_requires_image_instance
     def pip_install(
         self,
         *packages: str | list[str],
@@ -1098,6 +1117,7 @@ class _Image(_Object, type_prefix="im"):
             secrets=secrets,
         )
 
+    @_requires_image_instance
     def pip_install_private_repos(
         self,
         *repositories: str,
@@ -1218,6 +1238,7 @@ class _Image(_Object, type_prefix="im"):
             force_build=self.force_build or force_build,
         )
 
+    @_requires_image_instance
     def pip_install_from_requirements(
         self,
         requirements_txt: str,
@@ -1279,6 +1300,7 @@ class _Image(_Object, type_prefix="im"):
             secrets=secrets,
         )
 
+    @_requires_image_instance
     def pip_install_from_pyproject(
         self,
         pyproject_toml: str,
@@ -1362,6 +1384,7 @@ class _Image(_Object, type_prefix="im"):
             gpu_config=parse_gpu_config(gpu),
         )
 
+    @_requires_image_instance
     def uv_pip_install(
         self,
         *packages: str | list[str],
@@ -1493,6 +1516,7 @@ class _Image(_Object, type_prefix="im"):
             secrets=secrets,
         )
 
+    @_requires_image_instance
     def poetry_install_from_file(
         self,
         poetry_pyproject_toml: str,
@@ -1602,6 +1626,7 @@ class _Image(_Object, type_prefix="im"):
             gpu_config=parse_gpu_config(gpu),
         )
 
+    @_requires_image_instance
     def uv_sync(
         self,
         uv_project_dir: str = "./",
@@ -1785,6 +1810,7 @@ class _Image(_Object, type_prefix="im"):
             gpu_config=parse_gpu_config(gpu),
         )
 
+    @_requires_image_instance
     def dockerfile_commands(
         self,
         *dockerfile_commands: str | list[str],
@@ -1873,6 +1899,7 @@ class _Image(_Object, type_prefix="im"):
             build_args=build_args,
         )
 
+    @_requires_image_instance
     def entrypoint(
         self,
         entrypoint_commands: list[str],
@@ -1893,6 +1920,7 @@ class _Image(_Object, type_prefix="im"):
 
         return self.dockerfile_commands(dockerfile_cmd)
 
+    @_requires_image_instance
     def shell(
         self,
         shell_commands: list[str],
@@ -1913,6 +1941,7 @@ class _Image(_Object, type_prefix="im"):
 
         return self.dockerfile_commands(dockerfile_cmd)
 
+    @_requires_image_instance
     def run_commands(
         self,
         *commands: str | list[str],
@@ -1997,6 +2026,7 @@ class _Image(_Object, type_prefix="im"):
             _namespace=api_pb2.DEPLOYMENT_NAMESPACE_GLOBAL,
         )
 
+    @_requires_image_instance
     def micromamba_install(
         self,
         *packages: str | list[str],
@@ -2528,6 +2558,7 @@ class _Image(_Object, type_prefix="im"):
             _namespace=api_pb2.DEPLOYMENT_NAMESPACE_GLOBAL,
         )
 
+    @_requires_image_instance
     def apt_install(
         self,
         *packages: str | list[str],
@@ -2579,6 +2610,7 @@ class _Image(_Object, type_prefix="im"):
             secrets=secrets,
         )
 
+    @_requires_image_instance
     def run_function(
         self,
         raw_f: Callable[..., Any],
@@ -2697,6 +2729,7 @@ class _Image(_Object, type_prefix="im"):
             force_build=self.force_build or force_build,
         )
 
+    @_requires_image_instance
     def env(self, vars: dict[str, str]) -> "_Image":
         """Sets the environment variables in an Image.
 
@@ -2727,6 +2760,7 @@ class _Image(_Object, type_prefix="im"):
             dockerfile_function=build_dockerfile,
         )
 
+    @_requires_image_instance
     def workdir(self, path: str | PurePosixPath) -> "_Image":
         """Set the working directory for subsequent image build steps and function execution.
 
@@ -2756,6 +2790,7 @@ class _Image(_Object, type_prefix="im"):
             dockerfile_function=build_dockerfile,
         )
 
+    @_requires_image_instance
     def cmd(self, cmd: list[str]) -> "_Image":
         """Set the default command (`CMD`) to run when a container is started.
 
@@ -2784,6 +2819,7 @@ class _Image(_Object, type_prefix="im"):
 
         return self.dockerfile_commands(dockerfile_cmd)
 
+    @_requires_image_instance
     def pipe(
         self,
         func: Callable[Concatenate["modal.Image", P], "modal.Image"],

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/_partial_function.py

@@ -477,7 +477,7 @@ def _wsgi_app(
     Web Server Gateway Interface (WSGI) is a standard for synchronous Python web apps.
     It has been [succeeded by the ASGI interface](https://asgi.readthedocs.io/en/latest/introduction.html#wsgi-compatibility)
     which is compatible with ASGI and supports additional functionality such as web sockets.
-    Modal supports ASGI via [`asgi_app`](https://modal.com/docs/reference/modal.asgi_app).
+    Modal supports ASGI via [`asgi_app`](https://modal.com/docs/sdk/py/latest/modal.asgi_app).
 
     Examples:
         ```python

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/_server.py

@@ -49,10 +49,10 @@ class _Server:
     See [lifecycle hooks](https://modal.com/docs/guide/lifecycle-functions) for more information.
 
     Generally, you will not construct a Server directly.
-    Instead, use the [`@app.server()`](https://modal.com/docs/reference/modal.App#server) decorator.
+    Instead, use the [`@app.server()`](https://modal.com/docs/sdk/py/latest/modal.App#server) decorator.
 
     ```python notest
-    @app.server(port=8000, routing_region="us-east")
+    @app.server(port=8080, routing_region="us-east")
     class MyServer:
         @modal.enter()
         def start_server(self):

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/_utils/task_command_router_client.py

@@ -491,6 +491,27 @@ class TaskCommandRouterClient:
                 lambda: self._call_with_auth_retry(self._stub.SandboxStdinWriteV2, request)
             )
 
+    async def sandbox_wait_until_ready(self, task_id: str, timeout: float) -> sr_pb2.SandboxWaitUntilReadyTcrResponse:
+        """Wait until the sandbox's readiness probe reports ready.
+
+        Args:
+            task_id: The task ID hosting the sandbox.
+            timeout: Maximum time in seconds for the worker to wait.
+        Raises:
+            TimeoutError: If the sandbox does not become ready within `timeout`.
+        """
+        request = sr_pb2.SandboxWaitUntilReadyTcrRequest(task_id=task_id, timeout=timeout)
+        with grpc_error_converter():
+            try:
+                return await asyncio.wait_for(
+                    call_with_retries_on_transient_errors(
+                        lambda: self._call_with_auth_retry(self._stub.SandboxWaitUntilReady, request, timeout=timeout),
+                    ),
+                    timeout=timeout,
+                )
+            except asyncio.TimeoutError:
+                raise ModalTimeoutError("Timeout expired")
+
     async def exec_poll(self, task_id: str, exec_id: str, deadline: float | None = None) -> sr_pb2.TaskExecPollResponse:
         """Poll for the exit status of an exec'd command, properly retrying on transient errors.
 
@@ -784,6 +805,12 @@ class TaskCommandRouterClient:
                 lambda: self._call_with_auth_retry(self._stub.TaskUnmountDirectory, request)
             )
 
+    async def set_network_access(self, request: sr_pb2.TaskSetNetworkAccessRequest):
+        with grpc_error_converter():
+            return await call_with_retries_on_transient_errors(
+                lambda: self._call_with_auth_retry(self._stub.TaskSetNetworkAccess, request)
+            )
+
     async def _snapshot_with_deadline(self, rpc, request, *, timeout: float, **kwargs):
         # helper method for snapshot_directory and snapshot_filesystem to handle grpc
         # deadlines in a consistent way, converting any error to TimeoutError after passing

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/_workspace.py

@@ -151,8 +151,9 @@ class _WorkspaceBillingManager:
             Modal's billing model evolves.
 
             It's also possible to generate reports using the
-            [`modal billing report`](https://modal.com/docs/reference/cli/billing) CLI command. The CLI
-            has a few convenience features for generating reports across relative time ranges.
+            [`modal billing report`](https://modal.com/docs/cli/latest/billing#modal-billing-report)
+            CLI command. The CLI has a few convenience features for generating reports across relative
+            time ranges.
 
             """
             + BILLING_DOCSTRING

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/app.py

@@ -710,7 +710,7 @@ class _App:
         Modal functions can also be used as CLI entrypoints, but unlike `local_entrypoint`,
         those functions are executed remotely directly.
 
-        Note that an explicit [`app.run()`](https://modal.com/docs/reference/modal.App#run) is not needed, as an
+        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/modal.App#run) is not needed, as an
         [app](https://modal.com/docs/guide/apps) is automatically created for you.
 
         Args:
@@ -1066,7 +1066,7 @@ class _App:
         max_inputs: int | None = None,
     ) -> Callable[[CLS_T | _PartialFunction], CLS_T]:
         """
-        Decorator to register a new Modal [Cls](https://modal.com/docs/reference/modal.Cls) with this App.
+        Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/modal.Cls) with this App.
 
         Args:
             image: The image to run as the container for the class service.
@@ -1290,6 +1290,7 @@ class _App:
         scaleup_window: int | None = None,  # Stabilization window (seconds) of sustained demand before scaling up
         scaledown_window: int | None = None,  # Max idle time before scaling down (seconds)
         proxy: _Proxy | None = None,  # Modal Proxy to use in front of this server
+        unauthenticated: bool = False,  # Whether the endpoint requires proxy authentication, required by default.
         port: int = 8000,  # Port the HTTP server listens on
         startup_timeout: int = 30,  # Maximum startup time in seconds
         exit_grace_period: int = 0,  # Grace period for in-flight requests on shutdown
@@ -1334,10 +1335,11 @@ class _App:
             scaledown_window: Max idle time before scaling down (seconds).
             proxy: Modal Proxy to use in front of this server.
             port: Port the HTTP server listens on.
+            unauthenticated: Whether the endpoint requires proxy authentication, required by default.
             startup_timeout: Maximum startup time in seconds.
             exit_grace_period: Grace period for in-flight requests on shutdown.
             routing_region: Region to route Server requests through.
-            h2_enabled: Enable HTTP/2 in the container.
+            h2_enabled: Enable HTTP/2.
             target_concurrency: Target concurrency for the server; 0 disables autoscaling.
             cloud: Cloud provider (aws, gcp, oci, auto).
             region: Region(s) to run on.
@@ -1385,6 +1387,7 @@ class _App:
             startup_timeout=startup_timeout,
             exit_grace_period=exit_grace_period,
             h2_enabled=h2_enabled,
+            unauthenticated=unauthenticated,
         )
 
         # Build secrets list

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/app.pyi

@@ -494,7 +494,7 @@ class _App:
         Modal functions can also be used as CLI entrypoints, but unlike `local_entrypoint`,
         those functions are executed remotely directly.
 
-        Note that an explicit [`app.run()`](https://modal.com/docs/reference/modal.App#run) is not needed, as an
+        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/modal.App#run) is not needed, as an
         [app](https://modal.com/docs/guide/apps) is automatically created for you.
 
         Args:
@@ -683,7 +683,7 @@ class _App:
         _experimental_restrict_output: bool = False,
         max_inputs: typing.Optional[int] = None,
     ) -> collections.abc.Callable[[typing.Union[CLS_T, modal._partial_function._PartialFunction]], CLS_T]:
-        """Decorator to register a new Modal [Cls](https://modal.com/docs/reference/modal.Cls) with this App.
+        """Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/modal.Cls) with this App.
 
         Args:
             image: The image to run as the container for the class service.
@@ -751,6 +751,7 @@ class _App:
         scaleup_window: typing.Optional[int] = None,
         scaledown_window: typing.Optional[int] = None,
         proxy: typing.Optional[modal.proxy._Proxy] = None,
+        unauthenticated: bool = False,
         port: int = 8000,
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
@@ -795,10 +796,11 @@ class _App:
             scaledown_window: Max idle time before scaling down (seconds).
             proxy: Modal Proxy to use in front of this server.
             port: Port the HTTP server listens on.
+            unauthenticated: Whether the endpoint requires proxy authentication, required by default.
             startup_timeout: Maximum startup time in seconds.
             exit_grace_period: Grace period for in-flight requests on shutdown.
             routing_region: Region to route Server requests through.
-            h2_enabled: Enable HTTP/2 in the container.
+            h2_enabled: Enable HTTP/2.
             target_concurrency: Target concurrency for the server; 0 disables autoscaling.
             cloud: Cloud provider (aws, gcp, oci, auto).
             region: Region(s) to run on.
@@ -1495,7 +1497,7 @@ class App:
         Modal functions can also be used as CLI entrypoints, but unlike `local_entrypoint`,
         those functions are executed remotely directly.
 
-        Note that an explicit [`app.run()`](https://modal.com/docs/reference/modal.App#run) is not needed, as an
+        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/modal.App#run) is not needed, as an
         [app](https://modal.com/docs/guide/apps) is automatically created for you.
 
         Args:
@@ -1684,7 +1686,7 @@ class App:
         _experimental_restrict_output: bool = False,
         max_inputs: typing.Optional[int] = None,
     ) -> collections.abc.Callable[[typing.Union[CLS_T, modal.partial_function.PartialFunction]], CLS_T]:
-        """Decorator to register a new Modal [Cls](https://modal.com/docs/reference/modal.Cls) with this App.
+        """Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/modal.Cls) with this App.
 
         Args:
             image: The image to run as the container for the class service.
@@ -1752,6 +1754,7 @@ class App:
         scaleup_window: typing.Optional[int] = None,
         scaledown_window: typing.Optional[int] = None,
         proxy: typing.Optional[modal.proxy.Proxy] = None,
+        unauthenticated: bool = False,
         port: int = 8000,
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
@@ -1794,10 +1797,11 @@ class App:
             scaledown_window: Max idle time before scaling down (seconds).
             proxy: Modal Proxy to use in front of this server.
             port: Port the HTTP server listens on.
+            unauthenticated: Whether the endpoint requires proxy authentication, required by default.
             startup_timeout: Maximum startup time in seconds.
             exit_grace_period: Grace period for in-flight requests on shutdown.
             routing_region: Region to route Server requests through.
-            h2_enabled: Enable HTTP/2 in the container.
+            h2_enabled: Enable HTTP/2.
             target_concurrency: Target concurrency for the server; 0 disables autoscaling.
             cloud: Cloud provider (aws, gcp, oci, auto).
             region: Region(s) to run on.

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/billing.pyi

@@ -134,7 +134,7 @@ class __workspace_billing_report_spec(typing_extensions.Protocol):
         case, we recommend leaving a buffer after the end of the query interval.
 
         It's also possible to generate reports using the
-        [`modal billing report`](https://modal.com/docs/reference/cli/billing) CLI command. The CLI
+        [`modal billing report`](https://modal.com/docs/cli/latest/billing) CLI command. The CLI
         has a few convenience features for generating reports across relative time ranges.
         """
         ...
@@ -176,7 +176,7 @@ class __workspace_billing_report_spec(typing_extensions.Protocol):
         case, we recommend leaving a buffer after the end of the query interval.
 
         It's also possible to generate reports using the
-        [`modal billing report`](https://modal.com/docs/reference/cli/billing) CLI command. The CLI
+        [`modal billing report`](https://modal.com/docs/cli/latest/billing) CLI command. The CLI
         has a few convenience features for generating reports across relative time ranges.
         """
         ...

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/cli/_help.py

@@ -98,7 +98,7 @@ def _build_epilog(cmd: click.Command) -> RenderableType | None:
     return Text(cmd.epilog)
 
 
-def _group_commands_by_panel(group: click.Group) -> dict[str, list[tuple[str, click.Command]]]:
+def group_commands_by_panel(group: click.Group) -> dict[str, list[tuple[str, click.Command]]]:
     """Bucket visible subcommands, preserving registration order."""
     panels: dict[str, list[tuple[str, click.Command]]] = {}
     for name, sub in group.commands.items():
@@ -109,7 +109,7 @@ def _group_commands_by_panel(group: click.Group) -> dict[str, list[tuple[str, cl
 
 
 def _build_commands(group: click.Group, available_width: int) -> RenderableType | None:
-    panels = _group_commands_by_panel(group)
+    panels = group_commands_by_panel(group)
     if not panels:
         return None
 
@@ -229,7 +229,7 @@ class ModalGroup(click.Group):
     def format_commands(self, ctx: click.Context, formatter: click.HelpFormatter) -> None:
         # Replaces click's single flat "Commands:" section with one section per
         # panel so the simple-style help output still preserves grouping.
-        for panel_name, items in _group_commands_by_panel(self).items():
+        for panel_name, items in group_commands_by_panel(self).items():
             rows = [(name, sub.get_short_help_str(limit=80)) for name, sub in items]
             with formatter.section(panel_name):
                 formatter.write_dl(rows)

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/cli/billing.py

@@ -107,7 +107,7 @@ async def report(
     or by requesting a date range using `--for` (e.g., `--for today`, `--for 'last month'`).
 
     This command provides a CLI frontend for the
-    [`Workspace.billing.report`](https://modal.com/docs/reference/modal.Workspace#billingreport) API.
+    [`Workspace.billing.report`](https://modal.com/docs/sdk/py/latest/modal.Workspace#billingreport) API.
 
     Note that, as with the API, the start date is inclusive and the end date is exclusive.
     Data will be reported for full intervals only. Using `--for` is a convenient way to define a

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/cli/changelog.py

@@ -10,7 +10,7 @@ from modal._vendor.version import Version
 
 from ._help import ModalCommand
 
-CHANGELOG_URL = "https://modal.com/docs/reference/changelog.md"
+CHANGELOG_URL = "https://modal.com/docs/sdk/py/changelog.md"
 
 
 @dataclass

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/cli/config.py

@@ -14,7 +14,7 @@ config_cli = ModalGroup(
     help="""
     Manage client configuration for the current profile.
 
-    Refer to https://modal.com/docs/reference/modal.config for a full explanation
+    Refer to https://modal.com/docs/sdk/py/latest/modal.config for a full explanation
     of what these options mean, and how to set them.
     """,
 )

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/cli/environment.py

@@ -230,7 +230,8 @@ async def environment_billing(
     or by requesting a date range using `--for` (e.g., `--for today`, `--for 'last month'`).
 
     This command provides a CLI frontend for the
-    [`Environment.billing.report`](https://modal.com/docs/reference/modal.Environment#billingreport) API.
+    [`Environment.billing.report`](https://modal.com/docs/sdk/py/latest/modal.Environment#billingreport)
+    API.
 
     Note that, as with the API, the start date is inclusive and the end date is exclusive.
     Data will be reported for full intervals only. Using `--for` is a convenient way to define a

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/cli/shell.py

@@ -358,7 +358,7 @@ def shell(
     modal shell hello_world.py::my_function
     ```
 
-    Or, if you're using a [modal.Cls](https://modal.com/docs/reference/modal.Cls)
+    Or, if you're using a [modal.Cls](https://modal.com/docs/sdk/py/latest/modal.Cls)
     you can refer to a `@modal.method` directly:
 
     ```

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/client.py

@@ -235,7 +235,7 @@ class _Client:
             else:
                 raise AuthError(
                     "Token missing. Could not authenticate client."
-                    " If you have token credentials, see modal.com/docs/reference/modal.config for setup help."
+                    " If you have token credentials, see modal.com/docs/sdk/py/latest/modal.config for setup help."
                     " If you are a new user, register an account at modal.com, then run `modal token new`."
                 )
 

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/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.1.dev8",
+        version: str = "1.5.1.dev10",
     ):
         """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.1.dev8",
+        version: str = "1.5.1.dev10",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

{modal-1.5.1.dev8 → modal-1.5.1.dev10}/modal/cls.py

@@ -446,10 +446,10 @@ Obj = synchronize_api(_Obj)
 class _Cls(_Object, type_prefix="cs"):
     """
     Cls adds method pooling and [lifecycle hook](https://modal.com/docs/guide/lifecycle-functions) behavior
-    to [modal.Function](https://modal.com/docs/reference/modal.Function).
+    to [modal.Function](https://modal.com/docs/sdk/py/latest/modal.Function).
 
     Generally, you will not construct a Cls directly.
-    Instead, use the [`@app.cls()`](https://modal.com/docs/reference/modal.App#cls) decorator on the App object.
+    Instead, use the [`@app.cls()`](https://modal.com/docs/sdk/py/latest/modal.App#cls) decorator on the App object.
     """
 
     _class_service_function: _Function | None  # The _Function (read "service") serving *all* methods of the class