11.5 `ftplib` --- Client pour le protocole FTP

Ce module définit la classe FTP et quelques éléments associés. La classe FTP implémente le côté client du protocole FTP. Vous pouvez vous en servir pour écrire des programmes Python qui exécute une grande variété de tâches FTP automatisées, comme de créer des miroirs d'autres serveurs FTP. Il est aussi utilisé par le module urllib pour gérer les URL qui utilisent FTP. Pour plus d'informations au sujet de FTP (File Transfer Protocol), voir Internet RFC 959.

Voici un exemple de session qui utilise le module ftplib:

>>> from ftplib import FTP
>>> ftp = FTP('ftp.cwi.nl')   # connexion à l'hôte, port par défaut
>>> ftp.login()               # utilisateur anonyme, mot de passe utilisateur@nom_hote
>>> ftp.retrlines('LIST')     # liste le contenu du répertoire
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 LISEZMOI', open('LISEZMOI', 'wb').write)
'226 Transfer complete.'
>>> ftp.quit()

Le module définit les éléments suivants:

FTP([hote[, utilisateur[, motdepasse[, compte]]]]): Retourne une nouvelle instance de la classe FTP. Quand hote est fourni, l'appel à la méthode connect(host) est effectué. Quand utilisateur est fourni, l'appel additionnel à la méthode login(utilisateur, motdepasse, compte) est effectué (où motdepasse et compte sont par défaut des chaînes vides quand ils ne sont pas fournis).

all_errors

L'ensemble de toutes les exceptions (sous forme de tuple) que les méthodes des instances de FTP peuvent déclencher en cas de problèmes avec la connexion FTP (par opposition aux erreurs de programmation faites par l'appelant). Cet ensemble inclut les quatre exceptions listées ci-dessous ainsi que socket.error et IOError.

error_reply

Exception déclenchée quand une réponse inattendue est reçue du serveur.

error_temp

Exception déclenchée quand un code d'erreur dans l'intervalle 400--499 est reçu.

error_perm

Exception déclenchée quand un code d'erreur dans l'intervalle 500--599 est reçu.

error_proto

Exception déclenchée quand une réponse est reçue du serveur et qu'elle ne commence pas par un chiffre dans l'intervalle 1--5.

Voir aussi:

Module netrc:: Analyseur pour le format de fichier .netrc. Le fichier .netrc sert typiquement aux clients FTP à charger des informations d'authentification utilisateur avant d'envoyer une invite à l'utilisateur.

Le fichier Tools/scripts/ftpmirror.py dans la distribution du code source Python est un cript qui peut effectuer un miroir de sites FTP, ou de portions de sites, en utilisant le module ftplib. Il peut aussi servir d'exemple évolué de mise en ouvre de ce module.

Sous-sections

Objets FTP

11.5 ftplib --- Client pour le protocole FTP

11.5 `ftplib` --- Client pour le protocole FTP