- H ?csdZdkZdkZddgZdefdYZdZdZdZeeZ  dfdYZ Ae d jo Bdk Z Ce e i d ZDeiGHEeie i d Feie i d GeiHei\ZZIxued ed DI]]ZJeie\ZZZKd Ge GdGHLxeDL]ZMdeGHqmWNdGHq.WOeindS(s@A POP3 client class. Based on the J. Myers POP3 draft, Jan. 96 NsPOP3s error_protocsRS(N((((s#/mit/python/lib/python2.2/poplib.pys error_protosins s cs= dZHKedZbdZidZrdZdZdZdZdZ d Z d Z d Z d Z d ZedZdZdZdZdZdZdZeidZdZ,dZ5edZRS(sThis 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 s_KL||_M||_Nd}Ot|_Pxti|i|idtiDP]}Q|\}}}}} Ry2Sti||||_T|ii| WnNUtij o<}V|ioW|iinXt|_YqUnXZPqUW[|i o\ti|n]|iid|_^d|__|i|_dS(Ns!getaddrinfo returns an empty listisrb(shostsselfsportsmsgsNonessockssockets getaddrinfos SOCK_STREAMsressafssocktypesprotos canonnamessasconnectserrorsclosesmakefilesfiles _debuggings_getrespswelcome( sselfshostsportsafs canonnamesprotosmsgsresssocktypessa((s#/mit/python/lib/python2.2/poplib.pys__init__Ks*    %     csHbc|idjocdG| GHnd|iid|tfdS(Nis*put*s%s%s(sselfs _debuggingslinessockssendsCRLF(sselfsline((s#/mit/python/lib/python2.2/poplib.pys_putlinebscs5ij|iojdG| GHnk|i|dS(Ns*cmd*(sselfs _debuggingslines_putline(sselfsline((s#/mit/python/lib/python2.2/poplib.pys_putcmdis csrs|ii}t|idjotdG| GHnu| outdnvt|}z|dtjo{|d |fSn||dt jo}|dd!|fSn~|d |fSdS(Nis*get*s-ERR EOFiii( sselfsfilesreadlineslines _debuggings error_protoslensoctetssCRLFsCR(sselfsoctetssline((s#/mit/python/lib/python2.2/poplib.pys_getliners csw|i\}}|idjodG| GHn|d }|djot|n|SdS(Nis*resp*s+(sselfs_getlinesrespsos _debuggingscs error_proto(sselfscsrespso((s#/mit/python/lib/python2.2/poplib.pys_getresps cs|i}g}d}|i\}}xy|djoh|d djo|d}|d}n||}|i||i\}}q<W|||fSdS(Nis.is..i( sselfs_getrespsrespslistsoctetss_getlineslinesosappend(sselfsrespsoctetsslineslistso((s#/mit/python/lib/python2.2/poplib.pys _getlongresps  cs$|i||iSdS(N(sselfs_putcmdslines_getresp(sselfsline((s#/mit/python/lib/python2.2/poplib.pys _shortcmdscs$|i||iSdS(N(sselfs_putcmdslines _getlongresp(sselfsline((s#/mit/python/lib/python2.2/poplib.pys_longcmdscs|iSdS(N(sselfswelcome(sself((s#/mit/python/lib/python2.2/poplib.pys getwelcomescs||_dS(N(slevelsselfs _debugging(sselfslevel((s#/mit/python/lib/python2.2/poplib.pysset_debuglevelscs|id|SdS(sVSend user name, return response (should indicate password required). sUSER %sN(sselfs _shortcmdsuser(sselfsuser((s#/mit/python/lib/python2.2/poplib.pysuserscs|id|SdS(sSend password, return response (response includes message count, mailbox size). NB: mailbox is locked by server from here to 'quit()' sPASS %sN(sselfs _shortcmdspswd(sselfspswd((s#/mit/python/lib/python2.2/poplib.pyspass_scs||id}|i}|iodG| GHnt|d}t|d}||fSdS(s]Get mailbox status. Result is tuple of 2 ints (message count, mailbox size) sSTATs*stat*iiN( sselfs _shortcmdsretvalssplitsretss _debuggingsints numMessagess sizeMessages(sselfsretss sizeMessagessretvals numMessages((s#/mit/python/lib/python2.2/poplib.pysstats cs<|o|id|Sn|idSdS(sRequest listing, return result. Result without a message number argument is in form ['response', ['mesg_num octets', ...]]. Result when a message number argument is given is a single response: the "scan listing" for that message. sLIST %ssLISTN(swhichsselfs _shortcmds_longcmd(sselfswhich((s#/mit/python/lib/python2.2/poplib.pyslists cs|id|SdS(soRetrieve whole message number 'which'. Result is in form ['response', ['line', ...], octets]. sRETR %sN(sselfs_longcmdswhich(sselfswhich((s#/mit/python/lib/python2.2/poplib.pysretrscs|id|SdS(sFDelete message number 'which'. Result is 'response'. sDELE %sN(sselfs _shortcmdswhich(sselfswhich((s#/mit/python/lib/python2.2/poplib.pysdelescs|idSdS(sXDoes nothing. One supposes the response indicates the server is alive. sNOOPN(sselfs _shortcmd(sself((s#/mit/python/lib/python2.2/poplib.pysnoopscs|idSdS(sNot sure what this does.sRSETN(sselfs _shortcmd(sself((s#/mit/python/lib/python2.2/poplib.pysrsetscs}y|id}Wn!tj o}|}nX|ii|ii |`|` |SdS(sDSignoff: commit changes on server, unlock mailbox, close connection.sQUITN(sselfs _shortcmdsresps error_protosvalsfilesclosessock(sselfsrespsval((s#/mit/python/lib/python2.2/poplib.pysquitscs|id|SdS(sNot sure what this does.sRPOP %sN(sselfs _shortcmdsuser(sselfsuser((s#/mit/python/lib/python2.2/poplib.pysrpopss\+OK.*(<[^>]+>)cs"#|ii|i}$| o%tdn&dk}'|i|id|i }(di t d|})|i d||fSdS(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 serverNiscs(dt|S(Ns%02x(sordsx(sx((s#/mit/python/lib/python2.2/poplib.pys(ss APOP %s %s(sselfs timestampsmatchswelcomesms error_protosmd5snewsgroupssecretsdigestsjoinsmaps _shortcmdsuser(sselfsuserssecretsmsdigestsmd5((s#/mit/python/lib/python2.2/poplib.pysapops   %cs$,12|id||fSdS(sRetrieve message header of message number 'which' and first 'howmuch' lines of message body. Result is in form ['response', ['line', ...], octets]. s TOP %s %sN(sselfs_longcmdswhichshowmuch(sselfswhichshowmuch((s#/mit/python/lib/python2.2/poplib.pystop,scs<5;<|o=|id|Sn>|idSdS(sReturn 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 %ssUIDLN(swhichsselfs _shortcmds_longcmd(sselfswhich((s#/mit/python/lib/python2.2/poplib.pysuidl5s (s__doc__s POP3_PORTs__init__s_putlines_putcmds_getlines_getresps _getlongresps _shortcmds_longcmds getwelcomesset_debuglevelsuserspass_sstatsNoneslistsretrsdelesnoopsrsetsquitsrpopsrescompiles timestampsapopstopsuidl(((s#/mit/python/lib/python2.2/poplib.pysPOP3 s2 (                 s__main__iiisMessage s:s s-----------------------(s__doc__sressockets__all__s Exceptions error_protos POP3_PORTsCRsLFsCRLFsPOP3s__name__ssyssargvsas getwelcomesuserspass_slistsstatsnumMsgss totalSizesrangesisretrsheadersmsgsoctetsslinesquit(sLFssysssockets error_protos POP3_PORTs totalSizesisheadersoctetssPOP3sresCRLFsasmsgsCRslinesnumMsgss__all__((s#/mit/python/lib/python2.2/poplib.pys?s4     "