Enum Error 

pub enum Error {
    InvalidPgUrl,
    InvalidPgPackage,
    WriteFileError(String),
    ReadFileError(String),
    DirCreationError(String),
    UnpackFailure,
    PgStartFailure,
    PgStopFailure,
    PgInitFailure,
    PgCleanUpFailure(String),
    PgPurgeFailure(String),
    PgBufferReadError,
    PgLockError,
    PgProcessError,
    PgTimedOutError,
    PgTaskJoinError(String),
    PgError(String, String),
    DownloadFailure(String),
    ConversionFailure(String),
    SendFailure,
    SqlQueryError(String),
    MigrationError(String),
}

All errors that pg-embed can produce.

Every variant maps to a distinct failure mode in the library. Variants that carry a String field contain a human-readable message from the underlying OS or library call that caused the failure; this is always the .to_string() of the original error.

Variants

InvalidPgUrl

The download URL for PostgreSQL binaries could not be constructed.

Typically caused by the OS cache directory being unavailable or an unsupported platform combination.

InvalidPgPackage

The downloaded file is not a valid PostgreSQL binaries package.

Raised when the ZIP archive cannot be opened or does not contain the expected .xz-compressed tarball.

WriteFileError(String)

A file write operation failed.

The inner string is the OS error message (e.g. Permission denied).

ReadFileError(String)

A file read or existence-check operation failed.

The inner string is the OS error message.

DirCreationError(String)

A directory could not be created.

The inner string is the OS error message.

UnpackFailure

XZ decompression or tar extraction of the PostgreSQL binaries failed.

PgStartFailure

pg_ctl start exited with a non-zero status.

PgStopFailure

pg_ctl stop exited with a non-zero status.

PgInitFailure

initdb exited with a non-zero status.

PgCleanUpFailure(String)

Removal of the database directory or password file failed.

The inner string is the OS error message.

PgPurgeFailure(String)

Removal of the cached binaries directory failed.

The inner string is the OS error message.

PgBufferReadError

A buffered I/O read from a process stream failed unexpectedly.

PgLockError

A mutex or async lock could not be acquired.

PgProcessError

Spawning or waiting on a child process failed.

PgTimedOutError

A pg_ctl or initdb call exceeded its configured timeout.

See crate::postgres::PgSettings::timeout.

PgTaskJoinError(String)

A tokio::task::spawn_blocking join failed.

The inner string is the tokio::task::JoinError message.

PgError(String, String)

A generic error wrapper used internally to attach context.

The first field is the original error message; the second is a human-readable context string (e.g. "spawn_blocking join error").

DownloadFailure(String)

The HTTP download of the PostgreSQL binaries JAR failed.

The inner string is the reqwest error message.

ConversionFailure(String)

Converting the HTTP response body to bytes failed.

The inner string is the reqwest error message.

SendFailure

An internal MPSC channel send failed because the receiver was dropped.

SqlQueryError(String)

A sqlx query or connection operation failed.

The inner string is the sqlx error message. Only produced when the rt_tokio_migrate feature is enabled.

MigrationError(String)

Running sqlx migrations failed.

The inner string is the sqlx migrator error message. Only produced when the rt_tokio_migrate feature is enabled.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for Error

fn eq(&self, other: &Error) -> 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 ProcessStatus<PgServerStatus, Error> for PgProcessType

fn status_entry(&self) -> PgServerStatus

Returns the status value that signals the process has entered execution.

fn status_exit(&self) -> PgServerStatus

Returns the status value that signals the process exited successfully.

fn error_type(&self) -> Error

Returns the error value for a generic process failure (non-zero exit, spawn error, etc.).

fn timeout_error(&self) -> Error

Returns the error value to use when the process exceeds its timeout.

fn wrap_error<E: Error + Sync + Send + 'static>( &self, error: E, message: Option<String>, ) -> Error

Wraps a foreign error F (e.g. an OS I/O error) into E, optionally attaching a context message.

impl StructuralPartialEq for Error