Struct DownloadHub 

pub struct DownloadHub { /* private fields */ }

Implementations

impl DownloadHub

pub fn new() -> Self

pub fn mode_for(&self, backend: &TabBackend) -> Option<Mode>

Mode for backend, if already resolved for it.

pub fn mode(&self) -> Option<Mode>

Current mode regardless of backend (tool output).

pub fn set_mode(&self, backend: &TabBackend, mode: Mode)

Install the mode for a (new) backend. Drops router state that belonged to a previous backend.

pub fn reset(&self)

Forget everything (browser switch).

pub fn begin_action(&self) -> u64

Record the start of an action tool call; returns the mark used to report downloads that began during it.

Also clears the re-apply debounce: an action is exactly when a download can start, so the override is always re-sent for it.

pub fn end_action(&self)

Pair of Self::begin_action.

pub fn touch(&self, target_id: &str)

Record that this server’s tools work in target_id.

pub fn invalidate(&self)

Force the next apply to re-send the override (another connection that set it, such as the sidecar, just went away).

pub fn since(&self, mark: u64) -> Vec<DownloadRecord>

Downloads from this server’s tabs that began after mark.

pub fn list(&self) -> Vec<DownloadRecord>

pub async fn apply(&self, backend: &TabBackend, force: bool)

Make sure the runtime override and event routing are in place for backend. Debounced unless force. Never errors: failures are logged and the launch-time prefs remain the safety net.

pub fn events_available(&self) -> bool

Whether download events can be observed on the current backend.

pub async fn wait( &self, id: Option<&str>, begin_timeout: Duration, complete_timeout: Duration, ) -> Result<Option<DownloadRecord>>

Wait for a download. id: that download; otherwise the newest one no earlier id-less wait has returned (waiting up to begin_timeout for one to begin). Then waits up to complete_timeout for it to finish. Returns None when nothing began; an unfinished download is returned in its current state.

pub async fn save_to(&self, id: &str, dest_dir: &Path) -> Result<DownloadRecord>

Move a completed download into dest_dir (absolute; created if missing) without overwriting. Updates the record.

Trait Implementations

impl Default for DownloadHub

fn default() -> Self

Returns the “default value” for a type.

impl Drop for DownloadHub

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.