Module download 

Download state and management.

DownloadJob holds per-download progress/status. DownloadManager owns the shared job list and spawns background tasks.

This module handles downloading files from the RomM server, including resume support and progress tracking.

Structs

DownloadJob

A single background download job (for one ROM).

DownloadManager

Owns the shared download list and spawns background download tasks.

ExtrasItemResult

Outcome of one item inside an ExtrasJob.

ExtrasJob

One queued extras batch for a parent ROM (related files + cover + manual).

Enums

DownloadStatus

High-level status of a single download.

ExtrasJobStatus

Terminal status for a composite extras download.

Functions

download_directory

Backward-compatible default used by legacy CLI download code.

extract_zip_archive

Extract a ZIP archive into destination_dir.

platform_download_slug

Filesystem slug used for auto-mode console subfolders.

prepare_download_target_destination

resolve_console_roms_dir

Resolve the directory where ROM files for rom should be stored.

resolve_console_save_dir

Resolve the directory where save files for a console should be stored.

resolve_download_directory

Directory for ROM storage (ROMM_ROMS_DIR, ROMM_DOWNLOAD_DIR, or configured path).

resolve_game_save_dir

Resolve the directory where a specific game’s saves should be downloaded.

unique_zip_path

Pick stem.zip, then stem__2.zip, stem__3.zip, … until the path does not exist.

validate_configured_download_directory

Validate configured download path without env override fallback.