modal 1.5.2.dev14__tar.gz → 1.5.2.dev15__tar.gz

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

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

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/__init__.py

@@ -9,7 +9,7 @@ if sys.version_info[:2] >= (3, 15):
 from modal_version import __version__
 
 try:
-    from . import billing
+    from . import billing, types
     from ._runtime.execution_context import current_function_call_id, current_input_id, interact, is_local
     from ._tunnel import Tunnel, forward
     from .app import App
@@ -100,6 +100,7 @@ __all__ = [
     "interact",
     "method",
     "parameter",
+    "types",
     "web_endpoint",
     "web_server",
     "wsgi_app",

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/_billing.py

@@ -1,10 +1,7 @@
 # Copyright Modal Labs 2025
-from dataclasses import FrozenInstanceError, dataclass
-from datetime import datetime, timezone
+from datetime import datetime
 from decimal import Decimal
-from typing import Any, Iterable, TypedDict
-
-from modal_proto import api_pb2
+from typing import TypedDict
 
 from ._utils.deprecation import deprecation_warning
 from .client import _Client
@@ -19,54 +16,6 @@ class WorkspaceBillingReportItem(TypedDict):
     tags: dict[str, str]
 
 
-@dataclass(slots=True, frozen=True)
-class BillingReportItem:
-    object_id: str
-    description: str
-    environment_name: str
-    interval_start: datetime
-    cost: Decimal
-    cost_by_resource: dict[str, Decimal]
-    tags: dict[str, str]
-
-    def __getitem__(self, key: str) -> Any:
-        """mdmd:ignore"""
-        if key not in self.__slots__:
-            raise KeyError(key)
-
-        return getattr(self, key)
-
-    def __setitem__(self, key: str, _: Any):
-        """mdmd:ignore"""
-        raise FrozenInstanceError(f"cannot assign to field {key!r}")
-
-    def keys(self) -> Iterable[str]:
-        """mdmd:ignore"""
-        yield from self.__slots__
-
-    def values(self) -> Iterable[Any]:
-        """mdmd:ignore"""
-        for k in self.__slots__:
-            yield getattr(self, k)
-
-    def items(self) -> Iterable[tuple[str, Any]]:
-        """mdmd:ignore"""
-        for k in self.__slots__:
-            yield k, getattr(self, k)
-
-    @classmethod
-    def _from_proto(cls, pb_item: api_pb2.WorkspaceBillingReportItem) -> "BillingReportItem":
-        return cls(
-            object_id=pb_item.object_id,
-            description=pb_item.description,
-            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(v) for k, v in pb_item.cost_by_resource.items()},
-            tags=dict(pb_item.tags),
-        )
-
-
 async def _workspace_billing_report(
     *,
     start: datetime,  # Start of the report, inclusive

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/_environments.py

@@ -13,7 +13,6 @@ from synchronicity import classproperty
 
 from modal_proto import api_pb2
 
-from ._billing import BillingReportItem
 from ._load_context import LoadContext
 from ._object import _Object
 from ._resolver import Resolver
@@ -21,6 +20,7 @@ from ._utils.name_utils import check_environment_name
 from .client import _Client
 from .config import config, logger
 from .exception import InvalidError, WorkspaceManagementError
+from .types import BillingReportItem
 
 
 @dataclass(frozen=True)

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/_functions.py

@@ -90,6 +90,7 @@ from .proxy import _Proxy
 from .retries import Retries, RetryManager
 from .schedule import Schedule
 from .secret import _Secret
+from .types import FunctionStats
 from .volume import _Volume, _volume_to_mount_proto
 
 if TYPE_CHECKING:
@@ -541,17 +542,6 @@ class _InputPlaneInvocation:
         return [("x-modal-input-plane-region", input_plane_region), ("x-modal-auth-token", token)]
 
 
-# Wrapper type for api_pb2.FunctionStats
-@dataclass(frozen=True)
-class FunctionStats:
-    """Simple data structure storing stats for a running function."""
-
-    backlog: int
-    num_total_runners: int
-    num_running_inputs: int
-    input_headroom: int
-
-
 @dataclass
 class _FunctionSpec:
     """

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/_image.py

@@ -2976,7 +2976,7 @@ class _Image(_Object, type_prefix="im"):
             api_pb2.ImagePublishRequest(
                 image_id=self._object_id,
                 environment_name=resolved_env,
-                is_public=False,
+                allow_public=False,
                 tag=tag,
             )
         )

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

@@ -1,22 +1,19 @@
 # Copyright Modal Labs 2025
 import builtins
-from dataclasses import dataclass
 from datetime import datetime, timezone
-from typing import Literal, Optional
+from typing import Optional
 
 from google.protobuf.empty_pb2 import Empty
 
 from modal.exception import InvalidError
 from modal_proto import api_pb2
 
-from ._billing import BillingReportItem
 from ._load_context import LoadContext
 from ._object import _Object
 from ._resolver import Resolver
 from ._utils.time_utils import timestamp_to_localized_dt
 from .client import _Client
-
-MemberRole = Literal["user", "manager", "owner"]
+from .types import BillingReportItem, MemberRole, ProxyTokenInfo, TokenData, WorkspaceMemberInfo, WorkspaceSettings
 
 
 def _member_role_from_proto(proto_value: int) -> MemberRole:
@@ -31,18 +28,6 @@ def _member_role_from_proto(proto_value: int) -> MemberRole:
             raise ValueError(f"Unknown workspace member role: {proto_value}")
 
 
-@dataclass(frozen=True)
-class WorkspaceMemberInfo:
-    """Metadata about a Workspace member."""
-
-    name: str
-    email: str
-    user_id: str
-    role: MemberRole
-    joined_at: datetime
-    last_active_at: Optional[datetime]  # None if the member has never been active
-
-
 class _WorkspaceMembersManager:
     """mdmd:namespace
     Namespace with methods for managing the membership of a Workspace.
@@ -130,23 +115,6 @@ class _Workspace(_Object, type_prefix="ac"):
         return _WorkspaceSettingsManager(self)
 
 
-@dataclass(frozen=True)
-class TokenData:
-    """A token ID / secret pair."""
-
-    token_id: str
-    token_secret: str
-
-
-@dataclass(frozen=True)
-class ProxyTokenInfo:
-    """Metadata about a proxy token, not including the token secret."""
-
-    token_id: str
-    created_at: datetime
-    scoped: bool
-
-
 class _WorkspaceProxyTokenManager:
     """mdmd:namespace
     Namespace with methods for managing the proxy tokens in a Workspace.
@@ -346,14 +314,6 @@ class _WorkspaceBillingManager:
         ]
 
 
-@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.

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/billing.py

@@ -1,6 +1,7 @@
 # Copyright Modal Labs 2025
-from ._billing import BillingReportItem, WorkspaceBillingReportItem, _workspace_billing_report
+from ._billing import WorkspaceBillingReportItem, _workspace_billing_report
 from ._utils.async_utils import synchronize_api
+from .types import BillingReportItem
 
 workspace_billing_report = synchronize_api(_workspace_billing_report, target_module=__name__)
 

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/billing.pyi

@@ -2,12 +2,32 @@ import datetime
 import decimal
 import modal._billing
 import modal.client
+import modal.types
 import modal_proto.api_pb2
 import typing
 import typing_extensions
 
+class WorkspaceBillingReportItem(typing.TypedDict):
+    """dict() -> new empty dictionary
+    dict(mapping) -> new dictionary initialized from a mapping object's
+        (key, value) pairs
+    dict(iterable) -> new dictionary initialized as if via:
+        d = {}
+        for k, v in iterable:
+            d[k] = v
+    dict(**kwargs) -> new dictionary initialized with the name=value pairs
+        in the keyword argument list.  For example:  dict(one=1, two=2)
+    """
+
+    object_id: str
+    description: str
+    environment_name: str
+    interval_start: datetime.datetime
+    cost: decimal.Decimal
+    tags: dict[str, str]
+
 class BillingReportItem:
-    """BillingReportItem(object_id: str, description: str, environment_name: str, interval_start: datetime.datetime, cost: decimal.Decimal, cost_by_resource: dict[str, decimal.Decimal], tags: dict[str, str])"""
+    """Costs generated by a specific object during a specific time interval."""
 
     object_id: str
     description: str
@@ -18,29 +38,27 @@ class BillingReportItem:
     tags: dict[str, str]
 
     def __getitem__(self, key: str) -> typing.Any:
-        """mdmd:ignore"""
+        """mdmd:hidden"""
         ...
 
     def __setitem__(self, key: str, _: typing.Any):
-        """mdmd:ignore"""
+        """mdmd:hidden"""
         ...
 
     def keys(self) -> typing.Iterable[str]:
-        """mdmd:ignore"""
+        """mdmd:hidden"""
         ...
 
     def values(self) -> typing.Iterable[typing.Any]:
-        """mdmd:ignore"""
+        """mdmd:hidden"""
         ...
 
     def items(self) -> typing.Iterable[tuple[str, typing.Any]]:
-        """mdmd:ignore"""
+        """mdmd:hidden"""
         ...
 
     @classmethod
-    def _from_proto(
-        cls, pb_item: modal_proto.api_pb2.WorkspaceBillingReportItem
-    ) -> modal._billing.BillingReportItem: ...
+    def _from_proto(cls, pb_item: modal_proto.api_pb2.WorkspaceBillingReportItem) -> modal.types.BillingReportItem: ...
     def __init__(
         self,
         object_id: str,
@@ -77,25 +95,6 @@ class BillingReportItem:
     def __getstate__(self): ...
     def __setstate__(self, state): ...
 
-class WorkspaceBillingReportItem(typing.TypedDict):
-    """dict() -> new empty dictionary
-    dict(mapping) -> new dictionary initialized from a mapping object's
-        (key, value) pairs
-    dict(iterable) -> new dictionary initialized as if via:
-        d = {}
-        for k, v in iterable:
-            d[k] = v
-    dict(**kwargs) -> new dictionary initialized with the name=value pairs
-        in the keyword argument list.  For example:  dict(one=1, two=2)
-    """
-
-    object_id: str
-    description: str
-    environment_name: str
-    interval_start: datetime.datetime
-    cost: decimal.Decimal
-    tags: dict[str, str]
-
 class __workspace_billing_report_spec(typing_extensions.Protocol):
     def __call__(
         self,

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/call_graph.py

@@ -1,36 +1,7 @@
 # Copyright Modal Labs 2022
-from dataclasses import dataclass
-from enum import IntEnum
-
 from modal_proto import api_pb2
 
-
-class InputStatus(IntEnum):
-    """Enum representing status of a function input."""
-
-    PENDING = 0
-    SUCCESS = api_pb2.GenericResult.GENERIC_STATUS_SUCCESS
-    FAILURE = api_pb2.GenericResult.GENERIC_STATUS_FAILURE
-    INIT_FAILURE = api_pb2.GenericResult.GENERIC_STATUS_INIT_FAILURE
-    TERMINATED = api_pb2.GenericResult.GENERIC_STATUS_TERMINATED
-    TIMEOUT = api_pb2.GenericResult.GENERIC_STATUS_TIMEOUT
-
-    @classmethod
-    def _missing_(cls, value):
-        return cls.PENDING
-
-
-@dataclass
-class InputInfo:
-    """Simple data structure storing information about a function input."""
-
-    input_id: str
-    function_call_id: str
-    task_id: str
-    status: InputStatus
-    function_name: str
-    module_name: str
-    children: list["InputInfo"]
+from .types import InputInfo, InputStatus
 
 
 def _reconstruct_call_graph(ser_graph: api_pb2.FunctionGetCallGraphResponse) -> list[InputInfo]:

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/_download.py

@@ -13,7 +13,8 @@ from click import UsageError
 from modal._utils.async_utils import TaskContext
 from modal.config import logger
 from modal.network_file_system import _NetworkFileSystem
-from modal.volume import FileEntry, FileEntryType, _Volume
+from modal.types import FileEntry, FileEntryType
+from modal.volume import _Volume
 
 PIPE_PATH = Path("-")
 

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/cluster.py

@@ -59,7 +59,7 @@ async def list_(env: str | None = None, json: bool = False):
     display_table(column_names, rows, json=json, title=f"Active Multi-node Clusters in environment: {environment_name}")
 
 
-@cluster_cli.command("shell")
+@cluster_cli.command("shell", no_args_is_help=True)
 @click.argument("cluster_id")
 @click.option("--rank", default=0, help="Rank of the node to shell into")
 @synchronizer.create_blocking

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/config.py

@@ -40,7 +40,7 @@ when running a command that requires an environment.
 """
 
 
-@config_cli.command("set-environment", help=SET_DEFAULT_ENV_HELP)
+@config_cli.command("set-environment", help=SET_DEFAULT_ENV_HELP, no_args_is_help=True)
 @click.argument("environment_name")
 def set_environment(environment_name: str):
     # Confirm that the environment exists by looking it up
@@ -49,7 +49,7 @@ def set_environment(environment_name: str):
     click.echo(f"New default environment for profile {_profile}: {environment_name}")
 
 
-@config_cli.command("set", hidden=True)
+@config_cli.command("set", hidden=True, no_args_is_help=True)
 @click.argument("key")
 @click.argument("value")
 def set(key: str, value: str):

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

@@ -317,7 +317,7 @@ async def _exec_impl(
         ).wait()
 
 
-@container_cli.command("exec")
+@container_cli.command("exec", no_args_is_help=True)
 @click.option("--pty/--no-pty", default=None, help="Run the command using a PTY.")
 @click.argument("container_id")
 @click.argument("command", nargs=-1, required=True)
@@ -330,7 +330,7 @@ def exec(
     _exec_impl(pty=pty, container_id=container_id, command=command)
 
 
-@container_cli.command("stop")
+@container_cli.command("stop", no_args_is_help=True)
 @click.argument("container_id")
 @click.option(
     "--graceful",

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/curl.py

@@ -96,7 +96,12 @@ def _run_curl(curl_args: tuple[str, ...], token: str | None = None) -> None:
     sys.exit(subprocess.call(cmd))
 
 
-@click.command("curl", cls=ModalCommand, context_settings={"ignore_unknown_options": True, "allow_extra_args": True})
+@click.command(
+    "curl",
+    cls=ModalCommand,
+    no_args_is_help=True,
+    context_settings={"ignore_unknown_options": True, "allow_extra_args": True},
+)
 @click.argument("curl_args", nargs=-1, required=True, type=click.UNPROCESSED)
 @synchronizer.create_blocking
 async def curl(curl_args: tuple[str, ...]):

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/dict.py

@@ -21,7 +21,7 @@ dict_cli = ModalGroup(
 )
 
 
-@dict_cli.command("create", panel="Management")
+@dict_cli.command("create", panel="Management", no_args_is_help=True)
 @click.argument("name")
 @env_option
 @synchronizer.create_blocking
@@ -55,7 +55,7 @@ async def list_(*, json: bool = False, env: str | None = None):
     display_table(["Name", "Created at", "Created by"], rows, json)
 
 
-@dict_cli.command("clear", panel="Management")
+@dict_cli.command("clear", panel="Management", no_args_is_help=True)
 @click.argument("name")
 @yes_option
 @env_option
@@ -72,7 +72,7 @@ async def clear(name: str, *, yes: bool = False, env: str | None = None):
     await d.clear()
 
 
-@dict_cli.command("delete", panel="Management")
+@dict_cli.command("delete", panel="Management", no_args_is_help=True)
 @click.argument("name")
 @click.option("--allow-missing", is_flag=True, default=False, help="Don't error if the Dict doesn't exist.")
 @yes_option
@@ -95,7 +95,7 @@ async def delete(
     await _Dict.objects.delete(name, environment_name=env, allow_missing=allow_missing)
 
 
-@dict_cli.command("get", panel="Inspection")
+@dict_cli.command("get", panel="Inspection", no_args_is_help=True)
 @click.argument("name")
 @click.argument("key")
 @env_option
@@ -115,7 +115,7 @@ def _display(input: str, use_repr: bool) -> str:
     return val[:80] + "..." if len(val) > 80 else val
 
 
-@dict_cli.command("items", panel="Inspection")
+@dict_cli.command("items", panel="Inspection", no_args_is_help=True)
 @click.argument("name")
 @click.argument("n", default=20, type=int)
 @click.option(

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/environment.py

@@ -63,7 +63,7 @@ def list_(json: bool = False):
     display_table(["name", "web suffix", "active"], table_data, json=json)
 
 
-@environment_cli.command("create", help="Create a new environment in the current workspace.")
+@environment_cli.command("create", help="Create a new environment in the current workspace.", no_args_is_help=True)
 @click.argument("name")
 @click.option("--restricted", is_flag=True, default=False, help="Enable RBAC restrictions on the new environment")
 def create(name: str, restricted: bool = False):
@@ -79,7 +79,7 @@ Deletes all apps in the selected environment and deletes the environment irrevoc
 """
 
 
-@environment_cli.command("delete", help=ENVIRONMENT_DELETE_HELP)
+@environment_cli.command("delete", help=ENVIRONMENT_DELETE_HELP, no_args_is_help=True)
 @click.argument("name")
 @yes_option
 def delete(
@@ -100,7 +100,7 @@ def delete(
     rich.print(f"[green]✓[/green] Environment deleted: {name}")
 
 
-@environment_cli.command("update", help="Update environment-level settings.")
+@environment_cli.command("update", help="Update environment-level settings.", no_args_is_help=True)
 @click.argument("current_name")
 @click.option("--set-name", default=None, help="New name of the environment")
 @click.option("--set-web-suffix", default=None, help="New web suffix of environment (empty string is no suffix)")

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/image.py

@@ -57,14 +57,12 @@ 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 "-",
+        "published_by": item.published_by 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 "-",
-    )
+def _history_item_row(item: api_pb2.ImageTagRevisionsItem) -> tuple[str, str, str]:
+    return (item.image_id, timestamp_to_localized_str(item.created_at, False) or "-", item.published_by or "-")
 
 
 async def _iter_tag_pages(
@@ -158,7 +156,9 @@ async def list_(
     _print_result_summary(count)
 
 
-@image_names_cli.command("history", help="Show publishing history for a named Image.", hidden=True)
+@image_names_cli.command(
+    "history", help="Show publishing history for a named Image.", hidden=True, no_args_is_help=True
+)
 @click.argument("name")
 @env_option
 @click.option("--json", is_flag=True, default=False)
@@ -197,7 +197,7 @@ async def history(
         if response.items:
             title = f"History for {response.tag}" if show_title else ""
             display_table(
-                ["Image ID", "Published at"],
+                ["Image ID", "Published at", "Published by"],
                 [_history_item_row(item) for item in response.items],
                 title=title,
             )

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/network_file_system.py

@@ -56,7 +56,7 @@ def some_func():
 """
 
 
-@nfs_cli.command("create", help="Create a named network file system.", panel="Management")
+@nfs_cli.command("create", help="Create a named network file system.", panel="Management", no_args_is_help=True)
 @click.argument("name")
 @env_option
 def create(
@@ -71,7 +71,9 @@ def create(
     output.print(usage)
 
 
-@nfs_cli.command("ls", help="List files and directories in a network file system.", panel="File operations")
+@nfs_cli.command(
+    "ls", help="List files and directories in a network file system.", panel="File operations", no_args_is_help=True
+)
 @click.argument("volume_name")
 @click.argument("path", default="/")
 @env_option
@@ -102,7 +104,7 @@ async def ls(
             print(entry.path)  # noqa: T201
 
 
-@nfs_cli.command("put", panel="File operations")
+@nfs_cli.command("put", panel="File operations", no_args_is_help=True)
 @click.argument("volume_name")
 @click.argument("local_path")
 @click.argument("remote_path", default="/")
@@ -147,7 +149,7 @@ class CliError(Exception):
         self.message = message
 
 
-@nfs_cli.command("get", panel="File operations")
+@nfs_cli.command("get", panel="File operations", no_args_is_help=True)
 @click.argument("volume_name")
 @click.argument("remote_path")
 @click.argument("local_destination", default=".")
@@ -183,7 +185,9 @@ async def get(
     output.step_completed("Finished downloading files to local!")
 
 
-@nfs_cli.command("rm", help="Delete a file or directory from a network file system.", panel="File operations")
+@nfs_cli.command(
+    "rm", help="Delete a file or directory from a network file system.", panel="File operations", no_args_is_help=True
+)
 @click.argument("volume_name")
 @click.argument("remote_path")
 @click.option("-r", "--recursive", is_flag=True, default=False, help="Delete directory recursively")
@@ -201,7 +205,9 @@ async def rm(
     OutputManager.get().step_completed(f"{remote_path} was deleted successfully!")
 
 
-@nfs_cli.command("delete", help="Delete a named, persistent modal.NetworkFileSystem.", panel="Management")
+@nfs_cli.command(
+    "delete", help="Delete a named, persistent modal.NetworkFileSystem.", panel="Management", no_args_is_help=True
+)
 @click.argument("nfs_name")
 @yes_option
 @env_option

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/profile.py

@@ -25,7 +25,7 @@ from ._help import ModalGroup
 profile_cli = ModalGroup(name="profile", help="Switch between Modal profiles.")
 
 
-@profile_cli.command("activate", help="Change the active Modal profile.")
+@profile_cli.command("activate", help="Change the active Modal profile.", no_args_is_help=True)
 @click.argument("profile")
 def activate(profile: str):
     config_set_active_profile(profile)

{modal-1.5.2.dev14 → modal-1.5.2.dev15}/modal/cli/queues.py

@@ -32,7 +32,7 @@ def partition_option(func):
     )(func)
 
 
-@queue_cli.command("create", panel="Management")
+@queue_cli.command("create", panel="Management", no_args_is_help=True)
 @click.argument("name")
 @env_option
 @synchronizer.create_blocking
@@ -49,7 +49,7 @@ async def create(name: str, *, env: str | None = None):
         await resolver.load(q, load_context)
 
 
-@queue_cli.command("delete", panel="Management")
+@queue_cli.command("delete", panel="Management", no_args_is_help=True)
 @click.argument("name")
 @click.option("--allow-missing", is_flag=True, default=False, help="Don't error if the Queue doesn't exist.")
 @yes_option
@@ -122,7 +122,7 @@ async def list_(*, json: bool = False, env: str | None = None):
     display_table(["Name", "Created at", "Created by", "Partitions", "Total size"], rows, json)
 
 
-@queue_cli.command("clear", panel="Management")
+@queue_cli.command("clear", panel="Management", no_args_is_help=True)
 @click.argument("name")
 @partition_option
 @click.option("-a", "--all", "all", is_flag=True, default=False, help="Clear the contents of all partitions.")
@@ -148,7 +148,7 @@ async def clear(
     await q.clear(partition=partition, all=all)
 
 
-@queue_cli.command("peek", panel="Inspection")
+@queue_cli.command("peek", panel="Inspection", no_args_is_help=True)
 @click.argument("name")
 @click.argument("n", default=1, type=int)
 @partition_option
@@ -166,7 +166,7 @@ async def peek(name: str, n: int = 1, partition: str | None = None, *, env: str
             break
 
 
-@queue_cli.command("len", panel="Inspection")
+@queue_cli.command("len", panel="Inspection", no_args_is_help=True)
 @click.argument("name")
 @partition_option
 @click.option(