Ru & 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__ -/opt/alt/python311/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 }t j d| rt d | | d S )Nz*cmd*s [ - ]z*Control characters not allowed in commands) r r' r( bytesencodingresearchr" r- r+ s r _putcmdz POP3._putcmdz sm ?6E'4:: 6 6 6T4=))
9' . . K IJJ J
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@ listr; r, rA s r _getlongrespzPOP3._getlongresp s }}A6--//adllu%%
aCABBxaZF KK mmooGD!
dll T6!!r
c T | | | S N)r3 r r+ s r _shortcmdzPOP3._shortcmd s" T}} r
c T | | | 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 || _ d S rH )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 %srI r users r rU 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 %srS )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& )rI 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 %sLISTrI rK r whichs r rE 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 %srK rf s r retrz POP3.retr s
}}Y .///r
c 2 | d|z S )zFDelete message number 'which'.
Result is 'response'.
zDELE %srS rf s r delez POP3.dele s
~~i% /000r
c , | d S )zXDoes nothing.
One supposes the response indicates the server is alive.
NOOPrS rM s r noopz POP3.noop
s
~~f%%%r
c , | d S )z(Unmark all messages marked for deletion.RSETrS rM s r rsetz POP3.rset s ~~f%%%r
c X | d }| |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 }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 ru r shutdownr# SHUT_RDWROSErrorerrnoENOTCONNgetattr)r r r excs r ru 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 %srS rT s r rpopz POP3.rpop9 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 hexdigestrI )r rU passwordsecretmr digests r apopz POP3.apop@ s x // N . . C ABB BF"V$$..00~~~dddFF ;<<