| """ |
| 文件处理工具类 |
| |
| 纯工具方法，不包含业务逻辑 |
| """ |
|
|
| import logging |
| from pathlib import Path |
| from typing import Any |
|
|
| logger = logging.getLogger("apps.automation") |
|
|
|
|
| class FileUtils: |
| """文件处理相关工具方法""" |
|
|
| @staticmethod |
| def validate_file_basic(file_path: str, expected_extensions: list[Any] | None = None) -> dict[str, Any]: |
| """ |
| 基础文件校验 |
| |
| Args: |
| file_path: 文件路径 |
| expected_extensions: 期望的文件扩展名列表 |
| |
| Returns: |
| 校验结果 {valid: bool, error: str, info: dict} |
| """ |
| result: dict[str, Any] = {"valid": True, "error": None, "info": {}} |
|
|
| |
| if not Path(file_path).exists(): |
| result["valid"] = False |
| result["error"] = "文件不存在" |
| return result |
|
|
| |
| file_size = Path(file_path).stat().st_size |
| result["info"]["size"] = file_size |
|
|
| if file_size == 0: |
| result["valid"] = False |
| result["error"] = "文件为空" |
| return result |
|
|
| |
| ext = Path(file_path).suffix.lower() |
| result["info"]["extension"] = ext |
|
|
| if expected_extensions and ext not in expected_extensions: |
| result["valid"] = False |
| result["error"] = f"文件类型不匹配，期望: {expected_extensions}" |
| return result |
|
|
| |
| try: |
| with open(file_path, "rb") as f: |
| f.read(1024) |
| except Exception as e: |
| result["valid"] = False |
| result["error"] = f"文件可能损坏: {e!s}" |
| return result |
|
|
| logger.info(f"文件校验通过: {file_path} ({file_size} bytes)") |
| return result |
|
|
