Struct ScanHandle 

pub struct ScanHandle { /* private fields */ }

Live state of one scan.

All fields are Arc<…> because handles are shared between the background scan task and any number of HTTP request handlers.

Implementations

impl ScanHandle

pub fn new( username: impl Into<String>, site_count: usize, outcome_buffer: usize, ) -> Self

Construct an empty handle ready to accept outcomes.

site_count is the size of the site list this scan will run against — surfaced through Self::site_count so the UI can render 423 / 1890 progress without holding open an SSE stream. outcome_buffer sizes the broadcast ring buffer; a value substantially larger than site_count is fine — the cost is one Arc<…> slot per buffered notification.

pub fn username(&self) -> &str

Username being scanned (for display / debugging).

pub fn site_count(&self) -> usize

Total number of sites this scan will / did probe.

pub fn elapsed(&self) -> Duration

Wall-clock time since the handle was created.

pub fn created_at_ms(&self) -> u64

Unix epoch milliseconds when this handle was constructed. Used by the history endpoint so the UI can render relative times.

pub async fn outcomes_snapshot(&self) -> Vec<CheckOutcome>

Snapshot of outcomes recorded so far. Cheap clone — Vec deep-clones only the small number of strings inside each CheckOutcome.

pub async fn finished(&self) -> Option<FinishedScan>

Final aggregate, once the scan has completed. None while running.

pub fn is_finished_now(&self) -> bool

Best-effort sync peek used by the eviction policy. Returns false if the lock is currently held — a momentarily-locked finished slot is, by construction, still being mutated.

pub fn subscribe(&self) -> Receiver<usize>

Subscribe to “new outcome appended at index N” notifications. Combine with Self::outcomes_snapshot for “replay then live” semantics.

pub async fn wait_done(&self)

Wait until the scan finishes. Idempotent — fires for every caller registered before or after the scan completes (the finished field is the source of truth; this is just a wake-up).

Trait Implementations

impl Clone for ScanHandle

fn clone(&self) -> ScanHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ScanHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.