https://github.com/zarrs/zarrs_opendal

opendal store support for the zarrs Rust crate
https://github.com/zarrs/zarrs_opendal

Last synced: 5 months ago
JSON representation

opendal store support for the zarrs Rust crate

• Host: GitHub
• URL: https://github.com/zarrs/zarrs_opendal
• Owner: zarrs
• License: apache-2.0
• Created: 2025-07-17T22:37:53.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-07-17T23:24:20.000Z (11 months ago)
• Last Synced: 2025-08-02T15:13:28.629Z (11 months ago)
• Language: Rust
• Size: 43.9 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# zarrs_opendal

[![Latest Version](https://img.shields.io/crates/v/zarrs_opendal.svg)](https://crates.io/crates/zarrs_opendal)

[![opendal 0.55](https://img.shields.io/badge/opendal-0.55-blue)](https://crates.io/crates/opendal)

[![zarrs_opendal documentation](https://docs.rs/zarrs_opendal/badge.svg)](https://docs.rs/zarrs_opendal)

![msrv](https://img.shields.io/crates/msrv/zarrs_opendal)

[![build](https://github.com/zarrs/zarrs_opendal/actions/workflows/ci.yml/badge.svg)](https://github.com/zarrs/zarrs_opendal/actions/workflows/ci.yml)

[![codecov](https://codecov.io/gh/zarrs/zarrs_opendal/graph/badge.svg)](https://codecov.io/gh/zarrs/zarrs_opendal)

[`opendal`](https://crates.io/crates/opendal) store support for the [`zarrs`](https://crates.io/crates/zarrs) Rust crate.

```rust

use zarrs_storage::AsyncReadableStorage;

use zarrs_opendal::AsyncOpendalStore;

let builder = opendal::services::Http::default().endpoint("http://...");

let operator = opendal::Operator::new(builder)?.finish();

let store: AsyncReadableStorage = Arc::new(AsyncOpendalStore::new(operator));

```

## Version Compatibility Matrix

See [doc/version_compatibility_matrix.md](./doc/version_compatibility_matrix.md).

`opendal` is re-exported as a dependency of this crate, so it does not need to be specified as a direct dependency.

However, if `opendal` is a direct dependency, it is necessary to ensure that the version used by this crate is compatible.

This crate can depend on a range of semver-incompatible versions of `opendal`, and Cargo will not automatically choose a single version of `opendal` that satisfies all dependencies.

Use a precise cargo update to ensure compatibility.

For example, if this crate resolves to `opendal` 0.53.0 and your code uses 0.52.0:

```shell

cargo update --package opendal:0.53.0 --precise 0.52.0

```

## Licence

`zarrs_opendal` is licensed under either of

 - the Apache License, Version 2.0 [LICENSE-APACHE](./LICENCE-APACHE) or  or

 - the MIT license [LICENSE-MIT](./LICENCE-MIT) or , at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.