12 unstable releases (4 breaking)

0.6.0 May 5, 2020
0.5.0 Jan 13, 2020
0.4.1 Nov 5, 2019
0.2.1 Jun 6, 2018
0.1.3 Jun 10, 2017

#9 in Development tools

Download history 7717/week @ 2020-05-29 10116/week @ 2020-06-05 7197/week @ 2020-06-12 6691/week @ 2020-06-19 6474/week @ 2020-06-26 4601/week @ 2020-07-03 4939/week @ 2020-07-10 4549/week @ 2020-07-17 3722/week @ 2020-07-24 5524/week @ 2020-07-31 5601/week @ 2020-08-07 5314/week @ 2020-08-14 4630/week @ 2020-08-21 5281/week @ 2020-08-28 4738/week @ 2020-09-04 5576/week @ 2020-09-11

19,667 downloads per month
Used in 57 crates (25 directly)

MIT license

9KB
174 lines

include_dir

Build Status Build status license Crates.io Docs.rs

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

Rendered Documentation:

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.

Most importantly, the file path must be relative to the project root as indicated by the CARGO_MANIFEST_DIR environment variable.

#[macro_use]
extern crate include_dir;

use include_dir::Dir;
use std::path::Path;

static PROJECT_DIR: Dir = include_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 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 = "search")]
{
    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)

To-Do list:

  • File metadata
  • Compression?

Dependencies

~0.5–1MB
~22K SLoC