anyscale 0.26.51__py3-none-any.whl → 0.26.53__py3-none-any.whl

anyscale/commands/list_commands.py

@@ -8,6 +8,7 @@ from typing import Any, Optional
 import click
 
 from anyscale.cli_logger import BlockLogger
+from anyscale.commands.util import DeprecatedAnyscaleCommand
 from anyscale.controllers.list_controller import ListController
 
 
@@ -25,26 +26,40 @@ def list_cli() -> None:
     name="clouds",
     help="[DEPRECATED] List the clouds currently available in your account.",
     hidden=True,
+    cls=DeprecatedAnyscaleCommand,
+    removal_date="2025-10-01",
+    deprecation_message="`anyscale list clouds` has been deprecated",
+    alternative="use `anyscale cloud list` instead",
 )
 @click.option("--json", "show_json", help="Return the results in json", is_flag=True)
 def list_clouds(show_json: bool) -> None:
-    log.warning(
-        "`anyscale list clouds` has been deprecated. Please use `anyscale cloud list` instead."
-    )
+    """List the clouds currently available in your account.
+
+    DEPRECATED: This command will be removed on 2025-10-01.
+    Use 'anyscale cloud list' instead.
+    """
     list_controller = ListController()
     output = list_controller.list_clouds(json_format=show_json)
     print(output)
 
 
 @list_cli.command(
-    name="projects", help="[DEPRECATED] List all accessible projects.", hidden=True
+    name="projects",
+    help="[DEPRECATED] List all accessible projects.",
+    hidden=True,
+    cls=DeprecatedAnyscaleCommand,
+    removal_date="2025-10-01",
+    deprecation_message="`anyscale list projects` has been deprecated",
+    alternative="use `anyscale project list` instead",
 )
 @click.option("--json", "show_json", help="Return the results in json", is_flag=True)
 @click.pass_context
 def project_list(ctx: Any, show_json: bool) -> None:  # noqa: ARG001
-    log.warning(
-        "`anyscale list projects` has been deprecated. Please use `anyscale project list` instead."
-    )
+    """List all accessible projects.
+
+    DEPRECATED: This command will be removed on 2025-10-01.
+    Use 'anyscale project list' instead.
+    """
     list_controller = ListController()
     output = list_controller.list_projects(json_format=show_json)
     print(output)
@@ -54,6 +69,10 @@ def project_list(ctx: Any, show_json: bool) -> None:  # noqa: ARG001
     name="sessions",
     help="[DEPRECATED] List all clusters within the current project.",
     hidden=True,
+    cls=DeprecatedAnyscaleCommand,
+    removal_date="2025-10-01",
+    deprecation_message="`anyscale list sessions` has been deprecated",
+    alternative="use `anyscale cluster list` instead",
 )
 @click.option(
     "--name",
@@ -65,9 +84,11 @@ def project_list(ctx: Any, show_json: bool) -> None:  # noqa: ARG001
 @click.option("--all", help="List all clusters, including inactive ones.", is_flag=True)
 @click.option("--json", "show_json", help="Return the results in json", is_flag=True)
 def session_list(name: Optional[str], all: bool, show_json: bool) -> None:  # noqa: A002
-    log.warning(
-        "`anyscale list sessions` has been deprecated. Please use `anyscale cluster list` instead."
-    )
+    """List all clusters within the current project.
+
+    DEPRECATED: This command will be removed on 2025-10-01.
+    Use 'anyscale cluster list' instead.
+    """
     list_controller = ListController()
     output = list_controller.list_sessions(
         name=name, show_all=all, json_format=show_json
@@ -79,7 +100,16 @@ def session_list(name: Optional[str], all: bool, show_json: bool) -> None:  # no
     name="ips",
     help="[DEPRECATED] List IP addresses of head and worker nodes.",
     context_settings={"ignore_unknown_options": True, "allow_extra_args": True,},
+    cls=DeprecatedAnyscaleCommand,
+    removal_date="2025-10-01",
+    deprecation_message="Listing IPs is not supported on Anyscale",
+    alternative="use the Anyscale console to view cluster node information",
 )
 def list_ips() -> None:
-    """List IP addresses of head and worker nodes."""
-    raise click.ClickException("Listing IPs is not supported on Anyscale V2")
+    """List IP addresses of head and worker nodes.
+
+    DEPRECATED: This command will be removed on 2025-10-01.
+    Listing IPs is not supported on Anyscale.
+    Use the Anyscale console to view cluster node information.
+    """
+    raise click.ClickException("Listing IPs is not supported on Anyscale")

anyscale/commands/project_commands.py

@@ -1,22 +1,103 @@
-from typing import Optional
+from io import StringIO
+from json import dumps as json_dumps
+import sys
+from typing import Dict, Optional, Tuple
 
 import click
+from rich.console import Console
+from rich.table import Table
+import yaml
 
 import anyscale
 from anyscale.cli_logger import BlockLogger
 from anyscale.commands import command_examples
-from anyscale.commands.util import AnyscaleCommand, LegacyAnyscaleCommand, NotRequiredIf
+from anyscale.commands.list_util import display_list
+from anyscale.commands.util import (
+    AnyscaleCommand,
+    DeprecatedAnyscaleCommand,
+    NotRequiredIf,
+)
 from anyscale.controllers.project_controller import ProjectController
 from anyscale.project.models import (
     CreateProjectCollaborator,
     CreateProjectCollaborators,
+    Project,
+    ProjectMinimal,
+    ProjectSortField,
+    ProjectSortOrder,
 )
 from anyscale.project_utils import validate_project_name
-from anyscale.util import validate_non_negative_arg
+from anyscale.util import (
+    AnyscaleJSONEncoder,
+    get_endpoint,
+)
 
 
 log = BlockLogger()
 
+MAX_PAGE_SIZE = 50
+NON_INTERACTIVE_DEFAULT_MAX_ITEMS = 10
+
+
+def _create_project_list_table(show_header: bool) -> Table:
+    table = Table(show_header=show_header, expand=True)
+    # NAME and ID: larger ratios, can wrap but never truncate
+    table.add_column(
+        "NAME", no_wrap=False, overflow="fold", ratio=3, min_width=15,
+    )
+    table.add_column(
+        "ID", no_wrap=False, overflow="fold", ratio=2, min_width=12,
+    )
+    # all other columns will wrap as needed
+    for heading in (
+        "DESCRIPTION",
+        "CREATED AT",
+        "CREATOR",
+        "PARENT CLOUD ID",
+    ):
+        table.add_column(
+            heading, no_wrap=False, overflow="fold", ratio=1, min_width=8,
+        )
+    return table
+
+
+def _format_project_output_data(project: Project) -> Dict[str, str]:
+    return {
+        "name": project.name,
+        "id": project.id,
+        "description": project.description,
+        "created_at": project.created_at,
+        "creator": str(project.creator_id or ""),
+        "parent_cloud_id": str(project.parent_cloud_id or ""),
+    }
+
+
+def _parse_sort_option(
+    sort: Optional[str],
+) -> Tuple[Optional[ProjectSortField], ProjectSortOrder]:
+    if not sort:
+        return None, ProjectSortOrder.ASC
+
+    # build case-insensitive map of allowed fields
+    allowed = {f.value.lower(): f.value for f in ProjectSortField.__members__.values()}
+
+    # detect leading '-' for descending
+    if sort.startswith("-"):
+        raw = sort[1:]
+        order = ProjectSortOrder.DESC
+    else:
+        raw = sort
+        order = ProjectSortOrder.ASC
+
+    key = raw.lower()
+    if key not in allowed:
+        allowed_names = ", ".join(sorted(allowed.values()))
+        raise click.BadParameter(
+            f"Invalid sort field '{raw}'. Allowed fields: {allowed_names}"
+        )
+
+    return ProjectSortField(allowed[key]), order
+
 
 @click.group(
     "project",
@@ -28,49 +109,316 @@ def project_cli() -> None:
 
 
 @project_cli.command(
-    name="list",
-    short_help="List projects for which you have access.",
-    help="List projects for which you have access. By default, only projects created by you are listed.",
-    cls=LegacyAnyscaleCommand,
-    is_limited_support=True,
-    legacy_prefix="anyscale project",
+    name="get",
+    help="Get details of a project.",
+    cls=AnyscaleCommand,
+    example=command_examples.PROJECT_GET_EXAMPLE,
 )
 @click.option(
-    "--name", "-n", help="List information for a particular project.", type=str
+    "--id", "-i", type=str, required=True, help="ID of the project.",
 )
-@click.option("--json", help="Format output as JSON.", is_flag=True)
 @click.option(
-    "--any-creator",
-    "-a",
-    help="[Deprecated] List projects created by any user.",
+    "--json",
+    "-j",
     is_flag=True,
-    default=None,
-    hidden=True,
+    default=False,
+    help="Output the details in a structured JSON format.",
+)
+def get(id: str, json: bool = False):  # noqa: A002
+    try:
+        project: Project = anyscale.project.get(project_id=id)
+    except ValueError as e:
+        log.error(f"Error getting project details: {e}")
+        sys.exit(1)
+
+    console = Console()
+    if json:
+        json_str = json_dumps(project.to_dict(), indent=2, cls=AnyscaleJSONEncoder)
+        console.print_json(json=json_str)
+    else:
+        stream = StringIO()
+        yaml.dump(project.to_dict(), stream, sort_keys=False)
+        console.print(stream.getvalue(), end="")
+
+
+@project_cli.command(
+    name="list",
+    help="List all projects with optional filters.",
+    cls=AnyscaleCommand,
+    example=command_examples.PROJECT_LIST_EXAMPLE,
 )
-@click.option("--created-by-me", help="List projects created by me only.", is_flag=True)
 @click.option(
-    "--max-items",
-    required=False,
-    default=20,
+    "--name", "-n", type=str, help="A string to filter projects by name.",
+)
+@click.option(
+    "--creator", "-u", type=str, help="The ID of a creator to filter projects.",
+)
+@click.option(
+    "--cloud", "-c", type=str, help="The ID of a parent cloud to filter projects.",
+)
+@click.option(
+    "--include-defaults/--exclude-defaults",
+    default=True,
+    show_default=True,
+    help="Whether to include default projects.",
+)
+@click.option(
+    "--max-items", type=int, help="The maximum number of projects to return.",
+)
+@click.option(
+    "--page-size",
     type=int,
-    help="Max items to show in list.",
-    callback=validate_non_negative_arg,
+    default=10,
+    show_default=True,
+    help="The number of projects to return per page.",
+)
+@click.option(
+    "--sort",
+    help=(
+        "Sort by FIELD (prefix with '-' for desc). "
+        f"Allowed: {', '.join(ProjectSortField.__members__.values())}"
+    ),
+)
+@click.option(
+    "--interactive/--no-interactive",
+    default=True,
+    show_default=True,
+    help="Use interactive paging.",
+)
+@click.option(
+    "--json",
+    "-j",
+    is_flag=True,
+    default=False,
+    help="Output the list in a structured JSON format.",
 )
 def list(  # noqa: A001
+    *,
+    name: Optional[str] = None,
+    creator: Optional[str] = None,
+    cloud: Optional[str] = None,
+    include_defaults: bool = True,
+    max_items: Optional[int] = None,
+    page_size: Optional[int] = None,
+    sort: Optional[str] = None,
+    interactive: bool = True,
+    json: bool = False,
+):
+
+    if max_items is not None and interactive:
+        raise click.UsageError("--max-items only allowed with --no-interactive")
+
+    sort_field, sort_order = _parse_sort_option(sort)
+
+    # normalize max_items
+    effective_max = max_items
+    if not interactive and effective_max is None:
+        stderr = Console(stderr=True)
+        stderr.print(
+            f"Defaulting to {NON_INTERACTIVE_DEFAULT_MAX_ITEMS} items in batch mode; "
+            "use --max-items to override."
+        )
+        effective_max = NON_INTERACTIVE_DEFAULT_MAX_ITEMS
+
+    console = Console()
+    stderr = Console(stderr=True)
+
+    # diagnostics
+    stderr.print("[bold]Listing projects with:[/]")
+    stderr.print(f"• name_contains      = {name or '<any>'}")
+    stderr.print(f"• creator_id         = {creator or '<any>'}")
+    stderr.print(f"• parent_cloud_id    = {cloud or '<any>'}")
+    stderr.print(f"• include defaults   = {include_defaults}")
+    stderr.print(f"• sort-field         = {sort_field or '<none>'}")
+    stderr.print(f"• sort-order         = {sort_order or '<none>'}")
+    stderr.print(f"• mode               = {'interactive' if interactive else 'batch'}")
+    stderr.print(f"• per-page limit     = {page_size}")
+    stderr.print(f"• max-items total    = {effective_max or 'all'}")
+    stderr.print(f"\nView your Projects in the UI at {get_endpoint('/projects')}\n")
+
+    # choose formatter
+    if json:
+
+        def formatter(project):
+            return ProjectMinimal.from_dict(project.to_dict()).to_dict()
+
+    else:
+        formatter = _format_project_output_data
+
+    total = 0
+    try:
+        iterator = anyscale.project.list(
+            name_contains=name,
+            creator_id=creator,
+            parent_cloud_id=cloud,
+            include_defaults=include_defaults,
+            max_items=effective_max,
+            page_size=page_size,
+            sort_field=sort_field,
+            sort_order=sort_order,
+        )
+        total = display_list(
+            iterator=iter(iterator),
+            item_formatter=formatter,
+            table_creator=_create_project_list_table,
+            json_output=json,
+            page_size=page_size or MAX_PAGE_SIZE,
+            interactive=interactive,
+            max_items=effective_max,
+            console=console,
+        )
+
+        if not json:
+            if total > 0:
+                stderr.print(f"\nFetched {total} projects.")
+            else:
+                stderr.print("\nNo projects found.")
+    except Exception as e:  # noqa: BLE001
+        log.error(f"Failed to list projects: {e}")
+        sys.exit(1)
+
+
+@project_cli.command(
+    name="create",
+    help="Create a new project.",
+    cls=AnyscaleCommand,
+    example=command_examples.PROJECT_CREATE_EXAMPLE,
+)
+@click.option(
+    "--name", "-n", type=str, required=True, help="Name of the project.",
+)
+@click.option(
+    "--cloud", "-c", type=str, required=True, help="Parent cloud ID for the project.",
+)
+@click.option(
+    "--description", "-d", type=str, help="Description of the project.",
+)
+@click.option(
+    "--initial-cluster-config",
+    "-f",
+    type=str,
+    help="Initial cluster config for the project.",
+)
+def create(
     name: str,
-    json: bool,
-    created_by_me: bool,
-    any_creator: Optional[bool],
-    max_items: int,
+    cloud: str,
+    *,
+    description: Optional[str] = None,
+    initial_cluster_config: Optional[str] = None,
 ) -> None:
-    if any_creator is not None:
-        log.warning(
-            "`--any-creator` and `-a` flags have been deprecated. "
-            "`anyscale project list` now shows projects created by any user by default. "
-            "If you would like to show projects created by you only, you can pass the --created-by-me flag"
+    try:
+        project_id: str = anyscale.project.create(
+            name,
+            cloud,
+            description=description or "",
+            initial_cluster_config=initial_cluster_config,
         )
-    project_controller = ProjectController()
-    project_controller.list(name, json, created_by_me, max_items)
+    except ValueError as e:
+        log.error(f"Error creating project: {e}")
+        sys.exit(1)
+
+    log.info(f"Created project '{name}' with ID: {project_id}")
+
+
+@project_cli.command(
+    name="delete",
+    help="Delete a project.",
+    cls=AnyscaleCommand,
+    example=command_examples.PROJECT_DELETE_EXAMPLE,
+)
+@click.option(
+    "--id", "-i", type=str, required=True, help="ID of the project to delete.",
+)
+def delete(id: str):  # noqa: A002
+    try:
+        anyscale.project.delete(id)
+    except ValueError as e:
+        log.error(f"Error deleting project: {e}")
+        sys.exit(1)
+
+    log.info(f"Deleted project '{id}'")
+
+
+@project_cli.command(
+    name="get-default",
+    help="Get the default project for a cloud.",
+    cls=AnyscaleCommand,
+    example=command_examples.PROJECT_GET_DEFAULT_EXAMPLE,
+)
+@click.option(
+    "--cloud", "-c", type=str, required=True, help="Parent cloud ID for the project.",
+)
+@click.option(
+    "--json",
+    "-j",
+    is_flag=True,
+    default=False,
+    help="Output the project in a structured JSON format.",
+)
+def get_default(cloud: str, json: bool = False):
+    try:
+        project: Project = anyscale.project.get_default(cloud)
+    except ValueError as e:
+        log.error(f"Error getting default project for cloud '{cloud}': {e}")
+        sys.exit(1)
+
+    console = Console()
+    if json:
+        json_str = json_dumps(project.to_dict(), indent=2, cls=AnyscaleJSONEncoder)
+        console.print_json(json=json_str)
+    else:
+        stream = StringIO()
+        yaml.dump(project.to_dict(), stream, sort_keys=False)
+        console.print(stream.getvalue(), end="")
+
+
+@project_cli.command(
+    name="add-collaborators",
+    help="Add collaborators to the project.",
+    cls=AnyscaleCommand,
+    example=command_examples.PROJECT_ADD_COLLABORATORS_EXAMPLE,
+)
+@click.option(
+    "--cloud",
+    "-c",
+    help="Name of the cloud that the project belongs to.",
+    required=True,
+)
+@click.option(
+    "--project",
+    "-p",
+    help="Name of the project to add collaborators to.",
+    required=True,
+)
+@click.option(
+    "--users-file",
+    help="Path to a YAML file containing a list of users to add to the project.",
+    required=True,
+)
+def add_collaborators(cloud: str, project: str, users_file: str) -> None:
+    collaborators = CreateProjectCollaborators.from_yaml(users_file)
+
+    try:
+        anyscale.project.add_collaborators(
+            cloud=cloud,
+            project=project,
+            collaborators=[
+                CreateProjectCollaborator(**collaborator)
+                for collaborator in collaborators.collaborators
+            ],
+        )
+    except ValueError as e:
+        log.error(f"Error adding collaborators to project: {e}")
+        return
+
+    log.info(
+        f"Successfully added {len(collaborators.collaborators)} collaborators to project {project}."
+    )
+
+
+# ================================================
+# LEGACY CODE
+# ================================================
 
 
 def _validate_project_name(ctx, param, value) -> str:  # noqa: ARG001
@@ -97,6 +445,10 @@ def _default_project_name() -> str:
         "[DEPRECATED] Create a new project or attach this directory to an existing project."
     ),
     hidden=True,
+    cls=DeprecatedAnyscaleCommand,
+    removal_date="2025-10-01",
+    deprecation_message="`anyscale init` has been deprecated",
+    alternative="use `anyscale project create` to create a new project",
 )
 @click.option(
     "--project-id",
@@ -130,10 +482,11 @@ def anyscale_init(
     config: Optional[str],
     requirements: Optional[str],
 ) -> None:
-    log.warning(
-        "`anyscale init` has been deprecated. Please use `anyscale project init` "
-        "to create or attach to a project from this directory."
-    )
+    """Create a new project or attach this directory to an existing project.
+
+    DEPRECATED: This command will be removed on 2025-10-01.
+    Use 'anyscale project create' to create a new project.
+    """
     if (project_id and name) or not (project_id or name):
         raise click.BadArgumentUsage(
             "Only one of project_id and name must be provided."
@@ -147,6 +500,10 @@ def anyscale_init(
     name="init",
     help="[DEPRECATED] Create a new project or attach this directory to an existing project.",
     hidden=True,
+    cls=DeprecatedAnyscaleCommand,
+    removal_date="2025-10-01",
+    deprecation_message="`anyscale project init` has been deprecated",
+    alternative="use `anyscale project create` to create a new project and specify a project id or name for the other Anyscale CLI commands",
 )
 @click.option(
     "--project-id",
@@ -166,11 +523,11 @@ def anyscale_init(
     default=_default_project_name(),
 )
 def init(project_id: Optional[str], name: Optional[str],) -> None:
-    log.warning(
-        "`anyscale project init` has been deprecated and will be removed in "
-        "April 2022. Please use `anyscale project create` to create a new project "
-        "and specify a project id or name for the other Anyscale CLI commands."
-    )
+    """Create a new project or attach this directory to an existing project.
+
+    DEPRECATED: This command will be removed on 2025-10-01.
+    Use 'anyscale project create' to create a new project.
+    """
     if (project_id and name) or not (project_id or name):
         raise click.BadArgumentUsage(
             "Only one of --project-id and --name must be provided."
@@ -178,76 +535,3 @@ def init(project_id: Optional[str], name: Optional[str],) -> None:
 
     project_controller = ProjectController()
     project_controller.init(project_id, name, None, None)
-
-
-@project_cli.command(
-    name="create",
-    help="Create a new project.",
-    cls=LegacyAnyscaleCommand,
-    is_limited_support=True,
-    legacy_prefix="anyscale project",
-)
-@click.option(
-    "--name",
-    "-n",
-    help="Project name.",
-    callback=_validate_project_name,
-    prompt=True,
-    default=_default_project_name(),
-)
-@click.option(
-    "--parent-cloud-id",
-    required=False,
-    default=None,
-    help=(
-        "Cloud id that this project is associated with. This argument "
-        "is only relevant if cloud isolation is enabled."
-    ),
-)
-def create(name: str, parent_cloud_id: str) -> None:
-    project_controller = ProjectController()
-    project_controller.create(name, parent_cloud_id)
-
-
-@project_cli.command(
-    name="add-collaborators",
-    help="Add collaborators to the project.",
-    cls=AnyscaleCommand,
-    example=command_examples.PROJECT_ADD_COLLABORATORS_EXAMPLE,
-)
-@click.option(
-    "--cloud",
-    "-c",
-    help="Name of the cloud that the project belongs to.",
-    required=True,
-)
-@click.option(
-    "--project",
-    "-p",
-    help="Name of the project to add collaborators to.",
-    required=True,
-)
-@click.option(
-    "--users-file",
-    help="Path to a YAML file containing a list of users to add to the project.",
-    required=True,
-)
-def add_collaborators(cloud: str, project: str, users_file: str,) -> None:
-    collaborators = CreateProjectCollaborators.from_yaml(users_file)
-
-    try:
-        anyscale.project.add_collaborators(
-            cloud=cloud,
-            project=project,
-            collaborators=[
-                CreateProjectCollaborator(**collaborator)
-                for collaborator in collaborators.collaborators
-            ],
-        )
-    except ValueError as e:
-        log.error(f"Error adding collaborators to project: {e}")
-        return
-
-    log.info(
-        f"Successfully added {len(collaborators.collaborators)} collaborators to project {project}."
-    )