Enum PocketIcStartupFailure 

#[non_exhaustive]
pub enum PocketIcStartupFailure {
    NotConfigured,
    InvalidEnvironment {
        variable: &'static str,
    },
    ServerVersionProbe {
        source: ToolError,
    },
    ServerVersionMismatch {
        expected: String,
        observed: Vec<u8>,
    },
    CommandRun {
        program: PathBuf,
        source: Error,
    },
    InvalidConfiguration {
        message: String,
    },
    InvalidServerUrl {
        server_url: String,
        message: String,
    },
    Io {
        operation: &'static str,
        path: PathBuf,
        source: Error,
    },
    ServerSpawn {
        server_binary: PathBuf,
        source: Error,
    },
    ServerExited {
        server_binary: PathBuf,
        status: ExitStatus,
        elapsed: Duration,
    },
    ReadinessTimeout {
        server_binary: PathBuf,
        timeout: Duration,
    },
    InvalidServerPort {
        server_binary: PathBuf,
        value: String,
    },
    InstanceCreationTimeout {
        timeout: Duration,
    },
    BuilderThreadSpawn {
        source: Error,
    },
    BuilderPanicked {
        message: String,
    },
    BuilderDisconnected,
    ServerCleanup {
        command_status: ExitStatus,
    },
}

Original failure, independent of output capture and cleanup outcomes.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotConfigured

Neither the shared server URL nor an explicit executable was configured.

InvalidEnvironment

A selected environment value was empty or was not valid Unicode.

Fields

variable: &'static str

ServerVersionProbe

The bounded version probe failed, including nonzero exit or timeout.

Fields

source: ToolError

ServerVersionMismatch

The selected executable does not report the qualified server identity.

Fields

expected: String

observed: Vec<u8>

CommandRun

Command execution failed.

Fields

program: PathBuf

source: Error

InvalidConfiguration

The caller supplied a zero timeout or unusable hard TTL.

Fields

message: String

InvalidServerUrl

A caller-provided existing server URL could not be parsed.

Fields

server_url: String

message: String

Io

Preparing or inspecting bounded startup files failed.

Fields

operation: &'static str

path: PathBuf

source: Error

ServerSpawn

The configured PocketIC server process could not be spawned.

Fields

server_binary: PathBuf

source: Error

ServerExited

The managed PocketIC server exited during construction or command execution.

Fields

server_binary: PathBuf

status: ExitStatus

elapsed: Duration

ReadinessTimeout

The managed server did not publish a usable port before the deadline.

Fields

server_binary: PathBuf

timeout: Duration

InvalidServerPort

The managed server published an invalid or oversized port-file value.

Fields

server_binary: PathBuf

value: String

InstanceCreationTimeout

PocketIC instance creation did not finish before the startup deadline.

Fields

timeout: Duration

BuilderThreadSpawn

Spawning the bounded builder worker failed.

Fields

source: Error

BuilderPanicked

Upstream PocketIC construction panicked before returning an instance.

Fields

message: String

BuilderDisconnected

The bounded builder worker ended without returning a result.

ServerCleanup

The command completed, but the owned server could not be cleaned up.

Fields

command_status: ExitStatus

Trait Implementations

impl Debug for PocketIcStartupFailure

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

Formats the value using the given formatter.

impl Display for PocketIcStartupFailure

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

Formats the value using the given formatter.

impl Error for PocketIcStartupFailure

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.