13 releases

0.2.0 Nov 6, 2021
0.1.3 Mar 6, 2021
0.1.2 Jul 4, 2020
0.1.1 Aug 29, 2019
0.0.1 Nov 26, 2016

#737 in Data structures

Download history 38/week @ 2024-11-30 60/week @ 2024-12-07 68/week @ 2024-12-14 10/week @ 2024-12-21 6/week @ 2024-12-28 28/week @ 2025-01-04 60/week @ 2025-01-11 44/week @ 2025-01-18 52/week @ 2025-01-25 127/week @ 2025-02-01 54/week @ 2025-02-08 44/week @ 2025-02-15 45/week @ 2025-02-22 30/week @ 2025-03-01 36/week @ 2025-03-08 43/week @ 2025-03-15

158 downloads per month
Used in 3 crates

MIT license

105KB
2.5K SLoC

Commit Log

Sequential, disk-backed commit log library for Rust. The library can be used in various higher-level distributed abstractions on top of a distributed log such as Paxos, Chain Replication or Raft.

Crates.io Docs.rs Travis

Documentation

Usage

First, add this to your Cargo.toml:

[dependencies]
commitlog = "0.1"
extern crate commitlog;

use commitlog::*;

fn main() {
    // open a directory called 'log' for segment and index storage
    let opts = LogOptions::new("log");
    let mut log = CommitLog::new(opts).unwrap();

    // append to the log
    log.append("hello world").unwrap(); // offset 0
    log.append("second message").unwrap(); // offset 1

    // read the messages
    let messages = log.read(0, ReadLimit::default()).unwrap();
    for msg in messages.iter() {
        println!("{} - {}", msg.offset(), String::from_utf8_lossy(msg.payload()));
    }

    // prints:
    //    0 - hello world
    //    1 - second message
}

Prior Art

Dependencies

~0.5–0.8MB
~11K SLoC