Enum VcsError 

pub enum VcsError {
    SnapshotAlreadyExists(SnapshotId),
    SnapshotNotFound(SnapshotId),
    BranchNotFound {
        namespace: String,
        name: String,
    },
    NonFastForward {
        local_head: SnapshotId,
        remote_head: SnapshotId,
    },
    RemoteUnreachable {
        url: String,
        cause: String,
    },
    AuthFailed {
        url: String,
    },
    HashMismatch {
        expected: SnapshotId,
        actual: SnapshotId,
    },
    MergeRequired,
    UncommittedChanges {
        count: usize,
    },
    MergeNotImplemented,
    InvalidSnapshotId(String),
    InvalidBranchName(String),
    Storage(String),
    Json(Error),
    Io(Error),
    Internal(String),
}

Variants

SnapshotAlreadyExists(SnapshotId)

A snapshot with this ID already exists in the database. This should only occur on SHA-256 hash collision (computationally infeasible) or if commit() is called twice with identical namespace state.

SnapshotNotFound(SnapshotId)

The requested snapshot archive is not in the local database. Callers must pull from a remote to fetch it.

BranchNotFound

No branch with this name in the namespace.

Fields

namespace: String

name: String

NonFastForward

The remote branch HEAD is not an ancestor of the local HEAD. Caller must pull, merge, commit, then push.

Fields

local_head: SnapshotId

remote_head: SnapshotId

RemoteUnreachable

The remote khive-sync server could not be reached.

Fields

url: String

cause: String

AuthFailed

The remote rejected the request due to authentication failure.

Fields

url: String

HashMismatch

The archive stored at the remote has a different hash than expected. Indicates corruption or tampering.

Fields

expected: SnapshotId

actual: SnapshotId

MergeRequired

The remote has diverged from local history; a merge is required.

UncommittedChanges

checkout was blocked because there are uncommitted changes. Pass force: true to discard them.

Fields

count: usize

MergeNotImplemented

merge_branch was called but no MergeEngine has been registered. Ships as the default until khive-merge is linked.

InvalidSnapshotId(String)

A SnapshotId string failed validation.

InvalidBranchName(String)

A branch name failed validation (must match ^[a-zA-Z0-9_-]{1,64}$).

Storage(String)

An underlying storage operation failed.

Json(Error)

JSON serialization or deserialization failed.

Io(Error)

An I/O operation failed (file system, network).

Internal(String)

An unexpected internal error.

Trait Implementations

impl Debug for VcsError

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

Formats the value using the given formatter.

impl Display for VcsError

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

Formats the value using the given formatter.

impl Error for VcsError

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 VcsError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for VcsError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<RuntimeError> for VcsError

fn from(e: RuntimeError) -> Self

Converts to this type from the input type.