Enum Error

pub enum Error {
    Cache(CacheError),
    NonUtf8Path(PathBuf),
    NonUtf8EnvVar(Cow<'static, str>),
    InvalidKrateName(InvalidKrateName),
    UnknownRegistry(String),
    Io(Error),
    IoPath(Error, PathBuf),
    InvalidUrl(InvalidUrl),
    Json(Error),
    Toml(Box<Error>),
    NoCrateVersions,
    Http(HttpError),
    Git(GitError),
    Semver(Error),
    Local(LocalRegistryError),
    Lock(FileLockError),
}

The core error type for this library

Variants

Cache(CacheError)

Failed to deserialize a local cache entry

NonUtf8Path(PathBuf)

This library assumes utf-8 paths in all cases, a path was provided that was not valid utf-8

NonUtf8EnvVar(Cow<'static, str>)

An environment variable was located, but had a non-utf8 value

InvalidKrateName(InvalidKrateName)

A user-provided string was not a valid crate name

UnknownRegistry(String)

The user specified a registry name that did not exist in any searched .cargo/config.toml

Io(Error)

An I/O error

IoPath(Error, PathBuf)

An I/O error occurred trying to access a specific path

InvalidUrl(InvalidUrl)

A user provided URL was invalid

Json(Error)

Failed to de/serialize JSON

Toml(Box<Error>)

Failed to deserialize TOML

NoCrateVersions

An index entry did not contain any versions

Http(HttpError)

Failed to handle an HTTP response or request

Git(GitError)

Available on crate feature __git only.

An error occurred doing a git operation

Semver(Error)

Failed to parse a semver version or requirement

Local(LocalRegistryError)

Available on crate feature local only.

A local registry is invalid

Lock(FileLockError)

Failed to lock a file

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<Box<Error>> for Error

fn from(source: Box<Error>) -> Self

Converts to this type from the input type.

impl From<CacheError> for Error

fn from(source: CacheError) -> 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.

impl From<Error> for Error

Available on crate feature sparse only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature sparse only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<FileLockError> for Error

fn from(source: FileLockError) -> Self

Converts to this type from the input type.

impl From<GitError> for Error

fn from(source: GitError) -> Self

Converts to this type from the input type.

impl From<HttpError> for Error

fn from(source: HttpError) -> Self

Converts to this type from the input type.

impl From<InvalidKrateName> for Error

fn from(source: InvalidKrateName) -> Self

Converts to this type from the input type.

impl From<InvalidUrl> for Error

fn from(source: InvalidUrl) -> Self

Converts to this type from the input type.

impl From<LocalRegistryError> for Error

fn from(source: LocalRegistryError) -> Self

Converts to this type from the input type.

impl From<PathBuf> for Error

fn from(p: PathBuf) -> Self

Converts to this type from the input type.