Crates.io | include_directory |
lib.rs | include_directory |
version | 0.1.1 |
source | src |
created_at | 2023-02-16 16:39:58.057897 |
updated_at | 2023-02-16 16:45:32.650295 |
description | Embed the contents of a directory in your binary |
homepage | |
repository | https://github.com/devraymondsh/include_directory |
max_upload_size | |
id | 786885 |
size | 19,502 |
An evolution of the include_str!()
and include_bytes!()
macros for embedding
an entire directory tree into your binary.
This is a fork of the include_dir
crate which gathers files' mimetype at compile-time that can be accessed at run-time.
Rendered Documentation:
The include_directory!()
macro works very similarly to the normal include_str!()
and include_bytes!()
macros. You pass the macro a file path and assign the
returned value to some static
variable.
use include_directory::{include_directory, Dir};
static PROJECT_DIR: Dir = include_directory!("$CARGO_MANIFEST_DIR");
// of course, you can retrieve a file by its full path
let lib_rs = PROJECT_DIR.get_file("src/lib.rs").unwrap();
// you can get the mimetype by doing
let mimetype = lib_rs.mimetype();
// you can also inspect the file's contents
let body = lib_rs.contents_utf8().unwrap();
assert!(body.contains("SOME_INTERESTING_STRING"));
// you can search for files (and directories) using glob patterns
#[cfg(feature = "glob")]
{
let glob = "**/*.rs";
for entry in PROJECT_DIR.find(glob).unwrap() {
println!("Found {}", entry.path().display());
}
}
globs
feature)metadata
feature)To-Do list: