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, и когда present передает его в 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, это будет объект bytes.

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

почтовые опции:

список всех полученных параметров для команды 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. Сообщения будут отброшены и выведены на стандартный вывод.

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

Создайте новый объект 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 одновременно.

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

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

smtp_server¶

Содержит SMTPServer, который породил этот канал.

conn¶

Содержит объект сокета, подключающийся к клиенту.

addr¶

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

received_lines¶

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

smtp_state¶

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

seen_greeting¶

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

mailfrom¶

Содержит строку, содержащую адрес, указанный в строке «ПОЧТА ОТ:» от клиента.

rcpttos¶

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

received_data¶

Содержит строку, содержащую все данные, отправленные клиентом во время состояния ДАННЫХ, вплоть до конечного "\r\n.\r\n", но не включая его.

fqdn¶

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

peer¶

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

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