v0.54.0 #6425

Xuanwo · 2025-07-17T07:06:43Z

Xuanwo
Jul 17, 2025
Collaborator

Upgrade Notes

Rust Core Public API

RFC-6189: Remove Native Blocking Support

OpenDAL v0.54 implements RFC-6189, which removes all native blocking support in favor of using block_on from async runtimes.

The following breaking changes have been made:

blocking::Operator can no longer be used within async contexts
Using blocking APIs now requires an async runtime
All Blocking* types have been moved to the opendal::blocking module

To migrate:

- use opendal::BlockingOperator;
+ use opendal::blocking::Operator;

RFC-6213: Options Based API

OpenDAL v0.54 implements RFC-6213, which introduces options-based APIs for more structured and extensible operation configuration.

New APIs added:

read_options(path, ReadOptions)
write_options(path, data, WriteOptions)
list_options(path, ListOptions)
stat_options(path, StatOptions)
delete_options(path, DeleteOptions)

Example usage:

// Read with options
let options = ReadOptions::new()
    .range(0..1024)
    .if_match("etag");
let data = op.read_options("path/to/file", options).await?;

// Write with options  
let options = WriteOptions::new()
    .content_type("text/plain")
    .cache_control("max-age=3600");
op.write_options("path/to/file", data, options).await?;

Remove `stat_has_xxx` and `list_has_xxx` APIs

All stat_has_* and list_has_* capability check APIs have been removed. Instead, check capabilities directly on the Capability struct:

- if op.info().full_capability().stat_has_content_length() {
+ if op.info().full_capability().stat.content_length {
    // ...
}

Fix `with_user_metadata` signature

The signature of with_user_metadata has been changed. Please update your code accordingly if you use this method.

Services removed due to lack of maintainer

The following services have been removed due to lack of maintainers:

atomicserver
icloud
nebula_graph

If you need these services, please consider maintaining them or use alternative services.

HttpClientLayer replaces `update_http_client`

The Operator::update_http_client() method has been replaced by HttpClientLayer:

- op.update_http_client(client);
+ op = op.layer(HttpClientLayer::new(client));

Expose `presign_xxx_options` API

New options-based presign APIs have been exposed:

let options = PresignOptions::new()
    .expire(Duration::from_secs(3600));
    
let url = op.presign_read_options("path/to/file", options).await?;

Rust Core Raw API

Remove native blocking support

All native blocking implementations have been removed from the raw API. Services and layers no longer need to implement blocking-specific methods.

Bindings Java Breaking changes

Removed services

The following services have been removed:

Chainsafe service has been removed (PR-5744) - The service has been sunset.
libsql service has been removed (PR-5616) - Dead service removal.

Batch operations removed

PR-5393 removes the batch concept from OpenDAL. All batch-related operations and capabilities have been removed.

Capability changes

write_multi_align_size capability has been removed (PR-5322)
Added new shared capability (PR-5328)

Options-based API

New options classes have been introduced for structured operation configuration:

ReadOptions - for read operations
WriteOptions - for write operations
ListOptions - for list operations
StatOptions - for stat operations

Example usage:

// Read with options
ReadOptions options = ReadOptions.builder()
    .range(0, 1024)
    .ifMatch("etag")
    .build();
byte[] data = operator.read("path/to/file", options);

// Write with options
WriteOptions options = WriteOptions.builder()
    .contentType("text/plain")
    .cacheControl("max-age=3600")
    .build();
operator.write("path/to/file", data, options);

Bindings Python

Breaking change: Native blocking API removed

OpenDAL has removed the native blocking API in the core. The Python binding's blocking API now uses an async runtime internally. This is a transparent change and should not affect most users, but:

The blocking API now requires an async runtime to be available
Performance characteristics may be slightly different
All blocking operations are now implemented as async operations running in a tokio runtime

Breaking change: Removed services

The following services have been removed due to lack of maintainers and users:

atomicserver - This service is no longer supported
icloud - This service is no longer supported
nebula_graph - This service is no longer supported

If you were using any of these services, you'll need to migrate to an alternative storage backend.

Breaking change: Chainsafe service removed

The Chainsafe service has been sunset and is no longer available.

What's Changed

New Contributors

@kezhuw made their first contribution in docs(services/hdfs_native): fix outdated capabilities and config option name #6224
@DerGut made their first contribution in feat(services/azdls): Support parsing Azure Storage configs from connection strings #6212
@chitralverma made their first contribution in feat(bindings/python): Enhance Reader and Writer #6086
@Kinchkun made their first contribution in oli: support dropbox #6265
@oven-yang made their first contribution in fix(hdfs): fix infinite loop in write for HDFS failure #6295
@assignUser made their first contribution in chore(ci): use mlugg/setup-zig instead of archvied action #6310
@sqlpxc made their first contribution in fix(dav-server): Fix create_dir to create nested directories #6321
@MrCroxx made their first contribution in chore: bump msrv to v1.82.0 #6348
@jonathanc-n made their first contribution in feat(services/azdls): Implement write returns metadata #6368

Full Changelog: v0.53.3...v0.54.0

This discussion was created from the release v0.54.0.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

v0.54.0 #6425

Uh oh!

{{title}}

Uh oh!

Replies: 0 comments

Select a reply

Uh oh!

v0.54.0 #6425

Uh oh!

Xuanwo Jul 17, 2025 Collaborator

Upgrade Notes

Rust Core Public API

RFC-6189: Remove Native Blocking Support

RFC-6213: Options Based API

Remove stat_has_xxx and list_has_xxx APIs

Fix with_user_metadata signature

Services removed due to lack of maintainer

HttpClientLayer replaces update_http_client

Expose presign_xxx_options API

Rust Core Raw API

Remove native blocking support

Bindings Java Breaking changes

Removed services

Batch operations removed

Capability changes

Options-based API

Bindings Python

Breaking change: Native blocking API removed

Breaking change: Removed services

Breaking change: Chainsafe service removed

What's Changed

Added

Changed

Fixed

Docs

CI

Chore

New Contributors

Replies: 0 comments

Xuanwo
Jul 17, 2025
Collaborator

Remove `stat_has_xxx` and `list_has_xxx` APIs

Fix `with_user_metadata` signature

HttpClientLayer replaces `update_http_client`

Expose `presign_xxx_options` API