miarec_ftpfs

MiaRec FTPFS是PyFilesystem对FTP/FTPS存储的接口。

这是一个由Will McGugan（电子邮件willmcgugan@gmail.com）编写的PyFileSystem2项目内置FTPFS类的分支。

代码已被MiaRec团队修改以满足我们的需求。

miarec_ftpfs.FTPFS与fs.FTPFS之间的显著差异

1. 需要Python 3.6+。已移除对Python 2.7的支持。

2. 打开协议前缀为mftp://和mftps://，分别对应FTP和FTP-over-TLS（而不是原始的ftp://和ftps://）

3. 添加隐式TLS支持

4. 修复显式TLS实现中的错误

5. 在出现网络问题时，自动尝试在下一次操作中重新打开FTP连接。以前，FTPFS对象会陷入错误状态，任何对文件系统实例的操作（如openbin()、listdir()等）都会无限期失败。

6. 更好的错误处理。所有FTP协议特定和SSL错误都被转换为相应的FSError异常

安装

您可以通过以下方式使用pip安装FTPFS：

pip install miarec_ftpfs

这将安装最新稳定的版本。

或者，如果您想获取最新的代码，可以查看GitHub仓库：https://github.com/miarec/miarec_ftpfs

打开FTPFS

通过显式使用构造函数来打开FTPFS

from fs.ftpfs import FTPFS
FTPFS("demo.wftpserver.com")

或者通过FS URL

ftp_fs = fs.open_fs('mftp://test.rebex.net')

或者通过使用TLS的FS URL

ftp_fs = fs.open_fs('mftps://demo.wftpserver.com')

您还可以使用非匿名用户名，甚至可以在FS URL中使用密码

ftp_fs = FTPFS("test.rebex.net", user="demo", passwd="password")
ftp_fs = fs.open_fs('mftp://demo:password@test.rebex.net')

支持通过代理连接。如果使用FS URL，则需要将代理URL添加为URL参数

ftp_fs = FTPFS("ftp.ebi.ac.uk", proxy="test.rebex.net")
ftp_fs = fs.open_fs('mftp://ftp.ebi.ac.uk/?proxy=test.rebex.net')

测试

自动单元测试在GitHub Actions上运行

要本地运行测试，请执行以下操作。

创建Python虚拟环境

python -m vevn venv
source venv\bin\activate

安装项目和测试依赖项

pip install -e ".[test]"

运行测试

pytest

文档

• PyFilesystem Wiki
• PyFilesystem 参考