include_dir

An evolution of the include_str!() and include_bytes!() macros for embedding an entire directory tree into your binary.

Rendered Documentation:

• master
• Latest Release

Getting Started

The include_dir!() 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.

```rust use includedir::{includedir, Dir};

static PROJECTDIR: Dir = includedir!("$CARGOMANIFESTDIR");

// of course, you can retrieve a file by its full path let librs = PROJECTDIR.get_file("src/lib.rs").unwrap();

// you can also inspect the file's contents let body = librs.contentsutf8().unwrap(); assert!(body.contains("SOMEINTERESTINGSTRING"));

// 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()); } } ```

Features

• Embed a directory tree into your binary at compile time
• Find a file in the embedded directory
• Search for files using a glob pattern (requires the globs feature)
• File metadata (requires the metadata feature)

To-Do list:

• Compression?