
======
Baruwa
======
Baruwa (swahili for letter or mail) is a mailwatch http://mailwatch.sf.net/ inspired 
web 2.0 MailScanner http://www.mailscanner.info/ front-end. 

It provides an easy to use interface for users to view details of messages processed by 
MailScanner as well as perform operations such as releasing quarantined messages, 
spam learning,whitelisting and blacklisting addresses etc. Baruwa has implemented web 2.0 
features (AJAX) where deemed fit, graphing is also implemented on the client side using SVG.

It also provides reporting functionality with an easy to use query builder, results can be 
displayed as message lists or graphed as colorful and pretty graphs. The goal of the initial 
version will be to address the various quarks that exist in mailwatch at the moment. Baruwa 
will initially be a drop in replacement for mailwatch, future releases will however break 
compatibility with mailwatch. This enables easing of end users in to the new interface.

Baruwa is written in Python is released under the GPLv2

========
Features
========
    + AJAX refreshed recent messages listing
    + Detailed message view with AJAX enabled message processing (quarantine release/delete,spam learning,white/black listing)
    + AJAX powered Full/Quarantine messages listings
    + Reporting view with AJAX enabled query builder
    + Interactive SVG graphs
    + Multi user profiles
    + User profile aware white/blacklist management
    + REST API
    + Easy plug-in authentication to external authentication systems (LDAP,SQL,etc)
    + Works both with and without Javascript enabled (some features will have degraded performance)

===========
Screenshots
===========
Slideshow http://www.flickr.com/photos/kissandrew/sets/72157623453063688/show/

============
Requirements
============
    + Python >= 2.4
    + Django >= 1.1.1
    + MySQLdb >= 1.2.1p2
    + GeoIP
    + iPy
    + Apache httpd & mod_wsgi | mod_python (mod_wsgi recommended)

============
Installation
============
Baruwa is installed in the usual way::

    python setup install

