Struct Package 

pub struct Package { /* private fields */ }

.rlxp package types — re-exported so open_rlxp’s return type is nameable without a direct rlx-pkg dependency. Opened RLX package.

Implementations

impl Package

pub fn open(path: impl AsRef<Path>) -> Result<Package, Error>

Open a directory, flat .rlxp, or ZIP archive.

pub fn manifest(&self) -> &Manifest

pub fn weights_index(&self) -> Option<&WeightsIndex>

pub fn placement(&self) -> Option<&Placement>

pub fn has_graph(&self) -> bool

True when the package embeds a MIR graph (encoding != "none").

pub fn graph(&self) -> Result<Graph, Error>

Deserialize the MIR graph and fill stripped weight Constants from the package (hot tier only by default — see MaterializeMode).

pub fn graph_with(&self, mode: MaterializeMode) -> Result<Graph, Error>

Like Self::graph with an explicit materialize mode.

pub fn bind_tensor(&self, g: &mut Graph, name: &str) -> Result<(), Error>

Bind one tensor (any tier) into matching empty Constants.

pub fn bind_warm_and_cold(&self, g: &mut Graph) -> Result<(), Error>

Inflate all non-hot tensors into the graph (after MaterializeMode::HotOnly).

pub fn advise_hot_willneed(&self)

Hint the OS to prefetch hot weight pages (madvise WILLNEED). Best-effort.

pub fn prefetch_tensor(&self, name: &str) -> Result<(), Error>

Prefetch a single named tensor’s stored range.

pub fn sidecar(&self, id: &str) -> Result<Vec<u8>, Error>

Sidecar bytes by id (decompresses cold sidecars).

pub fn weight_entry(&self, name: &str) -> Result<&WeightEntry, Error>

pub fn tensor_bytes(&self, name: &str) -> Result<Vec<u8>, Error>

Owned tensor bytes (decompresses warm/cold; copies hot). Uses parallel warm-block decode for large zstd_blocks blobs.

pub fn tensor_mmap(&self, name: &str) -> Result<&[u8], Error>

Zero-copy mmap view — hot / raw only.

pub fn tensor_warm_block( &self, name: &str, block_index: usize, ) -> Result<Vec<u8>, Error>

Decode one warm block by index (0-based) without inflating the whole tensor.

pub fn tensor_f32(&self, name: &str) -> Result<Vec<f32>, Error>

pub fn tensors_for_rank(&self, rank: u32) -> Vec<&WeightEntry>

pub fn tensors_by_tier(&self, tier: StorageTier) -> Vec<&WeightEntry>

pub fn rank_root(&self, rank: u32) -> Option<String>

pub fn member_bytes(&self, rel: &str) -> Result<Vec<u8>, Error>

impl Package

pub fn typed_weight_bindings( &self, ) -> Result<Vec<(String, Vec<u8>, DType)>, Error>

Yield (name, bytes, dtype) for every weight — used to CompiledGraph::set_param_typed after compile (Param path).