Bump to version 0.26.2 (#1296)

* Bump to version 0.26.2

Signed-off-by: Xuanwo <[email protected]>

* Fix docs

Signed-off-by: Xuanwo <[email protected]>

---------

Signed-off-by: Xuanwo <[email protected]>

CHANGELOG.md

@@ -5,6 +5,30 @@ 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.26.2] - 2023-02-07
+
+### Added
+
+- feat: Add ChaosLayer to inject errors into underlying services (#1287)
+- feat: Implement retry reader (#1291)
+- feat: use std::path::Path for fs backend (#1100)
+- feat: Implement services webhdfs (#1263)
+
+### Changed
+
+- refactor: Split CompleteReaderLayer from TypeEraserLayer (#1290)
+- refactor(services/fs): Remove not needed generic (#1292)
+
+### Docs
+
+- docs: fix typo (#1285)
+- docs: Polish docs for better reading (#1288)
+
+### Fixed
+
+- fix: FsBuilder can't be used with empty root anymore (#1293)
+- fix: Fix retry happened in seek's read ahead logic (#1294)
+
 ## [v0.26.1] - 2023-02-05
 
 ### Changed
@@ -1287,6 +1311,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 Hello, OpenDAL!
 
+[v0.26.2]: https://github.com/datafuselabs/opendal/compare/v0.26.1...v0.26.2
 [v0.26.1]: https://github.com/datafuselabs/opendal/compare/v0.26.0...v0.26.1
 [v0.26.0]: https://github.com/datafuselabs/opendal/compare/v0.25.2...v0.26.0
 [v0.25.2]: https://github.com/datafuselabs/opendal/compare/v0.25.1...v0.25.2

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.26.1"
+version = "0.26.2"
 # MSRV of OpenDAL. Please update this field while bump.
 rust-version = "1.60"
 

src/scheme.rs

@@ -73,7 +73,7 @@ pub enum Scheme {
     S3,
     /// [webdav][crate::services::Webdav]: WebDAV support.
     Webdav,
-    /// [webhdfs][crate::services::WebHdfs]: WebHDFS RESTful API Services
+    /// [webhdfs][crate::services::Webhdfs]: WebHDFS RESTful API Services
     Webhdfs,
     /// Custom that allow users to implement services outside of OpenDAL.
     ///

src/services/hdfs/backend.rs

@@ -44,6 +44,10 @@ use crate::*;
 /// - [ ] ~~multipart~~
 /// - [x] blocking
 ///
+/// # Differences with webhdfs
+///
+/// [Webhdfs][crate::services::Webhdfs] is powered by hdfs's RESTful HTTP API.
+///
 /// # Features
 ///
 /// HDFS support needs to enable feature `services-hdfs`.

src/services/webhdfs/backend.rs

@@ -38,7 +38,27 @@ use crate::*;
 
 const WEBHDFS_DEFAULT_ENDPOINT: &str = "http://127.0.0.1:9870";
 
-/// WebHDFS's RESTFul API support
+/// [WebHDFS](https://hadoop.apache.org/docs/stable/hadoop-project-dist/hadoop-hdfs/WebHDFS.html)'s REST API support.
+///
+/// There two implementaions of WebHDFS REST API:
+///
+/// - Native via HDFS Namenode and Datanode, data are transferred between nodes directly.
+/// - [HttpFS](https://hadoop.apache.org/docs/stable/hadoop-hdfs-httpfs/index.html) is a gateway before hdfs nodes, data are proxied.
+///
+/// # Capabilities
+///
+/// This service can be used to:
+///
+/// - [x] read
+/// - [x] write
+/// - [x] list
+/// - [ ] ~~presign~~
+/// - [ ] ~~multipart~~
+/// - [ ] blocking
+///
+/// # Differences with hdfs
+///
+/// [Hdfs][crate::services::Hdfs] is powered by HDFS's native java client. Users need to setup the hdfs services correctly. But webhdfs can access from HTTP API and no extra setup needed.
 ///
 /// # Configurations
 ///
@@ -48,13 +68,8 @@ const WEBHDFS_DEFAULT_ENDPOINT: &str = "http://127.0.0.1:9870";
 ///
 /// Refer to [`Builder`]'s public API docs for more information
 ///
-/// # Environment
-///
-/// - `OPENDAL_WEBHDFS_ROOT`
-/// - `OPENDAL_WEBHDFS_ENDPOINT`
-/// - `OPENDAL_WEBHDFS_DELEGATION`
-///
 /// # Examples
+///
 /// ## Via Builder
 /// ```no_run
 /// use std::sync::Arc;