Struct DownloadId 

pub struct DownloadId(/* private fields */);

Unique identifier for a download

Implementations

impl DownloadId

pub fn new() -> Self

Create a new random download ID

pub fn from_uuid(uuid: Uuid) -> Self

Create from an existing UUID

pub fn as_uuid(&self) -> &Uuid

Get the underlying UUID

pub fn to_gid(&self) -> String

Generate an aria2-compatible GID (16-char hex string).

This is a lossy projection: only the first 8 bytes of the 16-byte UUID are encoded, so the upper 8 bytes are discarded. Two distinct DownloadId values that share the same first 8 bytes will produce the same GID.

Use matches_gid to check whether a given GID corresponds to this DownloadId without assuming a lossless round-trip.

pub fn from_gid(gid: &str) -> Option<Self>

Create a new DownloadId from an aria2-compatible GID string.

Because a GID only carries 8 bytes of the original 16-byte UUID, the returned DownloadId is not equal to whichever DownloadId originally produced the GID (the upper 8 bytes are zero-filled). In other words, DownloadId::from_gid(id.to_gid()) != id in the general case.

If you need to test whether an existing DownloadId matches a GID, use matches_gid instead.

pub fn matches_gid(&self, gid: &str) -> bool

Check whether this DownloadId’s first 8 bytes match the given GID.

This is the correct way to look up a DownloadId by GID without relying on the lossy from_gid round-trip. It compares only the bytes that to_gid encodes, so it works even when the upper 8 bytes of two DownloadId values differ.

Trait Implementations

impl Clone for DownloadId

fn clone(&self) -> DownloadId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DownloadId

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

Formats the value using the given formatter.

impl Default for DownloadId

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DownloadId

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for DownloadId

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

Formats the value using the given formatter.

impl Hash for DownloadId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for DownloadId

fn eq(&self, other: &DownloadId) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for DownloadId

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for DownloadId

impl Eq for DownloadId

impl StructuralPartialEq for DownloadId