All POP3 commands are represented by methods of the same name, in lower-case; most return the response text sent by the server.
An POP3 instance has the following methods:
level) |
0
, produces no
debugging output. A value of 1
produces a moderate amount of
debugging output, generally a single line per request. A value of
2
or higher produces the maximum amount of debugging output,
logging each line sent and received on the control connection.
) |
username) |
password) |
user, secret) |
user) |
) |
(message count, mailbox size)
.
[which]) |
(response, ['mesg_num octets', ...], octets)
.
If which is set, it is the message to list.
which) |
(response, ['line', ...], octets)
.
which) |
) |
) |
) |
which, howmuch) |
(response, ['line', ...], octets)
.
The POP3 TOP command this method uses, unlike the RETR command, doesn't set the message's seen flag; unfortunately, TOP is poorly specified in the RFCs and is frequently broken in off-brand servers. Test this method by hand against the POP3 servers you will use before trusting it.
[which]) |
'response mesgnum uid
,
otherwise result is list (response, ['mesgnum uid', ...],
octets)
.
Instances of POP3_SSL have no additional methods. The interface of this subclass is identical to its parent.
See About this document... for information on suggesting changes.