![Previous Page](../icons/previous.png) |
![Up One Level](../icons/up.png) |
![Next Page](../icons/next.png) |
La libreria di riferimento di Python |
![Contents](../icons/contents.png) |
![Module Index](../icons/modules.png) |
![Index](../icons/index.png) |
11.9.1 Oggetti POP3
Tutti i comandi POP3 sono rappresentati da metodi con lo stesso nome,
in lettere minuscole; la maggior parte di questi, restituisce il testo
di risposta inviato dal server.
Un'instanza POP3 possiede i seguenti metodi:
-
Imposta il livello di debugging dell'istanza. Questo controlla la
quantità di informazioni di debug stampate. Il valore predefinito,
0
, non produce output di debug. Un valore 1
produce un
quantitativo moderato di informazioni di debug, generalmente una
singola riga per richiesta. Un valore di 2
o maggiore produce
il massimo quantitativo di informazioni di debugging, registrando ogni
riga inviata e ricevuta sulla connessione di controllo.
-
Restituisce la stringa di benvenuto inviata dal server POP3.
-
Invia il comando user, la riposta dovrebbe indicare che viene
richiesta la password.
-
Invia la password, e nella risposta c'è il numero di messaggi e la
dimensione della casella di posta. Notate: la mailbox sul server è
bloccata fino a quando non viene chiamato il metodo quit().
-
Utilizza il più sicuro metodo di autenticazione APOP per connettersi
al server POP3.
-
Usa l'autenticazione RPOP (simile agli r-command di Unix) per
connettersi al server POP3.
-
Ottiene lo stato della mailbox. Il risultato è una tupla di due
interi: (
(numero dei messaggi, dimensione della mailbox)
.
-
Richiede l'elenco dei messaggi, il cui risultato è nella forma
(risposta, ['messaggio_num ottale', ...])
. Se
which viene impostato, è il singolo messaggio da elencare.
-
Recupera l'intero messaggio con numero which, ed imposta
l'opzione visto (NdT: seen). Il risultato è nella forma
(risposta, ['riga', ...], ottale)
.
-
Imposta il messaggio con numero which per la cancellazione.
Sulla maggior parte dei server, la cancellazione non viene effettuata
fino all'esecuzione del comando QUIT (la più eclatante eccezione è il
QPOP di Eudora, che deliberatamente viola l'RFC facendo eseguire le
cancellazioni ad ogni disconnessione).
-
Rimuove ogni opzione di cancellazione dalla mailbox.
-
Non fa niente. Dovrebbe essere usata come keep-alive.
-
Signoff: salva i cambiamente, sblocca la mailbox, interrompe la
connessione.
-
Recupera l'intestazione del messaggio, più howmuch righe del
messaggio dopo l'intestazione del messaggio numerato which. Il
valore restituito è nella forma
(response, ['line', ...], octets)
.
Il comando POP3 TOP che questo metodo usa, diversamente dal comando
RETR, non imposta l'opzione seen del messaggio; sfortunatamente TOP è
scarsamente trattato nelle RFC e frequentemente non è funzionante nei
server non standard. È consigliabile verificare questo metodo sui
server che si vorranno usare prima di utilizzarlo.
-
Restituisce la lista dei messaggi in formato digest (id unico). Se
which viene specificato, il risultato contiene l'id univoco per
quel messaggio nella forma
'risposta mesgnum uid
, altrimenti il
risultato è la lista
(risposta, ['mesgnum uid', ...], ottetti)
.
Le istanze di POP3_SSL non hanno metodi aggiuntivi.
L'interfaccia di questa sotto classe è identica al suo oggetto padre.
![Previous Page](../icons/previous.png) |
![Up One Level](../icons/up.png) |
![Next Page](../icons/next.png) |
La libreria di riferimento di Python |
![Contents](../icons/contents.png) |
![Module Index](../icons/modules.png) |
![Index](../icons/index.png) |
Release 2.3.4, documentation updated on 21. maggio 2005.
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.