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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
|
===========
LMTP server
===========
Mailman can accept messages via LMTP (RFC 2033). Most modern mail servers
support LMTP local delivery, so this is a very portable way to connect Mailman
with your mail server.
Our LMTP server is fairly simple though; all it does is make sure that the
message is destined for a valid endpoint, e.g. ``mylist-join@example.com``,
that the message bytes can be parsed into a message object, and that the
message has a `Message-ID` header.
Let's start a testable LMTP runner.
>>> from mailman.testing import helpers
>>> master = helpers.TestableMaster()
>>> master.start('lmtp')
It also helps to have a nice LMTP client.
>>> lmtp = helpers.get_lmtp_client()
(220, b'... GNU Mailman LMTP runner 2.0')
>>> lmtp.lhlo('remote.example.org')
(250, ...)
Posting address
===============
Once the mailing list is created, the posting address is valid, and messages
can be sent to the list.
::
>>> create_list('mylist@example.com')
<mailing list "mylist@example.com" at ...>
>>> transaction.commit()
>>> lmtp.sendmail(
... 'anne.person@example.com',
... ['mylist@example.com'], """\
... From: anne.person@example.com
... To: mylist@example.com
... Subject: An interesting message
... Message-ID: <badger>
...
... This is an interesting message.
... """)
{}
Since the message itself is valid, it gets parsed and lands in the incoming
queue.
>>> from mailman.testing.helpers import get_queue_messages
>>> messages = get_queue_messages('in')
>>> len(messages)
1
>>> print(messages[0].msg.as_string())
From: anne.person@example.com
To: mylist@example.com
Subject: An interesting message
Message-ID: <badger>
Message-ID-Hash: JYMZWSQ4IC2JPKK7ZUONRFRVC4ZYJGKJ
X-Message-ID-Hash: JYMZWSQ4IC2JPKK7ZUONRFRVC4ZYJGKJ
X-MailFrom: anne.person@example.com
<BLANKLINE>
This is an interesting message.
>>> dump_msgdata(messages[0].msgdata)
_parsemsg : False
listid : mylist.example.com
original_size: ...
to_list : True
version : ...
Sub-addresses
=============
The LMTP server understands each of the list's sub-addreses, such as `-join`,
`-leave`, `-request` and so on. The message is accepted if posted to a valid
sub-address.
>>> lmtp.sendmail(
... 'anne.person@example.com',
... ['mylist-request@example.com'], """\
... From: anne.person@example.com
... To: mylist-request@example.com
... Subject: Help
... Message-ID: <dog>
...
... Please help me.
... """)
{}
Request subaddress
------------------
Depending on the subaddress, there is a message in the appropriate queue for
later processing. For example, all `-request` messages are put into the
command queue for processing.
>>> messages = get_queue_messages('command')
>>> len(messages)
1
>>> print(messages[0].msg.as_string())
From: anne.person@example.com
To: mylist-request@example.com
Subject: Help
Message-ID: <dog>
Message-ID-Hash: 4SKREUSPI62BHDMFBSOZ3BMXFETSQHNA
X-Message-ID-Hash: 4SKREUSPI62BHDMFBSOZ3BMXFETSQHNA
X-MailFrom: anne.person@example.com
<BLANKLINE>
Please help me.
>>> dump_msgdata(messages[0].msgdata)
_parsemsg : False
listid : mylist.example.com
original_size: ...
subaddress : request
version : ...
Bounce processor
----------------
A message to the `-bounces` address goes to the bounce processor.
>>> lmtp.sendmail(
... 'mail-daemon@example.com',
... ['mylist-bounces@example.com'], """\
... From: mail-daemon@example.com
... To: mylist-bounces@example.com
... Subject: A bounce
... Message-ID: <elephant>
...
... Bouncy bouncy.
... """)
{}
>>> messages = get_queue_messages('bounces')
>>> len(messages)
1
>>> dump_msgdata(messages[0].msgdata)
_parsemsg : False
listid : mylist.example.com
original_size: ...
subaddress : bounces
version : ...
Command processor
-----------------
Confirmation messages go to the command processor...
>>> lmtp.sendmail(
... 'anne.person@example.com',
... ['mylist-confirm@example.com'], """\
... From: anne.person@example.com
... To: mylist-confirm@example.com
... Subject: A bounce
... Message-ID: <falcon>
...
... confirm 123
... """)
{}
>>> messages = get_queue_messages('command')
>>> len(messages)
1
>>> dump_msgdata(messages[0].msgdata)
_parsemsg : False
listid : mylist.example.com
original_size: ...
subaddress : confirm
version : ...
...as do join messages...
::
>>> lmtp.sendmail(
... 'anne.person@example.com',
... ['mylist-join@example.com'], """\
... From: anne.person@example.com
... To: mylist-join@example.com
... Message-ID: <giraffe>
...
... """)
{}
>>> messages = get_queue_messages('command')
>>> len(messages)
1
>>> dump_msgdata(messages[0].msgdata)
_parsemsg : False
listid : mylist.example.com
original_size: ...
subaddress : join
version : ...
>>> lmtp.sendmail(
... 'anne.person@example.com',
... ['mylist-subscribe@example.com'], """\
... From: anne.person@example.com
... To: mylist-subscribe@example.com
... Message-ID: <hippopotamus>
...
... """)
{}
>>> messages = get_queue_messages('command')
>>> len(messages)
1
>>> dump_msgdata(messages[0].msgdata)
_parsemsg : False
listid : mylist.example.com
original_size: ...
subaddress : join
version : ...
...and leave messages.
::
>>> lmtp.sendmail(
... 'anne.person@example.com',
... ['mylist-leave@example.com'], """\
... From: anne.person@example.com
... To: mylist-leave@example.com
... Message-ID: <iguana>
...
... """)
{}
>>> messages = get_queue_messages('command')
>>> len(messages)
1
>>> dump_msgdata(messages[0].msgdata)
_parsemsg : False
listid : mylist.example.com
original_size: ...
subaddress : leave
version : ...
>>> lmtp.sendmail(
... 'anne.person@example.com',
... ['mylist-unsubscribe@example.com'], """\
... From: anne.person@example.com
... To: mylist-unsubscribe@example.com
... Message-ID: <jackal>
...
... """)
{}
>>> messages = get_queue_messages('command')
>>> len(messages)
1
>>> dump_msgdata(messages[0].msgdata)
_parsemsg : False
listid : mylist.example.com
original_size: ...
subaddress : leave
version : ...
Incoming processor
------------------
Messages to the `-owner` address also go to the incoming processor.
>>> lmtp.sendmail(
... 'anne.person@example.com',
... ['mylist-owner@example.com'], """\
... From: anne.person@example.com
... To: mylist-owner@example.com
... Message-ID: <kangaroo>
...
... """)
{}
>>> messages = get_queue_messages('in')
>>> len(messages)
1
>>> dump_msgdata(messages[0].msgdata)
_parsemsg : False
envsender : noreply@example.com
listid : mylist.example.com
original_size: ...
subaddress : owner
to_owner : True
version : ...
.. Clean up
>>> master.stop()
|
