PyMailService 0.0.2

The library allows you to view, receive, and send emails.

PyMailService

Библиотека позволяет просматривать, получать и отправлять электронные письма

Фактически, класс является оберткой для imaplib и smtplib, позволяющий упростить их использование

Для начала работы, Вам нужно:

• почтовый ящик, к которому возможно подключиться через imap ssl и smtp ssl
• логин и пароль, от данного ящика
• знать imap и smtp сервер (например у яндека: imap.yandex.ru и smtp.yandex.ru, соответственно)
• знать imap и smtp порты (например у яндекса: 993 и 465 соответственно)

Пример создания обьекта класса:

    post = EmailsPost(
        email_login=LOGIN_EMAIL,
        email_password=PASSWORD_EMAIL,
        imap_server="imap.yandex.ru",
        smtp_server="smtp.yandex.ru",
        imap_port=993,
        smtp_port=465,
    )

После инициализации, необходимо явно подключиться к почте:

    check = post.connect()
    if check is True:
        print("success")
    else:
        print(check)

В случае успешного подключения, метод возвращает True, в противном случае, кортеж вида:

(False, error(b'[AUTHENTICATIONFAILED] LOGIN invalid credentials or IMAP is disabled sc=cDdQwR5MouQ0_051313_imap-production-468'))

Большинство методов, обернуто в декоратор, вида:

def reconnect_decorator(func):
    def wrapper(*args, **kwargs):
        try:
            return func(*args, **kwargs)
        except Exception as e:
            args[0].connect()
            return func(*args, **kwargs)
    return wrapper

В связи с этим, скрипт попытается создать или восстановить соединение, в случае если вы забыли сделать это явно, или в случае его отключения

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

post.select_folders("inbox")

по умолчанию, задана папка "inbox", поэтому вызов выше, будет аналогичен вызову: post.select_folders()

Узнать наименования папок или их наличие можно вызовом:

folders: tuple[str, list[bytes]] = post.get_folders()

Пример возвращаемого значения:

('OK', [b'(\\HasChildren \\Marked \\Drafts) "|" Drafts', b'(\\HasNoChildren \\Unmarked \\Templates) "|" "Drafts|template"', b'(\\HasNoChildren \\Marked \\NoInferiors) "|" INBOX', b'(\\HasNoChildren \\Unmarked) "|" Outbox', b'(\\HasNoChildren \\Marked \\Sent) "|" Sent', b'(\\HasNoChildren \\Unmarked \\Junk) "|" Spam', b'(\\HasNoChildren \\Marked \\Trash) "|" Trash'])

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

post.update_email(fltr="UNSEEN")

по умолчанию, задан фильтр "UNSEEN", поэтому вызов выше, будет аналогичен вызову:

post.update_email()

Данный вызов получит запишет в переменную self.list_uid_email uid всех непрочитанных сообщений в данной папке

Получить электронное письмо возможно следующим вызовом:

email = post.get_email(uid)

uid можно получить:

uid = post.get_uid_last_email()

Данный способ возвращает uid последнего письма или 0, в случае их отсутствия