Upgrade to v0.27
In v0.27, we refactored our list related logic and added scan support. So make Pager and BlockingPager associated types in Accessor too!
pub trait Accessor: Send + Sync + Debug + Unpin + 'static {
type Reader: output::Read;
type BlockingReader: output::BlockingRead;
+ type Pager: output::Page;
+ type BlockingPager: output::BlockingPage;
}User defined layers
Due to this change, all layers implementation should be changed. If there is not changed over pager, they can by changed like the following:
impl<A: Accessor> LayeredAccessor for MyAccessor<A> {
type Inner = A;
type Reader = MyReader<A::Reader>;
type BlockingReader = MyReader<A::BlockingReader>;
+ type Pager = A::Pager;
+ type BlockingPager = A::BlockingPager;
+ async fn list(&self, path: &str, args: OpList) -> Result<(RpList, Self::Pager)> {
+ self.inner.list(path, args).await
+ }
+ async fn scan(&self, path: &str, args: OpScan) -> Result<(RpScan, Self::Pager)> {
+ self.inner.scan(path, args).await
+ }
+ fn blocking_list(&self, path: &str, args: OpList) -> Result<(RpList, Self::BlockingPager)> {
+ self.inner.blocking_list(path, args)
+ }
+ fn blocking_scan(&self, path: &str, args: OpScan) -> Result<(RpScan, Self::BlockingPager)> {
+ self.inner.blocking_scan(path, args)
+ }
}Usage of ops
To reduce the understanding overhead, we move all OpXxx into opendal::ops now. User may need to change:
- use opendal::OpWrite;
+ use opendal::ops::OpWrite;Usage of RetryLayer
backon is the implementation detail of our RetryLayer, so we hide it from our public API. Users of RetryLayer need to change the code like:
- RetryLayer::new(backon::ExponentialBackoff::default())
+ RetryLayer::new()What's Changed
- ci: Fix dev container Dockerfile by @PsiACE in #1298
- fix: Rocksdb's scheme not output correctly by @Xuanwo in #1300
- refactor: Hide backon from our public API by @Xuanwo in #1302
- refactor: Don't expose ops structs to users directly by @Xuanwo in #1303
- feat: Add Retryable Pager Support by @ClSlaid in #1304
- refactor: Move and rename ObjectPager and ObjectEntry for more clear semantics by @Xuanwo in #1308
- refactor: Implement strong typed pager by @Xuanwo in #1311
- feat: Add Sled support by @jkleinknox in #1305
- chore: fix name typo in oss backend by @wcy-fdu in #1316
- feat: Add Object::scan() support by @Xuanwo in #1314
- feat: Add object page size support by @Xuanwo in #1318
- chore: Add typos-cli and fix typos by @Xuanwo in #1320
- deps: remove unused deps by @xxchan in #1321
- docs: Add risingwave in projects by @Xuanwo in #1322
- refactor: Extract scan as a new API and remove ListStyle by @Xuanwo in #1324
- Bump to version 0.27 by @Xuanwo in #1325
New Contributors
- @jkleinknox made their first contribution in #1305
- @wcy-fdu made their first contribution in #1316
- @xxchan made their first contribution in #1321
Full Changelog: v0.26.2...v0.27.0