refactor: 提取print_files函数到公共工具模块

- 将github、tsinghua和wenshushu驱动示例中的print_files函数移除
- 在fundrive.utils.file模块中创建统一的print_files函数
- 更新各驱动示例以引用新的公共工具函数
- 版本号从2.0.52升级到2.0.53

此重构提高了代码复用性，减少了重复代码，使打印文件列表的功能更易于维护和统一。

Author: “bingtao”

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fundrive"
-version = "2.0.52"
+version = "2.0.53"
 description = "fundrive"
 readme = "README.md"
 requires-python = ">=3.8"

src/fundrive/drives/github/example.py

@@ -33,6 +33,8 @@
 from fundrive.core import DriveFile
 from funutil import getLogger
 
+from fundrive.utils.file import print_files
+
 logger = getLogger("fundrive.github.example")
 
 

src/fundrive/drives/tsinghua/example.py

@@ -27,13 +27,13 @@
 import argparse
 import os
 import sys
-from typing import List
+
+from fundrive.utils.file import print_files
 
 # 添加项目根目录到Python路径
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), "../../../.."))
 
 from fundrive.drives.tsinghua import TSingHuaDrive
-from fundrive.core import DriveFile
 
 
 def print_separator(title: str = ""):
@@ -44,23 +44,6 @@ def print_separator(title: str = ""):
         print("=" * 60)
 
 
-def print_files(files: List[DriveFile], title: str = "文件列表"):
-    """打印文件列表"""
-    print(f"\n📁 {title} (共 {len(files)} 个):")
-    if not files:
-        print("  (空)")
-        return
-
-    for i, file in enumerate(files, 1):
-        file_type = "📁" if file.ext.get("type") == "folder" else "📄"
-        size_str = f"{file.size:,} bytes" if file.size > 0 else "-"
-        print(f"  {i:2d}. {file_type} {file.name}")
-        print(f"      路径: {file.fid}")
-        print(f"      大小: {size_str}")
-        if file.ext.get("modified"):
-            print(f"      修改时间: {file.ext['modified']}")
-
-
 def demo_basic_operations(drive: TSingHuaDrive):
     """演示基本操作"""
     print_separator("基本操作演示")

src/fundrive/drives/wenshushu/example.py

@@ -25,11 +25,10 @@
 import argparse
 import os
 import tempfile
-from typing import List
 
 
 from fundrive.drives.wenshushu import WSSDrive
-from fundrive.core import DriveFile
+from fundrive.utils.file import print_files
 
 
 def print_separator(title: str = ""):
@@ -40,25 +39,6 @@ def print_separator(title: str = ""):
         print("=" * 60)
 
 
-def print_files(files: List[DriveFile], title: str = "文件列表"):
-    """打印文件列表"""
-    print(f"\n📁 {title} (共 {len(files)} 个):")
-    if not files:
-        print("  (空)")
-        return
-
-    for i, file in enumerate(files, 1):
-        file_type = "📁" if file.ext.get("type") == "folder" else "📄"
-        size_str = f"{file.size:,} bytes" if file.size > 0 else "-"
-        print(f"  {i:2d}. {file_type} {file.name}")
-        print(f"      ID: {file.fid}")
-        print(f"      大小: {size_str}")
-        if file.ext.get("upload_time"):
-            print(f"      上传时间: {file.ext['upload_time']}")
-        if file.ext.get("share_url"):
-            print(f"      分享链接: {file.ext['share_url']}")
-
-
 def create_test_file(filename: str = "test_file.txt", content: str = None) -> str:
     """创建测试文件"""
     if content is None:

src/fundrive/utils/__init__.py

@@ -0,0 +1,20 @@
+from typing import List
+
+from fundrive import DriveFile
+
+
+def print_files(files: List[DriveFile], title: str = "文件列表"):
+    """打印文件列表"""
+    print(f"\n📁 {title} (共 {len(files)} 个):")
+    if not files:
+        print("  (空)")
+        return
+
+    for i, file in enumerate(files, 1):
+        file_type = "📁" if file.ext.get("type") == "folder" else "📄"
+        size_str = f"{file.size:,} bytes" if file.size > 0 else "-"
+        print(f"  {i:2d}. {file_type} {file.name}")
+        print(f"      路径: {file.fid}")
+        print(f"      大小: {size_str}")
+        if file.ext.get("modified"):
+            print(f"      修改时间: {file.ext['modified']}")