Enum HeddleError 

pub enum HeddleError {
    Recovery(Box<RecoveryDetails>),
    NotFound(String),
    NoMergeInProgress,
    NoChanges,
    StateNotFound(StateId),
    InvalidObject(String),
    RepositoryNotFound(PathBuf),
    RepositoryExists(PathBuf),
    IncompleteClone(PathBuf),
    UntrustedRepository {
        root: PathBuf,
        reason: UntrustedRepositoryReason,
    },
    RepositoryFormatTooNew {
        path: PathBuf,
        found: u32,
        supported: u32,
    },
    RepositoryFormatTooOld {
        path: PathBuf,
        found: u32,
        required: u32,
    },
    StorageFormatTooNew {
        storage: String,
        found: u32,
        supported: u32,
    },
    StorageFormatTooOld {
        storage: String,
        found: u32,
        required: u32,
    },
    Io(Error),
    Lock(LockError),
    Serialization(String),
    Config(String),
    NativeSourceSignerUnavailable {
        thread: String,
        reason: String,
    },
    ConfigParse {
        path: PathBuf,
        source: Error,
    },
    ConfigInvalidValue {
        path: PathBuf,
        key: String,
        value: String,
        valid_values: Vec<String>,
    },
    Conflict(String),
    Compression(String),
    InvalidRefName(String),
    InvalidFileSize(u64),
    Corruption {
        expected: ContentHash,
        found: ContentHash,
    },
    MissingObject {
        object_type: String,
        id: String,
    },
    InvalidTreeEntry(TreeError),
    TreeStream(TreeStreamError),
    RedactedTree(String),
    ReservedWorktreePath {
        path: PathBuf,
        reason: ReservedPathComponent,
    },
}

Error type for repository/storage-adjacent operations.

Variants

Recovery(Box<RecoveryDetails>)

NotFound(String)

NoMergeInProgress

NoChanges

StateNotFound(StateId)

InvalidObject(String)

RepositoryNotFound(PathBuf)

RepositoryExists(PathBuf)

IncompleteClone(PathBuf)

UntrustedRepository

Discovery found repository metadata the user never vouched for: it lies inside another Heddle repository’s worktree (so it may be checked-out content), or another user owns it. Opening it would let its config, hooks, and store pointer act on this user’s behalf.

Fields

root: PathBuf

reason: UntrustedRepositoryReason

RepositoryFormatTooNew

Fields

path: PathBuf

found: u32

supported: u32

RepositoryFormatTooOld

Fields

path: PathBuf

found: u32

required: u32

StorageFormatTooNew

Fields

storage: String

found: u32

supported: u32

StorageFormatTooOld

Fields

storage: String

found: u32

required: u32

Io(Error)

Lock(LockError)

Serialization(String)

Config(String)

NativeSourceSignerUnavailable

A checkout attached to a native Thread cannot sign a source operation with that Thread’s owner key, so capture fails closed. Distinct from Self::Config so callers can tell “no signer” from any other refusal.

Fields

thread: String

reason: String

ConfigParse

Fields

path: PathBuf

source: Error

ConfigInvalidValue

Fields

path: PathBuf

key: String

value: String

valid_values: Vec<String>

Conflict(String)

Compression(String)

InvalidRefName(String)

InvalidFileSize(u64)

Corruption

Fields

expected: ContentHash

found: ContentHash

MissingObject

Fields

object_type: String

id: String

InvalidTreeEntry(TreeError)

TreeStream(TreeStreamError)

RedactedTree(String)

A redacted-tree (HRT1) projection was encountered where a full, materializable tree is required — e.g. asked to store, pack, or read an HRT1 body as a Tree, or capture over a PartialTree whose withheld leaves cannot be re-authored. This is a distinct, fail-loud signal (v4 redactable trees, Fable F): the wire-status mapping is handled by the weft serve leg, but the heddle side must never silently drop the withheld leaves.

ReservedWorktreePath

A worktree write would create a path through a repository metadata directory (heddle#2028): .git at any depth, or the root .heddle.

Fields

path: PathBuf

reason: ReservedPathComponent

Implementations

impl HeddleError

pub fn recovery(details: RecoveryDetails) -> HeddleError

Trait Implementations

impl Debug for HeddleError

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

Formats the value using the given formatter.

impl Display for HeddleError

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

Formats the value using the given formatter.

impl Error for HeddleError

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<CompressionError> for HeddleError

fn from(e: CompressionError) -> HeddleError

Converts to this type from the input type.

impl From<Error> for HeddleError

fn from(source: Error) -> HeddleError

Converts to this type from the input type.

impl From<Error> for HeddleError

fn from(e: Error) -> HeddleError

Converts to this type from the input type.

impl From<Error> for HeddleError

fn from(e: Error) -> HeddleError

Converts to this type from the input type.

impl From<Error> for HeddleError

fn from(e: Error) -> HeddleError

Converts to this type from the input type.

impl From<Error> for HeddleError

fn from(e: Error) -> HeddleError

Converts to this type from the input type.

impl From<Error> for HeddleError

fn from(e: Error) -> HeddleError

Converts to this type from the input type.

impl From<Error> for HeddleError

fn from(error: Error) -> HeddleError

Converts to this type from the input type.

impl From<HeddleError> for BlameSliceError

fn from(source: HeddleError) -> Self

Converts to this type from the input type.

impl From<LockError> for HeddleError

fn from(source: LockError) -> HeddleError

Converts to this type from the input type.

impl From<SemanticIndexError> for HeddleError

fn from(e: SemanticIndexError) -> HeddleError

Converts to this type from the input type.

impl From<TreeError> for HeddleError

fn from(source: TreeError) -> HeddleError

Converts to this type from the input type.

impl From<TreePathResolveError> for HeddleError

fn from(value: TreePathResolveError) -> HeddleError

Converts to this type from the input type.

impl From<TreeStreamError> for HeddleError

fn from(error: TreeStreamError) -> HeddleError

Converts to this type from the input type.