Struct VendoredResolver 

pub struct VendoredResolver { /* private fields */ }

Resolver that exposes the .mlua-pkgs/vendored/ directory to require.

VendoredResolver is a thin wrapper over FsResolver rooted at the vendored_root directory (typically .mlua-pkgs/vendored/).

Each package in that directory is expected to be a symlink (or real directory) created by the mlua-pkg install CLI (ST5). For example, require("foo") resolves to vendored/foo/init.lua, and require("foo.bar") resolves to vendored/foo/bar.lua.

Responsibilities

• This resolver reads — it does not create symlinks or directories.
• The CLI creates — mlua-pkg install is responsible for populating .mlua-pkgs/vendored/ before this resolver is used.

Construction

Constructor	Use when
VendoredResolver::from_lockfile	Normal usage: lockfile path + vendored root
VendoredResolver::new	Low-level: vendored root already exists and is populated

Errors

new() returns InitError::RootNotFound if vendored_root does not exist. from_lockfile() returns [PkgError::MissingLockfile] if the lockfile is absent, or [PkgError::SameNameConflict] if duplicate package names are found.

Implementations

impl VendoredResolver

pub fn new(vendored_root: impl Into<PathBuf>) -> Result<Self, InitError>

Low-level constructor: wrap an existing vendored_root directory.

Does not read a lockfile. Use from_lockfile for the normal flow.

Errors

Returns InitError::RootNotFound if vendored_root does not exist.

pub fn from_lockfile( lockfile_path: impl AsRef<Path>, vendored_root: impl AsRef<Path>, ) -> Result<Self, PkgError>

Normal constructor: read lockfile_path and wrap vendored_root.

Reads and validates the lockfile, then constructs an FsResolver rooted at vendored_root. For each package in the lockfile, emits a tracing::warn! if the corresponding vendored_root/<name> symlink or directory is absent (the CLI has not yet installed that package). Resolution will simply return None for missing packages at runtime, matching normal FsResolver miss behaviour.

vendored_root is created automatically if it does not exist, to avoid requiring a prior mlua-pkg install just to construct the resolver.

Errors

Error	Condition
[PkgError::MissingLockfile]	lockfile_path does not exist
[PkgError::LockfileParse]	Invalid TOML in the lockfile
[PkgError::SameNameConflict]	Duplicate package names in the lockfile
[PkgError::Io]	I/O failure while creating vendored_root or reading the lockfile

Trait Implementations

impl Debug for VendoredResolver

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

Formats the value using the given formatter.

impl Resolver for VendoredResolver

fn resolve(&self, lua: &Lua, name: &str) -> Option<Result<Value>>

Delegate resolution to the inner FsResolver.

require("foo") resolves to vendored/foo.lua or vendored/foo/init.lua. require("foo.bar") resolves to vendored/foo/bar.lua.