+ wi9csRt^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_protocs]tRt^tRtR#)rN)__name__ __module__ __qualname____firstlineno____static_attributes__r/usr/lib64/python3.14/poplib.pyrrsdris s icsa]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-8csWnW nRVn\P!RWV4VP V4VnVP PR4Vn^Vn VP4Vn R#)Fzpoplib.connectrbN) hostport_tls_establishedsysaudit_create_socketsockmakefilefile _debugging_getrespwelcome)selfr r timeouts&&&&r __init__Z POP3.__init__bsa  % "D5''0 II&&t, }} rcsVeV'g \R4h\P!VPVP3V4#)Nz0Non-blocking socket (timeout=0) is not supported) ValueErrorsocketZcreate_connectionr r )rr&&r rZPOP3._create_socketms6  wOP P''DII(>HHrcsVP^8d\R\V44\P!RW4VP P V\,4R#)z*put*zpoplib.putlineN)rprintreprrrrZsendallCRLFrlinerr _putlineZ POP3._putliners@ ??Q gtDz : "D/ $+&rcsVP'd\R\V44\WP4p\ P !RV4'd \R4hVPV4R#)z*cmd*s[-]z*Control characters not allowed in commandsN) rrrbytesencodingreZsearchrr#r!rr _putcmdZ POP3._putcmdzsP ???E'4:6T==) 99' . .IJ J drcs~VPP\^,4p\V4\8d \ R4hVP ^8d\ R\V44V'g \ R4h\V4pVRR\8XdVRRV3#VR,\8XdV^RV3#VRRV3#)rz line too longz*get*z-ERR EOFN:NrNii) rZreadline_MAXLINElenrrrrr CR)rr"octets& r _getlineZ POP3._getlinesyy!!(Q,/ t9x o. . ??Q gtDz :;z22T 9 9f$ $ 8r>":v% %CRy&  rcsVP4wrVP^8d\R\V44VP R4'g \ V4hV#)rz*resp*s+)r-rrr startswithr)rrespor,r rZ POP3._getrespsG--/ ??Q hT ;t$$d# # rcsVP4p.p^pVP4wrEVR8wdWVPR4'dV^, pVR,pW5,pVPV4VP4wrEK]WV3#)is.s..rNN)rr-r.append)rr/listr+r"r0s& r _getlongrespZPOP3._getlongrespsx}}A6--/dlu%%aCBxZF KK mmoGD!6!!rcDVPV4VP4#N)r'rr!rr _shortcmdZPOP3._shortcmds T}}rcr5r6)r'r4r!rr _longcmdZ POP3._longcmds T  ""rcsVP#r6)rr&r getwelcomeZPOP3.getwelcomes ||rcsWnR#r6)r)rZlevelrr set_debuglevelZPOP3.set_debuglevelsrc 2VPRV,4#)zFSend user name, return response (should indicate password required). zUSER %sr7ruserrr r@Z POP3.users ~~i$.//rc r=)zSend password, return response (response includes message count, mailbox size). NB: mailbox is locked by server from here to 'quit()' zPASS %sr>)rZpswdrr pass_Z POP3.pass_s~~i$.//rc sLVPR4pVP4pVP'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) ZSTATz*stat*zInvalid STAT response formatz.Invalid STAT response data: non-numeric values) r7splitrrrr)rZintr)rZretvalZretsZ numMessagesZ sizeMessagess& r statZ POP3.stats '||~ ???E(DJ7 t9q=<= = Pd1g,KtAw>)e"34 4}}V$$rc r=)z_Retrieve whole message number 'which'. Result is in form ['response', ['line', ...], octets]. zRETR %sr8rFrr retrZ POP3.retrs }}Y.//rc r=)z6Delete message number 'which'. Result is 'response'. zDELE %sr>rFrr deleZ POP3.dele s ~~i%/00rc $VPR4#)zHDoes nothing. One supposes the response indicates the server is alive. ZNOOPr>r9r:r noopZ POP3.noops ~~f%%rc rK)z(Unmark all messages marked for deletion.ZRSETr>r9r:r rsetZ POP3.rsets~~f%%rc sHVPR4pVP4V#)zDSignoff: commit changes on server, unlock mailbox, close connection.ZQUIT)r7close)rr/& r quitZ POP3.quit"s~~f%  rc sVPpRVnVeVP4VPpRVnVe3VP\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.NZwinerrori&') rrNrZshutdownrZ SHUT_RDWRZOSErrorerrnoZENOTCONNZgetattr)rrrZexcs& r rNZ 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 r=)z?Send RPOP command to access the mailbox with an alternate user.zRPOP %sr>r?rr rpopZ POP3.rpopDs~~i$.//rs\+OK.[^<]*(<.*>)c sD\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  ) r$r% timestampZmatchrrhashlibZgroupZmd5Z hexdigestr7)rr@ZpasswordZsecretZmrUZdigests&&& r apopZ POP3.apopKsyx/ NN  .AB BF"V$..0~~dF;<>)e"34 4}}V$$rc rK)zITry to enter UTF-8 mode (see RFC 6856). Returns server response. ZUTF8r>r9r:r utf8Z POP3.utf8us~~f%%rc sRp/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... csdVPR4P4pV^,VR,3#)Zasciir1)ZdecoderB)r"ZlstrOr _parsecapZPOP3.capa.._parsecaps+++g&,,.Cq63r7? "rZCAPAz!-ERR CAPA not supported by server)r8r)rrZcapsr/ZrawcapsZcaplineZcapnmZcapargss& r capaZ POP3.capa{sn # C==(D1gG"!*7!3%U #   CAB B Cs 1:Ac s\'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 establishedZSTLSz!-ERR STLS not supported by serverZserver_hostnamer T) HAVE_SSLrr r\ssl_create_stdlib_contextr7 wrap_socketrr rr)rcontextr[r/s&& r stlsZ POP3.stlss x89 9  DE Eyy{~AB B ?002G~~f%'' 8< (C II&&t, $ r)rr rr r rrr6)*rrrr__doc__r% POP3_PORTr_GLOBAL_DEFAULT_TIMEOUTrrr#r'r-rr4r7r8r;r<r@rArCr3rIrJrLrMrPrNrRr&ZcompilerTrVrWrXrYr\rdr__classdictcell__Z __classdict__@r rr3s)VH"+77 'I '!* " # 00+0 %01&&  !80  /0I=*= %& :rcs`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. rrcNcspVf\P!4pW@n\P WW#4R#r6)r`rarcrr)rr r rrcs&&&$$r rZPOP3_SSL.__init__s(446"L MM$d 4rcs~\PW4pVPPVVPR7pV#)r^)rrrcrbr )rrrs&& r rZPOP3_SSL._create_sockets:&&t5D<<++D<@II,GDKrc s\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)rrcrr rdZ POP3_SSL.stlss DE Er)rcr6) rrrrre POP3_SSL_PORTrrgrrrdrrhrirjr rkrks; '4 5 & > > 5HL 5   F FrrkZ__main__z Message %d:z z-----------------------)'rerQr&rrr`r_Z ImportErrorZ__all__Z Exceptionrrfrlr*ZLFr r(rrkr2rZargvZarr;r@rAr3rCZnumMsgsZ totalSizeZrangeZirIZheaderZmsgr+r"rPrrr rmsy H - #)"      "u xxv  F4F@ NN: z SXXa[A !,,.FF388A;GGCHHQKFFH668Wi 1gk " !q f ma D %$,  '( # FFHu HsE77 FF