Struct VirtualFileSystem 

pub struct VirtualFileSystem { /* private fields */ }

The runtime representation of the asset index (index.bin).

The Virtual File System is a service that provides fast, in-memory access to the metadata of all assets available in the packed data. It is the primary source of truth for the AssetAgent when it needs to make decisions about loading assets.

Implementations

impl VirtualFileSystem

pub fn new(index_bytes: &[u8]) -> Result<Self, DecodeError>

Creates a new VirtualFileSystem by loading and parsing an index file from its raw bytes.

This function is the entry point for the runtime asset system. It takes the binary data from index.bin and builds the in-memory lookup table.

Errors

Returns a DecodeError if the byte slice is not a valid, bincode-encoded list of AssetMetadata.

pub fn get_metadata(&self, uuid: &AssetUUID) -> Option<&AssetMetadata>

Retrieves the metadata for a given asset UUID.

This is the primary query method used by the AssetAgent.

pub fn iter_all(&self) -> impl Iterator<Item = &AssetMetadata>

Returns an iterator over all asset metadata entries in the VFS.

Useful for editor tooling (asset browser) that needs to display all available assets.

pub fn asset_count(&self) -> usize

Returns the total number of indexed assets.

Trait Implementations

impl Debug for VirtualFileSystem

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

Formats the value using the given formatter.