tamar-file-hub-client 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

file_hub_client/services/file/sync_file_service.py

@@ -34,6 +34,7 @@ class SyncFileService(BaseFileService):
             expire_seconds: int = 86400,
             max_access: Optional[int] = None,
             share_password: Optional[str] = None,
+            request_id: Optional[str] = None,
             **metadata
     ) -> str:
         """
@@ -68,7 +69,7 @@ class SyncFileService(BaseFileService):
             request.share_password = share_password
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         response = stub.GenerateShareLink(request, metadata=grpc_metadata)
 
@@ -80,6 +81,7 @@ class SyncFileService(BaseFileService):
             access_type: str = "view",
             access_duration: int = 0,
             metadata: Optional[Dict[str, Any]] = None,
+            request_id: Optional[str] = None,
             **extra_metadata
     ) -> None:
         """
@@ -111,11 +113,12 @@ class SyncFileService(BaseFileService):
         )
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**extra_metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **extra_metadata)
 
         stub.VisitFile(request, metadata=grpc_metadata)
 
-    def get_file(self, file_id: str, **metadata) -> File:
+    def get_file(self, file_id: str, request_id: Optional[str] = None,
+                 **metadata) -> File:
         """
         获取文件信息
         
@@ -133,7 +136,7 @@ class SyncFileService(BaseFileService):
         request = file_service_pb2.GetFileRequest(file_id=file_id)
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         try:
             response = stub.GetFile(request, metadata=grpc_metadata)
@@ -143,13 +146,15 @@ class SyncFileService(BaseFileService):
                 raise FileNotFoundError(file_id)
             raise
 
-    def rename_file(self, file_id: str, new_name: str, **metadata) -> File:
+    def rename_file(self, file_id: str, new_name: str, request_id: Optional[str] = None,
+                    **metadata) -> File:
         """
         重命名文件
         
         Args:
             file_id: 文件ID
             new_name: 新文件名
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
             
         Returns:
@@ -165,7 +170,7 @@ class SyncFileService(BaseFileService):
         )
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         try:
             response = stub.RenameFile(request, metadata=grpc_metadata)
@@ -175,12 +180,14 @@ class SyncFileService(BaseFileService):
                 raise FileNotFoundError(file_id)
             raise
 
-    def delete_file(self, file_id: str, **metadata) -> None:
+    def delete_file(self, file_id: str, request_id: Optional[str] = None,
+                    **metadata) -> None:
         """
         删除文件
         
         Args:
             file_id: 文件ID
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
         """
         from ...rpc.gen import file_service_pb2, file_service_pb2_grpc
@@ -190,7 +197,7 @@ class SyncFileService(BaseFileService):
         request = file_service_pb2.DeleteFileRequest(file_id=file_id)
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         try:
             stub.DeleteFile(request, metadata=grpc_metadata)
@@ -208,6 +215,7 @@ class SyncFileService(BaseFileService):
             created_by: Optional[str] = None,
             page_size: int = 20,
             page: int = 1,
+            request_id: Optional[str] = None,
             **metadata
     ) -> FileListResponse:
         """
@@ -221,6 +229,7 @@ class SyncFileService(BaseFileService):
             created_by: 创建者过滤
             page_size: 每页大小
             page: 页码
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
             
         Returns:
@@ -246,7 +255,7 @@ class SyncFileService(BaseFileService):
             request.created_by = created_by
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         response = stub.ListFiles(request, metadata=grpc_metadata)
 

file_hub_client/services/folder/async_folder_service.py

@@ -31,7 +31,8 @@ class AsyncFolderService:
             folder_name: str,
             *,
             parent_id: Optional[str] = None,
-            **metadata
+            request_id: Optional[str] = None,
+        **metadata
     ) -> FolderInfo:
         """
         创建文件夹
@@ -54,18 +55,20 @@ class AsyncFolderService:
         )
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         response = await stub.CreateFolder(request, metadata=grpc_metadata)
         return self._convert_folder_info(response)
 
-    async def rename_folder(self, folder_id: str, new_name: str, **metadata) -> FolderInfo:
+    async def rename_folder(self, folder_id: str, new_name: str, request_id: Optional[str] = None,
+        **metadata) -> FolderInfo:
         """
         重命名文件夹
         
         Args:
             folder_id: 文件夹ID
             new_name: 新名称
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
         """
         from ...rpc.gen import folder_service_pb2, folder_service_pb2_grpc
@@ -81,7 +84,7 @@ class AsyncFolderService:
         )
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         try:
             response = await stub.RenameFolder(request, metadata=grpc_metadata)
@@ -91,13 +94,15 @@ class AsyncFolderService:
                 raise FolderNotFoundError(folder_id)
             raise
 
-    async def move_folder(self, folder_id: str, new_parent_id: str, **metadata) -> FolderInfo:
+    async def move_folder(self, folder_id: str, new_parent_id: str, request_id: Optional[str] = None,
+        **metadata) -> FolderInfo:
         """
         移动文件夹
         
         Args:
             folder_id: 文件夹ID
             new_parent_id: 新父文件夹ID
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
         """
         from ...rpc.gen import folder_service_pb2, folder_service_pb2_grpc
@@ -110,7 +115,7 @@ class AsyncFolderService:
         )
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         try:
             response = await stub.MoveFolder(request, metadata=grpc_metadata)
@@ -120,12 +125,14 @@ class AsyncFolderService:
                 raise FolderNotFoundError(folder_id)
             raise
 
-    async def delete_folder(self, folder_id: str, **metadata) -> None:
+    async def delete_folder(self, folder_id: str, request_id: Optional[str] = None,
+        **metadata) -> None:
         """
         删除文件夹
         
         Args:
             folder_id: 文件夹ID
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
         """
         from ...rpc.gen import folder_service_pb2, folder_service_pb2_grpc
@@ -135,7 +142,7 @@ class AsyncFolderService:
         request = folder_service_pb2.DeleteFolderRequest(folder_id=folder_id)
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         try:
             await stub.DeleteFolder(request, metadata=grpc_metadata)
@@ -150,7 +157,8 @@ class AsyncFolderService:
             folder_name: Optional[str] = None,
             created_by_role: Optional[str] = None,
             created_by: Optional[str] = None,
-            **metadata
+            request_id: Optional[str] = None,
+        **metadata
     ) -> FolderListResponse:
         """
         列出文件夹
@@ -160,6 +168,7 @@ class AsyncFolderService:
             folder_name: 文件夹名称
             created_by_role: 创建者角色
             created_by: 创建者
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
             
         Returns:
@@ -181,11 +190,11 @@ class AsyncFolderService:
             request.created_by = created_by
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         response = await stub.ListFolders(request, metadata=grpc_metadata)
 
-        folders = [self._convert_folder_info(f) for f in response.items]
+        folders = [self._convert_folder_info(f) for f in response.folders]
 
         return FolderListResponse(items=folders)
 

file_hub_client/services/folder/sync_folder_service.py

@@ -30,7 +30,8 @@ class SyncFolderService:
             self,
             folder_name: str,
             parent_id: str,
-            **metadata
+            request_id: Optional[str] = None,
+        **metadata
     ) -> FolderInfo:
         """
         创建文件夹
@@ -53,18 +54,20 @@ class SyncFolderService:
         )
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         response = stub.CreateFolder(request, metadata=grpc_metadata)
         return self._convert_folder_info(response)
 
-    def rename_folder(self, folder_id: str, new_name: str, **metadata) -> FolderInfo:
+    def rename_folder(self, folder_id: str, new_name: str, request_id: Optional[str] = None,
+        **metadata) -> FolderInfo:
         """
         重命名文件夹
         
         Args:
             folder_id: 文件夹ID
             new_name: 新名称
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
         """
         from ...rpc.gen import folder_service_pb2, folder_service_pb2_grpc
@@ -80,7 +83,7 @@ class SyncFolderService:
         )
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         try:
             response = stub.RenameFolder(request, metadata=grpc_metadata)
@@ -90,13 +93,15 @@ class SyncFolderService:
                 raise FolderNotFoundError(folder_id)
             raise
 
-    def move_folder(self, folder_id: str, new_parent_id: str, **metadata) -> FolderInfo:
+    def move_folder(self, folder_id: str, new_parent_id: str, request_id: Optional[str] = None,
+        **metadata) -> FolderInfo:
         """
         移动文件夹
         
         Args:
             folder_id: 文件夹ID
             new_parent_id: 新父文件夹ID
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
         """
         from ...rpc.gen import folder_service_pb2, folder_service_pb2_grpc
@@ -109,7 +114,7 @@ class SyncFolderService:
         )
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         try:
             response = stub.MoveFolder(request, metadata=grpc_metadata)
@@ -119,12 +124,14 @@ class SyncFolderService:
                 raise FolderNotFoundError(folder_id)
             raise
 
-    def delete_folder(self, folder_id: str, **metadata) -> None:
+    def delete_folder(self, folder_id: str, request_id: Optional[str] = None,
+        **metadata) -> None:
         """
         删除文件夹
         
         Args:
             folder_id: 文件夹ID
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
         """
         from ...rpc.gen import folder_service_pb2, folder_service_pb2_grpc
@@ -134,7 +141,7 @@ class SyncFolderService:
         request = folder_service_pb2.DeleteFolderRequest(folder_id=folder_id)
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         try:
             stub.DeleteFolder(request, metadata=grpc_metadata)
@@ -149,7 +156,8 @@ class SyncFolderService:
             folder_name: Optional[str] = None,
             created_by_role: Optional[str] = None,
             created_by: Optional[str] = None,
-            **metadata
+            request_id: Optional[str] = None,
+        **metadata
     ) -> FolderListResponse:
         """
         列出文件夹
@@ -159,6 +167,7 @@ class SyncFolderService:
             folder_name: 文件夹名称
             created_by_role: 创建者角色
             created_by: 创建者
+            request_id: 请求ID（可选，如果不提供则自动生成）
             **metadata: 额外的元数据（如 x-org-id, x-user-id 等）
             
         Returns:
@@ -180,11 +189,11 @@ class SyncFolderService:
             request.created_by = created_by
 
         # 构建元数据
-        grpc_metadata = self.client.build_metadata(**metadata)
+        grpc_metadata = self.client.build_metadata(request_id=request_id, **metadata)
 
         response = stub.ListFolders(request, metadata=grpc_metadata)
 
-        folders = [self._convert_folder_info(f) for f in response.items]
+        folders = [self._convert_folder_info(f) for f in response.folders]
 
         return FolderListResponse(items=folders)
 

file_hub_client/services/taple/__init__.py

@@ -0,0 +1,10 @@
+"""
+Taple 服务模块
+"""
+from .async_taple_service import AsyncTapleService
+from .sync_taple_service import SyncTapleService
+
+__all__ = [
+    "AsyncTapleService",
+    "SyncTapleService",
+]