Enum Error 

pub enum Error {
    NotATracker {
        root: PathBuf,
        prefix: String,
    },
    IssueNotFound {
        id: String,
    },
    DuplicateId {
        id: String,
        paths: Vec<PathBuf>,
    },
    ClaimConflict {
        id: String,
        holder: String,
        claimed_at: Option<String>,
    },
    BlockerCycle {
        blocker: String,
        issue: String,
    },
    InvalidState {
        id: String,
        state: String,
    },
    StaleWrite {
        id: String,
        expected_state: Option<String>,
        actual_state: String,
        expected_gen: Option<u64>,
        actual_gen: Option<u64>,
    },
    TerminalConflict {
        id: String,
        held: String,
        attempted: String,
    },
    Other(Error),
}

Recoverable catalog and mutation failures with a stable shape.

Variants

NotATracker

The working directory was taken as the tracker root and holds no tracker, so an empty answer would be a wrong answer rather than a small one.

Fields

root: PathBuf

The directory that was taken as the root.

prefix: String

The project directory that was looked for inside it.

IssueNotFound

No heading in the corpus carries this id.

Fields

id: String

The id that was looked up.

DuplicateId

The same id exists under more than one distinct tracker layout.

Fields

id: String

The id that was found twice.

paths: Vec<PathBuf>

The issues.org files that define it.

ClaimConflict

Another identity already holds the issue.

Fields

id: String

The issue that is already claimed.

holder: String

Who holds it.

claimed_at: Option<String>

When the claim was stamped, if the heading recorded it.

BlockerCycle

The edge would close a loop in the blocker graph.

Fields

blocker: String

The prospective prerequisite.

issue: String

The issue that would wait on it.

InvalidState

The issue is in a state that cannot be claimed.

Fields

id: String

The issue that was refused.

state: String

The heading state at the time of the refusal.

StaleWrite

A write named a last-seen state or generation that no longer holds.

Fields

id: String

The issue that was refused.

expected_state: Option<String>

State the caller required, when --if-state was set.

actual_state: String

Heading state at the refusal.

expected_gen: Option<u64>

Generation the caller required, when --if-gen was set.

actual_gen: Option<u64>

Corpus generation at the refusal.

TerminalConflict

A second terminal disagrees with the one already on the heading.

Fields

id: String

The issue that already has a terminal state.

held: String

The terminal already written.

attempted: String

The terminal the caller asked for.

Other(Error)

Any other failure, usually I/O or a parse problem.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.