Struct SourceReader 

pub struct SourceReader { /* private fields */ }

A detached reader over the server’s byte sources, for code that needs raw bytes away from the ECS: the bundles, then every registered AssetSource, then the filesystem. Kind-agnostic - no decoder runs and no cache is touched - so any plugin or runtime module that loads its own data (media files, archives, anything it ships with the app) reads through the same chain the asset pipeline uses instead of the raw filesystem.

Get one from crate::AssetServer::source_reader. The reader is a cheap snapshot: Send + Sync, safe to move to another thread, and free to block there (an archive read is a copy, a filesystem read is I/O). It does not follow later registrations - a source or bundle registered after the snapshot is invisible to it - so take a fresh reader per request rather than holding one for the app’s lifetime.

The reader resolves the path it is given. Callers keep the same conventions the rest of the pipeline uses: resolve app-relative paths first (lumen_core::app_paths::resolve), and pass lumen://app/... URIs through untouched - the bundle source claims those itself.

Implementations

impl SourceReader

pub fn read(&self, path: &Path) -> Result<Vec<u8>>

The bytes for path: the first source that claims it, else the filesystem. A path nothing holds is the filesystem’s NotFound error, so a missing bundled entry and a missing file report the same way.

Trait Implementations

impl Clone for SourceReader

fn clone(&self) -> SourceReader

Returns a duplicate of the value.

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

Performs copy-assignment from source.