3
�L�j�: �
@ sl d Z ddlZddlZddlZyddlZdZW n ek
rD dZY nX ddgZG dd� de�Z dZ
d Z d
Z d Z
e e
Zd ZG d
d� d�Zer�G dd� de�Zejd� edk�rhddlZeejd �Zeej� � ejejd � ejejd � ej� ej � \Z Z xXe de d �D ]FZ ej!e �\Z"Z#Z$ede � xe#D ]Z%ede% � �qd5d6�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 s@ || _ || _d| _| j|�| _| jjd�| _d| _| j� | _ d S )NF�rbr )
�host�port�_tls_established�_create_socket�sock�makefile�file�
_debugging�_getresp�welcome)�selfr
r �timeoutr r r �__init__a s z
POP3.__init__c C s t j| j| jf|�S )N)�socketZcreate_connectionr
r )r r r r r r k s zPOP3._create_socketc C s, | j dkrtdt|�� | jj|t � d S )N� z*put*)r �print�reprr Zsendall�CRLF)r �liner r r �_putlinen s
z
POP3._putlinec C sB | j rtdt|�� t|| j�}tjd|�r4td��| j|� d S )Nz*cmd*s [ - ]z*Control characters not allowed in commands) r r r �bytes�encoding�re�search�
ValueErrorr )r r r r r �_putcmdu s z POP3._putcmdc C s� | j jtd �}t|�tkr$td��| jdkr)c C s\ t || j�}| jj| j�}|s&td��ddl}|jd�| }|j|�j � }| j
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 hexdigestr8 )r r= ZpasswordZsecret�mrP Zdigestr r r �apop; s z POP3.apopc C s | j d||f �S )z�Retrieve message header of message number 'which'
and first 'howmuch' lines of message body.
Result is in form ['response', ['line', ...], octets].
z TOP %s %s)r9 )r rB Zhowmuchr r r �topP s zPOP3.topc C s |dk r| j d| �S | jd�S )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 %sZUIDL)r8 r9 )r rB r r r �uidlY s z POP3.uidlc C s
| j d�S )zITry to enter UTF-8 mode (see RFC 6856). Returns server response.
ZUTF8)r8 )r r r r �utf8e s z POP3.utf8c C st dd� }i }y8| j d�}|d }x |D ]}||�\}}|||< q&W W n* tk
rn } ztd��W Y dd}~X nX |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 S s" | j d�j� }|d |dd � fS )N�asciir r )�decoder? )r Zlstr r r � _parsecapx s z POP3.capa.._parsecapZCAPAr z!-ERR CAPA not supported by serverN)r9 r ) r rY �capsr2 ZrawcapsZcaplineZcapnmZcapargsZ_errr r r �capak s
z POP3.capac C sx t s td��| jrtd��| j� }d|kr2td��|dkrBtj� }| jd�}|j| j| j d�| _| jj
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 missingz$-ERR TLS session already establishedZSTLSz!-ERR STLS not supported by serverN)�server_hostnamer T) �HAVE_SSLr r r[ �ssl�_create_stdlib_contextr8 � wrap_socketr r
r r )r �contextrZ r2 r r r �stls� s
z POP3.stls)N)N)N)'r r r �__doc__r" � POP3_PORTr �_GLOBAL_DEFAULT_TIMEOUTr r r r& r/ r r7 r8 r9 r: r< r= r> rA r6 rC rD rE rF rH rG rM r# �compilerN rS rT rU rV r[ rb r r r r r 2 s@ +
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 k r|d k rt d��|d k r0|d k r0t d��|d k s@|d k rVdd l}|jdtd� || _|| _|d krxtj||d�}|| _t j
| |||� d S )Nz4context and keyfile arguments are mutually exclusivez5context and certfile arguments are mutually exclusiver zAkeyfile and certfile are deprecated, use a custom context insteadr' )�certfile�keyfile) r% �warnings�warn�DeprecationWarningri rh r^ r_ ra r r )r r
r ri rh r ra rj r r r r � s zPOP3_SSL.__init__c C s" t j| |�}| jj|| jd�}|S )N)r\ )r r ra r` r
)r r r r r r r � s
zPOP3_SSL._create_socketc C s t d��dS )z�The method unconditionally raises an exception since the
STLS command doesn't make any sense on an already established
SSL/TLS session.
z$-ERR TLS session already establishedN)r )r ri rh ra r r r rb � s z
POP3_SSL.stls)NNN)
r r r rc �
POP3_SSL_PORTr re r r rb r r r r rg � s
rg �__main__r r' � z Message %d:z z-----------------------)'rc rJ r# r r^ r] � ImportError�__all__� Exceptionr rd rm r- ZLFr r+ r rg r5 r �sys�argv�ar r: r= r> r6 rA ZnumMsgsZ totalSize�range�irC �header�msgr. r rH r r r r � sJ
n0