; Êâ"Ic@sµdZddlZddlZddgZGd„deƒZdZdZdZd Z ee Z Gd „dƒZ yddl Z Wne k oYn"XGd „d e ƒZejd ƒed koîddlZe ejdƒZeejƒƒejejdƒejejdƒejƒejƒ\ZZxjededƒD]UZejeƒ\ZZ Z!edeƒxe D]Z"ede"ƒq}WedƒqJWej#ƒndS(u@A POP3 client class. Based on the J. Myers POP3 draft, Jan. 96 iNuPOP3u error_protocBs|EeZdS(N(u__name__u __module__(u __locals__((u#/mit/python/lib/python3.0/poplib.pyu error_protos iniãs s cBs|EeZdZdZeejd„Zd„Zd„Z d„Z d„Z d„Z d„Z d „Zd „Zd „Zd „Zd „Zd„Zd„Zdd„Zd„Zd„Zd„Zd„Zd„Zd„ZejdƒZd„Z d„Z!dd„Z"dS(uÏ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. uUTF-8cCsU||_||_|j|ƒ|_|jjdƒ|_d|_|jƒ|_dS(Nurbi( uhostuportu_create_socketusockumakefileufileu _debuggingu_getrespuwelcome(uselfuhostuportutimeout((u#/mit/python/lib/python3.0/poplib.pyu__init__Ps    cCstj|j|jf|ƒS(N(usocketucreate_connectionuhostuport(uselfutimeout((u#/mit/python/lib/python3.0/poplib.pyu_create_socketYscCs?|jdkotdt|ƒƒn|jj|tƒdS(Niu*put*(u _debugginguprintureprusockusendalluCRLF(uselfuline((u#/mit/python/lib/python3.0/poplib.pyu_putline\scCsD|jotdt|ƒƒnt||jƒ}|j|ƒdS(Nu*cmd*(u _debugginguprintureprubytesuencodingu_putline(uselfuline((u#/mit/python/lib/python3.0/poplib.pyu_putcmdcs cCs¿|jjƒ}|jdkotdt|ƒƒn|ptdƒ‚nt|ƒ}|dd…tko|dd…|fS|dtko|dd…|fS|dd…|fS(Niu*get*u-ERR EOFiþÿÿÿiiÿÿÿÿ( ufileureadlineu _debugginguprinturepru error_protoulenuCRLFuCR(uselfulineuoctets((u#/mit/python/lib/python3.0/poplib.pyu_getlinems cCs]|jƒ\}}|jdkotdt|ƒƒn|jdƒpt|ƒ‚n|S(Niu*resp*s+(u_getlineu _debugginguprinturepru startswithu error_proto(uselfurespuo((u#/mit/python/lib/python3.0/poplib.pyu_getresps cCs£|jƒ}g}d}|jƒ\}}xi|dko[|jdƒo|d}|dd…}n||}|j|ƒ|jƒ\}}q-W|||fS(Nis.s..i(u_getrespu_getlineu startswithuappend(uselfurespulistuoctetsulineuo((u#/mit/python/lib/python3.0/poplib.pyu _getlongresp‰s     cCs|j|ƒ|jƒS(N(u_putcmdu_getresp(uselfuline((u#/mit/python/lib/python3.0/poplib.pyu _shortcmd™s cCs|j|ƒ|jƒS(N(u_putcmdu _getlongresp(uselfuline((u#/mit/python/lib/python3.0/poplib.pyu_longcmd s cCs|jS(N(uwelcome(uself((u#/mit/python/lib/python3.0/poplib.pyu getwelcome§scCs ||_dS(N(u _debugging(uselfulevel((u#/mit/python/lib/python3.0/poplib.pyuset_debuglevel«scCs|jd|ƒS(uVSend user name, return response (should indicate password required). uUSER %s(u _shortcmd(uselfuuser((u#/mit/python/lib/python3.0/poplib.pyuuser±scCs|jd|ƒS(u Send password, return response (response includes message count, mailbox size). NB: mailbox is locked by server from here to 'quit()' uPASS %s(u _shortcmd(uselfupswd((u#/mit/python/lib/python3.0/poplib.pyupass_¹scCsf|jdƒ}|jƒ}|jotdt|ƒƒnt|dƒ}t|dƒ}||fS(u]Get mailbox status. Result is tuple of 2 ints (message count, mailbox size) uSTATu*stat*ii(u _shortcmdusplitu _debugginguprinturepruint(uselfuretvaluretsu numMessagesu sizeMessages((u#/mit/python/lib/python3.0/poplib.pyustatÃs  cCs,|dk o|jd|ƒS|jdƒS(uRequest 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. uLIST %suLISTN(uNoneu _shortcmdu_longcmd(uselfuwhich((u#/mit/python/lib/python3.0/poplib.pyulistÐs cCs|jd|ƒS(uoRetrieve whole message number 'which'. Result is in form ['response', ['line', ...], octets]. uRETR %s(u_longcmd(uselfuwhich((u#/mit/python/lib/python3.0/poplib.pyuretrÞscCs|jd|ƒS(uFDelete message number 'which'. Result is 'response'. uDELE %s(u _shortcmd(uselfuwhich((u#/mit/python/lib/python3.0/poplib.pyudeleæscCs |jdƒS(uXDoes nothing. One supposes the response indicates the server is alive. uNOOP(u _shortcmd(uself((u#/mit/python/lib/python3.0/poplib.pyunoopîscCs |jdƒS(u(Unmark all messages marked for deletion.uRSET(u _shortcmd(uself((u#/mit/python/lib/python3.0/poplib.pyursetösc Csmy|jdƒ}Wn-tk o!}z |}WYdd}~XnX|jjƒ|jjƒ|`|`|S(uDSignoff: commit changes on server, unlock mailbox, close connection.uQUITN(u _shortcmdu error_protoufileucloseusock(uselfurespuval((u#/mit/python/lib/python3.0/poplib.pyuquitûs   cCs|jd|ƒS(uNot sure what this does.uRPOP %s(u _shortcmd(uselfuuser((u#/mit/python/lib/python3.0/poplib.pyurpop ss\+OK.*(<[^>]+>)cCs‰t||jƒ}|jj|jƒ}|ptdƒ‚nddl}|jdƒ|}|j|ƒj ƒ}|j d||fƒS(u Authorisation - 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()' u!-ERR APOP not supported by serveriNiu APOP %s %s( ubytesuencodingu timestampumatchuwelcomeu error_protouhashlibugroupumd5u hexdigestu _shortcmd(uselfuuserupasswordusecretumuhashlibudigest((u#/mit/python/lib/python3.0/poplib.pyuapops  cCs|jd||fƒS(u­Retrieve message header of message number 'which' and first 'howmuch' lines of message body. Result is in form ['response', ['line', ...], octets]. u TOP %s %s(u_longcmd(uselfuwhichuhowmuch((u#/mit/python/lib/python3.0/poplib.pyutop'scCs,|dk o|jd|ƒS|jdƒS(uì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] uUIDL %suUIDLN(uNoneu _shortcmdu_longcmd(uselfuwhich((u#/mit/python/lib/python3.0/poplib.pyuuidl0s N(#u__name__u __module__u__doc__uencodingu POP3_PORTusocketu_GLOBAL_DEFAULT_TIMEOUTu__init__u_create_socketu_putlineu_putcmdu_getlineu_getrespu _getlongrespu _shortcmdu_longcmdu getwelcomeuset_debugleveluuserupass_ustatuNoneulisturetrudeleunoopursetuquiturpopureucompileu timestampuapoputopuuidl(u __locals__((u#/mit/python/lib/python3.0/poplib.pyuPOP3$s8 (                  cBs5|EeZdZeddejd„Zd„ZdS(u¾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. cCs,||_||_tj||||ƒdS(N(ukeyfileucertfileuPOP3u__init__(uselfuhostuportukeyfileucertfileutimeout((u#/mit/python/lib/python3.0/poplib.pyu__init__Ns  cCs+tj||ƒ}tj||j|jƒS(N(uPOP3u_create_socketusslu wrap_socketukeyfileucertfile(uselfutimeoutusock((u#/mit/python/lib/python3.0/poplib.pyu_create_socketUsN( u__name__u __module__u__doc__u POP3_SSL_PORTuNoneusocketu_GLOBAL_DEFAULT_TIMEOUTu__init__u_create_socket(u __locals__((u#/mit/python/lib/python3.0/poplib.pyuPOP3_SSLAs uPOP3_SSLu__main__iiiu Message %d:u u-----------------------($u__doc__ureusocketu__all__u Exceptionu error_protou POP3_PORTu POP3_SSL_PORTuCRuLFuCRLFuPOP3usslu ImportErroruPOP3_SSLuappendu__name__usysuargvuauprintu getwelcomeuuserupass_ulistustatunumMsgsu totalSizeurangeuiuretruheaderumsguoctetsulineuquit(((u#/mit/python/lib/python3.0/poplib.pyusB   ÿ