Lib.rs

为 Rust 应用程序提供写入前日志。 写入前日志是数据持久性应用程序的关键组件。很多时候，将新数据（或现有数据的修改）刷新并同步到磁盘数据结构（如索引）是不高效的。写入前日志通过将写操作追加到磁盘并进行同步来促进，允许应用程序以最有效的方式预处理一批写操作并将它们写入磁盘结构。

目标

• 将写操作序列化到追加日志文件。
• 生成单调递增的 序列号 并将其返回给应用程序。
• 可配置的日志文件限制，超过限制后日志文件将轮换。
• 可配置的 fsync，以确保持久性。
• 按单调递增的 seqno 顺序遍历日志文件中持久化的所有条目。
• 通过 start-seqno 和 end-seqno 指定的子集遍历条目。
• Wal 类型由状态类型 S 参数化。这对于使用 Wal 类型与一致性协议（如 Raft）一起使用很有帮助。
• 对单个日志实例进行并发读写。

并发

单个日志实例可以被克隆并在多个线程之间共享以进行并发读写。所有写操作都是序列化的。虽然读写操作是互斥的，但允许并发读取。

性能

使用不同负载大小和启用 fsync 的单线程写入性能。

使用恒定负载大小（每个操作100字节）和启用 fsync 的多线程写入性能。

使用恒定负载大小（每个操作100字节）和启用 fsync 的多线程读取性能。

贡献

• 简单的工作流程。Fork - 修改 - 提交请求。
• 在创建 PR 之前，
  • 运行 make build 以确认所有构建版本均通过，无警告且无错误。
  • 运行 check.sh，无警告，无错误，所有测试用例通过。
  • 运行 perf.sh，无警告，无错误，所有测试用例通过。
  • 安装 并运行 cargo spellcheck 以去除常见的拼写错误。
• 首选 开发者证书来源。