Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

An interface to iredadmin

Project Description

# iRedAdmin API

A programmer friendly interface for iRedAdmin (OSE version)

# Known Limitations

  • Only supports MD5 passwords
  • Only supports MySQL

# Getting Started

  1. $ virtualenv -p $(which python2.7) venv
  2. $ source venv/bin/activate
  3. (venv)$ python develop

# Usage

Before you can start making API calls, you must initialize a connection to the database back end you wish to manage.

To do so simply call the init_db method with a SQLAlchemy database URL. If you’re unclear on how to create one, see:


import mailapi

mailapi.domain.get_all_domains() # throws a RuntimeError

mailapi.init_db(‘mysql://scott:tiger@’) # Initialize the db connection

mailapi.domain.get_all_domains() # works!

# Need Help?

I suggest you look at the test cases in ./tests as they illustrate how this package should be used and the expected outcomes.

# Running Unit Test Suite


(venv)$ TEST_DB_CONN_STR=’mysql://scott:tiger@’ python test

# I Need Feature x, y, z

Lol, fork me bro

# 0.1.8

  • sorts mailboxes by username

# 0.1.7

  • Custom exception class definitions
    • They are mostly self-explanatory, but here is the break down:
      • AliasExists: raised when trying to create an alias that already exists in the database
      • DbInitError: raised when init_db has not been called
      • MailboxExists: raised when adding a mailbox that already exists in the database
      • NoSuchMailbox: raised when trying to access a mailbox that does not exist in the database
      • DomainExists: raised when trying to create a domain that already exists
      • NoSuchDomain: raised when trying to access a domain that does not exist in the database

# 0.1.6

  • bookkeeping fixes:
    • populates created and modified date fields when adding a mailbox
    • populates modified and lastpasswordchange fields when resetting password

# 0.1.5

  • fixes issue where the all aliases were not deleted when deleting a mailbox

# 0.1.4

  • mailbox search
  • reset mailbox password
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
MailApi-0.1.8.tar.gz (12.9 kB) Copy SHA256 Checksum SHA256 Source Dec 4, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting