diff -r 70f21691b0e1 -r 6364f8b0656b app/soc/logic/mail_dispatcher.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/app/soc/logic/mail_dispatcher.py Sun Nov 16 12:48:23 2008 +0000 @@ -0,0 +1,118 @@ +#!/usr/bin/python2.5 +# +# Copyright 2008 the Melange authors. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""Functions used to send email messages. + +The following are the possible fields of an email message: + + sender: The email address of the sender, the From address. This must be the + email address of a registered administrator for the application, or the + address of the current signed-in user. Administrators can be added to + an application using the Administration Console. The current user's email + address can be determined with the Users API. + to: A recipient's email address (a string) or a list of email addresses to + appear on the To: line in the message header. + cc: A recipient's email address (a string) or a list of email addresses to + appear on the Cc: line in the message header. + bcc: A recipient's email address (a string) or a list of email addresses to + receive the message, but not appear in the message header ("blind carbon + copy"). + reply_to: An email address to which a recipient should reply instead of the + sender address, the Reply-To: field. + subject: The subject of the message, the Subject: line. + body: The plaintext body content of the message. + html: An HTML version of the body content, for recipients that + prefer HTML email. + attachments: The file attachments for the message, as a list of two-value + tuples, one tuple for each attachment. Each tuple contains a filename as + the first element, and the file contents as the second element. + An attachment file must be one of the allowed file types, and the + filename must end with an extension that corresponds with the type. + For a list of allowed types and filename extensions, see Allowed + Attachment Types. + +Usage: + + context = { 'sender': 'melange-noreply@foo.com', + 'to': 'bob@bar.com', + 'subject': 'You have been invited to become a Host', + 'sender_name': 'Alice', + 'to_name': 'Melange Team', + 'role': 'Host', + 'group': 'Google Summer of Code 2009', + 'invitation_url': 'http://invitation-url'} + + sendMailUsingTemplate('soc/mail/invitation.html', context) +""" + +__authors__ = [ + '"Lennard de Rijk" ', + '"Pawel Solyga"