python (3.12.0)
ˑeS7 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__ :/BuggyBox/python/3.12.0/bootstrap/lib/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 }| j | y )Nz*cmd*)r r' r( bytesencodingr- r+ s r _putcmdz POP3._putcmdz s2 ??E'4: 6T4==)
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> listr9 r, r? s r _getlongrespzPOP3._getlongresp s }}A6--/adlu%aCABxaZF KK mmoGD!
dl T6!!r
c D | j | | j S N)r1 r r+ s r _shortcmdzPOP3._shortcmd s T}} r
c D | j | | j S rF )r1 rD r+ s r _longcmdz
POP3._longcmd s T ""r
c | j S rF )r r s r
getwelcomezPOP3.getwelcome s ||r
c || _ y rF )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 %srG r users r rS 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 %srQ )r pswds r pass_z
POP3.pass_ s ~~i$ .//r
c | j d }|j }| j rt dt | t |d }t |d }||fS )z]Get mailbox status.
Result is tuple of 2 ints (message count, mailbox size)
STATz*stat*r& )rG splitr r' r( int)r retvalrets numMessages sizeMessagess r statz POP3.stat sV
'||~ ??E(DJ 7$q'l 47| \**r
Nc P || j d|z S | j 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.
zLIST %sLISTrG rI r whichs r rC z POP3.list s- >>)e"34 4}}V$$r
c * | j d|z S )zoRetrieve whole message number 'which'.
Result is in form ['response', ['line', ...], octets].
zRETR %srI rd s r retrz POP3.retr s
}}Y .//r
c * | j d|z S )zFDelete message number 'which'.
Result is 'response'.
zDELE %srQ rd s r delez POP3.dele s
~~i% /00r
c $ | j d S )zXDoes nothing.
One supposes the response indicates the server is alive.
NOOPrQ rK s r noopz POP3.noop s
~~f%%r
c $ | j d S )z(Unmark all messages marked for deletion.RSETrQ rK s r rsetz POP3.rset s ~~f%%r
c H | j d }| j |S )zDSignoff: commit changes on server, unlock mailbox, close connection.QUIT)rG 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 rs r shutdownr# SHUT_RDWROSErrorerrnoENOTCONNgetattr)r r r excs r rs 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 )zNot sure what this does.zRPOP %srQ rR s r rpopz POP3.rpop7 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 hexdigestrG )r rS passwordsecretmr digests r apopz POP3.apop> s{ x / NN . AB BF"V$..0~~dF ;<<r
c 0 | j d|d| S )zRetrieve message header of message number 'which'
and first 'howmuch' lines of message body.
Result is in form ['response', ['line', ...], octets].
zTOP r rg )r re howmuchs r topzPOP3.topS s }}E7 ;<<r
c P || j d|z S | j d S )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]
zUIDL %sUIDLrc rd s r uidlz POP3.uidl\ s- >>)e"34 4}}V$$r
c $ | j d S )zITry to enter UTF-8 mode (see RFC 6856). Returns server response.
UTF8rQ rK s r utf8z POP3.utf8h 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& )decoderZ )r, lsts r _parsecapz POP3.capa.<locals>._parsecap{ s- ++g&,,.Cq63qr7? "r
CAPAr& z!-ERR CAPA not supported by server)rI r )r r capsr> rawcapscaplinecapnmcapargss r capaz POP3.capan sw # 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_contextrG 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
rF )'r r r __doc__r0 POP3_PORTr# _GLOBAL_DEFAULT_TIMEOUTr r r- r1 r: r rD rG rI rL rO rS rV r` rC rh rj rm rp rt rs r recompiler r r r r r r r r
r r r 3 s )V H"+ 77 'I
' !* " # 00
+ % 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 rF )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
rF )
r r r r
POP3_SSL_PORTr# r r r r r r
r r r s, '4 5 & > > 5 Fr
r __main__r& rY z Message %d:z z-----------------------)'r rz r r# r r r ImportError__all__ Exceptionr r r r8 LFr* r6 r r rB r argvar' rL rS rV rC r` numMsgs totalSizerangeirh headermsgr9 r, rt r r
r <module>r s
H -
#) "
"u k k\ F4 F@ NN: z SXXa[A !,,.FF388A;GGCHHQKFFH 668Wi
1gk
" ) !q f
ma D %$,
'( ) FFH [
Hs E EE
Browse
Usage
Versions