Struct FallbackFilesystem 

pub struct FallbackFilesystem { /* private fields */ }

A filesystem implementation that tries multiple fallback filesystems in order.

FallbackFilesystem allows chaining multiple filesystem implementations together, attempting operations on each one in sequence until one succeeds. This is useful for implementing layered asset loading where assets might be located in different locations (e.g., first check a mod directory, then fall back to base game assets).

Implementations

impl FallbackFilesystem

pub fn new(fallbacks: Vec<Arc<dyn Filesystem>>) -> Self

Creates a new FallbackFilesystem with the given list of fallback filesystems.

The filesystems will be tried in the order they appear in the vector. Earlier filesystems have priority over later ones.

Arguments

• fallbacks - A vector of filesystem implementations to use as fallbacks

Example

let mod_fs = Arc::new(NativeFilesystem::new("mods/"));
let base_fs = Arc::new(NativeFilesystem::new("assets/"));
let fallback = FallbackFilesystem::new(vec![mod_fs, base_fs]);

Trait Implementations

impl Filesystem for FallbackFilesystem

fn read_bytes<'life0, 'life1, 'async_trait>( &'life0 self, asset_path: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, FilesystemError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Attempts to read bytes from the asset path using the fallback filesystems.

Tries each filesystem in order until one successfully reads the asset. Returns the bytes from the first successful read operation.

Arguments

• asset_path - The path to the asset to read

Returns

• Ok(Vec<u8>) - The asset bytes from the first successful filesystem
• Err(FilesystemError::NotFound) - If all filesystems fail to find the asset

fn write_bytes<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, asset_path: &'life1 str, data: &'life2 [u8], ) -> Pin<Box<dyn Future<Output = Result<(), FilesystemError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Attempts to write bytes to the asset path using the fallback filesystems.

Tries each filesystem in order until one successfully writes the asset. The write operation stops at the first successful filesystem.

Arguments

• asset_path - The path where the asset should be written
• data - The bytes to write

Returns

• Ok(()) - If any filesystem successfully writes the data
• Err(FilesystemError::WriteUnsupported) - If all filesystems fail to write