mhlib
— 访问 MH 邮箱
¶
Deprecated since version 2.6:
The
mhlib
module has been removed in Python 3. Use the
mailbox
代替。
The
mhlib
module provides a Python interface to MH folders and their contents.
The module contains three basic classes,
MH
, which represents a particular collection of folders,
Folder
, which represents a single folder, and
Message
, which represents a single message.
mhlib.
消息
(
folder
,
编号
[
,
名称
]
)
¶
Message
objects represent individual messages in a folder. The Message class is derived from
mimetools.Message
.
MH
实例具有下列方法：
MH.
error
(
format
[
,
...
]
)
¶
Print an error message – can be overridden.
MH.
getprofile
(
key
)
¶
Return a profile entry (
None
if not set).
MH.
getpath
(
)
¶
Return the mailbox pathname.
MH.
getcontext
(
)
¶
Return the current folder name.
MH.
setcontext
(
名称
)
¶
Set the current folder name.
MH.
listfolders
(
)
¶
Return a list of top-level folders.
MH.
listallfolders
(
)
¶
Return a list of all folders.
MH.
listsubfolders
(
名称
)
¶
Return a list of direct subfolders of the given folder.
MH.
listallsubfolders
(
名称
)
¶
Return a list of all subfolders of the given folder.
MH.
makefolder
(
名称
)
¶
Create a new folder.
MH.
deletefolder
(
名称
)
¶
Delete a folder – must have no subfolders.
MH.
openfolder
(
名称
)
¶
Return a new open folder object.
Folder
instances represent open folders and have the following methods:
Folder.
error
(
format
[
,
...
]
)
¶
Print an error message – can be overridden.
Folder.
getfullname
(
)
¶
Return the folder’s full pathname.
Folder.
getsequencesfilename
(
)
¶
Return the full pathname of the folder’s sequences file.
Folder.
getmessagefilename
(
n
)
¶
Return the full pathname of message n of the folder.
Folder.
listmessages
(
)
¶
Return a list of messages in the folder (as numbers).
Folder.
getcurrent
(
)
¶
Return the current message number.
Folder.
setcurrent
(
n
)
¶
Set the current message number to n .
Folder.
parsesequence
(
seq
)
¶
Parse msgs syntax into list of messages.
Folder.
getlast
(
)
¶
Get last message, or
0
if no messages are in the folder.
Folder.
setlast
(
n
)
¶
Set last message (internal use only).
Folder.
getsequences
(
)
¶
Return dictionary of sequences in folder. The sequence names are used as keys, and the values are the lists of message numbers in the sequences.
Folder.
putsequences
(
dict
)
¶
Return dictionary of sequences in folder name: list.
Folder.
removemessages
(
list
)
¶
Remove messages in list from folder.
Folder.
refilemessages
(
list
,
tofolder
)
¶
Move messages in list to other folder.
Folder.
movemessage
(
n
,
tofolder
,
ton
)
¶
Move one message to a given destination in another folder.
Folder.
copymessage
(
n
,
tofolder
,
ton
)
¶
Copy one message to a given destination in another folder.
The
Message
class adds one method to those of
mimetools.Message
:
Message.
openmessage
(
n
)
¶
Return a new open message object (costs a file descriptor).