Struct BtProgressManager 

pub struct BtProgressManager { /* private fields */ }

BT progress file manager

Manages BT download progress save, load, delete, and list operations. Supports atomic writes to ensure existing progress files are not corrupted in abnormal situations.

Implementations

impl BtProgressManager

pub fn new(progress_dir: &Path) -> Result<Self>

Create new BT progress manager

Automatically creates specified directory if it doesn’t exist.

Arguments

• progress_dir - Progress file storage directory path

Errors

Returns error when unable to create directory

pub fn get_progress_file_path(&self, info_hash: &[u8; 20]) -> PathBuf

Generate progress file path

pub fn save_progress( &self, info_hash: &[u8; 20], progress: &BtProgress, ) -> Result<()>

Save BT download progress to file

Uses atomic write strategy: writes to temporary file first, then replaces original file via rename operation, ensuring existing progress files are not corrupted if exceptions occur during write process.

Arguments

• info_hash - Torrent info_hash (20 bytes)
• progress - Progress data to save

Errors

Returns error when file write fails

pub fn load_progress(&self, info_hash: &[u8; 20]) -> Result<BtProgress>

Load BT download progress file

Automatically detects C++ binary format and text format, and parses correctly. Validates whether info_hash in file matches provided parameter.

Arguments

• info_hash - Expected info_hash (20 bytes) for validation

Returns

Returns loaded progress data

Errors

• File doesn’t exist or read failure
• File format invalid or corrupted
• info_hash mismatch

pub fn remove_progress(&self, info_hash: &[u8; 20]) -> Result<()>

Delete progress file for specified info_hash

Arguments

• info_hash - info_hash of torrent to delete (20 bytes)

Errors

Returns error when file deletion fails

pub fn list_saved_progresses(&self) -> Vec<[u8; 20]>

List all saved progress files

Scans all .aria2 files in progress directory, extracts their info_hash.

Returns

Returns list of info_hash for all saved progress