11.7.1 Objets POP3
Toutes les commandes POP3 sont représentées par des méthodes du même nom, en minuscules; la plupart retournent le texte de réponse envoyé par le serveur.
Une instance de POP3 possède les méthodes suivantes:
getwelcome()
- Retourne la chaîne de bienvenue envoyée par le serveur POP3.
user(nomutilisateur)
- Envoie une commande utilisateur, la réponse doit indiquer qu'un mot de passe est requis.
pass_(motdepasse)
- Envoie un mot de passe, la réponse inclut le compteur de messages et la taille de la boîte aux lettres. Note: la boîte aux lettres sur le serveur est bloquée jusqu'à ce que quit() soit appelé.
apop(utilisateur, secret)
- Utilise l'authentification APOP, plus sûre, pour lancer la session avec le serveur POP3.
rpop(utilisateur)
- Utilise l'authentification RPOP (similaire aux r-commands UNIX) pour lancer la session avec le serveur POP3.
stat()
- Pour obtenir l'état de la boîte aux lettres. Le résultat est un tuple de deux entiers:
(compteur_messages, taille_boite).
list([lequel])
- Demande une liste de messages, le résultat est de la forme
(reponse, ['num_mesg octets', ...]). Si lequel est fourni, c'est le message à lister.
retr(lequel)
- Récupère tout le message numéro lequel. Le résultat est sous la forme
(reponse, ['ligne', ...], octets).
dele(lequel)
- Supprime le message numéro lequel.
rset()
- Enlève toutes les marques de suppression pour la boîte aux lettres.
noop()
- Ne fait rien. Peut servir pour maintenir la connexion.
quit()
- Fin de session: valide les changements, déverrouille la boîte aux lettres, abandonne la connexion.
top(lequel, combien)
- Récupère l'entête de message plus combien lignes du message après l'entête du message numéro lequel. Le résultat est de la forme
(reponse, ['ligne', ...], octets).
uidl([lequel])
- Retourne la liste des condensés de message (identifiant unique).
Si lequel est spécifié, le résultat contient l'identifiant unique pour ce message sous la forme
'reponse numesg uid, sinon le résultat est la liste (reponse, ['nummesg uid', ...], octets).
