Expand description

include_dir_as_map

A procedural macro which embeds files from a directory into the rust binary as a hashmap. This can be used to embed assets such as images, html, css, and js.

include_dir_as_map extends include_str!() and include_bytes!() and is similar to include_dir.

Usage

Include the following section in Cargo.toml:

[dependencies]
include_dir_as_map="1"

In your rust code, include the following:

// DirMap is an alias for HashMap<String, Vec<u8>>
use include_dir_as_map::{include_dir_as_map, DirMap};

// Environment variables will be expanded at compile time
let dirmap: DirMap = include_dir_as_map!("$CARGO_MANIFEST_DIR");
let bytes = dirmap.get("Cargo.toml")?;

All paths are relative to the embedded directory, so if root contains files root/foo.txt and root/next/bar.txt, then include_dir_as_map!("root") will result in a hashmap with keys foo.txt and next/bar.txt.

Features

By default, the files are read from the filesystem at runtime in debug mode for compilation speed. To override this behavior, enable the always-embed feature in Cargo.toml:

[dependencies]
include_dir_as_map={ version="1", features=[ "always-embed" ] }

Examples

See the examples/ directory for more examples:

Development

Building

To build the library and examples:

cargo build --workspace

Testing

To test the library and procedural macro:

cargo test --workspace

Macros

  • The procedural macro magic that embeds files from a directory into the rust binary as a hashmap.

Type Aliases

  • Maps the relative path of each file to its contents as a vector of bytes.