Enum SurfaceError 

pub enum SurfaceError {
    NoRegistry {
        reference: String,
    },
    NoSuchRef {
        reference: String,
        reason: String,
    },
    NothingPublished,
    Malformed {
        source: String,
        reason: String,
    },
}

Why a surface could not be read.

Each is a different fact, and collapsing them would make a check that cannot reach its subject indistinguishable from one that found nothing wrong:

use majordomus_cli::release::surface::SurfaceError;
let e = SurfaceError::NothingPublished;
assert!(e.to_string().contains("published nothing"));
let e = SurfaceError::NoRegistry { reference: "v0.1.0".into() };
assert!(e.to_string().contains("carries no"));

Variants

NoRegistry

The ref carries no committed registry projection, so its surface is unknowable.

Fields

reference: String

The ref that was asked.

NoSuchRef

The ref is not a commit in this repository, or git could not be run.

Fields

reference: String

The ref that was asked.

reason: String

What git said.

NothingPublished

The repository has published nothing at all, so there is no baseline to measure against. Distinct from a ref that cannot be resolved: nothing is missing from this clone, there is simply no release yet, and telling a first-time user to fetch tags that do not exist sends them looking for a fault that is not there.

Malformed

The registry was found but is not the document this reads.

Fields

source: String

Where it came from.

reason: String

What was wrong with it.

Trait Implementations

impl Clone for SurfaceError

fn clone(&self) -> SurfaceError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SurfaceError

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

Formats the value using the given formatter.

impl Display for SurfaceError

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

Formats the value using the given formatter.

impl Eq for SurfaceError

impl Error for SurfaceError

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 SurfaceError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for SurfaceError