divbase-cli 0.1.0.dev3__py3-none-any.whl → 0.1.0.dev5__py3-none-any.whl

divbase_cli/cli_commands/file_cli.py

@@ -1,8 +1,5 @@
 """
 Command line interface for managing files in a DivBase project's store on DivBase.
-
-TODO - Download all files option.
-TODO - skip checked option (aka skip files that already exist in same local dir with correct checksum).
 """
 
 from pathlib import Path
@@ -16,22 +13,57 @@ from typing_extensions import Annotated
 from divbase_cli.cli_commands.shared_args_options import FORMAT_AS_TSV_OPTION, PROJECT_NAME_OPTION
 from divbase_cli.cli_exceptions import UnsupportedFileNameError, UnsupportedFileTypeError
 from divbase_cli.config_resolver import ensure_logged_in, resolve_download_dir, resolve_project
+from divbase_cli.services.project_versions import get_version_details_command
 from divbase_cli.services.s3_files import (
+    ToDownload,
     download_files_command,
+    filter_out_already_downloaded_files,
     get_file_info_command,
     list_files_command,
+    list_soft_deleted_files_command,
     restore_objects_command,
     soft_delete_objects_command,
     stream_file_command,
     upload_files_command,
 )
-from divbase_cli.utils import format_file_size, print_rich_table_as_tsv
+from divbase_cli.utils import print_rich_table_as_tsv
 from divbase_lib.divbase_constants import SUPPORTED_DIVBASE_FILE_TYPES, UNSUPPORTED_CHARACTERS_IN_FILENAMES
+from divbase_lib.utils import format_file_size
 
 file_app = typer.Typer(no_args_is_help=True, help="Download/upload/list files to/from the project's store on DivBase.")
 
 NO_FILES_SPECIFIED_MSG = "No files specified for the command, exiting..."
 
+DOWNLOAD_DIR_OPTION = typer.Option(
+    None,
+    "--download-dir",
+    "-d",
+    help="""Directory to download the files to. 
+        If not provided, defaults to what you specified in your user config. 
+        If also not specified in your user config, downloads to the current directory.
+        You can also specify "." to download to the current directory.""",
+)
+DISABLE_VERIFY_CHECKSUMS_OPTION = typer.Option(
+    False,
+    "--disable-verify-checksums",
+    "-nc",
+    help="Turn off checksum verification which is on by default. "
+    "Checksum verification means all downloaded files are verified against their MD5 checksums."
+    "It is recommended to leave checksum verification enabled unless you have a specific reason to disable it.",
+)
+PROJECT_VERSION_OPTION = typer.Option(
+    None,
+    "--project-version",
+    "-pv",
+    help="User defined version of the project's at which to download the files. If not provided, downloads the latest version of all selected files.",
+)
+DRY_RUN_OPTION = typer.Option(
+    False,
+    "--dry-run",
+    "-n",
+    help="If set, will not actually download the files, just print what would be downloaded.",
+)
+
 
 @file_app.command("ls")
 def list_files(
@@ -39,7 +71,7 @@ def list_files(
     prefix_filter: str | None = typer.Option(
         None,
         "--prefix",
-        "-p",
+        "-pre",
         help="Optional prefix to filter the listed files by name (only list files starting with this prefix).",
     ),
     include_results_files: bool = typer.Option(
@@ -48,6 +80,12 @@ def list_files(
         "-r",
         help="If set, will also show DivBase query results files which are hidden by default.",
     ),
+    show_deleted_files: bool = typer.Option(
+        False,
+        "--show-deleted-files",
+        "-s",
+        help="Show the files in the project that are currently soft deleted. These files can be recovered within a certain time frame after deletion",
+    ),
     project: str | None = PROJECT_NAME_OPTION,
 ):
     """
@@ -57,9 +95,35 @@ def list_files(
     By default, DivBase query results files are hidden from the listing. Use the --include-results-files option to include them.
     To see information about the versions of each file, use the 'divbase-cli files info [FILE_NAME]' command instead
     """
+    if (show_deleted_files and include_results_files) or (show_deleted_files and prefix_filter):
+        print(
+            "The --show-deleted-files option cannot be used with --include-results-files or --prefix. "
+            "Please use these options separately."
+        )
+        raise typer.Exit(1)
+
     project_config = resolve_project(project_name=project)
     logged_in_url = ensure_logged_in(desired_url=project_config.divbase_url)
 
+    if show_deleted_files:
+        files = list_soft_deleted_files_command(
+            divbase_base_url=logged_in_url,
+            project_name=project_config.name,
+        )
+
+        if not files:
+            print(f"No soft deleted files found for the project '{project_config.name}'.")
+            return
+
+        print(f"Soft deleted files for the project '{project_config.name}':")
+        for file_details in files:
+            cet_timestamp = file_details.last_modified.astimezone(ZoneInfo("CET")).strftime("%Y-%m-%d %H:%M:%S %Z")
+
+            print(f"- '{file_details.name}' (deleted at: '{cet_timestamp}')")
+        print("\nTo restore a soft deleted file, use the 'divbase-cli files restore' command.")
+        print("To get more information about one of the soft deleted files, use the 'divbase-cli files info' command.")
+        return
+
     files = list_files_command(
         divbase_base_url=logged_in_url,
         project_name=project_config.name,
@@ -156,26 +220,10 @@ def download_files(
         None, help="Space separated list of files/objects to download from the project's store on DivBase."
     ),
     file_list: Path | None = typer.Option(None, "--file-list", help="Text file with list of files to upload."),
-    download_dir: str = typer.Option(
-        None,
-        help="""Directory to download the files to. 
-            If not provided, defaults to what you specified in your user config. 
-            If also not specified in your user config, downloads to the current directory.
-            You can also specify "." to download to the current directory.""",
-    ),
-    disable_verify_checksums: Annotated[
-        bool,
-        typer.Option(
-            "--disable-verify-checksums",
-            help="Turn off checksum verification which is on by default. "
-            "Checksum verification means all downloaded files are verified against their MD5 checksums."
-            "It is recommended to leave checksum verification enabled unless you have a specific reason to disable it.",
-        ),
-    ] = False,
-    project_version: str | None = typer.Option(
-        default=None,
-        help="User defined version of the project's at which to download the files. If not provided, downloads the latest version of all selected files.",
-    ),
+    download_dir: str = DOWNLOAD_DIR_OPTION,
+    dry_run: bool = DRY_RUN_OPTION,
+    disable_verify_checksums: bool = DISABLE_VERIFY_CHECKSUMS_OPTION,
+    project_version: str | None = PROJECT_VERSION_OPTION,
     project: str | None = PROJECT_NAME_OPTION,
 ):
     """
@@ -204,19 +252,130 @@ def download_files(
         raw_files_input=raw_files_input,
         download_dir=download_dir_path,
         verify_checksums=not disable_verify_checksums,
+        dry_run=dry_run,
         project_version=project_version,
     )
 
-    if download_results.successful:
-        print("[green bold]Successfully downloaded the following files:[/green bold]")
-        for success in download_results.successful:
-            print(f"- '{success.object_name}' downloaded to: '{success.file_path.resolve()}'")
-    if download_results.failed:
-        print("[red bold]ERROR: Failed to download the following files:[/red bold]")
-        for failed in download_results.failed:
-            print(f"[red]- '{failed.object_name}': Exception: '{failed.exception}'[/red]")
+    _pretty_print_download_results(download_results=download_results)
 
-        raise typer.Exit(1)
+
+@file_app.command("download-all")
+def download_all_files(
+    download_dir: str = DOWNLOAD_DIR_OPTION,
+    resume: bool = typer.Option(
+        False,
+        "--resume",
+        "-r",
+        help="If set, will attempt to resume an interrupted download. Will check which files have already been fully downloaded (by checking if a file with the same name and checksum already exists in the download directory) and skip downloading those files again.",
+    ),
+    dry_run: bool = DRY_RUN_OPTION,
+    disable_verify_checksums: bool = DISABLE_VERIFY_CHECKSUMS_OPTION,
+    project_version: str | None = PROJECT_VERSION_OPTION,
+    project: str | None = PROJECT_NAME_OPTION,
+):
+    """
+    Download all files in the project's store on DivBase.
+    Before the download proceeds you'll be prompted if you want to continue.
+    DivBase Query results files will not be included in the download.
+
+    You can resume ('--resume' / '-r') a 'download-all' command, just make sure you're downloading into the same directory.
+    """
+    if resume and disable_verify_checksums:
+        print(
+            "The --resume and --disable-verify-checksums options cannot be used together, "
+            "as checksums are used to determine which files don't need to be downloaded. \n"
+            "Exiting... "
+        )
+        return
+
+    project_config = resolve_project(project_name=project)
+    logged_in_url = ensure_logged_in(desired_url=project_config.divbase_url)
+    download_dir_path = resolve_download_dir(download_dir=download_dir)
+
+    all_files: list[ToDownload] = []
+    if project_version:
+        version_details = get_version_details_command(
+            project_name=project_config.name, divbase_base_url=logged_in_url, version_name=project_version
+        )
+        for version_name, file_details in version_details.files.items():
+            all_files.append(
+                ToDownload(
+                    name=version_name,
+                    etag=file_details["etag"],
+                    size_bytes=file_details["size"],
+                    version_id=file_details["version_id"],
+                )
+            )
+
+    else:
+        list_files_response = list_files_command(
+            divbase_base_url=logged_in_url,
+            project_name=project_config.name,
+            prefix_filter=None,
+            include_results_files=False,
+        )
+        for file_details in list_files_response:
+            all_files.append(
+                ToDownload(
+                    name=file_details.name,
+                    etag=file_details.etag,
+                    size_bytes=file_details.size,
+                    version_id=None,  # latest version
+                )
+            )
+
+    if not all_files:
+        print("No files to download as there are no files in the project's store.")
+        return
+
+    # filter files to download based on those which already exist.
+    if resume:
+        files_to_download, files_to_overwrite = filter_out_already_downloaded_files(
+            all_files=all_files, download_dir=download_dir_path
+        )
+        if files_to_overwrite:
+            print(
+                "[yellow bold]Warning: The following files already exist in the download directory but have a different checksum."
+                "If you choose to proceed, these files will be overwritten by the download:[/yellow bold]"
+            )
+            for file in files_to_overwrite:
+                print(f"- '{file.name}'")
+
+        files_to_download.extend(files_to_overwrite)
+
+        if not files_to_download:
+            print("No files left to download, your folder matches the project's store on DivBase, exiting...")
+            return
+    else:
+        files_to_download = all_files
+
+    total_size_bytes = sum(file.size_bytes for file in files_to_download)
+    formatted_total_size = format_file_size(size_bytes=total_size_bytes)
+
+    print(f"There are '{len(files_to_download)}' files to download with a total size of: {formatted_total_size}.")
+
+    if not dry_run:
+        # (dry run will auto exit in the download_files_command)
+        do_download = typer.confirm("Do you want to proceed with the download?")
+        if not do_download:
+            print("Download cancelled...")
+            return
+
+    if project_version:
+        raw_files_input = [f"{file.name}:{file.version_id}" for file in files_to_download]
+    else:
+        raw_files_input = [file.name for file in files_to_download]
+    download_results = download_files_command(
+        divbase_base_url=logged_in_url,
+        project_name=project_config.name,
+        raw_files_input=raw_files_input,
+        download_dir=download_dir_path,
+        verify_checksums=not disable_verify_checksums,
+        dry_run=dry_run,
+        project_version=None,  # We already know the version id of each file, so can skip the processing here.
+    )
+
+    _pretty_print_download_results(download_results=download_results)
 
 
 @file_app.command("stream")
@@ -309,12 +468,12 @@ def upload_files(
     )
 
     if uploaded_results.successful:
-        print("[green bold] The following files were successfully uploaded: [/green bold]")
+        print("[green bold]\nThe following files were successfully uploaded: [/green bold]")
         for object in uploaded_results.successful:
             print(f"- '{object.object_name}' created from file at: '{object.file_path.resolve()}'")
 
     if uploaded_results.failed:
-        print("[red bold]ERROR: Failed to upload the following files:[/red bold]")
+        print("[red bold]\nERROR: Failed to upload the following files:[/red bold]")
         for failed in uploaded_results.failed:
             print(f"[red]- '{failed.object_name}': Exception: '{failed.exception}'[/red]")
 
@@ -457,3 +616,17 @@ def _check_for_unsupported_files(all_files: set[Path]) -> None:
 
     if unsupported_chars:
         raise UnsupportedFileNameError(unsupported_files=unsupported_chars)
+
+
+def _pretty_print_download_results(download_results):
+    """Helper fn used by download and download all commands to print the results of the download in a nice format."""
+    if download_results.successful:
+        print("\n[green bold]Successfully downloaded the following files:[/green bold]")
+        for success in download_results.successful:
+            print(f"- '{success.object_name}' downloaded to: '{success.file_path.resolve()}'")
+
+    if download_results.failed:
+        print("\n[red bold]ERROR: Failed to download the following files:[/red bold]")
+        for failed in download_results.failed:
+            print(f"[red]- '{failed.object_name}': Exception: '{failed.exception}'[/red]")
+        raise typer.Exit(1)

divbase_cli/cli_commands/query_cli.py

@@ -97,14 +97,23 @@ def sample_metadata_query(
 
     results = SampleMetadataQueryTaskResult(**response.json())
 
+    if results.warnings:
+        print("[yellow]Warnings:[/yellow]")
+        for warning in results.warnings:
+            print(f"  • {warning}")
+        print()
+
     if show_sample_results:
         print("[bright_blue]Name and file for each sample in query results:[/bright_blue]")
         for sample in results.sample_and_filename_subset:
             print(f"Sample ID: '{sample['Sample_ID']}', Filename: '{sample['Filename']}'")
 
     print(f"The results for the query ([bright_blue]{results.query_message}[/bright_blue]):")
-    print(f"Unique Sample IDs: {results.unique_sample_ids}")
-    print(f"Unique filenames: {results.unique_filenames}\n")
+
+    unique_sample_ids = results.unique_sample_ids or []
+    unique_filenames = results.unique_filenames or []
+    print(f"Unique Sample IDs: {unique_sample_ids}")
+    print(f"Unique filenames: {unique_filenames}\n")
 
 
 @query_app.command("bcftools-pipe")

divbase_cli/cli_commands/shared_args_options.py

@@ -8,6 +8,8 @@ import typer
 
 PROJECT_NAME_OPTION = typer.Option(
     None,
+    "--project",
+    "-p",
     help="Name of the DivBase project, if not provided uses the default in your DivBase config file",
     show_default=False,
 )
@@ -16,5 +18,6 @@ PROJECT_NAME_OPTION = typer.Option(
 FORMAT_AS_TSV_OPTION = typer.Option(
     False,
     "--tsv",
+    "-t",
     help="If set, will print the output in .TSV format for easier programmatic parsing.",
 )

divbase_cli/cli_commands/version_cli.py

@@ -14,8 +14,10 @@ from divbase_cli.services.project_versions import (
     delete_version_command,
     get_version_details_command,
     list_versions_command,
+    update_version_command,
 )
 from divbase_cli.utils import print_rich_table_as_tsv
+from divbase_lib.utils import format_file_size
 
 version_app = typer.Typer(
     no_args_is_help=True,
@@ -49,7 +51,54 @@ def add_version(
     print(f"New version: '{add_version_response.name}' added to the project: '{project_config.name}'")
 
 
-@version_app.command("list")
+@version_app.command("update")
+def update_version(
+    version_name: str = typer.Argument(help="Name of the existing version you want to modify", show_default=False),
+    new_name: str | None = typer.Option(
+        None, "--new-name", "-n", help="New name for the version. If not specified, the name will remain unchanged."
+    ),
+    new_description: str | None = typer.Option(
+        None,
+        "--new-description",
+        "-d",
+        help="Optional new description of the version. If not specified, the description will remain unchanged.",
+    ),
+    project: str | None = PROJECT_NAME_OPTION,
+):
+    """
+    Update an existing project version entry's name and/or description.
+
+    The files and timestamp associated with a version entry are immutable and cannot be changed.
+    This is by design to ensure version entries are representations of the project's state at the timepoint they were created at.
+    You can create a new version entry to capture the current state of the project instead.
+
+    To see your current version entries run: `divbase-cli version ls`
+    """
+    if not new_name and not new_description:
+        print(
+            "No updates specified. Please provide a new name (--new-name) and/or description (--new-description) to update for this entry."
+        )
+        return
+
+    project_config = resolve_project(project_name=project)
+    logged_in_url = ensure_logged_in(desired_url=project_config.divbase_url)
+
+    updated_version = update_version_command(
+        project_name=project_config.name,
+        divbase_base_url=logged_in_url,
+        version_name=version_name,
+        new_name=new_name,
+        new_description=new_description,
+    )
+    if new_name and new_name != version_name:
+        print(f"Version '{version_name}' renamed to '{updated_version.name}' in project: '{project_config.name}'")
+    else:
+        print(f"Version '{updated_version.name}' updated in project: '{project_config.name}'")
+    if new_description:
+        print(f"New description: '{updated_version.description}'")
+
+
+@version_app.command("ls")
 def list_versions(
     project: str | None = PROJECT_NAME_OPTION,
     include_deleted: bool = typer.Option(False, help="Include soft-deleted versions in the listing."),
@@ -100,8 +149,11 @@ def list_versions(
 def get_version_info(
     version: str = typer.Argument(help="Specific version to retrieve information for"),
     project: str | None = PROJECT_NAME_OPTION,
+    format_output_as_tsv: bool = FORMAT_AS_TSV_OPTION,
 ):
-    """Provide detailed information about a user specified project version, including all files present and their unique hashes."""
+    """
+    Provide detailed information about a user specified project version, including all files present and their unique hashes.
+    """
     project_config = resolve_project(project_name=project)
     logged_in_url = ensure_logged_in(desired_url=project_config.divbase_url)
 
@@ -109,26 +161,43 @@ def get_version_info(
         project_name=project_config.name, divbase_base_url=logged_in_url, version_name=version
     )
 
-    print(f"Project version entry for project: '{project_config.name}' with name: '{version_details.name}'")
-    print(f"Entry created at: {format_timestamp(version_details.created_at)}")
-    if version_details.description:
-        print(f"Description: {version_details.description}")
-    if version_details.is_deleted:
-        print(
-            "[red]WARNING: This version has been soft-deleted and will soon be permanently deleted unless restored - Contact a DivBase admin to prevent this.[/red]"
+    table = Table(title=f"Project version files for {project_config.name}")
+    table.add_column("Name", style="cyan", no_wrap=True)
+    table.add_column("Version ID", style="magenta")
+    table.add_column("MD5 Checksum", style="green")
+    table.add_column("Size", style="yellow")
+    for object_name, file_details in version_details.files.items():
+        file_size = format_file_size(file_details["size"])
+
+        table.add_row(
+            object_name,
+            file_details["version_id"],
+            file_details["etag"],
+            file_size,
         )
-    print("Files at this version:")
-    for object_name, hash in version_details.files.items():
-        print(f"- '{object_name}' : '{hash}'")
+
+    if not format_output_as_tsv:
+        print(f"Project version entry for project: '{project_config.name}' with name: '{version_details.name}'")
+        print(f"Entry created at: {format_timestamp(version_details.created_at)}")
+        if version_details.description:
+            print(f"Description: {version_details.description}")
+        if version_details.is_deleted:
+            print(
+                "[red]WARNING: This version has been soft-deleted and will soon be permanently deleted unless restored - Contact a DivBase admin to prevent this.[/red]"
+            )
+        print(table)
+    else:
+        print_rich_table_as_tsv(table=table)
 
 
-@version_app.command("delete")
+@version_app.command("rm")
 def delete_version(
     name: str = typer.Argument(help="Name of the version (e.g., semantic version).", show_default=False),
     project: str | None = PROJECT_NAME_OPTION,
 ):
     """
     Delete a version entry in the project versioning table. This does not delete the files themselves.
+
     Deleted version entries older than 30 days will be permanently deleted.
     You can ask a DivBase admin to restore a deleted version within that time period.
     """

divbase_cli/cli_config.py

@@ -3,7 +3,7 @@ Settings for DivBase CLI.
 
 This class creates a single 'settings' object at module load time that can be imported and used throughout the entire package.
 
-The user config and tokens are stored in the user local app dir:
+The user config and tokens are stored in the users local app dir:
 https://typer.tiangolo.com/tutorial/app-dir/
 """
 
@@ -15,11 +15,18 @@ import typer
 
 APP_NAME = "divbase-cli"
 APP_DIR = Path(typer.get_app_dir(APP_NAME))
+DEFAULT_METADATA_TSV_NAME = "sample_metadata.tsv"
+DEFAULT_LOG_LEVEL = "INFO"
+DEV_MODE = os.getenv("DIVBASE_DEV", "0") == "1"
 CONFIG_PATH = APP_DIR / "config.yaml"
 TOKENS_PATH = APP_DIR / ".secrets"
-DEFAULT_METADATA_TSV_NAME = "sample_metadata.tsv"
-# TODO - change to production URL when time comes
-DEFAULT_DIVBASE_API_URL = "https://divbase-dev.scilifelab-2-dev.sys.kth.se/api/"
+
+if DEV_MODE:
+    DEFAULT_DIVBASE_API_URL = "http://localhost:8000/api"
+    DEFAULT_LOGGING_ON = "1"
+else:
+    DEFAULT_DIVBASE_API_URL = "https://divbase-dev.scilifelab-2-dev.sys.kth.se/api"  # TODO - prod url when time
+    DEFAULT_LOGGING_ON = "0"
 
 
 @dataclass
@@ -27,7 +34,7 @@ class DivBaseCLISettings:
     """
     Settings for DivBase CLI.
 
-    Your do not need to create an instance of this class yourself,
+    You do not need to create an instance of this class yourself,
     instead, import the 'cli_settings' instance created at this module's load time.
     """
 
@@ -35,8 +42,8 @@ class DivBaseCLISettings:
     TOKENS_PATH: Path = Path(os.getenv("DIVBASE_CLI_TOKENS_PATH", TOKENS_PATH))
     DIVBASE_API_URL: str = os.getenv("DIVBASE_API_URL", DEFAULT_DIVBASE_API_URL)
     METADATA_TSV_NAME: str = os.getenv("DIVBASE_METADATA_TSV_NAME", DEFAULT_METADATA_TSV_NAME)
-    LOGGING_ON: bool = bool(os.getenv("DIVBASE_LOGGING_ON", "True") == "True")
-    LOG_LEVEL: str = os.getenv("DIVBASE_LOG_LEVEL", "INFO").upper()
+    LOGGING_ON: bool = os.getenv("DIVBASE_LOGGING_ON", DEFAULT_LOGGING_ON) == "1"
+    LOG_LEVEL: str = os.getenv("DIVBASE_LOG_LEVEL", DEFAULT_LOG_LEVEL).upper()
 
     def __post_init__(self):
         valid_levels = ["CRITICAL", "ERROR", "WARNING", "INFO", "DEBUG", "NOTSET"]

divbase_cli/services/announcements.py

@@ -0,0 +1,46 @@
+"""
+Get announcements from divbase API and display them to the user.
+"""
+
+from rich import print
+
+from divbase_cli.user_auth import make_unauthenticated_request
+from divbase_lib.api_schemas.announcements import AnnouncementResponse
+
+COLOR_MAPPING = {
+    "info": "blue",
+    "success": "green",
+    "warning": "yellow",
+    "danger": "red",
+}
+
+
+def get_and_display_announcements(divbase_base_url: str) -> None:
+    """
+    Get announcements from the API and display them to the user.
+    Used when logging in to display any important messages to the user.
+    """
+    response = make_unauthenticated_request(
+        method="GET",
+        divbase_base_url=divbase_base_url,
+        api_route="/v1/core/announcements",
+    )
+    announcements_data = response.json()
+    if not announcements_data:
+        return
+    announcements = [AnnouncementResponse.model_validate(ann) for ann in announcements_data]
+
+    if len(announcements) == 1:
+        print("[bold]An Announcement from DivBase Server:[/bold]")
+        color = COLOR_MAPPING.get(announcements[0].level)
+        print(f"[bold {color}]{announcements[0].heading}[/bold {color}]")
+        if announcements[0].message:
+            print(f"{announcements[0].message}\n")
+        return
+
+    print("[bold]Announcements from DivBase Server:[/bold]")
+    for idx, ann in enumerate(announcements, start=1):
+        color = COLOR_MAPPING.get(ann.level)
+        print(f"[bold {color}]{idx}) {ann.heading}[/bold {color}]")
+        if ann.message:
+            print(f"{ann.message}\n")

divbase_cli/services/pre_signed_urls.py

@@ -21,6 +21,7 @@ from pathlib import Path
 
 import httpx
 import stamina
+from rich import print
 
 from divbase_cli.cli_exceptions import DivBaseAPIConnectionError, DivBaseAPIError
 from divbase_cli.retries import retry_only_on_retryable_http_errors
@@ -95,6 +96,7 @@ def download_multiple_pre_signed_urls(
         for obj in pre_signed_urls:
             output_file_path = download_dir / obj.name
             object_name = obj.name
+            print(f"Downloading '{object_name}'...", end=" ")
             try:
                 result = _download_single_pre_signed_url(
                     httpx_client=client,
@@ -103,9 +105,11 @@ def download_multiple_pre_signed_urls(
                     output_file_path=output_file_path,
                     object_name=object_name,
                 )
+                print("[bold green]Success[/bold green]")
             except httpx.HTTPError as err:
                 output_file_path.unlink(missing_ok=True)  # Clean up possible partial file
                 result = FailedDownload(object_name=object_name, file_path=output_file_path, exception=err)
+                print("[bold red]Failed[/bold red]")
 
             if isinstance(result, SuccessfulDownload):
                 successful_downloads.append(result)
@@ -258,6 +262,7 @@ def upload_multiple_singlepart_pre_signed_urls(
     successful_uploads, failed_uploads = [], []
     with httpx.Client() as client:
         for obj in pre_signed_urls:
+            print(f"Uploading '{obj.name}'...", end=" ")
             result = _upload_one_singlepart_pre_signed_url(
                 httpx_client=client,
                 pre_signed_url=obj.pre_signed_url,
@@ -267,8 +272,10 @@ def upload_multiple_singlepart_pre_signed_urls(
             )
 
             if isinstance(result, SuccessfulUpload):
+                print("[bold green]Success[/bold green]")
                 successful_uploads.append(result)
             else:
+                print("[bold red]Failed[/bold red]")
                 failed_uploads.append(result)
 
     return UploadOutcome(successful=successful_uploads, failed=failed_uploads)
@@ -311,6 +318,7 @@ def perform_multipart_upload(
     """
     object_name = file_path.name
     file_size = file_path.stat().st_size
+    print(f"Uploading '{object_name}'...", end=" ")
 
     # 1. Create multipart upload
     create_request = CreateMultipartUploadRequest(name=object_name, content_length=file_size)
@@ -353,6 +361,7 @@ def perform_multipart_upload(
             json=complete_request_body.model_dump(),
         )
         completed_upload = CompleteMultipartUploadResponse(**response.json())
+        print("[bold green]Success[/bold green]")
         return SuccessfulUpload(file_path=file_path, object_name=completed_upload.name)
 
     # 4. If any unexpected error occurs, abort the multipart upload
@@ -369,6 +378,7 @@ def perform_multipart_upload(
         except (DivBaseAPIConnectionError, DivBaseAPIError):
             logger.error(f"Failed to abort multipart upload for object '{object_name}' after an upload error.")
 
+        print("[bold red]Failed[/bold red]")
         return FailedUpload(object_name=object_name, file_path=file_path, exception=e)