³ò ™›\Kc@sydZddkZddkZdddgZdefd„ƒYZdZdZd Zd Z ee Z dfd „ƒYZ de fd „ƒYZ e d joÚddkZe eidƒZeiƒGHeieidƒeieidƒeiƒeiƒ\ZZx[ededƒD]FZeieƒ\ZZZdeGHxeD]ZdeGHqKWdGHqWeiƒndS(s@A POP3 client class. Based on the J. Myers POP3 draft, Jan. 96 iÿÿÿÿNtPOP3t error_prototPOP3_SSLcBseZRS((t__name__t __module__(((s/usr/lib/python2.5/poplib.pyRsiniãs s cBsõeZdZed„Zd„Zd„Zd„Zd„Zd„Z d„Z d„Z d „Z d „Z d „Zd „Zd „Zdd„Zd„Zd„Zd„Zd„Zd„Zd„ZeidƒZd„Zd„Zdd„ZRS(sÏThis 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) 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. c Cs||_||_d}d|_x­ti|i|idtiƒD]Š}|\}}}}} y,ti|||ƒ|_|ii| ƒWn?tij o0}|io|ii ƒnd|_qCnXPqCW|ipti|‚n|ii dƒ|_ d|_ |i ƒ|_dS(Ns!getaddrinfo returns an empty listitrb(thosttporttNonetsocktsockett getaddrinfot SOCK_STREAMtconnectterrortclosetmakefiletfilet _debuggingt_getresptwelcome( tselfRRtmsgtrestaftsocktypetprotot canonnametsa((s/usr/lib/python2.5/poplib.pyt__init__Os*   "    cCsA|idjodGt|ƒGHn|iid|tfƒdS(Nis*put*s%s%s(RtreprR tsendalltCRLF(Rtline((s/usr/lib/python2.5/poplib.pyt_putlinefscCs.|iodGt|ƒGHn|i|ƒdS(Ns*cmd*(RRR"(RR!((s/usr/lib/python2.5/poplib.pyt_putcmdms cCs¬|iiƒ}|idjodGt|ƒGHn|ptdƒ‚nt|ƒ}|dtjo|d |fSn|dtjo|dd!|fSn|d |fS(Nis*get*s-ERR EOFiþÿÿÿiiÿÿÿÿ(RtreadlineRRRtlenR tCR(RR!toctets((s/usr/lib/python2.5/poplib.pyt_getlinevs cCs`|iƒ\}}|idjodGt|ƒGHn|d }|djot|ƒ‚n|S(Nis*resp*t+(R(RRR(Rtresptotc((s/usr/lib/python2.5/poplib.pyRˆs  cCsž|iƒ}g}d}|iƒ\}}xd|djoV|d djo|d}|d}n||}|i|ƒ|iƒ\}}q-W|||fS(Nit.is..i(RR(tappend(RR*tlistR'R!R+((s/usr/lib/python2.5/poplib.pyt _getlongresp“s     cCs|i|ƒ|iƒS(N(R#R(RR!((s/usr/lib/python2.5/poplib.pyt _shortcmd£s cCs|i|ƒ|iƒS(N(R#R0(RR!((s/usr/lib/python2.5/poplib.pyt_longcmdªs cCs|iS(N(R(R((s/usr/lib/python2.5/poplib.pyt getwelcome±scCs ||_dS(N(R(Rtlevel((s/usr/lib/python2.5/poplib.pytset_debuglevelµscCs|id|ƒS(sVSend user name, return response (should indicate password required). sUSER %s(R1(Rtuser((s/usr/lib/python2.5/poplib.pyR6»scCs|id|ƒS(s Send password, return response (response includes message count, mailbox size). NB: mailbox is locked by server from here to 'quit()' sPASS %s(R1(Rtpswd((s/usr/lib/python2.5/poplib.pytpass_ÃscCsb|idƒ}|iƒ}|iodGt|ƒGHnt|dƒ}t|dƒ}||fS(s]Get mailbox status. Result is tuple of 2 ints (message count, mailbox size) tSTATs*stat*ii(R1tsplitRRtint(Rtretvaltretst numMessagest sizeMessages((s/usr/lib/python2.5/poplib.pytstatÍs  cCs/|dj o|id|ƒSn|idƒS(sRequest listing, return result. Result without a message number argument is in form ['response', ['mesg_num octets', ...], octets]. Result when a message number argument is given is a single response: the "scan listing" for that message. sLIST %stLISTN(RR1R2(Rtwhich((s/usr/lib/python2.5/poplib.pyR/Ús cCs|id|ƒS(soRetrieve whole message number 'which'. Result is in form ['response', ['line', ...], octets]. sRETR %s(R2(RRB((s/usr/lib/python2.5/poplib.pytretrèscCs|id|ƒS(sFDelete message number 'which'. Result is 'response'. sDELE %s(R1(RRB((s/usr/lib/python2.5/poplib.pytdeleðscCs |idƒS(sXDoes nothing. One supposes the response indicates the server is alive. tNOOP(R1(R((s/usr/lib/python2.5/poplib.pytnoopøscCs |idƒS(sNot sure what this does.tRSET(R1(R((s/usr/lib/python2.5/poplib.pytrsetscCs[y|idƒ}Wntj o}|}nX|iiƒ|iiƒ|`|`|S(sDSignoff: commit changes on server, unlock mailbox, close connection.tQUIT(R1RRRR (RR*tval((s/usr/lib/python2.5/poplib.pytquits    cCs|id|ƒS(sNot sure what this does.sRPOP %s(R1(RR6((s/usr/lib/python2.5/poplib.pytrpopss\+OK.*(<[^>]+>)cCsŒ|ii|iƒ}|ptdƒ‚nddk}|i|idƒ|ƒiƒ}dit d„|ƒƒ}|i d||fƒS(s Authorisation - only possible if server has supplied a timestamp in initial greeting. Args: user - mailbox user; secret - secret shared between client and server. NB: mailbox is locked by server from here to 'quit()' s!-ERR APOP not supported by serveriÿÿÿÿNitcSsdt|ƒS(s%02x(tord(tx((s/usr/lib/python2.5/poplib.pyt,ss APOP %s %s( t timestamptmatchRRthashlibtmd5tgrouptdigesttjointmapR1(RR6tsecrettmRSRV((s/usr/lib/python2.5/poplib.pytapops  "cCs|id||fƒS(s­Retrieve message header of message number 'which' and first 'howmuch' lines of message body. Result is in form ['response', ['line', ...], octets]. s TOP %s %s(R2(RRBthowmuch((s/usr/lib/python2.5/poplib.pyttop0scCs/|dj o|id|ƒSn|idƒS(sìReturn message digest (unique id) list. If 'which', result contains unique id for that message in the form 'response mesgnum uid', otherwise result is the list ['response', ['mesgnum uid', ...], octets] sUIDL %stUIDLN(RR1R2(RRB((s/usr/lib/python2.5/poplib.pytuidl9s N(RRt__doc__t POP3_PORTRR"R#R(RR0R1R2R3R5R6R8R@RR/RCRDRFRHRKRLtretcompileRQR[R]R_(((s/usr/lib/python2.5/poplib.pyR$s2(                  cBsDeZdZeddd„Zd„Zd„Zd„Zd„Z RS(s¦POP3 client class over SSL connection Instantiate with: POP3_SSL(hostname, port=995, keyfile=None, certfile=None) hostname - the hostname of the pop3 over ssl server port - port number keyfile - PEM formatted file that countains your private key certfile - PEM formatted certificate chain file See the methods of the parent class POP3 for more documentation. c CsX||_||_||_||_d|_d}d|_x­ti|i|idti ƒD]Š}|\}}} } } y,ti||| ƒ|_|ii | ƒWn?ti j o0}|io|ii ƒnd|_q^nXPq^W|ipti |‚n|ii dƒ|_ti|i|i|iƒ|_d|_|iƒ|_dS(NRMs!getaddrinfo returns an empty listiR(RRtkeyfiletcertfiletbufferRR R R R R RRRRtssltsslobjRRR( RRRRdReRRRRRRR((s/usr/lib/python2.5/poplib.pyRQs2      "   ! cCsE|iiƒ}t|ƒdjotdƒ‚n|i|7_dS(Nis-ERR EOF(RhtreadR%RRf(Rtlocalbuf((s/usr/lib/python2.5/poplib.pyt _fillBufferkscCsd}tidƒ}|i|iƒ}x(|p |iƒ|i|iƒ}q*W|idƒ}|id|idƒ|_|idjodGt|ƒGHnt |ƒ}|dt jo|d |fSn|dt jo|dd!|fSn|d |fS(NRMs.*?\niis*get*iþÿÿÿiÿÿÿÿ( RbRcRRRfRkRUtsubRRR%R R&(RR!t renewlineRRR'((s/usr/lib/python2.5/poplib.pyR(qs"  cCsŠ|idjodGt|ƒGHn|t7}t|ƒ}xJ|djo<|ii|ƒ}||joPn||}||}q<WdS(Nis*put*i(RRR R%Rhtwrite(RR!tbytestsent((s/usr/lib/python2.5/poplib.pyR"ƒs     cCsNy|idƒ}Wntj o}|}nX|iiƒ|`|`|S(sDSignoff: commit changes on server, unlock mailbox, close connection.RI(R1RR RRh(RR*RJ((s/usr/lib/python2.5/poplib.pyRKŽs   N( RRR`t POP3_SSL_PORTRRRkR(R"RK(((s/usr/lib/python2.5/poplib.pyRDs     t__main__iiis Message %d:s s-----------------------( R`RbR t__all__t ExceptionRRaRqR&tLFR RRRtsystargvtaR3R6R8R/R@tnumMsgst totalSizetrangetiRCtheaderRR'R!RK(((s/usr/lib/python2.5/poplib.pyss8  ÿ!U