N u9csdZ dZ dZdZkZkZkZdefdYZdZ dZ dZ e e Z !d fd YZ 0ed jo1e eZ2eiGH3eie4eie5ei6ei\ZZ7xyed ed d 7r_Z8eie\ZZZ9dGe GdGH:xed :rZ;deGHq\W<dGHqW=eindS(sA POP3 client class. Based on the J. Myers POP3 draft, Jan. 96 Author: David Ascher [heavily stealing from nntplib.py] Updated: Piers Lauder [Jul '97] s localhoststests_passwd_s error_protocsRS(N((s*/usr/lib/python1.5/site-packages/poplib.pys error_protosins s sPOP3cs=!dZILedZVdZ]dZfdZxdZdZdZdZ d Z d Z d Z d Z d ZedZdZdZdZdZdZdZeidZ dZdZ%edZRS(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 authorisation 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. csLM||_N||_Otititi|_P|ii|i|iQ|iid|_ Rd|_ S|i |_ dS(Nsrbi( shostsselfsportssocketsAF_INETs SOCK_STREAMssocksconnectsmakefilesfiles _debuggings_getrespswelcome(sselfshostsports*/usr/lib/python1.5/site-packages/poplib.pys__init__Ls   cs$VX|iid|tfdS(Ns%s%s(sselfssockssendslinesCRLF(sselfslines*/usr/lib/python1.5/site-packages/poplib.pys_putlineVscs]_|i|dS(N(sselfs_putlinesline(sselfslines*/usr/lib/python1.5/site-packages/poplib.pys_putcmd]scsfg|ii}i| oitdnjt|}n|d tjoo|d |fSnp|dtjoq|dd !|fSnr|d |fSdS(Ns-ERR EOFiii( sselfsfilesreadlineslines error_protoslensoctetssCRLFsCR(sselfslinesoctetss*/usr/lib/python1.5/site-packages/poplib.pys_getlinefs csSxy|i\}}{|d }||djo}t|n~|SdS(Nis+(sselfs_getlinesrespsoscs error_proto(sselfsrespsoscs*/usr/lib/python1.5/site-packages/poplib.pys_getrespxs  cs|i}g}d}|i\}}xG|djo6||}|i||i\}}q<W|||fSdS(Nis.( sselfs_getrespsrespslistsoctetss_getlineslinesosappend(sselfsrespslistsoctetsslinesos*/usr/lib/python1.5/site-packages/poplib.pys _getlongresps cs$|i||iSdS(N(sselfs_putcmdslines_getresp(sselfslines*/usr/lib/python1.5/site-packages/poplib.pys _shortcmdscs$|i||iSdS(N(sselfs_putcmdslines _getlongresp(sselfslines*/usr/lib/python1.5/site-packages/poplib.pys_longcmdscs|iSdS(N(sselfswelcome(sselfs*/usr/lib/python1.5/site-packages/poplib.pys getwelcomescs||_dS(N(slevelsselfs _debugging(sselfslevels*/usr/lib/python1.5/site-packages/poplib.pysset_debuglevelscs|id|SdS(sLSend user name, return response (should indicate password required). sUSER %sN(sselfs _shortcmdsuser(sselfsusers*/usr/lib/python1.5/site-packages/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(sselfspswds*/usr/lib/python1.5/site-packages/poplib.pyspass_scsg|id}ti|}ti|d}ti|d}||fSdS(sSGet mailbox status. Result is tuple of 2 ints (message count, mailbox size) sSTATiiN( sselfs _shortcmdsretvalsstringssplitsretssatois numMessagess sizeMessages(sselfsretvalsretss numMessagess sizeMessagess*/usr/lib/python1.5/site-packages/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(sselfswhichs*/usr/lib/python1.5/site-packages/poplib.pyslists cs|id|SdS(scRetrieve whole message number 'which'. Result is in form ['response', ['line', ...], octets]. sRETR %sN(sselfs_longcmdswhich(sselfswhichs*/usr/lib/python1.5/site-packages/poplib.pysretrscs|id|SdS(s:Delete message number 'which'. Result is 'response'. sDELE %sN(sselfs _shortcmdswhich(sselfswhichs*/usr/lib/python1.5/site-packages/poplib.pysdelescs|idSdS(sNDoes nothing. One supposes the response indicates the server is alive. sNOOPN(sselfs _shortcmd(sselfs*/usr/lib/python1.5/site-packages/poplib.pysnoopscs|idSdS(sNot sure what this does.sRSETN(sselfs _shortcmd(sselfs*/usr/lib/python1.5/site-packages/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(sselfsrespsvals*/usr/lib/python1.5/site-packages/poplib.pysquitscs|id|SdS(sNot sure what this does.sRPOP %sN(sselfs _shortcmdsuser(sselfsusers*/usr/lib/python1.5/site-packages/poplib.pysrpopss\+OK.*\(<[^>]+>\)cs |ii|idjotdnk}|i|iid|i }t i t d|d}|i d||fSdS(sAuthorisation - 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()' is!-ERR APOP not supported by servericsdt|S(Ns%02x(sordsx(sxs*/usr/lib/python1.5/site-packages/poplib.pyssss APOP %s %sN(sselfs timestampsmatchswelcomes error_protosmd5snewsgroupssecretsdigestsstringsjoinsmaps _shortcmdsuser(sselfsuserssecretsmd5sdigests*/usr/lib/python1.5/site-packages/poplib.pysapop s  (!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(sselfswhichshowmuchs*/usr/lib/python1.5/site-packages/poplib.pystopscs<%*+|o,|id|Sn-|idSdS(sReturn message digest (unique id) list. If 'which', result contains unique id for that message, otherwise result is list ['response', ['mesgnum uid', ...], octets] sUIDL %ssUIDLN(swhichsselfs _shortcmds_longcmd(sselfswhichs*/usr/lib/python1.5/site-packages/poplib.pysuidl%s (s__doc__s POP3_PORTs__init__s_putlines_putcmds_getlines_getresps _getlongresps _shortcmds_longcmds getwelcomesset_debuglevelsuserspass_sstatsNoneslistsretrsdelesnoopsrsetsquitsrpopsregexscompiles timestampsapopstopsuidl(s*/usr/lib/python1.5/site-packages/poplib.pysPOP3!s2 (                s__main__iisMessage s:s s-----------------------N(s__doc__s TESTSERVERs TESTACCOUNTs TESTPASSWORDsregexssocketsstrings Exceptions error_protos POP3_PORTsCRsLFsCRLFsPOP3s__name__sas getwelcomesuserspass_slistsstatsnumMsgss totalSizesrangesisretrsheadersmsgsoctetsslinesquit(s*/usr/lib/python1.5/site-packages/poplib.pys?s6