Bump to version 0.20.0 (#961)

* Bump to version 0.20.0 Signed-off-by: Xuanwo <[email protected]> * Fix build Signed-off-by: Xuanwo <[email protected]> Signed-off-by: Xuanwo <[email protected]>
apache · Nov 17, 2022 · 44e9356 · 44e9356 · github-actions · Nov 17, 2022
1 parent c31cff0
commit 44e9356
Show file tree

Hide file tree

Showing 7 changed files with 72 additions and 48 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,20 +5,51 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [v0.20.0] - 2022-11-17
+
+### Added
+
+- RFC-0926: Object Reader (#926)
+- feat: Implement Object Reader (#928)
+- feat(services/s3): Return Object Meta for Read operation (#932)
+- feat: Implement Bytes Content Range (#933)
+- feat: Add Content Range support in ObjectMetadata (#935)
+- feat(layers/content_cache): Implement WholeCacheReader (#936)
+- feat: CompressAlgorithm derive serde. (#939)
+- feat: Allow using opendal without tls support (#945)
+- refactor: Refactor OpRead with BytesRange (#946)
+- feat: Allow using opendal with native tls support (#949)
+- docs: add docs for tls dependencies features (#951)
+- feat: Make ObjectReader content_length returned for all services (#954)
+- feat(layers): Implement fixed content cache (#953)
+- feat: Enable default_ttl support for redis (#960)
+
+### Changed
+
+- refactor: Return ObjectReader in Accessor::read (#929)
+- refactor(oay,oli): drop unnecessary patch.crates-io from `Cargo.toml`
+- refactor: Polish bytes range (#950)
+- refactor: Use simplifed kv adapter instead (#959)
+
+### Fixed
+
+- fix(ops): Fix suffix range behavior of bytes range (#942)
+- fix: Fix cache path not used correctly (#958)
+
 ## [v0.19.8] - 2022-11-13
 
-## Added
+### Added
 
 - feat(services/moka): Use entry's bytes as capacity weigher (#914)
 - feat: Implement rocksdb service (#913)
 
-## Changed
+### Changed
 
 - refactor: Reduce backend builder log level to debug (#907)
 - refactor: Remove deprecated features (#920)
 - refactor: use moka::sync::SegmentedCache (#921)
 
-## Fixed
+### Fixed
 
 - fix(http): Check already read size before returning (#919)
 
@@ -938,6 +969,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 Hello, OpenDAL!
 
+[v0.20.0]: https://github.com/datafuselabs/opendal/compare/v0.19.8...v0.20.0
 [v0.19.8]: https://github.com/datafuselabs/opendal/compare/v0.19.7...v0.19.8
 [v0.19.7]: https://github.com/datafuselabs/opendal/compare/v0.19.6...v0.19.7
 [v0.19.6]: https://github.com/datafuselabs/opendal/compare/v0.19.5...v0.19.6

diff --git a/Cargo.toml b/Cargo.toml
@@ -9,7 +9,7 @@ keywords = ["storage", "fs", "s3", "azblob", "gcs"]
 license = "Apache-2.0"
 name = "opendal"
 repository = "https://github.com/datafuselabs/opendal"
-version = "0.19.8"
+version = "0.20.0"
 
 [package.metadata.docs.rs]
 all-features = true

diff --git a/docs/upgrade.md b/docs/upgrade.md
@@ -2,6 +2,34 @@
 
 This document intends to record upgrade and migrate procedures while OpenDAL meets breaking changes.
 
+## Upgrade to v0.20
+
+v0.20 is a big release that we introduce a lot of performance related changes.
+
+To make the best of information from `read` operation, we propose and implemented [RFC-0926: Object Reader](https://opendal.databend.rs/rfcs/0926-object-reader.html). By this RFC, we can fetch content length from `ObjectReader` now!
+
+```rust
+pub struct ObjectReader {
+    inner: BytesReader
+    meta: ObjectMetadata,
+}
+
+impl ObjectReader {
+    pub fn content_length(&self) -> u64 {}
+    pub fn last_modified(&self) -> Option<OffsetDateTime> {}
+    pub fn etag(&self) -> Option<String> {}
+}
+```
+
+To make this happen, we changed our `Accessor` API:
+
+```diff
+- async fn read(&self, path: &str, args: OpRead) -> Result<BytesReader> {}
++ async fn read(&self, path: &str, args: OpRead) -> Result<ObjectReader> {}
+```
+
+All layers should be updated to meet this change. Also, it's required to return `content_length` while building `ObjectReader`. Please make sure the returning `ObjectMetadata` is used correctly.
+
 ## Upgrade to v0.19
 
 OpenDAL deprecate some features:

diff --git a/oay/Cargo.lock b/oay/Cargo.lock
diff --git a/oay/Cargo.toml b/oay/Cargo.toml
@@ -17,7 +17,7 @@ clap = { version = "4", features = ["cargo"] }
 env_logger = "0.9"
 futures = "0.3"
 log = "0.4"
-opendal = { version = "0.19", path = "../" }
+opendal = { version = "0.20", path = "../" }
 percent-encoding = "2"
 sluice = "0.5"
 tokio = { version = "1.20", features = ["rt-multi-thread", "macros"] }
diff --git a/oli/Cargo.lock b/oli/Cargo.lock
diff --git a/oli/Cargo.toml b/oli/Cargo.toml
@@ -15,7 +15,7 @@ anyhow = "1"
 clap = { version = "4", features = ["cargo", "string"] }
 env_logger = "0.9"
 log = "0.4"
-opendal = { version = "0.19", path = "../" }
+opendal = { version = "0.20", path = "../" }
 tokio = { version = "1.20", features = ["fs", "macros", "rt-multi-thread"] }
 
 [dev-dependencies]