12.2.12 Differenze rispetto a mimelib

12.2.12 Differenze rispetto a `mimelib`

Il package email fu in origine prototipato come libreria separata chiamata mimelib. Le modifiche sono state effettuate in modo che i nomi dei metodi fossero più efficaci ed alcuni metodi e moduli sono stati aggiunti o eliminati. Di alcuni metodi è stata cambiata la semantica. Per la maggior parte, tutte le funzionalità disponibili in mimelib sono tuttora disponibili nel package email, sebbene spesso in maniera diversa. La compatibilità all'indietro tra i package mimelib ed email non era una priorità.

Ecco una breve descrizione delle differenze tra i package mimelib ed email insieme ad alcuni suggerimenti sul porting delle vostre applicazioni.

Ovviamente la differenza più evidente tra i due package è il cambio del nome del package stesso in email. In aggiunta abbiamo le seguenti differenze nella parte più alta del package:

messageFromString() è stato rinominato in message_from_string().
messageFromFile() è stato rinominato in message_from_file().

La classe Message presenta le seguenti differenze:

Il metodo asString() è stato rinominato in as_string().
Il metodo ismultipart() è stato rinominato in is_multipart().
Il metodo get_payload() ha acquistato un argomento decode facoltativo.
Il metodo getall() è stato rinominato in get_all().
Il metodo addheader() è stato rinominato in add_header().
il metodo gettype() è stato rinominato in get_type().
il metodo getmaintype() è stato rinominato in get_main_type().
il metodo getsubtype() è stato rinominato in get_subtype().
Il metodo getparams() è stato rinominato in get_params(). Inoltre laddove getparams() restituiva una lista di stringhe, get_params() restituisce una lista di 2 tuple, le coppie chiave/valore dei parametri senza il segno di "=".
Il metodo getparam() è stato rinominato in get_param().
Il metodo getcharsets() è stato rinominato in get_charsets().
Il metodo getfilename() è stato rinominato in get_filename().
Il metodo getboundary() è stato rinominato in get_boundary().
Il metodo setboundary() è stato rinominato in set_boundary().
Il metodo getdecodedpayload() è stato eliminato. Per ottenere una funzionalità simile occorre passare il valore 1 all'opzione decode del metodo get_payload().
Il metodo getpayloadastext() è stato eliminato. Una simile funzionalità viene fornita dalla classe DecodedGenerator nel modulo email.
Il metodo getbodyastext() è stato rimosso. Si può ottenere una funzionalità simile creando un iteratore con typed_subpart_iterator(), presente nel modulo email.Iterators.

La classe Parser non ha differenze nell'interfaccia pubblica. Sono state aggiunte alcune peculiarità per riconoscere lo stato di consegna del messaggio, che viene rappresentato come un'istanza di Message che contiene sotto parti separate di Message per ognuno dei blocchi di intestazione nella notifica dello stato di consegna^12.3.

La classe Generator non ha differenze nell'interfaccia pubblica. Abbiamo però una nuova classe nel modulo email.Generator, chiamata DecodedGenerator che fornisce la maggior parte delle funzionalità precedentemente disponibili nel metodo Message.getpayloadastext().

Sono stati modificati i seguenti moduli e classi:

La classe MIMEBase Gli argomenti del costruttore di classe MIMEBase, _major sono stati rispettivamente modificati in _maintype e _subtype.
La classe/modulo Image è stata/o rinominata/o MIMEImage. L'argomento _minor è stato rinominato _subtype.
La classe/modulo Text è stata/o rinominata/o MIMEText. L'argomento _minor è stato rinominato _subtype.
La classe/modulo MessageRFC822 è stata/o rinominata/o MIMEMessage. Notare che una precedente versione di mimelib chiamava questa classe/modulo RFC822, ma questa/o, in presenza di alcuni file system non sensibili alle differenze tra maiuscole e minuscole, interferiva con il modulo rfc822 della libreria standard di Python.
Inoltre la classe MIMEMessage adesso rappresenta tutti i tipi di messaggi MIME di tipo message. È necessario l'argomento facoltativo _subtype che si usa per impostare il sotto tipo MIME. Il valore _subtype è predefinito per rfc822.

mimelib forniva alcune utili funzioni nei moduli address e date. Tutte queste funzioni sono state spostate nel modulo email.Utils.

La classe/modulo MsgReader è stata/o eliminata/o. La funzionalità più simile viene supportata dalla funzione body_line_iterator() nel modulo email.Iterators.

Footnotes

... consegna ^12.3: Le ``Delivery Status Notifications,'' (DSN) (Notificazione dello Stato del Trasporto) vengono definite nella RFC 1894.

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