11.12 smtplib -- Client per il protocollo SMTP

Il modulo smtplib definisce l'oggetto di una sessione smtp (lato Client) che pu essere usata per inviare mail ad ogni macchina internet con demone SMTP o ESMTP in ascolto. Per i dettagli delle operazioni SMTP o ESMPT, consultare l'RFC 821 (Simple Mail Transfer Protocol) e la RFC 1869 (SMTP Service Extensions).

class SMTP( [host[, port[, local_hostname]]])
Un'istanza SMTP che incapsula una connessione SMTP. Possiede metodi che supportano un gran repertorio di operazioni SMTP ed ESMTP. Se i parametri facoltativi host e port vengono indicati, il metodo SMTP connect() viene chiamato durante l'inizializzazione con questi parametri. Viene sollevata un'eccezione SMTPConnectError se l'host specificato non risponde correttamente.

Per un uso normale, vengono richiesti solamente i metodi di inizializzazione/connessione, sendmail() e quit(). Un esempio viene proposto di seguito.

Segue una selezione di eccezioni:

exception SMTPException
Classe dell'eccezione di base per tutte le eccezioni sollevate da questo modulo.

exception SMTPServerDisconnected
L'eccezione viene sollevata quando il server si disconnette in modo inaspettato, o quando viene fatto un tentativo di usare un'istanza SMTP prima che ci si connetta al server.

exception SMTPResponseException
Classe di base per tutte le eccezioni che includono un codice di errore SMTP. Queste eccezioni vengono generate in alcune istanze quando il server SMTP restituisce un codice di errore. Il codice di errore viene memorizzato nell'attributo dell'errore smtp_code, e l'attributo smtp_error viene impostato con il messaggio di errore.

exception SMTPSenderRefused
L'indirizzo del Sender (NdT: mittente) stato rifiutato. In aggiunta agli attributi impostati da tutte le eccezioni SMTPResponseException, questa imposta `sender' alla stringa che il server SMTP ha rifiutato.

exception SMTPRecipientsRefused
Tutti gli indirizzi dei destinatari sono stati rifiutati. Gli errori per ogni destinatario sono accessibili attraverso l'attributo recipients, che un dizionario esattamente dello stesso tipo di quello restituito da SMTP.sendmail().

exception SMTPDataError
Il server SMTP rifiuta di accettare il contenuto del messaggio.

exception SMTPConnectError
Un errore avviene durante l'attivazione di una connessione con il server.

exception SMTPHeloError
Il server rifiuta il nostro messaggio "HELO".

Vedete anche:

RFC 821, Simple Mail Transfer Protocol
Definizione del protocollo SMTP. Questo documento riguarda il modello, le procedure operative ed i dettagli del protocollo SMTP.
RFC 1869, SMTP Service Extensions
Definisce le estensioni ESMTP per l'SMTP. Questo descrive la struttura per estendere l'SMTP con nuovi comandi, supportando la scoperta dinamica dei comandi forniti dal server, e definisce una serie di comandi addizionali.



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