Struct CtrlCHandle 

pub struct CtrlCHandle { /* private fields */ }

A trigger for a CtrlC handle created via CtrlC::manual – the HTTP-triggered equivalent of a real Ctrl+C keypress. Deliberately a thin wrapper around the same watch::Sender<u32> mechanism #[cfg(test)]’s test_pair() already uses internally, rather than a second, parallel cancellation mechanism: CtrlC::signalled can’t tell the two apart, so execute/run_polling_loop/attempt_restore need no changes at all to support HTTP-triggered cancellation.

Clone so a caller can store one copy in a run registry (to answer a later POST /api/runs/{id}/cancel) while another copy is held by whatever’s waiting to trigger it on graceful shutdown.

Implementations

impl CtrlCHandle

pub fn trigger(&self)

Requests cancellation, exactly as if Ctrl+C had been pressed. Safe to call more than once – a second call is exactly what lets a caller model a “second Ctrl+C” hard-exit request arriving during an already-in-flight restore, matching safety-cancellation’s interactive CLI behavior (see AGENTS.md) – and safe to call after the paired CtrlC has already been dropped (the run this handle was for has already ended): [watch::Sender::send_modify] never fails, unlike send, so there is nothing to propagate or ignore.

Trait Implementations

impl Clone for CtrlCHandle

fn clone(&self) -> CtrlCHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.