Struct HttpAssetFetch 

pub struct HttpAssetFetch { /* private fields */ }

HttpAssetFetch is a struct that enables fetching assets from an HTTP endpoint. The root URL represents the base URL to join with paths to form full asset URLs.

Implementations

impl HttpAssetFetch

pub fn new(root: &str) -> Result<Self, Box<dyn Error>>

Creates a new HttpAssetFetch with a provided root URL.

Arguments

• root: A string representing the root URL for the HTTP request (e.g., “https://example.com”).

Returns

• Ok(HttpAssetFetch): If the root URL is valid and successfully parsed.
• Err(Box<dyn Error>): If the URL is invalid or any error occurs while parsing.

Examples found in repository

examples/hello_http.rs (lines 19-21)

fn main() -> Result<(), Box<dyn Error>> {
    /* ANCHOR: main */
    let mut database = AssetDatabase::default()
        .with_protocol(TextAssetProtocol)
        .with_protocol(BytesAssetProtocol)
        .with_protocol(BundleAssetProtocol::new("json", |bytes: Vec<u8>| {
            Ok((serde_json::from_slice::<Value>(&bytes)?,).into())
        }))
        // HTTP asset fetch with root URL for assets.
        .with_fetch(DeferredAssetFetch::new(HttpAssetFetch::new(
            "https://raw.githubusercontent.com/PsichiX/Keket/refs/heads/master/resources/",
        )?));

    // Ensure assets exists or start getting fetched.
    let lorem = database.ensure("text://lorem.txt")?;
    let json = database.ensure("json://person.json")?;
    let trash = database.ensure("bytes://trash.bin")?;

    // Wait while database is busy.
    while database.is_busy() {
        println!("Waiting for database to be free");
        println!(
            "Loading:\n- Lorem Ipsum: {}\n- JSON: {}\n- Bytes: {}",
            lorem.awaits_async_fetch(&database),
            json.awaits_async_fetch(&database),
            trash.awaits_async_fetch(&database)
        );
        database.maintain()?;
    }

    println!("Lorem Ipsum: {}", lorem.access::<&String>(&database));
    println!("JSON: {:#}", json.access::<&Value>(&database));
    println!("Bytes: {:?}", trash.access::<&Vec<u8>>(&database));

    // List all assets from HTTP.
    for (asset_path, url) in database.storage.query::<true, (&AssetPath, &Url)>() {
        println!("Asset: `{asset_path}` at url: `{url}`");
    }
    /* ANCHOR_END: main */

    Ok(())
}

Trait Implementations

impl AssetFetch for HttpAssetFetch

fn load_bytes( &self, path: AssetPath<'_>, ) -> Result<DynamicBundle, Box<dyn Error>>

Loads the raw bytes of an asset given its path.

fn maintain(&mut self, storage: &mut World) -> Result<(), Box<dyn Error>>

Maintains the fetcher’s state.