Skip to main content

Error

Enum Error 

Source
#[non_exhaustive]
pub enum Error {
Show 30 variants Io(Shared<Error>), Http(Shared<Error>), Json(Shared<Error>), Zip(Shared<ZipError>), Header(Shared<ToStrError>), ParseInt(ParseIntError), MissingHeader(String), Config(String), ManifestParse(String), Cache(String), SizeLimitExceeded { context: String, limit: u64, actual: Option<u64>, }, IncompleteDownload { expected: u64, actual: u64, }, UnsafeName(String), UnsupportedCacheVersion { found: u32, expected: u32, }, Ecosystem(String), Install(String), Profile(String), BadProfile(BadProfile), NotInstalled { package: String, }, UnresolvedDependency { package: String, unresolved: Vec<String>, }, MissingVersion { package: String, version: String, }, UnknownGame { game: String, }, NoGameProfile { game: String, }, NoModLoader { loader: LoaderKind, }, MissingGameDir { path: PathBuf, }, Download { total: usize, failures: Vec<(String, Error)>, }, ImportUnfinished { failures: Vec<(String, Error)>, }, InvalidHeader(String), ExtractLimitExceeded(String), ChecksumMismatch { path: String, expected: u32, actual: u32, },
}
Expand description

Represents all possible errors that can occur within the Thunderstore engine.

This enum is #[non_exhaustive]: new variants may be added in future releases without a breaking change, so downstream matches must include a wildcard arm.

Error is Clone, so a client can keep one in its state or hand it to several listeners. Sources that are not Clone themselves are held in a Shared; ? still converts them directly, and source still downcasts to them.

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

Io(Shared<Error>)

Error from the IO system.

§

Http(Shared<Error>)

Available on crate feature io only.

Error from HTTP operations.

§

Json(Shared<Error>)

Error from JSON parsing.

§

Zip(Shared<ZipError>)

Available on crate feature io only.

Error from ZIP operations.

§

Header(Shared<ToStrError>)

Available on crate feature io only.

Error from header parsing.

§

ParseInt(ParseIntError)

Error from parsing integers.

§

MissingHeader(String)

Missing header in response.

§

Config(String)

Error from builder or configuration validation.

§

ManifestParse(String)

Error parsing a per-mod manifest.json.

§

Cache(String)

Error reading, writing, or validating the on-disk package-index cache.

Covers cache load/decode/encode, a missing cache, an incompatible or corrupt cache layout, and the integrity checks in PackageIndex::validate — which run at the cache boundary.

§

SizeLimitExceeded

A network body, manifest file, or decompressed payload exceeded a configured size limit.

actual is a structured field for programmatic inspection; it is deliberately not rendered in Display because thiserror cannot conditionally format an Option.

Fields

§context: String

A short label for what was being read (e.g. "download body").

§limit: u64

The configured byte ceiling.

§actual: Option<u64>

The observed size, when known.

§

IncompleteDownload

A download ended before the declared number of bytes arrived.

Fields

§expected: u64

The number of bytes the server declared.

§actual: u64

The number of bytes actually received.

§

UnsafeName(String)

A download filename was unsafe (empty, absolute, or path-traversing).

§

UnsupportedCacheVersion

The on-disk cache was written by an incompatible version of the cache format. The client treats this as a cache miss and re-fetches.

Fields

§found: u32

The format version read from the cache file.

§expected: u32

The format version this build understands.

§

Ecosystem(String)

Error from ecosystem-schema parsing.

§

Install(String)

Error from install routing, e.g. a package that would escape the install root.

§

Profile(String)

Error from the profile layer: an invalid profile name, a malformed mods.yml/state file, or a profile operation that could not complete.

§

BadProfile(BadProfile)

A profile name that could not be used, from any operation that gates on layout::require_profile.

Carries the reason rather than a sentence so an operation with other failure modes, such as layout::use_profile, can still return one Error without a caller losing the ability to word the refusal itself. Renders exactly as Error::Profile did for the same refusal.

§

NotInstalled

The package is not recorded in the target’s mods.yml.

Fields

§package: String

The Owner-Name identifier as given.

§

UnresolvedDependency

A requested package, or a package in its dependency closure, is not in the package index, so nothing was installed.

Fields

§package: String

The identifier whose install was requested.

§unresolved: Vec<String>

Every identifier that could not be resolved, sorted.

§

MissingVersion

The index has the package, but not the version the request names.

Fields

§package: String

The Owner-Name identifier.

§version: String

The requested version.

§

UnknownGame

The ecosystem has no game with this slug.

Fields

§game: String

The game slug as given.

§

NoGameProfile

The game is known, but the ecosystem gives it no profile, so there are no install rules to route its packages with.

Fields

§game: String

The game slug as given.

§

NoModLoader

A modded launch found no mod loader installed in the target, so its mods would not load.

Fields

§loader: LoaderKind

The loader the game’s mods need.

§

MissingGameDir

The game folder a launch needs does not exist.

Fields

§path: PathBuf

The game folder as given.

§

Download

One or more files in a batch download failed.

Fields

§total: usize

How many files were attempted.

§failures: Vec<(String, Error)>

Each file that failed, with the reason, sorted by file name.

§

ImportUnfinished

An import stopped because one or more of its mods failed to install, so its config files were not restored. Importing again once the causes are fixed skips the mods already installed and completes it.

Fields

§failures: Vec<(String, Error)>

Each exported identifier that failed, with the reason.

§

InvalidHeader(String)

A response header was present but could not be parsed, e.g. an unparseable Last-Modified value.

§

ExtractLimitExceeded(String)

An archive exceeded a configured extraction limit (entry count or uncompressed size), e.g. a zip bomb.

§

ChecksumMismatch

CRC32 verification failed while extracting an archive entry.

Fields

§path: String

The archive-relative path of the entry that failed verification.

§expected: u32

The CRC32 the archive recorded for the entry.

§actual: u32

The CRC32 computed over the bytes actually read.

Trait Implementations§

Source§

impl Clone for Error

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for Error

Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more
Source§

impl From<BadProfile> for Error

Source§

fn from(source: BadProfile) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Source§

fn from(error: Error) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Available on crate feature io only.
Source§

fn from(error: Error) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Source§

fn from(error: Error) -> Self

Converts to this type from the input type.
Source§

impl From<NotRemovable> for Error

Source§

fn from(value: NotRemovable) -> Self

Converts to this type from the input type.
Source§

impl From<ParseIntError> for Error

Source§

fn from(source: ParseIntError) -> Self

Converts to this type from the input type.
Source§

impl From<ToStrError> for Error

Available on crate feature io only.
Source§

fn from(error: ToStrError) -> Self

Converts to this type from the input type.
Source§

impl From<ZipError> for Error

Available on crate feature io only.
Source§

fn from(error: ZipError) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl !RefUnwindSafe for Error

§

impl !UnwindSafe for Error

§

impl Forget for Error

§

impl Freeze for Error

§

impl Move for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl UnsafeUnpin for Error

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more