mhlib

自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。

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)

返回一个新的打开文件夹对象。

2.文件夹对象

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

Folder.error(format[, ...])

打印错误消息 - 可以被覆盖。

Folder.getfullname()

返回文件夹的完整路径名。

Folder.getsequencesfilename()

返回文件夹序列文件的完整路径名。

Folder.getmessagefilename(n)

返回文件夹的消息n的完整路径名。

Folder.listmessages()

返回文件夹中的消息列表（以数字形式）。

Folder.getcurrent()

返回当前的消息号码。

Folder.setcurrent(n)

将当前消息编号设置为n。

Folder.parsesequence(seq)

将消息解析成消息列表。

Folder.getlast()

获取最后一条消息，或者0文件夹中没有消息。

Folder.setlast(n)

设置最后一条消息（仅限内部使用）。

Folder.getsequences()

返回文件夹中序列的字典。序列名称用作关键字，值是序列中消息编号的列表。

Folder.putsequences(dict)

返回文件夹名称列表中的序列字典。

Folder.removemessages(list)

从文件夹中删除列表中的消息。

Folder.refilemessages(list, tofolder)

将列表中的邮件移至其他文件夹。

Folder.movemessage(n, tofolder, ton)

将一条消息移到另一个文件夹中的给定目的地。

Folder.copymessage(n, tofolder, ton)

将一封邮件复制到另一个文件夹中的给定目的地。

3.消息对象

该Message课程增加了一种方法mimetools.Message：

Message.openmessage(n)

返回一个新的打开的消息对象（花费一个文件描述符）。