o “Hb^;ã@shdZddlZddlZddlZddlZzddlZdZWn ey%dZYnwddgZGdd„de ƒZ dZ d Z d Z d Ze eZd ZGd d„dƒZerVGdd„deƒZe d¡edkr²ddlZeejdƒZee ¡ƒe ejd¡e ejd¡e ¡e ¡\ZZededƒD]Z e !e ¡\Z"Z#Z$ede ƒe#D]Z%ede%ƒqžedƒqŒe &¡dSdS)z@A POP3 client class. Based on the J. Myers POP3 draft, Jan. 96 éNTFÚPOP3Ú error_protoc@s eZdZdS)rN)Ú__name__Ú __module__Ú __qualname__©rrú/usr/lib/python3.10/poplib.pyrs éniãó ó ic@s eZdZdZdZeejfdd„Zdd„Z dd„Z d d „Z d d „Z d d„Z dd„Zdd„Zdd„Zdd„Zdd„Zdd„Zdd„Zdd„Zd=d d!„Zd"d#„Zd$d%„Zd&d'„Zd(d)„Zd*d+„Zd,d-„Zd.d/„Ze d0¡Z d1d2„Z!d3d4„Z"d=d5d6„Z#d7d8„Z$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-8cCsP||_||_d|_t d|||¡| |¡|_|j d¡|_d|_ |  ¡|_ dS)NFzpoplib.connectÚrbr) ÚhostÚportÚ_tls_establishedÚsysÚauditÚ_create_socketÚsockÚmakefileÚfileÚ _debuggingÚ_getrespÚwelcome)Úselfr rÚtimeoutrrrÚ__init__bs z POP3.__init__cCs(|dur |s tdƒ‚t |j|jf|¡S)Nz0Non-blocking socket (timeout=0) is not supported)Ú ValueErrorÚsocketZcreate_connectionr r)rrrrrrms zPOP3._create_socketcCs:|jdkr tdt|ƒƒt d||¡|j |t¡dS)Néz*put*zpoplib.putline)rÚprintÚreprrrrZsendallÚCRLF©rÚlinerrrÚ_putlinersz POP3._putlinecCs.|jr tdt|ƒƒt||jƒ}| |¡dS)Nz*cmd*)rrr ÚbytesÚencodingr$r"rrrÚ_putcmdzs z POP3._putcmdcCs |j td¡}t|ƒtkrtdƒ‚|jdkrtdt|ƒƒ|s$tdƒ‚t|ƒ}|dd…tkr8|dd…|fS|dd…t krH|dd…|fS|dd…|fS)Nrz line too longz*get*z-ERR EOFéþÿÿÿéÿÿÿÿ) rÚreadlineÚ_MAXLINEÚlenrrrr r!ÚCR)rr#ÚoctetsrrrÚ_getline„s  z POP3._getlinecCs:| ¡\}}|jdkrtdt|ƒƒ| d¡st|ƒ‚|S)Nrz*resp*ó+)r/rrr Ú startswithr)rÚrespÚorrrr™s  z POP3._getrespcCsr| ¡}g}d}| ¡\}}|dkr4| d¡r!|d}|dd…}||}| |¡| ¡\}}|dks|||fS)Nró.s..r)rr/r1Úappend)rr2Úlistr.r#r3rrrÚ _getlongresp£s     ú zPOP3._getlongrespcCó| |¡| ¡S©N)r'rr"rrrÚ _shortcmd³ó zPOP3._shortcmdcCr8r9)r'r7r"rrrÚ_longcmdºr;z POP3._longcmdcCs|jSr9)r©rrrrÚ getwelcomeÁszPOP3.getwelcomecCs ||_dSr9)r)rÚlevelrrrÚset_debuglevelÅs zPOP3.set_debuglevelcCó| d|¡S)zVSend user name, return response (should indicate password required). zUSER %s©r:©rÚuserrrrrDËóz POP3.usercCrA)z Send password, return response (response includes message count, mailbox size). NB: mailbox is locked by server from here to 'quit()' zPASS %srB)rZpswdrrrÚpass_Ósz POP3.pass_cCsF| d¡}| ¡}|jrtdt|ƒƒt|dƒ}t|dƒ}||fS)z]Get mailbox status. Result is tuple of 2 ints (message count, mailbox size) ZSTATz*stat*ré)r:Úsplitrrr Úint)rZretvalZretsZ numMessagesZ sizeMessagesrrrÚstatÝs   z POP3.statNcCó |dur | d|¡S| d¡S)aRequest 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. NzLIST %sZLIST©r:r<©rÚwhichrrrr6ês  z POP3.listcCrA)zoRetrieve whole message number 'which'. Result is in form ['response', ['line', ...], octets]. zRETR %s©r<rMrrrÚretrørEz POP3.retrcCrA)zFDelete message number 'which'. Result is 'response'. zDELE %srBrMrrrÚdelerEz POP3.delecCó | d¡S)zXDoes nothing. One supposes the response indicates the server is alive. ZNOOPrBr=rrrÚnoops z POP3.noopcCrR)z(Unmark all messages marked for deletion.ZRSETrBr=rrrÚrsets z POP3.rsetcCs| d¡}| ¡|S)zDSignoff: commit changes on server, unlock mailbox, close connection.ZQUIT)r:Úclose)rr2rrrÚquits z POP3.quitcCsBzY|j}d|_|dur| ¡W|j}d|_|durXz8z| tj¡Wn!tyD}z|jtjkr:t |ddƒdkr:‚WYd}~n d}~wwW| ¡dSW| ¡dS| ¡wdS|j}d|_|dur z6z| tj¡Wn!tyŽ}z|jtjkr„t |ddƒdkr„‚WYd}~n d}~wwW| ¡wW| ¡w| ¡ww)z8Close the connection without assuming anything about it.NÚwinerrorri&') rrUrZshutdownrZ SHUT_RDWRÚOSErrorÚerrnoZENOTCONNÚgetattr)rrrÚexcrrrrUsP€ ÿ€úÿ €õþ ÿ€úÿ €õz POP3.closecCrA)zNot sure what this does.zRPOP %srBrCrrrÚrpop7sz POP3.rpops\+OK.[^<]*(<.*>)cCs\t||jƒ}|j |j¡}|stdƒ‚ddl}| d¡|}| |¡  ¡}|  d||f¡S)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&Ú timestampÚmatchrrÚhashlibÚgroupZmd5Z hexdigestr:)rrDZpasswordZsecretÚmr_ZdigestrrrÚapop>s z POP3.apopcCs| d||f¡S)z­Retrieve message header of message number 'which' and first 'howmuch' lines of message body. Result is in form ['response', ['line', ...], octets]. z TOP %s %srO)rrNZhowmuchrrrÚtopSszPOP3.topcCrK)zì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] NzUIDL %sZUIDLrLrMrrrÚuidl\s z POP3.uidlcCrR)zITry to enter UTF-8 mode (see RFC 6856). Returns server response. ZUTF8rBr=rrrÚutf8hs z POP3.utf8cCsZdd„}i}z| d¡}|d}|D] }||ƒ\}}|||<qW|Sty,tdƒ‚w)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"| d¡ ¡}|d|dd…fS)NÚasciirr)ÚdecoderH)r#ZlstrrrÚ _parsecap{szPOP3.capa.._parsecapZCAPArz!-ERR CAPA not supported by server)r<r)rrhÚcapsr2ZrawcapsZcaplineZcapnmZcapargsrrrÚcapans    þ þÿz POP3.capacCsxtstdƒ‚|jr tdƒ‚| ¡}d|vrtdƒ‚|dur!t ¡}| d¡}|j|j|j d|_|j  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 missingú$-ERR TLS session already establishedZSTLSz!-ERR STLS not supported by serverN©Zserver_hostnamer T) ÚHAVE_SSLrrrjÚsslÚ_create_stdlib_contextr:Ú wrap_socketrr rr)rÚcontextrir2rrrÚstls‹s  ÿz POP3.stlsr9)'rrrÚ__doc__r&Ú POP3_PORTrÚ_GLOBAL_DEFAULT_TIMEOUTrrr$r'r/rr7r:r<r>r@rDrFrJr6rPrQrSrTrVrUr\ÚreÚcompiler]rbrcrdrerjrrrrrrr3sD+ ÿ       c@s8eZdZdZeddejdfdd„Zdd„Zd dd„Z 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’|dur |dur tdƒ‚|dur|durtdƒ‚|dus |dur+ddl}| dtd¡||_||_|durrDrFr6rJZnumMsgsZ totalSizeÚrangeÚirPÚheaderÚmsgr.r#rVrrrrÚsR ÿp 0     ò