NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io, #2447 most downloaded on crates.io
Apache OpenDAL™: One Layer, All Storage.
Latest stable
0.59.5
Last release 1 months ago
18 Oct 2026
Release timing varies
gaps range from 1 weeks to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
5 years old
161 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
feat: Enable retry layer by default by @Xuanwo in https://github.com/datafuselabs/opendal/pull/781
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.18.1...v0.18.2
docs: Fix wrong link to object_store by @Xuanwo in https://github.com/datafuselabs/opendal/pull/773
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.18.0...v0.18.1
OpenDAL v0.18 introduces the following breaking changes:
OpenDAL v0.18 introduces the following breaking changes:
services-http has been removed.DirXxx items have been renamed to ObjectXxx to make them more consistent.
DirEntry -> ObjectEntryDirStream -> ObjectStreamDirStreamer -> ObjectStreamDirIterate -> ObjectIterateDirIterator -> ObjectIteratorBesides, we also make a big change to our ObjectEntry API. Since v0.18, we can fully reuse the metadata that fetched during list. Take entry.content_length() for example:
content_lenght is already known, we will return directly.complete:
complete, the entry already fetched all metadata that it could have, return directly.stat call to get the metadata and refresh our cache.This change means:
content_length will be changed into async functions.metadata and blocking_metadata will not return errors anymore.entry.into_object().metadata() instead.Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.17.4...v0.18.0
fix(http_util): Allow retry more errors by @Xuanwo in https://github.com/datafuselabs/opendal/pull/724
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.17.3...v0.17.4
feat: Add SubdirLayer to allowing switch directory by @Xuanwo in https://github.com/datafuselabs/opendal/pull/718
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.17.2...v0.17.3
fix(services/fs): Handle slash normalized false positives properly by @damooo in https://github.com/datafuselabs/opendal/pull/702
enable_secure in FTP service. by @ClSlaid in https://github.com/datafuselabs/opendal/pull/709Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.17.1...v0.17.2
enable_secure in FTP service (#709)feat: redis service implement by @ClSlaid in https://github.com/datafuselabs/opendal/pull/679
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.17.0...v0.17.1
OpenDAL v0.17 refactor the Accessor to make space for future features.
OpenDAL v0.17 refactor the Accessor to make space for future features.
We move path String out of the OpXxx to function args so that we don't need to clone twice.
- async fn read(&self, args: OpRead) -> Result<BytesReader>
+ async fn read(&self, path: &str, args: OpRead) -> Result<BytesReader>
For more information about this change, please refer to RFC-0661: Path In Accessor.
And since OpenDAL v0.17, we will use rustls as default tls engine for our underlying http client. Since this release, we will not depend on openssl anymore.
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.16.0...v0.17.0
Accompany by these changes, http service has the following breaking changes:
OpenDAL v0.16 refactor the internal implementation of http service. Since v0.16, http service can be used directly without enabling services-http feature. Accompany by these changes, http service has the following breaking changes:
services-http feature has been deprecated. Enabling services-http is a no-op now.list or write.OpenDAL introduces a new layer ImmutableIndexLayer that can add list capability for services:
use opendal::layers::ImmutableIndexLayer;
use opendal::Operator;
use opendal::Scheme;
async fn main() {
let mut iil = ImmutableIndexLayer::default();
for i in ["file", "dir/", "dir/file", "dir_without_prefix/file"] {
iil.insert(i.to_string())
}
let op = Operator::from_env(Scheme::Http)?.layer(iil);
}
For more information about this change, please refer to RFC-0627: Split Capabilities.
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.15.0...v0.16.0
ci: Add alias domains support by @Xuanwo in https://github.com/datafuselabs/opendal/pull/600
BytesReader and DirStreamer by @ClSlaid in https://github.com/datafuselabs/opendal/pull/603Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.14.1...v0.15.0
BytesReader and DirStreamer (#603)docs: Add obs in OpenDAL lib docs by @Xuanwo in https://github.com/datafuselabs/opendal/pull/585
0.., don't insert range header by @Xuanwo in https://github.com/datafuselabs/opendal/pull/592Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.14.0...v0.14.1
0.., don't insert range header (#592)OpenDAL v0.14 removed all deprecated APIs in previous versions, including:
OpenDAL v0.14 removed all deprecated APIs in previous versions, including:
Operator::with_backoff in v0.13Builder::finish() in v0.12Backend::build() in v0.12Please visit related version's upgrade guide for migration.
And in OpenDAL v0.14, we introduce a break change for write operations.
pub trait Accessor {
- async fn write(&self, args: &OpWrite) -> Result<BytesWriter> {}
+ async fn write(&self, args: &OpWrite, r: BytesReader) -> Result<u64> {}
}
The following APIs have affected by this change:
Object::write now accept impl Into<Vec<u8>> instead of AsRef<&[u8]>Object::writer has been removed.Object::write_from has been added to support write from a reader.Accessor trait.For more information about this change, please refer to RFC-0554: Write Refactor.
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.13.1...v0.14.0
chore: Crates.io doesn't allow keywords more than five by @Xuanwo in https://github.com/datafuselabs/opendal/pull/539
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.13.0...v0.13.1
OpenDAL deprecate Operator::with_backoff since v0.13.
OpenDAL deprecate Operator::with_backoff since v0.13.
Please use RetryLayer instead:
use anyhow::Result;
use backon::ExponentialBackoff;
use opendal::layers::RetryLayer;
use opendal::Operator;
use opendal::Scheme;
let _ = Operator::from_env(Scheme::Fs)
.expect("must init")
.layer(RetryLayer::new(ExponentialBackoff::default()));
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.12.0...v0.13.0
OpenDAL introduces breaking changes for services initiation.
OpenDAL introduces breaking changes for services initiation.
Since v0.12, Operator::new will accept impl Accessor + 'static instead of Arc<dyn Accessor>:
impl Operator {
pub fn new(accessor: impl Accessor + 'static) -> Self { .. }
}
Every service's Builder now have a build() API which can be run without async:
let mut builder = fs::Builder::default();
let op: Operator = Operator::new(builder.build()?);
Along with these changes, Operator::from_iter and Operator::from_env now is a blocking API too.
For more information about this change, please refer to RFC-0501: New Builder.
The following APIs have been deprecated:
Builder::finish() (replaced by Builder::build())Backend::build() (replace by Builder::default())The following APIs have been removed:
Metadata (deprecated in v0.8, replaced by ObjectMetadata)Visit Upgrade Notes for more information.
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.11.4...v0.12.0
feat: try to support epoll by @PsiACE in https://github.com/datafuselabs/opendal/pull/478
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.11.3...v0.11.4
build: Remove not used features by @Xuanwo in https://github.com/datafuselabs/opendal/pull/472
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.11.2...v0.11.3
chore(deps): Bump clap from 3.2.8 to 3.2.12 in /oli by @dependabot in https://github.com/datafuselabs/opendal/pull/453
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.11.1...v0.11.2
RFC-0438: Multipart by @Xuanwo in https://github.com/datafuselabs/opendal/pull/438
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.11.0...v0.11.1
feat: derive Deserialize/Serialize for ObjectMetaData by @killme2008 in https://github.com/datafuselabs/opendal/pull/420
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.10.0...v0.11.0
RFC-0409: Accessor Capabilities by @Xuanwo in https://github.com/datafuselabs/opendal/pull/409
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.9.1...v0.10.0
feat(object): Add ETag support by @Xuanwo in https://github.com/datafuselabs/opendal/pull/381
size to 0.4 by @mqudsi in https://github.com/datafuselabs/opendal/pull/392Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.9.0...v0.9.1
size to 0.4 (#392)docs: Add concepts for Accessor, Operator and Object by @Xuanwo in https://github.com/datafuselabs/opendal/pull/354
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.8.0...v0.9.0
RFC-0337: Dir Entry by @Xuanwo in https://github.com/datafuselabs/opendal/pull/337
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.7.3...v0.8.0
fix(services/s3,hdfs): List empty dir should not return itself by @Xuanwo in https://github.com/datafuselabs/opendal/pull/327
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.7.2...v0.7.3
feat(io_util): Improve debug logging for compress by @Xuanwo in https://github.com/datafuselabs/opendal/pull/310
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.7.1...v0.7.2
fix(io_util/compress): Decompress read exit too early by @Xuanwo in https://github.com/datafuselabs/opendal/pull/308
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.7.0...v0.7.1
chore(deps): Update quick-xml requirement from 0.22.0 to 0.23.0 by @dependabot in https://github.com/datafuselabs/opendal/pull/286
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.6.3...v0.7.0
ci: Add all issues into databend-storage project by @Xuanwo in https://github.com/datafuselabs/opendal/pull/277
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.6.2...v0.6.3
fix(azblob): Request URL not construct correctly by @Xuanwo in https://github.com/datafuselabs/opendal/pull/270
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.6.1...v0.6.2
feat: Add hdfs scheme by @Xuanwo in https://github.com/datafuselabs/opendal/pull/266
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.6.0...v0.6.1
refactor: Remove deprecated modules by @Xuanwo in https://github.com/datafuselabs/opendal/pull/259
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.5.2...v0.6.0
chore: Build all features for docs.rs by @Xuanwo in https://github.com/datafuselabs/opendal/pull/238
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.5.1...v0.5.2
fix(services/fs): Create on existing dir should succeed by @Xuanwo in https://github.com/datafuselabs/opendal/pull/234
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.5.0...v0.5.1
This release introduces the following new features:
This release introduces the following new features:
Now, we can create an empty file or directory without a trick!
Read Object::create to know more!
let o = op.object("path/to/file");
let _ = o.create().await?;
let o = op.object("path/to/dir/");
let _ = o.create().await?;
Now, we can read a compressed file natively!
Enable compress features:
opendal = {version="0.5.0", feautres=["compress"]}
Read with decompress_read() or decompress_reader()!
let o = op.object("path/to/file.gz");
let bs = o.decompress_read().await?;
With the help from @D2Lark, we have official support for azblob now!
Refer to azblob for more information.
// Create azblob backend builder.
let mut builder: Builder = azblob::Backend::build();
// Set the root for azblob, all operations will happen under this root.
//
// NOTE: the root must be absolute path.
builder.root("/path/to/dir");
// Set the container name, this is required.
builder.container("test");
// Set the endpoint, this is required.
//
// For examples:
// - "http://127.0.0.1:10000/devstoreaccount1"
// - "https://accountname.blob.core.windows.net"
builder.endpoint("http://127.0.0.1:10000/devstoreaccount1");
// Set the account_name and account_key.
//
// OpenDAL will try load credential from the env.
// If credential not set and no valid credential in env, OpenDAL will
// send request without signing like anonymous user.
builder.account_name("devstoreaccount1");
builder.account_key("Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==");
// Build the `Accessor`.
let accessor: Arc<dyn Accessor> = builder.finish().await?;
// `Accessor` provides the low level APIs, we will use `Operator` normally.
let op: Operator = Operator::new(accessor);
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.4.2...v0.5.0
feat: Add seekable_reader on Object by @Xuanwo in https://github.com/datafuselabs/opendal/pull/215
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.4.1...v0.4.2
docs: Fix typo in CHANGELOG by @Xuanwo in https://github.com/datafuselabs/opendal/pull/211
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.4.0...v0.4.1
OpenDAL introduces many breaking changes in v0.4.
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.3.0...v0.4.0
Refer to Upgrade From v0.3 to v0.4 section for more upgrade details.
OpenDAL introduces many breaking changes in v0.4.
AsyncSeek anymoreSince v0.4, Object::reader() will return impl BytesRead instead of Reader that implements AsyncRead and AsyncSeek. Users who want AsyncSeek please wrapped with opendal::io_util::seekable_read:
use opendal::io_util::seekable_read;
let o = op.object("test");
let mut r = seekable_read(&o, 10..);
r.seek(SeekFrom::Current(10)).await?;
let mut bs = vec![0;10];
r.read(&mut bs).await?;
Since v0.4, the following APIs will be removed.
Object::limited_reader(size: u64)Object::offset_reader(offset: u64)Object::range_reader(offset: u64, size: u64)Instead, OpenDAL is providing a more general range_reader powered by RangeBounds:
pub async fn range_reader(&self, range: impl RangeBounds<u64>) -> Result<impl BytesRead>
Users can use their familiar rust range syntax:
let r = o.range_reader(1024..2048).await?;
Since v0.4, all functions in OpenDAL will return std::io::Result instead.
Please check via std::io::ErrorKind directly:
use std::io::ErrorKind;
if let Err(e) = op.object("test_file").metadata().await {
if e.kind() == ErrorKind::NotFound {
println!("object not exist")
}
}
Since v0.4, Credential has been removed, please use the API provided by Builder directly.
builder.access_key_id("access_key_id");
builder.secret_access_key("secret_access_key");
BytesWriter insteadSince v0.4, Accessor::write will return a BytesWriter instead accepting a BoxedAsyncReader.
Along with this change, the old Writer has been replaced by a new set of write functions:
pub async fn write(&self, bs: impl AsRef<[u8]>) -> Result<()> {}
pub async fn writer(&self, size: u64) -> Result<impl BytesWrite> {}
Users can write into an object more easily:
let _ = op.object("path/to/file").write("Hello, World!").await?;
io_util replaces readersSince v0.4, mod io_util will replace readers. In io_utils, OpenDAL provides helpful functions like:
into_reader: Convert BytesStream into BytesReadinto_sink: Convert BytesWrite into BytesSinkinto_stream: Convert BytesRead into BytesStreaminto_writer: Convert BytesSink into BytesWriteobserve_read: Add callback for BytesReaderobserve_write: Add callback for BytesWriteFor better naming, types that OpenDAL returns have been renamed:
AsyncRead + Unpin + Send => BytesReadBoxedAsyncReader => BytesReaderAsyncWrite + Unpin + Send => BytesWriteBoxedAsyncWriter => BytesWriterObjectStream => ObjectStreamerRefer to Upgrade From v0.3 to v0.4 section for more upgrade details.
add azure blob support by @D2Lark in https://github.com/datafuselabs/opendal/pull/165
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.2.5...v0.3.0
feat: Adopt quick_xml to parse xml
feat: Add content_md5 and last_modified in metadata
feat: Export BoxedObjectStream so that users can implement Layer
services/fs: Refactor via tokio::fs
feat(service): Add service memory read support
examples: Add more examples for services and operations
services/s3: Implement anonymous read support
RFC and implementations for limited reader
object: Polish API for Metadata
RFC and implementation of feature Object Stream
docs: Add README for behavior test and ops benchmarks
io: Remove not used debug print
readers: Allow config prefetch size
benches: Implement benches for ops
tests: Implement behavior tests
Full Changelog: https://github.com/datafuselabs/opendal/compare/v0.0.1...v0.0.2
@Xuanwo made their first contribution in https://github.com/datafuselabs/opendal/pull/2
Hello, OpenDAL!
Full Changelog: https://github.com/datafuselabs/opendal/commits/v0.0.1
Nothing published for this version
One column per quarter.