Struct ActiveOutputRegistry 

pub struct ActiveOutputRegistry { /* private fields */ }

Process-wide registry of output paths that are currently being written by active downloads.

All download command types (DownloadCommand, MetalinkDownloadCommand, ConcurrentDownloadCommand) consult this registry before opening their disk writer, so that concurrent downloads targeting the same filename receive distinct paths.

Implementations

impl ActiveOutputRegistry

pub fn new() -> Self

Create a new empty registry.

pub async fn resolve(&self, desired: &Path) -> PathBuf

Resolve the final output path for a download, registering it to prevent collisions.

If desired is not currently claimed by another active download, it is registered and returned as-is. If a collision is detected, the method appends (1), (2), etc. (before the file extension) until an unused name is found.

Returns

The resolved PathBuf that the caller should use for all subsequent disk I/O. The caller must call Self::release when the download finishes (success or failure).

pub async fn release(&self, path: &Path)

Release a previously-resolved path from the registry.

Must be called when a download completes (success or failure) so that the path becomes available for future downloads if needed.

pub async fn len(&self) -> usize

Return the number of paths currently registered (for diagnostics / testing).

pub async fn is_empty(&self) -> bool

Check whether the registry is empty.

Trait Implementations

impl Default for ActiveOutputRegistry

fn default() -> Self

Returns the “default value” for a type.