data_email_client

data_email_client is a Python package for downloading data files from emails using the imap protocol (SSL-compatible)

installation

pip install data_email_client

examples

see script docstrings for more usage info.

spidar data files:

>>> from data_email_client import mailer
>>> from getpass import getpass
>>> server = 'outlook.office365.com' # 'imap.gmail.com' for gmail
>>> username = 'data-email@my-domain.com'
>>> password = getpass()
...
>>> imap = mailer(server=server, username=username, password=password)
>>> data_boxes = [m for m in imap.mailboxes if 'data' in m]
>>> imap.search_for_messages(text='spidardatanotification@nrgsystems.com', area='from', folder=data_boxes)
>>> imap.download_attachments(out_dir='/path/to/data/', extension='csv', delete=False)

symphonie data emails

...
>>> body_text = 'SymphoniePRO Logger data attached.' # 'Wind Data attached.' for older logger types
>>> imap = mailer(server=server, username=username, password=password)
>>> data_boxes = [m for m in imap.mailboxes if 'data' in m]
>>> imap.search_for_messages(text=body_text, area='body', folder=data_boxes)
>>> imap.download_attachments(
        out_dir='/path/to/data/', 
        extension='rld', 
        delete=False, 
        archive_folder='INBOX/Archive'
    )