cacache

A high-performance, concurrent, content-addressable disk cache, optimized for async APIs.

Example

use cacache;
use async_attributes;

#[async_attributes::main]
async fn main() -> Result<(), cacache::Error> {
    let dir = String::from("./my-cache");

    // Write some data!
    cacache::write(&dir, "key", b"my-async-data").await?;

    // Get the data back!
    let data = cacache::read(&dir, "key").await?;
    assert_eq!(data, b"my-async-data");

    // Clean up the data!
    cacache::rm::all(&dir).await?;
}

Install

Using cargo-edit

$ cargo add cacache

Minimum supported Rust version is 1.43.0.

Documentation

API Docs

Features

First-class async support, using either async-std or tokio as its runtime. Sync APIs are available but secondary
std::fs-style API
Extraction by key or by content address (shasum, etc)
Subresource Integrity web standard support
Multi-hash support - safely host sha1, sha512, etc, in a single cache
Automatic content deduplication
Atomic content writes even for large data
Fault tolerance (immune to corruption, partial writes, process races, etc)
Consistency guarantees on read and write (full data verification)
Lockless, high-concurrency cache access
Really helpful, contextual error messages
Large file support
Pretty darn fast
Arbitrary metadata storage
Cross-platform: Windows and case-(in)sensitive filesystem support
miette integration for detailed, helpful error reporting.
Punches nazis

async-std is the default async runtime. To use tokio instead, turn off default features and enable the tokio-runtime feature, like this:

[dependencies]
cacache = { version = "*", default-features = false, features = ["tokio-runtime"] }

Contributing

The cacache team enthusiastically welcomes contributions and project participation! There's a bunch of things you can do if you want to contribute! The Contributor Guide has all the information you need for everything from reporting bugs to contributing entire new features. Please don't hesitate to jump in if you'd like to, or even ask us questions if something isn't clear.

All participants and maintainers in this project are expected to follow Code of Conduct, and just generally be excellent to each other.

Happy hacking!

MSRV

The Minimum Supported Rust Version for cacache is 1.67.0. Any changes to the MSRV will be considered breaking changes.

License

This project is licensed under the Apache-2.0 License.

redmar/cacache-rs