Модуль poplib

Еще один протокол — POP3 (Post Office Protocol, почтовый протокол) — служит для приема почты из почтового ящика на сервере (протокол определен в RFC 1725).

Для работы с почтовым сервером требуется установить с ним соединение и, подобно рассмотренному выше примеру, с помощью SMTP–команд получить требуемые сообщения. Объект–соединение POP3 можно установить посредством конструктора класса POP3 из модуля poplib:

poplib.POP3(host[, port])

Где host — адрес POP3–сервера, port — порт на сервере (по умолчанию 110), pop_obj — объект для управления сеансом работы с POP3–сервером.

Следующий пример демонстрирует основные методы для работы с POP3–соединением:

import poplib, email

# Учетные данные пользователя:

SERVER = "pop.server.com"

USERNAME = "user"

USERPASSWORD = "secretword"

p = poplib.POP3(SERVER)

print p.getwelcome()

# этап идентификации

print p.user(USERNAME)

print p.pass_(USERPASSWORD)

# этап транзакций

response, lst, octets = p.list()

print response

for msgnum, msgsize in [i.split() for i in lst]:

 print "Сообщение %(msgnum)s имеет длину %(msgsize)s" % vars()

 print "UIDL =", p.uidl(int(msgnum)).split()[2]

 if int(msgsize) > 32000:

  (resp, lines, octets) = p.top(msgnum, 0)

 else:

  (resp, lines, octets) = p.retr(msgnum)

 msgtxt = " ".join(lines)+" "

 msg = email.message_from_string(msgtxt)

 print "* От: %(from)s * Кому: %(to)s * Тема: %(subject)s " % msg

 # msg содержит заголовки сообщения или все сообщение (если оно небольшое)

# этап обновления

print p.quit()

Примечание:

Разумеется, чтобы пример сработал корректно, необходимо внести реальные учетные данные.

При выполнении сценарий выведет на экран примерно следующее.

+OK POP3 pop.server.com server ready

+OK User name accepted, password please

+OK Mailbox open, 68 messages

+OK Mailbox scan listing follows

Сообщение 1 имеет длину 4202

UIDL = 4152a47e00000004

* От: online@kaspersky.com

* Кому: user@server.com

* Тема: KL Online Activation

...

+OK Sayonara

Эти и другие методы экземпляров класса POP3 описаны ниже:

В этой таблице num обозначает номер сообщения (он не меняется на протяжении всей сессии), resp — ответ сервера, возвращается для любой команды, начинается с «+OK » для успешных операций (при неудаче возбуждается исключение poplib.proto_error). Параметр octets обозначает количество байт в принятых данных. uniqid — идентификатор сообщения, генерируемый сервером.

Работа с POP3–сервером состоит из трех фаз: идентификации, транзакций и обновления. На этапе идентификации сразу после создания POP3–объекта разрешены только команды USER, PASS (иногда APOP и RPOP). После идентификации сервер получает информацию о пользователе и наступает этап транзакций. Здесь уместны остальные команды. Этап обновления вызывается командой QUIT, после которой POP3–сервер обновляет почтовый ящик пользователя в соответствии с поданными командами, а именно — удаляет помеченные для удаления сообщения.