from imap_tools import MailBox, Q

# get list of email subjects from INBOX folder
with MailBox('imap.mail.com').login('[email protected]', 'password') as mailbox:
    subjects = [msg.subject for msg in mailbox.fetch()]

# get list of email subjects from INBOX folder - verbose version
mailbox = MailBox('imap.mail.com')
mailbox.login('[email protected]', 'password', initial_folder='INBOX')
subjects = [msg.subject for msg in mailbox.fetch(Q(all=True))]
mailbox.logout()

for message in mailbox.fetch():
    message.uid              # str or None: '123'
    message.subject          # str: 'some subject'
    message.from_            # str: '[email protected]'
    message.to               # tuple: ('[email protected]', '[email protected]', )
    message.cc               # tuple: ('[email protected]', )
    message.bcc              # tuple: ('[email protected]', )
    message.reply_to         # tuple: ('[email protected]', )
    message.date             # datetime.datetime: 1900-1-1 for unparsed, may be naive or with tzinfo
    message.date_str         # str: original date - 'Tue, 03 Jan 2017 22:26:59 +0500'
    message.text             # str: 'hi'
    message.html             # str: '<b>hi</b>'
    message.flags            # tuple: ('SEEN', 'FLAGGED', 'ENCRYPTED')
    message.headers          # dict: {'Received': ('from 1.m.ru', 'from 2.m.ru'), 'AntiVirus': ('Clean',)}

    for att in message.attachments:  # list: [Attachment objects]
        att.filename         # str: 'cat.jpg'
        att.content_type     # str: 'image/jpeg'
        att.payload          # bytes: b'\xff\xd8\xff\xe0\'

    message.obj              # email.message.Message: original object
    message.from_values      # dict or None: {'email': '[email protected]', 'name': 'Van', 'full': 'Van <[email protected]>'}
    message.to_values        # tuple: ({'email': '', 'name': '', 'full': ''},)
    message.cc_values        # tuple: ({'email': '', 'name': '', 'full': ''},)
    message.bcc_values       # tuple: ({'email': '', 'name': '', 'full': ''},)
    message.reply_to_values  # tuple: ({'email': '', 'name': '', 'full': ''},)

from imap_tools import Q, AND, OR, NOT

mailbox.fetch(Q(subject='weather'))  # query, the str-like object - see below
mailbox.fetch('TEXT "hello"')  # str, use charset arg for non US-ASCII chars
mailbox.fetch(b'TEXT "\xd1\x8f"')  # bytes, charset arg is ignored

from imap_tools import Q, AND, OR, NOT
# AND
Q(text='hello', new=True)  # '(TEXT "hello" NEW)'
# OR
OR(text='hello', date=datetime.date(2000, 3, 15))  # '(OR TEXT "hello" ON 15-Mar-2000)'
# NOT
NOT(text='hello', new=True)  # 'NOT (TEXT "hello" NEW)'
# complex
Q(OR(from_='[email protected]', text='"the text"'), NOT(OR(Q(answered=False), Q(new=True))), to='[email protected]')
# encoding
mailbox.fetch(Q(subject='привет'), charset='utf8')  # 'привет' will be encoded by MailBox._criteria_encoder
# python note: you can't do: Q(text='two', NOT(subject='one'))
Q(NOT(subject='one'), text='two')  # use kwargs after logic classes

with MailBox('imap.mail.com').login('[email protected]', 'pwd', initial_folder='INBOX') as mailbox:

    # COPY all messages from current folder to folder1, *by one
    for msg in mailbox.fetch():
        res = mailbox.copy(msg.uid, 'INBOX/folder1')

    # MOVE all messages from current folder to folder2, *in bulk (implicit creation of uid list)
    mailbox.move(mailbox.fetch(), 'INBOX/folder2')

    # DELETE all messages from current folder, *in bulk (explicit creation of uid list)
    mailbox.delete([msg.uid for msg in mailbox.fetch()])

    # FLAG unseen messages in current folder as Answered and Flagged, *in bulk.
    flags = (imap_tools.MessageFlags.ANSWERED, imap_tools.MessageFlags.FLAGGED)
    mailbox.flag(mailbox.fetch('(UNSEEN)'), flags, True)

    # SEEN: mark all messages sent at 05.03.2007 in current folder as unseen, *in bulk
    mailbox.seen(mailbox.fetch("SENTON 05-Mar-2007"), False)

with MailBox('imap.mail.com').login('[email protected]', 'pwd') as mailbox:
    # LIST
    for folder_info in mailbox.folder.list('INBOX'):
        print(folder_info)  # {'name': 'INBOX|cats', 'delim': '|', 'flags': '\\Unmarked \\HasChildren'}
    # SET
    mailbox.folder.set('INBOX')
    # GET
    current_folder = mailbox.folder.get()
    # CREATE
    mailbox.folder.create('folder1')
    # EXISTS
    is_exists = mailbox.folder.exists('folder1')
    # RENAME
    mailbox.folder.rename('folder1', 'folder2')
    # DELETE
    mailbox.folder.delete('folder2')
    # STATUS
    folder_status = mailbox.folder.status('some_folder')
    print(folder_status)  # {'MESSAGES': 41, 'RECENT': 0, 'UIDNEXT': 11996, 'UIDVALIDITY': 1, 'UNSEEN': 5}