库文件

将 paq 添加到 Cargo.toml 中的项目依赖项。

使用库

use paq;

let source = std::path::PathBuf::from("/path/to/source");
let ignore_hidden = true; // .dir or .file
let source_hash: paq::ArrayString<64> = paq::hash_source(&source, ignore_hidden);

println!("{}", source_hash);

哈希示例目录

use paq;

let source = std::path::PathBuf::from("example");
let ignore_hidden = true;
let source_hash: paq::ArrayString<64> = paq::hash_source(&source, ignore_hidden);

assert_eq!(&source_hash[..], "a593d18de8b696c153df9079c662346fafbb555cc4b2bbf5c7e6747e23a24d74");

如果将 ignore_hidden 设置为 false，可能会得到不同的结果。

内容限制

哈希是通过将文件系统内容作为输入数据输入到 blake3 哈希算法中生成的。

按照设计，paq 不将文件系统元数据包括在哈希输入中，例如

• 文件模式
• 文件所有权
• 文件修改和访问时间
• 文件 ACLs 和扩展属性
• 硬链接
• 软链接目标内容（目标路径被哈希处理）

此外，以点或句点开头的文件或目录内容（可选）可以被忽略。

工作原理

1. 递归获取给定源参数的路径。
2. 如果路径指向文件，则对每个路径和文件内容进行哈希处理。
3. 对哈希列表进行排序，以保持一致的顺序。
4. 通过哈希哈希列表来计算最终的哈希。

许可证

MIT