Struct PgFetchSettings 

pub struct PgFetchSettings {
    pub host: String,
    pub operating_system: OperationSystem,
    pub architecture: Architecture,
    pub version: PostgresVersion,
}

Settings that determine which PostgreSQL binary package to download.

Construct with Default::default and override individual fields as needed:

use pg_embed::pg_fetch::{PgFetchSettings, PG_V17};

let settings = PgFetchSettings {
    version: PG_V17,
    ..Default::default()
};

The default target OS and architecture are detected at compile time via #[cfg(target_os)] / #[cfg(target_arch)].

Fields

host: String

Base URL of the Maven repository hosting the binaries.

Defaults to https://repo1.maven.org. Override to point at a local mirror or artifact proxy.

operating_system: OperationSystem

Target operating system. Determines the package classifier used in the Maven artifact name.

architecture: Architecture

Target CPU architecture. Combined with Self::operating_system to form the Maven classifier.

version: PostgresVersion

PostgreSQL version to download. Use one of the PG_Vxx constants.

Implementations

impl PgFetchSettings

pub fn platform(&self) -> String

Returns the Maven classifier string for this OS/architecture combination.

The classifier is the middle segment of the artifact name, e.g. linux-amd64 or darwin-amd64. For Alpine Linux the architecture gets an -alpine suffix instead of a separate OS segment.

Returns

A String of the form {os}-{arch} (or {os}-{arch}-alpine for OperationSystem::AlpineLinux).

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

Downloads the PostgreSQL binaries JAR from Maven Central.

Constructs the full artifact URL from Self::host, Self::platform, and Self::version, performs an HTTP GET, and returns the raw bytes of the JAR file. The caller is responsible for persisting and unpacking the data (see crate::pg_unpack::unpack_postgres).

Prefer Self::fetch_postgres_to_file when the bytes will be written to disk — it streams directly without buffering the entire archive in memory.

Returns

The raw bytes of the downloaded JAR on success.

Errors

Returns Error::DownloadFailure if the HTTP request fails or the server returns a non-2xx status (e.g. 404 when the requested PostgreSQL version is not available for the current platform). Returns Error::ConversionFailure if reading the response body fails.

Trait Implementations

impl Clone for PgFetchSettings

fn clone(&self) -> PgFetchSettings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PgFetchSettings

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

Formats the value using the given formatter.

impl Default for PgFetchSettings

fn default() -> Self

Returns the “default value” for a type.