Enum SriAlgorithm 

pub enum SriAlgorithm {
    Sha256,
    Sha384,
    Sha512,
}

Digest algorithm used for Subresource Integrity integrity= attributes on externalized assets (v0.0.47 plan §3 item 2.3).

Applies to the SRI attributes emitted by the fingerprint plugin (crate::assets::FingerprintPlugin) and the CSP inline-extraction plugin (crate::csp::CspPlugin). It deliberately does not govern CSP directive source hashes (the 'sha256-…' entries inside a Content-Security-Policy header/meta value) — those stay SHA-256 for the broadest UA compatibility.

Serialized in ssg.toml as the lowercase strings "sha256", "sha384", and "sha512"; kept in lockstep with the security.sri_algorithm enum in ssg.schema.json.

Examples

use ssg::cmd::SriAlgorithm;

// SHA-384 is the default, matching the documented posture.
assert_eq!(SriAlgorithm::default(), SriAlgorithm::Sha384);

// Every emitted integrity value starts with the algorithm prefix.
let sri = SriAlgorithm::Sha512.integrity(b"body{margin:0}");
assert!(sri.starts_with("sha512-"));

Variants

Sha256

SHA-256 — the pre-v0.0.47 behaviour, kept for back-compat.

Sha384

SHA-384 — the default; matches the README/SECURITY.md claim.

Sha512

SHA-512 — the strongest digest the SRI spec admits.

Implementations

impl SriAlgorithm

pub const fn prefix(self) -> &'static str

Returns the SRI prefix token for this algorithm ("sha256", "sha384", or "sha512").

Examples

use ssg::cmd::SriAlgorithm;

assert_eq!(SriAlgorithm::default().prefix(), "sha384");
assert_eq!(SriAlgorithm::Sha256.prefix(), "sha256");

pub fn integrity(self, data: &[u8]) -> String

Computes the full SRI attribute value for data: <prefix>-<base64(digest(data))>.

Browsers compare the integrity attribute against base64(digest(body)) per the W3C SRI spec, so the returned string is exactly what a UA will validate the response body against.

Examples

use ssg::cmd::SriAlgorithm;

// SHA-384("") — well-known empty-input digest.
assert_eq!(
    SriAlgorithm::Sha384.integrity(b""),
    "sha384-OLBgp1GsljhM2TJ+sbHjaiH9txEUvgdDTAzHv2P24donTt6/529l+9Ua0vFImLlb"
);

Trait Implementations

impl Clone for SriAlgorithm

fn clone(&self) -> SriAlgorithm

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SriAlgorithm

impl Debug for SriAlgorithm

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

Formats the value using the given formatter.

impl Default for SriAlgorithm

fn default() -> SriAlgorithm

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SriAlgorithm

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SriAlgorithm

impl PartialEq for SriAlgorithm

fn eq(&self, other: &SriAlgorithm) -> 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 SriAlgorithm

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 SriAlgorithm