Struct CheckpointManager 

pub struct CheckpointManager {
    pub base_dir: PathBuf,
    pub max_checkpoints: usize,
    pub interval_steps: u64,
}

Manages a rolling set of checkpoint files in a directory.

Checkpoints are named checkpoint_NNNNNNNNNN.bin where N is the zero-padded step number.

Fields

base_dir: PathBuf

Base directory for checkpoint files.

max_checkpoints: usize

Maximum number of checkpoints to keep.

interval_steps: u64

Write a checkpoint every interval_steps steps.

Implementations

impl CheckpointManager

pub fn new( base_dir: impl Into<PathBuf>, max_checkpoints: usize, interval_steps: u64, ) -> Self

Construct a new CheckpointManager.

pub fn should_checkpoint(&self, step: u64) -> bool

Return true when a checkpoint should be written at step.

Always returns true for step 0 if interval_steps > 0.

pub fn checkpoint_path(&self, step: u64) -> PathBuf

Compute the canonical path for the checkpoint at step.

pub fn list_checkpoints(&self) -> Vec<PathBuf>

Return a sorted list of existing checkpoint file paths in base_dir.

pub fn latest_checkpoint(&self) -> Option<PathBuf>

Return the path to the most recent (highest step) checkpoint, if any.

pub fn prune_old_checkpoints(&self) -> Result<()>

Delete oldest checkpoints, keeping at most max_checkpoints files.

Trait Implementations

impl Clone for CheckpointManager

fn clone(&self) -> CheckpointManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CheckpointManager

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

Formats the value using the given formatter.