tamar-file-hub-client 0.1.0__tar.gz → 0.1.2__tar.gz

{tamar_file_hub_client-0.1.0 → tamar_file_hub_client-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tamar-file-hub-client
-Version: 0.1.0
+Version: 0.1.2
 Summary: A Python SDK for gRPC-based file management system
 Home-page: https://github.com/Tamar-Edge-AI/file-hub-client
 Author: Oscar Ou
@@ -682,6 +682,137 @@ async with AsyncTamarFileHubClient() as client:
     print(f"文件已保存到: {save_path}")
 ```
 
+#### 高级下载功能
+
+File Hub Client 提供了高级的下载URL管理功能，支持批量操作和直接获取GCS URL：
+
+##### 批量生成下载URL
+
+当需要为多个文件生成下载URL时，使用批量接口可以显著提高效率：
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    # 设置用户上下文
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 批量生成下载URL
+    file_ids = ["file-001", "file-002", "file-003"]
+    
+    result = await client.blobs.batch_generate_download_url(
+        file_ids=file_ids,
+        is_cdn=True,           # 使用CDN加速（可选，默认为True）
+        expire_seconds=3600    # URL有效期1小时（可选）
+    )
+    
+    # 处理结果
+    for url_info in result.download_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 生成URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id} 的下载URL: {url_info.url}")
+```
+
+同步客户端示例：
+
+```python
+from file_hub_client import TamarFileHubClient
+
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    result = client.blobs.batch_generate_download_url(
+        file_ids=["file-001", "file-002"],
+        is_cdn=False  # 不使用CDN，直接返回源站URL
+    )
+```
+
+##### 获取GCS URL
+
+对于需要直接访问Google Cloud Storage的场景，可以获取文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 获取单个文件的GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    gcs_response = await client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    # 输出示例：
+    # GCS URL: gs://bucket-name/path/to/file.pdf
+    # MIME类型: application/pdf
+```
+
+**注意**：`get_gcs_url` 方法现在返回一个 `GetGcsUrlResponse` 对象，包含：
+- `gcs_url`: Google Cloud Storage 的完整路径
+- `mime_type`: 文件的MIME类型，便于正确处理文件内容
+
+##### 批量获取GCS URL
+
+批量获取多个文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 批量获取GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    file_ids = ["file-001", "file-002", "file-003"]
+    result = await client.blobs.batch_get_gcs_url(file_ids)
+    
+    # 处理结果
+    for url_info in result.gcs_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 获取GCS URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id}:")
+            print(f"  GCS URL: {url_info.gcs_url}")
+            print(f"  MIME类型: {url_info.mime_type}")
+            # 根据MIME类型处理文件
+            if url_info.mime_type.startswith('image/'):
+                print(f"  这是一个图片文件")
+            elif url_info.mime_type == 'application/pdf':
+                print(f"  这是一个PDF文件")
+```
+
+同步客户端示例：
+
+```python
+# 同步客户端 - 批量获取GCS URL
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 获取单个GCS URL
+    gcs_response = client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    
+    # 批量获取GCS URL
+    result = client.blobs.batch_get_gcs_url(["file-001", "file-002"])
+```
+
+##### 使用场景说明
+
+1. **批量下载URL生成**：
+   - 适用于需要同时下载多个文件的场景
+   - 支持CDN加速，提供更好的下载体验
+   - 可设置URL有效期，增强安全性
+   - 批量操作减少网络往返，提高效率
+
+2. **GCS URL获取**：
+   - 适用于需要与Google Cloud服务集成的场景
+   - 可用于数据分析、批处理等后端处理
+   - 支持使用GCS工具进行文件操作
+   - 返回的是永久有效的存储路径
+   - 同时返回MIME类型信息，便于正确处理不同类型的文件
+   - 可根据MIME类型选择合适的处理方式（如图片处理、文档解析等）
+
+3. **错误处理**：
+   - 每个文件独立处理，部分失败不影响其他文件
+   - 错误信息通过 `error` 字段返回
+   - 建议在批量操作时做好错误处理和重试逻辑
+
 ### 文件管理操作
 
 File Hub Client 提供了完整的文件管理功能，通过 `files` 服务访问：
@@ -2019,6 +2150,12 @@ MIT License
 
 ## 更新日志
 
+### v0.0.5 (2025-01)
+- 新增批量下载URL生成接口 (batch_generate_download_url)
+- 新增GCS URL获取接口 (get_gcs_url, batch_get_gcs_url)
+- GCS URL接口返回MIME类型信息，便于文件类型识别
+- 更新相关文档和测试用例
+
 ### v0.0.4 (2025-01)
 - 新增从URL上传文件功能
 - 支持自动下载URL内容并上传到GCS

{tamar_file_hub_client-0.1.0 → tamar_file_hub_client-0.1.2}/README.md

@@ -636,6 +636,137 @@ async with AsyncTamarFileHubClient() as client:
     print(f"文件已保存到: {save_path}")
 ```
 
+#### 高级下载功能
+
+File Hub Client 提供了高级的下载URL管理功能，支持批量操作和直接获取GCS URL：
+
+##### 批量生成下载URL
+
+当需要为多个文件生成下载URL时，使用批量接口可以显著提高效率：
+
+```python
+from file_hub_client import AsyncTamarFileHubClient
+
+async with AsyncTamarFileHubClient() as client:
+    # 设置用户上下文
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 批量生成下载URL
+    file_ids = ["file-001", "file-002", "file-003"]
+    
+    result = await client.blobs.batch_generate_download_url(
+        file_ids=file_ids,
+        is_cdn=True,           # 使用CDN加速（可选，默认为True）
+        expire_seconds=3600    # URL有效期1小时（可选）
+    )
+    
+    # 处理结果
+    for url_info in result.download_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 生成URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id} 的下载URL: {url_info.url}")
+```
+
+同步客户端示例：
+
+```python
+from file_hub_client import TamarFileHubClient
+
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    result = client.blobs.batch_generate_download_url(
+        file_ids=["file-001", "file-002"],
+        is_cdn=False  # 不使用CDN，直接返回源站URL
+    )
+```
+
+##### 获取GCS URL
+
+对于需要直接访问Google Cloud Storage的场景，可以获取文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 获取单个文件的GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    gcs_response = await client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    # 输出示例：
+    # GCS URL: gs://bucket-name/path/to/file.pdf
+    # MIME类型: application/pdf
+```
+
+**注意**：`get_gcs_url` 方法现在返回一个 `GetGcsUrlResponse` 对象，包含：
+- `gcs_url`: Google Cloud Storage 的完整路径
+- `mime_type`: 文件的MIME类型，便于正确处理文件内容
+
+##### 批量获取GCS URL
+
+批量获取多个文件的GCS URL和MIME类型信息：
+
+```python
+# 异步客户端 - 批量获取GCS URL
+async with AsyncTamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    file_ids = ["file-001", "file-002", "file-003"]
+    result = await client.blobs.batch_get_gcs_url(file_ids)
+    
+    # 处理结果
+    for url_info in result.gcs_urls:
+        if url_info.error:
+            print(f"文件 {url_info.file_id} 获取GCS URL失败: {url_info.error}")
+        else:
+            print(f"文件 {url_info.file_id}:")
+            print(f"  GCS URL: {url_info.gcs_url}")
+            print(f"  MIME类型: {url_info.mime_type}")
+            # 根据MIME类型处理文件
+            if url_info.mime_type.startswith('image/'):
+                print(f"  这是一个图片文件")
+            elif url_info.mime_type == 'application/pdf':
+                print(f"  这是一个PDF文件")
+```
+
+同步客户端示例：
+
+```python
+# 同步客户端 - 批量获取GCS URL
+with TamarFileHubClient() as client:
+    client.set_user_context(org_id="123", user_id="456")
+    
+    # 获取单个GCS URL
+    gcs_response = client.blobs.get_gcs_url(file_id="file-001")
+    print(f"GCS URL: {gcs_response.gcs_url}")
+    print(f"MIME类型: {gcs_response.mime_type}")
+    
+    # 批量获取GCS URL
+    result = client.blobs.batch_get_gcs_url(["file-001", "file-002"])
+```
+
+##### 使用场景说明
+
+1. **批量下载URL生成**：
+   - 适用于需要同时下载多个文件的场景
+   - 支持CDN加速，提供更好的下载体验
+   - 可设置URL有效期，增强安全性
+   - 批量操作减少网络往返，提高效率
+
+2. **GCS URL获取**：
+   - 适用于需要与Google Cloud服务集成的场景
+   - 可用于数据分析、批处理等后端处理
+   - 支持使用GCS工具进行文件操作
+   - 返回的是永久有效的存储路径
+   - 同时返回MIME类型信息，便于正确处理不同类型的文件
+   - 可根据MIME类型选择合适的处理方式（如图片处理、文档解析等）
+
+3. **错误处理**：
+   - 每个文件独立处理，部分失败不影响其他文件
+   - 错误信息通过 `error` 字段返回
+   - 建议在批量操作时做好错误处理和重试逻辑
+
 ### 文件管理操作
 
 File Hub Client 提供了完整的文件管理功能，通过 `files` 服务访问：
@@ -1973,6 +2104,12 @@ MIT License
 
 ## 更新日志
 
+### v0.0.5 (2025-01)
+- 新增批量下载URL生成接口 (batch_generate_download_url)
+- 新增GCS URL获取接口 (get_gcs_url, batch_get_gcs_url)
+- GCS URL接口返回MIME类型信息，便于文件类型识别
+- 更新相关文档和测试用例
+
 ### v0.0.4 (2025-01)
 - 新增从URL上传文件功能
 - 支持自动下载URL内容并上传到GCS

{tamar_file_hub_client-0.1.0 → tamar_file_hub_client-0.1.2}/file_hub_client/rpc/gen/file_service_pb2.py

@@ -26,7 +26,7 @@ from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__
 from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x12\x66ile_service.proto\x12\x04\x66ile\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/protobuf/struct.proto\"\xab\x01\n\x04\x46ile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x11\n\tfile_name\x18\x03 \x01(\t\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12.\n\ncreated_at\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb7\x02\n\nUploadFile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x0f\n\x07\x66ile_id\x18\x03 \x01(\t\x12\x14\n\x0cstorage_type\x18\x04 \x01(\t\x12\x13\n\x0bstored_name\x18\x05 \x01(\t\x12\x13\n\x0bstored_path\x18\x06 \x01(\t\x12\x11\n\tfile_name\x18\x07 \x01(\t\x12\x11\n\tfile_size\x18\x08 \x01(\x03\x12\x10\n\x08\x66ile_ext\x18\t \x01(\t\x12\x11\n\tmime_type\x18\n \x01(\t\x12\x0e\n\x06status\x18\x0b \x01(\t\x12.\n\ncreated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdf\x01\n\x11UploadFileRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12\x11\n\tmime_type\x18\x05 \x01(\t\x12\x19\n\x0cis_temporary\x18\x06 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x07 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\"\xf3\x01\n\x10UploadUrlRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x11\n\tfile_type\x18\x03 \x01(\t\x12\x11\n\tmime_type\x18\x04 \x01(\t\x12\x11\n\tfile_size\x18\x05 \x01(\x03\x12\x11\n\tfile_hash\x18\x06 \x01(\t\x12\x19\n\x0cis_temporary\x18\x07 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x08 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\")\n\x16UploadCompletedRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"u\n\x12\x44ownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x13\n\x06is_cdn\x18\x03 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"\xd4\x01\n\x10ShareLinkRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x11\n\tis_public\x18\x02 \x01(\x08\x12\x14\n\x0c\x61\x63\x63\x65ss_scope\x18\x03 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x04 \x01(\x05H\x00\x88\x01\x01\x12\x17\n\nmax_access\x18\x05 \x01(\x05H\x01\x88\x01\x01\x12\x1b\n\x0eshare_password\x18\x06 \x01(\tH\x02\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\r\n\x0b_max_accessB\x11\n\x0f_share_password\"\x82\x01\n\x10\x46ileVisitRequest\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\x12\x13\n\x0b\x61\x63\x63\x65ss_type\x18\x02 \x01(\t\x12\x17\n\x0f\x61\x63\x63\x65ss_duration\x18\x03 \x01(\x05\x12)\n\x08metadata\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\"!\n\x0eGetFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"6\n\x11RenameFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x10\n\x08new_name\x18\x02 \x01(\t\"$\n\x11\x44\x65leteFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x8d\x02\n\x10ListFilesRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\tfile_name\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x11\n\tfile_type\x18\x03 \x03(\t\x12\x1c\n\x0f\x63reated_by_role\x18\x04 \x01(\tH\x02\x88\x01\x01\x12\x17\n\ncreated_by\x18\x05 \x01(\tH\x03\x88\x01\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05H\x04\x88\x01\x01\x12\x11\n\x04page\x18\x07 \x01(\x05H\x05\x88\x01\x01\x42\x0c\n\n_folder_idB\x0c\n\n_file_nameB\x12\n\x10_created_by_roleB\r\n\x0b_created_byB\x0c\n\n_page_sizeB\x07\n\x05_page\"U\n\x12UploadFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\"a\n\x11UploadUrlResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\x12\x0b\n\x03url\x18\x03 \x01(\t\"\"\n\x13\x44ownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\"*\n\x11ShareLinkResponse\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\"-\n\x10\x46ileListResponse\x12\x19\n\x05\x66iles\x18\x01 \x03(\x0b\x32\n.file.File\"g\n\x0fGetFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12*\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFileH\x00\x88\x01\x01\x42\x0e\n\x0c_upload_file\"\x07\n\x05\x45mpty2\xc8\x05\n\x0b\x46ileService\x12?\n\nUploadFile\x12\x17.file.UploadFileRequest\x1a\x18.file.UploadFileResponse\x12\x44\n\x11GenerateUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12M\n\x1aGenerateResumableUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12\x43\n\x16\x43onfirmUploadCompleted\x12\x1c.file.UploadCompletedRequest\x1a\x0b.file.Empty\x12J\n\x13GenerateDownloadUrl\x12\x18.file.DownloadUrlRequest\x1a\x19.file.DownloadUrlResponse\x12\x44\n\x11GenerateShareLink\x12\x16.file.ShareLinkRequest\x1a\x17.file.ShareLinkResponse\x12\x30\n\tVisitFile\x12\x16.file.FileVisitRequest\x1a\x0b.file.Empty\x12\x36\n\x07GetFile\x12\x14.file.GetFileRequest\x1a\x15.file.GetFileResponse\x12\x31\n\nRenameFile\x12\x17.file.RenameFileRequest\x1a\n.file.File\x12\x32\n\nDeleteFile\x12\x17.file.DeleteFileRequest\x1a\x0b.file.Empty\x12;\n\tListFiles\x12\x16.file.ListFilesRequest\x1a\x16.file.FileListResponseb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x12\x66ile_service.proto\x12\x04\x66ile\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/protobuf/struct.proto\"\xab\x01\n\x04\x46ile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x11\n\tfile_name\x18\x03 \x01(\t\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12.\n\ncreated_at\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb7\x02\n\nUploadFile\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x0f\n\x07\x66ile_id\x18\x03 \x01(\t\x12\x14\n\x0cstorage_type\x18\x04 \x01(\t\x12\x13\n\x0bstored_name\x18\x05 \x01(\t\x12\x13\n\x0bstored_path\x18\x06 \x01(\t\x12\x11\n\tfile_name\x18\x07 \x01(\t\x12\x11\n\tfile_size\x18\x08 \x01(\x03\x12\x10\n\x08\x66ile_ext\x18\t \x01(\t\x12\x11\n\tmime_type\x18\n \x01(\t\x12\x0e\n\x06status\x18\x0b \x01(\t\x12.\n\ncreated_at\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdf\x01\n\x11UploadFileRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tfile_type\x18\x04 \x01(\t\x12\x11\n\tmime_type\x18\x05 \x01(\t\x12\x19\n\x0cis_temporary\x18\x06 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x07 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\"\xf3\x01\n\x10UploadUrlRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x11\n\tfile_type\x18\x03 \x01(\t\x12\x11\n\tmime_type\x18\x04 \x01(\t\x12\x11\n\tfile_size\x18\x05 \x01(\x03\x12\x11\n\tfile_hash\x18\x06 \x01(\t\x12\x19\n\x0cis_temporary\x18\x07 \x01(\x08H\x01\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x08 \x01(\x05H\x02\x88\x01\x01\x42\x0c\n\n_folder_idB\x0f\n\r_is_temporaryB\x11\n\x0f_expire_seconds\")\n\x16UploadCompletedRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"u\n\x12\x44ownloadUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x13\n\x06is_cdn\x18\x03 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"\xd4\x01\n\x10ShareLinkRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x11\n\tis_public\x18\x02 \x01(\x08\x12\x14\n\x0c\x61\x63\x63\x65ss_scope\x18\x03 \x01(\t\x12\x1b\n\x0e\x65xpire_seconds\x18\x04 \x01(\x05H\x00\x88\x01\x01\x12\x17\n\nmax_access\x18\x05 \x01(\x05H\x01\x88\x01\x01\x12\x1b\n\x0eshare_password\x18\x06 \x01(\tH\x02\x88\x01\x01\x42\x11\n\x0f_expire_secondsB\r\n\x0b_max_accessB\x11\n\x0f_share_password\"\x82\x01\n\x10\x46ileVisitRequest\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\x12\x13\n\x0b\x61\x63\x63\x65ss_type\x18\x02 \x01(\t\x12\x17\n\x0f\x61\x63\x63\x65ss_duration\x18\x03 \x01(\x05\x12)\n\x08metadata\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\"!\n\x0eGetFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"6\n\x11RenameFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x10\n\x08new_name\x18\x02 \x01(\t\"$\n\x11\x44\x65leteFileRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\"\x8d\x02\n\x10ListFilesRequest\x12\x16\n\tfolder_id\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\tfile_name\x18\x02 \x01(\tH\x01\x88\x01\x01\x12\x11\n\tfile_type\x18\x03 \x03(\t\x12\x1c\n\x0f\x63reated_by_role\x18\x04 \x01(\tH\x02\x88\x01\x01\x12\x17\n\ncreated_by\x18\x05 \x01(\tH\x03\x88\x01\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05H\x04\x88\x01\x01\x12\x11\n\x04page\x18\x07 \x01(\x05H\x05\x88\x01\x01\x42\x0c\n\n_folder_idB\x0c\n\n_file_nameB\x12\n\x10_created_by_roleB\r\n\x0b_created_byB\x0c\n\n_page_sizeB\x07\n\x05_page\"{\n\x17\x42\x61tchDownloadUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\x12\x13\n\x06is_cdn\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x1b\n\x0e\x65xpire_seconds\x18\x03 \x01(\x05H\x01\x88\x01\x01\x42\t\n\x07_is_cdnB\x11\n\x0f_expire_seconds\"#\n\x10GetGcsUrlRequest\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\")\n\x15\x42\x61tchGetGcsUrlRequest\x12\x10\n\x08\x66ile_ids\x18\x01 \x03(\t\"U\n\x12UploadFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\"a\n\x11UploadUrlResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12%\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFile\x12\x0b\n\x03url\x18\x03 \x01(\t\"\"\n\x13\x44ownloadUrlResponse\x12\x0b\n\x03url\x18\x01 \x01(\t\"*\n\x11ShareLinkResponse\x12\x15\n\rfile_share_id\x18\x01 \x01(\t\"-\n\x10\x46ileListResponse\x12\x19\n\x05\x66iles\x18\x01 \x03(\x0b\x32\n.file.File\"g\n\x0fGetFileResponse\x12\x18\n\x04\x66ile\x18\x01 \x01(\x0b\x32\n.file.File\x12*\n\x0bupload_file\x18\x02 \x01(\x0b\x32\x10.file.UploadFileH\x00\x88\x01\x01\x42\x0e\n\x0c_upload_file\"H\n\x18\x42\x61tchDownloadUrlResponse\x12,\n\rdownload_urls\x18\x01 \x03(\x0b\x32\x15.file.DownloadUrlInfo\"M\n\x0f\x44ownloadUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\x12\n\x05\x65rror\x18\x03 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"7\n\x11GetGcsUrlResponse\x12\x0f\n\x07gcs_url\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\"<\n\x16\x42\x61tchGetGcsUrlResponse\x12\"\n\x08gcs_urls\x18\x01 \x03(\x0b\x32\x10.file.GcsUrlInfo\"_\n\nGcsUrlInfo\x12\x0f\n\x07\x66ile_id\x18\x01 \x01(\t\x12\x0f\n\x07gcs_url\x18\x02 \x01(\t\x12\x11\n\tmime_type\x18\x03 \x01(\t\x12\x12\n\x05\x65rror\x18\x04 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_error\"\x07\n\x05\x45mpty2\xae\x07\n\x0b\x46ileService\x12?\n\nUploadFile\x12\x17.file.UploadFileRequest\x1a\x18.file.UploadFileResponse\x12\x44\n\x11GenerateUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12M\n\x1aGenerateResumableUploadUrl\x12\x16.file.UploadUrlRequest\x1a\x17.file.UploadUrlResponse\x12\x43\n\x16\x43onfirmUploadCompleted\x12\x1c.file.UploadCompletedRequest\x1a\x0b.file.Empty\x12J\n\x13GenerateDownloadUrl\x12\x18.file.DownloadUrlRequest\x1a\x19.file.DownloadUrlResponse\x12Y\n\x18\x42\x61tchGenerateDownloadUrl\x12\x1d.file.BatchDownloadUrlRequest\x1a\x1e.file.BatchDownloadUrlResponse\x12<\n\tGetGcsUrl\x12\x16.file.GetGcsUrlRequest\x1a\x17.file.GetGcsUrlResponse\x12K\n\x0e\x42\x61tchGetGcsUrl\x12\x1b.file.BatchGetGcsUrlRequest\x1a\x1c.file.BatchGetGcsUrlResponse\x12\x44\n\x11GenerateShareLink\x12\x16.file.ShareLinkRequest\x1a\x17.file.ShareLinkResponse\x12\x30\n\tVisitFile\x12\x16.file.FileVisitRequest\x1a\x0b.file.Empty\x12\x36\n\x07GetFile\x12\x14.file.GetFileRequest\x1a\x15.file.GetFileResponse\x12\x31\n\nRenameFile\x12\x17.file.RenameFileRequest\x1a\n.file.File\x12\x32\n\nDeleteFile\x12\x17.file.DeleteFileRequest\x1a\x0b.file.Empty\x12;\n\tListFiles\x12\x16.file.ListFilesRequest\x1a\x16.file.FileListResponseb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -57,20 +57,36 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_DELETEFILEREQUEST']._serialized_end=1688
   _globals['_LISTFILESREQUEST']._serialized_start=1691
   _globals['_LISTFILESREQUEST']._serialized_end=1960
-  _globals['_UPLOADFILERESPONSE']._serialized_start=1962
-  _globals['_UPLOADFILERESPONSE']._serialized_end=2047
-  _globals['_UPLOADURLRESPONSE']._serialized_start=2049
-  _globals['_UPLOADURLRESPONSE']._serialized_end=2146
-  _globals['_DOWNLOADURLRESPONSE']._serialized_start=2148
-  _globals['_DOWNLOADURLRESPONSE']._serialized_end=2182
-  _globals['_SHARELINKRESPONSE']._serialized_start=2184
-  _globals['_SHARELINKRESPONSE']._serialized_end=2226
-  _globals['_FILELISTRESPONSE']._serialized_start=2228
-  _globals['_FILELISTRESPONSE']._serialized_end=2273
-  _globals['_GETFILERESPONSE']._serialized_start=2275
-  _globals['_GETFILERESPONSE']._serialized_end=2378
-  _globals['_EMPTY']._serialized_start=2380
-  _globals['_EMPTY']._serialized_end=2387
-  _globals['_FILESERVICE']._serialized_start=2390
-  _globals['_FILESERVICE']._serialized_end=3102
+  _globals['_BATCHDOWNLOADURLREQUEST']._serialized_start=1962
+  _globals['_BATCHDOWNLOADURLREQUEST']._serialized_end=2085
+  _globals['_GETGCSURLREQUEST']._serialized_start=2087
+  _globals['_GETGCSURLREQUEST']._serialized_end=2122
+  _globals['_BATCHGETGCSURLREQUEST']._serialized_start=2124
+  _globals['_BATCHGETGCSURLREQUEST']._serialized_end=2165
+  _globals['_UPLOADFILERESPONSE']._serialized_start=2167
+  _globals['_UPLOADFILERESPONSE']._serialized_end=2252
+  _globals['_UPLOADURLRESPONSE']._serialized_start=2254
+  _globals['_UPLOADURLRESPONSE']._serialized_end=2351
+  _globals['_DOWNLOADURLRESPONSE']._serialized_start=2353
+  _globals['_DOWNLOADURLRESPONSE']._serialized_end=2387
+  _globals['_SHARELINKRESPONSE']._serialized_start=2389
+  _globals['_SHARELINKRESPONSE']._serialized_end=2431
+  _globals['_FILELISTRESPONSE']._serialized_start=2433
+  _globals['_FILELISTRESPONSE']._serialized_end=2478
+  _globals['_GETFILERESPONSE']._serialized_start=2480
+  _globals['_GETFILERESPONSE']._serialized_end=2583
+  _globals['_BATCHDOWNLOADURLRESPONSE']._serialized_start=2585
+  _globals['_BATCHDOWNLOADURLRESPONSE']._serialized_end=2657
+  _globals['_DOWNLOADURLINFO']._serialized_start=2659
+  _globals['_DOWNLOADURLINFO']._serialized_end=2736
+  _globals['_GETGCSURLRESPONSE']._serialized_start=2738
+  _globals['_GETGCSURLRESPONSE']._serialized_end=2793
+  _globals['_BATCHGETGCSURLRESPONSE']._serialized_start=2795
+  _globals['_BATCHGETGCSURLRESPONSE']._serialized_end=2855
+  _globals['_GCSURLINFO']._serialized_start=2857
+  _globals['_GCSURLINFO']._serialized_end=2952
+  _globals['_EMPTY']._serialized_start=2954
+  _globals['_EMPTY']._serialized_end=2961
+  _globals['_FILESERVICE']._serialized_start=2964
+  _globals['_FILESERVICE']._serialized_end=3906
 # @@protoc_insertion_point(module_scope)

{tamar_file_hub_client-0.1.0 → tamar_file_hub_client-0.1.2}/file_hub_client/rpc/gen/file_service_pb2_grpc.py

@@ -61,6 +61,21 @@ class FileServiceStub(object):
                 request_serializer=file__service__pb2.DownloadUrlRequest.SerializeToString,
                 response_deserializer=file__service__pb2.DownloadUrlResponse.FromString,
                 _registered_method=True)
+        self.BatchGenerateDownloadUrl = channel.unary_unary(
+                '/file.FileService/BatchGenerateDownloadUrl',
+                request_serializer=file__service__pb2.BatchDownloadUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.BatchDownloadUrlResponse.FromString,
+                _registered_method=True)
+        self.GetGcsUrl = channel.unary_unary(
+                '/file.FileService/GetGcsUrl',
+                request_serializer=file__service__pb2.GetGcsUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.GetGcsUrlResponse.FromString,
+                _registered_method=True)
+        self.BatchGetGcsUrl = channel.unary_unary(
+                '/file.FileService/BatchGetGcsUrl',
+                request_serializer=file__service__pb2.BatchGetGcsUrlRequest.SerializeToString,
+                response_deserializer=file__service__pb2.BatchGetGcsUrlResponse.FromString,
+                _registered_method=True)
         self.GenerateShareLink = channel.unary_unary(
                 '/file.FileService/GenerateShareLink',
                 request_serializer=file__service__pb2.ShareLinkRequest.SerializeToString,
@@ -128,6 +143,24 @@ class FileServiceServicer(object):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def BatchGenerateDownloadUrl(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetGcsUrl(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def BatchGetGcsUrl(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
     def GenerateShareLink(self, request, context):
         """Missing associated documentation comment in .proto file."""
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
@@ -192,6 +225,21 @@ def add_FileServiceServicer_to_server(servicer, server):
                     request_deserializer=file__service__pb2.DownloadUrlRequest.FromString,
                     response_serializer=file__service__pb2.DownloadUrlResponse.SerializeToString,
             ),
+            'BatchGenerateDownloadUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.BatchGenerateDownloadUrl,
+                    request_deserializer=file__service__pb2.BatchDownloadUrlRequest.FromString,
+                    response_serializer=file__service__pb2.BatchDownloadUrlResponse.SerializeToString,
+            ),
+            'GetGcsUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetGcsUrl,
+                    request_deserializer=file__service__pb2.GetGcsUrlRequest.FromString,
+                    response_serializer=file__service__pb2.GetGcsUrlResponse.SerializeToString,
+            ),
+            'BatchGetGcsUrl': grpc.unary_unary_rpc_method_handler(
+                    servicer.BatchGetGcsUrl,
+                    request_deserializer=file__service__pb2.BatchGetGcsUrlRequest.FromString,
+                    response_serializer=file__service__pb2.BatchGetGcsUrlResponse.SerializeToString,
+            ),
             'GenerateShareLink': grpc.unary_unary_rpc_method_handler(
                     servicer.GenerateShareLink,
                     request_deserializer=file__service__pb2.ShareLinkRequest.FromString,
@@ -370,6 +418,87 @@ class FileService(object):
             metadata,
             _registered_method=True)
 
+    @staticmethod
+    def BatchGenerateDownloadUrl(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/file.FileService/BatchGenerateDownloadUrl',
+            file__service__pb2.BatchDownloadUrlRequest.SerializeToString,
+            file__service__pb2.BatchDownloadUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GetGcsUrl(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/file.FileService/GetGcsUrl',
+            file__service__pb2.GetGcsUrlRequest.SerializeToString,
+            file__service__pb2.GetGcsUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def BatchGetGcsUrl(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/file.FileService/BatchGetGcsUrl',
+            file__service__pb2.BatchGetGcsUrlRequest.SerializeToString,
+            file__service__pb2.BatchGetGcsUrlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
     @staticmethod
     def GenerateShareLink(request,
             target,

{tamar_file_hub_client-0.1.0 → tamar_file_hub_client-0.1.2}/file_hub_client/rpc/protos/file_service.proto

@@ -13,6 +13,9 @@ service FileService {
     rpc GenerateResumableUploadUrl (UploadUrlRequest) returns (UploadUrlResponse);
     rpc ConfirmUploadCompleted (UploadCompletedRequest) returns (Empty);
     rpc GenerateDownloadUrl (DownloadUrlRequest) returns (DownloadUrlResponse);
+    rpc BatchGenerateDownloadUrl (BatchDownloadUrlRequest) returns (BatchDownloadUrlResponse);
+    rpc GetGcsUrl (GetGcsUrlRequest) returns (GetGcsUrlResponse);
+    rpc BatchGetGcsUrl (BatchGetGcsUrlRequest) returns (BatchGetGcsUrlResponse);
     rpc GenerateShareLink (ShareLinkRequest) returns (ShareLinkResponse);
     rpc VisitFile (FileVisitRequest) returns (Empty);
     rpc GetFile (GetFileRequest) returns (GetFileResponse);
@@ -120,6 +123,20 @@ message ListFilesRequest {
     optional int32 page = 7;
 }
 
+message BatchDownloadUrlRequest {
+    repeated string file_ids = 1;
+    optional bool is_cdn = 2;
+    optional int32 expire_seconds = 3;
+}
+
+message GetGcsUrlRequest {
+    string file_id = 1;
+}
+
+message BatchGetGcsUrlRequest {
+    repeated string file_ids = 1;
+}
+
 // ========= 响应结构 =========
 
 message UploadFileResponse {
@@ -150,4 +167,30 @@ message GetFileResponse {
     optional UploadFile upload_file = 2;
 }
 
+message BatchDownloadUrlResponse {
+    repeated DownloadUrlInfo download_urls = 1;
+}
+
+message DownloadUrlInfo {
+    string file_id = 1;
+    string url = 2;
+    optional string error = 3;
+}
+
+message GetGcsUrlResponse {
+    string gcs_url = 1;
+    string mime_type = 2;
+}
+
+message BatchGetGcsUrlResponse {
+    repeated GcsUrlInfo gcs_urls = 1;
+}
+
+message GcsUrlInfo {
+    string file_id = 1;
+    string gcs_url = 2;
+    string mime_type = 3;
+    optional string error = 4;
+}
+
 message Empty {}

{tamar_file_hub_client-0.1.0 → tamar_file_hub_client-0.1.2}/file_hub_client/schemas/__init__.py

@@ -11,6 +11,11 @@ from .file import (
     FileListRequest,
     FileListResponse,
     GetFileResponse,
+    DownloadUrlInfo,
+    BatchDownloadUrlResponse,
+    GcsUrlInfo,
+    GetGcsUrlResponse,
+    BatchGcsUrlResponse,
 )
 from .folder import (
     FolderInfo,
@@ -63,6 +68,11 @@ __all__ = [
     "FileListRequest",
     "FileListResponse",
     "GetFileResponse",
+    "DownloadUrlInfo",
+    "BatchDownloadUrlResponse",
+    "GcsUrlInfo",
+    "GetGcsUrlResponse",
+    "BatchGcsUrlResponse",
 
     # 文件夹相关
     "FolderInfo",

{tamar_file_hub_client-0.1.0 → tamar_file_hub_client-0.1.2}/file_hub_client/schemas/file.py

@@ -93,3 +93,34 @@ class GetFileResponse(BaseModel):
     """获取文件响应"""
     file: File = Field(..., description="文件信息")
     upload_file: Optional[UploadFile] = Field(None, description="上传文件信息")
+
+
+class DownloadUrlInfo(BaseModel):
+    """下载URL信息"""
+    file_id: str = Field(..., description="文件ID")
+    url: str = Field(..., description="下载URL")
+    error: Optional[str] = Field(None, description="错误信息")
+
+
+class BatchDownloadUrlResponse(BaseModel):
+    """批量下载URL响应"""
+    download_urls: List[DownloadUrlInfo] = Field(default_factory=list, description="下载URL列表")
+
+
+class GcsUrlInfo(BaseModel):
+    """GCS URL信息"""
+    file_id: str = Field(..., description="文件ID")
+    gcs_url: str = Field(..., description="GCS URL")
+    mime_type: str = Field(..., description="MIME类型")
+    error: Optional[str] = Field(None, description="错误信息")
+
+
+class GetGcsUrlResponse(BaseModel):
+    """获取GCS URL响应"""
+    gcs_url: str = Field(..., description="GCS URL")
+    mime_type: str = Field(..., description="MIME类型")
+
+
+class BatchGcsUrlResponse(BaseModel):
+    """批量GCS URL响应"""
+    gcs_urls: List[GcsUrlInfo] = Field(default_factory=list, description="GCS URL列表")