+ lh 9Rt^RIt^RIt^RIt^RIt^RItRtRR.t!RR] 4t ^nt Rt Rt R t] ],tR t!R R4t]'d!R R ]4t]P'R 4]R8XEd]!]P*^,4t]!]P144]P3]P*^,4]P5]P*^,4]P74]P94wtt]!^]^,4FGt ]PC] 4wt"t#t$]!R] ,4]#Ft%]!R]%,4K ]!R4KI ]PM4R#R# ]dRtELii;i)z@A POP3 client class. Based on the J. Myers POP3 draft, Jan. 96 NTFPOP3 error_protoc]tRt^tRtR#)rN)__name__ __module__ __qualname____firstlineno____static_attributes__rlib/python3.14/poplib.pyrrsdr i  ica]tRt^3toRtRt]]P3Rlt Rt Rt Rt Rt RtR tR tR tR tR tRtRtRtR"RltRtRtRtRtRtRtRt]P@!R4t!Rt"Rt#R"Rlt$Rt%Rt&R"R lt'R!t(Vt)R#)#raThis class supports both the minimal and optional command sets. Arguments can be strings or integers (where appropriate) (e.g.: retr(1) and retr('1') both work equally well. Minimal Command Set: USER name user(name) PASS string pass_(string) STAT stat() LIST [msg] list(msg = None) RETR msg retr(msg) DELE msg dele(msg) NOOP noop() RSET rset() QUIT quit() Optional Commands (some servers support these): RPOP name rpop(name) APOP name digest apop(name, digest) TOP msg n top(msg, n) UIDL [msg] uidl(msg = None) CAPA capa() STLS stls() UTF8 utf8() Raises one exception: 'error_proto'. Instantiate with: POP3(hostname, port=110) NB: the POP protocol locks the mailbox from user authorization until QUIT, so be sure to get in, suck the messages, and quit, each time you access the mailbox. POP is a line-based protocol, which means large mail messages consume lots of python cycles reading them line-by-line. If it's available on your mail server, use IMAP4 instead, it doesn't suffer from the two problems above. zUTF-8cWnW nRVn\P!RWV4VP V4VnVP PR4Vn^Vn VP4Vn R#)Fzpoplib.connectrbN) hostport_tls_establishedsysaudit_create_socketsockmakefilefile _debugging_getrespwelcome)selfrrtimeouts&&&&r __init__ POP3.__init__bsa  % "D5''0 II&&t, }} r cVeV'g \R4h\P!VPVP3V4#)Nz0Non-blocking socket (timeout=0) is not supported) ValueErrorsocketcreate_connectionrr)rrs&&r rPOP3._create_socketms6  wOP P''DII(>HHr cVP^8d\R\V44\P!RW4VP P V\,4R#)z*put*zpoplib.putlineN)rprintreprrrrsendallCRLFrlines&&r _putline POP3._putliners@ ??Q gtDz : "D/ $+&r cVP'd\R\V44\WP4pVP V4R#)z*cmd*N)rr)r*bytesencodingr/r-s&&r _putcmd POP3._putcmdzs2 ???E'4:6T==) dr c~VPP\^,4p\V4\8d \ R4hVP ^8d\ R\V44V'g \ R4h\V4pVRR\8XdVRRV3#VR,\8XdV^RV3#VRRV3#)r(z line too longz*get*z-ERR EOFN:Nr(N) rreadline_MAXLINElenrrr)r*r,CR)rr.octetss& r _getline POP3._getlinesyy!!(Q,/ t9x o. . ??Q gtDz :;z22T 9 9f$ $ 8r>":v% %CRy&  r cVP4wrVP^8d\R\V44VP R4'g \ V4hV#)r(z*resp*+)r>rr)r* startswithr)rrespos& r r POP3._getrespsG--/ ??Q hT ;t$$d# # r cVP4p.p^pVP4wrEVR8wdWVPR4'dV^, pVR,pW5,pVPV4VP4wrEK]WV3#).s..r(NN)rr>rBappend)rrClistr=r.rDs& r _getlongrespPOP3._getlongrespsx}}A6--/dlu%%aCBxZF KK mmoGD!6!!r cDVPV4VP4#N)r4rr-s&&r _shortcmdPOP3._shortcmds T}}r cDVPV4VP4#rO)r4rLr-s&&r _longcmd POP3._longcmds T  ""r cVP#rO)rrs&r getwelcomePOP3.getwelcomes ||r cWnR#rO)r)rlevels&&r set_debuglevelPOP3.set_debuglevelsr c 2VPRV,4#)zFSend user name, return response (should indicate password required). zUSER %srPrusers&&r r` POP3.users ~~i$.//r c 2VPRV,4#)zSend password, return response (response includes message count, mailbox size). NB: mailbox is locked by server from here to 'quit()' zPASS %sr^)rpswds&&r pass_ POP3.pass_s~~i$.//r c LVPR4pVP4pVP'd\R\ V44\ V4^8d \ R4h\V^,4p\V^,4pW43# \d \ R4hi;i)zMGet mailbox status. Result is tuple of 2 ints (message count, mailbox size) STATz*stat*zInvalid STAT response formatz.Invalid STAT response data: non-numeric values) rPsplitrr)r*r;rintr#)rretvalrets numMessages sizeMessagess& r stat POP3.stats '||~ ???E(DJ7 t9q=<= = Pd1g,KtAw>)e"34 4}}V$$r c 2VPRV,4#)z_Retrieve whole message number 'which'. Result is in form ['response', ['line', ...], octets]. zRETR %srSrss&&r retr POP3.retrs }}Y.//r c 2VPRV,4#)z6Delete message number 'which'. Result is 'response'. zDELE %sr^rss&&r dele POP3.dele s ~~i%/00r c $VPR4#)zHDoes nothing. One supposes the response indicates the server is alive. NOOPr^rVs&r noop POP3.noops ~~f%%r c $VPR4#)z(Unmark all messages marked for deletion.RSETr^rVs&r rset POP3.rsets~~f%%r c HVPR4pVP4V#)zDSignoff: commit changes on server, unlock mailbox, close connection.QUIT)rPclose)rrCs& r quit POP3.quit s~~f%  r c VPpRVnVeVP4VPpRVnVe3VP\P 4VP4R#R# \ d=pTP\P8wd\TR^4R8wdhRp?LVRp?ii;i TP4i;i TPpRTnTeTP\P 4MJ \ d=pTP\P8wd\TR^4R8wdhRp?MRp?ii;iTP4i TP4i;ii;i)z8Close the connection without assuming anything about it.Nwinerrori&') rrrshutdownr$ SHUT_RDWROSErrorerrnoENOTCONNgetattr)rrrexcs& r r POP3.close&s) !99DDI 99DDI !MM&"2"23JJL  U^^3"3 A6%? JJL99DDI !MM&"2"23 U^^3"3 A6%? JJLDJJL sq'CA44 B;?2B61B>6B;;B>>CE=,D  E' E2E E'EE'E='E99E=c 2VPRV,4#)z?Send RPOP command to access the mailbox with an alternate user.zRPOP %sr^r_s&&r rpop POP3.rpopBs~~i$.//r s\+OK.[^<]*(<.*>)c D\W P4pVPPVP4pV'g \ R4h^RIpVP^4V,pVPV4P4pVPRV: RV: 24#)zAuthorisation - only possible if server has supplied a timestamp in initial greeting. Args: user - mailbox user; password - mailbox password. NB: mailbox is locked by server from here to 'quit()' z!-ERR APOP not supported by serverNzAPOP  ) r2r3 timestampmatchrrhashlibgroupmd5 hexdigestrP)rr`passwordsecretmrdigests&&& r apop POP3.apopIsyx/ NN  .AB BF"V$..0~~dF;<>)e"34 4}}V$$r c $VPR4#)zITry to enter UTF-8 mode (see RFC 6856). Returns server response. UTF8r^rVs&r utf8 POP3.utf8ss~~f%%r c Rp/pVPR4pV^,pVFpV!V4wrgWrV&K V# \d \R4hi;i)aReturn server capabilities (RFC 2449) as a dictionary >>> c=poplib.POP3('localhost') >>> c.capa() {'IMPLEMENTATION': ['Cyrus', 'POP3', 'server', 'v2.2.12'], 'TOP': [], 'LOGIN-DELAY': ['0'], 'AUTH-RESP-CODE': [], 'EXPIRE': ['NEVER'], 'USER': [], 'STLS': [], 'PIPELINING': [], 'UIDL': [], 'RESP-CODES': []} >>> Really, according to RFC 2449, the cyrus folks should avoid having the implementation split into multiple arguments... cdVPR4P4pV^,VR,3#)asciirI)decoderh)r.lsts& r _parsecapPOP3.capa.._parsecaps+++g&,,.Cq63r7? "r CAPAz!-ERR CAPA not supported by server)rSr)rrcapsrCrawcapscaplinecapnmcapargss& r capa POP3.capaysn # C==(D1gG"!*7!3%U #   CAB B Cs 1:Ac \'g \R4hVP'd \R4hVP4pRV9g \R4hVf\P !4pVP R4pVPVPVPR7VnVPPR4Vn RVnV#)zcStart a TLS session on the active connection as specified in RFC 2595. context - a ssl.SSLContext z-ERR TLS support missing$-ERR TLS session already establishedSTLSz!-ERR STLS not supported by serverserver_hostnamerT) HAVE_SSLrrrssl_create_stdlib_contextrP wrap_socketrrrr)rcontextrrCs&& r stls POP3.stlss x89 9  DE Eyy{~AB B ?002G~~f%'' 8< (C II&&t, $ r )rrrrrrrrO)*rrrr __doc__r3 POP3_PORTr$_GLOBAL_DEFAULT_TIMEOUTr rr/r4r>rrLrPrSrWr[r`rdrnrKrxr{rrrrrrecompilerrrrrrrr __classdictcell__ __classdict__s@r rr3s)VH"+77 'I '!* " # 00+0 %01&&  !80  /0I=*= %& :r c`a]tRtRtoRt]3R]PRR/RlltRt R Rlt R t Vt R#) POP3_SSLiaPOP3 client class over SSL connection Instantiate with: POP3_SSL(hostname, port=995, context=None) hostname - the hostname of the pop3 over ssl server port - port number context - a ssl.SSLContext See the methods of the parent class POP3 for more documentation. rrNcpVf\P!4pW@n\P WW#4R#rO)rrrrr )rrrrrs&&&$$r r POP3_SSL.__init__s(446"L MM$d 4r c~\PW4pVPPVVPR7pV#)r)rrrrr)rrrs&& r rPOP3_SSL._create_sockets:&&t5D<<++D<@II,GDKr c \R4h)zThe method unconditionally raises an exception since the STLS command doesn't make any sense on an already established SSL/TLS session. r)r)rrs&&r r POP3_SSL.stlss DE Er )rrO) rrrr r POP3_SSL_PORTr$rr rrr rrs@r rrs; '4 5 & > > 5HL 5   F Fr r__main__z Message %d:z z-----------------------)'rrrr$rrr ImportError__all__ Exceptionrrrr<LFr,r:rrrJrargvar)rWr`rdrKrnnumMsgs totalSizerangeirxheadermsgr=r.rrr r rsy H - #)"      "u vvr  F4F@ NN: z SXXa[A !,,.FF388A;GGCHHQKFFH668Wi 1gk " !q f ma D %$,  '( # FFHq HsE77 FF