Python ftplib
概述
该模块是内置模块,定义了FTP类和一些相关项。FTP类实现了FTP协议的客户端。你可以用它来编程来处理一系列FTP相关的任务。
快速入门
>>> from ftplib import FTP
>>> ftp = FTP('ftp.debian.org') # connect to host, default port
>>> ftp.login(‘usr', 'pwd') # anonymous loging, just let usr and pwd empty@
'230 Login successful.'
>>> ftp.cwd('debian') # change into "debian" directory
>>> ftp.retrlines('LIST') # list directory contents, same as ftp.dir()
-rw-rw-r-- 1 1176 1176 1063 Jun 15 10:18 README
...
drwxr-sr-x 5 1176 1176 4096 Dec 19 2000 pool
drwxr-sr-x 4 1176 1176 4096 Nov 17 2008 project
drwxr-xr-x 3 1176 1176 4096 Oct 10 2012 tools
'226 Directory send OK.'
>>> ftp.retrbinary('RETR README', open('README', 'wb').write)
'226 Transfer complete.'
>>> ftp.quit()
类介绍
- class ftplib.FTP([host[, user[, passwd[, acct[, timeout]]]]]):
返回FTP类的新实例。提供host时调用connect(host)。提供user时调用login(user, passwd, acct),passwd和acct在没有提供时默认为空。可选timeout参数指定用于像连接尝试之类阻塞操作的超时描述(如果未指定,则timeout 全局默认超时设置)。超时为2.6加入。
- class ftplib.FTP_TLS([host[, user[, passwd[, acct[, keyfile[, certfile[, timeout]]]]]]])
FTP子类,增加TLS支持到FTP,在RFC4217http://tools.ietf.org/html/rfc4217.html中描述。TLS的快速了解参见http://zh.wikipedia.org/wiki/TLS。和通常一样连接到21端口但认证以前已经加密了FTP控制连接。调用prot_p()可以保护数据连接。keyfile和certfile中是可选的 - 它们可以包含PEM格式的私钥和SSL连接的证书链文件名。2.7版本新增。
示例:
>>> from ftplib import FTP_TLS
>>> ftps = FTP_TLS('ftp.python.org')
>>> ftps.login('usr', 'pwd') # login anonymously before securing control channel
>>> ftps.prot_p() # switch to secure data connection
>>> ftps.dir() # list directory content securely
total 9
drwxr-xr-x 8 root wheel 1024 Jan 3 1994 .
drwxr-xr-x 8 root wheel 1024 Jan 3 1994 ..
drwxr-xr-x 2 root wheel 1024 Jan 3 1994 bin
drwxr-xr-x 2 root wheel 1024 Jan 3 1994 etc
d-wxrwxr-x 2 ftp wheel 1024 Sep 5 13:43 incoming
drwxr-xr-x 2 root wheel 1024 Nov 17 1993 lib
drwxr-xr-x 6 1094 wheel 1024 Sep 13 19:07 pub
drwxr-xr-x 3 root wheel 1024 Jan 3 1994 usr
-rw-r--r-- 1 root root 312 Aug 1 1994 welcome.msg
>>> ftps.quit()
>>>
我这边试验,ftps = FTP_TLS('ftp.python.org')报错socket.error: [Errno 101] Network is unreachable。
- exception ftplib.error_reply
Exception raised when an unexpected reply is received from the server. 从服务器接收到非预期的reply时产生。
- exception ftplib.error_temp
Exception raised when an error code signifying a temporary error (response codes in the range 400–499) is received. 接收到临时错误(范围400-499响应代码)。
- exception ftplib.error_perm
Exception raised when an error code signifying a permanent error (response codes in the range 500–599) is received. 接收到永久性的错误(范围500-599响应代码)。。
- exception ftplib.error_proto
Exception raised when a reply is received from the server that does not fit the response specifications of the File Transfer Protocol, i.e. begin with a digit in the range 1–5. 不符合FTP响应规格的响应,即1-5开头的数字。
- ftplib.all_errors
The set of all exceptions (as a tuple) that methods of FTP instances may raise as a result of problems with the FTP connection (as opposed to programming errors made by the caller). This set includes the four exceptions listed above as well as socket.error and IOError.FTP示例的异常集合,为元组,包含以上4种异常和socket.error和IOError
模块netrc可以解析.netrc文件,FTP客户端通常使用.netrc文件加载用于验证信息。python源码中的Tools/scripts/ftpmirror.py可以镜像FTP站点,可以看做本模块的实例。
FTP对象
方法分为处理文本文件和二进制文件,方法名分别对应lines和binary。
- FTP.set_debuglevel(level)
设置实例的调试级别。默认情况为0,不产生任何调试输出。值为1时会产生适量的调试输出,一般每次请求一行。 2或更高的值会产生大量调试输出,记录控制连接上发送和接收的每行。
- FTP.connect(host[, port[, timeout]])
连接到指定的host和port。默认端口号为21。此函数每个实例只调用一次,如果在创建实例时指定了host则不能调用。所有其他的方法经建立连接后使用。在2.6版本:加入超时。
- FTP.getwelcome()
Return the welcome message sent by the server in reply to the initial connection. (This message sometimes contains disclaimers or help information that may be relevant to the user.)
- FTP.login([user[, passwd[, acct]]])
登录为user。passwd和acct参数可选,默认为空字符串。如果没有指定用户,默认为'anonymous'。如果用户是'anonymous',默认的passwd是'anonymous@'。此函数每个实例只调用一次,acct为"accounting information",很少有系统实现。
- FTP.abort()
中止正在传输的文件,使用未必总是有效,但值得一试。
- FTP.sendcmd(command)
发送简单的命令字符串到服务器,并返回响应字符串。
- FTP.voidcmd(command)
发送一个简单的命令字符串到服务器,并处理响应。返回None如果接收到成功(范围200-299码。否则报error_reply。
- FTP.retrbinary(command, callback[, maxblocksize[, rest]])
用二进制传输方式获取文件。命令应该是适当的RETR命令:'RETR filename'。每次接收到数据块时会调用callback函数。
- FTP.retrlines(command[, callback])
用文本传输方式获取文件。命令应该是适当的RETR命令或LIST, NLST,MLSD。LIST获取文件和信息列表,NLST 获取文件名列表,一些服务器上MLSD返回可读文件和信息的列表。每次接收到一行时会调用callback函数,默认为打印到sys.stdout。
- FTP.set_pasv(boolean)
是否启用"passive"模式,默认为开启。
- FTP.storbinary(command, file[, blocksize, callback, rest])
二进制传输方式存储文件。command是适当的STOR命令:"STOR filename"。file是打开的文件对象,可以使用其read()方法读取blocksize的数据直到EOF。blocksize默认为8192。2.6版本:callback添加。2.7版本:rest添加。
- FTP.storlines(command, file[, callback])
文本传输方式存储文件。command是适当的STOR命令:"STOR filename"。2.6版本:callback添加。
- FTP.transfercmd(cmd[, rest])
在数据连接启动传输。如果传输处于active状态,发送EPRT或PORT命令,传输CMD命令,并接受连接。如果服务器是passive的,发送EPSV或PASV命令,连接再开始传输命令。无论哪种方式都返回套接字连接。
如果有可选的rest,以rest为参数发送REST命令到服务器。rest通常是请求文件中的字节偏移量,告诉服务器重新启动时所要求的偏移发送文件的字节数,跳过最初的字节。但是请注意, RFC 959中只要求休息是包含在可打印范围从ASCII码33为ASCII码126个字符的字符串。transfercmd()方转换rest为字符串,但不检查字符串的内容。如果服务器不能识别REST命令,将引发异常error_reply。如果发生这种情况,只需不附加rest调用transfercmd() 。
- FTP.ntransfercmd(cmd[, rest])
像transfercmd(),但返回元组,包含数据连接,预期数据大小。如果预期的大小不能计算,返回None。
- FTP.nlst(argument[, ...])
返回NLST命令返回的文件名列表。可选参数argument是目录(默认为当前服务器的目录)。多多个参数可以用来传递非标准选项给NLST命令。
- FTP.dir(argument[, ...])
通过LIST命令返回目录列表,打印到标准输出。可选参数argument是目录(默认为当前服务器的目录)。多个参数可以用来传递非标准选项给LIST命令。如果最后一个参数是函数,用来作为retrlines()的回调函数;默认打印到sys.stdout。此方法返回None。
- FTP.rename(fromname, toname)
重命名文件。
- FTP.cwd(pathname)
设置当前目录。
- FTP.mkd(pathname)
创建新目录。
- FTP.pwd()
返回当前目录。
- FTP.rmd(dirname)
删除目录。
- FTP.size(filename)
返回文件大小。不成功返回None。SIZE不标准,但是多数服务器支持。
- FTP.quit()
发送QUIT命令到服务器并关闭连接。这是礼貌的方式来关闭连接,但是如果服务器返回错误给QUIT命令时可能会引发异常。这意味着在调用close()方法而呈现的FTP实例无用的后续调用(见下文) 。
- FTP.close()
单方面关闭连接。不能多次关闭连接或重开连接。
FTP_TLS对象
FTP_TLS继承了FTP,增加了如下:
- FTP_TLS.ssl_version:SSL版本,默认为TLSv1
- FTP_TLS.auth():使用TLS或SSL(使用何种处决于ssl_version)建立安全控制连接。
- FTP_TLS.prot_p():建立安全的数据连接。
- FTP_TLS.prot_c():建立明文数据连接。
附:模板
#!/usr/bin/python
# -*- coding: utf-8 -*-
import ftplib
import os
import socket HOST = 'ftp.mozilla.org'
DIRN = 'pub/mozilla.org/webtools'
FILE = 'bugzilla-3.6.7.tar.gz'
def main():
try:
f = ftplib.FTP(HOST)
except (socket.error, socket.gaierror):
print 'ERROR:cannot reach " %s"' % HOST
return
print '***Connected to host "%s"' % HOST try:
f.login()
except ftplib.error_perm:
print 'ERROR: cannot login anonymously'
f.quit()
return
print '*** Logged in as "anonymously"'
try:
f.cwd(DIRN)
except ftplib.error_perm:
print 'ERRORL cannot CD to "%s"' % DIRN
f.quit()
return
print '*** Changed to "%s" folder' % DIRN
try:
#传一个回调函数给retrbinary() 它在每接收一个二进制数据时都会被调用
f.retrbinary('RETR %s' % FILE, open(FILE, 'wb').write)
except ftplib.error_perm:
print 'ERROR: cannot read file "%s"' % FILE
os.unlink(FILE)
else:
print '*** Downloaded "%s" to CWD' % FILE
f.quit()
return if __name__ == '__main__':
main()
Python ftplib的更多相关文章
- Python ftplib模块
Python ftplib模块 官方文档:https://docs.python.org/3/library/ftplib.html?highlight=ftplib#module-ftplib 实例 ...
- python ftplib,smtplib,poplib学习
一.ftplib from ftplib import FTP ftpobj = FTP(IP或域名) #实例化对象 ftpobj.login('username','passwd') ## ...
- 关于Python, ftplib模块中的cwd()进入含中文目录失败的问题
使用Python的ftplib模块连接ftp服务器时, 使用cwd()连接含中文的目录, 报错 : UnicodeEncodeError: 'latin-1' codec can't encode c ...
- python ftplib模块使用
Python中默认安装的ftplib模块定义了FTP类,可用来实现简单的ftp客户端,用于上传或下载文件. ftplib模块常用方法 ftp登陆连接 from ftplib import FTP #加 ...
- 使用python ftplib包递归下载文件夹及文件
#!/usr/bin/env python # -*- coding: utf-8 -*- # @Date : 2018-06-11 09:35:49 # @Author : Yaheng Wang ...
- Python ftplib 模块关于 ftp的下载
import ftplib import os import socket import sys HOST='192.168.216.193' DIRN='c:\\ftp\FTP.123' FILE= ...
- python ftplib.FTP 获取当前路径下所有目录
FTP 模块里有一个dir函数,可以打印出当前路径下所有文件,但是这个函数没有返回值,只是打印出来. 还有一个nlst函数,可以返回一个文件名的列表,但是只有文件名,没有详细信息,无法判断是否是目录. ...
- python标准库学习-ftplib
源码: """An FTP client class and some helper functions. Based on RFC 959: File Transfer ...
- 【Python学习 】Python实现的FTP上传和下载功能
一.背景 最近公司的一些自动化操作需要使用Python来实现FTP的上传和下载功能.因此参考网上的例子,撸了一段代码来实现了该功能,下面做个记录. 二.ftplib介绍 Python中默认安装的ftp ...
随机推荐
- 夺命雷公狗---微信开发58----微网站之jquery_mobile之控件介绍
我们上一节课里面介绍了基本的jqm是如何用的了,那么这一节课我们就开始玩玩他的控件 1...布局网格 <!DOCTYPE html> <html> <head> & ...
- webform 文件上传(头像上传) 隐藏FileUpload
<div> <%-- 核心思想:把FileUpload设为relative,top:-200px;opacity: --%> <div id="localIma ...
- Office 2007在安装过程中出错-解决办法
1, 可能是因为c:\program files\common files\microsoft Shared\web server Extensions\40\bin目录下缺少Fp4autl.dll, ...
- android 学习随笔十(网络:get、post提交数据)
1.get public class Tools { public static String getTextFromStream(InputStream is){ byte[] b = new by ...
- 161125、Java网络编程之统一资源定位符URL
统一资源定位符URL(Uniform Resource Locator)是www客户机访问Internet时用来标识资源的名字和地址.超文本链路由统一资源定位符URL维持.URL的格式是: <M ...
- webpack笔记_(3)_First_Project
知道了怎么样安装,那么学习一下简单的应用吧. 1.安装webpack npm install webpack -g (全局) npm install webpack --save--dev (本地) ...
- 给文件加ip访问限制
获取IP: function getIP(){ return isset($_SERVER['HTTP_X_FORWARDED_FOR'])? $_SERVER['HTTP_X_FORWARDED_F ...
- arm驱动linux异步通知与异步IO【转】
转自:http://blog.csdn.net/chinazhangzhong123/article/details/51638793 <[ arm驱动] linux异步通知与 异步IO> ...
- Web API 2 authentication with JWT
Web API 2 authentication with JWT JSON Web Token (JWT) 使用 AngularJS & NodeJS 实现基于 token 的认证应用
- IE11下,IIS7.5不自动生成__doPostBack事件
MS在 2013/10/8 已出补丁 http://www.microsoft.com/zh-cn/download/details.aspx?id=39257 https://support.mic ...