Enum PkgError 

#[non_exhaustive]
pub enum PkgError {
    ManifestParse {
        source: Error,
    },
    LockfileParse {
        source: Error,
    },
    LockfileWrite {
        source: Error,
    },
    MissingLockfile {
        path: PathBuf,
    },
    SameNameConflict {
        name: String,
    },
    Io {
        source: Error,
    },
    Validation {
        message: String,
    },
    GitFetch {
        source: Error,
    },
    TagShaMismatch {
        expected: String,
        actual: String,
    },
    EntryNotFound {
        name: String,
        attempted: Vec<PathBuf>,
    },
}

Crate-wide error for PkgMgr operations.

Error taxonomy

Variant	Phase	Source
ManifestParse	Parse	toml::de::Error via #[from]
LockfileParse	Parse	toml::de::Error via map_err
LockfileWrite	Serialize	toml::ser::Error via #[from]
MissingLockfile	I/O	path not found
SameNameConflict	Validate	duplicate name in lockfile
Io	I/O	std::io::Error via #[from]
Validation	Post-parse	custom message
GitFetch	Fetch	git2::Error via #[from]
TagShaMismatch	Fetch	tag ↔ SHA conflict

Variants are #[non_exhaustive] so that future subtasks can add new variants without breaking downstream match arms that include a wildcard.

The existing crate::ResolveError is intentionally not modified.

Variants (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.

ManifestParse

TOML parse failure when reading mlua-pkg.toml.

Automatically constructed from toml::de::Error via ?.

Fields

source: Error

LockfileParse

TOML parse failure when reading mlua-pkg.lock.

Does not carry #[from] — ManifestParse already claims From<toml::de::Error>. Lockfile read paths must use .map_err(|e| PkgError::LockfileParse { source: e }) explicitly.

Fields

source: Error

LockfileWrite

TOML serialization failure when writing mlua-pkg.lock.

Automatically constructed from toml::ser::Error via ?.

Fields

source: Error

MissingLockfile

mlua-pkg.lock not found at the expected path.

Raised by Lockfile::read when the file is absent, to distinguish the “not yet installed” case from other I/O failures.

Fields

path: PathBuf

SameNameConflict

Two packages share the same name field within a lockfile.

Package names must be unique within a lockfile. Raised during Lockfile::read and (in ST5) at install time.

Fields

name: String

Io

I/O error while reading or writing files (manifest, lockfile, cache).

Automatically constructed from std::io::Error via ?.

Fields

source: Error

Validation

Post-parse validation failure.

Raised when the parsed manifest satisfies TOML grammar but violates semantic constraints, e.g. specifying both tag and rev in a single dependency entry.

Fields

message: String

GitFetch

git2 operation failure during fetch or clone.

Automatically constructed from git2::Error via ?.

Fields

source: Error

TagShaMismatch

The resolved SHA for a tag did not match the expected SHA.

Raised when the caller pins a specific SHA together with a tag and the tag resolves to a different commit.

Fields

expected: String

actual: String

EntryNotFound

No suitable entry point directory found within a cached package.

Raised by mlua_pkg::resolve_entry when neither the override path nor any fallback candidate (src/, lua/, .) exists as a directory under cache_path.

Also raised during VendoredResolver::from_lockfile construction when a package in the lockfile has no resolvable entry.

Fields

name: String

attempted: Vec<PathBuf>

Trait Implementations

impl Debug for PkgError

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

Formats the value using the given formatter.

impl Display for PkgError

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

Formats the value using the given formatter.

impl Error for PkgError

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 PkgError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for PkgError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for PkgError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for PkgError

fn from(source: Error) -> Self

Converts to this type from the input type.