Apache OpenDAL™

OpenDAL is a data access layer that allows users to easily and efficiently retrieve data from various storage services in a unified way.

• Documentation: stable | main
• Release notes

Services

Welcome to add any services that are not currently supported here.

Features

Access data freely

• Access different storage services in the same way
• Behavior tests for all services

Access data painlessly

• 100% documents covered
• Powerful Layers
• Automatic retry support
• Full observability: logging, tracing, metrics.
• Native chaos testing

Access data efficiently

• Zero cost: Maps to API calls directly
• Best effort: Automatically selects best read/seek/next based on services
• Avoid extra calls: Reuses metadata when possible

Quickstart

use opendal::Result;
use opendal::layers::LoggingLayer;
use opendal::services;
use opendal::Operator;

#[tokio::main]
async fn main() -> Result<()> {
    // Pick a builder and configure it.
    let mut builder = services::S3::default();
    builder.bucket("test");

    // Init an operator
    let op = Operator::new(builder)?
        // Init with logging layer enabled.
        .layer(LoggingLayer::default())
        .finish();

    // Write data
    op.write("hello.txt", "Hello, World!").await?;

    // Read data
    let bs = op.read("hello.txt").await?;

    // Fetch metadata
    let meta = op.stat("hello.txt").await?;
    let mode = meta.mode();
    let length = meta.content_length();

    // Delete
    op.delete("hello.txt").await?;

    Ok(())
}

Examples

The examples are available at here.

Contributing

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

License and Trademarks

Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0

Apache OpenDAL, OpenDAL, and Apache are either registered trademarks or trademarks of the Apache Software Foundation.