iro/offer/smtp.py
author Sandro Knauß <knauss@netzguerilla.net>
Fri, 10 Aug 2012 14:42:26 +0200
branchdevel
changeset 291 84eb5a7a715a
parent 269 0d134b173cb1
child 294 0e75bd39767d
permissions -rw-r--r--
start licensing

# -*- coding: utf-8 -*-

import smtplib
import copy
from functools import partial

from ..validate import vInteger, vEmail,vBool
from ..model.status import Status
from ..config import Option
from .provider import Provider, providers

class SMTP(Provider):
    """A SMTP Provider to send emails.
    This Provider has only one typ ``"mail"`` and one route ``None``. 
    
    If :attr:`~iro.offer.provider.Provider.testmode` is **True** no mail will be send, only a connection is created to server.

    """
    def __init__(self, name):
        options = [
                ("host", Option(lambda x,y: x, long="Hostname of MTA", must=True)),
                ("port", Option(partial(vInteger,minv=0),long="Port of the MTA", default=25)),
                ("user", Option(lambda x,y: x, long="username to login into MTA.",default="")),
                ("password", Option(lambda x,y: x, long="password to login into MTA.",default="")),
                ("SSL", Option(vBool,long="use SSL for connection to MTA", default=False)),
                ("TLS", Option(vBool,long="use TLS for connection to MTA", default=False)),
                ("send_from", Option(vEmail,long="Emailaddress from which mail will be sended.",must=True)),
                ]
        Provider.__init__(self,name,{"mail":[None]},options)

    def send(self, recipient, mail):   
        """sends a mail to recipient
        
        :param string recipient: A valid email address.
        :param `iro.model.message.Mail` mail: Mail to send.
        :return: 
            - All went ok -- :class:`iro.model.status.Status` object
            - otherwise -- an exception
        """
        if not self.testmode:
            if self.SSL:
                smtp = smtplib.SMTP_SSL(self.host,self.port)
            else:
                smtp = smtplib.SMTP(self.host,self.port)
            
            if self.TLS:
                smtp.starttls()
           
            if not self.user == "":
                smtp.login(self.user,self.password)
        try:
            frm=self.send_from
            
            if mail.getFrom():
                frm = mail.getFrom()
            
            tmpmail=copy.deepcopy(mail)
            tmpmail.content['From'] = frm 
            tmpmail.content['To'] = recipient
            if not self.testmode:
                smtp.sendmail(frm,  recipient, tmpmail.as_string())
            return Status(self, None)
        finally:
            smtp.quit()

    def getSendFunc(self, typ, route):
        """returns :meth:`send` method, if typ and route is valid."""

        Provider.getSendFunc(self, typ, route)
        return self.send

providers["smtp"]=SMTP