Module codeflare_sdk.utils.pretty_print
This sub-module exists primarily to be used internally by the Cluster object (in the cluster sub-module) for pretty-printing cluster status and details.
Expand source code
# Copyright 2022 IBM, Red Hat
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""
This sub-module exists primarily to be used internally by the Cluster object
(in the cluster sub-module) for pretty-printing cluster status and details.
"""
from rich import print
from rich.table import Table
from rich.console import Console
from rich.layout import Layout
from rich.panel import Panel
from rich import box
from typing import List
from ..cluster.model import RayCluster, AppWrapper, RayClusterStatus
def print_no_resources_found():
console = Console()
console.print(Panel("[red]No resources found, have you run cluster.up() yet?"))
def print_app_wrappers_status(app_wrappers: List[AppWrapper], starting: bool = False):
if not app_wrappers:
print_no_resources_found()
return # shortcircuit
console = Console()
table = Table(
box=box.ASCII_DOUBLE_HEAD,
title="[bold] :rocket: Cluster Queue Status :rocket:",
)
table.add_column("Name", style="cyan", no_wrap=True)
table.add_column("Status", style="magenta")
for app_wrapper in app_wrappers:
name = app_wrapper.name
status = app_wrapper.status.value
if starting:
status += " (starting)"
table.add_row(name, status)
table.add_row("") # empty row for spacing
console.print(Panel.fit(table))
def print_ray_clusters_status(app_wrappers: List[AppWrapper], starting: bool = False):
if not app_wrappers:
print_no_resources_found()
return # shortcircuit
console = Console()
table = Table(
box=box.ASCII_DOUBLE_HEAD,
title="[bold] :rocket: Cluster Queue Status :rocket:",
)
table.add_column("Name", style="cyan", no_wrap=True)
table.add_column("Status", style="magenta")
for app_wrapper in app_wrappers:
name = app_wrapper.name
status = app_wrapper.status.value
if starting:
status += " (starting)"
table.add_row(name, status)
table.add_row("") # empty row for spacing
console.print(Panel.fit(table))
def print_cluster_status(cluster: RayCluster):
"Pretty prints the status of a passed-in cluster"
if not cluster:
print_no_resources_found()
return
console = Console()
status = (
"Active :white_heavy_check_mark:"
if cluster.status == RayClusterStatus.READY
else "Inactive :x:"
)
name = cluster.name
dashboard = cluster.dashboard
#'table0' to display the cluster name, status, url, and dashboard link
table0 = Table(box=None, show_header=False)
table0.add_row("[white on green][bold]Name")
table0.add_row("[bold underline]" + name, status)
table0.add_row()
# fixme harcded to default for now
table0.add_row(
f"[bold]URI:[/bold] ray://{cluster.name}-head-svc.{cluster.namespace}.svc:10001"
) # format that is used to generate the name of the service
table0.add_row()
table0.add_row(f"[link={dashboard} blue underline]Dashboard:link:[/link]")
table0.add_row("") # empty row for spacing
# table4 to display table0 and table3, one below the other
table4 = Table(box=None, show_header=False)
table4.add_row(table0)
# Encompass all details of the cluster in a single panel
table5 = Table(box=None, title="[bold] :rocket: CodeFlare Cluster Status :rocket:")
table5.add_row(Panel.fit(table4))
console.print(table5)
def print_clusters(clusters: List[RayCluster]):
if not clusters:
print_no_resources_found()
return # shortcircuit
console = Console()
title_printed = False
for cluster in clusters:
status = (
"Active :white_heavy_check_mark:"
if cluster.status == RayClusterStatus.READY
else "Inactive :x:"
)
name = cluster.name
dashboard = cluster.dashboard
workers = str(cluster.workers)
memory = f"{cluster.worker_mem_min}~{cluster.worker_mem_max}"
cpu = str(cluster.worker_cpu)
gpu = str(cluster.worker_extended_resources.get("nvidia.com/gpu", 0))
#'table0' to display the cluster name, status, url, and dashboard link
table0 = Table(box=None, show_header=False)
table0.add_row("[white on green][bold]Name")
table0.add_row("[bold underline]" + name, status)
table0.add_row()
# fixme harcded to default for now
table0.add_row(
f"[bold]URI:[/bold] ray://{cluster.name}-head-svc.{cluster.namespace}.svc:10001"
) # format that is used to generate the name of the service
table0.add_row()
table0.add_row(f"[link={dashboard} blue underline]Dashboard:link:[/link]")
table0.add_row("") # empty row for spacing
#'table1' to display the worker counts
table1 = Table(box=None)
table1.add_row()
table1.add_column("# Workers", style="magenta")
table1.add_row()
table1.add_row(workers)
table1.add_row()
#'table2' to display the worker resources
table2 = Table(box=None)
table2.add_column("Memory", style="cyan", no_wrap=True, min_width=10)
table2.add_column("CPU", style="magenta", min_width=10)
table2.add_column("GPU", style="magenta", min_width=10)
table2.add_row()
table2.add_row(memory, cpu, gpu)
table2.add_row()
# panels to encompass table1 and table2 into separate cards
panel_1 = Panel.fit(table1, title="Workers")
panel_2 = Panel.fit(table2, title="Worker specs(each)")
# table3 to display panel_1 and panel_2 side-by-side in a single row
table3 = Table(box=None, show_header=False, title="Cluster Resources")
table3.add_row(panel_1, panel_2)
# table4 to display table0 and table3, one below the other
table4 = Table(box=None, show_header=False)
table4.add_row(table0)
table4.add_row(table3)
# Encompass all details of the cluster in a single panel
if not title_printed:
# If first cluster in the list, then create a table with title "Codeflare clusters".
# This is done to ensure the title is center aligned on the cluster display tables, rather
# than being center aligned on the console/terminal if we simply use console.print(title)
table5 = Table(
box=None, title="[bold] :rocket: CodeFlare Cluster Details :rocket:"
)
table5.add_row(Panel.fit(table4))
console.print(table5)
title_printed = True
else:
console.print(Panel.fit(table4))
Functions
def print_app_wrappers_status(app_wrappers: List[AppWrapper], starting: bool = False)-
Expand source code
def print_app_wrappers_status(app_wrappers: List[AppWrapper], starting: bool = False): if not app_wrappers: print_no_resources_found() return # shortcircuit console = Console() table = Table( box=box.ASCII_DOUBLE_HEAD, title="[bold] :rocket: Cluster Queue Status :rocket:", ) table.add_column("Name", style="cyan", no_wrap=True) table.add_column("Status", style="magenta") for app_wrapper in app_wrappers: name = app_wrapper.name status = app_wrapper.status.value if starting: status += " (starting)" table.add_row(name, status) table.add_row("") # empty row for spacing console.print(Panel.fit(table)) def print_cluster_status(cluster: RayCluster)-
Pretty prints the status of a passed-in cluster
Expand source code
def print_cluster_status(cluster: RayCluster): "Pretty prints the status of a passed-in cluster" if not cluster: print_no_resources_found() return console = Console() status = ( "Active :white_heavy_check_mark:" if cluster.status == RayClusterStatus.READY else "Inactive :x:" ) name = cluster.name dashboard = cluster.dashboard #'table0' to display the cluster name, status, url, and dashboard link table0 = Table(box=None, show_header=False) table0.add_row("[white on green][bold]Name") table0.add_row("[bold underline]" + name, status) table0.add_row() # fixme harcded to default for now table0.add_row( f"[bold]URI:[/bold] ray://{cluster.name}-head-svc.{cluster.namespace}.svc:10001" ) # format that is used to generate the name of the service table0.add_row() table0.add_row(f"[link={dashboard} blue underline]Dashboard:link:[/link]") table0.add_row("") # empty row for spacing # table4 to display table0 and table3, one below the other table4 = Table(box=None, show_header=False) table4.add_row(table0) # Encompass all details of the cluster in a single panel table5 = Table(box=None, title="[bold] :rocket: CodeFlare Cluster Status :rocket:") table5.add_row(Panel.fit(table4)) console.print(table5) def print_clusters(clusters: List[RayCluster])-
Expand source code
def print_clusters(clusters: List[RayCluster]): if not clusters: print_no_resources_found() return # shortcircuit console = Console() title_printed = False for cluster in clusters: status = ( "Active :white_heavy_check_mark:" if cluster.status == RayClusterStatus.READY else "Inactive :x:" ) name = cluster.name dashboard = cluster.dashboard workers = str(cluster.workers) memory = f"{cluster.worker_mem_min}~{cluster.worker_mem_max}" cpu = str(cluster.worker_cpu) gpu = str(cluster.worker_extended_resources.get("nvidia.com/gpu", 0)) #'table0' to display the cluster name, status, url, and dashboard link table0 = Table(box=None, show_header=False) table0.add_row("[white on green][bold]Name") table0.add_row("[bold underline]" + name, status) table0.add_row() # fixme harcded to default for now table0.add_row( f"[bold]URI:[/bold] ray://{cluster.name}-head-svc.{cluster.namespace}.svc:10001" ) # format that is used to generate the name of the service table0.add_row() table0.add_row(f"[link={dashboard} blue underline]Dashboard:link:[/link]") table0.add_row("") # empty row for spacing #'table1' to display the worker counts table1 = Table(box=None) table1.add_row() table1.add_column("# Workers", style="magenta") table1.add_row() table1.add_row(workers) table1.add_row() #'table2' to display the worker resources table2 = Table(box=None) table2.add_column("Memory", style="cyan", no_wrap=True, min_width=10) table2.add_column("CPU", style="magenta", min_width=10) table2.add_column("GPU", style="magenta", min_width=10) table2.add_row() table2.add_row(memory, cpu, gpu) table2.add_row() # panels to encompass table1 and table2 into separate cards panel_1 = Panel.fit(table1, title="Workers") panel_2 = Panel.fit(table2, title="Worker specs(each)") # table3 to display panel_1 and panel_2 side-by-side in a single row table3 = Table(box=None, show_header=False, title="Cluster Resources") table3.add_row(panel_1, panel_2) # table4 to display table0 and table3, one below the other table4 = Table(box=None, show_header=False) table4.add_row(table0) table4.add_row(table3) # Encompass all details of the cluster in a single panel if not title_printed: # If first cluster in the list, then create a table with title "Codeflare clusters". # This is done to ensure the title is center aligned on the cluster display tables, rather # than being center aligned on the console/terminal if we simply use console.print(title) table5 = Table( box=None, title="[bold] :rocket: CodeFlare Cluster Details :rocket:" ) table5.add_row(Panel.fit(table4)) console.print(table5) title_printed = True else: console.print(Panel.fit(table4)) def print_no_resources_found()-
Expand source code
def print_no_resources_found(): console = Console() console.print(Panel("[red]No resources found, have you run cluster.up() yet?")) def print_ray_clusters_status(app_wrappers: List[AppWrapper], starting: bool = False)-
Expand source code
def print_ray_clusters_status(app_wrappers: List[AppWrapper], starting: bool = False): if not app_wrappers: print_no_resources_found() return # shortcircuit console = Console() table = Table( box=box.ASCII_DOUBLE_HEAD, title="[bold] :rocket: Cluster Queue Status :rocket:", ) table.add_column("Name", style="cyan", no_wrap=True) table.add_column("Status", style="magenta") for app_wrapper in app_wrappers: name = app_wrapper.name status = app_wrapper.status.value if starting: status += " (starting)" table.add_row(name, status) table.add_row("") # empty row for spacing console.print(Panel.fit(table))