Struct CrashShipper 

pub struct CrashShipper { /* private fields */ }

Offline crash spool shipping API. Offline crash spool shipping API. Offline crash spool shipping API. Reusable crash uploader with pooled HTTP connections and an in-memory token.

Convenience shipping functions create one uploader per scan. Keep this value to reuse its pool across scans, or supply a Reqwest client for private CAs, mutual TLS, proxy settings, and custom timeouts.

Implementations

impl CrashShipper

pub fn new(token: SecretString) -> Result<Self, ShipError>

Creates an uploader with a 10-second connect timeout, 30-second read timeout, and 60-second total request timeout.

The offline spool owns retries; HTTP-level retries are disabled to avoid recording a crash index more than once during one upload attempt.

Errors

Returns ShipError::Http if the HTTP client cannot be initialized.

pub fn with_client(client: Client, token: SecretString) -> Self

Uses a caller-configured HTTP client. Its timeout and retry policy apply.

pub fn with_config(self, config: ShipConfig) -> Self

Sets dump and attachment compression options.

pub async fn ship_pending( &self, spool_dir: impl AsRef<Path>, endpoint: Url, ) -> Result<usize, ShipError>

Ships pending entries to an explicit endpoint using this client’s connection pool.

Errors

See ship_pending_crashes_with_config. Failed entries remain pending.

pub async fn ship_using_stored_config( &self, spool_dir: impl AsRef<Path>, ) -> Result<usize, ShipError>

Ships pending entries using their stored endpoints and retention policies.

Errors

See ship_pending_crashes_using_stored_config_with_config.

Trait Implementations

impl Clone for CrashShipper

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CrashShipper

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

Formats the value using the given formatter.