Commit Log

Commit log library for rust. It is intended to be used in various higher-level distributed abstractions on top of a distributed log.

Documentation

Usage

First, add this to your Cargo.toml:

[dependencies]
commitlog = "0.0.5"

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(ReadPosition::Beginning, ReadLimit::Messages(2)).unwrap();
    for msg in messages.iter() {
        println!("{} - {}", msg.offset(), String::from_utf8_lossy(msg.payload()));
    }

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

Prior Art

• Apache Kafka
• Jocko + EXCELLENT Blog Post