18.5. mhlib-访问 MH 邮箱

自 2.6 版起已弃用：mhlib模块已在 Python 3 中删除。请改用mailbox。

mhlib模块为 MH 文件夹及其内容提供 Python 接口。

该模块包含三个基本类，MH代表文件夹的特定集合，Folder代表单个文件夹，Message代表单个消息。

- class * mhlib. MH([* path * [，* profile *]])
- MH代表 MH 文件夹的集合。
- class * mhlib. Folder(* mh ， name *)
- Folder类代表单个文件夹及其消息。
- class * mhlib. Message(* folder ， number * [，* name *])
- Message对象代表文件夹中的单个邮件。 Message 类是从mimetools.Message派生的。

18.5.1. MH 对象

MH个实例具有以下方法：

MH. error(* format * [，* ... *])
- 打印错误消息–可以覆盖。
MH. getprofile(* key *)
- 返回一个配置文件条目(如果未设置，则返回None)。
MH. getpath ( )
- 返回邮箱路径名。
MH. getcontext ( )
- 返回当前文件夹名称。
MH. setcontext(* name *)
- 设置当前文件夹名称。
MH. listfolders ( )
- 返回顶级文件夹的列表。
MH. listallfolders ( )
- 返回所有文件夹的列表。
MH. listsubfolders(* name *)
- 返回给定文件夹的直接子文件夹列表。
MH. listallsubfolders(* name *)
- 返回给定文件夹的所有子文件夹的列表。
MH. makefolder(* name *)
- 新建一个文件夹。
MH. deletefolder(* name *)
- 删除文件夹-必须没有子文件夹。
MH. openfolder(* name *)
- 返回一个新的打开文件夹对象。

18.5.2. 文件夹对象

Folder实例代表打开的文件夹，并具有以下方法：

Folder. error(* format * [，* ... *])
- 打印错误消息–可以覆盖。
Folder. getfullname ( )
- 返回文件夹的完整路径名。
Folder. getsequencesfilename ( )
- 返回文件夹的序列文件的完整路径名。
Folder. getmessagefilename(* n *)
- 返回文件夹的消息* n *的完整路径名。
Folder. listmessages ( )
- 返回文件夹中的消息列表(以数字形式)。
Folder. getcurrent ( )
- 返回当前消息号。
Folder. setcurrent(* n *)
- 将当前消息号设置为* n *。
Folder. parsesequence(* seq *)
- 将 msgs 语法解析为消息列表。
Folder. getlast ( )
- 获取最后一条消息；如果文件夹中没有消息，则返回0。
Folder. setlast(* n *)
- 设置最后一条消息(仅供内部使用)。
Folder. getsequences ( )
- 返回文件夹中序列的字典。序列名称用作键，值是序列中消息编号的列表。
Folder. putsequences(* dict *)
- 返回文件夹名称：list 中序列的字典。
Folder. removemessages(* list *)
- 从文件夹中删除列表中的邮件。
Folder. refilemessages(* list ， tofolder *)
- 将列表中的邮件移动到其他文件夹。
Folder. movemessage(* n ， tofolder ， ton *)
- 将一条消息移到另一个文件夹中的给定目的地。
Folder. copymessage(* n ， tofolder ， ton *)
- 将一条消息复制到另一个文件夹中的给定目标。

18.5.3. 讯息对象

Message类向mimetools.Message的方法添加一种方法：

Message. openmessage(* n *)
- 返回一个新的打开消息对象(花费一个文件 Descriptors)。