Enum ManifestSource 

pub enum ManifestSource {
    Url {
        url: String,
        sha256: Sha256Hex,
    },
    Path {
        path: Utf8PathBuf,
        sha256: Option<Sha256Hex>,
    },
}

Where the manifest comes from and how it is verified.

Variants

Url

Fetched from a permitted URL: https:// anywhere, or http:// to a loopback address. The digest is mandatory either way, because it is what makes the fetched bytes checkable and loopback does not supply that. See crate::extensions::is_permitted_url, which the fetch and the redirect policy both consult.

Fields

url: String

The URL of manifest.json.

sha256: Sha256Hex

Expected SHA-256 of the manifest bytes.

Path

Read from the filesystem; a local manifest is trusted like local source, so the digest is optional.

Fields

path: Utf8PathBuf

Path of manifest.json.

sha256: Option<Sha256Hex>

Expected SHA-256 of the manifest bytes, when pinned.

Implementations

impl ManifestSource

pub fn location(&self) -> String

Renders the location for error messages and logs.

A URL is redacted, because a consumer’s manifest URL can carry userinfo, a signed query parameter or a token in its fragment, and this string reaches log fields and error messages. A path is rendered as written.

Examples

use camino::Utf8PathBuf;
use pg_embedded_setup_unpriv::extensions::ManifestSource;

let path = ManifestSource::Path {
    path: Utf8PathBuf::from("/srv/extensions/manifest.json"),
    sha256: None,
};
assert_eq!(path.location(), "/srv/extensions/manifest.json");

Trait Implementations

impl Clone for ManifestSource

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ManifestSource

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

Formats the value using the given formatter.

impl Eq for ManifestSource

impl PartialEq for ManifestSource

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ManifestSource