include_dir

include_str!() 和 include_bytes!() 宏的演变，用于将整个目录树嵌入到你的二进制文件中。

渲染文档

• master
• 最新版本

入门指南

include_dir!() 宏与正常的 include_str!() 和 include_bytes!() 宏非常相似。你将文件路径传递给宏，并将返回值赋给某个 static 变量。

最重要的是，文件路径必须是相对于项目根目录的，如环境变量 CARGO_MANIFEST_DIR 所示。

#[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());
    }
}

特性

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

待办事项列表

• 文件元数据
• 压缩？