This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
.. image:: web/static/logo.png

An application to maintain a mailing list, send bulk mails.


* PostgreSQL 9.2 with contrib and Python
* Python 2.6 or 3.3 with standart library
* Psycopg2 2.5
* Flask 0.10


All configuration parameters are optional. PostgreSQL connection parameters can be given as environment variables
via libpg. See for the list.

Flesk configuration parameters can be given as environment variables with FLESK_ prefix. See for the default ones.

A seperate PostgreSQL database is required. The scripts under the db/ directory should be executed in order.
db/003-emailHash.sql includes the hash function for user URL's. Is is better to change the secrets in it, before.
Executing only the new scripts should be sufficient for upgrading. All of the scripts can be executed in order like

cat db/* | psql

There are seperate web servers. One of them is for users to redirect, unsubscribe... One is a RESTful API for
other applications. Other one is for administrators to list emails, send new ones... They both can be run directly::




Email messages are send and received asynchronously. Executables under worker/ directory should be run periodically,
to process the messages waiting to be sent or received. Command line arguments of the executables will be listed by::

worker/ --help

worker/ --help

Running standalone web servers is intended for debugging only. See deployment page of the Flask documentation [1]
to run them in production. There are example configurations under the conf/ directory for Nginx and uWSGI. Also,
there is a test script under the test/ directory.



This tool is released under the ISC License, whose text is included to the
source files. The ISC License is registered with and approved by the
Open Source Initiative [1].


Coding Style

In PostgreSQL, relation names are case-insensitive when they are not in double quotes. PostgreSQL returns
them in lower-case. That is why column names, which will be keys of the dictionaries, are lower-case. This
rule should be kept even the dictionary is not return from the database, for convenience. HTML forms are
also mapped to dictionaries. Input names on the forms should also be lower-case as they will be the keys
of the dictionaries.

Known Issues

Duplicate headers of the response reports are not saved to the database.


Version 1.0

* Improve database schema using more composite keys
* Make the infrastructure suitable to not bulk emails
* Add authorization to the API
* Allow adding subscribers via admin panel
* Support IMAP4 SSL
* Process DMARC reports
Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

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