124 lines
2.3 KiB
Python
124 lines
2.3 KiB
Python
from typing import Protocol, IO
|
||
|
||
|
||
# 基类
|
||
class Attachment(Protocol):
|
||
"""
|
||
附件处理协议类，定义了附件处理的基本接口。
|
||
"""
|
||
|
||
def exists(self, path: str) -> bool:
|
||
"""
|
||
检查文件或目录是否存在。
|
||
|
||
参数:
|
||
path (str): 文件或目录路径。
|
||
|
||
返回:
|
||
bool: 如果存在返回True，否则返回False。
|
||
"""
|
||
pass
|
||
|
||
def makedirs(self, path: str) -> bool:
|
||
"""
|
||
创建目录，包括所有中间目录。
|
||
|
||
参数:
|
||
path (str): 目录路径。
|
||
|
||
返回:
|
||
bool: 总是返回True。
|
||
"""
|
||
pass
|
||
|
||
def open(self, path: str, mode: str) -> IO:
|
||
"""
|
||
打开一个文件并返回文件对象。
|
||
|
||
参数:
|
||
path (str): 文件路径。
|
||
mode (str): 打开文件的模式。
|
||
|
||
返回:
|
||
IO: 文件对象。
|
||
"""
|
||
pass
|
||
|
||
def remove(self, path: str) -> bool:
|
||
"""
|
||
删除文件
|
||
|
||
参数:
|
||
path (str): 文件路径
|
||
|
||
返回:
|
||
bool: 是否删除成功
|
||
"""
|
||
pass
|
||
|
||
def isdir(self, path: str) -> bool:
|
||
|
||
"""
|
||
判断是否为目录
|
||
|
||
参数:
|
||
s3_url (str): 文件路径
|
||
|
||
返回:
|
||
bool: 是否为目录
|
||
"""
|
||
pass
|
||
@classmethod
|
||
def join(cls, path: str, *paths: str) -> str:
|
||
"""
|
||
连接一个或多个路径组件。
|
||
|
||
参数:
|
||
path (str): 第一个路径组件。
|
||
*paths (str): 其他路径组件。
|
||
|
||
返回:
|
||
str: 连接后的路径。
|
||
"""
|
||
pass
|
||
|
||
@classmethod
|
||
def dirname(cls, path: str) -> str:
|
||
"""
|
||
获取路径的目录名。
|
||
|
||
参数:
|
||
path (str): 文件路径。
|
||
|
||
返回:
|
||
str: 目录名。
|
||
"""
|
||
pass
|
||
|
||
@classmethod
|
||
def basename(cls, path: str) -> str:
|
||
"""
|
||
获取路径的基本名（文件名）。
|
||
|
||
参数:
|
||
path (str): 文件路径。
|
||
|
||
返回:
|
||
str: 基本名（文件名）。
|
||
"""
|
||
pass
|
||
|
||
def getsize(self, path) -> int:
|
||
"""
|
||
获取文件大小
|
||
|
||
参数:
|
||
path (str): 文件路径
|
||
|
||
返回:
|
||
int: 文件大小
|
||
"""
|
||
pass
|
||
|
||
|