Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(89532)

Side by Side Diff: Doc/library/poplib.rst

Issue 21804: Implement thr UTF8 command (RFC 6856) in poplib.
Patch Set: Created 5 years, 1 month ago
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
View unified diff | Download patch
« no previous file with comments | « no previous file | Lib/poplib.py » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 :mod:`poplib` --- POP3 protocol client 1 :mod:`poplib` --- POP3 protocol client
2 ====================================== 2 ======================================
3 3
4 .. module:: poplib 4 .. module:: poplib
5 :synopsis: POP3 protocol client (requires sockets). 5 :synopsis: POP3 protocol client (requires sockets).
6 .. sectionauthor:: Andrew T. Csillag 6 .. sectionauthor:: Andrew T. Csillag
7 .. revised by ESR, January 2000 7 .. revised by ESR, January 2000
8 8
9 .. index:: pair: POP3; protocol 9 .. index:: pair: POP3; protocol
10 10
(...skipping 175 matching lines...) Expand 10 before | Expand all | Expand 10 after
186 message's seen flag; unfortunately, TOP is poorly specified in the RFCs and i s 186 message's seen flag; unfortunately, TOP is poorly specified in the RFCs and i s
187 frequently broken in off-brand servers. Test this method by hand against the 187 frequently broken in off-brand servers. Test this method by hand against the
188 POP3 servers you will use before trusting it. 188 POP3 servers you will use before trusting it.
189 189
190 190
191 .. method:: POP3.uidl(which=None) 191 .. method:: POP3.uidl(which=None)
192 192
193 Return message digest (unique id) list. If *which* is specified, result conta ins 193 Return message digest (unique id) list. If *which* is specified, result conta ins
194 the unique id for that message in the form ``'response mesgnum uid``, otherwi se 194 the unique id for that message in the form ``'response mesgnum uid``, otherwi se
195 result is list ``(response, ['mesgnum uid', ...], octets)``. 195 result is list ``(response, ['mesgnum uid', ...], octets)``.
196
197
198 .. method:: POP3.utf8()
199
200 Try to switch to UTF-8 mode. Returns the server response if sucessful,
201 raises :class:`error_proto` if not. Specified in :RFC:`6856`.
202
203 .. versionadded:: 3.5
204
196 205
197 .. method:: POP3.stls(context=None) 206 .. method:: POP3.stls(context=None)
198 207
199 Start a TLS session on the active connection as specified in :rfc:`2595`. 208 Start a TLS session on the active connection as specified in :rfc:`2595`.
200 This is only allowed before user authentication 209 This is only allowed before user authentication
201 210
202 *context* parameter is a :class:`ssl.SSLContext` object which allows 211 *context* parameter is a :class:`ssl.SSLContext` object which allows
203 bundling SSL configuration options, certificates and private keys into 212 bundling SSL configuration options, certificates and private keys into
204 a single (potentially long-lived) structure. Please read :ref:`ssl-security` 213 a single (potentially long-lived) structure. Please read :ref:`ssl-security`
205 for best practices. 214 for best practices.
(...skipping 23 matching lines...) Expand all
229 M.user(getpass.getuser()) 238 M.user(getpass.getuser())
230 M.pass_(getpass.getpass()) 239 M.pass_(getpass.getpass())
231 numMessages = len(M.list()[1]) 240 numMessages = len(M.list()[1])
232 for i in range(numMessages): 241 for i in range(numMessages):
233 for j in M.retr(i+1)[1]: 242 for j in M.retr(i+1)[1]:
234 print(j) 243 print(j)
235 244
236 At the end of the module, there is a test section that contains a more extensive 245 At the end of the module, there is a test section that contains a more extensive
237 example of usage. 246 example of usage.
238 247
OLDNEW
« no previous file with comments | « no previous file | Lib/poplib.py » ('j') | no next file with comments »

RSS Feeds Recent Issues | This issue
This is Rietveld 894c83f36cb7+