Enum ConfigIssueKind 

pub enum ConfigIssueKind {
    UnknownKey {
        suggestion: String,
    },
    InvalidValue {
        value: String,
        expected: Vec<String>,
    },
    SpanningNotSingleParent {
        inverse: String,
    },
    NestNotSingleValued {
        field: String,
    },
    MalformedWorkspaceId {
        value: String,
    },
    MalformedRoot {
        value: String,
    },
}

The two ways a config key goes unread. See ConfigIssue.

Variants

UnknownKey

key is not a recognized axis but closely resembles suggestion — almost certainly a misspelling. An unrecognized key that resembles no axis at its level is deliberately not reported: a config surface can carry user-owned fields prov never reads (DESIGN §2), so flagging every unknown key would be noise.

Fields

suggestion: String

InvalidValue

key is a recognized axis but value is not a spelling prov understands, so apply kept the default. expected lists the accepted spellings (advisory help; mirrors the axis’s parser).

Fields

value: String

expected: Vec<String>

SpanningNotSingleParent

The spanning relation’s declared inverse is a relation whose cardinality is many, which cannot form the single-parent containment tree the spanning relation requires (DESIGN §3). key is spanning; inverse is the offending child→parent relation.

Fields

inverse: String

NestNotSingleValued

A view declares nest: but groups by a field the workspace declares multi-valued (fields.<field>.type: seq).

Nesting files a record into the single-parent spanning relation, so a document carrying two values for field has two homes and nothing can choose between them. The grouping is fine — one document under several groups is what a view is for — so only the filing half is reported.

Fields

field: String

MalformedWorkspaceId

workspace_id holds a name that cannot be written as the qualifier of an id:<workspace>/<id> reference — it contains /, : or whitespace, or is not a string at all. apply ignored it, so the workspace stayed anonymous.

An empty value is not this: it is the explicit spelling of anonymous, the way an empty updated spells that feature off.

Unlike InvalidValue there is no list of accepted spellings to offer: the name is the user’s to choose and only its shape is constrained.

Fields

value: String

MalformedRoot

root holds something that is not a bare file name in the node’s own directory — it contains a separator, is a relative segment, or is not a string at all. apply ignored it, so the root is chosen by the candidate scan as though the key were absent.

Like MalformedWorkspaceId and unlike InvalidValue there is no list of accepted spellings: the name is the user’s to choose and only its shape is fixed.

Fields

value: String

Trait Implementations

impl Clone for ConfigIssueKind

fn clone(&self) -> ConfigIssueKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigIssueKind

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

Formats the value using the given formatter.

impl Eq for ConfigIssueKind

impl PartialEq for ConfigIssueKind

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ConfigIssueKind