from datetime import datetime
from os import makedirs
from os.path import exists
from os.path import join
from random import sample
import smtplib
from pyramid.settings import asbool
from pyramid.settings import aslist
from repoze.sendmail.mailer import SMTPMailer
from repoze.sendmail.mailer import SendmailMailer
from repoze.sendmail.delivery import DirectMailDelivery
from repoze.sendmail.delivery import QueuedMailDelivery
import transaction
from pyramid_mailer._compat import SMTP_SSL
def _check_bind_options(kw):
"""Check keyword options passed to dummy mailer ``.bind`` method
for plausibility.
Performs the same checks that :method:`Mailer.bind` does.
"""
valid_options = ('default_sender', 'transaction_manager')
invalid_options = set(kw.keys()).difference(valid_options)
if invalid_options:
raise ValueError(
'invalid options: %s' % ', '.join(sorted(invalid_options)))
class DebugMailer(object):
""" Debug mailer for testing
Stores messages as files in the specified directory.
"""
def __init__(self, top_level_directory, include_bcc=False):
if not exists(top_level_directory):
makedirs(top_level_directory)
self.tld = top_level_directory
self.include_bcc = include_bcc
@classmethod
def from_settings(cls, settings, prefix='mail.'):
"""Create a new instance of 'DebugMailer' from settings dict.
:param settings: a settings dict-like
:param prefix: prefix separating 'pyramid_mailer' settings
"""
settings = settings or {}
top_level_directory = settings.get(prefix+'top_level_directory')
if top_level_directory is None:
raise ValueError("DebugMailer: must specify "
"'%stop_level_directory'" % prefix)
include_bcc = settings.get(prefix+'debug_include_bcc', False)
return cls(top_level_directory, include_bcc)
def bind(self, **kw):
"""Get mailer with the same server configuration but with
different delivery options.
This method returns ``self``, and is, essentially a no-op, but
is included for API compatibility with :class:`Mailer`.
:param default_sender: default "from" address
:param transaction_manager: a transaction manager to join with when
sending transactional emails
"""
_check_bind_options(kw)
return self
def _send(self, message, fail_silently=False):
"""Save message to a file for debugging
"""
seeds = '1234567890qwertyuiopasdfghjklzxcvbnm'
file_part1 = datetime.now().strftime('%Y%m%d%H%M%S')
file_part2 = ''.join(sample(seeds, 4))
filename = join(self.tld, '%s_%s.eml' % (file_part1, file_part2))
if self.include_bcc:
message.extra_headers['Bcc'] = ', '.join(message.bcc)
with open(filename, 'w') as fd:
if not message.sender:
message.sender = 'nobody'
fd.write(str(message.to_message()))
send = _send
send_immediately = _send
send_to_queue = _send
send_sendmail = _send
send_immediately_sendmail = _send
[docs]class DummyMailer(object):
"""Dummy mailer instance, used for example in unit tests.
Sent messages are appended to 'outbox' list.
Queued messages are appended to 'queue' list.
"""
def __init__(self):
self.outbox = []
self.queue = []
[docs] def bind(self, **kw):
"""Get mailer with the same server configuration but with
different delivery options.
This method returns ``self``, and is, essentially a no-op, but
is included for API compatibility with :class:`Mailer`.
:param default_sender: default "from" address
:param transaction_manager: a transaction manager to join with when
sending transactional emails
"""
_check_bind_options(kw)
return self
[docs] def send(self, message):
"""Mock sending a transactional message via SMTP.
The message is appended to the 'outbox' list.
:param message: a 'Message' instance.
"""
self.outbox.append(message)
[docs] def send_to_queue(self, message):
"""Mock sending to a maildir queue.
The message is appended to the 'queue' list.
:param message: a 'Message' instance.
"""
self.queue.append(message)
[docs] def send_sendmail(self, message ):
"""Mock sending a transactional message via sendmail.
The message is added to the 'outbox' list.
:param message: a 'Message' instance.
"""
self.outbox.append(message)
class SMTP_SSLMailer(SMTPMailer):
"""Subclass of SMTPMailer enabling SSL.
"""
smtp = SMTP_SSL
def __init__(self, *args, **kwargs):
self.keyfile = kwargs.pop('keyfile', None)
self.certfile = kwargs.pop('certfile', None)
super(SMTP_SSLMailer, self).__init__(*args, **kwargs)
def smtp_factory(self):
if self.smtp is None:
raise RuntimeError(
'No SMTP_SSL support in Python usable by mailer')
connection = self.smtp(
self.hostname,
str(self.port),
keyfile=self.keyfile,
certfile=self.certfile
)
connection.set_debuglevel(self.debug_smtp)
return connection
[docs]class Mailer(object):
"""Manages sending of email messages.
:param host: SMTP hostname
:param port: SMTP port
:param username: SMTP username
:param password: SMPT password
:param tls: use TLS
:param ssl: use SSL
:param keyfile: SSL key file
:param certfile: SSL certificate file
:param queue_path: path to maildir for queued messages
:param default_sender: default "from" address
:param sendmail_app: path to "sendmail" binary.
repoze defaults to "/usr/sbin/sendmail"
:param sendmail_template: custom commandline template for sendmail binary,
defaults to'["{sendmail_app}", "-t", "-i", "-f", "{sender}"]'
:param transaction_manager: a transaction manager to join with when
sending transactional emails
:param debug: SMTP debug level
"""
def __init__(self, **kw):
smtp_mailer = kw.pop('smtp_mailer', None)
if smtp_mailer is None:
host = kw.pop('host', 'localhost')
port = kw.pop('port', 25)
username = kw.pop('username', None)
password = kw.pop('password', None)
tls = kw.pop('tls', False)
ssl = kw.pop('ssl', False)
keyfile = kw.pop('keyfile', None)
certfile = kw.pop('certfile', None)
debug = kw.pop('debug', 0)
if ssl:
smtp_mailer = SMTP_SSLMailer(
hostname=host,
port=port,
username=username,
password=password,
no_tls=not(tls),
force_tls=tls,
debug_smtp=debug,
keyfile=keyfile,
certfile=certfile)
else:
smtp_mailer = SMTPMailer(
hostname=host,
port=port,
username=username,
password=password,
no_tls=not(tls),
force_tls=tls,
debug_smtp=debug)
self.smtp_mailer = smtp_mailer
sendmail_mailer = kw.pop('sendmail_mailer', None)
if sendmail_mailer is None:
sendmail_mailer = SendmailMailer(
kw.pop('sendmail_app', None),
kw.pop('sendmail_template', None),
)
self.sendmail_mailer = sendmail_mailer
self.queue_path = kw.pop('queue_path', None)
self.default_sender = kw.pop('default_sender', None)
transaction_manager = kw.pop('transaction_manager', None)
if transaction_manager is None:
transaction_manager = transaction.manager
self.transaction_manager = transaction_manager
if kw:
raise ValueError(
'invalid options: %s' % ', '.join(sorted(kw.keys())))
self.direct_delivery = DirectMailDelivery(
self.smtp_mailer, transaction_manager=transaction_manager)
if self.queue_path:
self.queue_delivery = QueuedMailDelivery(
self.queue_path, transaction_manager=transaction_manager)
else:
self.queue_delivery = None
self.sendmail_delivery = DirectMailDelivery(
self.sendmail_mailer, transaction_manager=transaction_manager)
[docs] @classmethod
def from_settings(cls, settings, prefix='mail.'):
"""Create a new instance of 'Mailer' from settings dict.
:param settings: a settings dict-like
:param prefix: prefix separating 'pyramid_mailer' settings
"""
settings = settings or {}
kwarg_names = [prefix + k for k in (
'host', 'port', 'username',
'password', 'tls', 'ssl', 'keyfile',
'certfile', 'queue_path', 'debug', 'default_sender',
'sendmail_app', 'sendmail_template')]
size = len(prefix)
kwargs = dict(((k[size:], settings[k]) for k in settings.keys() if
k in kwarg_names))
for key in ('tls', 'ssl'):
val = kwargs.get(key)
if val:
kwargs[key] = asbool(val)
for key in ('debug', 'port'):
val = kwargs.get(key)
if val:
kwargs[key] = int(val)
# list values
for key in ('sendmail_template', ):
if key in kwargs:
kwargs[key] = aslist(kwargs.get(key))
username = kwargs.pop('username', None)
password = kwargs.pop('password', None)
if not (username or password):
# Setting both username and password to the empty string,
# causes repoze.sendmail.mailer.SMTPMailer to authenticate.
# This most likely makes no sense, so, in that case
# set username to None to skip authentication.
username = password = None
return cls(username=username, password=password, **kwargs)
[docs] def bind(self, **kw):
"""Create a new mailer with the same server configuration but with
different delivery options.
:param default_sender: default "from" address
:param transaction_manager: a transaction manager to join with when
sending transactional emails
"""
_check_bind_options(kw)
default_sender = kw.get('default_sender', self.default_sender)
transaction_manager = kw.get(
'transaction_manager', self.transaction_manager)
return self.__class__(
smtp_mailer=self.smtp_mailer,
sendmail_mailer=self.sendmail_mailer,
queue_path=self.queue_path,
default_sender=default_sender,
transaction_manager=transaction_manager,
)
[docs] def send(self, message):
"""Send a message.
The message is handled inside a transaction, so in case of failure
(or the message fails) the message will not be sent.
:param message: a 'Message' instance.
"""
return self.direct_delivery.send(*self._message_args(message))
[docs] def send_to_queue(self, message):
"""Add a message to a maildir queue.
In order to handle this, the setting 'mail.queue_path' must be
provided and must point to a valid maildir.
:param message: a 'Message' instance.
"""
if not self.queue_delivery:
raise RuntimeError("No queue_path provided")
return self.queue_delivery.send(*self._message_args(message))
def _message_args(self, message):
message.sender = message.sender or self.default_sender
# convert Lamson message to Python email package message
msg = message.to_message()
return (message.sender, message.send_to, msg)
[docs] def send_sendmail(self, message ):
"""Send a message within the transaction manager.
Uses the local sendmail option
:param message: a 'Message' instance.
"""
return self.sendmail_delivery.send(*self._message_args(message))