Z#Y & d Z ddlZddlZddlZddlZ ddlZdZn
# e$ r dZY nw xY wddgZ G d de Z
dZ d Z d
Z
d Ze
ez Zd Z G d
d Zer# G d de Ze d edk rddlZ eej d Z ee e ej d e ej d e e \ Z Z e de dz D ]GZ e! e \ Z"Z#Z$ ede z e#D ]Z% ede%z ed He& dS dS )z@A POP3 client class.
Based on the J. Myers POP3 draft, Jan. 96
NTFPOP3 error_protoc e Zd ZdS )r N)__name__
__module__ __qualname__ 3/opt/alt/python-internal/lib64/python3.11/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&dS )"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 d | _ d| _ |
| _ d S )NFzpoplib.connectrbr ) hostport_tls_establishedsysaudit_create_socketsockmakefilefile
_debugging_getrespwelcome)selfr r timeouts r __init__z
POP3.__init__b su % "D$555''00 I&&t,, }} r
c j ||st 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 s8 w OPP P'DI(>HHHr
c | j dk r t dt | t j d| | | j |t z d S )N z*put*zpoplib.putline)r printreprr r r sendallCRLFr lines r _putlinez
POP3._putliner sY ?Q gtDzz : : : "D$/// $+&&&&&r
c | j r t dt | t || j }| | d S )Nz*cmd*)r r' r( bytesencodingr- r+ s r _putcmdz POP3._putcmdz sH ?6E'4:: 6 6 6T4=))
dr
c | j t dz }t | t k rt d | j dk r t
dt | |st 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 y!!(Q,// t99x o.. . ?Q gtDzz : : :2;z222T 9 9f$ $ 8r>>":v% %CRCy& r
c | \ }}| j dk r t dt | | d st | |S )Nr& z*resp* +)r: r r' r(
startswithr )r respos r r z
POP3._getresp s\ --//a ?Q hT
; ; ;t$$ $ d## # r
c , | }g }d}| \ }}|dk r[| d r|dz
}|dd }||z }| | | \ }}|dk [|||fS )Nr .s ..r& )r r: r= append)r r> listr9 r, r? s r _getlongrespzPOP3._getlongresp s }}A6--//adllu%%
aCABBxaZF KK mmooGD!
dll T6!!r
c T | | | S N)r1 r r+ s r _shortcmdzPOP3._shortcmd s" T}} r
c T | | | 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 || _ d S rF )r )r levels r set_debuglevelzPOP3.set_debuglevel s
r
c 2 | 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 2 | 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 | d }| }| j r t 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 sh
''||~~ ?7E(DJJ 7 7 7$q'll 47|| \**r
Nc ` || d|z 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 %sLISTrG rI r whichs r rC z POP3.list s3 >>)e"344 4}}V$$$r
c 2 | 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 2 | d|z S )zFDelete message number 'which'.
Result is 'response'.
zDELE %srQ rd s r delez POP3.dele s
~~i% /000r
c , | d S )zXDoes nothing.
One supposes the response indicates the server is alive.
NOOPrQ rK s r noopz POP3.noop s
~~f%%%r
c , | d S )z(Unmark all messages marked for deletion.RSETrQ rK s r rsetz POP3.rset s ~~f%%%r
c X | d }| |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 }d| _ | | t j nB# t $ r5}|j t j k rt |dd dk r Y d}~nd}~ww xY w| dS # | w xY wdS # | j }d| _ | | t j nB# t $ r5}|j t j k rt |dd dk r Y d}~nd}~ww xY w| w # | 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 !9D DI
9D DI
!MM&"23333 U^33"3
A66%??
JJLLLLLDJJLLLL 9D DI
!MM&"23333 U^33"3
A66%??
JJLLLLDJJLLLL sv $C
A B/
B!+B B/ BB/ /C
E- C<;E<
D;+D61E6D;;E>E-E))E-c 2 | d|z S )zNot sure what this does.zRPOP %srQ rR s r rpopz POP3.rpop7 s ~~i$ .///r
s \+OK.[^<]*(<.*>)c H t || j }| j | j }|st d ddl}| d |z }| | }|
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 // N . . C ABB BF"V$$..00~~~dddFF ;<<>)e"344 4}}V$$$r
c , | 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 } | d }|d }|D ]} || \ }}|||< n # t $ r t d w xY w|S )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 | d }|d |dd fS )Nasciir r& )decoderZ )r, lsts r _parsecapz POP3.capa.._parsecap{ s5 ++g&&,,..Cq63qrr7? "r
CAPAr& z!-ERR CAPA not supported by server)rI r )r r capsr> rawcapscaplinecapnmcapargss r capaz POP3.capan s # # # C==((D1gG"
&
&!*7!3!3w %U
& C C C ABB B C s 5= Ac t st d | j rt d | }d|vrt d |t j }| d }| | 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 serverNserver_hostnamer T) HAVE_SSLr r r ssl_create_stdlib_contextrG wrap_socketr r r r )r contextr r> s r stlsz POP3.stls s
: 899 9 F DEE Eyy{{~~ ABB B ?022G~~f%%'' 8< ( C C I&&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"+ 7 ' ' ' 'I I I
' ' ' ! ! !* " " " # # # 0 0 00 0 0
+
+
+ % % % % 0 0 01 1 1& & && & &
! ! !80 0 0
/00I= = =*= = = % % % %& & & : r
c < e Zd ZdZeddej dfdZd ZddZ 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 . ||t d ||t d || dd l}| dt d || _ || _ |t
j || }|| _ t
| ||| d S )Nz4context and keyfile arguments are mutually exclusivez5context and certfile arguments are mutually exclusiver zAkeyfile and certfile are deprecated, use a custom context insteadrY )certfilekeyfile) r" warningswarnDeprecationWarningr r r r r r r )r r r r r r r r s r r zPOP3_SSL.__init__ s "w': "- . . ."x'; "- . . ."h&:
78JAO O O"DL $DM 4h=DF F F"DL MM$dG 4 4 4 4 4r
c ~ t | | }| j || j }|S )Nr )r r r r r )r r r s r r zPOP3_SSL._create_socket sA &&tW55D<++D<@I , G 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 r r s r r z
POP3_SSL.stls s
DEE Er
)NNN)
r r r r
POP3_SSL_PORTr# r r r r r r
r r r sl '4TD # ;T 5 5 5 5( F F F F F 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 r so
JJJHH HHH -
# " " " ") " " "
"u k k k k k k k k\ 2 .F .F .F .F .F4 .F .F .F` NN: zJJJ SXa[A E!,,..FF38A;GGCHQKFFHHH 6688Wi
U1gk
"
" ) ) !q f
ma D E%$,
'((((FFHHHHH s %%