Enum AddError 

pub enum AddError {
    NotAFile(Utf8PathBuf),
    Symlink(Utf8PathBuf),
    Io {
        path: Utf8PathBuf,
        source: Error,
    },
    NotAPdf(Utf8PathBuf),
    TooLarge {
        path: Utf8PathBuf,
        actual: u64,
        cap: u64,
    },
    AlreadyStored {
        ref_: String,
        path: Utf8PathBuf,
    },
    NamesAnotherWork {
        stem: String,
        ref_: String,
    },
    Resolve {
        ref_: String,
        source: FetchError,
    },
    Store(FetchError),
    UnreadableEntry {
        ref_: String,
        source: StoreError,
    },
}

Why a file was not added.

Variants

NotAFile(Utf8PathBuf)

Not a regular file (missing, a directory, a device, …).

Symlink(Utf8PathBuf)

A symlink: resolved elsewhere, it is not the file the user named.

Io

Reading the file failed.

Fields

path: Utf8PathBuf

The file.

source: Error

The error.

NotAPdf(Utf8PathBuf)

The first bytes are not %PDF- – the same check a fetch makes.

TooLarge

Larger than a fetch would accept.

Fields

path: Utf8PathBuf

The file.

actual: u64

Its size.

cap: u64

crate::PDF_MAX_BYTES.

AlreadyStored

The store already holds a PDF for this ref.

Fields

ref_: String

The ref.

path: Utf8PathBuf

The stored PDF.

NamesAnotherWork

The file name is another work’s id.

Fields

stem: String

The file name without .pdf.

ref_: String

The ref it was being added under.

Resolve

The ref’s metadata could not be resolved (and the store had none).

Fields

ref_: String

The ref.

source: FetchError

The resolver error.

Store(FetchError)

The store write failed.

UnreadableEntry

The store has an entry for the ref that cannot be read. Writing over it would drop its tags, collections and annotation unseen.

Fields

ref_: String

The ref.

source: StoreError

Why the read failed.

Trait Implementations

impl Debug for AddError

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

Formats the value using the given formatter.

impl Display for AddError

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

Formats the value using the given formatter.

impl Error for AddError

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.