include_dir

是 include_str!() 和 include_bytes!() 宏嵌入整个目录树到二进制文件的演变。

渲染文档

• master
• 最新版本

入门

include_dir!() 宏的工作方式与普通的 include_str!() 和 include_bytes!() 宏非常相似。您将文件路径传递给宏，并将返回值赋给某个 static 变量。

use include_dir::{include_dir, Dir};

static PROJECT_DIR: Dir = include_dir!("$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 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());
    }
}

特性

• 在编译时将目录树嵌入到您的二进制文件中
• 在嵌入的目录中查找文件
• 使用glob模式搜索文件（需要 globs 特性）
• 文件元数据（需要 metadata 特性）

待办事项列表

• 压缩？