- H ?csVdZdkZdkZddgZdefdYZdZdZdZeeZ dfdYZ e d jodk Z e e i d ZeiGHeie i d eie i d eiei\ZZx`ed ed D]KZeie\ZZZd Ge GdGHxeD]ZdeGHq(WdGHqWeindS(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 csdZedZdZdZdZdZdZdZdZ d Z d Z d Z d Z d ZedZdZdZdZdZdZdZeidZdZdZedZRS(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||_||_d}t|_xti|i|idtiD]}|\}}}}} y,ti||||_|ii| Wn?tij o0}|io|iint|_qCnXPqCW|i oti|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*   "    cs<|idjodG| GHn|iid|tfdS(Nis*put*s%s%s(sselfs _debuggingslinessockssendsCRLF(sselfsline((s#/mit/python/lib/python2.2/poplib.pys_putlinebscs)|iodG| GHn|i|dS(Ns*cmd*(sselfs _debuggingslines_putline(sselfsline((s#/mit/python/lib/python2.2/poplib.pys_putcmdis cs|ii}|idjodG| GHn| otdnt|}|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 cs_|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\}}xd|djoV|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 _shortcmds cs|i||iSdS(N(sselfs_putcmdslines _getlongresp(sselfsline((s#/mit/python/lib/python2.2/poplib.pys_longcmds cs |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_scsa|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.pyslistscs|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}Wntj 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.pysquits    cs|id|SdS(sNot sure what this does.sRPOP %sN(sselfs _shortcmdsuser(sselfsuser((s#/mit/python/lib/python2.2/poplib.pysrpopss\+OK.*(<[^>]+>)cs|ii|i}| otdndk}|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 serverNiscsdt|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|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-|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   "