Enum GroupConfigError 

pub enum GroupConfigError {
    Io(Error),
    Parse(Error),
    RedefinedBuiltin {
        name: String,
    },
    DuplicateName {
        name: String,
    },
    InvalidCapability {
        group: String,
        cap: String,
        reason: CapabilityGrammarError,
    },
    UnsafeUniversalGrant {
        group: String,
    },
    UnknownGroup {
        name: String,
    },
}

Errors raised when loading or validating a GroupConfig.

Variants

Io(Error)

Filesystem IO failed while reading groups.toml.

Parse(Error)

groups.toml failed to parse as TOML, or contains unknown fields.

RedefinedBuiltin

A group entry attempts to redefine a reserved built-in group name.

Fields

name: String

Name of the built-in group the config tried to overwrite.

DuplicateName

Two different group entries share the same name.

Note: the TOML parser itself rejects duplicate keys in a single table, but this variant covers the future case where multiple sources are merged.

Fields

name: String

Duplicated group name.

InvalidCapability

A group entry contains a capability that fails the grammar validator.

Fields

group: String

Name of the offending group.

cap: String

Raw capability string that failed validation.

reason: CapabilityGrammarError

Underlying grammar error.

UnsafeUniversalGrant

A custom group grants the universal * capability without opting in to the unsafe_admin flag.

Fields

group: String

Name of the offending custom group.

UnknownGroup

A runtime admin mutation targets a group name that does not exist in the current config. Returned by GroupConfig::modify_custom_group and GroupConfig::remove_group.

Fields

name: String

Name of the group that could not be located.

Trait Implementations

impl Debug for GroupConfigError

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

Formats the value using the given formatter.

impl Display for GroupConfigError

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

Formats the value using the given formatter.

impl Error for GroupConfigError

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 From<Error> for GroupConfigError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GroupConfigError

fn from(source: Error) -> Self

Converts to this type from the input type.