1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
# Copyright (C) 2009-2014 by the Free Software Foundation, Inc.
#
# This file is part of GNU Mailman.
#
# GNU Mailman is free software: you can redistribute it and/or modify it under
# the terms of the GNU General Public License as published by the Free
# Software Foundation, either version 3 of the License, or (at your option)
# any later version.
#
# GNU Mailman is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
# more details.
#
# You should have received a copy of the GNU General Public License along with
# GNU Mailman. If not, see <http://www.gnu.org/licenses/>.
"""Interface for mail transport agent integration."""
from __future__ import absolute_import, unicode_literals
__metaclass__ = type
__all__ = [
'IMailTransportAgentAliases',
'IMailTransportAgentDelivery',
'IMailTransportAgentLifecycle',
]
from zope.interface import Interface
from mailman.core.errors import MailmanError
class SomeRecipientsFailed(MailmanError):
"""Delivery to some or all recipients failed"""
def __init__(self, temporary_failures, permanent_failures):
super(SomeRecipientsFailed, self).__init__()
self.temporary_failures = temporary_failures
self.permanent_failures = permanent_failures
class IMailTransportAgentAliases(Interface):
"""Interface to the MTA utility for generating all the aliases."""
def aliases(mlist):
"""Generate all the aliases for the mailing list.
This method is a generator. The posting address will be returned
first, followed by the rest of the aliases in alphabetical order.
:param mlist: The mailing list.
:type mlist: An `IMailingList` or an object with `list_name`,
`mail_host`, and `posting_address` attributes.
:return: The set of fully qualified common aliases for the mailing
list.
:rtype: string
"""
def destinations(mlist):
"""Generate just the local parts for the mailing list aliases.
This method is a generator. The posting address will be returned
first, followed by the rest of the aliases in alphabetical order.
:param mlist: The mailing list.
:type mlist: An `IMailingList` or an object with a `list_name`
attribute.
:return: The set of short (i.e. without the @dom.ain part) common
aliases for the mailing list.
:rtype: string
"""
class IMailTransportAgentLifecycle(Interface):
"""Interface to the MTA for creating and deleting a mailing list."""
def create(mlist):
"""Tell the MTA that the mailing list was created."""
def delete(mlist):
"""Tell the MTA that the mailing list was deleted."""
def regenerate(directory=None):
"""Regenerate the full aliases file.
:param directory: The directory to write the MTA specific support
files to. Defaults to $DATA_DIR.
:type directory: string
"""
class IMailTransportAgentDelivery(Interface):
"""Interface to the MTA delivery strategies."""
def deliver(mlist, msg, msgdata):
"""Deliver a message to a mailing list's recipients.
Ordinarily the mailing list is consulted for delivery specifics,
however the message metadata dictionary can contain additional
directions to control delivery. Specifics are left to the
implementation, but there are a few common keys:
* envelope_sender - the email address of the RFC 2821 envelope sender;
* decorated - a flag indicating whether the message has been decorated
with headers and footers yet;
* recipients - the set of all recipients who should receive this
message, as a set of email addresses;
:param mlist: The mailing list being delivered to.
:type mlist: `IMailingList`
:param msg: The original message being delivered.
:type msg: `Message`
:param msgdata: Additional message metadata for this delivery.
:type msgdata: dictionary
:return: delivery failures as defined by `smtplib.SMTP.sendmail`
:rtype: dictionary
"""
|
