modal 1.5.2.dev5__py3-none-any.whl → 1.5.2.dev7__py3-none-any.whl

modal/cli/image.py

@@ -10,10 +10,12 @@ from typing import Optional
 import click
 
 from modal._environments import ensure_env
+from modal._image import _parse_named_image_ref
 from modal._utils.async_utils import synchronizer
 from modal._utils.time_utils import timestamp_to_localized_str
 from modal.cli.utils import display_table, env_option
 from modal.client import _Client
+from modal.exception import InvalidError
 from modal.output import OutputManager
 from modal_proto import api_pb2
 
@@ -21,6 +23,8 @@ from ._help import ModalGroup
 
 IMAGE_NAMES_LIST_PAGE_SIZE = 100
 IMAGE_NAMES_LIST_PAGE_DELAY_SECONDS = 1.0
+IMAGE_NAMES_HISTORY_PAGE_SIZE = 100
+IMAGE_NAMES_HISTORY_PAGE_DELAY_SECONDS = 1.0
 
 image_cli = ModalGroup(name="image", help="Manage Images.")
 image_names_cli = ModalGroup(name="names", help="Manage Modal Image names.")
@@ -49,6 +53,20 @@ def _tag_item_row(item: api_pb2.ImageListTagsItem) -> tuple[str, str, str]:
     )
 
 
+def _history_item_json(item: api_pb2.ImageTagRevisionsItem) -> dict[str, str]:
+    return {
+        "image_id": item.image_id,
+        "published_at": timestamp_to_localized_str(item.created_at, True) or "-",
+    }
+
+
+def _history_item_row(item: api_pb2.ImageTagRevisionsItem) -> tuple[str, str]:
+    return (
+        item.image_id,
+        timestamp_to_localized_str(item.created_at, False) or "-",
+    )
+
+
 async def _iter_tag_pages(
     client: _Client, env: str, prefix: str
 ) -> AsyncIterator[tuple[str, list[api_pb2.ImageListTagsItem]]]:
@@ -73,6 +91,36 @@ async def _iter_tag_pages(
         await asyncio.sleep(IMAGE_NAMES_LIST_PAGE_DELAY_SECONDS)
 
 
+async def _fetch_history_page(
+    client: _Client,
+    env: str,
+    tag: str,
+    page_token: str,
+) -> api_pb2.ImageTagRevisionsResponse:
+    return await client.stub.ImageTagRevisions(
+        api_pb2.ImageTagRevisionsRequest(
+            tag=tag,
+            environment_name=env,
+            max_objects=IMAGE_NAMES_HISTORY_PAGE_SIZE,
+            page_token=page_token,
+        )
+    )
+
+
+async def _iter_history_pages(
+    client: _Client, env: str, tag: str, first_page: api_pb2.ImageTagRevisionsResponse
+) -> AsyncIterator[api_pb2.ImageTagRevisionsResponse]:
+    response = first_page
+
+    while True:
+        yield response
+
+        if not response.next_page_token:
+            return
+        await asyncio.sleep(IMAGE_NAMES_HISTORY_PAGE_DELAY_SECONDS)
+        response = await _fetch_history_page(client, env, tag, response.next_page_token)
+
+
 @image_names_cli.command("list", help="List named Images.")
 @env_option
 @click.option("--prefix", default="", help="Only include named image tags that start with this prefix.")
@@ -108,3 +156,52 @@ async def list_(
         count += len(page_items)
 
     _print_result_summary(count)
+
+
+@image_names_cli.command("history", help="Show publishing history for a named Image.", hidden=True)
+@click.argument("name")
+@env_option
+@click.option("--json", is_flag=True, default=False)
+@synchronizer.create_blocking
+async def history(
+    name: str,
+    env: Optional[str] = None,
+    json: bool = False,
+):
+    env = ensure_env(env)
+    try:
+        name_tag = _parse_named_image_ref(name)
+    except InvalidError as exc:
+        raise click.UsageError(str(exc)) from exc
+    client = await _Client.from_env()
+
+    first_page = await _fetch_history_page(client, env, name_tag, "")
+    if not first_page.items:
+        raise click.ClickException(f"No publishing history found for named image {first_page.tag!r}.")
+
+    if json:
+        click.echo("[", nl=False)
+        count = 0
+        async for response in _iter_history_pages(client, env, name_tag, first_page):
+            for item in response.items:
+                if count:
+                    click.echo(",", nl=False)
+                click.echo(json_module.dumps(_history_item_json(item)), nl=False)
+                count += 1
+        click.echo("]")
+        return
+
+    count = 0
+    show_title = True
+    async for response in _iter_history_pages(client, env, name_tag, first_page):
+        if response.items:
+            title = f"History for {response.tag}" if show_title else ""
+            display_table(
+                ["Image ID", "Published at"],
+                [_history_item_row(item) for item in response.items],
+                title=title,
+            )
+            show_title = False
+        count += len(response.items)
+
+    _print_result_summary(count)

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.dev5",
+        version: str = "1.5.2.dev7",
     ):
         """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.dev5",
+        version: str = "1.5.2.dev7",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

modal/sandbox.py

@@ -1284,7 +1284,6 @@ class _Sandbox(_Object, type_prefix="sb"):
             outbound_domain_allowlist: List of domain names the Sandbox is allowed to access. Supports
                 wildcard prefixes (``*.``); a bare ``"*"`` allows all domains.
         """
-        self._ensure_v1("_experimental_set_outbound_network_policy")
         task_id = await self._get_task_id()
         command_router_client = await self._get_command_router_client(task_id)
 

{modal-1.5.2.dev5.dist-info → modal-1.5.2.dev7.dist-info}/METADATA

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

{modal-1.5.2.dev5.dist-info → modal-1.5.2.dev7.dist-info}/RECORD

@@ -31,7 +31,7 @@ modal/billing.py,sha256=tWrlpbNau0cfGSr643MzguHS0Dl5cRd7tm0GsCLYvtQ,372
 modal/billing.pyi,sha256=2hUdEbWa1nLdFfzZpwxHHpyK9k8uBRASGkFmPJhtkUU,7318
 modal/call_graph.py,sha256=k_wH3DuuUHCeuycHsOqlcOpIlIVbCYi9RPobg21hJdI,2550
 modal/client.py,sha256=OgjptM5UuU5LL85_-DFia-ehS8UCgMzVuzfNcxA1qPA,16136
-modal/client.pyi,sha256=nkN4HbEW0stuQNoVjY7wnPnD2e92Enn6D19zZj15gYU,17852
+modal/client.pyi,sha256=aE_yLcH31Imz800m4wDbOR7kVDy3qQjNQwAw1zOp8cI,17852
 modal/cloud_bucket_mount.py,sha256=03gECcV9l2Lnt9k23YrDOTGFW7ajfXMW5O8b1prhtwQ,6254
 modal/cloud_bucket_mount.pyi,sha256=lMOb44pbNE9kDVEqWfcmvpsnh1sdNNFzuKoVyZZ3d5M,8058
 modal/cls.py,sha256=4oWIthR84usP5oejQbdMWzXkvzXyER2GDIpLvLTH4Og,40936
@@ -73,7 +73,7 @@ modal/retries.py,sha256=tSGB5bGM5xZZUDXMkuelIEoQJY0vOukOssZhwc6tXAo,5014
 modal/runner.py,sha256=YdBqWOWkcGgSDKLEz1zrGNHrh0-d2tSNx24XPB6QyoM,30284
 modal/runner.pyi,sha256=0hIfkl-7VTyw1n-1B0AV7f53t3i3hCzRPyBu3DUyHnk,9669
 modal/running_app.py,sha256=xSR1VVlhxEFytmjx2x697_0GpD25Vc9crhp6r117_QY,1145
-modal/sandbox.py,sha256=Pb_rqjAkEIlIl_ewgbKzj6kKMDPAJdv9JiVbSZKj5hU,109254
+modal/sandbox.py,sha256=L6Gi_OMIhokEmaytGFu5VIjrceCGcFu0mH4bXhBzWXc,109185
 modal/sandbox.pyi,sha256=vF1qXdslQeZDrlLTgw5q0F3jtjmTMz9USy-ggQiJiO8,126252
 modal/sandbox_fs.py,sha256=Iwx-kjWrp12Gii_8Zdo1T8DHOkkbO0n9RMyBuYXMkU4,31361
 modal/sandbox_fs.pyi,sha256=nmfb1Ns9__C5sH3Mq52rFDtJbfKdQrn7Cc1mcP64WBw,46902
@@ -169,7 +169,7 @@ modal/cli/dict.py,sha256=EYJlADqAyOW0YKjmzQuBv1qgLwBU2JNQnWulfZXrgK0,5042
 modal/cli/endpoint.py,sha256=6y5N8ThRvqM2JlSeMz5wCSEOXEchaDLyl3RTV_RpdV0,13509
 modal/cli/entry_point.py,sha256=Z5f-kE2OumaNsuCZU_P_E2pfLB1JGQTL-55MAp3r1ys,5074
 modal/cli/environment.py,sha256=nBYfobAMg_a5lfrz0CkLmgJ_lxdjW7TfbR5r5d8cKr8,11751
-modal/cli/image.py,sha256=eAD4kG8QzRtg0es4OQPMC2CzMBQIt7KaVtvtNRn8SHw,3513
+modal/cli/image.py,sha256=PDGkGSBP4F1Dr_T1iGNsC8YOp-vuTZCLmSjAGOF1vRc,6580
 modal/cli/import_refs.py,sha256=s3OeBuFZJNh0S8EaaEiqUnAPETRTrWdOk-jkO7yRVr4,15506
 modal/cli/launch.py,sha256=1cPg9y7zIETMeg6_5HBPpX3hbL4uKe-yXf49bXx8tSY,4482
 modal/cli/logo.py,sha256=plv82syvPb8j3qrR1A_nojZwp823t3VEXaDlrx1jkt0,3221
@@ -193,33 +193,33 @@ modal/experimental/flash.py,sha256=GAJ1c-EGL8M3_loAkqr5gdUfySMHY3U_oc6RywfZ8-0,3
 modal/experimental/flash.pyi,sha256=lpTqJFZRMGWscw0xpYZVdBMnAYjj16asXE4_64A6itQ,17774
 modal/experimental/ipython.py,sha256=kJ6o9wkAY_MiSb7paewI7f1MJAeqdi8TX5pBdhr_mUI,2925
 modal/skills/modal/SKILL.md,sha256=WzLjYJ1utjc_ZOf6qZTPwB6wxxwRYB5PibdvIf_FLy0,5316
-modal-1.5.2.dev5.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.5.2.dev7.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
 modal_docs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal_docs/gen_cli_docs.py,sha256=nZRXP6sh0hTFqTQOo_dMKy8V57I-L6V5cv3cs3eL7NE,5808
 modal_docs/gen_cli_docs_main.py,sha256=UPGr7O1DYTIRLwfINe2rbdh89J3cPVTU1OWL-SjxnOQ,198
 modal_docs/gen_reference_docs.py,sha256=ic2qrSF7-A45IFeS7rKXvolSC_Zcum70XvVje3m74S0,6144
 modal_docs/gen_reference_docs_main.py,sha256=56Cr3YKgq4qgb01bEcumTo1Px87boGGOFeHQ0Wcjg74,210
 modal_docs/mdmd/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
-modal_docs/mdmd/mdmd.py,sha256=djF9wyfy6FoOLtvYsFncgRV3WZiunSr-zPSmJz61Wrg,20454
+modal_docs/mdmd/mdmd.py,sha256=gAat7jmIVyzxTnaw5MUM5U_3VKMqNKk1E6FJL3NIius,20518
 modal_docs/mdmd/signatures.py,sha256=Xx1FF6oND90MfbHJ24E9rej_GjmEGOAaOp6oJpkv1Os,10174
 modal_docs/mdmd/types.py,sha256=MIh5VOnWvFd8T1aZT_vTB2OeLbPB5TASdOaX8jGvpQk,710
 modal_proto/__init__.py,sha256=tFdSv9eaHBvYcwhgq-XqIlYDNDw57clrvO91Fb-oUV4,130
-modal_proto/api_grpc.py,sha256=BXhVof9Iy9rPbuGNSr_uIDOrdzh4m3cTaIDkxoiLYQU,169044
-modal_proto/api_pb2.py,sha256=wMjeG2g3g7OEwrzT3vnmTRGZ7Qr5kTL0UEXa9TuvMX4,467602
-modal_proto/api_pb2.pyi,sha256=x5-i2N1wI78-MufXLzy1NIFn_9QZ3qjuAXcidsuCVkI,650807
-modal_proto/api_pb2_grpc.py,sha256=cpLTRo1ZDam-qmhfshgGIeK2Mw-957F8u6eZcftXWhw,363694
-modal_proto/api_pb2_grpc.pyi,sha256=NuTeCJ8vcLTOSvva6T27Oj9qKkDB7gKcAVfmmdUULQ4,84966
-modal_proto/modal_api_grpc.py,sha256=5DHjTCyG9RB5jdDNwcpBVtx3Ua1Dg5DIDu_DvgDws8k,26663
+modal_proto/api_grpc.py,sha256=ttl6R1gTtFo-f35eYobQEEaG6dXekYzGaqbSdS-6YH8,171624
+modal_proto/api_pb2.py,sha256=B7S8Sgykb8OAB8onkPsBQzfApqxV9tiaQYHI4yMRI2s,470981
+modal_proto/api_pb2.pyi,sha256=9d89DnqR2Lah2hCCsoZtsPZIz3jpWUXAsksUaAj2Jow,653421
+modal_proto/api_pb2_grpc.py,sha256=3CLIMPQ7-hPe6l1GxOs0IJpoP3TjtdoN5EArkR4WsgQ,369037
+modal_proto/api_pb2_grpc.pyi,sha256=LMUgIbLi38ZwZux_AFGWMjRin8auy0RiVSBU9ysmgTE,86233
+modal_proto/modal_api_grpc.py,sha256=934KM6shysR3NIIeziZKCKKkRsP9e_shMa-PEvMLfys,27083
 modal_proto/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 modal_proto/task_command_router_grpc.py,sha256=xJGVEHXSU6t4qpIkNlNdGyLMwLd5CShm93gRONL4ndI,19403
 modal_proto/task_command_router_pb2.py,sha256=A-Q_mi-Wf761JNtcOmUkoWsPpIuYiGYcoKpJsn8bDRU,37368
 modal_proto/task_command_router_pb2.pyi,sha256=-0UrXDxiTvIy_BUP7OGeGNeLVaTWPHWDSaES4FVMYyw,42841
 modal_proto/task_command_router_pb2_grpc.py,sha256=QM5h4IvjweLZ6ZRyJD5AB8juzw4anhj4hzPS8mE1mWM,38611
 modal_proto/task_command_router_pb2_grpc.pyi,sha256=jLJvR5sZmKqU_3pTul-Mgfc7WcG5gQjvHS9CbACpFIU,12602
-modal_version/__init__.py,sha256=zJasD63IVnWBdrYwCLFH_o6sXGX4qdIQPNV2rLclhFQ,120
+modal_version/__init__.py,sha256=cRMLrALDqpvtpHL2nP0SNeBXLOdLJjyWblr61mdASYw,120
 modal_version/__main__.py,sha256=nLUbubxKx7GXNzJIkTB7M7_u8080LyLM0IS0rzFkC_c,119
-modal-1.5.2.dev5.dist-info/METADATA,sha256=69zEZi2xYO3kPZDStB0XqIlBsmqJCJ409PV8kkgFsyY,2512
-modal-1.5.2.dev5.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-modal-1.5.2.dev5.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.5.2.dev5.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.5.2.dev5.dist-info/RECORD,,
+modal-1.5.2.dev7.dist-info/METADATA,sha256=ZJMoVaOPfMRq4KrV_G-ZA4xFBeOXpb-_SKV_5gyyevc,2512
+modal-1.5.2.dev7.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+modal-1.5.2.dev7.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.5.2.dev7.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.5.2.dev7.dist-info/RECORD,,

modal_docs/mdmd/mdmd.py

@@ -3,9 +3,9 @@
 
 import html
 import inspect
+import logging
 import re
 import typing
-import warnings
 from collections.abc import Callable
 from enum import Enum, EnumMeta
 from types import ModuleType
@@ -15,6 +15,8 @@ import synchronicity.synchronizer
 from .signatures import get_signature, parse_params_from_signature, strip_signature
 from .types import ParsedDoc, ParsedParam, ParsedRaise
 
+logger = logging.getLogger(__name__)
+
 
 def _escape_svelte_html_attr(value: str) -> str:
     """Escape text for double-quoted HTML / Svelte component attributes.
@@ -475,7 +477,7 @@ def module_str(header, module, title_level="#", filter_items: Callable[[ModuleTy
                 object_docs.append(f"{member_title_level} {qual_name}\n\n")
                 object_docs.append(item_doc)
             else:
-                warnings.warn(f"Not sure how to document: {name} ({item}")
+                logger.warning(f"[mdmd] Not sure how to document {name} ({item.__class__.__name__})")
 
     if object_docs:
         return "".join(header + object_docs)

modal_proto/api_grpc.py

@@ -891,6 +891,18 @@ class ModalClientBase(abc.ABC):
     async def WorkspaceNameLookup(self, stream: 'grpclib.server.Stream[google.protobuf.empty_pb2.Empty, modal_proto.api_pb2.WorkspaceNameLookupResponse]') -> None:
         pass
 
+    @abc.abstractmethod
+    async def WorkspaceSetDefaultEnvironment(self, stream: 'grpclib.server.Stream[modal_proto.api_pb2.WorkspaceSetDefaultEnvironmentRequest, google.protobuf.empty_pb2.Empty]') -> None:
+        pass
+
+    @abc.abstractmethod
+    async def WorkspaceSetImageBuilderVersion(self, stream: 'grpclib.server.Stream[modal_proto.api_pb2.WorkspaceSetImageBuilderVersionRequest, modal_proto.api_pb2.WorkspaceSetImageBuilderVersionResponse]') -> None:
+        pass
+
+    @abc.abstractmethod
+    async def WorkspaceSettings(self, stream: 'grpclib.server.Stream[google.protobuf.empty_pb2.Empty, modal_proto.api_pb2.WorkspaceSettingsResponse]') -> None:
+        pass
+
     def __mapping__(self) -> typing.Dict[str, grpclib.const.Handler]:
         return {
             '/modal.client.ModalClient/AppClientDisconnect': grpclib.const.Handler(
@@ -2201,6 +2213,24 @@ class ModalClientBase(abc.ABC):
                 google.protobuf.empty_pb2.Empty,
                 modal_proto.api_pb2.WorkspaceNameLookupResponse,
             ),
+            '/modal.client.ModalClient/WorkspaceSetDefaultEnvironment': grpclib.const.Handler(
+                self.WorkspaceSetDefaultEnvironment,
+                grpclib.const.Cardinality.UNARY_UNARY,
+                modal_proto.api_pb2.WorkspaceSetDefaultEnvironmentRequest,
+                google.protobuf.empty_pb2.Empty,
+            ),
+            '/modal.client.ModalClient/WorkspaceSetImageBuilderVersion': grpclib.const.Handler(
+                self.WorkspaceSetImageBuilderVersion,
+                grpclib.const.Cardinality.UNARY_UNARY,
+                modal_proto.api_pb2.WorkspaceSetImageBuilderVersionRequest,
+                modal_proto.api_pb2.WorkspaceSetImageBuilderVersionResponse,
+            ),
+            '/modal.client.ModalClient/WorkspaceSettings': grpclib.const.Handler(
+                self.WorkspaceSettings,
+                grpclib.const.Cardinality.UNARY_UNARY,
+                google.protobuf.empty_pb2.Empty,
+                modal_proto.api_pb2.WorkspaceSettingsResponse,
+            ),
         }
 
 
@@ -3515,3 +3545,21 @@ class ModalClientStub:
             google.protobuf.empty_pb2.Empty,
             modal_proto.api_pb2.WorkspaceNameLookupResponse,
         )
+        self.WorkspaceSetDefaultEnvironment = grpclib.client.UnaryUnaryMethod(
+            channel,
+            '/modal.client.ModalClient/WorkspaceSetDefaultEnvironment',
+            modal_proto.api_pb2.WorkspaceSetDefaultEnvironmentRequest,
+            google.protobuf.empty_pb2.Empty,
+        )
+        self.WorkspaceSetImageBuilderVersion = grpclib.client.UnaryUnaryMethod(
+            channel,
+            '/modal.client.ModalClient/WorkspaceSetImageBuilderVersion',
+            modal_proto.api_pb2.WorkspaceSetImageBuilderVersionRequest,
+            modal_proto.api_pb2.WorkspaceSetImageBuilderVersionResponse,
+        )
+        self.WorkspaceSettings = grpclib.client.UnaryUnaryMethod(
+            channel,
+            '/modal.client.ModalClient/WorkspaceSettings',
+            google.protobuf.empty_pb2.Empty,
+            modal_proto.api_pb2.WorkspaceSettingsResponse,
+        )