Struct HistoryEntry 

pub struct HistoryEntry {
    pub id: String,
    pub url: String,
    pub filename: String,
    pub output_dir: String,
    pub status: EntryStatus,
    pub bytes_total: Option<u64>,
    pub sha256: Option<String>,
    pub expected_sha256: Option<String>,
    pub created_at: u64,
    pub finished_at: Option<u64>,
    pub error: Option<String>,
}

A single record in the download history.

Fields

id: String

Short hex identifier derived from the URL and creation time.

url: String

Source URL or magnet link.

filename: String

Filename extracted from the URL or Content-Disposition.

output_dir: String

Directory where the file was (or would be) saved.

status: EntryStatus

Final outcome.

bytes_total: Option<u64>

File size in bytes, if known after the download.

sha256: Option<String>

SHA-256 of the completed file, if computed.

expected_sha256: Option<String>

Expected SHA-256 supplied by the user, if any.

created_at: u64

Unix timestamp (seconds UTC) when the download was enqueued.

finished_at: Option<u64>

Unix timestamp (seconds UTC) when the download finished.

error: Option<String>

Error message for failed downloads.

Implementations

impl HistoryEntry

pub fn new(url: &str, output_dir: &str, expected_sha256: Option<&str>) -> Self

Create a new pending entry. Call DownloadHistory::record to finalise it with a status and optional error once the download is done.

pub fn created_at_display(&self) -> String

Human-readable UTC string for created_at (e.g. 2026-05-21 14:32 UTC).

pub fn finished_at_display(&self) -> Option<String>

Human-readable UTC string for finished_at, if set.

Trait Implementations

impl Clone for HistoryEntry

fn clone(&self) -> HistoryEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HistoryEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HistoryEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HistoryEntry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.