mailpipe: flesh out InvalidMessage attributes before raising exceptions.

This tacks on all the interesting attribute data which the function
that originally raised the exception may not have known about.  We
want this metadata in all cases, not just those where we are
constructing a response message.

mailpipe: fix InvalidHandlerMessage error message construction.

`target` is an explicit argument, not in `**kwargs`.

I also removed the InvalidHandlerMessage error logging, because we're
raising an exception.  The calling function can log the exception if
it catches it.  If it doesn't, the user will see the message in the
traceback.

handler: add InvalidMessage.message_id convenience method.

test:mail-in: add example emails for manual testing.

color: add ColoredFormatter for more transparent coloring.

This way we don't have to pass use_color around all over the place.

mailpipe|handler: with the Response framework, handlers don't need `original`.

mailpipe: replace `respond` callback with exceptions.

Now mailpipe sub-functions will raise Response or InvalidMessage when
they want to respond to the incoming email.  This takes advantage of
Python's exception handling to avoid passing the `respond` callback
all over the place.  It also allows us consolidate error message
construction in `_get_error_response`, which will lead to both simpler
program logic and more consistent response messages.

Other changes to make this cleaner:

* Renamed functions in pygrader.email:
    _construct_email -> construct_email
    construct_email -> construct_text_email
* Pulled _get_assignment out of submission.run.

handler:get: add `get` handler for grade requests.

handler:submission: fix non-lowercase subject assignment matching.

Also accept (and ignore) unrecognized keyword arguments in run().
This will allow interoperability with other handlers which may take
other arguments.

template: add targets argument to construct_student_email.

README: elaborate on grade file format and mailpipe processing.

handler:submission: add doctest to run().

template: remove extra blank lines from construct student email.

By fixing STUDENT_TEMPLATE to remove blank lines due to grades without
comments.

Also remove NORMALIZE_WHITESPACE from template doctests, which had
been there to match tabs (doctest expands hard tab characters to
spaces using 8-column tab stops).  However, with NORMALIZE_WHITESPACE
it was impossible to test for extra blank lines.

mailpipe: clarify the source of missing `Return-Path` (bad email)

mailpipe: add .authenticated attribute to _get_verified_message results.

This will allow message handlers to easily determine if the message
they're processing is from an authenticated user.

mailpipe: add support for multi-part subjects in _get_message_subject.

mailpipe|handler: split mailpipe's submission handler into its own module.

Now you must use a tag target (e.g. `[submit]`) in your email header
to let mailpipe know which handler you want processing your email.
With the new setup, we can easily add additional handlers (e.g. for
grade requests).

mailpipe: split initial _parse_message processing into sub-functions.

New functions:

* _get_message_person_and_subject  (which calls the others internally)
* _get_message_person
* _get_decoded_message
* _get_message_subject

With the previous implementation, all the inline error handling was
making the intended logic of _parse_message difficult to follow.

mailpipe: update doctests now that I'm using GnuPG v2.0.19.

setup.py: explicitly list Python 3.2 and 3.3 as supported.

Bump to version 0.2.

Add MANIFEST.in to distribute COPYING.

Add --respond option to pg.py's mailpipe command.

Finish mailpipe respond() doctests.

Also:
* Add course.name configuration to README example.
* Standardize course.name examples on the more formal `Physics 101`.
* Standardize robot nickname examples on `phys-101 robot`.

Document course.robot and assignment.submittable in the README.

Reject attempted submissions for unsubmittable assignments in mailpipe.

This implements the expected behaviour for the option created by:

  commit 80639ff31b3bc6780659f526d518526cf63fcaec
  Author: W. Trevor King <wking@tremily.us>
  Date:   Tue Apr 24 16:48:56 2012 -0400

    Add Assignment.submittable attribute to configure student submission.

Initial `respond` implementation in the `mailpipe` module.

Add Assignment.submittable attribute to configure student submission.

If `Assignment.submittable` is `True`, mailpipe will accept student
submissions for that assignment.  However, there may also be
assignments where you don't want to accept direct submissions
(e.g. attendance and written, in-class exams).  For these assignments,
you should leave the `submittable` option at its default `False`
value.

Note that `mailpipe` doesn't use this value yet (implementation coming
soon).

pgp_mime.pgp.verify() no longer needs deepcopy().

Since the pgp-mime commit:

  commit 49802119d7846c7ffd6d72a46068aff014361b59
  Author: W. Trevor King <wking@tremily.us>
  Date:   Tue Apr 24 16:01:17 2012 -0400

    Always return a new Message instance from pgp.verify().

Add Course.robot attribute (for automatic email generation).

I'm getting things set up to send automatic responses when mailpipe
processes incoming email, which means someone's going to have to be
signing that email for security.  Since you probably don't want to
leave your secret PGP key on the mailserver, you can now setup a new
(and less important) PGP key for each course.  The Course.robot is
just a Person instance to hold that key and an appropriate nickname.

If you want to use your own key when you call pg.py from the command
line, you can always setup a shell alias.  In Bash:

  alias pg.py='/usr/bin/pg.py --author="John Doe"'

Pull _construct_email out of construct_email and add construct_response.

_construct_email() handles general tasks for setting up the main email
header.  construct_email() combines this with a simple text/plain body,
while construct_response() uses a multipart/mixed format suitable for
sending message receipts to users.

Fix Built -> Build typo in construct_email docstring.

Add docstring and doctest to message_time().

Add Course.name attribute (for clearer email generation).

Add mailpipe doctests and allow saving from stream to an output maildir.

Add pygrader.test.course for managing testing course directories.

Add pygrader.test with asyncore SMTP client/server implemenations.

This should make it easier to build integration tests for `mailpipe()`.

Remove myself as the hardcoded default sender.

Use the first assistant instead, since they are the most likely person
to be running this database.

Always sign/encrypt outgoing email in construct_email().

Remove the `sign` option.  If you've configured pgp_keys for the
correspondents, it's because you want to use them.

This commit also ensures that the sender is also encluded on the
recipient list for encryption, although there is currently no copy of
the email forwarded to the sender.

Update to use pgp-mime v0.3

Change my email address from drexel.edu to tremily.us.

Oops, missed some pygrade -> pygrader updates in model/course.py.

Log the gpg_message in mailpipe._get_verified_message instead of printing it.

Fix storage.load_person doctest typo (actually print the PGP key).

Add AUTHORS to .gitignore (generated by update-copyright.py).

Remove fingerprint stuff from the README (waiting on a GPGME agent).

Fix link to Alex's pygrade in the README.

Oops, missed some pygrade -> pygrader updates in setup.py.

Mention update-copyright in the README.

Ran update-copyright.py.

Begin versioning!  (better late than never)