Enum Error 

pub enum Error {
    Frontmatter(String),
    InvalidRecord(String),
    InvalidRemote(String),
    Io(Error),
    Json(Error),
    Yaml(Error),
    Other(String),
    InvalidOrigin(String),
    InvalidPath(String),
    Http(Error),
    NotFound {
        project: String,
        id: String,
    },
    NotSupported {
        operation: String,
    },
    VersionMismatch {
        current: String,
        requested: String,
        body: String,
    },
}

All errors that can flow across crate boundaries.

Variants

Frontmatter(String)

Frontmatter parsing or serialization failure.

InvalidRecord(String)

Record body / file format violation.

InvalidRemote(String)

Remote URL could not be parsed into a RemoteSpec.

Io(Error)

Underlying I/O error.

Json(Error)

JSON serialization error.

Yaml(Error)

YAML serialization error.

Other(String)

Untyped error escape hatch — only for cases where typing the error adds no value.

InvalidOrigin(String)

URL rejected by the egress allowlist (SG-01).

InvalidPath(String)

Path/filename rejected by the path validator (SG-04).

Http(Error)

Underlying HTTP/transport error from reqwest.

NotFound

The requested record does not exist on the backend.

Migrated from Error::Other(format!("not found: {context}")) — see code-quality audit P1-1 (POLISH2-09 partial). Display string retains the "not found:" prefix so existing substring-matching callers (e.g. reposix-swarm’s ErrorKind::classify) continue to classify correctly during the migration.

Fields

project: String

Project / space / repo slug the lookup targeted.

id: String

Record id (issue id, page id, etc.) that was not found.

NotSupported

The backend received the request but does not support the operation (e.g., a read-only connector being asked to update). Reserved for future migration of the read-only-backend disambiguator currently emitted as Error::Other("not supported: ...") by adapters such as reposix-jira (full migration scheduled for v0.12.0).

Fields

operation: String

Human-readable name of the unsupported operation.

VersionMismatch

Optimistic concurrency check failed: the caller’s version does not match the backend’s current version.

Migrated from Error::Other(format!("version mismatch: {body}")) — see code-quality audit P1-1 + P1-5 (POLISH2-09 partial). Closes the stringly-typed protocol where downstream callers used to recover the rejection body via msg.strip_prefix("version mismatch: ") plus serde_json::from_str — pattern-match on body instead.

Fields

current: String

Backend’s current version (as reported in the rejection body).

requested: String

Caller-supplied If-Match / expected_version value.

body: String

Full backend response body for callers that want to inspect the rejection (e.g., the simulator’s HTTP 409 JSON).

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, __formatter: &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(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.