Easy-to-use asset manager for many environments.
This crate is written with following goals in mind:
Batteries included.\
Crate comes with variety of simple data sources like FileSource and HttpSource.
Few Formats based on serde are included under feature flags.
Extensibility.\
Multiple Format traits can be implemented for any asset type, including foreign asset types.\
For example JsonFormat, YamlFormat and RonFormat (bundled in the crate) implement Format trait for any asset type
which intermediate representation implements serde::de::DeserializeOwned.
Supporting WebAssembly.\ All mandatory dependencies are WASM-compatible and no threading is required for asset loading to work.
Working with asynchronous data sources.\
All data sources implement Source trait.
Source::read method returns future that will be driven to completion by the bound Loader.
no_std\
alloc is required.
Fast compilation.\
build after cargo clean takes ~3s.
This crate is not aimed to support every possible feature. Here's list of some of those features:
All out-of-the-box functionality execut core traits and types are enabled with features.
std - adds implementation of std::error::Error trait for error types.
Enabled by default.sync - makes most types Send and some Sync. Adds requirements for traits implementations to be Send and Sync where needed.
Enabled by default.fs (enables std) - adds FileSource - Source implementation that loads asset bytes from file-system.reqwest - adds ReqwestSource - Source implementation that loads asset bytes from URLs using reqwest.
Using this source requires Loader to be polled by tokio. Otherwise reqwest interals will panic.fetch - adds FetchSource that uses browser's Fetch API to load assets data. Conflicts with sync feature.json-format - adds Format implementation that treats asset bytes as JSON document and deserializes asset representation via serdeyaml-format - adds Format implementation that treats asset bytes as YAML document and deserializes asset representation via serderon-format - adds Format implementation that treats asset bytes as RON document and deserializes asset representation via serdefutures-spawn - adds Spawn implementation for futures_task::Spawn(aka futures::task::Spawn) allowing to use compatible spawners to drive loading tasks to completion.wasm-bindgen-spawn - adds Spawn implementations that uses wasm_bindgen_futures::spawn_local to drive loadin tasks. Usable only on wasm32 target.tokio-spawn - adds Spawn implementation for tokio::runtime::Handle wrapper allowing tokio to drive loading tasks. reqwest based source requires tokio runtime.There are few simple examples provided already.
Shows how to build registry with FileSource and load simple assets from it.
Async example that loads assets using HTTP protocol with tokio and reqwest crates.
Shows how to load assets directly into entity using legion ECS crate.
Shows how to load assets in browser using Fetch API.
This example can be built using build-wasm32.sh or build-wasm32.bat in examples directory.\
wasm-bindgen (compatible version) and wasm-opt must be in PATH
sh
cd examples
build-wasm32 fetch --features fetch,json-format,yaml-format,wasm-spawn
python3 server.py
Then open http://localhost:8000/fetch Loaded assets must be shown on the page. Otherwise see for errors in log.
no_std on stablesync is conflicts with fetch feature. But in general sync is not necessary when targeting web browser.This repository is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.