5 个版本

0.7.4 2024 年 6 月 17 日
0.7.3 2022 年 10 月 16 日
0.7.2 2021 年 12 月 6 日
0.7.1 2021 年 11 月 19 日
0.7.0 2021 年 11 月 14 日

#1682 in 文件系统

Download history 129727/week @ 2024-05-04 136750/week @ 2024-05-11 145469/week @ 2024-05-18 149929/week @ 2024-05-25 167248/week @ 2024-06-01 167619/week @ 2024-06-08 165152/week @ 2024-06-15 176815/week @ 2024-06-22 148671/week @ 2024-06-29 147377/week @ 2024-07-06 153868/week @ 2024-07-13 155902/week @ 2024-07-20 152328/week @ 2024-07-27 164304/week @ 2024-08-03 174144/week @ 2024-08-10 149906/week @ 2024-08-17

670,011 每月下载量
1,036 个 Crates 中使用 (通过 include_dir)

MIT 许可证

13KB
282

include_dir

Continuous Integration license Crates.io Docs.rs

include_str!()include_bytes!() 宏的进化,可以将整个目录树嵌入到您的二进制文件中。

渲染的文档

入门

include_dir!() 宏与常规的 include_str!()include_bytes!() 宏非常相似。您将文件路径传递给宏,并将返回值赋给某个 静态 变量。

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 功能)

待办事项列表

  • 压缩?

依赖项

~79KB