Struct AssetFolder 

pub struct AssetFolder { /* private fields */ }

The project’s assets/ folder as the compiler sees it: the files in it, listed up front, and a reader the compiler calls for the bytes of only those a declaration names. A large file nothing declares is never read.

The caller decides where the bytes come from: AssetFolder::on_disk for a real build, AssetFolder::new with its own reader otherwise. bynk-emit only ever calls AssetFolder::read, so it stays disk-free.

Implementations

impl AssetFolder

pub fn new( files: BTreeSet<String>, reader: Arc<dyn Fn(&str) -> Result<Vec<u8>, Error> + Sync + Send>, ) -> AssetFolder

A folder of files (normalised keys, assets/board.css) whose bytes come from reader. The compiler calls reader only with a key in files, at most once per build.

pub fn on_disk(project_root: &Path) -> Result<AssetFolder, Error>

<project_root>/assets/, listed now (list_asset_files: regular files only, symbolic links not followed, a missing folder empty) and read later, file by file, as the compiler asks. The folder’s real location is fixed now too, so a read whose path resolves anywhere else — a directory swapped for a symbolic link after the listing — is refused rather than published.

pub fn embeds_on_disk(project_root: &Path) -> Result<AssetFolder, Error>

AssetFolder::on_disk for the project’s embeds/ folder (#2387): the same listing and the same refusals, a different directory.

pub fn files(&self) -> &BTreeSet<String>

The files in the folder, by normalised key.

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

The bytes of the listed file key. A key the listing does not hold is NotFound without consulting the reader, so no caller can steer it outside the folder (normalise_asset_path keeps .. segments).

Trait Implementations

impl Clone for AssetFolder

fn clone(&self) -> AssetFolder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AssetFolder

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

Formats the value using the given formatter.