Struct ExtractedPackage 

#[non_exhaustive]
pub struct ExtractedPackage {
    pub name: String,
    pub python_path: PathBuf,
    pub native_extensions: Vec<NativeExtension>,
    pub has_native_extensions: bool,
    /* private fields */
}

An extracted package ready for use in a sandbox.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

Package name (e.g., “numpy”).

python_path: PathBuf

Path to the extracted Python files directory. This should be mounted at /site-packages.

native_extensions: Vec<NativeExtension>

Native extensions (.so files) with their dlopen paths. Empty for pure-Python packages.

has_native_extensions: bool

Whether this package has native extensions.

Implementations

impl ExtractedPackage

pub fn from_path(path: impl AsRef<Path>) -> Result<Self, Error>

Extract a package from a file path.

The format is auto-detected from the file extension.

Errors

Returns an error if:

• The format cannot be detected
• The archive cannot be read or extracted

pub fn from_bytes( bytes: &[u8], format: PackageFormat, name_hint: impl Into<String>, ) -> Result<Self, Error>

Extract a package from raw bytes.

The format is specified explicitly since it cannot be detected from bytes alone. The name_hint is used for the package name if one cannot be detected from the archive contents (e.g., “numpy” or “requests-2.31.0”).

Example

use eryx::package::{ExtractedPackage, PackageFormat};

// Load from bytes (e.g., downloaded from a URL)
let bytes = download_package("https://example.com/numpy-wasi.tar.gz").await?;
let package = ExtractedPackage::from_bytes(&bytes, PackageFormat::TarGz, "numpy")?;

Errors

Returns an error if:

• The format is Directory (directories cannot be loaded from bytes)
• The archive cannot be read or extracted

Trait Implementations

impl Debug for ExtractedPackage

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

Formats the value using the given formatter.