Роман Сузи - Язык программирования Python
>>> for srv in 'http', 'ftp', 'imap', 'pop3', 'smtp':
... print socket.getservbyname(srv, 'tcp'), srv
...
80 http
21 ftp
143 imap
110 pop3
25 smtp
Модуль также содержит большое количество констант для указания протоколов, типов сокетов, коммуникационных доменов и т.п. Другие функции модуля socket можно при необходимости изучить по документации.
Модуль smtplib
Сообщения электронной почты в Интернете передаются от клиента к серверу и между серверами в основном по протоколу SMTP (Simple Mail Transfer Protocol, простой протокол передачи почты). Протокол SMTP и ESMTP (расширенный вариант SMTP) описаны в RFC 821 и RFC 1869. Для работы с SMTP в стандартной библиотеке модулей имеется модуль smtplib. Для того чтобы начать SMTP–соединение с сервером электронной почты, необходимо в начале создать объект для управления SMTP–сессией с помощью конструктора класса SMTP:
smtplib.SMTP([host[, port]])
Параметры host и port задают адрес и порт SMTP–сервера, через который будет отправляться почта. По умолчанию, port=25. Если host задан, конструктор сам установит соединение, иначе придется отдельно вызывать метод connect(). Экземпляры класса SMTP имеют методы для всех распространенных команд SMTP–протокола, но для отправки почты достаточно вызова конструктора и методов sendmail() и quit():
# -*- coding: cp1251 -*-from smtplib import SMTP
fromaddr = "[email protected]" # От кого
toaddr = "[email protected]" # Кому
message = """From: Student <%(fromaddr)s>
To: Lecturer <%(toaddr)s>
Subject: From Python course student
MIME–Version: 1.0
Content–Type: text/plain; charset=Windows–1251
Content–Transfer–Encoding: 8bit
Здравствуйте! Я изучаю курс по языку Python и
отправляю письмо его автору.
"""
connect = SMTP('mail.onego.ru')
connect.set_debuglevel(1)
connect.sendmail(fromaddr, toaddr, message % vars())
connect.quit()
Следует заметить, что toaddr в сообщении (в поле To) и при отправке могут не совпадать. Дело в том, что получатель и отправитель в ходе SMTP–сессии передается командами SMTP–протокола. При запуске указанного выше примера на экране появится отладочная информация (ведь уровень отладки задан равным 1):
send: 'ehlo rnd.onego.rurn'
reply: '250–mail.onego.ru Hello as3–042.dialup.onego.ru [195.161.147.4], pleased to meet yourn'
send: 'mail FROM:<[email protected]> size=270rn'
reply: '250 2.1.0 <[email protected]>... Sender okrn'
send: 'rcpt TO:<[email protected]>rn'
reply: '250 2.1.5 <[email protected]>... Recipient okrn'
send: 'datarn'
reply: '354 Enter mail, end with "." on a line by itselfrn'
send: 'From: Student <[email protected]>rn ... '
reply: '250 2.0.0 iBPFgQ7q028433 Message accepted for deliveryrn'
send: 'quitrn'
reply: '221 2.0.0 mail.onego.ru closing connectionrn'
Из этой (несколько сокращенной) отладочной информации можно увидеть, что клиент отправляет (send) команды SMTP–серверу (EHLO, MAIL FROM, RCPT TO, DATA, QUIT), а тот выполняет команды и отвечает (reply), возвращая код возврата.
В ходе одной SMTP–сессии можно отправить сразу несколько писем подряд, если не вызывать quit().
В принципе, команды SMTP можно подавать и отдельно: для этого у объекта–соединения есть методы (helo(), ehlo(), expn(), help(), mail(), rcpt(), vrfy(), send(), noop(), data()), соответствующие одноименным командам SMTP–протокола.
Можно задать и произвольную команду SMTP–серверу с помощью метода docmd(). В следующем примере показан простейший сценарий, который могут использовать те, кто время от времени принимает почту на свой сервер по протоколу SMTP от почтового сервера, на котором хранится очередь сообщений для некоторого домена:
from smtplib import SMTP
connect = SMTP('mx.abcde.ru')
connect.set_debuglevel(1)
connect.docmd("ETRN rnd.abcde.ru")
connect.quit()
Этот простенький сценарий предлагает серверу mx.abcde.ru попытаться связаться с основным почтовым сервером домена rnd.abcde.ru и переслать всю накопившуюся для него почту.
При работе с классом smtplib.SMTP могут возбуждаться различные исключения. Назначение некоторых из них приведено ниже:
smtplib.SMTPException
Базовый класс для всех исключений модуля.
smtplib.SMTPServerDisconnected
Сервер неожиданно прервал связь (или связь с сервером не была установлена).
smtplib.SMTPResponseException
Базовый класс для всех исключений, которые имеют код ответа SMTP–сервера.
smtplib.SMTPSenderRefused
Отправитель отвергнут
smtplib.SMTPRecipientsRefused
Все получатели отвергнуты сервером.
smtplib.SMTPDataError
Сервер ответил неизвестным кодом на данные сообщения.
smtplib.SMTPConnectError
Ошибка установления соединения.
smtplib.SMTPHeloError
Сервер не ответил правильно на команду HELO или отверг ее.
Модуль 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 = "n".join(lines)+"nn"
msg = email.message_from_string(msgtxt)
print "* От: %(from)sn* Кому: %(to)sn* Тема: %(subject)sn" % 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
* От: [email protected]
* Кому: [email protected]
* Тема: KL Online Activation
...
+OK Sayonara
Эти и другие методы экземпляров класса POP3 описаны ниже:
Метод Команда POP3 Описание getwelcome() Получает строку s с приветствием POP3–сервера user(name) USER name Посылает команду USER с указанием имени пользователя name. Возвращает строку с ответом сервера pass_(pwd) PASS pwd Отправляет пароль пользователя в команде PASS. После этой команды и до выполнения команды QUIT почтовый ящик блокируется apop(user, secret) APOP user secret Идентификация на сервере по APOP rpop(user) RPOP user Идентификация по методу RPOP stat() STAT Возвращает кортеж с информацией о почтовом ящике. В нем m — количество сообщений, l — размер почтового ящика в байтах list([num]) LIST [num] Возвращает список сообщений в формате (resp, ['num octets', ...]), если не указан num, и «+OK num octets», если указан. Список lst состоит из строк в формате «num octets». retr(num) RETR num Загружает с сервера сообщение с номером num и возвращает кортеж с ответом сервера (resp, lst, octets) dele(num) DELE num Удаляет сообщение с номером num rset() RSET Отменяет пометки удаления сообщений noop() NOOP Ничего не делает (поддерживает соединение) quit() QUIT Отключение от сервера. Сервер выполняет все необходимые изменения (удаляет сообщения) и снимает блокировку почтового ящика top(num, lines) TOP num lines Команда аналогична RETR, но загружает только заголовок и lines строк тела сообщения. Возвращает кортеж (resp, lst, octets) uidl([num]) UIDL [num] Сокращение от «unique–id listing» (список уникальных идентификаторов сообщений). Формат результата: (resp, lst, octets), если num не указан, и «+OK num uniqid», если указан. Список lst состоит из строк вида «+OK num uniqid»В этой таблице num обозначает номер сообщения (он не меняется на протяжении всей сессии), resp — ответ сервера, возвращается для любой команды, начинается с «+OK » для успешных операций (при неудаче возбуждается исключение poplib.proto_error). Параметр octets обозначает количество байт в принятых данных. uniqid — идентификатор сообщения, генерируемый сервером.
