set_debuglevel() | 定义: FTP.set_debuglevel(level) 功能:设置实例的调试级别,0:不输出(缺省值),1:中等调试输出,通常每个请求一行,2:显示详细信息 |
connect() | 定义:FTP.connect(host='', port=0, timeout=None, source_address=None) 功能:连接到给定的主机和端口。默认端口号是21,由FTP协议规范指定。很少需要指定其他端口号。每个实例只应调用一次该函数。如果在创建实例时给出了主机,则根本不应该调用它。所有其他方法只能在建立连接后使用。可选的timeout参数指定连接尝试的超时时间(以秒为单位)。如果没有超时,则使用全局默认超时设置。source_address是2个元组(主机,端口),套接字在连接之前绑定为其源地址。 |
getwelcome() | 定义:FTP.getwelcome() 功能:返回服务器发送的欢迎消息以回复初始连接。(此消息有时包含与用户有关的免责声明或帮助信息。) |
login() | 定义:FTP.login(user='', password='', acct='') 功能:以给定用户身份登录, password和acct参数是可选的,默认为空字符串。如果用户未指定,则默认为anonymous。如果用户为anonymous,则默认密码为anonymous@。建立连接后,每个实例只能调用一次此函数。大多数FTP命令仅在客户端登录后才被允许。 |
abort() | 定义:FTP.abort() 功能:中止正在进行的文件传输。不一定总是可以使用,但值得一试。 |
sendcmd() | 定义:FTP.sendcmd(cmd) 功能:将简单的命令字符串发送到服务器并返回响应字符串。 |
voidcmd() | 定义:FTP.voidcmd(cmd) 功能:将简单的命令字符串发送到服务器并处理响应。如果收到与成功相对应的响应代码(范围在200-299之间的代码),则不返回任何内容。否则,请引发error_reply。 |
retrbinary() | 定义:retrbinary(self, cmd, callback, blocksize=8192, rest=None) 功能:以二进制模式获取文件。 参数:
cmd:是一个RETR命令:RETR filename, filename为要获取文件的完整路径+名称 callback :在读取的每个数据块上可调用的回调函数,使用单个字节参数指定数据块 blocksize:可选参数,实际传输的数据块的最大尺寸(这也是传递给回调的数据块的最大大小) 返回值:响应代码 |
retrlines() | 定义:FTP.retrlines(cmd, callback = None) 功能:以ASCII传输模式获取文件或目录列表 参数:cmd:RETR命令,或者诸如LIST或NLST之类的命令。每一行都使用一个字符串参数调用回调函数。默认将回调行打印到sys.stdout。 |
storbinary() | 定义:FTP.storbinary(cmd, fp, blocksize=8192, callback=None, rest=None) 功能:以二进制传输模式存储文件,即上产本地文件至FTP服务器 参数:
cmd:合适的STOR命令:“STOR filename”
fp:文件对象,以read()方法读取文件直到EOF
blocksize:默认值为8192,数据库大小
callback:可选参数,在每个数据库发送后调用 返回值:响应代码 |
storlines() | 定义:FTP.storlines(cmd, fp, callback=None) 功能:以ASCII模式存储文件,创建一个新的端口 参数:
cmd:合适的STOR命令
fp:文件对象,以read()方法读取文件直到EOF |
set_pasv() | 定义:set_pasv(val) 功能:设置传输数据使用主动模式还是被动模式 参数:val为true表示使用被动模式(PASV命令),false表示使用正常的PORT模式。默认是true |
size() | 定义:FTP.size(filename) 功能:请求服务器上名为filename的文件的大小。成功后,将以整数形式返回文件的大小,否则返回None。 |
quit() | 定义:FTP.quit() 功能:将QUIT命令发送到服务器并关闭连接。这是关闭连接的“礼貌”方式,但是如果服务器响应QUIT命令错误,则可能会引发异常。这意味着将调用close()方法,从而使FTP实例无法用于后续调用。 |
close() | 定义:FTP.close() 功能:单方面关闭连接,这不应该用于已经关闭的连接,例如,已经成功调用quit()之后。在此调用之后,不应该再使用FTP实例(在调用close()或quit()之后,将无法通过发出另一个login()方法再来重新打开连接) |