Struct RetryPolicy 

pub struct RetryPolicy { /* private fields */ }

How retries are scheduled and which errors trigger them.

The default policy retries up to 3 times with exponential backoff (100ms → 200ms → 400ms, with jitter). The default predicate only retries RunError::NonZeroExit whose stderr matches "stale" or ".lock" (jj working-copy staleness, git/jj lock-file contention).

RunError::Spawn and RunError::Timeout are never retried by the default predicate — a missing binary doesn’t become available, and a hung process retried is still hung. Users who want to retry either can supply a custom predicate via RetryPolicy::when or Cmd::retry_when.

Implementations

impl RetryPolicy

pub fn with_backoff(backoff: ExponentialBuilder) -> RetryPolicy

Construct a policy with custom backoff and the default predicate.

pub fn when( self, f: impl Fn(&RunError) -> bool + Send + Sync + 'static, ) -> RetryPolicy

Replace the predicate. The predicate receives a RunError and returns whether to retry.

Trait Implementations

impl Clone for RetryPolicy

fn clone(&self) -> RetryPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetryPolicy

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

Formats the value using the given formatter.

impl Default for RetryPolicy

fn default() -> RetryPolicy

Returns the “default value” for a type.