12.2.11 Differenze tra il modulo email v1 (fino a Python 2.2.1)

12.2.11 Differenze tra il modulo `email` v1 (fino a Python 2.2.1)

La versione 1 del package email era parte integrante delle distribuzioni Python fino a Python 2.2.1. La versione 2 fu sviluppata per la distribuzione Python 2.3 e resa compatibile per Python 2.2.2. Era disponibile anche come package separato, basato su distutils. La versione 2 di email è quasi per intero compatibile con la precedente versione 1, con le seguenti differenze:

Sono stati aggiunti i moduli email.Header e email.Charset.
È stato cambiato il formato di serializzazione per le istanze Message. Poiché tale formato non era mai stato (e non lo è ancora) formalmente definito, questa non viene considerata un'incompatibilità all'indietro. Ad ogni modo se l' applicazione in uso serializza e deserializza istanze di Message, fare attenzione che nella versione 2 di email le istanze di Message dispongono adesso delle variabili private _charset e _default_type.
Parecchi metodi nella classe Message sono stati deprecati o le loro sigle cambiate. Inoltre sono stati aggiunti parecchi nuovi metodi. Vedere la documentazione della classe Message per i dettagli. I cambiamenti dovrebbero essere interamente compatibili all'indietro.
È stata cambiata la struttura dell'oggetto per quanto riguarda i tipi di contenuto message/rfc822. Nella versione 1 di email un tipo di questo genere sarebbe stato rappresentato da un carico utile scalare, per esempio il contenitore di messaggi is_multipart() restituiva falso, get_payload() non era un oggetto lista, ma un'istanza singola di Message.
Questa struttura era estranea al resto del package, così la rappresentazione oggetto per i tipi di contenuto message/rfc822 è stata cambiata. Nella versione 2 di email il contenitore restituisce vero da is_multipart() e get_payload() restituisce una lista che contiene un singolo elemento Message.
Si può notare che in questo caso non si poteva ottenere una completa compatibilità all'indietro. Comunque se si sta già testando il tipo restituito da get_payload() non si dovrebbero avere problemi. Si avrà solamente bisogno di essere sicuri che il codice usato non esegua un set_payload() con un'istanza di Message o con un contenitore di tipi di contenuto message/rfc822.
È stato introdotto lo specifico argomento del costruttore Parser ed i suoi metodi parse() e parsestr() sono diventati semplicemente argomenti headersonly. Inoltre è stata aggiunta la specifica opzione strict alle funzioni email.message_from_file() e email.message_from_string().
Generator.__call__() è deprecato; usate invece Generator.flatten(). La classe Generator ha inoltre sviluppato il metodo clone().
È stata aggiunta la classe DecodedGenerator al modulo email.Generator.
Sono state aggiunte le classi base intermedie MIMENonMultipart, MIMEMultipart ed inserite nella gerarchia della classe per la maggior parte delle altre classi derivate che usano MIME.
Deprecato l'argomento _encoder per il costruttore MIMEText. Adesso la codifica si basa implicitamente sull'argomento _charset.
Vengono deprecate le seguenti funzioni nel modulo email.Utils: dump_address_pairs(), decode() ed encode(). Aggiunte al modulo le seguenti funzioni: make_msgid(), decode_rfc2231(), encode_rfc2231() e decode_params().
Aggiunta la funzione non pubblica email.Iterators._structure().

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