Skip to main content

Use your Email-account as Storage for data structures and files

Project description


Build Status License: GPL v3 Documentation Status

Use your Email-account as Storage for data structures and files

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system. Have a look at the documentation.

Introducing notes

  • Before reaching version 1.0, the storage layout may change when updating


python3.5 or later. It should work Python3.4+ but tests are running on 2.7, 3.5 and 3.7.

This project makes use of the following libraries:

  • IMAPClient - easy-to-use, Pythonic and complete IMAP client library.
  • lxml - the most feature-rich and easy-to-use library for processing XML and HTML in the Python language


You can install the latest release from pip:

pip install imap-storage

Short example

from imap_storage import Account, Config

config = Config()
config.imap.user = ''
config.imap.password = '123' = ''  # config.imap.port default is 993

account = Account(config, 1)
directory =
email = directory.new_email('Your_first_item')
email.add_item('TestMessage', text='Your first message')

Running the tests

Rename '' in tests directory to '' and include your e-mail account for testing. Then run this inside root directory:

python -m unittest  # tests all
python -m unittest tests.test_account  # tests only account

or run it with coverage:

coverage run --source='imap_storage' -m unittest && coverage report -m --skip-covered

And coding style tests

Code style is not finished, mostly because of missing docstrings.

pylint imap_storage


This library is not ready to be deployed productive


Please read for details on our code of conduct, and the process for submitting pull requests to us.


We use SemVer for versioning. During beta development minor versions may be incompatible, too.


See also the list of contributors who participated in this project.


This project is licensed under the GNU General Public License v3.0 - see the file for details

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for imap-storage, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size imap_storage-0.2.1-py2.py3-none-any.whl (39.0 kB) File type Wheel Python version py2.py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page