smtpd — SMTP-сервер¶

Создайте новый объект SMTPServer, который привязывается к локальному адресу localaddr. Он будет рассматривать remoteaddr как восходящий SMTP ретранслятор. И localaddr, и remoteaddr должны быть кортежем (host, port). Объект наследуется от asyncore.dispatcher, и поэтому будет вставляться в цикл событий asyncore при инстанцировании.

data_size_limit определяет максимальное количество байт, которое будет принято в команде DATA. Значение None или 0 означает отсутствие ограничения.

map - карта сокетов, используемая для соединений (изначально пустой словарь является подходящим значением). Если не указано, используется глобальная карта сокетов asyncore.

enable_SMTPUTF8 определяет, должно ли быть включено расширение SMTPUTF8 (как определено в RFC 6531). По умолчанию используется False. Когда True, SMTPUTF8 принимается как параметр к команде MAIL и, когда присутствует, передается в process_message() в списке kwargs['mail_options']. decode_data и enable_SMTPUTF8 не могут быть одновременно установлены в True.

decode_data указывает, должна ли часть данных транзакции SMTP декодироваться с использованием UTF-8. Когда decode_data равно False (по умолчанию), сервер рекламирует расширение 8BITMIME (RFC 6152), принимает параметр BODY=8BITMIME к команде MAIL и, когда он присутствует, передает его process_message() в списке kwargs['mail_options']. decode_data и enable_SMTPUTF8 не могут быть одновременно установлены в True.

process_message(peer, mailfrom, rcpttos, data, **kwargs)¶

Вызвать исключение NotImplementedError. Переопределите это в подклассах, чтобы сделать что-нибудь полезное с этим сообщением. Все, что было передано в конструкторе как remoteaddr, будет доступно в качестве атрибута _remoteaddr. peer - адрес удаленного узла, mailfrom - отправитель конверта, rcpttos - получатели конверта и data - строка, содержащая содержимое письма (которое должно быть в формате RFC 5321).

Если ключевое слово конструктора decode_data установлено в True, аргумент data будет строкой юникода. Если он имеет значение False, то это будет объект байтов.

kwargs - это словарь, содержащий дополнительную информацию. Он пуст, если в качестве аргумента init было передано decode_data=True, в противном случае он содержит следующие ключи:

mail_options:

список всех полученных параметров команды MAIL (элементы являются строками в верхнем регистре; пример: ['BODY=8BITMIME', 'SMTPUTF8']).

rcpt_options:

то же самое, что и mail_options, но для команды RCPT. В настоящее время опции RCPT TO не поддерживаются, поэтому пока это всегда будет пустой список.

Реализации process_message должны использовать сигнатуру **kwargs для приема произвольных аргументов ключевых слов, поскольку будущие усовершенствования функций могут добавить ключи в словарь kwargs.

Верните None для запроса обычного ответа 250 Ok; в противном случае верните желаемую строку ответа в формате RFC 5321.

channel_class¶

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

Создайте новый отладочный сервер. Аргументы в соответствии с SMTPServer. Сообщения будут отброшены и выведены на stdout.

Создайте новый чистый прокси-сервер. Аргументы в соответствии с SMTPServer. Все будет передаваться на remoteaddr. Обратите внимание, что при запуске этой программы велика вероятность превратить вас в открытый ретранслятор, поэтому будьте осторожны.

Создайте новый чистый прокси-сервер. Аргументы в соответствии с SMTPServer. Все будет передаваться на remoteaddr, если только локальные конфигурации mailman не знают об адресе, в этом случае он будет обрабатываться через mailman. Обратите внимание, что выполнение этой команды имеет все шансы сделать вас открытым ретранслятором, поэтому будьте осторожны.

Создайте новый объект SMTPChannel, который управляет взаимодействием между сервером и одним SMTP-клиентом.

conn и addr соответствуют переменным экземпляра, описанным ниже.

data_size_limit определяет максимальное количество байт, которое будет принято в команде DATA. Значение None или 0 означает отсутствие ограничения.

enable_SMTPUTF8 определяет, должно ли быть включено расширение SMTPUTF8 (как определено в RFC 6531). По умолчанию используется False. decode_data и enable_SMTPUTF8 не могут быть одновременно установлены в True.

Словарь может быть указан в map, чтобы избежать использования глобальной карты сокетов.

decode_data указывает, должна ли часть данных транзакции SMTP декодироваться с использованием UTF-8. По умолчанию False. decode_data и enable_SMTPUTF8 не могут быть одновременно установлены в True.

Чтобы использовать пользовательскую реализацию SMTPChannel, необходимо переопределить SMTPServer.channel_class вашего SMTPServer.

SMTPChannel имеет следующие переменные экземпляра:

smtp_server¶

Хранит SMTPServer, породивший этот канал.

conn¶

Хранит объект сокета, соединяющегося с клиентом.

addr¶

Удерживает адрес клиента, второе значение, возвращаемое socket.accept

received_lines¶

Хранит список строк (декодированных с помощью UTF-8), полученных от клиента. Строки имеют окончание строки "\r\n", переведенное в "\n".

smtp_state¶

Удерживает текущее состояние канала. Это будет либо COMMAND изначально, либо DATA после того, как клиент отправит строку «DATA».

seen_greeting¶

Содержит строку, содержащую приветствие, отправленное клиентом в сообщении «HELO».

mailfrom¶

Держит строку, содержащую адрес, указанный в строке «MAIL FROM:» от клиента.

rcpttos¶

Держит список строк, содержащих адреса, определенные в строках «RCPT TO:» от клиента.

received_data¶

Хранит строку, содержащую все данные, отправленные клиентом во время состояния DATA, вплоть до завершающего "\r\n.\r\n", но не включая его.

fqdn¶

Удерживает полное доменное имя сервера, возвращенное командой socket.getfqdn().

peer¶

Удерживает имя клиентского пира, как возвращено conn.getpeername(), где conn - conn.

Класс SMTPChannel работает путем вызова методов с именем smtp_<command> при получении командной строки от клиента. В базовый класс SMTPChannel встроены методы для обработки следующих команд (и реагирования на них соответствующим образом):