Enum ServiceConfError 

pub enum ServiceConfError {
    Missing {
        name: String,
    },
    FileRead {
        name: String,
        path: String,
        source: Error,
    },
    Parse {
        name: String,
        type_name: String,
        message: String,
    },
}

Errors that can occur when loading configuration from environment variables.

This error type covers three main failure scenarios:

• Missing required environment variables
• File read failures when using the {VAR}_FILE pattern
• Type parsing failures during deserialization

Variants

Missing

Required environment variable is not set.

Occurs when a non-optional field’s environment variable is not found and no default value is specified.

Fields

name: String

Name of the missing environment variable

FileRead

Failed to read from a file specified by {VAR}_FILE environment variable.

When using #[conf(from_file)], this error occurs if the file path specified in {VAR}_FILE cannot be read (e.g., file doesn’t exist, permission denied).

Fields

name: String

Name of the {VAR}_FILE environment variable (e.g., “API_KEY_FILE”)

path: String

Path to the file that failed to be read

source: Error

Underlying I/O error that caused the failure

Parse

Failed to parse environment variable value into the target type.

Occurs when the string value cannot be converted to the field’s type, either via FromStr or a custom deserializer function.

Fields

name: String

Name of the environment variable being parsed

type_name: String

Fully qualified type name that parsing was attempted for

message: String

Error message from the parser (FromStr or custom deserializer)

Trait Implementations

impl Debug for ServiceConfError

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

Formats the value using the given formatter.

impl Display for ServiceConfError

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

Formats the value using the given formatter.

impl Error for ServiceConfError

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.