skip to navigation
skip to content

easyimap 0.3.2

Simple imap wrapper.

Latest Version: 0.6.3

About this module

Simple imap wrapper.

Example to use

connect function create IMAP4_SSL instance:

>>> import easyimap
>>> host = ""
>>> user = ""
>>> password = "hogehogehogehoge"
>>> mailbox = "secret"
>>> imapper = easyimap.connect(host, user, password, mailbox)

This imapper can list up latest n mail by listup method:

>>> imapper.listup(2)
[(80, <easyimap.easyimap.MailObj object at 0x...>), (79, <easyimap.easyimap.MailObj object at 0x...)]
>>> [(id1, mail1), (id2, mail2)] = imapper.listup(2)
>>> id1
>>> mail1
<easyimap.easyimap.MailObj object at 0x...>
>>> type(mail1.body)
<type 'unicode'>
>>> type(mail1.title)
<type 'unicode'>
>>> type(
<type 'unicode'>
>>> type(mail1.sender)
<type 'unicode'>

You can check latest unseen mail by unseen method:

>>> imapper.unseen(2)
[(82, <easyimap.easyimap.MailObj object at 0x...>), (81, <easyimap.easyimap.MailObj object at 0x...)]

You can directly fetch email object with specific id:

>>> imapper.mail(80)
<easyimap.easyimap.MailObj object at 0x...>

You can download attachments:

>>> imapper.mail(80)
>>> (id, mail) = imapper.mail(80)
>>> for attachment in mail.attachment:
>>>     print attachment[0], attachment[1]

Finally, call quit method:

>>> imapper.quit()

Basic API

  • easyimap.connect(host, user, password, mailbox=’INBOX’, timeout=15)

    Create IMAP4_SSL wrapper.


  • listup(limit=10)

    Returns list of tuples(email_id, mail_object).

  • unseen(limit=10)

    Returns list of typles(email_id, mail_object).

  • mail(id)

    Returns MailObj.

  • change_mailbox(mailbox)

    Change mailbox.

  • quit

    Close and Logout.


  • title

    Returns string of ‘Subject’ header.

  • sender

    Returns string of ‘From’ header.

  • date

    Returns string of ‘Date’ header.

  • body

    Returns string of Body.

  • contenttype

    Returns string of ‘Content-Type’ header.

  • contenttransferencoding

    Returns string of ‘Content-Transfer-Encoding’ header.

  • references

    Returns string of ‘References’ header.

  • inrepplyto

    Returns string of ‘In-Reply-To’ header.

  • repplyto

    Returns string of ‘Reply-To’ header.

  • returnpath

    Returns string of ‘Return-Path’ header.

  • mimeversion

    Returns string of ‘MIME-Version’ header.

  • messageid

    Returns string of ‘Message-ID’ header.

  • attachments

    Returns list of tuples(‘attached file name’, MailObj).

File Type Py Version Uploaded on Size
easyimap-0.3.2.tar.gz (md5) Source 2012-12-05 4KB (md5) Source 2012-12-05 8KB