OpenDAL

Open Data Access Layer that connect the whole world together.

You may be looking for:

Status

OpenDAL is in alpha stage and has been early adopted by databend. Welcome any feedback at Discussions!

Supported Services

fs: POSIX alike file system.
memory: In memory backend support.
s3: AWS S3 alike services.

Quickstart

use anyhow::Result;
use futures::AsyncReadExt;
use futures::StreamExt;
use opendal::services::fs;
use opendal::ObjectMode;
use opendal::Operator;

#[tokio::main]
async fn main() -> Result<()> {
    let op = Operator::new(fs::Backend::build().root("/tmp").finish().await?);

    let o = op.object("test_file");

    // Write data info file;
    let _ = o.write("Hello, World!").await?;

    // Read data from file;
    let bs = o.read().await?;

    // Read range from file;
    let bs = o.range_read(1..=11).await?;

    // Get file's Metadata
    let meta = o.metadata().await?;

    // List dir.
    let mut obs = op.objects("").await?.map(|o| o.expect("list object"));
    while let Some(o) = obs.next().await {
        let meta = o.metadata().await?;
        let path = meta.path();
        let mode = meta.mode();
        let length = meta.content_length();
    }

    // Delete file.
    o.delete().await?;

    Ok(())
}

More examples could be found at examples.

Contributing

Check out the CONTRIBUTING.md guide for more details on getting started with contributing to this project.

Getting help

Submit issues for bug report or asking questions in discussion.