Struct PackageBundle 

pub struct PackageBundle {
    pub metadata: BundleMetadata,
    pub modules: Vec<BundledModule>,
    pub dependencies: HashMap<String, String>,
    pub blob_store: HashMap<[u8; 32], Vec<u8>>,
    pub manifests: Vec<ModuleManifest>,
    pub native_dependency_scopes: Vec<BundledNativeDependencyScope>,
    pub docs: HashMap<String, Vec<DocItem>>,
}

A compiled package bundle containing all modules and metadata.

Fields

metadata: BundleMetadata

Bundle metadata

modules: Vec<BundledModule>

Compiled modules

dependencies: HashMap<String, String>

Declared dependency versions (name -> version string)

blob_store: HashMap<[u8; 32], Vec<u8>>

Content-addressed blob store: hash -> raw blob bytes. Blobs are deduplicated across modules so shared functions are stored once.

manifests: Vec<ModuleManifest>

Module manifests for content-addressed resolution. Each manifest maps export names to blob hashes in blob_store.

native_dependency_scopes: Vec<BundledNativeDependencyScope>

Native dependency scopes for this package and all transitive dependencies. Used by consumers of .shapec bundles to lock/validate native prerequisites.

docs: HashMap<String, Vec<DocItem>>

Documentation items extracted from source code, keyed by module path.

Implementations

impl PackageBundle

pub fn to_bytes(&self) -> Result<Vec<u8>, String>

Serialize the bundle to bytes with magic header.

pub fn from_bytes(data: &[u8]) -> Result<Self, String>

Deserialize a bundle from bytes, validating magic and version.

Supports v1 (no blob_store/manifests), v2, and v3 (docs) bundles. Missing fields are filled with defaults via #[serde(default)].

pub fn write_to_file(&self, path: &Path) -> Result<(), String>

Write the bundle to a file.

pub fn read_from_file(path: &Path) -> Result<Self, String>

Read a bundle from a file.

Trait Implementations

impl Clone for PackageBundle

fn clone(&self) -> PackageBundle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PackageBundle

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PackageBundle

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PackageBundle

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.