Maildir?

class mailbox.Maildir(dirname, factory=None, create=True)?

Mailbox 的一個(gè)子類(lèi)，用于 Maildir 格式的郵箱。 形參 factory 是一個(gè)可調用對象，它接受一個(gè)文件類(lèi)消息表示形式（其行為相當于以二進(jìn)制模式打開(kāi)）并返回一個(gè)自定義的表示形式。 如果 factory 為 None，則會(huì )使用 MaildirMessage 作為默認的消息表示形式。 如果 create 為 True，則當郵箱不存在時(shí)會(huì )創(chuàng )建它。

如果 create 為 True 且 dirname 路徑存在，它將被視為已有的 maildir 而無(wú)需嘗試驗證其目錄布局。

使用 dirname 這個(gè)名稱(chēng)而不使用 path 是出于歷史原因。

Maildir 是一種基于目錄的郵箱格式，它是針對 qmail 郵件傳輸代理而發(fā)明的，現在也得到了其他程序的廣泛支持。 Maildir 郵箱中的消息存儲在一個(gè)公共目錄結構中的單獨文件內。 這樣的設計允許 Maildir 郵箱被多個(gè)彼此無(wú)關(guān)的程序訪(fǎng)問(wèn)和修改而不會(huì )導致數據損壞，因此文件鎖定操作是不必要的。

Maildir 郵箱包含三個(gè)子目錄，分別是: tmp, new 和 cur。 消息會(huì )不時(shí)地在 tmp 子目錄中創(chuàng )建然后移至 new 子目錄來(lái)結束投遞。 后續電子郵件客戶(hù)端可能將消息移至 cur 子目錄并將有關(guān)消息狀態(tài)的信息存儲在附帶到其文件名的特殊 "info" 小節中。

Courier 電子郵件傳輸代理所引入的文件夾風(fēng)格也是受支持的。 主郵箱中任何子目錄只要其名稱(chēng)的第一個(gè)字符是 '.' 就會(huì )被視為文件夾。 文件夾名稱(chēng)會(huì )被 Maildir 表示為不帶前綴 '.' 的形式。 每個(gè)文件夾自身都是一個(gè) Maildir 郵箱但不應包含其他文件夾。 邏輯嵌套關(guān)系是使用 '.' 來(lái)劃定層級，例如 "Archived.2005.07"。

備注

Maildir 規范要求使用在特定消息文件名中使用冒號 (':')。 但是，某些操作系統不允許將此字符用于文件名，如果你希望在這些操作系統上使用類(lèi)似 Maildir 的格式，你應當指定改用另一個(gè)字符。 嘆號 ('!') 是一個(gè)受歡迎的選擇。 例如:

import mailbox
mailbox.Maildir.colon = '!'

colon 屬性也可以在每個(gè)實(shí)例上分別設置。

Maildir 實(shí)例具有 Mailbox 的所有方法及下列附加方法:

list_folders()?

返回所有文件夾名稱(chēng)的列表。

get_folder(folder)?

返回表示名稱(chēng)為 folder 的文件夾的 Maildir 實(shí)例。 如果文件夾不存在則會(huì )引發(fā) NoSuchMailboxError 異常。

add_folder(folder)?

創(chuàng )建名稱(chēng)為 folder 的文件夾并返回表示它的 Maildir 實(shí)例。

remove_folder(folder)?

刪除名稱(chēng)為 folder 的文件夾。 如果文件夾包含任何消息，則將引發(fā) NotEmptyError 異常且該文件夾將不會(huì )被刪除。

clean()?

從郵箱中刪除最近 36 小時(shí)內未被訪(fǎng)問(wèn)過(guò)的臨時(shí)文件。 Maildir 規范要求郵件閱讀程序應當時(shí)常進(jìn)行此操作。

Maildir 所實(shí)現的某些 Mailbox 方法值得進(jìn)行特別的說(shuō)明:

add(message)?

__setitem__(key, message)?

update(arg)?

警告

這些方法會(huì )基于當前進(jìn)程 ID 來(lái)生成唯一文件名。 當使用多線(xiàn)程時(shí)，可能發(fā)生未被檢測到的名稱(chēng)沖突并導致郵箱損壞，除非是對線(xiàn)程進(jìn)行協(xié)調以避免使用這些方法同時(shí)操作同一個(gè)郵箱。

flush()?

對 Maildir 郵箱的所有更改都會(huì )立即被應用，所以此方法并不會(huì )做任何事情。

lock()?

unlock()?

Maildir 郵箱不支持（或要求）鎖定操作，所以此方法并不會(huì )做任何事情。

close()?

Maildir 實(shí)例不保留任何打開(kāi)的文件并且下層的郵箱不支持鎖定操作，所以此方法不會(huì )做任何事情。

get_file(key)?

根據主機平臺的不同，當返回的文件保持打開(kāi)狀態(tài)時(shí)可能無(wú)法修改或移除下層的消息。

mbox?

class mailbox.mbox(path, factory=None, create=True)?

Mailbox 的子類(lèi)，用于 mbox 格式的郵箱。 形參 factory 是一個(gè)可調用對象，它接受一個(gè)文件類(lèi)消息表示形式（其行為相當于以二進(jìn)制模式打開(kāi)）并返回一個(gè)自定義的表示形式。 如果 factory 為 None，則會(huì )使用 mboxMessage 作為默認的消息表示形式。 如果 create 為 True，則當郵箱不存在時(shí)會(huì )創(chuàng )建它。

mbox 格式是在 Unix 系統上存儲電子郵件的經(jīng)典格式。 mbox 郵箱中的所有消息都存儲在一個(gè)單獨文件中，每條消息的開(kāi)頭由前五個(gè)字符為 "From " 的行來(lái)指明。

還有一些 mbox 格式變種對原始格式中發(fā)現的缺點(diǎn)做了改進(jìn)，mbox 只實(shí)現原始格式，有時(shí)被稱(chēng)為 mboxo。 這意味著(zhù)當存儲消息時(shí) Content-Length 標頭如果存在則會(huì )被忽略并且消息體中出現于行開(kāi)頭的任何 "From " 會(huì )被轉換為 ">From "，但是當讀取消息時(shí) ">From " 則不會(huì )被轉換為 "From "。

mbox 所實(shí)現的某些 Mailbox 方法值得進(jìn)行特別的說(shuō)明:

get_file(key)?

在 mbox 實(shí)例上調用 flush() 或 close() 之后再使用文件可能產(chǎn)生無(wú)法預料的結果或者引發(fā)異常。

lock()?

unlock()?

使用三種鎖機制 --- dot 鎖，以及可能情況下的 flock() 和 lockf() 系統調用。

MH?

class mailbox.MH(path, factory=None, create=True)?

Mailbox 的子類(lèi)，用于 MH 格式的郵箱。 形參 factory 是一個(gè)可調用對象，它接受一個(gè)文件類(lèi)消息表示形式（其行為相當于以二進(jìn)制模式打開(kāi)）并返回一個(gè)自定義的表示形式。 如果 factory 為 None，則會(huì )使用 MHMessage 作為默認的消息表示形式。 如果 create 為 True，則當郵箱不存在時(shí)會(huì )創(chuàng )建它。

MH 是一種基于目錄的郵箱格式，它是針對 MH Message Handling System 電子郵件用戶(hù)代理而發(fā)明的。 在 MH 郵箱的每條消息都放在單獨文件中。 MH 郵箱中除了郵件消息還可以包含其他 MH 郵箱 (稱(chēng)為 文件夾)。 文件夾可以無(wú)限嵌套。 MH 郵箱還支持 序列，這是一種命名列表，用來(lái)對消息進(jìn)行邏輯分組而不必將其移入子文件夾。 序列是在每個(gè)文件夾中名為 .mh_sequences 的文件內定義的。

MH 類(lèi)可以操作 MH 郵箱，但它并不試圖模擬 mh 的所有行為。 特別地，它并不會(huì )修改 context 或 .mh_profile 文件也不會(huì )受其影響，這兩個(gè)文件是 mh 用來(lái)存儲狀態(tài)和配置數據的。

MH 實(shí)例具有 Mailbox 的所有方法及下列附加方法:

list_folders()?

返回所有文件夾名稱(chēng)的列表。

get_folder(folder)?

返回表示名稱(chēng)為 folder 的文件夾的 MH 實(shí)例。 如果文件夾不存在則會(huì )引發(fā) NoSuchMailboxError 異常。

add_folder(folder)?

創(chuàng )建名稱(chēng)為 folder 的文件夾并返回表示它的 MH 實(shí)例。

remove_folder(folder)?

刪除名稱(chēng)為 folder 的文件夾。 如果文件夾包含任何消息，則將引發(fā) NotEmptyError 異常且該文件夾將不會(huì )被刪除。

get_sequences()?

返回映射到鍵列表的序列名稱(chēng)字典。 如果不存在任何序列，則返回空字典。

set_sequences(sequences)?

根據由映射到鍵列表的名稱(chēng)組成的字典 sequences 來(lái)重新定義郵箱中的序列，該字典與 get_sequences() 返回值的形式一樣。

pack()?

根據需要重命名郵箱中的消息以消除序號中的空缺。 序列列表中的條目會(huì )做相應的修改。

備注

已發(fā)送的鍵會(huì )因此操作而失效并且不應當被繼續使用。

MH 所實(shí)現的某些 Mailbox 方法值得進(jìn)行特別的說(shuō)明:

remove(key)?

__delitem__(key)?

discard(key)?

這些方法會(huì )立即刪除消息。 通過(guò)在名稱(chēng)前加綴一個(gè)冒號作為消息刪除標記的 MH 慣例不會(huì )被使用。

lock()?

unlock()?

使用三種鎖機制 --- dot 鎖，以及可能情況下下 flock() 和 lockf() 系統調用。 對于 MH 郵箱來(lái)說(shuō)，鎖定郵箱意味著(zhù)鎖定 .mh_sequences 文件，并且僅在執行會(huì )影響單獨消息文件的操作期間鎖定單獨消息文件。

get_file(key)?

根據主機平臺的不同，當返回的文件保持打開(kāi)狀態(tài)時(shí)可能無(wú)法移除下層的消息。

flush()?

對 MH 郵箱的所有更改都會(huì )立即被應用，所以此方法并不會(huì )做任何事情。

close()?

MH 實(shí)例不保留任何打開(kāi)的文件，所以此方法等價(jià)于 unlock()。

Babyl?

class mailbox.Babyl(path, factory=None, create=True)?

Mailbox 的子類(lèi)，用于 Babyl 格式的郵箱。 形參 factory 是一個(gè)可調用對象，它接受一個(gè)文件類(lèi)表示形式（其行為相當于以二進(jìn)制模式打開(kāi)）并返回一個(gè)自定義的表示形式。 如果 factory 為 None，則會(huì )使用 BabylMessage 作為默認的消息表示形式。 如果 create 為 True，則當郵箱不存在時(shí)會(huì )創(chuàng )建它。

Babyl 是 Rmail 電子郵箱用戶(hù)代理所使用單文件郵箱格式，包括在 Emacs 中。 每條消息的開(kāi)頭由一個(gè)包含 Control-Underscore ('\037') 和 Control-L ('\014') 這兩個(gè)字符的行來(lái)指明。 消息的結束由下一條消息的開(kāi)頭來(lái)指明，或者當為最后一條消息時(shí)則由一個(gè)包含 Control-Underscore ('\037') 字符的行來(lái)指明。

Babyl 郵箱中的消息帶有兩組標頭：原始標頭和所謂的可見(jiàn)標頭。 可見(jiàn)標頭通常為原始標頭經(jīng)過(guò)重格式化和刪減以更易讀的子集。 Babyl 郵箱中的每條消息都附帶了一個(gè) 標簽 列表，即記錄消息相關(guān)額外信息的短字符串，郵箱中所有的用戶(hù)定義標簽列表會(huì )存儲于 Babyl 的選項部分。

Babyl 實(shí)例具有 Mailbox 的所有方法及下列附加方法:

get_labels()?

返回郵箱中使用的所有用戶(hù)定義標簽名稱(chēng)的列表。

備注

郵箱中存在哪些標簽會(huì )通過(guò)檢查實(shí)際的消息而非查詢(xún) Babyl 選項部分的標簽列表，但 Babyl 選項部分會(huì )在郵箱被修改時(shí)更新。

Babyl 所實(shí)現的某些 Mailbox 方法使得進(jìn)行特別的說(shuō)明:

get_file(key)?

在 Babyl 郵箱中，消息的標頭并不是與消息體存儲在一起的。 要生成文件類(lèi)表示形式，標頭和消息體會(huì )被一起拷貝到一個(gè) io.BytesIO 實(shí)例中，它具有與文件相似的 API。 因此，文件類(lèi)對象實(shí)際上獨立于下層郵箱，但與字符串表達形式相比并不會(huì )更節省內存。

lock()?

unlock()?

使用三種鎖機制 --- dot 鎖，以及可能情況下的 flock() 和 lockf() 系統調用。

MMDF?

class mailbox.MMDF(path, factory=None, create=True)?

Mailbox 的子類(lèi)，用于 MMDF 格式的郵箱。 形參 factory 是一個(gè)可調用對象，它接受一個(gè)文件類(lèi)消息表示形式（其行為相當于以二進(jìn)制模式打開(kāi)）并返回一個(gè)自定義的表示形式。 如果 factory 為 None，則會(huì )使用 MMDFMessage 作為默認的消息表示形式。 如果 create 為 True，則當郵箱不存在時(shí)會(huì )創(chuàng )建它。

MMDF 是一種專(zhuān)用于電子郵件傳輸代理 Multichannel Memorandum Distribution Facility 的單文件郵箱格式。 每條消息使用與 mbox 消息相同的形式，但其前后各有包含四個(gè) Control-A ('\001') 字符的行。 與 mbox 格式一樣，每條消息的開(kāi)頭由一個(gè)前五個(gè)字符為 "From " 的行來(lái)指明，但當存儲消息時(shí)額外出現的 "From " 不會(huì )被轉換為 ">From " 因為附加的消息分隔符可防止將這些內容誤認為是后續消息的開(kāi)頭。

MMDF 所實(shí)現的某些 Mailbox 方法值得進(jìn)行特別的說(shuō)明:

get_file(key)?

在 MMDF 實(shí)例上調用 flush() 或 close() 之后再使用文件可能產(chǎn)生無(wú)法預料的結果或者引發(fā)異常。

lock()?

unlock()?

使用三種鎖機制 --- dot 鎖，以及可能情況下的 flock() 和 lockf() 系統調用。

MaildirMessage?

class mailbox.MaildirMessage(message=None)?

具有 Maildir 專(zhuān)屬行為的消息。 形參 message 的含義與 Message 構造器一致。

通常，郵件用戶(hù)代理應用程序會(huì )在用戶(hù)第一次打開(kāi)并關(guān)閉郵箱之后將 new 子目錄中的所有消息移至 cur 子目錄，將這些消息記錄為舊消息，無(wú)論它們是否真的已被閱讀。 cur 下的每條消息都有一個(gè) "info" 部分被添加到其文件名中以存儲有關(guān)其狀態(tài)的信息。 （某些郵件閱讀器還會(huì )把 "info" 部分也添加到 new 下的消息中。） "info" 部分可以采用兩種形式之一：它可能包含 "2," 后面跟一個(gè)經(jīng)標準化的旗標列表（例如 "2,FR"）或者它可能包含 "1," 后面跟所謂的實(shí)驗性信息。 Maildir 消息的標準旗標如下:

旗標	含意	說(shuō)明
D	草稿	正在撰寫(xiě)中
F	已標記	已被標記為重要
P	已檢視	轉發(fā)，重新發(fā)送或退回
R	已回復	回復給
S	已查看	已閱讀
T	已刪除	標記為可被刪除

MaildirMessage 實(shí)例提供以下方法：

get_subdir()?

返回 "new" (如果消息應當被存儲在 new 子目錄下) 或者 "cur" (如果消息應當被存儲在 cur 子目錄下)。

備注

消息通常會(huì )在其郵箱被訪(fǎng)問(wèn)后被從 new 移至 cur，無(wú)論該消息是否已被閱讀。 如果 msg.get_flags()`` 中的 "S" 為 ``True 則說(shuō)明消息 msg 已被閱讀。

set_subdir(subdir)?

設置消息應當被存儲到的子目錄。 形參 subdir 必須為 "new" 或 "cur"。

get_flags()?

返回一個(gè)指明當前所設旗標的字符串。 如果消息符合標準的 Maildir 格式，則結果為零或按字母順序各自出現一次的 'D', 'F', 'P', 'R', 'S' 和 'T' 的拼接。 如果未設任何旗標或者如果 "info" 包含實(shí)驗性語(yǔ)義則返回空字符串。

set_flags(flags)?

設置由 flags 所指定的旗標并重置所有其它旗標。

add_flag(flag)?

設置由 flag 所指明的旗標而不改變其他旗標。 要一次性添加一個(gè)以上的旗標，flag 可以為包含一個(gè)以上字符的字符串。 當前 "info" 會(huì )被覆蓋，無(wú)論它是否只包含實(shí)驗性信息而非旗標。

remove_flag(flag)?

重置由 flag 所指明的旗標而不改變其他旗標。 要一次性移除一個(gè)以上的旗標，flag 可以為包含一個(gè)以上字符的字符串。 如果 "info" 包含實(shí)驗性信息而非旗標，則當前的 "info" 不會(huì )被修改。

get_date()?

以表示 Unix 紀元秒數的浮點(diǎn)數形式返回消息的發(fā)送日期。

set_date(date)?

將消息的發(fā)送日期設為 date，一個(gè)表示 Unix 紀元秒數的浮點(diǎn)數。

get_info()?

返回一個(gè)包含消息的 "info" 的字符串。 這適用于訪(fǎng)問(wèn)和修改實(shí)驗性的 "info" (即不是由旗標組成的列表)。

set_info(info)?

將 "info" 設為 info，這應當是一個(gè)字符串。

當一個(gè) MaildirMessage 實(shí)例基于 mboxMessage 或 MMDFMessage 實(shí)例被創(chuàng )建時(shí)，將會(huì )忽略 Status 和 X-Status 標頭并進(jìn)行下列轉換:

當一個(gè) MaildirMessage 實(shí)例基于 MHMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)行下列轉換:

當一個(gè) MaildirMessage 實(shí)例基于 BabylMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)行下列轉換:

mboxMessage?

class mailbox.mboxMessage(message=None)?

具有 mbox 專(zhuān)屬行為的消息。 形參 message 的含義與 Message 構造器一致。

mbox 郵箱中的消息會(huì )一起存儲在單個(gè)文件中。 發(fā)件人的信封地址和發(fā)送時(shí)間通常存儲在指明每條消息的起始的以 "From " 打頭的行中，不過(guò)在 mbox 的各種實(shí)現之間此數據的確切格式具有相當大的差異。 指明消息狀態(tài)的各種旗標，例如是否已讀或標記為重要等等通常存儲在 Status 和 X-Status 標頭中。

傳統的 mbox 消息旗標如下:

旗標	含意	說(shuō)明
R	已閱讀	已閱讀
O	舊消息	之前已經(jīng)過(guò) MUA 檢測
D	已刪除	標記為可被刪除
F	已標記	已被標記為重要
A	已回復	回復給

"R" 和 "O" 旗標存儲在 Status 標頭中，而 "D", "F" 和 "A" 旗標存儲在 X-Status 標頭中。 旗標和標頭通常會(huì )按上述順序顯示。

mboxMessage 實(shí)例提供了下列方法:

get_from()?

返回一個(gè)表示在 mbox 郵箱中標記消息起始的 "From " 行的字符串。 開(kāi)頭的 "From " 和末尾的換行符會(huì )被去除。

set_from(from_, time_=None)?

將 "From " 行設為 from_，這應當被指定為不帶開(kāi)頭的 "From " 或末尾的換行符。 為方便起見(jiàn)，可以指定 time_ 并將經(jīng)過(guò)適當的格式化再添加到 from_。 如果指定了 time_，它應當是一個(gè) time.struct_time 實(shí)例，適合傳入 time.strftime() 的元組或者 True (以使用 time.gmtime())。

get_flags()?

返回一個(gè)指明當前所設旗標的字符串。 如果消息符合規范格式，則結果為零或各自出現一次的 'R', 'O', 'D', 'F' 和 'A' 按上述順序的拼接。

set_flags(flags)?

設置由 flags 所指明的旗標并重啟所有其他旗標。 形參 flags 應當為零或各自出現多次的 'R', 'O', 'D', 'F' 和 'A' 按任意順序的拼接。

add_flag(flag)?

設置由 flag 所指明的旗標而不改變其他旗標。 要一次性添加一個(gè)以上的旗標，flag 可以為包含一個(gè)以上字符的字符串。

remove_flag(flag)?

重置由 flag 所指明的旗標而不改變其他旗標。 要一次性移除一個(gè)以上的旗標，flag 可以為包含一個(gè)以上字符的字符串。

當一個(gè) mboxMessage 實(shí)例基于 MaildirMessage 實(shí)例被創(chuàng )建時(shí)，"From " 行會(huì )基于 MaildirMessage 實(shí)例的發(fā)送時(shí)間被生成，并進(jìn)行下列轉換:

當一個(gè) mboxMessage 實(shí)例基于 MHMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)行下列轉換:

當一個(gè) mboxMessage 實(shí)例基于 BabylMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)行下列轉換:

當一個(gè) Message 實(shí)例基于 MMDFMessage 實(shí)例被創(chuàng )建時(shí)，"From " 行會(huì )被拷貝并直接對應所有旗標。

MHMessage?

class mailbox.MHMessage(message=None)?

具有 MH 專(zhuān)屬行為的消息。 形參 message 的含義與 Message 構造器一致。

MH 消息不支持傳統意義上的標記或旗標，但它們支持序列，即對任意消息的邏輯分組。 某些郵件閱讀程序 (但不包括標準 mh 和 nmh) 以與其他格式使用旗標類(lèi)似的方式來(lái)使用序列，如下所示:

序列	說(shuō)明
unseen	未閱讀，但之前已經(jīng)過(guò) MUA 檢測
已回復	回復給
已標記	已被標記為重要

MHMessage 實(shí)例提供了下列方法:

get_sequences()?

返回一個(gè)包含此消息的序列的名稱(chēng)的列表。

set_sequences(sequences)?

設置包含此消息的序列的列表。

add_sequence(sequence)?

將 sequence 添加到包含此消息的序列的列表。

remove_sequence(sequence)?

將 sequence 從包含此消息的序列的列表中移除。

當一個(gè) MHMessage 實(shí)例基于 MaildirMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)行下列轉換:

當一個(gè) MHMessage 實(shí)例基于 mboxMessage 或 MMDFMessage 實(shí)例被創(chuàng )建時(shí)，將會(huì )忽略 Status 和 X-Status 標頭并進(jìn)行下列轉換:

當一個(gè) MHMessage 實(shí)例基于 BabylMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)入下列轉換:

BabylMessage?

class mailbox.BabylMessage(message=None)?

具有 Babyl 專(zhuān)屬行為的消息。 形參 message 的含義與 Message 構造器一致。

某些消息標簽被稱(chēng)為 屬性，根據慣例被定義為具有特殊的含義。 這些屬性如下所示:

標簽	說(shuō)明
unseen	未閱讀，但之前已經(jīng)過(guò) MUA 檢測
deleted	標記為可被刪除
filed	復制到另一個(gè)文件或郵箱
answered	回復給
forwarded	已轉發(fā)
edited	已被用戶(hù)修改
resent	已重發(fā)

默認情況下，Rmail 只顯示可見(jiàn)標頭。 不過(guò) BabylMessage 類(lèi)會(huì )使用原始標頭因為它們更完整。 如果需要可以顯式地訪(fǎng)問(wèn)可見(jiàn)標頭。

BabylMessage 實(shí)例提供了下列方法:

get_labels()?

返回郵件上的標簽列表。

set_labels(labels)?

將消息上的標簽列表設置為 labels 。

add_label(label)?

將 label 添加到消息上的標簽列表中。

remove_label(label)?

從消息上的標簽列表中刪除 label 。

get_visible()?

返回一個(gè) Message 實(shí)例，其標頭為消息的可見(jiàn)標頭而其消息體為空。

set_visible(visible)?

將消息的可見(jiàn)標頭設為與 message 中的標頭一致。 形參 visible 應當是一個(gè) Message 實(shí)例，email.message.Message 實(shí)例，字符串或文件類(lèi)對象（且應當以文本模式打開(kāi)）。

update_visible()?

當一個(gè) BabylMessage 實(shí)例的原始標頭被修改時(shí)，可見(jiàn)標頭不會(huì )自動(dòng)進(jìn)行對應修改。 此方法將按以下方式更新可見(jiàn)標頭：每個(gè)具有對應原始標頭的可見(jiàn)標頭會(huì )被設為原始標頭的值，每個(gè)沒(méi)有對應原始標頭的可見(jiàn)標頭會(huì )被移除，而任何存在于原始標頭但不存在于可見(jiàn)標頭中的 Date, From, Reply-To, To, CC 和 Subject 會(huì )被添加至可見(jiàn)標頭。

當一個(gè) BabylMessage 實(shí)例基于 MaildirMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)行下列轉換:

當一個(gè) BabylMessage 實(shí)例基于 mboxMessage 或 MMDFMessage 實(shí)例被創(chuàng )建時(shí)，將會(huì )忽略 Status 和 X-Status 標頭并進(jìn)入下列轉換:

當一個(gè) BabylMessage 實(shí)例基于 MHMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)入下列轉換:

MMDFMessage?

class mailbox.MMDFMessage(message=None)?

具有 MMDF 專(zhuān)屬行為的消息。 形參 message 的含義與 Message 構造器一致。

與 mbox 郵箱中的消息類(lèi)似，MMDF 消息會(huì )與將發(fā)件人的地址和發(fā)送日期作為以 "From " 打頭的初始行一起存儲。 同樣地，指明消息狀態(tài)的旗標通常存儲在 Status 和 X-Status 標頭中。

傳統的 MMDF 消息旗標與 mbox 消息的類(lèi)似，如下所示:

旗標	含意	說(shuō)明
R	已閱讀	已閱讀
O	舊消息	之前已經(jīng)過(guò) MUA 檢測
D	已刪除	標記為可被刪除
F	已標記	已被標記為重要
A	已回復	回復給

"R" 和 "O" 旗標存儲在 Status 標頭中，而 "D", "F" 和 "A" 旗標存儲在 X-Status 標頭中。 旗標和標頭通常會(huì )按上述順序顯示。

MMDFMessage 實(shí)例提供了下列方法，與 mboxMessage 所提供的類(lèi)似:

get_from()?

返回一個(gè)表示在 mbox 郵箱中標記消息起始的 "From " 行的字符串。 開(kāi)頭的 "From " 和末尾的換行符會(huì )被去除。

set_from(from_, time_=None)?

將 "From " 行設為 from_，這應當被指定為不帶開(kāi)頭的 "From " 或末尾的換行符。 為方便起見(jiàn)，可以指定 time_ 并將經(jīng)過(guò)適當的格式化再添加到 from_。 如果指定了 time_，它應當是一個(gè) time.struct_time 實(shí)例，適合傳入 time.strftime() 的元組或者 True (以使用 time.gmtime())。

get_flags()?

返回一個(gè)指明當前所設旗標的字符串。 如果消息符合規范格式，則結果為零或各自出現一次的 'R', 'O', 'D', 'F' 和 'A' 按上述順序的拼接。

set_flags(flags)?

設置由 flags 所指明的旗標并重啟所有其他旗標。 形參 flags 應當為零或各自出現多次的 'R', 'O', 'D', 'F' 和 'A' 按任意順序的拼接。

add_flag(flag)?

設置由 flag 所指明的旗標而不改變其他旗標。 要一次性添加一個(gè)以上的旗標，flag 可以為包含一個(gè)以上字符的字符串。

remove_flag(flag)?

重置由 flag 所指明的旗標而不改變其他旗標。 要一次性移除一個(gè)以上的旗標，flag 可以為包含一個(gè)以上字符的字符串。

當一個(gè) MMDFMessage 實(shí)例基于 MaildirMessage 實(shí)例被創(chuàng )建時(shí)，"From " 行會(huì )基于 MaildirMessage 實(shí)例的發(fā)送日期被生成，并進(jìn)入下列轉換:

當一個(gè) MMDFMessage 實(shí)例基于 MHMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)行下列轉換:

當一個(gè) MMDFMessage 實(shí)例基于 BabylMessage 實(shí)例被創(chuàng )建時(shí)，將進(jìn)行下列轉換:

當一個(gè) MMDFMessage 實(shí)例基于 mboxMessage 實(shí)例被創(chuàng )建時(shí)，"From " 行會(huì )被拷貝并直接對應所有旗標: