Enum NormalizeError 

#[non_exhaustive]
pub enum NormalizeError {
    MissingName,
    InvalidName(String),
    MissingScript,
    ZeroInstances,
    InvalidCron {
        pattern: String,
        reason: String,
    },
    InvalidTimezone {
        name: String,
    },
    DuplicateName(String),
    InvalidProbe {
        probe: &'static str,
        reason: String,
    },
    ZeroFailureThreshold {
        probe: &'static str,
    },
    IntervalBelowMinimum {
        probe: &'static str,
        value: UpDuration,
        min: UpDuration,
    },
    ZeroMaxMemory {
        name: String,
    },
    ActionTimeoutTooLong {
        name: String,
        value: UpDuration,
        max: UpDuration,
    },
    InvalidKillSignal {
        name: String,
        value: String,
    },
    WatchWithoutCwd {
        name: String,
    },
    TildeUser {
        name: String,
        field: &'static str,
        value: String,
    },
    NoHomeForTilde {
        name: String,
        field: &'static str,
    },
    ZeroWatchDelay {
        name: String,
    },
    InvalidWatchGlob {
        name: String,
        field: &'static str,
        pattern: String,
        reason: String,
    },
}

Error type returned from normalize and normalize_all

Growth is expected: every config surface this crate learns to validate brings its own rejection reasons with it (IR-20).

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.

MissingName

name is empty

InvalidName(String)

name contains / or \ or is ./.. — it becomes a filesystem path stem, so these would escape the shep home (carries the name)

MissingScript

script is empty

ZeroInstances

instances is zero

InvalidCron

cron_restart is not valid in croner’s dialect. Carries the pattern and the rejection reason — croner’s own sentence where croner did the rejecting, ours where shep’s pre-parse pass did.

Fields

pattern: String

The pattern as the user wrote it

reason: String

Why it was rejected

InvalidTimezone

cron_timezone is not a name in the IANA time-zone database

Fields

name: String

The value as the user wrote it

DuplicateName(String)

Two apps in one flock share this name

InvalidProbe

A readiness_probe or liveness_probe target is malformed. Carries which probe and the rendered reason.

Fields

probe: &'static str

"readiness_probe" or "liveness_probe" — the Flockfile field name, so the error names the line the user has to edit.

reason: String

ProbeTarget::parse’s rendered rejection reason.

ZeroFailureThreshold

A readiness_probe or liveness_probe has failure_threshold == 0.

Fields

probe: &'static str

"readiness_probe" or "liveness_probe" — the Flockfile field name, so the error names the line the user has to edit.

IntervalBelowMinimum

A readiness_probe or liveness_probe has an interval under the floor its own loop in the daemon honours. At 0 that would spin the loop as fast as the runtime allows; a liveness_probe under a full second would instead be silently polled at that second.

Fields

probe: &'static str

"readiness_probe" or "liveness_probe" — the Flockfile field name, so the error names the line the user has to edit.

value: UpDuration

The value as the user wrote it.

min: UpDuration

The floor it failed.

ZeroMaxMemory

max_memory is 0 — a ceiling every live process is already over, so the enforcer would restart the sheep on every poll forever. Carries the app name.

Fields

name: String

The sheep name, so the error names which Flockfile entry to edit.

ActionTimeoutTooLong

action_timeout is at or above normalize’s own ceiling — a wait no RPC caller could ever be given enough deadline to outlast, since the daemon clamps every deadline a caller can ask for. Carries the app name, the value as written, and the ceiling it failed.

Fields

name: String

The sheep name, so the error names which Flockfile entry to edit.

value: UpDuration

The value as the user wrote it.

max: UpDuration

The ceiling it failed.

InvalidKillSignal

kill_signal names a signal the daemon’s stop ladder cannot send. Carries the app name and the value as written.

Fields

name: String

The sheep name, so the error names which Flockfile entry to edit.

value: String

The value as the user wrote it.

WatchWithoutCwd

watch is enabled but the app sets no cwd, so there is no directory to watch. Carries the app name.

Fields

name: String

The sheep name, so the error names which Flockfile entry to edit.

TildeUser

A path begins ~user/, naming another user’s home.

Refused rather than resolved: answering it means a passwd lookup, and under a systemd unit the answer is not obviously the one anyone meant. ~/ is supported; this is not.

Fields

name: String

The sheep name, so the error names which Flockfile entry to edit.

field: &'static str

Which field carried it.

value: String

The path as written.

NoHomeForTilde

A path begins ~/ and no home directory could be determined.

Fields

name: String

The sheep name, so the error names which Flockfile entry to edit.

field: &'static str

Which field carried it.

ZeroWatchDelay

watch_delay is 0, which would spin the debouncer’s own OS thread. Carries the app name.

Fields

name: String

The sheep name, so the error names which Flockfile entry to edit.

InvalidWatchGlob

A watch_options or ignore_watch pattern is one globset will not compile, so the watch it describes could never be armed.

Fields

name: String

The sheep name, so the error names which Flockfile entry to edit.

field: &'static str

"watch_options" or "ignore_watch" — the Flockfile field name, so the error names which of the two lists to edit.

pattern: String

The pattern as the user wrote it.

reason: String

globset’s own rendered reason.

Trait Implementations

impl Clone for NormalizeError

fn clone(&self) -> NormalizeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NormalizeError

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

Formats the value using the given formatter.

impl Display for NormalizeError

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

Formats the value using the given formatter.

impl Eq for NormalizeError

impl Error for NormalizeError

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 NormalizeError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for NormalizeError