Enum InternalSchemaState 

pub enum InternalSchemaState {
    Unmigrated,
    TooOld {
        found: i32,
        required: i32,
    },
    Behind {
        found: i32,
        current: i32,
    },
    Current,
    Newer {
        found: i32,
        current: i32,
    },
}

How a database’s internal schema relates to the one this build expects.

The classification is deliberately separate from what any caller does about it: pylon-server refuses to start on TooOld while a client raises, and both merely note Behind, but the rule for which is which belongs in one place.

Variants

Unmigrated

No _pylon."Internal" row — a database no migration has ever run against. Legal, and not a mismatch: callers should behave exactly as they did before this check existed rather than treat it as an error.

TooOld

Older than MIN_SUPPORTED_INTERNAL_VERSION: this build cannot work against it. The only fix is pylon migration apply.

Fields

found: i32

required: i32

Behind

Behind this build but still within its supported range — an upgrade is pending and everything works meanwhile.

Fields

found: i32

current: i32

Current

Exactly what this build writes.

Newer

Written by a newer build. Reported, never fatal: this is what a rollback looks like, and failing closed would turn the recovery lever into a second outage.

Fields

found: i32

current: i32

Implementations

impl InternalSchemaState

pub fn is_fatal(&self) -> bool

Whether this build should refuse to proceed.

pub fn message(&self) -> Option<String>

A one-line explanation, or None when there is nothing to say.

Trait Implementations

impl Clone for InternalSchemaState

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for InternalSchemaState

impl Debug for InternalSchemaState

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

Formats the value using the given formatter.

impl Eq for InternalSchemaState

impl PartialEq for InternalSchemaState

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for InternalSchemaState