11.5 ftplib -- cliente del protocolo FTP

Este módulo define la clase FTP y otros elementos relacionados. la clase FTP implementa el lado cliente del protocolo FTP. Se puede utilizar para escribir programas que realizan diversas tareas FTP automatizadas, tales como clonar otros servidores de FTP. También lo utiliza el módulos urllib para tratar las URLs que usan FTP. Para obtener más información sobre FTP (Protocolo de Transferencia de Ficheros), consúltese en Internet RFC 959.

He aquí una sesión de ejemplo del módulo ftplib:

>>> from ftplib import FTP
>>> ftp = FTP('ftp.cwi.nl')   # conectarse al servidor al puerto predeterm.
>>> ftp.login()               # usuario anonymous, contraseña user@hostname
>>> ftp.retrlines('LIST')     # enumerar el contenido del directorio
total 24418
drwxrwsr-x   5 ftp-usr  pdmaint     1536 Mar 20 09:48 .
dr-xr-srwt 105 ftp-usr  pdmaint     1536 Mar 21 14:32 ..
-rw-r--r--   1 ftp-usr  pdmaint     5305 Mar 20 09:48 INDEX
 .
 .
 .
>>> ftp.retrbinary('RETR README', open('README', 'wb').write)
'226 Transfer complete.'
>>> ftp.quit()

El módulo define los siguientes elementos:

FTP ([host[, user[, passwd[, acct]]]])
Devuelve una instancia nueva de la clase FTP. Si se proporciona host, se llama al método connect(host). Si se proporciona user, además se llama al método login(user, passwd, acct) (donde passwd y acct toman el valor por defecto, la cadena vacía).

all_errors
El conjunto de todas las excepciones (como tupla) que pueden lanzar los métodos de las instancias de FTP como resultado de problemas en la conexión FTP (no los errores de programación del usuario de la biblioteca). Este conjunto incluye las cuatro excepciones enumeradas a continuación, además de socket.error y IOError.

error_reply
Excepción que se lanza cuando se recibe una respuesta inesperada del servidor.

error_temp
Excepción que se lanza cuando se recibe un código de error en el rango 400-499.

error_perm
Excepción que se lanza cuando se recibe un código de error en el rango 500-599.

error_proto
Excepción que se lanza cuando se recibe una respuesta del servidor que no comienza por un dígito en el rango 1-5.

Más informació en:

Module netrc:
Analizador del formato de fichero .netrc. Este fichero lo utilizan típicamente los clientes de FTP para cargar la información de autentificación del usuario antes de preguntarle.

El fichero Tools/scripts/ftpmirror.py de la distribución de fuentes de Python es un guion para clonar servidores FTP total o parcialmente, utilizando el módulo ftplib. Se puede utilizar como ejemplo extenso de utilización de este módulo.


Subsections

Ver Sobre este documento... para obtener información sobre sugerencias.