3 \t: @sldZddlZddlZddlZyddlZdZWnek rDdZYnXddgZGdddeZ dZ d Z d Z d Z e e Zd ZGd ddZerGdddeZejdedkrhddlZeejdZeejejejdejejdejej\ZZxXededD]FZ ej!e \Z"Z#Z$ede xe#D]Z%ede%qd5d6Z#d7d8Z$d9d:Z%d?d;d<Z&dS)@raPThis 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) CAPA capa() STLS stls() UTF8 utf8() 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. zUTF-8cCs@||_||_d|_|j||_|jjd|_d|_|j|_ dS)NFrbr) hostport_tls_established_create_socketsockmakefilefile _debugging_getrespwelcome)selfr rtimeoutrrr__init__as z POP3.__init__cCstj|j|jf|S)N)socketZcreate_connectionr r)rrrrrrkszPOP3._create_socketcCs,|jdkrtdt||jj|tdS)Nz*put*)rprintreprrZsendallCRLF)rlinerrr_putlinens z POP3._putlinecCs.|jrtdt|t||j}|j|dS)Nz*cmd*)rrrbytesencodingr )rrrrr_putcmdus z POP3._putcmdcCs|jjtd}t|tkr$td|jdkr)cCs\t||j}|jj|j}|s&tdddl}|jd|}|j|j }|j d||fS)a 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()' z!-ERR APOP not supported by serverrNrz APOP %s %s) r!r" timestampmatchrrhashlibgroupZmd5Z hexdigestr5)rr:ZpasswordZsecretmrMZdigestrrrapop9s z POP3.apopcCs|jd||fS)zRetrieve message header of message number 'which' and first 'howmuch' lines of message body. Result is in form ['response', ['line', ...], octets]. z TOP %s %s)r6)rr?ZhowmuchrrrtopNszPOP3.topcCs |dk r|jd|S|jdS)zReturn 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] NzUIDL %sZUIDL)r5r6)rr?rrruidlWsz POP3.uidlcCs |jdS)zITry to enter UTF-8 mode (see RFC 6856). Returns server response. ZUTF8)r5)rrrrutf8csz POP3.utf8c Cstdd}i}y8|jd}|d}x |D]}||\}}|||<q&WWn*tk rn}ztdWYdd}~XnX|S)aReturn server capabilities (RFC 2449) as a dictionary >>> c=poplib.POP3('localhost') >>> c.capa() {'IMPLEMENTATION': ['Cyrus', 'POP3', 'server', 'v2.2.12'], 'TOP': [], 'LOGIN-DELAY': ['0'], 'AUTH-RESP-CODE': [], 'EXPIRE': ['NEVER'], 'USER': [], 'STLS': [], 'PIPELINING': [], 'UIDL': [], 'RESP-CODES': []} >>> Really, according to RFC 2449, the cyrus folks should avoid having the implementation split into multiple arguments... cSs"|jdj}|d|ddfS)Nasciirr)decoder<)rZlstrrr _parsecapvszPOP3.capa.._parsecapZCAPArz!-ERR CAPA not supported by serverN)r6r) rrVcapsr/ZrawcapsZcaplineZcapnmZcapargsZ_errrrrcapais    z POP3.capacCsxts td|jrtd|j}d|kr2td|dkrBtj}|jd}|j|j|j d|_|jj d|_ d|_|S) z{Start a TLS session on the active connection as specified in RFC 2595. context - a ssl.SSLContext z-ERR TLS support missingz$-ERR TLS session already establishedZSTLSz!-ERR STLS not supported by serverN)server_hostnamer T) HAVE_SSLrrrXssl_create_stdlib_contextr5 wrap_socketrr rr)rcontextrWr/rrrstlss  z POP3.stls)N)N)N)'rrr__doc__r" POP3_PORTr_GLOBAL_DEFAULT_TIMEOUTrrr r#r,rr4r5r6r7r9r:r;r>r3r@rArBrCrErDrJrecompilerKrPrQrRrSrXr_rrrrr2s@+       c@s8eZdZdZeddejdfddZddZd ddZ dS) POP3_SSLaPOP3 client class over SSL connection Instantiate with: POP3_SSL(hostname, port=995, keyfile=None, certfile=None, context=None) hostname - the hostname of the pop3 over ssl server port - port number keyfile - PEM formatted file that contains your private key certfile - PEM formatted certificate chain file context - a ssl.SSLContext See the methods of the parent class POP3 for more documentation. NcCs|dk r|dk rtd|dk r0|dk r0td|dk s@|dk rVddl}|jdtd||_||_|dkrxtj||d}||_t j ||||dS)Nz4context and keyfile arguments are mutually exclusivez5context and certfile arguments are mutually exclusiverzAkeyfile and certfile are deprecated, use a custom context insteadr$)certfilekeyfile) ValueErrorwarningswarnDeprecationWarningrgrfr[r\r^rr)rr rrgrfrr^rirrrrszPOP3_SSL.__init__cCs"tj||}|jj||jd}|S)N)rY)rrr^r]r )rrrrrrrs  zPOP3_SSL._create_socketcCs tddS)zThe method unconditionally raises an exception since the STLS command doesn't make any sense on an already established SSL/TLS session. z$-ERR TLS session already establishedN)r)rrgrfr^rrrr_sz POP3_SSL.stls)NNN) rrrr` POP3_SSL_PORTrrbrrr_rrrrres  re__main__rr$z Message %d:z z-----------------------)'r`rGrcrr[rZ ImportError__all__ Exceptionrrarlr*ZLFrr(rrer2rsysargvarr7r:r;r3r>ZnumMsgsZ totalSizerangeir@headermsgr+rrErrrrsJ  l0