Function menu_list

unity_cli/cli/commands/menu.py:60–101

List Unity menu-bar entries (built-in + custom [MenuItem]). Useful for discovering which paths 'u menu exec' can invoke. Examples: u menu list # All menu items u menu list -f Tools # Items containing 'Tools' u menu list -f "Windo

(
    ctx: typer.Context,
    filter_text: Annotated[
        str | None,
        typer.Option("--filter", "-f", help="Filter menu items (case-insensitive)"),
    ] = None,
    limit: Annotated[
        int,
        typer.Option("--limit", "-l", help="Maximum items to return"),
    ] = 100,
    json_flag: Annotated[
        bool,
        typer.Option("--json", help="Output as JSON"),
    ] = False,
)

@menu_app.command("list")
def menu_list(
    ctx: typer.Context,
    filter_text: Annotated[
        str | None,
        typer.Option("--filter", "-f", help="Filter menu items (case-insensitive)"),
    ] = None,
    limit: Annotated[
        int,
        typer.Option("--limit", "-l", help="Maximum items to return"),
    ] = 100,
    json_flag: Annotated[
        bool,
        typer.Option("--json", help="Output as JSON"),
    ] = False,
) -> None:
    """List Unity menu-bar entries (built-in + custom [MenuItem]).

    Useful for discovering which paths 'u menu exec' can invoke.

    Examples:
        u menu list                        # All menu items
        u menu list -f Tools               # Items containing 'Tools'
        u menu list -f "Window/Analysis"   # Narrow to a submenu
    """
    context: CLIContext = ctx.obj
    try:
        result = context.client.menu.list(filter_text=filter_text, limit=limit)
        if _should_json(context, json_flag):
            print_json(result)
        else:
            items = result.get("items", [])
            if is_no_color():
                for item in items:
                    path = item.get("path", str(item)) if isinstance(item, dict) else str(item)
                    print_plain_item(path)
            else:
                print_line(f"[bold]Menu Items ({len(items)})[/bold]")
                for item in items:
                    path = item.get("path", str(item)) if isinstance(item, dict) else str(item)
                    print_line(f"  {escape(path)}")
    except UnityCLIError as e:
        _handle_error(e)


@menu_app.command("context")