ftplib 用法示例

ftplib模块是Python标准库中的一个模块，用于实现FTP（文件传输协议）的客户端功能。它提供了一些用于连接FTP服务器、上传和下载文件等常见操作的函数和类。以下是一些ftplib模块的基本用法示例：

一、创建FTP对象并连接与登录FTP服务器

1. 导入ftplib模块。
2. 创建FTP对象，并指定FTP服务器的主机名、用户名、密码等信息（可选，也可以在connect和login方法中分别指定）。
3. 使用connect方法连接到FTP服务器。
4. 使用login方法登录到FTP服务器。

示例代码如下：

import ftplib

# 创建FTP对象
ftp = ftplib.FTP(host='ftp.example.com', user='username', passwd='password')

# 或者分别使用connect和login方法
# ftp = ftplib.FTP()
# ftp.connect(host='ftp.example.com', port=21)  # 端口号默认为21，可以省略
# ftp.login(user='username', passwd='password')

二、切换目录、查看目录列表

1. 使用cwd方法更改当前工作目录。
2. 使用nlst或retrlines方法列出当前目录下的文件和目录。

示例代码如下：

# 切换到指定目录
ftp.cwd('/path/to/directory')

# 列出当前目录下的文件和目录
files = ftp.nlst()  # 或者使用 ftp.retrlines('LIST')
print(files)

三、文件上传与下载

1. 使用storbinary方法上传文件。该方法需要指定存储命令（如'STOR filename'）和文件对象。
2. 使用retrbinary方法下载文件。该方法需要指定检索命令（如'RETR filename'）和一个用于写入数据的函数（通常是文件对象的write方法）。

示例代码如下：

# 上传文件
with open('local_file.txt', 'rb') as file_object:
    ftp.storbinary('STOR remote_file.txt', file_object)

# 下载文件
with open('downloaded_file.txt', 'wb') as file_object:
    ftp.retrbinary('RETR remote_file.txt', file_object.write)

四、其他常见操作

ftplib模块还支持其他常见操作，如删除远程文件、新建远程目录、删除远程目录（空目录）以及重命名文件或目录等。

示例代码如下：

# 删除远程文件
ftp.delete('remote_file.txt')

# 新建远程目录
ftp.mkd('new_directory')

# 删除远程目录（空目录）
ftp.rmd('directory_to_remove')

# 重命名文件或目录
ftp.rename('old_name.txt', 'new_name.txt')

五、关闭FTP连接

完成所有操作后，使用quit方法断开与FTP服务器的连接，并关闭FTP连接。

示例代码如下：

ftp.quit()

以上示例展示了ftplib模块的基本用法。在实际应用中，可能需要处理各种异常情况，如网络问题、登录失败等。因此，建议在使用ftplib模块时添加适当的异常处理代码。