blob: e462fe34f77e025ee1d6a7377fa9008115455713 [file] [log] [blame]
Fred Drake0aaed272000-10-23 13:39:15 +00001import os
Thomas Wouters00ee7ba2006-08-21 19:07:27 +00002import sys
Fred Drakec02bc3e2001-05-21 20:23:21 +00003import time
Thomas Wouters477c8d52006-05-27 19:21:47 +00004import stat
5import socket
6import email
Thomas Woutersb2137042007-02-01 18:02:27 +00007import email.message
Thomas Wouters477c8d52006-05-27 19:21:47 +00008import re
Guido van Rossum34d19282007-08-09 01:03:29 +00009import io
R. David Murrayb7deff12011-01-30 06:21:28 +000010import tempfile
Benjamin Petersonee8712c2008-05-20 21:35:26 +000011from test import support
Thomas Wouters477c8d52006-05-27 19:21:47 +000012import unittest
R. David Murrayb7deff12011-01-30 06:21:28 +000013import textwrap
Thomas Wouters477c8d52006-05-27 19:21:47 +000014import mailbox
15import glob
Guido van Rossum75ebb292001-04-10 15:01:20 +000016try:
Thomas Wouters477c8d52006-05-27 19:21:47 +000017 import fcntl
18except ImportError:
Guido van Rossum75ebb292001-04-10 15:01:20 +000019 pass
20
Thomas Wouters477c8d52006-05-27 19:21:47 +000021
22class TestBase(unittest.TestCase):
23
24 def _check_sample(self, msg):
25 # Inspect a mailbox.Message representation of the sample message
Ezio Melottie9615932010-01-24 19:26:24 +000026 self.assertIsInstance(msg, email.message.Message)
27 self.assertIsInstance(msg, mailbox.Message)
Guido van Rossumcc2b0162007-02-11 06:12:03 +000028 for key, value in _sample_headers.items():
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +000029 self.assertIn(value, msg.get_all(key))
Benjamin Petersonc9c0f202009-06-30 23:06:06 +000030 self.assertTrue(msg.is_multipart())
Guido van Rossume61fd5b2007-07-11 12:20:59 +000031 self.assertEqual(len(msg.get_payload()), len(_sample_payloads))
Thomas Wouters477c8d52006-05-27 19:21:47 +000032 for i, payload in enumerate(_sample_payloads):
33 part = msg.get_payload(i)
Ezio Melottie9615932010-01-24 19:26:24 +000034 self.assertIsInstance(part, email.message.Message)
35 self.assertNotIsInstance(part, mailbox.Message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +000036 self.assertEqual(part.get_payload(), payload)
Thomas Wouters477c8d52006-05-27 19:21:47 +000037
38 def _delete_recursively(self, target):
39 # Delete a file or delete a directory recursively
40 if os.path.isdir(target):
41 for path, dirs, files in os.walk(target, topdown=False):
42 for name in files:
43 os.remove(os.path.join(path, name))
44 for name in dirs:
45 os.rmdir(os.path.join(path, name))
46 os.rmdir(target)
47 elif os.path.exists(target):
48 os.remove(target)
49
50
51class TestMailbox(TestBase):
52
R. David Murrayb7deff12011-01-30 06:21:28 +000053 maxDiff = None
54
Thomas Wouters477c8d52006-05-27 19:21:47 +000055 _factory = None # Overridden by subclasses to reuse tests
56 _template = 'From: foo\n\n%s'
57
58 def setUp(self):
Benjamin Petersonee8712c2008-05-20 21:35:26 +000059 self._path = support.TESTFN
Guido van Rossumd8faa362007-04-27 19:54:29 +000060 self._delete_recursively(self._path)
Thomas Wouters477c8d52006-05-27 19:21:47 +000061 self._box = self._factory(self._path)
62
63 def tearDown(self):
Guido van Rossumc12a8132007-10-26 04:29:23 +000064 self._box.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +000065 self._delete_recursively(self._path)
66
67 def test_add(self):
68 # Add copies of a sample message
69 keys = []
70 keys.append(self._box.add(self._template % 0))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000071 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +000072 keys.append(self._box.add(mailbox.Message(_sample_message)))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000073 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +000074 keys.append(self._box.add(email.message_from_string(_sample_message)))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000075 self.assertEqual(len(self._box), 3)
R. David Murrayb7deff12011-01-30 06:21:28 +000076 keys.append(self._box.add(io.BytesIO(_bytes_sample_message)))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000077 self.assertEqual(len(self._box), 4)
Thomas Wouters477c8d52006-05-27 19:21:47 +000078 keys.append(self._box.add(_sample_message))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000079 self.assertEqual(len(self._box), 5)
R. David Murrayb7deff12011-01-30 06:21:28 +000080 keys.append(self._box.add(_bytes_sample_message))
81 self.assertEqual(len(self._box), 6)
82 with self.assertWarns(DeprecationWarning):
83 keys.append(self._box.add(
84 io.TextIOWrapper(io.BytesIO(_bytes_sample_message))))
85 self.assertEqual(len(self._box), 7)
Guido van Rossumea834472007-07-27 05:17:50 +000086 self.assertEqual(self._box.get_string(keys[0]), self._template % 0)
R. David Murrayb7deff12011-01-30 06:21:28 +000087 for i in (1, 2, 3, 4, 5, 6):
Thomas Wouters477c8d52006-05-27 19:21:47 +000088 self._check_sample(self._box[keys[i]])
89
R. David Murrayb7deff12011-01-30 06:21:28 +000090 _nonascii_msg = textwrap.dedent("""\
91 From: foo
92 Subject: Falinaptár házhozszállítással. Már rendeltél?
93
94 0
95 """)
96
97 def test_add_invalid_8bit_bytes_header(self):
Marc-André Lemburg8f36af72011-02-25 15:42:01 +000098 key = self._box.add(self._nonascii_msg.encode('latin-1'))
R. David Murrayb7deff12011-01-30 06:21:28 +000099 self.assertEqual(len(self._box), 1)
100 self.assertEqual(self._box.get_bytes(key),
Marc-André Lemburg8f36af72011-02-25 15:42:01 +0000101 self._nonascii_msg.encode('latin-1'))
R. David Murrayb7deff12011-01-30 06:21:28 +0000102
103 def test_invalid_nonascii_header_as_string(self):
104 subj = self._nonascii_msg.splitlines()[1]
Marc-André Lemburg8f36af72011-02-25 15:42:01 +0000105 key = self._box.add(subj.encode('latin-1'))
R. David Murrayb7deff12011-01-30 06:21:28 +0000106 self.assertEqual(self._box.get_string(key),
107 'Subject: =?unknown-8bit?b?RmFsaW5hcHThciBo4Xpob3pzeuFsbO104XNz'
108 'YWwuIE3hciByZW5kZWx06Ww/?=\n\n')
109
R. David Murrayfc141142011-02-11 22:47:17 +0000110 def test_add_nonascii_string_header_raises(self):
R. David Murrayb7deff12011-01-30 06:21:28 +0000111 with self.assertRaisesRegex(ValueError, "ASCII-only"):
112 self._box.add(self._nonascii_msg)
R. David Murrayfc141142011-02-11 22:47:17 +0000113 self._box.flush()
114 self.assertEqual(len(self._box), 0)
115 self.assertMailboxEmpty()
116
117 def test_add_that_raises_leaves_mailbox_empty(self):
118 # XXX This test will start failing when Message learns to handle
119 # non-ASCII string headers, and a different internal failure will
120 # need to be found or manufactured.
121 with self.assertRaises(ValueError):
122 self._box.add(email.message_from_string("From: Alphöso"))
123 self.assertEqual(len(self._box), 0)
124 self._box.close()
125 self.assertMailboxEmpty()
R. David Murrayb7deff12011-01-30 06:21:28 +0000126
127 _non_latin_bin_msg = textwrap.dedent("""\
128 From: foo@bar.com
129 To: báz
130 Subject: Maintenant je vous présente mon collègue, le pouf célèbre
131 \tJean de Baddie
132 Mime-Version: 1.0
133 Content-Type: text/plain; charset="utf-8"
134 Content-Transfer-Encoding: 8bit
135
136 Да, они летят.
137 """).encode('utf-8')
138
139 def test_add_8bit_body(self):
140 key = self._box.add(self._non_latin_bin_msg)
141 self.assertEqual(self._box.get_bytes(key),
142 self._non_latin_bin_msg)
143 with self._box.get_file(key) as f:
144 self.assertEqual(f.read(),
145 self._non_latin_bin_msg.replace(b'\n',
146 os.linesep.encode()))
147 self.assertEqual(self._box[key].get_payload(),
148 "Да, они летят.\n")
149
150 def test_add_binary_file(self):
151 with tempfile.TemporaryFile('wb+') as f:
152 f.write(_bytes_sample_message)
153 f.seek(0)
154 key = self._box.add(f)
155 # See issue 11062
156 if not isinstance(self._box, mailbox.Babyl):
157 self.assertEqual(self._box.get_bytes(key).split(b'\n'),
158 _bytes_sample_message.split(b'\n'))
159
160 def test_add_binary_nonascii_file(self):
161 with tempfile.TemporaryFile('wb+') as f:
162 f.write(self._non_latin_bin_msg)
163 f.seek(0)
164 key = self._box.add(f)
165 # See issue 11062
166 if not isinstance(self._box, mailbox.Babyl):
167 self.assertEqual(self._box.get_bytes(key).split(b'\n'),
168 self._non_latin_bin_msg.split(b'\n'))
169
170 def test_add_text_file_warns(self):
171 with tempfile.TemporaryFile('w+') as f:
172 f.write(_sample_message)
173 f.seek(0)
174 with self.assertWarns(DeprecationWarning):
175 key = self._box.add(f)
176 # See issue 11062
177 if not isinstance(self._box, mailbox.Babyl):
178 self.assertEqual(self._box.get_bytes(key).split(b'\n'),
179 _bytes_sample_message.split(b'\n'))
180
181 def test_add_StringIO_warns(self):
182 with self.assertWarns(DeprecationWarning):
183 key = self._box.add(io.StringIO(self._template % "0"))
184 self.assertEqual(self._box.get_string(key), self._template % "0")
185
186 def test_add_nonascii_StringIO_raises(self):
187 with self.assertWarns(DeprecationWarning):
188 with self.assertRaisesRegex(ValueError, "ASCII-only"):
189 self._box.add(io.StringIO(self._nonascii_msg))
R. David Murrayfc141142011-02-11 22:47:17 +0000190 self.assertEqual(len(self._box), 0)
191 self._box.close()
192 self.assertMailboxEmpty()
R. David Murrayb7deff12011-01-30 06:21:28 +0000193
Thomas Wouters477c8d52006-05-27 19:21:47 +0000194 def test_remove(self):
195 # Remove messages using remove()
196 self._test_remove_or_delitem(self._box.remove)
197
198 def test_delitem(self):
199 # Remove messages using __delitem__()
200 self._test_remove_or_delitem(self._box.__delitem__)
201
202 def _test_remove_or_delitem(self, method):
203 # (Used by test_remove() and test_delitem().)
204 key0 = self._box.add(self._template % 0)
205 key1 = self._box.add(self._template % 1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000206 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000207 method(key0)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000208 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000209 self.assertRaises(KeyError, lambda: self._box[key0])
210 self.assertRaises(KeyError, lambda: method(key0))
Guido van Rossumea834472007-07-27 05:17:50 +0000211 self.assertEqual(self._box.get_string(key1), self._template % 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000212 key2 = self._box.add(self._template % 2)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000213 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000214 method(key2)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000215 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000216 self.assertRaises(KeyError, lambda: self._box[key2])
217 self.assertRaises(KeyError, lambda: method(key2))
Guido van Rossumea834472007-07-27 05:17:50 +0000218 self.assertEqual(self._box.get_string(key1), self._template % 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000219 method(key1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000220 self.assertEqual(len(self._box), 0)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000221 self.assertRaises(KeyError, lambda: self._box[key1])
222 self.assertRaises(KeyError, lambda: method(key1))
223
224 def test_discard(self, repetitions=10):
225 # Discard messages
226 key0 = self._box.add(self._template % 0)
227 key1 = self._box.add(self._template % 1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000228 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000229 self._box.discard(key0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000230 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000231 self.assertRaises(KeyError, lambda: self._box[key0])
232 self._box.discard(key0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000233 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000234 self.assertRaises(KeyError, lambda: self._box[key0])
235
236 def test_get(self):
237 # Retrieve messages using get()
238 key0 = self._box.add(self._template % 0)
239 msg = self._box.get(key0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000240 self.assertEqual(msg['from'], 'foo')
241 self.assertEqual(msg.get_payload(), '0')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000242 self.assertIs(self._box.get('foo'), None)
243 self.assertIs(self._box.get('foo', False), False)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000244 self._box.close()
Georg Brandlfb16cf12008-05-11 21:31:44 +0000245 self._box = self._factory(self._path)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000246 key1 = self._box.add(self._template % 1)
247 msg = self._box.get(key1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000248 self.assertEqual(msg['from'], 'foo')
Georg Brandlfb16cf12008-05-11 21:31:44 +0000249 self.assertEqual(msg.get_payload(), '1')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000250
251 def test_getitem(self):
252 # Retrieve message using __getitem__()
253 key0 = self._box.add(self._template % 0)
254 msg = self._box[key0]
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000255 self.assertEqual(msg['from'], 'foo')
256 self.assertEqual(msg.get_payload(), '0')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000257 self.assertRaises(KeyError, lambda: self._box['foo'])
258 self._box.discard(key0)
259 self.assertRaises(KeyError, lambda: self._box[key0])
260
261 def test_get_message(self):
262 # Get Message representations of messages
263 key0 = self._box.add(self._template % 0)
264 key1 = self._box.add(_sample_message)
265 msg0 = self._box.get_message(key0)
Ezio Melottie9615932010-01-24 19:26:24 +0000266 self.assertIsInstance(msg0, mailbox.Message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000267 self.assertEqual(msg0['from'], 'foo')
268 self.assertEqual(msg0.get_payload(), '0')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000269 self._check_sample(self._box.get_message(key1))
270
R. David Murrayb7deff12011-01-30 06:21:28 +0000271 def test_get_bytes(self):
272 # Get bytes representations of messages
273 key0 = self._box.add(self._template % 0)
274 key1 = self._box.add(_sample_message)
275 self.assertEqual(self._box.get_bytes(key0),
276 (self._template % 0).encode('ascii'))
277 self.assertEqual(self._box.get_bytes(key1), _bytes_sample_message)
278
Thomas Wouters477c8d52006-05-27 19:21:47 +0000279 def test_get_string(self):
280 # Get string representations of messages
281 key0 = self._box.add(self._template % 0)
282 key1 = self._box.add(_sample_message)
Guido van Rossumea834472007-07-27 05:17:50 +0000283 self.assertEqual(self._box.get_string(key0), self._template % 0)
R. David Murrayb7deff12011-01-30 06:21:28 +0000284 self.assertEqual(self._box.get_string(key1).split('\n'),
285 _sample_message.split('\n'))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000286
287 def test_get_file(self):
288 # Get file representations of messages
289 key0 = self._box.add(self._template % 0)
290 key1 = self._box.add(_sample_message)
Brett Cannon653238a2010-10-30 00:13:00 +0000291 with self._box.get_file(key0) as file:
292 data0 = file.read()
293 with self._box.get_file(key1) as file:
294 data1 = file.read()
R. David Murrayb7deff12011-01-30 06:21:28 +0000295 self.assertEqual(data0.decode('ascii').replace(os.linesep, '\n'),
Guido van Rossumea834472007-07-27 05:17:50 +0000296 self._template % 0)
R. David Murrayb7deff12011-01-30 06:21:28 +0000297 self.assertEqual(data1.decode('ascii').replace(os.linesep, '\n'),
Guido van Rossumea834472007-07-27 05:17:50 +0000298 _sample_message)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000299
300 def test_iterkeys(self):
301 # Get keys using iterkeys()
Guido van Rossumcc2b0162007-02-11 06:12:03 +0000302 self._check_iteration(self._box.keys, do_keys=True, do_values=False)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000303
304 def test_keys(self):
305 # Get keys using keys()
306 self._check_iteration(self._box.keys, do_keys=True, do_values=False)
307
308 def test_itervalues(self):
309 # Get values using itervalues()
Guido van Rossumcc2b0162007-02-11 06:12:03 +0000310 self._check_iteration(self._box.values, do_keys=False,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000311 do_values=True)
312
313 def test_iter(self):
314 # Get values using __iter__()
315 self._check_iteration(self._box.__iter__, do_keys=False,
316 do_values=True)
317
318 def test_values(self):
319 # Get values using values()
320 self._check_iteration(self._box.values, do_keys=False, do_values=True)
321
322 def test_iteritems(self):
323 # Get keys and values using iteritems()
Guido van Rossumcc2b0162007-02-11 06:12:03 +0000324 self._check_iteration(self._box.items, do_keys=True,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000325 do_values=True)
326
327 def test_items(self):
328 # Get keys and values using items()
329 self._check_iteration(self._box.items, do_keys=True, do_values=True)
330
331 def _check_iteration(self, method, do_keys, do_values, repetitions=10):
332 for value in method():
333 self.fail("Not empty")
334 keys, values = [], []
Guido van Rossum805365e2007-05-07 22:24:25 +0000335 for i in range(repetitions):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000336 keys.append(self._box.add(self._template % i))
337 values.append(self._template % i)
338 if do_keys and not do_values:
339 returned_keys = list(method())
340 elif do_values and not do_keys:
341 returned_values = list(method())
342 else:
343 returned_keys, returned_values = [], []
344 for key, value in method():
345 returned_keys.append(key)
346 returned_values.append(value)
347 if do_keys:
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000348 self.assertEqual(len(keys), len(returned_keys))
349 self.assertEqual(set(keys), set(returned_keys))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000350 if do_values:
351 count = 0
352 for value in returned_values:
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000353 self.assertEqual(value['from'], 'foo')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000354 self.assertLess(int(value.get_payload()), repetitions)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000355 count += 1
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000356 self.assertEqual(len(values), count)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000357
Thomas Wouters477c8d52006-05-27 19:21:47 +0000358 def test_contains(self):
359 # Check existence of keys using __contains__()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000360 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000361 key0 = self._box.add(self._template % 0)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000362 self.assertIn(key0, self._box)
363 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000364 key1 = self._box.add(self._template % 1)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000365 self.assertIn(key1, self._box)
366 self.assertIn(key0, self._box)
367 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000368 self._box.remove(key0)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000369 self.assertNotIn(key0, self._box)
370 self.assertIn(key1, self._box)
371 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000372 self._box.remove(key1)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000373 self.assertNotIn(key1, self._box)
374 self.assertNotIn(key0, self._box)
375 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000376
377 def test_len(self, repetitions=10):
378 # Get message count
379 keys = []
Guido van Rossum805365e2007-05-07 22:24:25 +0000380 for i in range(repetitions):
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000381 self.assertEqual(len(self._box), i)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000382 keys.append(self._box.add(self._template % i))
Guido van Rossumea834472007-07-27 05:17:50 +0000383 self.assertEqual(len(self._box), i + 1)
Guido van Rossum805365e2007-05-07 22:24:25 +0000384 for i in range(repetitions):
Guido van Rossumea834472007-07-27 05:17:50 +0000385 self.assertEqual(len(self._box), repetitions - i)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000386 self._box.remove(keys[i])
Guido van Rossumea834472007-07-27 05:17:50 +0000387 self.assertEqual(len(self._box), repetitions - i - 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000388
389 def test_set_item(self):
390 # Modify messages using __setitem__()
391 key0 = self._box.add(self._template % 'original 0')
Guido van Rossumea834472007-07-27 05:17:50 +0000392 self.assertEqual(self._box.get_string(key0),
393 self._template % 'original 0')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000394 key1 = self._box.add(self._template % 'original 1')
Guido van Rossumea834472007-07-27 05:17:50 +0000395 self.assertEqual(self._box.get_string(key1),
396 self._template % 'original 1')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000397 self._box[key0] = self._template % 'changed 0'
Guido van Rossumea834472007-07-27 05:17:50 +0000398 self.assertEqual(self._box.get_string(key0),
399 self._template % 'changed 0')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000400 self._box[key1] = self._template % 'changed 1'
Guido van Rossumea834472007-07-27 05:17:50 +0000401 self.assertEqual(self._box.get_string(key1),
402 self._template % 'changed 1')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000403 self._box[key0] = _sample_message
404 self._check_sample(self._box[key0])
405 self._box[key1] = self._box[key0]
406 self._check_sample(self._box[key1])
407 self._box[key0] = self._template % 'original 0'
Guido van Rossumea834472007-07-27 05:17:50 +0000408 self.assertEqual(self._box.get_string(key0),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000409 self._template % 'original 0')
410 self._check_sample(self._box[key1])
411 self.assertRaises(KeyError,
412 lambda: self._box.__setitem__('foo', 'bar'))
413 self.assertRaises(KeyError, lambda: self._box['foo'])
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000414 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000415
416 def test_clear(self, iterations=10):
417 # Remove all messages using clear()
418 keys = []
Guido van Rossum805365e2007-05-07 22:24:25 +0000419 for i in range(iterations):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000420 self._box.add(self._template % i)
421 for i, key in enumerate(keys):
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000422 self.assertEqual(self._box.get_string(key), self._template % i)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000423 self._box.clear()
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000424 self.assertEqual(len(self._box), 0)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000425 for i, key in enumerate(keys):
426 self.assertRaises(KeyError, lambda: self._box.get_string(key))
427
428 def test_pop(self):
429 # Get and remove a message using pop()
430 key0 = self._box.add(self._template % 0)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000431 self.assertIn(key0, self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000432 key1 = self._box.add(self._template % 1)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000433 self.assertIn(key1, self._box)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000434 self.assertEqual(self._box.pop(key0).get_payload(), '0')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000435 self.assertNotIn(key0, self._box)
436 self.assertIn(key1, self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000437 key2 = self._box.add(self._template % 2)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000438 self.assertIn(key2, self._box)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000439 self.assertEqual(self._box.pop(key2).get_payload(), '2')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000440 self.assertNotIn(key2, self._box)
441 self.assertIn(key1, self._box)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000442 self.assertEqual(self._box.pop(key1).get_payload(), '1')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000443 self.assertNotIn(key1, self._box)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000444 self.assertEqual(len(self._box), 0)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000445
446 def test_popitem(self, iterations=10):
447 # Get and remove an arbitrary (key, message) using popitem()
448 keys = []
Guido van Rossum805365e2007-05-07 22:24:25 +0000449 for i in range(10):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000450 keys.append(self._box.add(self._template % i))
451 seen = []
Guido van Rossum805365e2007-05-07 22:24:25 +0000452 for i in range(10):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000453 key, msg = self._box.popitem()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000454 self.assertIn(key, keys)
455 self.assertNotIn(key, seen)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000456 seen.append(key)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000457 self.assertEqual(int(msg.get_payload()), keys.index(key))
458 self.assertEqual(len(self._box), 0)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000459 for key in keys:
460 self.assertRaises(KeyError, lambda: self._box[key])
461
462 def test_update(self):
463 # Modify multiple messages using update()
464 key0 = self._box.add(self._template % 'original 0')
465 key1 = self._box.add(self._template % 'original 1')
466 key2 = self._box.add(self._template % 'original 2')
467 self._box.update({key0: self._template % 'changed 0',
468 key2: _sample_message})
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000469 self.assertEqual(len(self._box), 3)
Guido van Rossumea834472007-07-27 05:17:50 +0000470 self.assertEqual(self._box.get_string(key0),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000471 self._template % 'changed 0')
Guido van Rossumea834472007-07-27 05:17:50 +0000472 self.assertEqual(self._box.get_string(key1),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000473 self._template % 'original 1')
474 self._check_sample(self._box[key2])
475 self._box.update([(key2, self._template % 'changed 2'),
476 (key1, self._template % 'changed 1'),
477 (key0, self._template % 'original 0')])
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000478 self.assertEqual(len(self._box), 3)
Guido van Rossumea834472007-07-27 05:17:50 +0000479 self.assertEqual(self._box.get_string(key0),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000480 self._template % 'original 0')
Guido van Rossumea834472007-07-27 05:17:50 +0000481 self.assertEqual(self._box.get_string(key1),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000482 self._template % 'changed 1')
Guido van Rossumea834472007-07-27 05:17:50 +0000483 self.assertEqual(self._box.get_string(key2),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000484 self._template % 'changed 2')
485 self.assertRaises(KeyError,
486 lambda: self._box.update({'foo': 'bar',
487 key0: self._template % "changed 0"}))
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000488 self.assertEqual(len(self._box), 3)
Guido van Rossumea834472007-07-27 05:17:50 +0000489 self.assertEqual(self._box.get_string(key0),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000490 self._template % "changed 0")
Guido van Rossumea834472007-07-27 05:17:50 +0000491 self.assertEqual(self._box.get_string(key1),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000492 self._template % "changed 1")
Guido van Rossumea834472007-07-27 05:17:50 +0000493 self.assertEqual(self._box.get_string(key2),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000494 self._template % "changed 2")
495
496 def test_flush(self):
497 # Write changes to disk
Christian Heimesf6cd9672008-03-26 13:45:42 +0000498 self._test_flush_or_close(self._box.flush, True)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000499
500 def test_lock_unlock(self):
501 # Lock and unlock the mailbox
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000502 self.assertFalse(os.path.exists(self._get_lock_path()))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000503 self._box.lock()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000504 self.assertTrue(os.path.exists(self._get_lock_path()))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000505 self._box.unlock()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000506 self.assertFalse(os.path.exists(self._get_lock_path()))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000507
508 def test_close(self):
509 # Close mailbox and flush changes to disk
Christian Heimesf6cd9672008-03-26 13:45:42 +0000510 self._test_flush_or_close(self._box.close, False)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000511
Christian Heimesf6cd9672008-03-26 13:45:42 +0000512 def _test_flush_or_close(self, method, should_call_close):
Guido van Rossum805365e2007-05-07 22:24:25 +0000513 contents = [self._template % i for i in range(3)]
Thomas Wouters477c8d52006-05-27 19:21:47 +0000514 self._box.add(contents[0])
515 self._box.add(contents[1])
516 self._box.add(contents[2])
Guido van Rossumc12a8132007-10-26 04:29:23 +0000517 oldbox = self._box
Thomas Wouters477c8d52006-05-27 19:21:47 +0000518 method()
Christian Heimesf6cd9672008-03-26 13:45:42 +0000519 if should_call_close:
520 self._box.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000521 self._box = self._factory(self._path)
522 keys = self._box.keys()
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000523 self.assertEqual(len(keys), 3)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000524 for key in keys:
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000525 self.assertIn(self._box.get_string(key), contents)
Guido van Rossumc12a8132007-10-26 04:29:23 +0000526 oldbox.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000527
528 def test_dump_message(self):
529 # Write message representations to disk
530 for input in (email.message_from_string(_sample_message),
R. David Murrayb7deff12011-01-30 06:21:28 +0000531 _sample_message, io.BytesIO(_bytes_sample_message)):
532 output = io.BytesIO()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000533 self._box._dump_message(input, output)
R. David Murrayb7deff12011-01-30 06:21:28 +0000534 self.assertEqual(output.getvalue(),
535 _bytes_sample_message.replace(b'\n', os.linesep.encode()))
536 output = io.BytesIO()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000537 self.assertRaises(TypeError,
538 lambda: self._box._dump_message(None, output))
539
540 def _get_lock_path(self):
541 # Return the path of the dot lock file. May be overridden.
542 return self._path + '.lock'
543
544
545class TestMailboxSuperclass(TestBase):
546
547 def test_notimplemented(self):
548 # Test that all Mailbox methods raise NotImplementedException.
549 box = mailbox.Mailbox('path')
550 self.assertRaises(NotImplementedError, lambda: box.add(''))
551 self.assertRaises(NotImplementedError, lambda: box.remove(''))
552 self.assertRaises(NotImplementedError, lambda: box.__delitem__(''))
553 self.assertRaises(NotImplementedError, lambda: box.discard(''))
554 self.assertRaises(NotImplementedError, lambda: box.__setitem__('', ''))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000555 self.assertRaises(NotImplementedError, lambda: box.keys())
Guido van Rossumcc2b0162007-02-11 06:12:03 +0000556 self.assertRaises(NotImplementedError, lambda: box.keys())
Guido van Rossumb5a755e2007-07-18 18:15:48 +0000557 self.assertRaises(NotImplementedError, lambda: box.values().__next__())
558 self.assertRaises(NotImplementedError, lambda: box.__iter__().__next__())
Thomas Wouters477c8d52006-05-27 19:21:47 +0000559 self.assertRaises(NotImplementedError, lambda: box.values())
Guido van Rossumcc2b0162007-02-11 06:12:03 +0000560 self.assertRaises(NotImplementedError, lambda: box.items().next())
Thomas Wouters477c8d52006-05-27 19:21:47 +0000561 self.assertRaises(NotImplementedError, lambda: box.items())
562 self.assertRaises(NotImplementedError, lambda: box.get(''))
563 self.assertRaises(NotImplementedError, lambda: box.__getitem__(''))
564 self.assertRaises(NotImplementedError, lambda: box.get_message(''))
565 self.assertRaises(NotImplementedError, lambda: box.get_string(''))
R. David Murrayb7deff12011-01-30 06:21:28 +0000566 self.assertRaises(NotImplementedError, lambda: box.get_bytes(''))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000567 self.assertRaises(NotImplementedError, lambda: box.get_file(''))
Guido van Rossume2b70bc2006-08-18 22:13:04 +0000568 self.assertRaises(NotImplementedError, lambda: '' in box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000569 self.assertRaises(NotImplementedError, lambda: box.__contains__(''))
570 self.assertRaises(NotImplementedError, lambda: box.__len__())
571 self.assertRaises(NotImplementedError, lambda: box.clear())
572 self.assertRaises(NotImplementedError, lambda: box.pop(''))
573 self.assertRaises(NotImplementedError, lambda: box.popitem())
574 self.assertRaises(NotImplementedError, lambda: box.update((('', ''),)))
575 self.assertRaises(NotImplementedError, lambda: box.flush())
576 self.assertRaises(NotImplementedError, lambda: box.lock())
577 self.assertRaises(NotImplementedError, lambda: box.unlock())
578 self.assertRaises(NotImplementedError, lambda: box.close())
579
580
581class TestMaildir(TestMailbox):
582
583 _factory = lambda self, path, factory=None: mailbox.Maildir(path, factory)
584
585 def setUp(self):
586 TestMailbox.setUp(self)
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000587 if os.name in ('nt', 'os2') or sys.platform == 'cygwin':
Thomas Wouters477c8d52006-05-27 19:21:47 +0000588 self._box.colon = '!'
589
R. David Murrayfc141142011-02-11 22:47:17 +0000590 def assertMailboxEmpty(self):
591 self.assertEqual(os.listdir(os.path.join(self._path, 'tmp')), [])
592
Thomas Wouters477c8d52006-05-27 19:21:47 +0000593 def test_add_MM(self):
594 # Add a MaildirMessage instance
595 msg = mailbox.MaildirMessage(self._template % 0)
596 msg.set_subdir('cur')
597 msg.set_info('foo')
598 key = self._box.add(msg)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000599 self.assertTrue(os.path.exists(os.path.join(self._path, 'cur', '%s%sfoo' %
Thomas Wouters477c8d52006-05-27 19:21:47 +0000600 (key, self._box.colon))))
601
602 def test_get_MM(self):
603 # Get a MaildirMessage instance
604 msg = mailbox.MaildirMessage(self._template % 0)
605 msg.set_subdir('cur')
606 msg.set_flags('RF')
607 key = self._box.add(msg)
608 msg_returned = self._box.get_message(key)
Ezio Melottie9615932010-01-24 19:26:24 +0000609 self.assertIsInstance(msg_returned, mailbox.MaildirMessage)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000610 self.assertEqual(msg_returned.get_subdir(), 'cur')
611 self.assertEqual(msg_returned.get_flags(), 'FR')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000612
613 def test_set_MM(self):
614 # Set with a MaildirMessage instance
615 msg0 = mailbox.MaildirMessage(self._template % 0)
616 msg0.set_flags('TP')
617 key = self._box.add(msg0)
618 msg_returned = self._box.get_message(key)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000619 self.assertEqual(msg_returned.get_subdir(), 'new')
620 self.assertEqual(msg_returned.get_flags(), 'PT')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000621 msg1 = mailbox.MaildirMessage(self._template % 1)
622 self._box[key] = msg1
623 msg_returned = self._box.get_message(key)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000624 self.assertEqual(msg_returned.get_subdir(), 'new')
625 self.assertEqual(msg_returned.get_flags(), '')
626 self.assertEqual(msg_returned.get_payload(), '1')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000627 msg2 = mailbox.MaildirMessage(self._template % 2)
628 msg2.set_info('2,S')
629 self._box[key] = msg2
630 self._box[key] = self._template % 3
631 msg_returned = self._box.get_message(key)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000632 self.assertEqual(msg_returned.get_subdir(), 'new')
633 self.assertEqual(msg_returned.get_flags(), 'S')
634 self.assertEqual(msg_returned.get_payload(), '3')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000635
Christian Heimesfdab48e2008-01-20 09:06:41 +0000636 def test_consistent_factory(self):
637 # Add a message.
638 msg = mailbox.MaildirMessage(self._template % 0)
639 msg.set_subdir('cur')
640 msg.set_flags('RF')
641 key = self._box.add(msg)
642
643 # Create new mailbox with
644 class FakeMessage(mailbox.MaildirMessage):
645 pass
646 box = mailbox.Maildir(self._path, factory=FakeMessage)
Christian Heimes15ebc882008-02-04 18:48:49 +0000647 box.colon = self._box.colon
Christian Heimesfdab48e2008-01-20 09:06:41 +0000648 msg2 = box.get_message(key)
Ezio Melottie9615932010-01-24 19:26:24 +0000649 self.assertIsInstance(msg2, FakeMessage)
Christian Heimesfdab48e2008-01-20 09:06:41 +0000650
Thomas Wouters477c8d52006-05-27 19:21:47 +0000651 def test_initialize_new(self):
652 # Initialize a non-existent mailbox
653 self.tearDown()
654 self._box = mailbox.Maildir(self._path)
Georg Brandlfb16cf12008-05-11 21:31:44 +0000655 self._check_basics()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000656 self._delete_recursively(self._path)
657 self._box = self._factory(self._path, factory=None)
658 self._check_basics()
659
660 def test_initialize_existing(self):
661 # Initialize an existing mailbox
662 self.tearDown()
663 for subdir in '', 'tmp', 'new', 'cur':
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000664 os.mkdir(os.path.normpath(os.path.join(self._path, subdir)))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000665 self._box = mailbox.Maildir(self._path)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000666 self._check_basics()
667
668 def _check_basics(self, factory=None):
669 # (Used by test_open_new() and test_open_existing().)
670 self.assertEqual(self._box._path, os.path.abspath(self._path))
671 self.assertEqual(self._box._factory, factory)
672 for subdir in '', 'tmp', 'new', 'cur':
673 path = os.path.join(self._path, subdir)
674 mode = os.stat(path)[stat.ST_MODE]
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000675 self.assertTrue(stat.S_ISDIR(mode), "Not a directory: '%s'" % path)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000676
677 def test_list_folders(self):
678 # List folders
679 self._box.add_folder('one')
680 self._box.add_folder('two')
681 self._box.add_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000682 self.assertEqual(len(self._box.list_folders()), 3)
Guido van Rossumea834472007-07-27 05:17:50 +0000683 self.assertEqual(set(self._box.list_folders()),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000684 set(('one', 'two', 'three')))
685
686 def test_get_folder(self):
687 # Open folders
688 self._box.add_folder('foo.bar')
689 folder0 = self._box.get_folder('foo.bar')
690 folder0.add(self._template % 'bar')
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000691 self.assertTrue(os.path.isdir(os.path.join(self._path, '.foo.bar')))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000692 folder1 = self._box.get_folder('foo.bar')
Guido van Rossumea834472007-07-27 05:17:50 +0000693 self.assertEqual(folder1.get_string(folder1.keys()[0]),
694 self._template % 'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000695
696 def test_add_and_remove_folders(self):
697 # Delete folders
698 self._box.add_folder('one')
699 self._box.add_folder('two')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000700 self.assertEqual(len(self._box.list_folders()), 2)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000701 self.assertEqual(set(self._box.list_folders()), set(('one', 'two')))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000702 self._box.remove_folder('one')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000703 self.assertEqual(len(self._box.list_folders()), 1)
704 self.assertEqual(set(self._box.list_folders()), set(('two',)))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000705 self._box.add_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000706 self.assertEqual(len(self._box.list_folders()), 2)
Guido van Rossumea834472007-07-27 05:17:50 +0000707 self.assertEqual(set(self._box.list_folders()), set(('two', 'three')))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000708 self._box.remove_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000709 self.assertEqual(len(self._box.list_folders()), 1)
710 self.assertEqual(set(self._box.list_folders()), set(('two',)))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000711 self._box.remove_folder('two')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000712 self.assertEqual(len(self._box.list_folders()), 0)
713 self.assertEqual(self._box.list_folders(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +0000714
715 def test_clean(self):
716 # Remove old files from 'tmp'
717 foo_path = os.path.join(self._path, 'tmp', 'foo')
718 bar_path = os.path.join(self._path, 'tmp', 'bar')
Brian Curtin5acec042010-10-13 02:29:46 +0000719 with open(foo_path, 'w') as f:
720 f.write("@")
721 with open(bar_path, 'w') as f:
722 f.write("@")
Thomas Wouters477c8d52006-05-27 19:21:47 +0000723 self._box.clean()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000724 self.assertTrue(os.path.exists(foo_path))
725 self.assertTrue(os.path.exists(bar_path))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000726 foo_stat = os.stat(foo_path)
727 os.utime(foo_path, (time.time() - 129600 - 2,
728 foo_stat.st_mtime))
729 self._box.clean()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000730 self.assertFalse(os.path.exists(foo_path))
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000731 self.assertTrue(os.path.exists(bar_path))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000732
733 def test_create_tmp(self, repetitions=10):
734 # Create files in tmp directory
735 hostname = socket.gethostname()
736 if '/' in hostname:
737 hostname = hostname.replace('/', r'\057')
738 if ':' in hostname:
739 hostname = hostname.replace(':', r'\072')
740 pid = os.getpid()
741 pattern = re.compile(r"(?P<time>\d+)\.M(?P<M>\d{1,6})P(?P<P>\d+)"
742 r"Q(?P<Q>\d+)\.(?P<host>[^:/]+)")
743 previous_groups = None
Guido van Rossum805365e2007-05-07 22:24:25 +0000744 for x in range(repetitions):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000745 tmp_file = self._box._create_tmp()
746 head, tail = os.path.split(tmp_file.name)
747 self.assertEqual(head, os.path.abspath(os.path.join(self._path,
748 "tmp")),
749 "File in wrong location: '%s'" % head)
750 match = pattern.match(tail)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000751 self.assertIsNot(match, None, "Invalid file name: '%s'" % tail)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000752 groups = match.groups()
Benjamin Peterson2a691a82008-03-31 01:51:45 +0000753 if previous_groups is not None:
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000754 self.assertTrue(int(groups[0] >= previous_groups[0]),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000755 "Non-monotonic seconds: '%s' before '%s'" %
756 (previous_groups[0], groups[0]))
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000757 self.assertTrue(int(groups[1] >= previous_groups[1]) or
Thomas Wouters477c8d52006-05-27 19:21:47 +0000758 groups[0] != groups[1],
759 "Non-monotonic milliseconds: '%s' before '%s'" %
760 (previous_groups[1], groups[1]))
Guido van Rossumea834472007-07-27 05:17:50 +0000761 self.assertEqual(int(groups[2]), pid,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000762 "Process ID mismatch: '%s' should be '%s'" %
763 (groups[2], pid))
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000764 self.assertEqual(int(groups[3]), int(previous_groups[3]) + 1,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000765 "Non-sequential counter: '%s' before '%s'" %
766 (previous_groups[3], groups[3]))
Guido van Rossumea834472007-07-27 05:17:50 +0000767 self.assertEqual(groups[4], hostname,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000768 "Host name mismatch: '%s' should be '%s'" %
769 (groups[4], hostname))
770 previous_groups = groups
R. David Murrayb7deff12011-01-30 06:21:28 +0000771 tmp_file.write(_bytes_sample_message)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000772 tmp_file.seek(0)
R. David Murrayb7deff12011-01-30 06:21:28 +0000773 self.assertEqual(tmp_file.read(), _bytes_sample_message)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000774 tmp_file.close()
775 file_count = len(os.listdir(os.path.join(self._path, "tmp")))
Guido van Rossumea834472007-07-27 05:17:50 +0000776 self.assertEqual(file_count, repetitions,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000777 "Wrong file count: '%s' should be '%s'" %
778 (file_count, repetitions))
779
780 def test_refresh(self):
781 # Update the table of contents
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000782 self.assertEqual(self._box._toc, {})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000783 key0 = self._box.add(self._template % 0)
784 key1 = self._box.add(self._template % 1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000785 self.assertEqual(self._box._toc, {})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000786 self._box._refresh()
Guido van Rossumea834472007-07-27 05:17:50 +0000787 self.assertEqual(self._box._toc, {key0: os.path.join('new', key0),
788 key1: os.path.join('new', key1)})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000789 key2 = self._box.add(self._template % 2)
Guido van Rossumea834472007-07-27 05:17:50 +0000790 self.assertEqual(self._box._toc, {key0: os.path.join('new', key0),
791 key1: os.path.join('new', key1)})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000792 self._box._refresh()
Guido van Rossumea834472007-07-27 05:17:50 +0000793 self.assertEqual(self._box._toc, {key0: os.path.join('new', key0),
794 key1: os.path.join('new', key1),
795 key2: os.path.join('new', key2)})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000796
797 def test_lookup(self):
798 # Look up message subpaths in the TOC
799 self.assertRaises(KeyError, lambda: self._box._lookup('foo'))
800 key0 = self._box.add(self._template % 0)
Guido van Rossumea834472007-07-27 05:17:50 +0000801 self.assertEqual(self._box._lookup(key0), os.path.join('new', key0))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000802 os.remove(os.path.join(self._path, 'new', key0))
Guido van Rossumea834472007-07-27 05:17:50 +0000803 self.assertEqual(self._box._toc, {key0: os.path.join('new', key0)})
Antoine Pitrou03f13442009-11-02 11:36:51 +0000804 # Be sure that the TOC is read back from disk (see issue #6896
805 # about bad mtime behaviour on some systems).
806 self._box.flush()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000807 self.assertRaises(KeyError, lambda: self._box._lookup(key0))
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000808 self.assertEqual(self._box._toc, {})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000809
810 def test_lock_unlock(self):
811 # Lock and unlock the mailbox. For Maildir, this does nothing.
812 self._box.lock()
813 self._box.unlock()
814
Thomas Wouters89f507f2006-12-13 04:49:30 +0000815 def test_folder (self):
816 # Test for bug #1569790: verify that folders returned by .get_folder()
817 # use the same factory function.
818 def dummy_factory (s):
819 return None
820 box = self._factory(self._path, factory=dummy_factory)
821 folder = box.add_folder('folder1')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000822 self.assertIs(folder._factory, dummy_factory)
Thomas Wouters9fe394c2007-02-05 01:24:16 +0000823
Thomas Wouters89f507f2006-12-13 04:49:30 +0000824 folder1_alias = box.get_folder('folder1')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000825 self.assertIs(folder1_alias._factory, dummy_factory)
Thomas Wouters89f507f2006-12-13 04:49:30 +0000826
Guido van Rossumb5a755e2007-07-18 18:15:48 +0000827 def test_directory_in_folder (self):
828 # Test that mailboxes still work if there's a stray extra directory
829 # in a folder.
830 for i in range(10):
831 self._box.add(mailbox.Message(_sample_message))
Thomas Wouters9fe394c2007-02-05 01:24:16 +0000832
Guido van Rossumb5a755e2007-07-18 18:15:48 +0000833 # Create a stray directory
834 os.mkdir(os.path.join(self._path, 'cur', 'stray-dir'))
835
836 # Check that looping still works with the directory present.
837 for msg in self._box:
838 pass
Thomas Wouters477c8d52006-05-27 19:21:47 +0000839
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000840 def test_file_permissions(self):
841 # Verify that message files are created without execute permissions
842 if not hasattr(os, "stat") or not hasattr(os, "umask"):
843 return
844 msg = mailbox.MaildirMessage(self._template % 0)
845 orig_umask = os.umask(0)
846 try:
847 key = self._box.add(msg)
848 finally:
849 os.umask(orig_umask)
850 path = os.path.join(self._path, self._box._lookup(key))
851 mode = os.stat(path).st_mode
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000852 self.assertFalse(mode & 0o111)
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000853
854 def test_folder_file_perms(self):
855 # From bug #3228, we want to verify that the file created inside a Maildir
856 # subfolder isn't marked as executable.
857 if not hasattr(os, "stat") or not hasattr(os, "umask"):
858 return
859
860 orig_umask = os.umask(0)
861 try:
862 subfolder = self._box.add_folder('subfolder')
863 finally:
864 os.umask(orig_umask)
865
866 path = os.path.join(subfolder._path, 'maildirfolder')
867 st = os.stat(path)
868 perms = st.st_mode
869 self.assertFalse((perms & 0o111)) # Execute bits should all be off.
870
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000871 def test_reread(self):
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000872
R David Murraycaed7fe2011-05-06 22:07:19 -0400873 # Put the last modified times more than two seconds into the past
874 # (because mtime may have a two second granularity)
R David Murrayb9a428d2011-03-25 16:03:47 -0400875 for subdir in ('cur', 'new'):
876 os.utime(os.path.join(self._box._path, subdir),
877 (time.time()-5,)*2)
878
R David Murraycaed7fe2011-05-06 22:07:19 -0400879 # Because mtime has a two second granularity in worst case (FAT), a
880 # refresh is done unconditionally if called for within
881 # two-second-plus-a-bit of the last one, just in case the mbox has
882 # changed; so now we have to wait for that interval to expire.
883 time.sleep(2.01 + self._box._skewfactor)
884
R David Murrayb9a428d2011-03-25 16:03:47 -0400885 # Re-reading causes the ._toc attribute to be assigned a new dictionary
886 # object, so we'll check that the ._toc attribute isn't a different
887 # object.
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000888 orig_toc = self._box._toc
889 def refreshed():
890 return self._box._toc is not orig_toc
891
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000892 self._box._refresh()
R David Murraycaed7fe2011-05-06 22:07:19 -0400893 self.assertFalse(refreshed())
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000894
895 # Now, write something into cur and remove it. This changes
896 # the mtime and should cause a re-read.
897 filename = os.path.join(self._path, 'cur', 'stray-file')
898 f = open(filename, 'w')
899 f.close()
900 os.unlink(filename)
901 self._box._refresh()
R David Murraycaed7fe2011-05-06 22:07:19 -0400902 self.assertTrue(refreshed())
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000903
Thomas Wouters477c8d52006-05-27 19:21:47 +0000904class _TestMboxMMDF(TestMailbox):
905
906 def tearDown(self):
Brett Cannon653238a2010-10-30 00:13:00 +0000907 super().tearDown()
Guido van Rossumc12a8132007-10-26 04:29:23 +0000908 self._box.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000909 self._delete_recursively(self._path)
910 for lock_remnant in glob.glob(self._path + '.*'):
Benjamin Petersonee8712c2008-05-20 21:35:26 +0000911 support.unlink(lock_remnant)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000912
R. David Murrayfc141142011-02-11 22:47:17 +0000913 def assertMailboxEmpty(self):
914 with open(self._path) as f:
915 self.assertEqual(f.readlines(), [])
916
Thomas Wouters477c8d52006-05-27 19:21:47 +0000917 def test_add_from_string(self):
918 # Add a string starting with 'From ' to the mailbox
919 key = self._box.add('From foo@bar blah\nFrom: foo\n\n0')
Guido van Rossumea834472007-07-27 05:17:50 +0000920 self.assertEqual(self._box[key].get_from(), 'foo@bar blah')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000921 self.assertEqual(self._box[key].get_payload(), '0')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000922
R. David Murrayb7deff12011-01-30 06:21:28 +0000923 def test_add_from_bytes(self):
924 # Add a byte string starting with 'From ' to the mailbox
925 key = self._box.add(b'From foo@bar blah\nFrom: foo\n\n0')
926 self.assertEqual(self._box[key].get_from(), 'foo@bar blah')
927 self.assertEqual(self._box[key].get_payload(), '0')
928
Thomas Wouters477c8d52006-05-27 19:21:47 +0000929 def test_add_mbox_or_mmdf_message(self):
930 # Add an mboxMessage or MMDFMessage
931 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
932 msg = class_('From foo@bar blah\nFrom: foo\n\n0')
933 key = self._box.add(msg)
934
935 def test_open_close_open(self):
936 # Open and inspect previously-created mailbox
Guido van Rossum805365e2007-05-07 22:24:25 +0000937 values = [self._template % i for i in range(3)]
Thomas Wouters477c8d52006-05-27 19:21:47 +0000938 for value in values:
939 self._box.add(value)
940 self._box.close()
941 mtime = os.path.getmtime(self._path)
942 self._box = self._factory(self._path)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000943 self.assertEqual(len(self._box), 3)
Guido van Rossumcc2b0162007-02-11 06:12:03 +0000944 for key in self._box.keys():
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000945 self.assertIn(self._box.get_string(key), values)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000946 self._box.close()
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000947 self.assertEqual(mtime, os.path.getmtime(self._path))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000948
949 def test_add_and_close(self):
950 # Verifying that closing a mailbox doesn't change added items
951 self._box.add(_sample_message)
Guido van Rossum805365e2007-05-07 22:24:25 +0000952 for i in range(3):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000953 self._box.add(self._template % i)
954 self._box.add(_sample_message)
955 self._box._file.flush()
956 self._box._file.seek(0)
957 contents = self._box._file.read()
958 self._box.close()
R. David Murrayb7deff12011-01-30 06:21:28 +0000959 with open(self._path, 'rb') as f:
Brian Curtin5acec042010-10-13 02:29:46 +0000960 self.assertEqual(contents, f.read())
Thomas Wouters477c8d52006-05-27 19:21:47 +0000961 self._box = self._factory(self._path)
962
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000963 def test_lock_conflict(self):
964 # Fork off a subprocess that will lock the file for 2 seconds,
965 # unlock it, and then exit.
966 if not hasattr(os, 'fork'):
967 return
968 pid = os.fork()
969 if pid == 0:
970 # In the child, lock the mailbox.
Guido van Rossum62cbc8a2007-04-09 00:41:25 +0000971 try:
972 self._box.lock()
973 time.sleep(2)
974 self._box.unlock()
975 finally:
976 os._exit(0)
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000977
978 # In the parent, sleep a bit to give the child time to acquire
979 # the lock.
980 time.sleep(0.5)
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000981 try:
982 self.assertRaises(mailbox.ExternalClashError,
983 self._box.lock)
984 finally:
985 # Wait for child to exit. Locking should now succeed.
986 exited_pid, status = os.waitpid(pid, 0)
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000987
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000988 self._box.lock()
989 self._box.unlock()
990
Thomas Wouters89f507f2006-12-13 04:49:30 +0000991 def test_relock(self):
992 # Test case for bug #1575506: the mailbox class was locking the
993 # wrong file object in its flush() method.
994 msg = "Subject: sub\n\nbody\n"
995 key1 = self._box.add(msg)
996 self._box.flush()
997 self._box.close()
998
999 self._box = self._factory(self._path)
1000 self._box.lock()
1001 key2 = self._box.add(msg)
1002 self._box.flush()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001003 self.assertTrue(self._box._locked)
Thomas Wouters89f507f2006-12-13 04:49:30 +00001004 self._box.close()
1005
1006
Thomas Wouters477c8d52006-05-27 19:21:47 +00001007class TestMbox(_TestMboxMMDF):
1008
1009 _factory = lambda self, path, factory=None: mailbox.mbox(path, factory)
1010
Georg Brandl6aa2d1f2008-08-12 08:35:52 +00001011 def test_file_perms(self):
1012 # From bug #3228, we want to verify that the mailbox file isn't executable,
1013 # even if the umask is set to something that would leave executable bits set.
1014 # We only run this test on platforms that support umask.
1015 if hasattr(os, 'umask') and hasattr(os, 'stat'):
1016 try:
1017 old_umask = os.umask(0o077)
1018 self._box.close()
1019 os.unlink(self._path)
1020 self._box = mailbox.mbox(self._path, create=True)
1021 self._box.add('')
1022 self._box.close()
1023 finally:
1024 os.umask(old_umask)
1025
1026 st = os.stat(self._path)
1027 perms = st.st_mode
1028 self.assertFalse((perms & 0o111)) # Execute bits should all be off.
Thomas Wouters477c8d52006-05-27 19:21:47 +00001029
1030class TestMMDF(_TestMboxMMDF):
1031
1032 _factory = lambda self, path, factory=None: mailbox.MMDF(path, factory)
1033
1034
1035class TestMH(TestMailbox):
1036
1037 _factory = lambda self, path, factory=None: mailbox.MH(path, factory)
1038
R. David Murrayfc141142011-02-11 22:47:17 +00001039 def assertMailboxEmpty(self):
1040 self.assertEqual(os.listdir(self._path), ['.mh_sequences'])
1041
Thomas Wouters477c8d52006-05-27 19:21:47 +00001042 def test_list_folders(self):
1043 # List folders
1044 self._box.add_folder('one')
1045 self._box.add_folder('two')
1046 self._box.add_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001047 self.assertEqual(len(self._box.list_folders()), 3)
Guido van Rossumea834472007-07-27 05:17:50 +00001048 self.assertEqual(set(self._box.list_folders()),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001049 set(('one', 'two', 'three')))
1050
1051 def test_get_folder(self):
1052 # Open folders
Thomas Wouters89f507f2006-12-13 04:49:30 +00001053 def dummy_factory (s):
1054 return None
1055 self._box = self._factory(self._path, dummy_factory)
Thomas Wouters9fe394c2007-02-05 01:24:16 +00001056
Thomas Wouters89f507f2006-12-13 04:49:30 +00001057 new_folder = self._box.add_folder('foo.bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001058 folder0 = self._box.get_folder('foo.bar')
1059 folder0.add(self._template % 'bar')
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001060 self.assertTrue(os.path.isdir(os.path.join(self._path, 'foo.bar')))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001061 folder1 = self._box.get_folder('foo.bar')
Guido van Rossumea834472007-07-27 05:17:50 +00001062 self.assertEqual(folder1.get_string(folder1.keys()[0]),
1063 self._template % 'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001064
Thomas Wouters89f507f2006-12-13 04:49:30 +00001065 # Test for bug #1569790: verify that folders returned by .get_folder()
1066 # use the same factory function.
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001067 self.assertIs(new_folder._factory, self._box._factory)
1068 self.assertIs(folder0._factory, self._box._factory)
Thomas Wouters89f507f2006-12-13 04:49:30 +00001069
Thomas Wouters477c8d52006-05-27 19:21:47 +00001070 def test_add_and_remove_folders(self):
1071 # Delete folders
1072 self._box.add_folder('one')
1073 self._box.add_folder('two')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001074 self.assertEqual(len(self._box.list_folders()), 2)
Guido van Rossumea834472007-07-27 05:17:50 +00001075 self.assertEqual(set(self._box.list_folders()), set(('one', 'two')))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001076 self._box.remove_folder('one')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001077 self.assertEqual(len(self._box.list_folders()), 1)
1078 self.assertEqual(set(self._box.list_folders()), set(('two',)))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001079 self._box.add_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001080 self.assertEqual(len(self._box.list_folders()), 2)
Guido van Rossumea834472007-07-27 05:17:50 +00001081 self.assertEqual(set(self._box.list_folders()), set(('two', 'three')))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001082 self._box.remove_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001083 self.assertEqual(len(self._box.list_folders()), 1)
1084 self.assertEqual(set(self._box.list_folders()), set(('two',)))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001085 self._box.remove_folder('two')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001086 self.assertEqual(len(self._box.list_folders()), 0)
1087 self.assertEqual(self._box.list_folders(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001088
1089 def test_sequences(self):
1090 # Get and set sequences
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001091 self.assertEqual(self._box.get_sequences(), {})
Thomas Wouters477c8d52006-05-27 19:21:47 +00001092 msg0 = mailbox.MHMessage(self._template % 0)
1093 msg0.add_sequence('foo')
1094 key0 = self._box.add(msg0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001095 self.assertEqual(self._box.get_sequences(), {'foo':[key0]})
Thomas Wouters477c8d52006-05-27 19:21:47 +00001096 msg1 = mailbox.MHMessage(self._template % 1)
1097 msg1.set_sequences(['bar', 'replied', 'foo'])
1098 key1 = self._box.add(msg1)
Guido van Rossumea834472007-07-27 05:17:50 +00001099 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001100 {'foo':[key0, key1], 'bar':[key1], 'replied':[key1]})
1101 msg0.set_sequences(['flagged'])
1102 self._box[key0] = msg0
Guido van Rossumea834472007-07-27 05:17:50 +00001103 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001104 {'foo':[key1], 'bar':[key1], 'replied':[key1],
1105 'flagged':[key0]})
1106 self._box.remove(key1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001107 self.assertEqual(self._box.get_sequences(), {'flagged':[key0]})
Thomas Wouters477c8d52006-05-27 19:21:47 +00001108
R. David Murray548ac412009-04-02 19:44:43 +00001109 def test_issue2625(self):
1110 msg0 = mailbox.MHMessage(self._template % 0)
1111 msg0.add_sequence('foo')
1112 key0 = self._box.add(msg0)
1113 refmsg0 = self._box.get_message(key0)
1114
Benjamin Peterson21896a32010-03-21 22:03:03 +00001115 def test_issue7627(self):
1116 msg0 = mailbox.MHMessage(self._template % 0)
1117 key0 = self._box.add(msg0)
1118 self._box.lock()
1119 self._box.remove(key0)
1120 self._box.unlock()
1121
Thomas Wouters477c8d52006-05-27 19:21:47 +00001122 def test_pack(self):
1123 # Pack the contents of the mailbox
1124 msg0 = mailbox.MHMessage(self._template % 0)
1125 msg1 = mailbox.MHMessage(self._template % 1)
1126 msg2 = mailbox.MHMessage(self._template % 2)
1127 msg3 = mailbox.MHMessage(self._template % 3)
1128 msg0.set_sequences(['foo', 'unseen'])
1129 msg1.set_sequences(['foo'])
1130 msg2.set_sequences(['foo', 'flagged'])
1131 msg3.set_sequences(['foo', 'bar', 'replied'])
1132 key0 = self._box.add(msg0)
1133 key1 = self._box.add(msg1)
1134 key2 = self._box.add(msg2)
1135 key3 = self._box.add(msg3)
Guido van Rossumea834472007-07-27 05:17:50 +00001136 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001137 {'foo':[key0,key1,key2,key3], 'unseen':[key0],
1138 'flagged':[key2], 'bar':[key3], 'replied':[key3]})
1139 self._box.remove(key2)
Guido van Rossumea834472007-07-27 05:17:50 +00001140 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001141 {'foo':[key0,key1,key3], 'unseen':[key0], 'bar':[key3],
1142 'replied':[key3]})
1143 self._box.pack()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001144 self.assertEqual(self._box.keys(), [1, 2, 3])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001145 key0 = key0
1146 key1 = key0 + 1
1147 key2 = key1 + 1
Guido van Rossumea834472007-07-27 05:17:50 +00001148 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001149 {'foo':[1, 2, 3], 'unseen':[1], 'bar':[3], 'replied':[3]})
1150
Thomas Wouters89f507f2006-12-13 04:49:30 +00001151 # Test case for packing while holding the mailbox locked.
1152 key0 = self._box.add(msg1)
1153 key1 = self._box.add(msg1)
1154 key2 = self._box.add(msg1)
1155 key3 = self._box.add(msg1)
1156
1157 self._box.remove(key0)
1158 self._box.remove(key2)
1159 self._box.lock()
1160 self._box.pack()
1161 self._box.unlock()
Guido van Rossumea834472007-07-27 05:17:50 +00001162 self.assertEqual(self._box.get_sequences(),
Thomas Wouters89f507f2006-12-13 04:49:30 +00001163 {'foo':[1, 2, 3, 4, 5],
1164 'unseen':[1], 'bar':[3], 'replied':[3]})
Thomas Wouters9fe394c2007-02-05 01:24:16 +00001165
Thomas Wouters477c8d52006-05-27 19:21:47 +00001166 def _get_lock_path(self):
1167 return os.path.join(self._path, '.mh_sequences.lock')
1168
1169
1170class TestBabyl(TestMailbox):
1171
1172 _factory = lambda self, path, factory=None: mailbox.Babyl(path, factory)
1173
R. David Murrayfc141142011-02-11 22:47:17 +00001174 def assertMailboxEmpty(self):
1175 with open(self._path) as f:
1176 self.assertEqual(f.readlines(), [])
1177
Thomas Wouters477c8d52006-05-27 19:21:47 +00001178 def tearDown(self):
Brett Cannon653238a2010-10-30 00:13:00 +00001179 super().tearDown()
Guido van Rossumc12a8132007-10-26 04:29:23 +00001180 self._box.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001181 self._delete_recursively(self._path)
1182 for lock_remnant in glob.glob(self._path + '.*'):
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001183 support.unlink(lock_remnant)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001184
1185 def test_labels(self):
1186 # Get labels from the mailbox
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001187 self.assertEqual(self._box.get_labels(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001188 msg0 = mailbox.BabylMessage(self._template % 0)
1189 msg0.add_label('foo')
1190 key0 = self._box.add(msg0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001191 self.assertEqual(self._box.get_labels(), ['foo'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001192 msg1 = mailbox.BabylMessage(self._template % 1)
1193 msg1.set_labels(['bar', 'answered', 'foo'])
1194 key1 = self._box.add(msg1)
Guido van Rossumea834472007-07-27 05:17:50 +00001195 self.assertEqual(set(self._box.get_labels()), set(['foo', 'bar']))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001196 msg0.set_labels(['blah', 'filed'])
1197 self._box[key0] = msg0
Guido van Rossumea834472007-07-27 05:17:50 +00001198 self.assertEqual(set(self._box.get_labels()),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001199 set(['foo', 'bar', 'blah']))
1200 self._box.remove(key1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001201 self.assertEqual(set(self._box.get_labels()), set(['blah']))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001202
1203
1204class TestMessage(TestBase):
1205
1206 _factory = mailbox.Message # Overridden by subclasses to reuse tests
1207
1208 def setUp(self):
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001209 self._path = support.TESTFN
Thomas Wouters477c8d52006-05-27 19:21:47 +00001210
1211 def tearDown(self):
1212 self._delete_recursively(self._path)
1213
1214 def test_initialize_with_eMM(self):
Thomas Woutersb2137042007-02-01 18:02:27 +00001215 # Initialize based on email.message.Message instance
Thomas Wouters477c8d52006-05-27 19:21:47 +00001216 eMM = email.message_from_string(_sample_message)
1217 msg = self._factory(eMM)
1218 self._post_initialize_hook(msg)
1219 self._check_sample(msg)
1220
1221 def test_initialize_with_string(self):
1222 # Initialize based on string
1223 msg = self._factory(_sample_message)
1224 self._post_initialize_hook(msg)
1225 self._check_sample(msg)
1226
1227 def test_initialize_with_file(self):
1228 # Initialize based on contents of file
Brian Curtin5acec042010-10-13 02:29:46 +00001229 with open(self._path, 'w+') as f:
1230 f.write(_sample_message)
1231 f.seek(0)
1232 msg = self._factory(f)
1233 self._post_initialize_hook(msg)
1234 self._check_sample(msg)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001235
R. David Murrayb7deff12011-01-30 06:21:28 +00001236 def test_initialize_with_binary_file(self):
1237 # Initialize based on contents of binary file
1238 with open(self._path, 'wb+') as f:
1239 f.write(_bytes_sample_message)
1240 f.seek(0)
1241 msg = self._factory(f)
1242 self._post_initialize_hook(msg)
1243 self._check_sample(msg)
1244
Thomas Wouters477c8d52006-05-27 19:21:47 +00001245 def test_initialize_with_nothing(self):
1246 # Initialize without arguments
1247 msg = self._factory()
1248 self._post_initialize_hook(msg)
Ezio Melottie9615932010-01-24 19:26:24 +00001249 self.assertIsInstance(msg, email.message.Message)
1250 self.assertIsInstance(msg, mailbox.Message)
1251 self.assertIsInstance(msg, self._factory)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001252 self.assertEqual(msg.keys(), [])
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001253 self.assertFalse(msg.is_multipart())
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001254 self.assertEqual(msg.get_payload(), None)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001255
1256 def test_initialize_incorrectly(self):
1257 # Initialize with invalid argument
1258 self.assertRaises(TypeError, lambda: self._factory(object()))
1259
1260 def test_become_message(self):
1261 # Take on the state of another message
1262 eMM = email.message_from_string(_sample_message)
1263 msg = self._factory()
1264 msg._become_message(eMM)
1265 self._check_sample(msg)
1266
1267 def test_explain_to(self):
1268 # Copy self's format-specific data to other message formats.
1269 # This test is superficial; better ones are in TestMessageConversion.
1270 msg = self._factory()
1271 for class_ in (mailbox.Message, mailbox.MaildirMessage,
1272 mailbox.mboxMessage, mailbox.MHMessage,
1273 mailbox.BabylMessage, mailbox.MMDFMessage):
1274 other_msg = class_()
1275 msg._explain_to(other_msg)
Thomas Woutersb2137042007-02-01 18:02:27 +00001276 other_msg = email.message.Message()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001277 self.assertRaises(TypeError, lambda: msg._explain_to(other_msg))
1278
1279 def _post_initialize_hook(self, msg):
1280 # Overridden by subclasses to check extra things after initialization
1281 pass
1282
1283
1284class TestMaildirMessage(TestMessage):
1285
1286 _factory = mailbox.MaildirMessage
1287
1288 def _post_initialize_hook(self, msg):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001289 self.assertEqual(msg._subdir, 'new')
1290 self.assertEqual(msg._info, '')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001291
1292 def test_subdir(self):
1293 # Use get_subdir() and set_subdir()
1294 msg = mailbox.MaildirMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001295 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001296 msg.set_subdir('cur')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001297 self.assertEqual(msg.get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001298 msg.set_subdir('new')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001299 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001300 self.assertRaises(ValueError, lambda: msg.set_subdir('tmp'))
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001301 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001302 msg.set_subdir('new')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001303 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001304 self._check_sample(msg)
1305
1306 def test_flags(self):
1307 # Use get_flags(), set_flags(), add_flag(), remove_flag()
1308 msg = mailbox.MaildirMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001309 self.assertEqual(msg.get_flags(), '')
1310 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001311 msg.set_flags('F')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001312 self.assertEqual(msg.get_subdir(), 'new')
1313 self.assertEqual(msg.get_flags(), 'F')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001314 msg.set_flags('SDTP')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001315 self.assertEqual(msg.get_flags(), 'DPST')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001316 msg.add_flag('FT')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001317 self.assertEqual(msg.get_flags(), 'DFPST')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001318 msg.remove_flag('TDRP')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001319 self.assertEqual(msg.get_flags(), 'FS')
1320 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001321 self._check_sample(msg)
1322
1323 def test_date(self):
1324 # Use get_date() and set_date()
1325 msg = mailbox.MaildirMessage(_sample_message)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001326 self.assertLess(abs(msg.get_date() - time.time()), 60)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001327 msg.set_date(0.0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001328 self.assertEqual(msg.get_date(), 0.0)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001329
1330 def test_info(self):
1331 # Use get_info() and set_info()
1332 msg = mailbox.MaildirMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001333 self.assertEqual(msg.get_info(), '')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001334 msg.set_info('1,foo=bar')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001335 self.assertEqual(msg.get_info(), '1,foo=bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001336 self.assertRaises(TypeError, lambda: msg.set_info(None))
1337 self._check_sample(msg)
1338
1339 def test_info_and_flags(self):
1340 # Test interaction of info and flag methods
1341 msg = mailbox.MaildirMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001342 self.assertEqual(msg.get_info(), '')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001343 msg.set_flags('SF')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001344 self.assertEqual(msg.get_flags(), 'FS')
1345 self.assertEqual(msg.get_info(), '2,FS')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001346 msg.set_info('1,')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001347 self.assertEqual(msg.get_flags(), '')
1348 self.assertEqual(msg.get_info(), '1,')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001349 msg.remove_flag('RPT')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001350 self.assertEqual(msg.get_flags(), '')
1351 self.assertEqual(msg.get_info(), '1,')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001352 msg.add_flag('D')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001353 self.assertEqual(msg.get_flags(), 'D')
1354 self.assertEqual(msg.get_info(), '2,D')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001355 self._check_sample(msg)
1356
1357
1358class _TestMboxMMDFMessage(TestMessage):
1359
1360 _factory = mailbox._mboxMMDFMessage
1361
1362 def _post_initialize_hook(self, msg):
1363 self._check_from(msg)
1364
1365 def test_initialize_with_unixfrom(self):
1366 # Initialize with a message that already has a _unixfrom attribute
1367 msg = mailbox.Message(_sample_message)
1368 msg.set_unixfrom('From foo@bar blah')
1369 msg = mailbox.mboxMessage(msg)
Guido van Rossumea834472007-07-27 05:17:50 +00001370 self.assertEqual(msg.get_from(), 'foo@bar blah', msg.get_from())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001371
1372 def test_from(self):
1373 # Get and set "From " line
1374 msg = mailbox.mboxMessage(_sample_message)
1375 self._check_from(msg)
1376 msg.set_from('foo bar')
Guido van Rossumea834472007-07-27 05:17:50 +00001377 self.assertEqual(msg.get_from(), 'foo bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001378 msg.set_from('foo@bar', True)
1379 self._check_from(msg, 'foo@bar')
1380 msg.set_from('blah@temp', time.localtime())
1381 self._check_from(msg, 'blah@temp')
1382
1383 def test_flags(self):
1384 # Use get_flags(), set_flags(), add_flag(), remove_flag()
1385 msg = mailbox.mboxMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001386 self.assertEqual(msg.get_flags(), '')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001387 msg.set_flags('F')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001388 self.assertEqual(msg.get_flags(), 'F')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001389 msg.set_flags('XODR')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001390 self.assertEqual(msg.get_flags(), 'RODX')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001391 msg.add_flag('FA')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001392 self.assertEqual(msg.get_flags(), 'RODFAX')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001393 msg.remove_flag('FDXA')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001394 self.assertEqual(msg.get_flags(), 'RO')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001395 self._check_sample(msg)
1396
1397 def _check_from(self, msg, sender=None):
1398 # Check contents of "From " line
1399 if sender is None:
1400 sender = "MAILER-DAEMON"
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001401 self.assertTrue(re.match(sender + r" \w{3} \w{3} [\d ]\d [\d ]\d:\d{2}:"
Thomas Wouters477c8d52006-05-27 19:21:47 +00001402 r"\d{2} \d{4}", msg.get_from()) is not None)
1403
1404
1405class TestMboxMessage(_TestMboxMMDFMessage):
1406
1407 _factory = mailbox.mboxMessage
1408
1409
1410class TestMHMessage(TestMessage):
1411
1412 _factory = mailbox.MHMessage
1413
1414 def _post_initialize_hook(self, msg):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001415 self.assertEqual(msg._sequences, [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001416
1417 def test_sequences(self):
1418 # Get, set, join, and leave sequences
1419 msg = mailbox.MHMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001420 self.assertEqual(msg.get_sequences(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001421 msg.set_sequences(['foobar'])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001422 self.assertEqual(msg.get_sequences(), ['foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001423 msg.set_sequences([])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001424 self.assertEqual(msg.get_sequences(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001425 msg.add_sequence('unseen')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001426 self.assertEqual(msg.get_sequences(), ['unseen'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001427 msg.add_sequence('flagged')
Guido van Rossumea834472007-07-27 05:17:50 +00001428 self.assertEqual(msg.get_sequences(), ['unseen', 'flagged'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001429 msg.add_sequence('flagged')
Guido van Rossumea834472007-07-27 05:17:50 +00001430 self.assertEqual(msg.get_sequences(), ['unseen', 'flagged'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001431 msg.remove_sequence('unseen')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001432 self.assertEqual(msg.get_sequences(), ['flagged'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001433 msg.add_sequence('foobar')
Guido van Rossumea834472007-07-27 05:17:50 +00001434 self.assertEqual(msg.get_sequences(), ['flagged', 'foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001435 msg.remove_sequence('replied')
Guido van Rossumea834472007-07-27 05:17:50 +00001436 self.assertEqual(msg.get_sequences(), ['flagged', 'foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001437 msg.set_sequences(['foobar', 'replied'])
Guido van Rossumea834472007-07-27 05:17:50 +00001438 self.assertEqual(msg.get_sequences(), ['foobar', 'replied'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001439
1440
1441class TestBabylMessage(TestMessage):
1442
1443 _factory = mailbox.BabylMessage
1444
1445 def _post_initialize_hook(self, msg):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001446 self.assertEqual(msg._labels, [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001447
1448 def test_labels(self):
1449 # Get, set, join, and leave labels
1450 msg = mailbox.BabylMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001451 self.assertEqual(msg.get_labels(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001452 msg.set_labels(['foobar'])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001453 self.assertEqual(msg.get_labels(), ['foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001454 msg.set_labels([])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001455 self.assertEqual(msg.get_labels(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001456 msg.add_label('filed')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001457 self.assertEqual(msg.get_labels(), ['filed'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001458 msg.add_label('resent')
Guido van Rossumea834472007-07-27 05:17:50 +00001459 self.assertEqual(msg.get_labels(), ['filed', 'resent'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001460 msg.add_label('resent')
Guido van Rossumea834472007-07-27 05:17:50 +00001461 self.assertEqual(msg.get_labels(), ['filed', 'resent'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001462 msg.remove_label('filed')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001463 self.assertEqual(msg.get_labels(), ['resent'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001464 msg.add_label('foobar')
Guido van Rossumea834472007-07-27 05:17:50 +00001465 self.assertEqual(msg.get_labels(), ['resent', 'foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001466 msg.remove_label('unseen')
Guido van Rossumea834472007-07-27 05:17:50 +00001467 self.assertEqual(msg.get_labels(), ['resent', 'foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001468 msg.set_labels(['foobar', 'answered'])
Guido van Rossumea834472007-07-27 05:17:50 +00001469 self.assertEqual(msg.get_labels(), ['foobar', 'answered'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001470
1471 def test_visible(self):
1472 # Get, set, and update visible headers
1473 msg = mailbox.BabylMessage(_sample_message)
1474 visible = msg.get_visible()
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001475 self.assertEqual(visible.keys(), [])
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001476 self.assertIs(visible.get_payload(), None)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001477 visible['User-Agent'] = 'FooBar 1.0'
1478 visible['X-Whatever'] = 'Blah'
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001479 self.assertEqual(msg.get_visible().keys(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001480 msg.set_visible(visible)
1481 visible = msg.get_visible()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001482 self.assertTrue(visible.keys() == ['User-Agent', 'X-Whatever'])
1483 self.assertTrue(visible['User-Agent'] == 'FooBar 1.0')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001484 self.assertEqual(visible['X-Whatever'], 'Blah')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001485 self.assertIs(visible.get_payload(), None)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001486 msg.update_visible()
Guido van Rossumea834472007-07-27 05:17:50 +00001487 self.assertEqual(visible.keys(), ['User-Agent', 'X-Whatever'])
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001488 self.assertIs(visible.get_payload(), None)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001489 visible = msg.get_visible()
Guido van Rossumea834472007-07-27 05:17:50 +00001490 self.assertEqual(visible.keys(), ['User-Agent', 'Date', 'From', 'To',
1491 'Subject'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001492 for header in ('User-Agent', 'Date', 'From', 'To', 'Subject'):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001493 self.assertEqual(visible[header], msg[header])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001494
1495
1496class TestMMDFMessage(_TestMboxMMDFMessage):
1497
1498 _factory = mailbox.MMDFMessage
1499
1500
1501class TestMessageConversion(TestBase):
1502
1503 def test_plain_to_x(self):
1504 # Convert Message to all formats
1505 for class_ in (mailbox.Message, mailbox.MaildirMessage,
1506 mailbox.mboxMessage, mailbox.MHMessage,
1507 mailbox.BabylMessage, mailbox.MMDFMessage):
1508 msg_plain = mailbox.Message(_sample_message)
1509 msg = class_(msg_plain)
1510 self._check_sample(msg)
1511
1512 def test_x_to_plain(self):
1513 # Convert all formats to Message
1514 for class_ in (mailbox.Message, mailbox.MaildirMessage,
1515 mailbox.mboxMessage, mailbox.MHMessage,
1516 mailbox.BabylMessage, mailbox.MMDFMessage):
1517 msg = class_(_sample_message)
1518 msg_plain = mailbox.Message(msg)
1519 self._check_sample(msg_plain)
1520
R. David Murrayb7deff12011-01-30 06:21:28 +00001521 def test_x_from_bytes(self):
1522 # Convert all formats to Message
1523 for class_ in (mailbox.Message, mailbox.MaildirMessage,
1524 mailbox.mboxMessage, mailbox.MHMessage,
1525 mailbox.BabylMessage, mailbox.MMDFMessage):
1526 msg = class_(_bytes_sample_message)
1527 self._check_sample(msg)
1528
Thomas Wouters477c8d52006-05-27 19:21:47 +00001529 def test_x_to_invalid(self):
1530 # Convert all formats to an invalid format
1531 for class_ in (mailbox.Message, mailbox.MaildirMessage,
1532 mailbox.mboxMessage, mailbox.MHMessage,
1533 mailbox.BabylMessage, mailbox.MMDFMessage):
1534 self.assertRaises(TypeError, lambda: class_(False))
1535
1536 def test_maildir_to_maildir(self):
1537 # Convert MaildirMessage to MaildirMessage
1538 msg_maildir = mailbox.MaildirMessage(_sample_message)
1539 msg_maildir.set_flags('DFPRST')
1540 msg_maildir.set_subdir('cur')
1541 date = msg_maildir.get_date()
1542 msg = mailbox.MaildirMessage(msg_maildir)
1543 self._check_sample(msg)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001544 self.assertEqual(msg.get_flags(), 'DFPRST')
1545 self.assertEqual(msg.get_subdir(), 'cur')
1546 self.assertEqual(msg.get_date(), date)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001547
1548 def test_maildir_to_mboxmmdf(self):
1549 # Convert MaildirMessage to mboxmessage and MMDFMessage
1550 pairs = (('D', ''), ('F', 'F'), ('P', ''), ('R', 'A'), ('S', 'R'),
1551 ('T', 'D'), ('DFPRST', 'RDFA'))
1552 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1553 msg_maildir = mailbox.MaildirMessage(_sample_message)
1554 msg_maildir.set_date(0.0)
1555 for setting, result in pairs:
1556 msg_maildir.set_flags(setting)
1557 msg = class_(msg_maildir)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001558 self.assertEqual(msg.get_flags(), result)
Guido van Rossumea834472007-07-27 05:17:50 +00001559 self.assertEqual(msg.get_from(), 'MAILER-DAEMON %s' %
Thomas Wouters477c8d52006-05-27 19:21:47 +00001560 time.asctime(time.gmtime(0.0)))
1561 msg_maildir.set_subdir('cur')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001562 self.assertEqual(class_(msg_maildir).get_flags(), 'RODFA')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001563
1564 def test_maildir_to_mh(self):
1565 # Convert MaildirMessage to MHMessage
1566 msg_maildir = mailbox.MaildirMessage(_sample_message)
1567 pairs = (('D', ['unseen']), ('F', ['unseen', 'flagged']),
1568 ('P', ['unseen']), ('R', ['unseen', 'replied']), ('S', []),
1569 ('T', ['unseen']), ('DFPRST', ['replied', 'flagged']))
1570 for setting, result in pairs:
1571 msg_maildir.set_flags(setting)
Guido van Rossumea834472007-07-27 05:17:50 +00001572 self.assertEqual(mailbox.MHMessage(msg_maildir).get_sequences(),
1573 result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001574
1575 def test_maildir_to_babyl(self):
1576 # Convert MaildirMessage to Babyl
1577 msg_maildir = mailbox.MaildirMessage(_sample_message)
1578 pairs = (('D', ['unseen']), ('F', ['unseen']),
1579 ('P', ['unseen', 'forwarded']), ('R', ['unseen', 'answered']),
1580 ('S', []), ('T', ['unseen', 'deleted']),
1581 ('DFPRST', ['deleted', 'answered', 'forwarded']))
1582 for setting, result in pairs:
1583 msg_maildir.set_flags(setting)
Guido van Rossumea834472007-07-27 05:17:50 +00001584 self.assertEqual(mailbox.BabylMessage(msg_maildir).get_labels(),
1585 result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001586
1587 def test_mboxmmdf_to_maildir(self):
1588 # Convert mboxMessage and MMDFMessage to MaildirMessage
1589 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1590 msg_mboxMMDF = class_(_sample_message)
1591 msg_mboxMMDF.set_from('foo@bar', time.gmtime(0.0))
1592 pairs = (('R', 'S'), ('O', ''), ('D', 'T'), ('F', 'F'), ('A', 'R'),
1593 ('RODFA', 'FRST'))
1594 for setting, result in pairs:
1595 msg_mboxMMDF.set_flags(setting)
1596 msg = mailbox.MaildirMessage(msg_mboxMMDF)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001597 self.assertEqual(msg.get_flags(), result)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001598 self.assertEqual(msg.get_date(), 0.0)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001599 msg_mboxMMDF.set_flags('O')
Guido van Rossumea834472007-07-27 05:17:50 +00001600 self.assertEqual(mailbox.MaildirMessage(msg_mboxMMDF).get_subdir(),
1601 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001602
1603 def test_mboxmmdf_to_mboxmmdf(self):
1604 # Convert mboxMessage and MMDFMessage to mboxMessage and MMDFMessage
1605 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1606 msg_mboxMMDF = class_(_sample_message)
1607 msg_mboxMMDF.set_flags('RODFA')
1608 msg_mboxMMDF.set_from('foo@bar')
1609 for class2_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1610 msg2 = class2_(msg_mboxMMDF)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001611 self.assertEqual(msg2.get_flags(), 'RODFA')
1612 self.assertEqual(msg2.get_from(), 'foo@bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001613
1614 def test_mboxmmdf_to_mh(self):
1615 # Convert mboxMessage and MMDFMessage to MHMessage
1616 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1617 msg_mboxMMDF = class_(_sample_message)
1618 pairs = (('R', []), ('O', ['unseen']), ('D', ['unseen']),
1619 ('F', ['unseen', 'flagged']),
1620 ('A', ['unseen', 'replied']),
1621 ('RODFA', ['replied', 'flagged']))
1622 for setting, result in pairs:
1623 msg_mboxMMDF.set_flags(setting)
Guido van Rossumea834472007-07-27 05:17:50 +00001624 self.assertEqual(mailbox.MHMessage(msg_mboxMMDF).get_sequences(),
1625 result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001626
1627 def test_mboxmmdf_to_babyl(self):
1628 # Convert mboxMessage and MMDFMessage to BabylMessage
1629 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1630 msg = class_(_sample_message)
1631 pairs = (('R', []), ('O', ['unseen']),
1632 ('D', ['unseen', 'deleted']), ('F', ['unseen']),
1633 ('A', ['unseen', 'answered']),
1634 ('RODFA', ['deleted', 'answered']))
1635 for setting, result in pairs:
1636 msg.set_flags(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001637 self.assertEqual(mailbox.BabylMessage(msg).get_labels(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001638
1639 def test_mh_to_maildir(self):
1640 # Convert MHMessage to MaildirMessage
1641 pairs = (('unseen', ''), ('replied', 'RS'), ('flagged', 'FS'))
1642 for setting, result in pairs:
1643 msg = mailbox.MHMessage(_sample_message)
1644 msg.add_sequence(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001645 self.assertEqual(mailbox.MaildirMessage(msg).get_flags(), result)
1646 self.assertEqual(mailbox.MaildirMessage(msg).get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001647 msg = mailbox.MHMessage(_sample_message)
1648 msg.add_sequence('unseen')
1649 msg.add_sequence('replied')
1650 msg.add_sequence('flagged')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001651 self.assertEqual(mailbox.MaildirMessage(msg).get_flags(), 'FR')
1652 self.assertEqual(mailbox.MaildirMessage(msg).get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001653
1654 def test_mh_to_mboxmmdf(self):
1655 # Convert MHMessage to mboxMessage and MMDFMessage
1656 pairs = (('unseen', 'O'), ('replied', 'ROA'), ('flagged', 'ROF'))
1657 for setting, result in pairs:
1658 msg = mailbox.MHMessage(_sample_message)
1659 msg.add_sequence(setting)
1660 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001661 self.assertEqual(class_(msg).get_flags(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001662 msg = mailbox.MHMessage(_sample_message)
1663 msg.add_sequence('unseen')
1664 msg.add_sequence('replied')
1665 msg.add_sequence('flagged')
1666 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001667 self.assertEqual(class_(msg).get_flags(), 'OFA')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001668
1669 def test_mh_to_mh(self):
1670 # Convert MHMessage to MHMessage
1671 msg = mailbox.MHMessage(_sample_message)
1672 msg.add_sequence('unseen')
1673 msg.add_sequence('replied')
1674 msg.add_sequence('flagged')
Guido van Rossumea834472007-07-27 05:17:50 +00001675 self.assertEqual(mailbox.MHMessage(msg).get_sequences(),
1676 ['unseen', 'replied', 'flagged'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001677
1678 def test_mh_to_babyl(self):
1679 # Convert MHMessage to BabylMessage
1680 pairs = (('unseen', ['unseen']), ('replied', ['answered']),
1681 ('flagged', []))
1682 for setting, result in pairs:
1683 msg = mailbox.MHMessage(_sample_message)
1684 msg.add_sequence(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001685 self.assertEqual(mailbox.BabylMessage(msg).get_labels(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001686 msg = mailbox.MHMessage(_sample_message)
1687 msg.add_sequence('unseen')
1688 msg.add_sequence('replied')
1689 msg.add_sequence('flagged')
Guido van Rossumea834472007-07-27 05:17:50 +00001690 self.assertEqual(mailbox.BabylMessage(msg).get_labels(),
1691 ['unseen', 'answered'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001692
1693 def test_babyl_to_maildir(self):
1694 # Convert BabylMessage to MaildirMessage
1695 pairs = (('unseen', ''), ('deleted', 'ST'), ('filed', 'S'),
1696 ('answered', 'RS'), ('forwarded', 'PS'), ('edited', 'S'),
1697 ('resent', 'PS'))
1698 for setting, result in pairs:
1699 msg = mailbox.BabylMessage(_sample_message)
1700 msg.add_label(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001701 self.assertEqual(mailbox.MaildirMessage(msg).get_flags(), result)
1702 self.assertEqual(mailbox.MaildirMessage(msg).get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001703 msg = mailbox.BabylMessage(_sample_message)
1704 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1705 'edited', 'resent'):
1706 msg.add_label(label)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001707 self.assertEqual(mailbox.MaildirMessage(msg).get_flags(), 'PRT')
1708 self.assertEqual(mailbox.MaildirMessage(msg).get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001709
1710 def test_babyl_to_mboxmmdf(self):
1711 # Convert BabylMessage to mboxMessage and MMDFMessage
1712 pairs = (('unseen', 'O'), ('deleted', 'ROD'), ('filed', 'RO'),
1713 ('answered', 'ROA'), ('forwarded', 'RO'), ('edited', 'RO'),
1714 ('resent', 'RO'))
1715 for setting, result in pairs:
1716 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1717 msg = mailbox.BabylMessage(_sample_message)
1718 msg.add_label(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001719 self.assertEqual(class_(msg).get_flags(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001720 msg = mailbox.BabylMessage(_sample_message)
1721 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1722 'edited', 'resent'):
1723 msg.add_label(label)
1724 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001725 self.assertEqual(class_(msg).get_flags(), 'ODA')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001726
1727 def test_babyl_to_mh(self):
1728 # Convert BabylMessage to MHMessage
1729 pairs = (('unseen', ['unseen']), ('deleted', []), ('filed', []),
1730 ('answered', ['replied']), ('forwarded', []), ('edited', []),
1731 ('resent', []))
1732 for setting, result in pairs:
1733 msg = mailbox.BabylMessage(_sample_message)
1734 msg.add_label(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001735 self.assertEqual(mailbox.MHMessage(msg).get_sequences(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001736 msg = mailbox.BabylMessage(_sample_message)
1737 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1738 'edited', 'resent'):
1739 msg.add_label(label)
Guido van Rossumea834472007-07-27 05:17:50 +00001740 self.assertEqual(mailbox.MHMessage(msg).get_sequences(),
1741 ['unseen', 'replied'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001742
1743 def test_babyl_to_babyl(self):
1744 # Convert BabylMessage to BabylMessage
1745 msg = mailbox.BabylMessage(_sample_message)
1746 msg.update_visible()
1747 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1748 'edited', 'resent'):
1749 msg.add_label(label)
1750 msg2 = mailbox.BabylMessage(msg)
Guido van Rossumea834472007-07-27 05:17:50 +00001751 self.assertEqual(msg2.get_labels(), ['unseen', 'deleted', 'filed',
1752 'answered', 'forwarded', 'edited',
1753 'resent'])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001754 self.assertEqual(msg.get_visible().keys(), msg2.get_visible().keys())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001755 for key in msg.get_visible().keys():
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001756 self.assertEqual(msg.get_visible()[key], msg2.get_visible()[key])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001757
1758
1759class TestProxyFileBase(TestBase):
1760
1761 def _test_read(self, proxy):
1762 # Read by byte
1763 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001764 self.assertEqual(proxy.read(), b'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001765 proxy.seek(1)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001766 self.assertEqual(proxy.read(), b'ar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001767 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001768 self.assertEqual(proxy.read(2), b'ba')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001769 proxy.seek(1)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001770 self.assertEqual(proxy.read(-1), b'ar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001771 proxy.seek(2)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001772 self.assertEqual(proxy.read(1000), b'r')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001773
1774 def _test_readline(self, proxy):
1775 # Read by line
Guido van Rossum98297ee2007-11-06 21:34:58 +00001776 linesep = os.linesep.encode()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001777 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001778 self.assertEqual(proxy.readline(), b'foo' + linesep)
1779 self.assertEqual(proxy.readline(), b'bar' + linesep)
1780 self.assertEqual(proxy.readline(), b'fred' + linesep)
1781 self.assertEqual(proxy.readline(), b'bob')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001782 proxy.seek(2)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001783 self.assertEqual(proxy.readline(), b'o' + linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001784 proxy.seek(6 + 2 * len(os.linesep))
Guido van Rossum98297ee2007-11-06 21:34:58 +00001785 self.assertEqual(proxy.readline(), b'fred' + linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001786 proxy.seek(6 + 2 * len(os.linesep))
Guido van Rossum98297ee2007-11-06 21:34:58 +00001787 self.assertEqual(proxy.readline(2), b'fr')
1788 self.assertEqual(proxy.readline(-10), b'ed' + linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001789
1790 def _test_readlines(self, proxy):
1791 # Read multiple lines
Guido van Rossum98297ee2007-11-06 21:34:58 +00001792 linesep = os.linesep.encode()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001793 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001794 self.assertEqual(proxy.readlines(), [b'foo' + linesep,
1795 b'bar' + linesep,
1796 b'fred' + linesep, b'bob'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001797 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001798 self.assertEqual(proxy.readlines(2), [b'foo' + linesep])
1799 proxy.seek(3 + len(linesep))
1800 self.assertEqual(proxy.readlines(4 + len(linesep)),
1801 [b'bar' + linesep, b'fred' + linesep])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001802 proxy.seek(3)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001803 self.assertEqual(proxy.readlines(1000), [linesep, b'bar' + linesep,
1804 b'fred' + linesep, b'bob'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001805
1806 def _test_iteration(self, proxy):
1807 # Iterate by line
Guido van Rossum98297ee2007-11-06 21:34:58 +00001808 linesep = os.linesep.encode()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001809 proxy.seek(0)
1810 iterator = iter(proxy)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001811 self.assertEqual(next(iterator), b'foo' + linesep)
1812 self.assertEqual(next(iterator), b'bar' + linesep)
1813 self.assertEqual(next(iterator), b'fred' + linesep)
1814 self.assertEqual(next(iterator), b'bob')
Georg Brandla18af4e2007-04-21 15:47:16 +00001815 self.assertRaises(StopIteration, next, iterator)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001816
1817 def _test_seek_and_tell(self, proxy):
1818 # Seek and use tell to check position
Guido van Rossum98297ee2007-11-06 21:34:58 +00001819 linesep = os.linesep.encode()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001820 proxy.seek(3)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001821 self.assertEqual(proxy.tell(), 3)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001822 self.assertEqual(proxy.read(len(linesep)), linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001823 proxy.seek(2, 1)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001824 self.assertEqual(proxy.read(1 + len(linesep)), b'r' + linesep)
1825 proxy.seek(-3 - len(linesep), 2)
1826 self.assertEqual(proxy.read(3), b'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001827 proxy.seek(2, 0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001828 self.assertEqual(proxy.read(), b'o' + linesep + b'bar' + linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001829 proxy.seek(100)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001830 self.assertFalse(proxy.read())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001831
1832 def _test_close(self, proxy):
1833 # Close a file
1834 proxy.close()
1835 self.assertRaises(AttributeError, lambda: proxy.close())
1836
1837
1838class TestProxyFile(TestProxyFileBase):
1839
1840 def setUp(self):
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001841 self._path = support.TESTFN
Thomas Wouters477c8d52006-05-27 19:21:47 +00001842 self._file = open(self._path, 'wb+')
1843
1844 def tearDown(self):
1845 self._file.close()
1846 self._delete_recursively(self._path)
1847
1848 def test_initialize(self):
1849 # Initialize and check position
Neal Norwitz9a923102007-08-30 06:20:05 +00001850 self._file.write(b'foo')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001851 pos = self._file.tell()
1852 proxy0 = mailbox._ProxyFile(self._file)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001853 self.assertEqual(proxy0.tell(), pos)
1854 self.assertEqual(self._file.tell(), pos)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001855 proxy1 = mailbox._ProxyFile(self._file, 0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001856 self.assertEqual(proxy1.tell(), 0)
1857 self.assertEqual(self._file.tell(), pos)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001858
1859 def test_read(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001860 self._file.write(b'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001861 self._test_read(mailbox._ProxyFile(self._file))
1862
1863 def test_readline(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001864 self._file.write(bytes('foo%sbar%sfred%sbob' % (os.linesep, os.linesep,
1865 os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001866 self._test_readline(mailbox._ProxyFile(self._file))
1867
1868 def test_readlines(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001869 self._file.write(bytes('foo%sbar%sfred%sbob' % (os.linesep, os.linesep,
1870 os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001871 self._test_readlines(mailbox._ProxyFile(self._file))
1872
1873 def test_iteration(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001874 self._file.write(bytes('foo%sbar%sfred%sbob' % (os.linesep, os.linesep,
1875 os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001876 self._test_iteration(mailbox._ProxyFile(self._file))
1877
1878 def test_seek_and_tell(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001879 self._file.write(bytes('foo%sbar%s' % (os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001880 self._test_seek_and_tell(mailbox._ProxyFile(self._file))
1881
1882 def test_close(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001883 self._file.write(bytes('foo%sbar%s' % (os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001884 self._test_close(mailbox._ProxyFile(self._file))
1885
1886
1887class TestPartialFile(TestProxyFileBase):
1888
1889 def setUp(self):
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001890 self._path = support.TESTFN
Thomas Wouters477c8d52006-05-27 19:21:47 +00001891 self._file = open(self._path, 'wb+')
1892
1893 def tearDown(self):
1894 self._file.close()
1895 self._delete_recursively(self._path)
1896
1897 def test_initialize(self):
1898 # Initialize and check position
Neal Norwitz9a923102007-08-30 06:20:05 +00001899 self._file.write(bytes('foo' + os.linesep + 'bar', 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001900 pos = self._file.tell()
1901 proxy = mailbox._PartialFile(self._file, 2, 5)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001902 self.assertEqual(proxy.tell(), 0)
1903 self.assertEqual(self._file.tell(), pos)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001904
1905 def test_read(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001906 self._file.write(bytes('***bar***', 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001907 self._test_read(mailbox._PartialFile(self._file, 3, 6))
1908
1909 def test_readline(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001910 self._file.write(bytes('!!!!!foo%sbar%sfred%sbob!!!!!' %
1911 (os.linesep, os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001912 self._test_readline(mailbox._PartialFile(self._file, 5,
1913 18 + 3 * len(os.linesep)))
1914
1915 def test_readlines(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001916 self._file.write(bytes('foo%sbar%sfred%sbob?????' %
1917 (os.linesep, os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001918 self._test_readlines(mailbox._PartialFile(self._file, 0,
1919 13 + 3 * len(os.linesep)))
1920
1921 def test_iteration(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001922 self._file.write(bytes('____foo%sbar%sfred%sbob####' %
1923 (os.linesep, os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001924 self._test_iteration(mailbox._PartialFile(self._file, 4,
1925 17 + 3 * len(os.linesep)))
1926
1927 def test_seek_and_tell(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001928 self._file.write(bytes('(((foo%sbar%s$$$' % (os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001929 self._test_seek_and_tell(mailbox._PartialFile(self._file, 3,
1930 9 + 2 * len(os.linesep)))
1931
1932 def test_close(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00001933 self._file.write(bytes('&foo%sbar%s^' % (os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001934 self._test_close(mailbox._PartialFile(self._file, 1,
1935 6 + 3 * len(os.linesep)))
1936
1937
1938## Start: tests from the original module (for backward compatibility).
1939
Skip Montanaro5253da12004-07-24 19:56:03 +00001940FROM_ = "From some.body@dummy.domain Sat Jul 24 13:43:35 2004\n"
Fred Drakec02bc3e2001-05-21 20:23:21 +00001941DUMMY_MESSAGE = """\
1942From: some.body@dummy.domain
1943To: me@my.domain
Skip Montanaro5253da12004-07-24 19:56:03 +00001944Subject: Simple Test
Fred Drakec02bc3e2001-05-21 20:23:21 +00001945
1946This is a dummy message.
1947"""
1948
Fred Drakec02bc3e2001-05-21 20:23:21 +00001949class MaildirTestCase(unittest.TestCase):
1950
1951 def setUp(self):
1952 # create a new maildir mailbox to work with:
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001953 self._dir = support.TESTFN
Fred Drakec02bc3e2001-05-21 20:23:21 +00001954 os.mkdir(self._dir)
1955 os.mkdir(os.path.join(self._dir, "cur"))
1956 os.mkdir(os.path.join(self._dir, "tmp"))
1957 os.mkdir(os.path.join(self._dir, "new"))
1958 self._counter = 1
1959 self._msgfiles = []
1960
1961 def tearDown(self):
Guido van Rossumc1f779c2007-07-03 08:25:58 +00001962 list(map(os.unlink, self._msgfiles))
Fred Drakec02bc3e2001-05-21 20:23:21 +00001963 os.rmdir(os.path.join(self._dir, "cur"))
1964 os.rmdir(os.path.join(self._dir, "tmp"))
1965 os.rmdir(os.path.join(self._dir, "new"))
1966 os.rmdir(self._dir)
1967
Skip Montanaro5253da12004-07-24 19:56:03 +00001968 def createMessage(self, dir, mbox=False):
Jack Jansen97df7b62001-06-19 20:20:05 +00001969 t = int(time.time() % 1000000)
Fred Drakec02bc3e2001-05-21 20:23:21 +00001970 pid = self._counter
1971 self._counter += 1
Skip Montanaro7a98be22007-08-16 14:35:24 +00001972 filename = ".".join((str(t), str(pid), "myhostname", "mydomain"))
Fred Drakec02bc3e2001-05-21 20:23:21 +00001973 tmpname = os.path.join(self._dir, "tmp", filename)
1974 newname = os.path.join(self._dir, dir, filename)
Brian Curtin5acec042010-10-13 02:29:46 +00001975 with open(tmpname, "w") as fp:
1976 self._msgfiles.append(tmpname)
1977 if mbox:
1978 fp.write(FROM_)
1979 fp.write(DUMMY_MESSAGE)
Tim Peters6626c1f2001-05-22 16:29:01 +00001980 if hasattr(os, "link"):
1981 os.link(tmpname, newname)
1982 else:
Brian Curtin5acec042010-10-13 02:29:46 +00001983 with open(newname, "w") as fp:
1984 fp.write(DUMMY_MESSAGE)
Fred Drakec02bc3e2001-05-21 20:23:21 +00001985 self._msgfiles.append(newname)
Skip Montanaro5253da12004-07-24 19:56:03 +00001986 return tmpname
Fred Drakec02bc3e2001-05-21 20:23:21 +00001987
1988 def test_empty_maildir(self):
1989 """Test an empty maildir mailbox"""
1990 # Test for regression on bug #117490:
1991 # Make sure the boxes attribute actually gets set.
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001992 self.mbox = mailbox.Maildir(support.TESTFN)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001993 #self.assertTrue(hasattr(self.mbox, "boxes"))
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001994 #self.assertEqual(len(self.mbox.boxes), 0)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001995 self.assertIs(self.mbox.next(), None)
1996 self.assertIs(self.mbox.next(), None)
Fred Drakec02bc3e2001-05-21 20:23:21 +00001997
1998 def test_nonempty_maildir_cur(self):
1999 self.createMessage("cur")
Benjamin Petersonee8712c2008-05-20 21:35:26 +00002000 self.mbox = mailbox.Maildir(support.TESTFN)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002001 #self.assertEqual(len(self.mbox.boxes), 1)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00002002 self.assertIsNot(self.mbox.next(), None)
2003 self.assertIs(self.mbox.next(), None)
2004 self.assertIs(self.mbox.next(), None)
Fred Drakec02bc3e2001-05-21 20:23:21 +00002005
2006 def test_nonempty_maildir_new(self):
2007 self.createMessage("new")
Benjamin Petersonee8712c2008-05-20 21:35:26 +00002008 self.mbox = mailbox.Maildir(support.TESTFN)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002009 #self.assertEqual(len(self.mbox.boxes), 1)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00002010 self.assertIsNot(self.mbox.next(), None)
2011 self.assertIs(self.mbox.next(), None)
2012 self.assertIs(self.mbox.next(), None)
Fred Drakec02bc3e2001-05-21 20:23:21 +00002013
2014 def test_nonempty_maildir_both(self):
2015 self.createMessage("cur")
2016 self.createMessage("new")
Benjamin Petersonee8712c2008-05-20 21:35:26 +00002017 self.mbox = mailbox.Maildir(support.TESTFN)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002018 #self.assertEqual(len(self.mbox.boxes), 2)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00002019 self.assertIsNot(self.mbox.next(), None)
2020 self.assertIsNot(self.mbox.next(), None)
2021 self.assertIs(self.mbox.next(), None)
2022 self.assertIs(self.mbox.next(), None)
Fred Drake0aaed272000-10-23 13:39:15 +00002023
Georg Brandledb978f2008-05-11 08:59:40 +00002024## End: tests from the original module (for backward compatibility).
Thomas Wouters477c8d52006-05-27 19:21:47 +00002025
2026
2027_sample_message = """\
2028Return-Path: <gkj@gregorykjohnson.com>
2029X-Original-To: gkj+person@localhost
2030Delivered-To: gkj+person@localhost
2031Received: from localhost (localhost [127.0.0.1])
2032 by andy.gregorykjohnson.com (Postfix) with ESMTP id 356ED9DD17
2033 for <gkj+person@localhost>; Wed, 13 Jul 2005 17:23:16 -0400 (EDT)
2034Delivered-To: gkj@sundance.gregorykjohnson.com
2035Received: from localhost [127.0.0.1]
2036 by localhost with POP3 (fetchmail-6.2.5)
2037 for gkj+person@localhost (single-drop); Wed, 13 Jul 2005 17:23:16 -0400 (EDT)
2038Received: from andy.gregorykjohnson.com (andy.gregorykjohnson.com [64.32.235.228])
2039 by sundance.gregorykjohnson.com (Postfix) with ESMTP id 5B056316746
2040 for <gkj@gregorykjohnson.com>; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)
2041Received: by andy.gregorykjohnson.com (Postfix, from userid 1000)
2042 id 490CD9DD17; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)
2043Date: Wed, 13 Jul 2005 17:23:11 -0400
2044From: "Gregory K. Johnson" <gkj@gregorykjohnson.com>
2045To: gkj@gregorykjohnson.com
2046Subject: Sample message
2047Message-ID: <20050713212311.GC4701@andy.gregorykjohnson.com>
2048Mime-Version: 1.0
2049Content-Type: multipart/mixed; boundary="NMuMz9nt05w80d4+"
2050Content-Disposition: inline
2051User-Agent: Mutt/1.5.9i
2052
2053
2054--NMuMz9nt05w80d4+
2055Content-Type: text/plain; charset=us-ascii
2056Content-Disposition: inline
2057
2058This is a sample message.
2059
2060--
2061Gregory K. Johnson
2062
2063--NMuMz9nt05w80d4+
2064Content-Type: application/octet-stream
2065Content-Disposition: attachment; filename="text.gz"
2066Content-Transfer-Encoding: base64
2067
2068H4sICM2D1UIAA3RleHQAC8nILFYAokSFktSKEoW0zJxUPa7wzJIMhZLyfIWczLzUYj0uAHTs
20693FYlAAAA
2070
2071--NMuMz9nt05w80d4+--
2072"""
2073
R. David Murrayb7deff12011-01-30 06:21:28 +00002074_bytes_sample_message = _sample_message.encode('ascii')
2075
Thomas Wouters477c8d52006-05-27 19:21:47 +00002076_sample_headers = {
2077 "Return-Path":"<gkj@gregorykjohnson.com>",
2078 "X-Original-To":"gkj+person@localhost",
2079 "Delivered-To":"gkj+person@localhost",
2080 "Received":"""from localhost (localhost [127.0.0.1])
2081 by andy.gregorykjohnson.com (Postfix) with ESMTP id 356ED9DD17
2082 for <gkj+person@localhost>; Wed, 13 Jul 2005 17:23:16 -0400 (EDT)""",
2083 "Delivered-To":"gkj@sundance.gregorykjohnson.com",
2084 "Received":"""from localhost [127.0.0.1]
2085 by localhost with POP3 (fetchmail-6.2.5)
2086 for gkj+person@localhost (single-drop); Wed, 13 Jul 2005 17:23:16 -0400 (EDT)""",
2087 "Received":"""from andy.gregorykjohnson.com (andy.gregorykjohnson.com [64.32.235.228])
2088 by sundance.gregorykjohnson.com (Postfix) with ESMTP id 5B056316746
2089 for <gkj@gregorykjohnson.com>; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)""",
2090 "Received":"""by andy.gregorykjohnson.com (Postfix, from userid 1000)
2091 id 490CD9DD17; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)""",
2092 "Date":"Wed, 13 Jul 2005 17:23:11 -0400",
2093 "From":""""Gregory K. Johnson" <gkj@gregorykjohnson.com>""",
2094 "To":"gkj@gregorykjohnson.com",
2095 "Subject":"Sample message",
2096 "Mime-Version":"1.0",
2097 "Content-Type":"""multipart/mixed; boundary="NMuMz9nt05w80d4+\"""",
2098 "Content-Disposition":"inline",
2099 "User-Agent": "Mutt/1.5.9i" }
2100
2101_sample_payloads = ("""This is a sample message.
2102
2103--
2104Gregory K. Johnson
2105""",
2106"""H4sICM2D1UIAA3RleHQAC8nILFYAokSFktSKEoW0zJxUPa7wzJIMhZLyfIWczLzUYj0uAHTs
21073FYlAAAA
2108""")
Fred Drake0aaed272000-10-23 13:39:15 +00002109
Fred Drakec02bc3e2001-05-21 20:23:21 +00002110
Fred Drake2e2be372001-09-20 21:33:42 +00002111def test_main():
Thomas Wouters477c8d52006-05-27 19:21:47 +00002112 tests = (TestMailboxSuperclass, TestMaildir, TestMbox, TestMMDF, TestMH,
2113 TestBabyl, TestMessage, TestMaildirMessage, TestMboxMessage,
2114 TestMHMessage, TestBabylMessage, TestMMDFMessage,
2115 TestMessageConversion, TestProxyFile, TestPartialFile,
2116 MaildirTestCase)
Benjamin Petersonee8712c2008-05-20 21:35:26 +00002117 support.run_unittest(*tests)
2118 support.reap_children()
Fred Drake2e2be372001-09-20 21:33:42 +00002119
2120
Thomas Wouters477c8d52006-05-27 19:21:47 +00002121if __name__ == '__main__':
Fred Drake2e2be372001-09-20 21:33:42 +00002122 test_main()