11.7 ftplib -- Client per protocollo FTP

Questo modulo definisce la classe FTP ed una serie di elementi correlati. La classe FTP implementa la parte client del protocollo FTP. La si puņ utilizzare per scrivere programmi Python che eseguono una serie di compiti FTP automatizzati, come la duplicazione di altri server ftp. Viene anche utilizzato dal modulo urllib per gestire URL che utilizzano FTP. Per maggiori informazioni sull'FTP (Protocollo di Trasferimento File), vedere la RFC 959 Internet.

Qui un esempio di sessione che utilizza il modulo ftplib:

>>> from ftplib import FTP
>>> ftp = FTP('ftp.cwi.nl')   # Si connette all'host sulla porta predefinita
>>> ftp.login()               # utente anonymous, password anonymous@
>>> ftp.retrlines('LIST')     # elenca il contenuto della directory
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()

Il modulo definisce i seguenti elementi:

class FTP( [host[, user[, passwd[, acct]]]])
Restituisce una nuova istanza della classe FTP. Quando viene passato host, il metodo chiama connect(host). Quando user viene passato, viene ulteriormente chiamato il metodo login(user, passwd, acct) (dove, in modo predefinito, passwd e acct sono stringhe vuote, se non diversamente indicate).

all_errors
L'insieme di tutte le eccezioni (come tuple) che i metodi dell'istanza FTP possono sollevare, come risultanza di problemi con la connessione FTP (all'opposto di errori di programmazione fatti dal chiamante). Questo insieme include le quattro eccezioni elencate sotto, come anche socket.error ed IOError.

exception error_reply
Eccezione sollevata quando viene ricevuta una risposta inaspettata dal server.

exception error_temp
Eccezione sollevata quando viene ricevuto un codice di errore nell'intervallo 400-499.

exception error_perm
Eccezione sollevata quando viene ricevuto un codice di errore nell'intervallo 500-599.

exception error_proto
Eccezione sollevata quando viene ricevuta una risposta dal server che non inizia con un numero nell'intervallo 1-5.

Vedete anche:

Modulo netrc:
Analizzatore per file in formato .netrc. Il file .netrc viene tipicamente utilizzato dai client FTP per caricare le informazioni di autenticazione dell'utente prima di richiederle direttamente al prompt dell'utente stesso.

Il file Tools/scripts/ftpmirror.py nel sorgente Python della distribuzione č uno script che puņ duplicare siti FTP, o porzioni di esso, usando il modulo ftplib. Puņ essere usato come un esempio esteso applicabile a questo modulo.



Subsections
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.