cloudos-cli 2.81.2__tar.gz → 2.82.0__tar.gz

{cloudos_cli-2.81.2 → cloudos_cli-2.82.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloudos_cli
-Version: 2.81.2
+Version: 2.82.0
 Summary: Python package for interacting with CloudOS
 Home-page: https://github.com/lifebit-ai/cloudos-cli
 Author: David Piñeyro
@@ -365,11 +365,21 @@ Projects in CloudOS provide logical separation of datasets, workflows, and resul
 
 #### List Projects
 
-You can get a summary of all available workspace projects in two different formats:
-- **CSV**: A table with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
-- **JSON**: All available information from projects in JSON format
+You can get a summary of all available workspace projects in three different output formats using the `--output-format` option:
 
-To get a CSV table with all available projects for a given workspace:
+- **stdout** (default): Displays a rich formatted table directly in the terminal with pagination and visual formatting
+- **csv**: Saves project data to a CSV file with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
+- **json**: Saves complete project information to a JSON file with all available fields
+
+To display projects as a formatted table in the terminal:
+
+```bash
+cloudos project list --profile my_profile
+# or explicitly:
+cloudos project list --profile my_profile --output-format stdout
+```
+
+To save projects to a CSV file with all available fields:
 
 ```bash
 cloudos project list --profile my_profile --output-format csv --all-fields
@@ -383,7 +393,7 @@ Executing list...
 	Project list saved to project_list.csv
 ```
 
-To get the same information in JSON format:
+To save the same information in JSON format:
 
 ```bash
 cloudos project list --profile my_profile --output-format json
@@ -406,13 +416,28 @@ The expected output is something similar to:
 
 ### Queue
 
-Job queues are required for running jobs using AWS batch executor. The available job queues in your CloudOS workspace are listed in the "Compute Resources" section in "Settings". You can get a summary of all available workspace job queues in two formats:
-- **CSV**: A table with a selection of the available job queue information. You can get all information using the `--all-fields` flag
-- **JSON**: All available information from job queues in JSON format
+Job queues are required for running jobs using AWS batch executor. The available job queues in your CloudOS workspace are listed in the "Compute Resources" section in "Settings".
+
+> [!NOTE]
+> **Azure Platform**: Queue listing is not available for CloudOS workspaces configured to use Azure execution platform, as Azure does not use AWS batch queues.
 
 #### List Queues
 
-This command allows you to view available computational queues and their configurations. Example command for getting all available job queues in JSON format:
+This command allows you to view available computational queues and their configurations. You can get a summary of all available workspace job queues in three different output formats using the `--output-format` option:
+
+- **stdout** (default): Displays a rich formatted table directly in the terminal with pagination and visual formatting
+- **csv**: Saves queue data to a CSV file with a selection of available queue information, or all information using the `--all-fields` flag
+- **json**: Saves complete queue information to a JSON file with all available fields
+
+To display queues as a formatted table in the terminal:
+
+```bash
+cloudos queue list --profile my_profile
+# or explicitly:
+cloudos queue list --profile my_profile --output-format stdout
+```
+
+To save all available job queues in JSON format:
 
 ```bash
 cloudos queue list --profile my_profile --output-format json --output-basename "available_queues"
@@ -424,7 +449,11 @@ Executing list...
 	Job queue list saved to available_queues.json
 ```
 
-This command will output the list of available job queues in JSON format and save it to a file named `available_queues.json`. You can use `--output-format csv` for a CSV file, or omit `--output-basename` to print to the console.
+To save queue data to a CSV file:
+
+```bash
+cloudos queue list --profile my_profile --output-format csv
+```
 
 > NOTE: The queue name that is visible in CloudOS and must be used with the `--job-queue` parameter is the one in the `label` field.
 
@@ -437,11 +466,21 @@ Platform workflows (those provided by CloudOS in your workspace as modules) run
 
 #### List All Available Workflows
 
-You can get a summary of all available workspace workflows in two different formats:
-- **CSV**: A table with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
-- **JSON**: All available information from workflows in JSON format
+You can get a list of all available workspace workflows in three different output formats using the `--output-format` option:
+
+- **stdout** (default): Displays a rich formatted table directly in the terminal with pagination and visual formatting
+- **csv**: Saves workflow data to a CSV file with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
+- **json**: Saves complete workflow information to a JSON file with all available fields
+
+To display the list of workflows as a formatted table in the terminal:
+
+```bash
+cloudos workflow list --profile my_profile
+# or explicitly:
+cloudos workflow list --profile my_profile --output-format stdout
+```
 
-To get a CSV table with all available workflows for a given workspace:
+To save the list of workflows to a CSV file with all available fields:
 
 ```bash
 cloudos workflow list --profile my_profile --output-format csv --all-fields
@@ -455,7 +494,7 @@ Executing list...
 	Workflow list saved to workflow_list.csv
 ```
 
-To get the same information in JSON format:
+To save the same information in JSON format:
 
 ```bash
 cloudos workflow list --profile my_profile --output-format json

{cloudos_cli-2.81.2 → cloudos_cli-2.82.0}/README.md

@@ -330,11 +330,21 @@ Projects in CloudOS provide logical separation of datasets, workflows, and resul
 
 #### List Projects
 
-You can get a summary of all available workspace projects in two different formats:
-- **CSV**: A table with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
-- **JSON**: All available information from projects in JSON format
+You can get a summary of all available workspace projects in three different output formats using the `--output-format` option:
 
-To get a CSV table with all available projects for a given workspace:
+- **stdout** (default): Displays a rich formatted table directly in the terminal with pagination and visual formatting
+- **csv**: Saves project data to a CSV file with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
+- **json**: Saves complete project information to a JSON file with all available fields
+
+To display projects as a formatted table in the terminal:
+
+```bash
+cloudos project list --profile my_profile
+# or explicitly:
+cloudos project list --profile my_profile --output-format stdout
+```
+
+To save projects to a CSV file with all available fields:
 
 ```bash
 cloudos project list --profile my_profile --output-format csv --all-fields
@@ -348,7 +358,7 @@ Executing list...
 	Project list saved to project_list.csv
 ```
 
-To get the same information in JSON format:
+To save the same information in JSON format:
 
 ```bash
 cloudos project list --profile my_profile --output-format json
@@ -371,13 +381,28 @@ The expected output is something similar to:
 
 ### Queue
 
-Job queues are required for running jobs using AWS batch executor. The available job queues in your CloudOS workspace are listed in the "Compute Resources" section in "Settings". You can get a summary of all available workspace job queues in two formats:
-- **CSV**: A table with a selection of the available job queue information. You can get all information using the `--all-fields` flag
-- **JSON**: All available information from job queues in JSON format
+Job queues are required for running jobs using AWS batch executor. The available job queues in your CloudOS workspace are listed in the "Compute Resources" section in "Settings".
+
+> [!NOTE]
+> **Azure Platform**: Queue listing is not available for CloudOS workspaces configured to use Azure execution platform, as Azure does not use AWS batch queues.
 
 #### List Queues
 
-This command allows you to view available computational queues and their configurations. Example command for getting all available job queues in JSON format:
+This command allows you to view available computational queues and their configurations. You can get a summary of all available workspace job queues in three different output formats using the `--output-format` option:
+
+- **stdout** (default): Displays a rich formatted table directly in the terminal with pagination and visual formatting
+- **csv**: Saves queue data to a CSV file with a selection of available queue information, or all information using the `--all-fields` flag
+- **json**: Saves complete queue information to a JSON file with all available fields
+
+To display queues as a formatted table in the terminal:
+
+```bash
+cloudos queue list --profile my_profile
+# or explicitly:
+cloudos queue list --profile my_profile --output-format stdout
+```
+
+To save all available job queues in JSON format:
 
 ```bash
 cloudos queue list --profile my_profile --output-format json --output-basename "available_queues"
@@ -389,7 +414,11 @@ Executing list...
 	Job queue list saved to available_queues.json
 ```
 
-This command will output the list of available job queues in JSON format and save it to a file named `available_queues.json`. You can use `--output-format csv` for a CSV file, or omit `--output-basename` to print to the console.
+To save queue data to a CSV file:
+
+```bash
+cloudos queue list --profile my_profile --output-format csv
+```
 
 > NOTE: The queue name that is visible in CloudOS and must be used with the `--job-queue` parameter is the one in the `label` field.
 
@@ -402,11 +431,21 @@ Platform workflows (those provided by CloudOS in your workspace as modules) run
 
 #### List All Available Workflows
 
-You can get a summary of all available workspace workflows in two different formats:
-- **CSV**: A table with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
-- **JSON**: All available information from workflows in JSON format
+You can get a list of all available workspace workflows in three different output formats using the `--output-format` option:
+
+- **stdout** (default): Displays a rich formatted table directly in the terminal with pagination and visual formatting
+- **csv**: Saves workflow data to a CSV file with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
+- **json**: Saves complete workflow information to a JSON file with all available fields
+
+To display the list of workflows as a formatted table in the terminal:
+
+```bash
+cloudos workflow list --profile my_profile
+# or explicitly:
+cloudos workflow list --profile my_profile --output-format stdout
+```
 
-To get a CSV table with all available workflows for a given workspace:
+To save the list of workflows to a CSV file with all available fields:
 
 ```bash
 cloudos workflow list --profile my_profile --output-format csv --all-fields
@@ -420,7 +459,7 @@ Executing list...
 	Workflow list saved to workflow_list.csv
 ```
 
-To get the same information in JSON format:
+To save the same information in JSON format:
 
 ```bash
 cloudos workflow list --profile my_profile --output-format json

cloudos_cli-2.82.0/cloudos_cli/_version.py

@@ -0,0 +1 @@
+__version__ = '2.82.0'

{cloudos_cli-2.81.2 → cloudos_cli-2.82.0}/cloudos_cli/projects/cli.py

@@ -7,6 +7,7 @@ from cloudos_cli.clos import Cloudos
 from cloudos_cli.utils.resources import ssl_selector
 from cloudos_cli.configure.configure import with_profile_config, CLOUDOS_URL
 from cloudos_cli.utils.cli_helpers import pass_debug_to_subcommands
+from cloudos_cli.utils.details import create_project_list_table
 
 
 @click.group(cls=pass_debug_to_subcommands())
@@ -34,9 +35,13 @@ def project():
               default='project_list',
               required=False)
 @click.option('--output-format',
-              help='The desired file format (file extension) for the output. Default=csv.',
-              type=click.Choice(['csv', 'json'], case_sensitive=False),
-              default='csv')
+              help=('Output format for project list. Options: '
+                    'stdout (display as interactive table in terminal), '
+                    'csv (save as comma-separated values file), '
+                    'json (save as JSON file with full API response). '
+                    'Default=stdout.'),
+              type=click.Choice(['stdout', 'csv', 'json'], case_sensitive=False),
+              default='stdout')
 @click.option('--all-fields',
               help=('Whether to collect all available fields from projects or ' +
                     'just the preconfigured selected fields. Only applicable ' +
@@ -70,11 +75,12 @@ def list_projects(ctx,
                   disable_ssl_verification,
                   ssl_cert,
                   profile):
-    """Collect all projects from a CloudOS workspace in CSV format."""
+    """Collect and display all projects from a CloudOS workspace."""
     # apikey, cloudos_url, and workspace_id are now automatically resolved by the decorator
 
     verify_ssl = ssl_selector(disable_ssl_verification, ssl_cert)
-    outfile = output_basename + '.' + output_format
+    if output_format != 'stdout':
+        outfile = output_basename + '.' + output_format
     print('Executing list...')
     if verbose:
         print('\t...Preparing objects')
@@ -93,25 +99,32 @@ def list_projects(ctx,
         if not isinstance(page, int) or page < 1:
             raise ValueError('Please, use a positive integer (>= 1) for the --page parameter')
     my_projects_r = cl.get_project_list(workspace_id, verify_ssl, page=page, get_all=get_all)
+    
+    # Print informative message if no projects found
     if len(my_projects_r) == 0:
         if ctx.get_parameter_source('page') == click.core.ParameterSource.DEFAULT:
-            print('A total of 0 projects collected. This is likely because your workspace ' +
+            print('\tA total of 0 projects collected. This is likely because your workspace ' +
                   'has no projects created yet.')
         else:
-            print('A total of 0 projects collected. This is likely because the --page you ' +
+            print('\tA total of 0 projects collected. This is likely because the --page you ' +
                   'requested does not exist. Please, try a smaller number for --page or collect all the ' +
                   'projects by not using --page parameter.')
+    
+    # Generate output files (even if empty, for consistency with automation)
+    if output_format == 'stdout':
+        create_project_list_table(my_projects_r, cloudos_url)
     elif output_format == 'csv':
         my_projects = cl.process_project_list(my_projects_r, all_fields)
         my_projects.to_csv(outfile, index=False)
         print(f'\tProject list collected with a total of {my_projects.shape[0]} projects.')
+        print(f'\tProject list saved to {outfile}')
     elif output_format == 'json':
         with open(outfile, 'w') as o:
             o.write(json.dumps(my_projects_r))
         print(f'\tProject list collected with a total of {len(my_projects_r)} projects.')
+        print(f'\tProject list saved to {outfile}')
     else:
-        raise ValueError('Unrecognised output format. Please use one of [csv|json]')
-    print(f'\tProject list saved to {outfile}')
+        raise ValueError('Unrecognised output format. Please use one of [stdout|csv|json]')
 
 
 @project.command('create')

{cloudos_cli-2.81.2 → cloudos_cli-2.82.0}/cloudos_cli/queue/cli.py

@@ -6,6 +6,7 @@ from cloudos_cli.queue.queue import Queue
 from cloudos_cli.utils.resources import ssl_selector
 from cloudos_cli.configure.configure import with_profile_config, CLOUDOS_URL
 from cloudos_cli.utils.cli_helpers import pass_debug_to_subcommands
+from cloudos_cli.utils.details import create_queue_list_table
 
 
 # Create the queue group
@@ -34,11 +35,15 @@ def queue():
               default='job_queue_list',
               required=False)
 @click.option('--output-format',
-              help='The desired file format (file extension) for the output. Default=csv.',
-              type=click.Choice(['csv', 'json'], case_sensitive=False),
-              default='csv')
+              help=('Output format for queue list. Options: '
+                    'stdout (display as interactive table in terminal), '
+                    'csv (save as comma-separated values file), '
+                    'json (save as JSON file with full API response). '
+                    'Default=stdout.'),
+              type=click.Choice(['stdout', 'csv', 'json'], case_sensitive=False),
+              default='stdout')
 @click.option('--all-fields',
-              help=('Whether to collect all available fields from workflows or ' +
+              help=('Whether to collect all available fields from queues or ' +
                     'just the preconfigured selected fields. Only applicable ' +
                     'when --output-format=csv'),
               is_flag=True)
@@ -61,24 +66,26 @@ def list_queues(ctx,
                 disable_ssl_verification,
                 ssl_cert,
                 profile):
-    """Collect all available job queues from a CloudOS workspace."""
+    """Collect and display all available job queues from a CloudOS workspace."""
     # apikey, cloudos_url, and workspace_id are now automatically resolved by the decorator
 
     verify_ssl = ssl_selector(disable_ssl_verification, ssl_cert)
-    outfile = output_basename + '.' + output_format
     print('Executing list...')
     j_queue = Queue(cloudos_url, apikey, None, workspace_id, verify=verify_ssl)
     my_queues = j_queue.get_job_queues()
     if len(my_queues) == 0:
-        raise ValueError('No AWS batch queues found. Please, make sure that your CloudOS supports AWS bath queues')
-    if output_format == 'csv':
+        raise ValueError('No AWS batch queues found. Please, make sure that your CloudOS supports AWS batch queues')
+    if output_format == 'stdout':
+        create_queue_list_table(my_queues, cloudos_url)
+    elif output_format == 'csv':
+        outfile = output_basename + '.' + output_format
         queues_processed = j_queue.process_queue_list(my_queues, all_fields)
         queues_processed.to_csv(outfile, index=False)
         print(f'\tJob queue list collected with a total of {queues_processed.shape[0]} queues.')
+        print(f'\tJob queue list saved to {outfile}')
     elif output_format == 'json':
+        outfile = output_basename + '.' + output_format
         with open(outfile, 'w') as o:
             o.write(json.dumps(my_queues))
         print(f'\tJob queue list collected with a total of {len(my_queues)} queues.')
-    else:
-        raise ValueError('Unrecognised output format. Please use one of [csv|json]')
-    print(f'\tJob queue list saved to {outfile}')
+        print(f'\tJob queue list saved to {outfile}')

{cloudos_cli-2.81.2 → cloudos_cli-2.82.0}/cloudos_cli/utils/details.py

@@ -4,6 +4,7 @@ from rich.table import Table
 import json
 import csv
 import os
+import sys
 
 
 def get_path(param, param_kind_map, execution_platform, storage_provider, mode="parameters"):
@@ -646,3 +647,376 @@ def create_job_list_table(jobs, cloudos_url, pagination_metadata=None, selected_
         total_pages = (total_jobs + page_size - 1) // page_size if total_jobs > 0 else 1
 
         console.print(f"\n[cyan]Showing {len(jobs)} of {total_jobs} total jobs | Page {current_page} of {total_pages}[/cyan]")
+
+
+def create_workflow_list_table(workflows, cloudos_url="https://cloudos.lifebit.ai", page_size=10):
+    """Display workflows in a rich formatted table with pagination.
+
+    Parameters
+    ----------
+    workflows : list
+        A list of dicts, each corresponding to a workflow.
+    cloudos_url : str
+        The CloudOS URL for creating hyperlinks.
+    page_size : int
+        Number of workflows to display per page. Default is 10.
+    """
+    console = Console()
+
+    # Handle empty workflow list
+    if len(workflows) == 0:
+        console.print("\n[yellow]No workflows found in this workspace.[/yellow]")
+        return
+
+    # Prepare rows data
+    rows = []
+    for workflow in workflows:
+        # Get workflow ID for the hyperlink
+        workflow_id = str(workflow.get("_id", "N/A"))
+        workflow_url = f"{cloudos_url}/app/advanced-analytics/pipelines-and-tools/workspace/{workflow_id}"
+        
+        # Name with hyperlink
+        name = str(workflow.get("name", "N/A"))
+        name_with_link = f"[link={workflow_url}]{name}[/link]"
+
+        # Archived status
+        # archived_status = workflow.get("archived", {})
+        # if isinstance(archived_status, dict):
+        #     archived = str(archived_status.get("status", "N/A"))
+        # else:
+        #     archived = str(archived_status)
+
+        # Repository name
+        repository = workflow.get("repository", {})
+        repo_name = str(repository.get("name", "N/A"))
+        repo_url = str(repository.get("url", "N/A"))
+        
+        # Create hyperlink for repository name if URL is available
+        if repo_url != "N/A" and repo_url:
+            repo_name_with_link = f"[link={repo_url}]{repo_name}[/link]"
+        else:
+            repo_name_with_link = repo_name
+
+        # Repository platform
+        #repo_platform = str(repository.get("platform", "N/A"))
+
+        # Repository URL
+        #repo_url = str(repository.get("url", "N/A"))
+
+        # Is private
+        # is_private = str(repository.get("isPrivate", "N/A"))
+
+        rows.append([
+            name_with_link,
+            #archived,
+            repo_name_with_link,
+            #repo_platform,
+            #repo_url,
+            #is_private
+        ])
+
+    # Pagination
+    current_page = 0
+    total_pages = (len(rows) + page_size - 1) // page_size if len(rows) > 0 else 1
+    show_error = None  # Track error messages to display
+
+    while True:
+        start = current_page * page_size
+        end = start + page_size
+
+        # Clear console first
+        console.clear()
+
+        # Create and display table
+        table = Table(title="Workflow List")
+
+        # Add columns
+        table.add_column("Name", style="green", overflow="fold")
+        #table.add_column("Archived", style="yellow", no_wrap=True)
+        table.add_column("Repository", style="cyan", overflow="fold")
+        #table.add_column("Platform", style="green", no_wrap=True)
+        #table.add_column("Repository URL", style="blue", overflow="fold")
+        #table.add_column("Private", style="red", no_wrap=True)
+
+        # Get rows for current page
+        page_rows = rows[start:end]
+
+        # Add rows to table
+        for row in page_rows:
+            table.add_row(*row)
+
+        # Print table
+        console.print(table)
+
+        # Display total count and page info
+        console.print(f"\n[cyan]Total workflows:[/cyan] {len(workflows)}")
+        if total_pages > 1:
+            console.print(f"[cyan]Page:[/cyan] {current_page + 1} of {total_pages}")
+            console.print(f"[cyan]Workflows on this page:[/cyan] {len(page_rows)}")
+
+        # Show error message if any
+        if show_error:
+            console.print(show_error)
+            show_error = None  # Reset error after displaying
+
+        # Show pagination controls
+        if total_pages > 1:
+            # Check if we're in an interactive environment
+            if not sys.stdin.isatty():
+                console.print("\n[yellow]Note: Pagination not available in non-interactive mode. Showing page 1 of {0}.[/yellow]".format(total_pages))
+                console.print("[yellow]Run in an interactive terminal to navigate through all pages.[/yellow]")
+                break
+            
+            console.print(f"\n[bold cyan]n[/] = next, [bold cyan]p[/] = prev, [bold cyan]q[/] = quit")
+
+            # Get user input for navigation
+            try:
+                choice = input(">>> ").strip().lower()
+            except (EOFError, KeyboardInterrupt):
+                # Handle non-interactive environments or user interrupt
+                console.print("\n[yellow]Pagination interrupted.[/yellow]")
+                break
+
+            if choice in ("q", "quit"):
+                break
+            elif choice in ("n", "next"):
+                if current_page < total_pages - 1:
+                    current_page += 1
+                else:
+                    show_error = "[red]Invalid choice. Already on the last page.[/red]"
+            elif choice in ("p", "prev"):
+                if current_page > 0:
+                    current_page -= 1
+                else:
+                    show_error = "[red]Invalid choice. Already on the first page.[/red]"
+            else:
+                show_error = "[red]Invalid choice. Please enter 'n' (next), 'p' (prev), or 'q' (quit).[/red]"
+        else:
+            # Only one page, no need for input, just exit
+            break
+
+
+def create_queue_list_table(queues, cloudos_url="https://cloudos.lifebit.ai"):
+    """Display job queues in a rich formatted table.
+
+    Parameters
+    ----------
+    queues : list
+        A list of dicts, each corresponding to a job queue.
+    cloudos_url : str
+        The CloudOS URL for context (currently not used for hyperlinks).
+
+    Returns
+    -------
+    None
+        Prints the formatted table to console.
+    """
+    console = Console()
+
+    # Handle empty queue list
+    if len(queues) == 0:
+        console.print("\n[yellow]No job queues found in this workspace.[/yellow]")
+        return
+
+    # Create table
+    table = Table(title="Job Queue List")
+
+    # Add columns
+    table.add_column("Label", style="green", overflow="fold", min_width=10)
+    table.add_column("Default", style="cyan", no_wrap=True, min_width=7, justify="center")
+    table.add_column("Resource Type", style="magenta", overflow="fold", min_width=12)
+    table.add_column("Status", style="yellow", no_wrap=True, min_width=8, justify="center")
+
+    # Process each queue
+    for queue in queues:
+        # Label
+        label = str(queue.get("label", "N/A"))
+
+        # Default (show as checkmark or dash)
+        is_default = queue.get("isDefault", False)
+        if is_default:
+            default_display = "[bold green]Default[/bold green]"
+        else:
+            default_display = "[dim]—[/dim]"
+
+        # Resource Type
+        resource_type = str(queue.get("resourceType", "N/A"))
+        if not resource_type or resource_type == "":
+            resource_type = "N/A"
+        elif resource_type == "teamBatchJobQueue":
+            resource_type = "Batch Queues"
+
+        # Status with checkmark/X icons
+        status_raw = str(queue.get("status", "N/A"))
+        if status_raw.lower() == "ready":
+            status = "[bold green]Ready[/bold green]"
+        else:
+            status = "[bold red]Not Ready[/bold red]"
+
+        # Add row
+        table.add_row(label, default_display, resource_type, status)
+
+    # Print table
+    console.print(table)
+
+    # Display total count
+    console.print(f"\n[cyan]Total job queues:[/cyan] {len(queues)}")
+
+
+def create_project_list_table(projects, cloudos_url="https://cloudos.lifebit.ai", page_size=10):
+    """Display projects in a rich formatted table with pagination.
+
+    Parameters
+    ----------
+    projects : list
+        A list of dicts, each corresponding to a project.
+    cloudos_url : str
+        The CloudOS URL for creating hyperlinks.
+    page_size : int
+        Number of projects to display per page. Default is 10.
+    """
+    console = Console()
+
+    # Handle empty project list
+    if len(projects) == 0:
+        console.print("\n[yellow]No projects found in this workspace.[/yellow]")
+        return
+
+    # Prepare rows data
+    rows = []
+    for project in projects:
+        # Name with hyperlink
+        project_id = str(project.get("_id", "N/A"))
+        project_url = f"{cloudos_url}/app/data-science/datasets/projects/{project_id}"
+        name = str(project.get("name", "N/A"))
+        name_with_link = f"[link={project_url}]{name}[/link]"
+
+        # User (combine name and surname)
+        user_info = project.get("user", {})
+        user_name = user_info.get("name", "")
+        user_surname = user_info.get("surname", "")
+        if user_name and user_surname:
+            user = f"{user_name} {user_surname}"
+        elif user_name:
+            user = user_name
+        elif user_surname:
+            user = user_surname
+        else:
+            user = "N/A"
+
+        # Created date (format: yyyy.mm.dd)
+        created_at = project.get("createdAt")
+        if created_at:
+            try:
+                created_dt = datetime.fromisoformat(str(created_at).replace('Z', '+00:00'))
+                created = created_dt.strftime('%Y.%m.%d')
+            except (ValueError, TypeError):
+                created = "N/A"
+        else:
+            created = "N/A"
+
+        # Updated date (format: yyyy.mm.dd)
+        updated_at = project.get("updatedAt")
+        if updated_at:
+            try:
+                updated_dt = datetime.fromisoformat(str(updated_at).replace('Z', '+00:00'))
+                updated = updated_dt.strftime('%Y.%m.%d')
+            except (ValueError, TypeError):
+                updated = "N/A"
+        else:
+            updated = "N/A"
+
+        # Job count
+        job_count = str(project.get("jobCount", 0))
+
+        # Notebook session count
+        notebook_count = str(project.get("notebookSessionCount", 0))
+
+        rows.append([
+            name_with_link,
+            user,
+            created,
+            updated,
+            job_count,
+            notebook_count
+        ])
+
+    # Pagination
+    current_page = 0
+    total_pages = (len(rows) + page_size - 1) // page_size if len(rows) > 0 else 1
+    show_error = None  # Track error messages to display
+
+    while True:
+        start = current_page * page_size
+        end = start + page_size
+
+        # Clear console first
+        console.clear()
+
+        # Create and display table
+        table = Table(title="Project List")
+
+        # Add columns
+        table.add_column("Name", style="green", overflow="fold", min_width=15)
+        table.add_column("User", style="cyan", overflow="ellipsis", min_width=12, max_width=20)
+        table.add_column("Created", style="magenta", no_wrap=True, min_width=10)
+        table.add_column("Updated", style="blue", no_wrap=True, min_width=10)
+        table.add_column("Jobs", style="yellow", no_wrap=True, min_width=4, justify="right")
+        table.add_column("Notebooks", style="white", no_wrap=True, min_width=9, justify="right")
+
+        # Get rows for current page
+        page_rows = rows[start:end]
+
+        # Add rows to table
+        for row in page_rows:
+            table.add_row(*row)
+
+        # Print table
+        console.print(table)
+
+        # Display total count and page info
+        console.print(f"\n[cyan]Total projects:[/cyan] {len(projects)}")
+        if total_pages > 1:
+            console.print(f"[cyan]Page:[/cyan] {current_page + 1} of {total_pages}")
+            console.print(f"[cyan]Projects on this page:[/cyan] {len(page_rows)}")
+
+        # Show error message if any
+        if show_error:
+            console.print(show_error)
+            show_error = None  # Reset error after displaying
+
+        # Show pagination controls
+        if total_pages > 1:
+            # Check if we're in an interactive environment
+            if not sys.stdin.isatty():
+                console.print("\n[yellow]Note: Pagination not available in non-interactive mode. Showing page 1 of {0}.[/yellow]".format(total_pages))
+                console.print("[yellow]Run in an interactive terminal to navigate through all pages.[/yellow]")
+                break
+            
+            console.print(f"\n[bold cyan]n[/] = next, [bold cyan]p[/] = prev, [bold cyan]q[/] = quit")
+
+            # Get user input for navigation
+            try:
+                choice = input(">>> ").strip().lower()
+            except (EOFError, KeyboardInterrupt):
+                # Handle non-interactive environments or user interrupt
+                console.print("\n[yellow]Pagination interrupted.[/yellow]")
+                break
+
+            if choice in ("q", "quit"):
+                break
+            elif choice in ("n", "next"):
+                if current_page < total_pages - 1:
+                    current_page += 1
+                else:
+                    show_error = "[red]Invalid choice. Already on the last page.[/red]"
+            elif choice in ("p", "prev"):
+                if current_page > 0:
+                    current_page -= 1
+                else:
+                    show_error = "[red]Invalid choice. Already on the first page.[/red]"
+            else:
+                show_error = "[red]Invalid choice. Please enter 'n' (next), 'p' (prev), or 'q' (quit).[/red]"
+        else:
+            # Only one page, no need for input, just exit
+            break

{cloudos_cli-2.81.2 → cloudos_cli-2.82.0}/cloudos_cli/workflows/cli.py

@@ -7,6 +7,7 @@ from cloudos_cli.import_wf.import_wf import ImportWorflow
 from cloudos_cli.utils.resources import ssl_selector
 from cloudos_cli.configure.configure import with_profile_config, CLOUDOS_URL
 from cloudos_cli.utils.cli_helpers import pass_debug_to_subcommands
+from cloudos_cli.utils.details import create_workflow_list_table
 
 
 # Create the workflow group
@@ -35,9 +36,13 @@ def workflow():
               default='workflow_list',
               required=False)
 @click.option('--output-format',
-              help='The desired file format (file extension) for the output. Default=csv.',
-              type=click.Choice(['csv', 'json'], case_sensitive=False),
-              default='csv')
+              help=('Output format for workflow list. Options: '
+                    'stdout (display as interactive table in terminal), '
+                    'csv (save as comma-separated values file), '
+                    'json (save as JSON file with full API response). '
+                    'Default=stdout.'),
+              type=click.Choice(['stdout', 'csv', 'json'], case_sensitive=False),
+              default='stdout')
 @click.option('--all-fields',
               help=('Whether to collect all available fields from workflows or ' +
                     'just the preconfigured selected fields. Only applicable ' +
@@ -66,11 +71,13 @@ def list_workflows(ctx,
                    disable_ssl_verification,
                    ssl_cert,
                    profile):
-    """Collect all workflows from a CloudOS workspace in CSV format."""
+    """Collect and display workflows from a CloudOS workspace."""
     # apikey, cloudos_url, and workspace_id are now automatically resolved by the decorator
 
     verify_ssl = ssl_selector(disable_ssl_verification, ssl_cert)
-    outfile = output_basename + '.' + output_format
+    # Only set outfile if not using stdout
+    if output_format != 'stdout':
+        outfile = output_basename + '.' + output_format
     print('Executing list...')
     if verbose:
         print('\t...Preparing objects')
@@ -81,17 +88,22 @@ def list_workflows(ctx,
         print('\tSearching for workflows in the following workspace: ' +
               f'{workspace_id}')
     my_workflows_r = cl.get_workflow_list(workspace_id, verify=verify_ssl)
-    if output_format == 'csv':
+    
+    if output_format == 'stdout':
+        # Display as table with pagination
+        create_workflow_list_table(my_workflows_r, cloudos_url)
+    elif output_format == 'csv':
         my_workflows = cl.process_workflow_list(my_workflows_r, all_fields)
         my_workflows.to_csv(outfile, index=False)
         print(f'\tWorkflow list collected with a total of {my_workflows.shape[0]} workflows.')
+        print(f'\tWorkflow list saved to {outfile}')
     elif output_format == 'json':
         with open(outfile, 'w') as o:
             o.write(json.dumps(my_workflows_r))
         print(f'\tWorkflow list collected with a total of {len(my_workflows_r)} workflows.')
+        print(f'\tWorkflow list saved to {outfile}')
     else:
-        raise ValueError('Unrecognised output format. Please use one of [csv|json]')
-    print(f'\tWorkflow list saved to {outfile}')
+        raise ValueError('Unrecognised output format. Please use one of [stdout|csv|json]')
 
 
 @workflow.command('import')

{cloudos_cli-2.81.2 → cloudos_cli-2.82.0}/cloudos_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloudos_cli
-Version: 2.81.2
+Version: 2.82.0
 Summary: Python package for interacting with CloudOS
 Home-page: https://github.com/lifebit-ai/cloudos-cli
 Author: David Piñeyro
@@ -365,11 +365,21 @@ Projects in CloudOS provide logical separation of datasets, workflows, and resul
 
 #### List Projects
 
-You can get a summary of all available workspace projects in two different formats:
-- **CSV**: A table with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
-- **JSON**: All available information from projects in JSON format
+You can get a summary of all available workspace projects in three different output formats using the `--output-format` option:
 
-To get a CSV table with all available projects for a given workspace:
+- **stdout** (default): Displays a rich formatted table directly in the terminal with pagination and visual formatting
+- **csv**: Saves project data to a CSV file with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
+- **json**: Saves complete project information to a JSON file with all available fields
+
+To display projects as a formatted table in the terminal:
+
+```bash
+cloudos project list --profile my_profile
+# or explicitly:
+cloudos project list --profile my_profile --output-format stdout
+```
+
+To save projects to a CSV file with all available fields:
 
 ```bash
 cloudos project list --profile my_profile --output-format csv --all-fields
@@ -383,7 +393,7 @@ Executing list...
 	Project list saved to project_list.csv
 ```
 
-To get the same information in JSON format:
+To save the same information in JSON format:
 
 ```bash
 cloudos project list --profile my_profile --output-format json
@@ -406,13 +416,28 @@ The expected output is something similar to:
 
 ### Queue
 
-Job queues are required for running jobs using AWS batch executor. The available job queues in your CloudOS workspace are listed in the "Compute Resources" section in "Settings". You can get a summary of all available workspace job queues in two formats:
-- **CSV**: A table with a selection of the available job queue information. You can get all information using the `--all-fields` flag
-- **JSON**: All available information from job queues in JSON format
+Job queues are required for running jobs using AWS batch executor. The available job queues in your CloudOS workspace are listed in the "Compute Resources" section in "Settings".
+
+> [!NOTE]
+> **Azure Platform**: Queue listing is not available for CloudOS workspaces configured to use Azure execution platform, as Azure does not use AWS batch queues.
 
 #### List Queues
 
-This command allows you to view available computational queues and their configurations. Example command for getting all available job queues in JSON format:
+This command allows you to view available computational queues and their configurations. You can get a summary of all available workspace job queues in three different output formats using the `--output-format` option:
+
+- **stdout** (default): Displays a rich formatted table directly in the terminal with pagination and visual formatting
+- **csv**: Saves queue data to a CSV file with a selection of available queue information, or all information using the `--all-fields` flag
+- **json**: Saves complete queue information to a JSON file with all available fields
+
+To display queues as a formatted table in the terminal:
+
+```bash
+cloudos queue list --profile my_profile
+# or explicitly:
+cloudos queue list --profile my_profile --output-format stdout
+```
+
+To save all available job queues in JSON format:
 
 ```bash
 cloudos queue list --profile my_profile --output-format json --output-basename "available_queues"
@@ -424,7 +449,11 @@ Executing list...
 	Job queue list saved to available_queues.json
 ```
 
-This command will output the list of available job queues in JSON format and save it to a file named `available_queues.json`. You can use `--output-format csv` for a CSV file, or omit `--output-basename` to print to the console.
+To save queue data to a CSV file:
+
+```bash
+cloudos queue list --profile my_profile --output-format csv
+```
 
 > NOTE: The queue name that is visible in CloudOS and must be used with the `--job-queue` parameter is the one in the `label` field.
 
@@ -437,11 +466,21 @@ Platform workflows (those provided by CloudOS in your workspace as modules) run
 
 #### List All Available Workflows
 
-You can get a summary of all available workspace workflows in two different formats:
-- **CSV**: A table with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
-- **JSON**: All available information from workflows in JSON format
+You can get a list of all available workspace workflows in three different output formats using the `--output-format` option:
+
+- **stdout** (default): Displays a rich formatted table directly in the terminal with pagination and visual formatting
+- **csv**: Saves workflow data to a CSV file with a minimum predefined set of columns by default, or all available columns using the `--all-fields` parameter
+- **json**: Saves complete workflow information to a JSON file with all available fields
+
+To display the list of workflows as a formatted table in the terminal:
+
+```bash
+cloudos workflow list --profile my_profile
+# or explicitly:
+cloudos workflow list --profile my_profile --output-format stdout
+```
 
-To get a CSV table with all available workflows for a given workspace:
+To save the list of workflows to a CSV file with all available fields:
 
 ```bash
 cloudos workflow list --profile my_profile --output-format csv --all-fields
@@ -455,7 +494,7 @@ Executing list...
 	Workflow list saved to workflow_list.csv
 ```
 
-To get the same information in JSON format:
+To save the same information in JSON format:
 
 ```bash
 cloudos workflow list --profile my_profile --output-format json

cloudos_cli-2.81.2/cloudos_cli/_version.py

@@ -1 +0,0 @@
-__version__ = '2.81.2'