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.