Next: gopherlib Prev: httplib Up: Internet and WWW Top: Top

11.4. Standard Module ftplib

This module defines the class FTP and a few related items. The FTP class implements the client side of the FTP protocol. You can use this to write Python programs that perform a variety of automated FTP jobs, such as mirroring other ftp servers. It is also used bu the module urllib to handle URLs that use FTP. For more information on FTP (File Transfer Protocol), see Internet RFC 959.

Here's a sample session using the ftplib module:

The module defines the following items:

FTP ([host[, user, passwd, acct]]) -- function of module ftplib
Return a new instance of the FTP class. When host is given, the method call connect(host) is made. When user is given, additionally the method call login(user, passwd, acct) is made (where passwd and acct default to the empty string when not given).
all_errors -- data of module ftplib
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 below as well as socket.error and IOError.
error_reply -- exception of module ftplib
Exception raised when an unexpected reply is received from the server.
error_temp -- exception of module ftplib
Exception raised when an error code in the range 400--499 is received.
error_perm -- exception of module ftplib
Exception raised when an error code in the range 500--599 is received.
error_proto -- exception of module ftplib
Exception raised when a reply is received from the server that does not begin with a digit in the range 1--5.

Menu

FTP Objects