Struct cacache::Integrity

impl Integrity

pub fn pick_algorithm(&self) -> Algorithm

Pick the most secure available Algorithm in this Integrity.

Example

use ssri::{Integrity, Algorithm};

let sri: Integrity = "sha1-deadbeef sha256-badc0ffee".parse().unwrap();
let algorithm = sri.pick_algorithm();
assert_eq!(algorithm, Algorithm::Sha256);

pub fn from(data: B) -> Integritywhere B: AsRef<[u8]>,

Create a new Integrity based on data. Use IntegrityOpts for more options.

Example

use ssri::Integrity;
let sri = Integrity::from(b"hello");
assert_eq!(sri.to_string(), "sha256-LPJNul+wow4m6DsqxbninhsWHlwfp0JecwQzYpOLmCQ=".to_owned());

pub fn from_hex(hex: B, algorithm: Algorithm) -> Result<Integrity, Error>where B: AsRef<[u8]>,

Converts a hex string obtained from to_hex() to an Integrity with a Hash containing algorithm and decoded hex string.

Example

 use ssri::{Integrity, Algorithm};

 let expected = Integrity::from(b"hello");
 let hex = String::from("2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824");
 assert_eq!(Integrity::from_hex(hex, Algorithm::Sha256).unwrap(), expected);

pub fn concat(&self, other: Integrity) -> Integrity

Join together two Integrity instances. Hashes will be grouped and sorted by algorithm but otherwise kept in the same order.

Example

use ssri::Integrity;
let sri1: Integrity = "sha256-deadbeef".parse().unwrap();
let sri2: Integrity = "sha256-badc0ffee".parse().unwrap();
let sri3 = sri1.concat(sri2);
assert_eq!(sri3.to_string(), "sha256-deadbeef sha256-badc0ffee".to_owned());

pub fn check(&self, data: B) -> Result<Algorithm, Error>where B: AsRef<[u8]>,

Check some data against this Integrity. For more options, use Checker.

Example

use ssri::{Algorithm, Integrity};

let sri = Integrity::from(b"hello");
let algorithm = sri.check(b"hello").unwrap();
assert_eq!(algorithm, Algorithm::Sha256);

pub fn to_hex(&self) -> (Algorithm, String)

Converts the first Hash in this Integrity into its hex string format.

Example

use ssri::{Algorithm, Integrity};

let sri = Integrity::from(b"hello");
let (algo, hex) = sri.to_hex();
assert_eq!(algo, Algorithm::Sha256);
assert_eq!(hex, "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824".to_owned());

pub fn matches(&self, other: &Integrity) -> Option<Algorithm>

Compares self against a given SRI to see if there’s a match. The deciding algorithm is determined by other.

Example

use ssri::{Algorithm, Integrity};

let sri1 = Integrity::from(b"hello");
let sri2 = Integrity::from(b"hello").concat(Integrity::from(b"world"));
let m = sri1.matches(&sri2);
assert_eq!(m, Some(Algorithm::Sha256));

Trait Implementations§

impl Clone for Integrity

fn clone(&self) -> Integrity

Returns a copy of the value. Read more

1.0.0 · source§

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

Performs copy-assignment from source. Read more

impl Debug for Integrity

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

Formats the value using the given formatter. Read more

impl<'de> Deserialize<'de> for Integrity

fn deserialize<D>( deserializer: D ) -> Result<Integrity, <D as Deserializer<'de>>::Error>where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

impl Display for Integrity

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

Formats the value using the given formatter. Read more

impl FromStr for Integrity

fn from_str(s: &str) -> Result<Integrity, <Integrity as FromStr>::Err>

Parses a string into an Integrity instance.

Example

use ssri::Integrity;
let sri: Integrity = "sha256-deadbeef".parse().unwrap();
assert_eq!(sri.to_string(), String::from("sha256-deadbeef"));

type Err = Error

The associated error which can be returned from parsing.

impl Hash for Integrity

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

Feeds this value into the given Hasher. Read more

1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more

impl PartialEq<Integrity> for Integrity

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

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

1.0.0 · source§

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

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

impl Serialize for Integrity

fn serialize<S>( &self, serializer: S ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where S: Serializer,

Serialize this value into the given Serde serializer. Read more

impl Eq for Integrity

impl StructuralEq for Integrity

impl StructuralPartialEq for Integrity

Auto Trait Implementations§

impl UnwindSafe for Integrity

Blanket Implementations§

impl<T> Any for Twhere T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for Twhere T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for Twhere T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into for Twhere U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> Same<T> for T

type Output = T

Should always be Self

impl<T> ToOwned for Twhere T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> ToString for Twhere T: Display + ?Sized,

default fn to_string(&self) -> String

Converts the given value to a String. Read more

impl<T, U> TryFrom for Twhere U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

impl<T, U> TryInto for Twhere U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.