carbites

Crates.iocarbites
lib.rscarbites
version0.1.2
sourcesrc
created_at2023-04-30 13:37:43.177194
updated_at2023-05-23 13:11:22.426463
descriptionCAR file splitted implementation in Rust
homepage
repositoryhttps://github.com/tarassh/carbites
max_upload_size
id852773
size371,234
(tarassh)

documentation

README

carbites

Chunking for CAR files. Split a single CAR into multiple CARs.

Original implementation in go-carbites.

Usage

Carbites supports treewalk strategy:

Treewalk - walks the DAG to pack sub-graphs into each CAR file that is output. Every CAR file has the same root CID but contains a different portion of the DAG. The DAG is traversed from the root node and each block is decoded and links extracted in order to determine which sub-graph to include in each CAR.

use carbites::{new_splitter, CarSplitter, Strategy};
use std::io::Write;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let file = std::fs::File::open("examples/test.car")?;
    let mut splitter = new_splitter(Strategy::Treewalk, file, 1024);

    let mut i = 0;
    while let Some(chunk) = splitter.next_chunk()? {
        let mut file = std::fs::File::create(format!("target/chunk-{}.car", i))?;
        file.write(&chunk)?;
        i += 1;
    }

    Ok(())
}

Todo

  • Add support for simple strategy (see below)

Simple - fast but naive, only the first CAR output has a root CID, subsequent CARs have a placeholder "empty" CID. The first CAR output has roots in the header, subsequent CARs have an empty root CID bafkqaaa as recommended.

License

Licensed under either of

at your option.

Commit count: 5

cargo fmt