Enum SiteConfigError 

pub enum SiteConfigError {
    Read(PathBuf, Error),
    Parse(PathBuf, String),
    ZeroConcurrencyCeiling(PathBuf),
    UnusableRefuseMarker {
        path: PathBuf,
        marker: String,
    },
    MarkerRootUnresolved {
        path: PathBuf,
        root: PathBuf,
        cause: GitError,
    },
    MarkerUnreadable {
        path: PathBuf,
        marker: PathBuf,
        cause: Error,
    },
}

What went wrong loading the site policy file.

A separate enum from super::ConfigError, so the error’s type names which of the two files is at fault. Folding these into ConfigError::Io and ConfigError::Parse would make those variants reachable from two files with two different grammars, and a reader could no longer tell which grammar was violated from the variant alone.

Variants

Read(PathBuf, Error)

Parse(PathBuf, String)

ZeroConcurrencyCeiling(PathBuf)

The clamp runs after super::validate, so a ceiling of zero would slip past ConfigError::ZeroConcurrency and rebuild the hang it exists to prevent: a semaphore with no permits, waited on forever with no message. Rejected here so the clamp can never produce zero.

UnusableRefuseMarker

A marker that cannot name a file matches nothing, so the policy declaring it refuses nothing while reading as though it did.

Fields

path: PathBuf

marker: String

MarkerRootUnresolved

Fails closed. A policy naming markers cannot be evaluated outside a repository, and “cannot be evaluated” must not become “evaluates to allowed”: that is the unenforced policy reported as compliance which every message here refuses. cause rather than source because main.rs prints {err:#}, which would otherwise print it twice.

Fields

path: PathBuf

root: PathBuf

cause: GitError

MarkerUnreadable

Only NotFound means the marker is absent. Every other metadata error means the policy could not be evaluated and must fail closed.

Fields

path: PathBuf

marker: PathBuf

cause: Error

Trait Implementations

impl Debug for SiteConfigError

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

Formats the value using the given formatter.

impl Display for SiteConfigError

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

Formats the value using the given formatter.

impl Error for SiteConfigError

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.