Struct JobHandle 

pub struct JobHandle { /* private fields */ }

A live scan job handle (P7 task 9.2, PF-01). spawn_scan_json returns immediately, so a UI thread never blocks on a walk: progress is polled, cancellation is cooperative, and result_json is the only joining call. Dropping the last handle detaches the worker; the database is only written by the worker’s own publish step, so a detached run either completes its publish or leaves none.

Implementations

impl JobHandle

pub fn progress_json(&self) -> String

A non-blocking snapshot: state, bytes observed so far, and whether the job finished. Safe to call from a UI render loop.

pub fn cancel(&self)

Asks the walk to stop at its next observation boundary. A job that already finished is unaffected; cancellation is cooperative, so the final state stays truthful about how far the walk got.

pub fn result_json(&self) -> String

Joins the worker and returns the same envelope the synchronous call would have produced. Idempotent: later calls return the recorded result without re-running anything.

Trait Implementations

impl<UT> LiftRef<UT> for JobHandle

type LiftType = Arc<JobHandle>

impl<UT> LowerError<UT> for JobHandle

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for JobHandle

type ReturnType = <Arc<JobHandle> as LowerReturn<UniFfiTag>>::ReturnType

The type that should be returned by scaffolding functions for this type.

fn lower_return(obj: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl<UT> TypeId<UT> for JobHandle

const TYPE_ID_META: MetadataBuffer