Struct FileTransferRecord 

pub struct FileTransferRecord { /* private fields */ }

Immutable progress/state record emitted by transfer callbacks.

This snapshot is safe to clone and pass across threads. file_sign and file_name are backed by Arc<str> so per-event fan-out only performs a refcount bump instead of string allocation.

Implementations

impl FileTransferRecord

pub fn new( task_id: TaskId, file_sign: impl Into<Arc<str>>, file_name: impl Into<Arc<str>>, total_size: u64, progress: f32, status: TransferStatus, direction: Direction, ) -> Self

Creates a new transfer record.

Range guidance

• total_size >= 0
• progress should stay in 0.0..=1.0

Examples

use rusty_cat::api::{Direction, FileTransferRecord, TaskId, TransferStatus};

let record = FileTransferRecord::new(
    task_id,
    "sign".to_string(),
    "file.bin".to_string(),
    1024,
    0.5,
    TransferStatus::Transmission,
    Direction::Download,
);
assert_eq!(record.total_size(), 1024);

pub fn file_sign(&self) -> &str

Returns file signature.

Examples

use rusty_cat::api::FileTransferRecord;

fn read_sign(record: &FileTransferRecord) {
    let _ = record.file_sign();
}

pub fn file_name(&self) -> &str

Returns display file name.

Examples

use rusty_cat::api::FileTransferRecord;

fn read_name(record: &FileTransferRecord) {
    let _ = record.file_name();
}

pub fn total_size(&self) -> u64

Returns total file size in bytes.

Examples

use rusty_cat::api::FileTransferRecord;

fn read_size(record: &FileTransferRecord) {
    let _ = record.total_size();
}

pub fn progress(&self) -> f32

Returns progress ratio in range 0.0..=1.0.

Examples

use rusty_cat::api::FileTransferRecord;

fn read_progress(record: &FileTransferRecord) {
    let _ = record.progress();
}

pub fn status(&self) -> &TransferStatus

Returns current transfer status.

Examples

use rusty_cat::api::FileTransferRecord;

fn read_status(record: &FileTransferRecord) {
    let _ = record.status();
}

pub fn direction(&self) -> Direction

Returns transfer direction.

Examples

use rusty_cat::api::FileTransferRecord;

fn read_direction(record: &FileTransferRecord) {
    let _ = record.direction();
}

pub fn task_id(&self) -> TaskId

Returns task ID.

Examples

use rusty_cat::api::FileTransferRecord;

fn read_task_id(record: &FileTransferRecord) {
    let _ = record.task_id();
}

Trait Implementations

impl Clone for FileTransferRecord

fn clone(&self) -> FileTransferRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileTransferRecord

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

Formats the value using the given formatter.