nori-wal¶

Production-ready Write-Ahead Log for Rust with automatic recovery, rotation, and configurable durability.

What is nori-wal?¶

nori-wal is a production-ready write-ahead log (WAL) implementation in Rust. It provides the foundation for durable, crash-safe storage systems.

Key Features¶

Append-only writes with sequential I/O (~110K writes/sec)
Automatic crash recovery with prefix-valid truncation
CRC32C checksumming for corruption detection
Configurable fsync policies (every write, batch, async)
Automatic rotation with size/time triggers
LZ4/Zstd compression support
Zero-copy reads with mmap support

Quick Example¶

use nori_wal::{Wal, WalConfig, Record};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Open WAL with automatic recovery
    let (wal, recovery_info) = Wal::open(WalConfig::default()).await?;

    // Append a record
    let record = Record::put(b"user:42", b"alice@example.com");
    let lsn = wal.append(&record).await?;

    // Iterate over all records
    let mut iter = wal.iter();
    while let Some(entry) = iter.try_next().await? {
        println!("LSN {}: {:?}", entry.lsn, entry.record);
    }

    Ok(())
}