===============
 Email Handler
===============

The :term:`email handler` is responsible for email messages; it can:

* generate a message by rendering a template
* inject sender/recipients based on config
* deliver message to SMTP server

The base class and default email handler is
:class:`wuttjamaican.email.EmailHandler`.

The :term:`app handler` is responsible for creating the email handler
via :meth:`~wuttjamaican.app.AppHandler.get_email_handler()`::

   app = config.get_app()
   email = app.get_email_handler()