reinda: easily embed and manage assets
This library helps you manage your assets (external files) and is mostly intended to be used in web applications. Assets can be embedded into the binary file to obtain an easy to deploy standalone executable. This crate also offers a template engine and the ability to automatically include a hash of an asset's content into its filename (useful for caching on the web). In release mode, this crate prepares everything up-front such that the actually serving the file via HTTP can be as fast as possible.
You might know the crate rust-embed: reinda does basically the same, but for the most part has more features and is more flexible (in my opinion).
Tiny example:
use reinda::{assets, Assets, Config, Setup};
const ASSETS: Setup = assets! {
#![base_path = "assets"]
"index.html": { template },
"bundle.js": { hash },
};
let assets = Assets::new(ASSETS, Config::default()).await?;
// Retrieve specific asset. You can now send this data via HTTP or use it however you like.
let bytes /* : Option<bytes::Bytes> */ = assets.get("index.html")?;
See the documentation for more information.
Features
- Embed files at compile time (in prod mode) or load them at runtime (in dev mode)
- Allow for
dynamicfiles which will always be loaded at runtime - Include content hash in filename (has to be enabled per asset)
- Template system
- Include other assets
- Refer to other assets by path
- Use runtime variables
- Compress embedded files to shrink the resulting binary
- Cargo feature to embed everything in debug mode
- Template syntax checked at compile time (in prod mode)
- Well tested
Status of this project
This project is very young. I developed it specifically for a web application I work on where rust-embed did not offer enough features. You should absolutely not use this in production yet, but you sure can try it out.
If you have any thoughts about this project, please let me know in this community feedback issue!
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
13 May 28, 2022
158 Oct 9, 2022
13 Feb 16, 2022
1 Nov 2, 2021
6 Oct 19, 2022
294 Dec 23, 2022
16 Dec 20, 2022
496 Jan 2, 2023
18 Oct 24, 2022
722 Dec 27, 2022
63 Oct 31, 2022
1 Jan 26, 2022
296 Dec 29, 2022
82 Jan 1, 2023
26 Dec 26, 2022
752 Dec 30, 2022
4.5k Jan 4, 2023
3 Dec 20, 2022
2.2k Jan 7, 2023
56.3k Jan 3, 2023