Struct tough::schema::Snapshot

pub struct Snapshot {
    pub spec_version: String,
    pub version: NonZeroU64,
    pub expires: DateTime<Utc>,
    pub meta: HashMap<String, SnapshotMeta>,
    pub _extra: HashMap<String, Value>,
}

TUF 4.4 The snapshot.json file is signed by the snapshot role. It MUST list the version numbers of the top-level targets metadata and all delegated targets metadata. It MAY also list their lengths and file hashes.

Fields

spec_version: String

A string that contains the version number of the TUF specification. Its format follows the Semantic Versioning 2.0.0 (semver) specification.

version: NonZeroU64

An integer that is greater than 0. Clients MUST NOT replace a metadata file with a version number less than the one currently trusted.

expires: DateTime<Utc>

Determines when metadata should be considered expired and no longer trusted by clients.

meta: HashMap<String, SnapshotMeta>

A list of what the TUF spec calls 'METAFILES' (SnapshotMeta objects). The TUF spec describes the hash key in 4.4: METAPATH is the file path of the metadata on the repository relative to the metadata base URL. For snapshot.json, these are top-level targets metadata and delegated targets metadata.

_extra: HashMap<String, Value>

Extra arguments found during deserialization.

We must store these to correctly verify signatures for this object.

If you're instantiating this struct, you should make this HashMap::empty().

Implementations

impl Snapshot

pub fn new(
    spec_version: String,
    version: NonZeroU64,
    expires: DateTime<Utc>
) -> Self

Create a new Snapshot object.

Trait Implementations

impl Clone for Snapshot

pub fn clone(&self) -> Snapshot

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Snapshot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Snapshot

pub fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl PartialEq<Snapshot> for Snapshot

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Role for Snapshot

pub const TYPE: RoleType

The type of role this object represents.

pub fn expires(&self) -> DateTime<Utc>

Determines when metadata should be considered expired and no longer trusted by clients.

pub fn version(&self) -> NonZeroU64

An integer that is greater than 0. Clients MUST NOT replace a metadata file with a version number less than the one currently trusted.

pub fn filename(&self, consistent_snapshot: bool) -> String

The filename that the role metadata should be written to

pub fn role_id(&self) -> RoleId

The RoleId corresponding to the role

pub fn canonical_form(&self) -> Result<Vec<u8>>

A deterministic JSON serialization used when calculating the digest of a metadata object. More info on canonical JSON

impl Serialize for Snapshot

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

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Snapshot