Enum Error 

pub enum Error {
    NotAWorkspace(PathBuf),
    WorkspaceExists(PathBuf),
    NestedWorkspace(PathBuf),
    AlreadyAttached,
    LfsSourceUnsupported,
    NoActorConfigured,
    SessionNotFound(String),
    SessionClosed {
        id: String,
        state: String,
    },
    RequestNotFound(String),
    RequestClosed {
        id: String,
        state: String,
    },
    RequestParked(String),
    SelfApprovalForbidden,
    ApprovalsDismissed {
        new_snapshot: String,
    },
    LeaseHeld {
        holder: String,
        expires_at_ms: i64,
    },
    PathOutsideWorkingCopy(String),
    NotText(String),
    WindowTooLarge {
        max: usize,
    },
    PackageFailed {
        package: String,
        reason: String,
    },
    Engine(String),
    Io(Error),
    Config(String),
}

Every way a core operation can fail.

The domain variants are outcomes callers match on by name; the last three wrap a lower layer (the engine, the filesystem, config parsing) whose detail is carried as a message.

Variants

NotAWorkspace(PathBuf)

The path is not inside an atelier workspace.

WorkspaceExists(PathBuf)

init refused: the path already holds a workspace.

NestedWorkspace(PathBuf)

init refused: the path sits inside an existing workspace.

AlreadyAttached

attach refused: the mount name is already taken.

LfsSourceUnsupported

Adoption refused: the git source uses git-lfs.

NoActorConfigured

No config home names an actor; see resolve_actor.

SessionNotFound(String)

No session carries the given id.

SessionClosed

The session left the open state; the operation needs it open.

Fields

id: String

The session’s id.

state: String

The state the session is in.

RequestNotFound(String)

No landing request carries the given id.

RequestClosed

The landing request left the open state; the operation needs it open.

Fields

id: String

The request’s id.

state: String

The state the request is in.

RequestParked(String)

The landing request hit a conflict and parked.

SelfApprovalForbidden

The workspace’s landing policy forbids self-approval.

ApprovalsDismissed

The change gained a snapshot after approval, so the approvals no longer vouch for what would land.

Fields

new_snapshot: String

The snapshot that dismissed the approvals.

LeaseHeld

Another actor holds the landing lease.

Fields

holder: String

The actor holding the lease.

expires_at_ms: i64

When the lease expires, in unix milliseconds.

PathOutsideWorkingCopy(String)

The path escapes the session’s working copy.

NotText(String)

The file has no projecting package and its bytes are not text.

WindowTooLarge

The requested read window exceeds the maximum.

Fields

max: usize

The largest window a read accepts, in bytes.

PackageFailed

A format package failed while handling a document it claimed.

Fields

package: String

The failing package’s id.

reason: String

Why it failed, in the package’s own words.

Engine(String)

An engine-layer failure: jj or SQLite.

Io(Error)

A filesystem failure.

Config(String)

A config-layer failure: TOML or time formatting.

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.