feat: add a helper macro to reduce the definition of root methods

core/src/services/aliyun_drive/backend.rs

@@ -115,20 +115,9 @@ impl Debug for AliyunDriveBuilder {
     }
 }
 
-impl AliyunDriveBuilder {
-    /// Set the root of this backend.
-    ///
-    /// All operations will happen under this root.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(AliyunDriveBuilder);
 
+impl AliyunDriveBuilder {
     /// Set access_token of this backend.
     pub fn access_token(mut self, access_token: &str) -> Self {
         self.config.access_token = Some(access_token.to_string());

core/src/services/alluxio/backend.rs

@@ -88,20 +88,9 @@ impl Debug for AlluxioBuilder {
     }
 }
 
-impl AlluxioBuilder {
-    /// Set root of this backend.
-    ///
-    /// All operations will happen under this root.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(AlluxioBuilder);
 
+impl AlluxioBuilder {
     /// endpoint of this backend.
     ///
     /// Endpoint must be full uri, mostly like `http://127.0.0.1:39999`.

core/src/services/azblob/backend.rs

@@ -145,20 +145,9 @@ impl Debug for AzblobBuilder {
     }
 }
 
-impl AzblobBuilder {
-    /// Set root of this backend.
-    ///
-    /// All operations will happen under this root.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(AzblobBuilder);
 
+impl AzblobBuilder {
     /// Set container name of this backend.
     pub fn container(mut self, container: &str) -> Self {
         self.config.container = container.to_string();

core/src/services/azdls/backend.rs

@@ -108,20 +108,9 @@ impl Debug for AzdlsBuilder {
     }
 }
 
-impl AzdlsBuilder {
-    /// Set root of this backend.
-    ///
-    /// All operations will happen under this root.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(AzdlsBuilder);
 
+impl AzdlsBuilder {
     /// Set filesystem name of this backend.
     pub fn filesystem(mut self, filesystem: &str) -> Self {
         self.config.filesystem = filesystem.to_string();

core/src/services/azfile/backend.rs

@@ -106,20 +106,9 @@ impl Debug for AzfileBuilder {
     }
 }
 
-impl AzfileBuilder {
-    /// Set root of this backend.
-    ///
-    /// All operations will happen under this root.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(AzfileBuilder);
 
+impl AzfileBuilder {
     /// Set endpoint of this backend.
     pub fn endpoint(mut self, endpoint: &str) -> Self {
         if !endpoint.is_empty() {

core/src/services/b2/backend.rs

@@ -110,20 +110,9 @@ impl Debug for B2Builder {
     }
 }
 
-impl B2Builder {
-    /// Set root of this backend.
-    ///
-    /// All operations will happen under this root.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(B2Builder);
 
+impl B2Builder {
     /// application_key_id of this backend.
     pub fn application_key_id(mut self, application_key_id: &str) -> Self {
         self.config.application_key_id = if application_key_id.is_empty() {

core/src/services/chainsafe/backend.rs

@@ -92,20 +92,9 @@ impl Debug for ChainsafeBuilder {
     }
 }
 
-impl ChainsafeBuilder {
-    /// Set root of this backend.
-    ///
-    /// All operations will happen under this root.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(ChainsafeBuilder);
 
+impl ChainsafeBuilder {
     /// api_key of this backend.
     ///
     /// required.

core/src/services/cloudflare_kv/backend.rs

@@ -88,6 +88,8 @@ impl Debug for CloudflareKvBuilder {
     }
 }
 
+crate::impl_root_for_builder!(CloudflareKvBuilder);
+
 impl CloudflareKvBuilder {
     /// Set the token used to authenticate with CloudFlare.
     pub fn token(mut self, token: &str) -> Self {
@@ -112,17 +114,6 @@ impl CloudflareKvBuilder {
         }
         self
     }
-
-    /// Set the root within this backend.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
 }
 
 impl Builder for CloudflareKvBuilder {

core/src/services/compfs/backend.rs

@@ -52,18 +52,7 @@ pub struct CompfsBuilder {
     config: CompfsConfig,
 }
 
-impl CompfsBuilder {
-    /// Set root for Compfs
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
-}
+crate::impl_root_for_builder!(CompfsBuilder);
 
 impl Builder for CompfsBuilder {
     const SCHEME: Scheme = Scheme::Compfs;

core/src/services/cos/backend.rs

@@ -92,20 +92,9 @@ impl Debug for CosBuilder {
     }
 }
 
-impl CosBuilder {
-    /// Set root of this backend.
-    ///
-    /// All operations will happen under this root.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(CosBuilder);
 
+impl CosBuilder {
     /// Set endpoint of this backend.
     ///
     /// NOTE: no bucket or account id in endpoint, we will trim them if exists.

core/src/services/d1/backend.rs

@@ -92,6 +92,8 @@ impl Debug for D1Builder {
     }
 }
 
+crate::impl_root_for_builder!(D1Builder);
+
 impl D1Builder {
     /// Set api token for the cloudflare d1 service.
     ///
@@ -125,19 +127,6 @@ impl D1Builder {
         self
     }
 
-    /// set the working directory, all operations will be performed under it.
-    ///
-    /// default: "/"
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
-
     /// Set the table name of the d1 service to read/write.
     ///
     /// If not specified, it will return an error when building.

core/src/services/dbfs/backend.rs

@@ -82,20 +82,9 @@ impl Debug for DbfsBuilder {
     }
 }
 
-impl DbfsBuilder {
-    /// Set root of this backend.
-    ///
-    /// All operations will happen under this root.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(DbfsBuilder);
 
+impl DbfsBuilder {
     /// Set endpoint of this backend.
     ///
     /// Endpoint must be full uri, e.g.

core/src/services/dropbox/builder.rs

@@ -83,20 +83,9 @@ impl Debug for DropboxBuilder {
     }
 }
 
-impl DropboxBuilder {
-    /// Set the root directory for dropbox.
-    ///
-    /// Default to `/` if not set.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(DropboxBuilder);
 
+impl DropboxBuilder {
     /// Access token is used for temporary access to the Dropbox API.
     ///
     /// You can get the access token from [Dropbox App Console](https://www.dropbox.com/developers/apps)

core/src/services/etcd/backend.rs

@@ -124,6 +124,8 @@ impl Debug for EtcdBuilder {
     }
 }
 
+crate::impl_root_for_builder!(EtcdBuilder);
+
 impl EtcdBuilder {
     /// set the network address of etcd service.
     ///
@@ -155,19 +157,6 @@ impl EtcdBuilder {
         self
     }
 
-    /// set the working directory, all operations will be performed under it.
-    ///
-    /// default: "/"
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
-
     /// Set the certificate authority file path.
     ///
     /// default is None

core/src/services/fs/backend.rs

@@ -59,18 +59,9 @@ pub struct FsBuilder {
     config: FsConfig,
 }
 
-impl FsBuilder {
-    /// Set root for backend.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
+crate::impl_root_for_builder!(FsBuilder);
 
+impl FsBuilder {
     /// Set temp dir for atomic write.
     ///
     /// # Notes

core/src/services/ftp/backend.rs

@@ -92,6 +92,8 @@ impl Debug for FtpBuilder {
     }
 }
 
+crate::impl_root_for_builder!(FtpBuilder);
+
 impl FtpBuilder {
     /// set endpoint for ftp backend.
     pub fn endpoint(mut self, endpoint: &str) -> Self {
@@ -104,17 +106,6 @@ impl FtpBuilder {
         self
     }
 
-    /// set root path for ftp backend.
-    pub fn root(mut self, root: &str) -> Self {
-        self.config.root = if root.is_empty() {
-            None
-        } else {
-            Some(root.to_string())
-        };
-
-        self
-    }
-
     /// set user for ftp backend.
     pub fn user(mut self, user: &str) -> Self {
         self.config.user = if user.is_empty() {