Struct ExtensionRequest 

pub struct ExtensionRequest {
    pub names: Vec<ExtensionName>,
    pub manifest: ManifestSource,
    pub cache_dir: Utf8PathBuf,
}

A validated declaration of which extensions to install and from where.

Fields

names: Vec<ExtensionName>

Extension names in declaration order, deduplicated.

manifest: ManifestSource

Manifest location and pin.

cache_dir: Utf8PathBuf

Directory holding verified archives between runs.

Implementations

impl ExtensionRequest

pub fn from_config(cfg: &PgEnvCfg) -> BootstrapResult<Option<Self>>

Builds a request from the PG_EXTENSIONS* variables captured in cfg.

Returns Ok(None) when PG_EXTENSIONS is unset, empty or whitespace, so the hook stays inert for consumers that do not declare extensions.

Errors

Returns ExtensionConfigInvalid when names are declared without a manifest, when a URL manifest has no digest, or when a name or digest is malformed. Every URL manifest needs one, loopback http:// included: the digest is what makes the fetched bytes checkable, and loopback does not supply that.

Examples

use pg_embedded_setup_unpriv::{PgEnvCfg, extensions::ExtensionRequest};

let cfg = PgEnvCfg {
    extensions: Some("vector, vector".into()),
    extensions_manifest: Some("/srv/extensions/manifest.json".into()),
    ..PgEnvCfg::default()
};
let request = ExtensionRequest::from_config(&cfg)?.expect("names were declared");
assert_eq!(request.names.len(), 1, "duplicates collapse in order");

Trait Implementations

impl Clone for ExtensionRequest

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 ExtensionRequest

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

Formats the value using the given formatter.

impl Eq for ExtensionRequest

impl PartialEq for ExtensionRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ExtensionRequest