$ Id $

This folder contains scripts & other files for testing emails sent by Origo.

You'll need several things for email-testing to work:

- Intercept Outgoing Email
  You need to intercept the emails sent by Origo, e.g. by the test-suite. 
  For this you have to properly configure your test server's MTA. You'll find an
  example configuration file for exim in the folder "etc". This file defines an
  exim "system filter" that all emails are passed to.

- Email Filter
  By defining an email filter, you can conditionnaly pass emails to external
  programs instead of delivering them. The folder "etc" contains the file
  "filter" which is tuned to the email-testsuite. All emails to addresses used 
  by the test-suite (see "test.sql" for the actual values) are sent to the
  script "process_test_mail.py"

- Process emails
  The script "process_test_mail" will read & parse incoming emails and store
  them in the table "mail" in the test-database. This will allow the test-suite
  to extract values from it, and compare it to expected values.


Common Pitfalls:

- Paths & Permissions
  Pay special attention to all involved paths and file-permissions. Logfiles
  (in /var/log/aranea/) have to be writable by the user executing the
  test-suite!