Wj9 d Z ddlZddlZddlZddlZ ddlZdZddgZ G d de Z
dZ d Z d
Z
d Ze
ez Zd Z G d
d Zer G d de Zej' d edk( rddlZ eej* d Z eej1 ej3 ej* d ej5 ej* d ej7 ej9 \ Z Z e de dz D ]< Z ejC e \ Z"Z#Z$ ede z e#D ]
Z% ede%z ed > ejM yy# e$ r dZY @w xY w)z@A POP3 client class.
Based on the J. Myers POP3 draft, Jan. 96
NTFPOP3 error_protoc e Zd Zy)r N)__name__
__module__ __qualname__ /usr/lib64/python3.12/poplib.pyr r s r
n i
i c e Zd ZdZdZeej fdZd Z d Z
d Z d Z d Z
d Zd
Zd Zd Zd
Zd Zd Zd Zd!dZd Zd Zd Zd Zd Zd Z d Z e j> d Z d Z!d Z"d!d Z#d Z$d Z%d!d Z&y)"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 || _ || _ d| _ t j d| || | j | | _ | j j d | _ d| _ | j | _ y )NFzpoplib.connectrbr ) hostport_tls_establishedsysaudit_create_socketsockmakefilefile
_debugging_getrespwelcome)selfr r timeouts r __init__z
POP3.__init__b sg % "D$5''0 II&&t, }} r
c x |
|s t d t j | j | j f| S )Nz0Non-blocking socket (timeout=0) is not supported)
ValueErrorsocketcreate_connectionr r )r r s r r zPOP3._create_socketm s6 w OP P''DII(>HHr
c | j dkD rt dt | t j d| | | j
j
|t z y )N z*put*zpoplib.putline)r printreprr r r sendallCRLFr lines r _putlinez
POP3._putliner sB ??Q gtDz : "D$/ $+&r
c | j rt dt | t || j }t j d| r t d | j | y )Nz*cmd*s [ - ]z*Control characters not allowed in commands) r r' r( bytesencodingresearchr" r- r+ s r _putcmdz POP3._putcmdz sM ??E'4: 6T4==)
99' . IJ J
dr
c R | j j t dz }t | t kD r t d | j
dkD rt
dt | |s t d t | }|dd t k( r|d d |fS |d d t k( r|dd |fS |d d |fS )Nr& z
line too longz*get*z-ERR EOF)
r readline_MAXLINElenr r r' r( r* CR)r r, octetss r _getlinez
POP3._getline s yy!!(Q,/ t9x o. . ??Q gtDz :;z22T 9 9f$ $ 8r>":v% %CRy& r
c | j \ }}| j dkD rt dt | |j d s t | |S )Nr& z*resp* +)r< r r' r(
startswithr )r respos r r z
POP3._getresp sF --/a ??Q hT
;t$ d# # r
c | j }g }d}| j \ }}|dk7 rJ|j d r
|dz
}|dd }||z }|j | | j \ }}|dk7 rJ|||fS )Nr .s ..r& )r r< r? append)r r@ listr; r, rA s r _getlongrespzPOP3._getlongresp s }}A6--/adlu%aCABxaZF KK mmoGD!
dl T6!!r
c D | j | | j S N)r3 r r+ s r _shortcmdzPOP3._shortcmd s T}} r
c D | j | | j S rH )r3 rF r+ s r _longcmdz
POP3._longcmd s T ""r
c | j S rH )r r s r
getwelcomezPOP3.getwelcome s ||r
c || _ y rH )r )r levels r set_debuglevelzPOP3.set_debuglevel s r
c * | j d|z S )zVSend user name, return response
(should indicate password required).
zUSER %srI r users r rU z POP3.user s
~~i$ .//r
c * | j d|z S )zSend password, return response
(response includes message count, mailbox size).
NB: mailbox is locked by server from here to 'quit()'
zPASS %srS )r pswds r pass_z
POP3.pass_ s ~~i$ .//r
c * | j d }|j }| j rt dt | t | dk r t
d t |d }t |d }||fS # t $ r t
d w xY w)z]Get mailbox status.
Result is tuple of 2 ints (message count, mailbox size)
STATz*stat* z Invalid STAT response formatr& z.Invalid STAT response data: non-numeric values) rI splitr r' r( r9 r intr" )r retvalrets numMessages sizeMessagess r statz POP3.stat s
'||~ ??E(DJ 7
t9q= <= = P d1g,K tAw>)e"34 4}}V$$r
c * | j d|z S )zoRetrieve whole message number 'which'.
Result is in form ['response', ['line', ...], octets].
zRETR %srK rg s r retrz POP3.retr s
}}Y .//r
c * | j d|z S )zFDelete message number 'which'.
Result is 'response'.
zDELE %srS rg s r delez POP3.dele
s
~~i% /00r
c $ | j d S )zXDoes nothing.
One supposes the response indicates the server is alive.
NOOPrS rM s r noopz POP3.noop s
~~f%%r
c $ | j d S )z(Unmark all messages marked for deletion.RSETrS rM s r rsetz POP3.rset s ~~f%%r
c H | j d }| j |S )zDSignoff: commit changes on server, unlock mailbox, close connection.QUIT)rI close)r r@ s r quitz POP3.quit" s ~~f%
r
c | j }d| _ ||j | j }d| _ |1 |j t j
|j yy# t $ r8}|j t j k7 rt |dd dk7 r Y d}~Nd}~ww xY w# |j w xY w# | j }d| _ | |j t j
nD# t $ r8}|j t j k7 rt |dd dk7 r Y d}~nd}~ww xY w|j w # |j w xY ww xY w)z8Close the connection without assuming anything about it.Nwinerrorr i&' )
r rv r shutdownr# SHUT_RDWROSErrorerrnoENOTCONNgetattr)r r r excs r rv z
POP3.close( s) !99D DI
99D DI
!MM&"2"23 JJL U^^3"3
A6%?
JJL 99D DI
!MM&"2"23 U^^3"3
A6%?
JJLDJJL sp %C A. . B/7.B*%B2 *B//B2 2CE) C>=E> D?.D:5E:D??EE)E%%E)c * | j d|z S )z?Send RPOP command to access the mailbox with an alternate user.zRPOP %srS rT s r rpopz POP3.rpopD s ~~i$ .//r
s \+OK.[^<]*(<.*>)c . t || j }| j j | j }|s t d ddl}|j d |z }|j | j }| j d|d| 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& zAPOP ) r/ r0 timestampmatchr r hashlibgroupmd5 hexdigestrI )r rU passwordsecretmr digests r apopz POP3.apopK s{ x / NN . AB BF"V$..0~~dF ;<>)e"34 4}}V$$r
c $ | j d S )zITry to enter UTF-8 mode (see RFC 6856). Returns server response.
UTF8rS rM s r utf8z POP3.utf8u s ~~f%%r
c d }i } | j d }|d }|D ] } || \ }}|||< |S # t $ r t d w xY 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 T | j d j }|d |dd fS )Nasciir r& )decoder] )r, lsts r _parsecapz POP3.capa.._parsecap s- ++g&,,.Cq63qr7? "r
CAPAr& z!-ERR CAPA not supported by server)rK r )r r capsr@ rawcapscaplinecapnmcapargss r capaz POP3.capa{ sr # C==(D1gG"!*7!3w %U #
C AB B Cs -7 A c t s t d | j r t d | j }d|vr t d |t j
}| j
d }|j | j | j | _ | j 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 establishedSTLSz!-ERR STLS not supported by serverserver_hostnamer T) HAVE_SSLr r r ssl_create_stdlib_contextrI wrap_socketr r r r )r contextr r@ s r stlsz POP3.stls s
89 9 DE Eyy{~ AB B ?002G~~f%'' 8< ( C II&&t, $ r
rH )'r r r __doc__r0 POP3_PORTr# _GLOBAL_DEFAULT_TIMEOUTr r r- r3 r< r rF rI rK rN rQ rU rX rc rE rk rm rp rs rw rv r r1 compiler r r r r r r r r
r r r 3 s )V H"+ 77 'I
' !* " # 00+0 % 01&&
!80
/0I=*= %& :r
c D e Zd ZdZefej dddZd ZddZ y)POP3_SSLaN POP3 client class over SSL connection
Instantiate with: POP3_SSL(hostname, port=995, context=None)
hostname - the hostname of the pop3 over ssl server
port - port number
context - a ssl.SSLContext
See the methods of the parent class POP3 for more documentation.
N)r r c n |t j }|| _ t j | ||| y rH )r r r r r )r r r r r s r r zPOP3_SSL.__init__ s. 446"DL MM$dG 4r
c t j | | }| j j || j }|S )Nr )r r r r r )r r r s r r zPOP3_SSL._create_socket s< &&tW5D<<++D<@II , GDKr
c t d )zThe method unconditionally raises an exception since the
STLS command doesn't make any sense on an already established
SSL/TLS session.
r )r )r r s r r z
POP3_SSL.stls s
DE Er
rH )
r r r r
POP3_SSL_PORTr# r r r r r r
r r r s, '4 5 & > > 5 Fr
r __main__r& r\ r[ z Message %d:z z-----------------------)'r r} r1 r# r r r ImportError__all__ Exceptionr r r r: LFr* r8 r r rD r argvar' rN rU rX rE rc numMsgs totalSizerangeirk headermsgr; r, rw r r
r r s|
H -
#) "
"u x xv F4 F@ NN: z SXXa[A !,,.FF388A;GGCHHQKFFH 668Wi
1gk
" !q f
ma D %$,
'( # FFH u
Hs E EE