o
0¦i^; ã @ sh d Z ddlZddlZddlZddlZzddlZdZW n ey% dZY nw ddgZG dd„ de ƒZ
dZ d Z d
Z
d Ze
e Zd ZG d
d„ dƒZerVG dd„ deƒZe d¡ edkr²ddlZeejd ƒZee ¡ ƒ e ejd ¡ e ejd ¡ e ¡ e ¡ \Z Z e de d ƒD ] Z e !e ¡\Z"Z#Z$ede ƒ e#D ]Z%ede% ƒ qžedƒ qŒe &¡ dS dS )z@A POP3 client class.
Based on the J. Myers POP3 draft, Jan. 96
é NTFÚPOP3Ú error_protoc @ s e Zd ZdS )r N)Ú__name__Ú
__module__Ú __qualname__© r r ú-/opt/alt/python310/lib64/python3.10/poplib.pyr s én iã ó
ó
i c @ s e Zd ZdZdZeejfdd„Zdd„ Z dd„ Z
d d
„ Z d d „ Z d
d„ Z
dd„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd „ Zd d „ Zd=d d!„Zd"d#„ Zd$d%„ Zd&d'„ Zd(d)„ Zd*d+„ Zd,d-„ Z d.d/„ Z e d0¡Z d1d2„ Z!d3d4„ Z"d=d5d6„Z#d7d8„ Z$d9d:„ Z%d=d;d<„Z&d S )>r aP 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)
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-8c C sP || _ || _d| _t d| ||¡ | |¡| _| j d¡| _d| _ |
¡ | _ d S )NFzpoplib.connectÚrbr ) ÚhostÚportÚ_tls_establishedÚsysÚauditÚ_create_socketÚsockÚmakefileÚfileÚ
_debuggingÚ_getrespÚwelcome)Úselfr
r Útimeoutr r r Ú__init__b s z
POP3.__init__c C s( |d ur
|s
t dƒ‚t | j| jf|¡S )Nz0Non-blocking socket (timeout=0) is not supported)Ú
ValueErrorÚsocketZcreate_connectionr
r )r r r r r r m s zPOP3._create_socketc C s: | j dkr tdt|ƒƒ t d| |¡ | j |t ¡ d S )Né z*put*zpoplib.putline)r ÚprintÚreprr r r ZsendallÚCRLF©r Úliner r r Ú_putliner s z
POP3._putlinec C s. | j r
tdt|ƒƒ t|| jƒ}| |¡ d S )Nz*cmd*)r r r ÚbytesÚencodingr$ r" r r r Ú_putcmdz s z POP3._putcmdc C s | j td ¡}t|ƒtkrtdƒ‚| jdkr tdt|ƒƒ |s$tdƒ‚t|ƒ}|dd … tkr8|d d… |fS |d d… t krH|dd… |fS |d d… |fS )Nr z
line too longz*get*z-ERR EOFéþÿÿÿéÿÿÿÿ)
r ÚreadlineÚ_MAXLINEÚlenr r r r r! ÚCR)r r# Úoctetsr r r Ú_getline„ s z
POP3._getlinec C s: | ¡ \}}| jdkrtdt|ƒƒ | d¡st|ƒ‚|S )Nr z*resp*ó +)r/ r r r Ú
startswithr )r ÚrespÚor r r r ™ s
z
POP3._getrespc C sr | ¡ }g }d}| ¡ \}}|dkr4| d¡r!|d }|dd … }|| }| |¡ | ¡ \}}|dks|||fS )Nr ó .s ..r )r r/ r1 Úappend)r r2 Úlistr. r# r3 r r r Ú _getlongresp£ s
ú
zPOP3._getlongrespc C ó | |¡ | ¡ S ©N)r' r r" r r r Ú _shortcmd³ ó
zPOP3._shortcmdc C r8 r9 )r' r7 r" r r r Ú_longcmdº r; z
POP3._longcmdc C s | j S r9 )r ©r r r r Ú
getwelcomeÁ s zPOP3.getwelcomec C s
|| _ d S r9 )r )r Úlevelr r r Úset_debuglevelÅ s
zPOP3.set_debuglevelc C ó | d| ¡S )zVSend user name, return response
(should indicate password required).
zUSER %s©r: ©r Úuserr r r rD Ë ó z POP3.userc C rA )z Send password, return response
(response includes message count, mailbox size).
NB: mailbox is locked by server from here to 'quit()'
zPASS %srB )r Zpswdr r r Úpass_Ó s z
POP3.pass_c C sF | 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: Úsplitr r r Úint)r ZretvalZretsZ numMessagesZ sizeMessagesr r r ÚstatÝ s
z POP3.statNc C ó |dur | d| ¡S | d¡S )a Request 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 Úwhichr r r r6 ê s
z POP3.listc C rA )zoRetrieve whole message number 'which'.
Result is in form ['response', ['line', ...], octets].
zRETR %s©r< rM r r r Úretrø rE z POP3.retrc C rA )zFDelete message number 'which'.
Result is 'response'.
zDELE %srB rM r r r Údele rE z POP3.delec C ó
| d¡S )zXDoes nothing.
One supposes the response indicates the server is alive.
ZNOOPrB r= r r r Únoop s
z POP3.noopc C rR )z(Unmark all messages marked for deletion.ZRSETrB r= r r r Úrset s
z POP3.rsetc C s | d¡}| ¡ |S )zDSignoff: commit changes on server, unlock mailbox, close connection.ZQUIT)r: Úclose)r r2 r r r Úquit s
z POP3.quitc C sB zY| j }d| _ |dur| ¡ W | j}d| _|durXz8z| tj¡ W n! tyD } z|jtjkr:t |ddƒdkr:‚ W Y d}~n d}~ww W | ¡ dS W | ¡ dS | ¡ w dS | j}d| _|dur z6z| tj¡ W n! tyŽ } z|jtjkr„t |ddƒdkr„‚ W Y d}~n d}~ww W | ¡ w W | ¡ w | ¡ w w )z8Close the connection without assuming anything about it.NZwinerrorr i&' )
r rU r Zshutdownr Z SHUT_RDWRÚOSErrorÚerrnoZENOTCONNÚgetattr)r r r Úexcr r r rU sL € €úÿ € õþ €úÿ
€ õz
POP3.closec C rA )zNot sure what this does.zRPOP %srB rC r r r Úrpop7 s z POP3.rpops \+OK.[^<]*(<.*>)c C s\ 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 serverr Nr z
APOP %s %s) r% r& Ú timestampÚmatchr r ÚhashlibÚgroupZmd5Z hexdigestr: )r rD ZpasswordZsecretÚmr^ Zdigestr r r Úapop> s z POP3.apopc C s | d||f ¡S )zRetrieve message header of message number 'which'
and first 'howmuch' lines of message body.
Result is in form ['response', ['line', ...], octets].
z TOP %s %srO )r rN Zhowmuchr r r ÚtopS s zPOP3.topc C rK )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 %sZUIDLrL rM r r r Úuidl\ s
z POP3.uidlc C rR )zITry to enter UTF-8 mode (see RFC 6856). Returns server response.
ZUTF8rB r= r r r Úutf8h s
z POP3.utf8c C sZ dd„ }i }z| d¡}|d }|D ] }||ƒ\}}|||< qW |S ty, tdƒ‚w )a Return 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...
c S s" | d¡ ¡ }|d |dd … fS )NÚasciir r )ÚdecoderH )r# Zlstr r r Ú _parsecap{ s z POP3.capa.._parsecapZCAPAr z!-ERR CAPA not supported by server)r< r )r rg Úcapsr2 ZrawcapsZcaplineZcapnmZcapargsr r r Úcapan s
þ þÿz POP3.capac C sx t stdƒ‚| jr
tdƒ‚| ¡ }d|vrtdƒ‚|du r!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_SSLr r ri ÚsslÚ_create_stdlib_contextr: Ú wrap_socketr r
r r )r Úcontextrh r2 r r r Ústls‹ s
ÿz POP3.stlsr9 )'r r r Ú__doc__r& Ú POP3_PORTr Ú_GLOBAL_DEFAULT_TIMEOUTr r r$ r' r/ r r7 r: r< r> r@ rD rF rJ r6 rP rQ rS rT rV rU r[ ÚreÚcompiler\ ra rb rc rd ri rq r r r r r 3 sD +
ÿ
c @ s8 e Zd ZdZeddejdfdd„Zdd„ Zd dd„Z dS )
ÚPOP3_SSLa POP3 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.
Nc C s’ |d ur |d ur t dƒ‚|d ur|d urt dƒ‚|d us |d ur+dd l}| dtd¡ || _|| _|d u r rD rF r6 rJ ZnumMsgsZ totalSizeÚrangeÚirP ÚheaderÚmsgr. r# rV r r r r Ú sR ÿ p
0
ò