Lines Matching refs:POP3
1 :mod:`poplib` --- POP3 protocol client
5 :synopsis: POP3 protocol client (requires sockets).
9 .. index:: pair: POP3; protocol
15 This module defines a class, :class:`POP3`, which encapsulates a connection to a
16 POP3 server and implements the protocol as defined in :rfc:`1725`. The
17 :class:`POP3` class supports both the minimal and optional command sets.
19 support for connecting to POP3 servers that use SSL as an underlying protocol
22 Note that POP3, though widely supported, is obsolescent. The implementation
23 quality of POP3 servers varies widely, and too many are quite poor. If your
30 .. class:: POP3(host[, port[, timeout]])
32 This class implements the actual POP3 protocol. The connection is created when
33 the instance is initialized. If *port* is omitted, the standard POP3 port (110)
44 This is a subclass of :class:`POP3` that connects to the server over an SSL
45 encrypted socket. If *port* is not specified, 995, the standard POP3-over-SSL
68 POP3 server variations and RFC noncompliance that may be useful if you need to
74 POP3 Objects
77 All POP3 commands are represented by methods of the same name, in lower-case;
80 An :class:`POP3` instance has the following methods:
83 .. method:: POP3.set_debuglevel(level)
92 .. method:: POP3.getwelcome()
94 Returns the greeting string sent by the POP3 server.
97 .. method:: POP3.user(username)
102 .. method:: POP3.pass_(password)
108 .. method:: POP3.apop(user, secret)
110 Use the more secure APOP authentication to log into the POP3 server.
113 .. method:: POP3.rpop(user)
115 Use RPOP authentication (similar to UNIX r-commands) to log into POP3 server.
118 .. method:: POP3.stat()
124 .. method:: POP3.list([which])
130 .. method:: POP3.retr(which)
136 .. method:: POP3.dele(which)
143 .. method:: POP3.rset()
148 .. method:: POP3.noop()
153 .. method:: POP3.quit()
158 .. method:: POP3.top(which, howmuch)
164 The POP3 TOP command this method uses, unlike the RETR command, doesn't set the
167 POP3 servers you will use before trusting it.
170 .. method:: POP3.uidl([which])
182 POP3 Example
190 M = poplib.POP3('localhost')