blob: 346c9f1c559cd50225e6bd1a23b31ba61dbae31a [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
Hai Shi96a6a6d2020-07-09 21:25:10 +080012from test.support import os_helper
Thomas Wouters477c8d52006-05-27 19:21:47 +000013import unittest
R. David Murrayb7deff12011-01-30 06:21:28 +000014import textwrap
Thomas Wouters477c8d52006-05-27 19:21:47 +000015import mailbox
16import glob
Guido van Rossum75ebb292001-04-10 15:01:20 +000017
Thomas Wouters477c8d52006-05-27 19:21:47 +000018
R David Murray317c8d22012-04-08 16:46:18 -040019class TestBase:
Thomas Wouters477c8d52006-05-27 19:21:47 +000020
R David Murrayc988e242012-04-08 21:00:27 -040021 all_mailbox_types = (mailbox.Message, mailbox.MaildirMessage,
22 mailbox.mboxMessage, mailbox.MHMessage,
23 mailbox.BabylMessage, mailbox.MMDFMessage)
24
Thomas Wouters477c8d52006-05-27 19:21:47 +000025 def _check_sample(self, msg):
26 # Inspect a mailbox.Message representation of the sample message
Ezio Melottie9615932010-01-24 19:26:24 +000027 self.assertIsInstance(msg, email.message.Message)
28 self.assertIsInstance(msg, mailbox.Message)
Guido van Rossumcc2b0162007-02-11 06:12:03 +000029 for key, value in _sample_headers.items():
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +000030 self.assertIn(value, msg.get_all(key))
Benjamin Petersonc9c0f202009-06-30 23:06:06 +000031 self.assertTrue(msg.is_multipart())
Guido van Rossume61fd5b2007-07-11 12:20:59 +000032 self.assertEqual(len(msg.get_payload()), len(_sample_payloads))
Thomas Wouters477c8d52006-05-27 19:21:47 +000033 for i, payload in enumerate(_sample_payloads):
34 part = msg.get_payload(i)
Ezio Melottie9615932010-01-24 19:26:24 +000035 self.assertIsInstance(part, email.message.Message)
36 self.assertNotIsInstance(part, mailbox.Message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +000037 self.assertEqual(part.get_payload(), payload)
Thomas Wouters477c8d52006-05-27 19:21:47 +000038
39 def _delete_recursively(self, target):
40 # Delete a file or delete a directory recursively
41 if os.path.isdir(target):
Hai Shi96a6a6d2020-07-09 21:25:10 +080042 os_helper.rmtree(target)
Thomas Wouters477c8d52006-05-27 19:21:47 +000043 elif os.path.exists(target):
Hai Shi96a6a6d2020-07-09 21:25:10 +080044 os_helper.unlink(target)
Thomas Wouters477c8d52006-05-27 19:21:47 +000045
46
47class TestMailbox(TestBase):
48
R. David Murrayb7deff12011-01-30 06:21:28 +000049 maxDiff = None
50
Thomas Wouters477c8d52006-05-27 19:21:47 +000051 _factory = None # Overridden by subclasses to reuse tests
Petri Lehtinen46809192012-09-25 21:58:51 +030052 _template = 'From: foo\n\n%s\n'
Thomas Wouters477c8d52006-05-27 19:21:47 +000053
54 def setUp(self):
Hai Shi96a6a6d2020-07-09 21:25:10 +080055 self._path = os_helper.TESTFN
Guido van Rossumd8faa362007-04-27 19:54:29 +000056 self._delete_recursively(self._path)
Thomas Wouters477c8d52006-05-27 19:21:47 +000057 self._box = self._factory(self._path)
58
59 def tearDown(self):
Guido van Rossumc12a8132007-10-26 04:29:23 +000060 self._box.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +000061 self._delete_recursively(self._path)
62
63 def test_add(self):
64 # Add copies of a sample message
65 keys = []
66 keys.append(self._box.add(self._template % 0))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000067 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +000068 keys.append(self._box.add(mailbox.Message(_sample_message)))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000069 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +000070 keys.append(self._box.add(email.message_from_string(_sample_message)))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000071 self.assertEqual(len(self._box), 3)
R. David Murrayb7deff12011-01-30 06:21:28 +000072 keys.append(self._box.add(io.BytesIO(_bytes_sample_message)))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000073 self.assertEqual(len(self._box), 4)
Thomas Wouters477c8d52006-05-27 19:21:47 +000074 keys.append(self._box.add(_sample_message))
Guido van Rossume61fd5b2007-07-11 12:20:59 +000075 self.assertEqual(len(self._box), 5)
R. David Murrayb7deff12011-01-30 06:21:28 +000076 keys.append(self._box.add(_bytes_sample_message))
77 self.assertEqual(len(self._box), 6)
78 with self.assertWarns(DeprecationWarning):
79 keys.append(self._box.add(
80 io.TextIOWrapper(io.BytesIO(_bytes_sample_message))))
81 self.assertEqual(len(self._box), 7)
Guido van Rossumea834472007-07-27 05:17:50 +000082 self.assertEqual(self._box.get_string(keys[0]), self._template % 0)
R. David Murrayb7deff12011-01-30 06:21:28 +000083 for i in (1, 2, 3, 4, 5, 6):
Thomas Wouters477c8d52006-05-27 19:21:47 +000084 self._check_sample(self._box[keys[i]])
85
R. David Murrayb7deff12011-01-30 06:21:28 +000086 _nonascii_msg = textwrap.dedent("""\
87 From: foo
88 Subject: Falinaptár házhozszállítással. Már rendeltél?
89
90 0
91 """)
92
93 def test_add_invalid_8bit_bytes_header(self):
Marc-André Lemburg8f36af72011-02-25 15:42:01 +000094 key = self._box.add(self._nonascii_msg.encode('latin-1'))
R. David Murrayb7deff12011-01-30 06:21:28 +000095 self.assertEqual(len(self._box), 1)
96 self.assertEqual(self._box.get_bytes(key),
Marc-André Lemburg8f36af72011-02-25 15:42:01 +000097 self._nonascii_msg.encode('latin-1'))
R. David Murrayb7deff12011-01-30 06:21:28 +000098
99 def test_invalid_nonascii_header_as_string(self):
100 subj = self._nonascii_msg.splitlines()[1]
Marc-André Lemburg8f36af72011-02-25 15:42:01 +0000101 key = self._box.add(subj.encode('latin-1'))
R. David Murrayb7deff12011-01-30 06:21:28 +0000102 self.assertEqual(self._box.get_string(key),
103 'Subject: =?unknown-8bit?b?RmFsaW5hcHThciBo4Xpob3pzeuFsbO104XNz'
104 'YWwuIE3hciByZW5kZWx06Ww/?=\n\n')
105
R. David Murrayfc141142011-02-11 22:47:17 +0000106 def test_add_nonascii_string_header_raises(self):
R. David Murrayb7deff12011-01-30 06:21:28 +0000107 with self.assertRaisesRegex(ValueError, "ASCII-only"):
108 self._box.add(self._nonascii_msg)
R. David Murrayfc141142011-02-11 22:47:17 +0000109 self._box.flush()
110 self.assertEqual(len(self._box), 0)
111 self.assertMailboxEmpty()
112
113 def test_add_that_raises_leaves_mailbox_empty(self):
R David Murray7441a7a2012-03-14 02:59:51 -0400114 def raiser(*args, **kw):
115 raise Exception("a fake error")
116 support.patch(self, email.generator.BytesGenerator, 'flatten', raiser)
117 with self.assertRaises(Exception):
R. David Murrayfc141142011-02-11 22:47:17 +0000118 self._box.add(email.message_from_string("From: Alphöso"))
119 self.assertEqual(len(self._box), 0)
120 self._box.close()
121 self.assertMailboxEmpty()
R. David Murrayb7deff12011-01-30 06:21:28 +0000122
123 _non_latin_bin_msg = textwrap.dedent("""\
124 From: foo@bar.com
125 To: báz
126 Subject: Maintenant je vous présente mon collègue, le pouf célèbre
127 \tJean de Baddie
128 Mime-Version: 1.0
129 Content-Type: text/plain; charset="utf-8"
130 Content-Transfer-Encoding: 8bit
131
132 Да, они летят.
133 """).encode('utf-8')
134
135 def test_add_8bit_body(self):
136 key = self._box.add(self._non_latin_bin_msg)
137 self.assertEqual(self._box.get_bytes(key),
138 self._non_latin_bin_msg)
139 with self._box.get_file(key) as f:
140 self.assertEqual(f.read(),
141 self._non_latin_bin_msg.replace(b'\n',
142 os.linesep.encode()))
143 self.assertEqual(self._box[key].get_payload(),
144 "Да, они летят.\n")
145
146 def test_add_binary_file(self):
147 with tempfile.TemporaryFile('wb+') as f:
148 f.write(_bytes_sample_message)
149 f.seek(0)
150 key = self._box.add(f)
Petri Lehtinen3d12c432012-08-15 14:00:40 +0300151 self.assertEqual(self._box.get_bytes(key).split(b'\n'),
152 _bytes_sample_message.split(b'\n'))
R. David Murrayb7deff12011-01-30 06:21:28 +0000153
154 def test_add_binary_nonascii_file(self):
155 with tempfile.TemporaryFile('wb+') as f:
156 f.write(self._non_latin_bin_msg)
157 f.seek(0)
158 key = self._box.add(f)
Petri Lehtinen3d12c432012-08-15 14:00:40 +0300159 self.assertEqual(self._box.get_bytes(key).split(b'\n'),
160 self._non_latin_bin_msg.split(b'\n'))
R. David Murrayb7deff12011-01-30 06:21:28 +0000161
162 def test_add_text_file_warns(self):
163 with tempfile.TemporaryFile('w+') as f:
164 f.write(_sample_message)
165 f.seek(0)
166 with self.assertWarns(DeprecationWarning):
167 key = self._box.add(f)
Petri Lehtinen3d12c432012-08-15 14:00:40 +0300168 self.assertEqual(self._box.get_bytes(key).split(b'\n'),
169 _bytes_sample_message.split(b'\n'))
R. David Murrayb7deff12011-01-30 06:21:28 +0000170
171 def test_add_StringIO_warns(self):
172 with self.assertWarns(DeprecationWarning):
173 key = self._box.add(io.StringIO(self._template % "0"))
174 self.assertEqual(self._box.get_string(key), self._template % "0")
175
176 def test_add_nonascii_StringIO_raises(self):
177 with self.assertWarns(DeprecationWarning):
178 with self.assertRaisesRegex(ValueError, "ASCII-only"):
179 self._box.add(io.StringIO(self._nonascii_msg))
R. David Murrayfc141142011-02-11 22:47:17 +0000180 self.assertEqual(len(self._box), 0)
181 self._box.close()
182 self.assertMailboxEmpty()
R. David Murrayb7deff12011-01-30 06:21:28 +0000183
Thomas Wouters477c8d52006-05-27 19:21:47 +0000184 def test_remove(self):
185 # Remove messages using remove()
186 self._test_remove_or_delitem(self._box.remove)
187
188 def test_delitem(self):
189 # Remove messages using __delitem__()
190 self._test_remove_or_delitem(self._box.__delitem__)
191
192 def _test_remove_or_delitem(self, method):
193 # (Used by test_remove() and test_delitem().)
194 key0 = self._box.add(self._template % 0)
195 key1 = self._box.add(self._template % 1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000196 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000197 method(key0)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000198 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000199 self.assertRaises(KeyError, lambda: self._box[key0])
200 self.assertRaises(KeyError, lambda: method(key0))
Guido van Rossumea834472007-07-27 05:17:50 +0000201 self.assertEqual(self._box.get_string(key1), self._template % 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000202 key2 = self._box.add(self._template % 2)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000203 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000204 method(key2)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000205 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000206 self.assertRaises(KeyError, lambda: self._box[key2])
207 self.assertRaises(KeyError, lambda: method(key2))
Guido van Rossumea834472007-07-27 05:17:50 +0000208 self.assertEqual(self._box.get_string(key1), self._template % 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000209 method(key1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000210 self.assertEqual(len(self._box), 0)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000211 self.assertRaises(KeyError, lambda: self._box[key1])
212 self.assertRaises(KeyError, lambda: method(key1))
213
214 def test_discard(self, repetitions=10):
215 # Discard messages
216 key0 = self._box.add(self._template % 0)
217 key1 = self._box.add(self._template % 1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000218 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000219 self._box.discard(key0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000220 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000221 self.assertRaises(KeyError, lambda: self._box[key0])
222 self._box.discard(key0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000223 self.assertEqual(len(self._box), 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000224 self.assertRaises(KeyError, lambda: self._box[key0])
225
226 def test_get(self):
227 # Retrieve messages using get()
228 key0 = self._box.add(self._template % 0)
229 msg = self._box.get(key0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000230 self.assertEqual(msg['from'], 'foo')
Petri Lehtinen46809192012-09-25 21:58:51 +0300231 self.assertEqual(msg.get_payload(), '0\n')
Serhiy Storchaka578c6772014-02-08 15:06:08 +0200232 self.assertIsNone(self._box.get('foo'))
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000233 self.assertIs(self._box.get('foo', False), False)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000234 self._box.close()
Georg Brandlfb16cf12008-05-11 21:31:44 +0000235 self._box = self._factory(self._path)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000236 key1 = self._box.add(self._template % 1)
237 msg = self._box.get(key1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000238 self.assertEqual(msg['from'], 'foo')
Petri Lehtinen46809192012-09-25 21:58:51 +0300239 self.assertEqual(msg.get_payload(), '1\n')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000240
241 def test_getitem(self):
242 # Retrieve message using __getitem__()
243 key0 = self._box.add(self._template % 0)
244 msg = self._box[key0]
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000245 self.assertEqual(msg['from'], 'foo')
Petri Lehtinen46809192012-09-25 21:58:51 +0300246 self.assertEqual(msg.get_payload(), '0\n')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000247 self.assertRaises(KeyError, lambda: self._box['foo'])
248 self._box.discard(key0)
249 self.assertRaises(KeyError, lambda: self._box[key0])
250
251 def test_get_message(self):
252 # Get Message representations of messages
253 key0 = self._box.add(self._template % 0)
254 key1 = self._box.add(_sample_message)
255 msg0 = self._box.get_message(key0)
Ezio Melottie9615932010-01-24 19:26:24 +0000256 self.assertIsInstance(msg0, mailbox.Message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000257 self.assertEqual(msg0['from'], 'foo')
Petri Lehtinen46809192012-09-25 21:58:51 +0300258 self.assertEqual(msg0.get_payload(), '0\n')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000259 self._check_sample(self._box.get_message(key1))
260
R. David Murrayb7deff12011-01-30 06:21:28 +0000261 def test_get_bytes(self):
262 # Get bytes representations of messages
263 key0 = self._box.add(self._template % 0)
264 key1 = self._box.add(_sample_message)
265 self.assertEqual(self._box.get_bytes(key0),
266 (self._template % 0).encode('ascii'))
267 self.assertEqual(self._box.get_bytes(key1), _bytes_sample_message)
268
Thomas Wouters477c8d52006-05-27 19:21:47 +0000269 def test_get_string(self):
270 # Get string representations of messages
271 key0 = self._box.add(self._template % 0)
272 key1 = self._box.add(_sample_message)
Guido van Rossumea834472007-07-27 05:17:50 +0000273 self.assertEqual(self._box.get_string(key0), self._template % 0)
R. David Murrayb7deff12011-01-30 06:21:28 +0000274 self.assertEqual(self._box.get_string(key1).split('\n'),
275 _sample_message.split('\n'))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000276
277 def test_get_file(self):
278 # Get file representations of messages
279 key0 = self._box.add(self._template % 0)
280 key1 = self._box.add(_sample_message)
Brett Cannon653238a2010-10-30 00:13:00 +0000281 with self._box.get_file(key0) as file:
282 data0 = file.read()
283 with self._box.get_file(key1) as file:
284 data1 = file.read()
R. David Murrayb7deff12011-01-30 06:21:28 +0000285 self.assertEqual(data0.decode('ascii').replace(os.linesep, '\n'),
Guido van Rossumea834472007-07-27 05:17:50 +0000286 self._template % 0)
R. David Murrayb7deff12011-01-30 06:21:28 +0000287 self.assertEqual(data1.decode('ascii').replace(os.linesep, '\n'),
Guido van Rossumea834472007-07-27 05:17:50 +0000288 _sample_message)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000289
R David Murrayc88bce12011-06-17 22:24:05 -0400290 def test_get_file_can_be_closed_twice(self):
291 # Issue 11700
292 key = self._box.add(_sample_message)
293 f = self._box.get_file(key)
294 f.close()
295 f.close()
296
Thomas Wouters477c8d52006-05-27 19:21:47 +0000297 def test_iterkeys(self):
298 # Get keys using iterkeys()
Serhiy Storchakacd3aacf52014-08-13 09:35:21 +0300299 self._check_iteration(self._box.iterkeys, do_keys=True, do_values=False)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000300
301 def test_keys(self):
302 # Get keys using keys()
303 self._check_iteration(self._box.keys, do_keys=True, do_values=False)
304
305 def test_itervalues(self):
306 # Get values using itervalues()
Serhiy Storchakacd3aacf52014-08-13 09:35:21 +0300307 self._check_iteration(self._box.itervalues, do_keys=False,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000308 do_values=True)
309
310 def test_iter(self):
311 # Get values using __iter__()
312 self._check_iteration(self._box.__iter__, do_keys=False,
313 do_values=True)
314
315 def test_values(self):
316 # Get values using values()
317 self._check_iteration(self._box.values, do_keys=False, do_values=True)
318
319 def test_iteritems(self):
320 # Get keys and values using iteritems()
Serhiy Storchakacd3aacf52014-08-13 09:35:21 +0300321 self._check_iteration(self._box.iteritems, do_keys=True,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000322 do_values=True)
323
324 def test_items(self):
325 # Get keys and values using items()
326 self._check_iteration(self._box.items, do_keys=True, do_values=True)
327
328 def _check_iteration(self, method, do_keys, do_values, repetitions=10):
329 for value in method():
330 self.fail("Not empty")
331 keys, values = [], []
Guido van Rossum805365e2007-05-07 22:24:25 +0000332 for i in range(repetitions):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000333 keys.append(self._box.add(self._template % i))
334 values.append(self._template % i)
335 if do_keys and not do_values:
336 returned_keys = list(method())
337 elif do_values and not do_keys:
338 returned_values = list(method())
339 else:
340 returned_keys, returned_values = [], []
341 for key, value in method():
342 returned_keys.append(key)
343 returned_values.append(value)
344 if do_keys:
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000345 self.assertEqual(len(keys), len(returned_keys))
346 self.assertEqual(set(keys), set(returned_keys))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000347 if do_values:
348 count = 0
349 for value in returned_values:
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000350 self.assertEqual(value['from'], 'foo')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000351 self.assertLess(int(value.get_payload()), repetitions)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000352 count += 1
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000353 self.assertEqual(len(values), count)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000354
Thomas Wouters477c8d52006-05-27 19:21:47 +0000355 def test_contains(self):
356 # Check existence of keys using __contains__()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000357 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000358 key0 = self._box.add(self._template % 0)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000359 self.assertIn(key0, self._box)
360 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000361 key1 = self._box.add(self._template % 1)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000362 self.assertIn(key1, self._box)
363 self.assertIn(key0, self._box)
364 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000365 self._box.remove(key0)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000366 self.assertNotIn(key0, self._box)
367 self.assertIn(key1, self._box)
368 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000369 self._box.remove(key1)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000370 self.assertNotIn(key1, self._box)
371 self.assertNotIn(key0, self._box)
372 self.assertNotIn('foo', self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000373
374 def test_len(self, repetitions=10):
375 # Get message count
376 keys = []
Guido van Rossum805365e2007-05-07 22:24:25 +0000377 for i in range(repetitions):
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000378 self.assertEqual(len(self._box), i)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000379 keys.append(self._box.add(self._template % i))
Guido van Rossumea834472007-07-27 05:17:50 +0000380 self.assertEqual(len(self._box), i + 1)
Guido van Rossum805365e2007-05-07 22:24:25 +0000381 for i in range(repetitions):
Guido van Rossumea834472007-07-27 05:17:50 +0000382 self.assertEqual(len(self._box), repetitions - i)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000383 self._box.remove(keys[i])
Guido van Rossumea834472007-07-27 05:17:50 +0000384 self.assertEqual(len(self._box), repetitions - i - 1)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000385
386 def test_set_item(self):
387 # Modify messages using __setitem__()
388 key0 = self._box.add(self._template % 'original 0')
Guido van Rossumea834472007-07-27 05:17:50 +0000389 self.assertEqual(self._box.get_string(key0),
390 self._template % 'original 0')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000391 key1 = self._box.add(self._template % 'original 1')
Guido van Rossumea834472007-07-27 05:17:50 +0000392 self.assertEqual(self._box.get_string(key1),
393 self._template % 'original 1')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000394 self._box[key0] = self._template % 'changed 0'
Guido van Rossumea834472007-07-27 05:17:50 +0000395 self.assertEqual(self._box.get_string(key0),
396 self._template % 'changed 0')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000397 self._box[key1] = self._template % 'changed 1'
Guido van Rossumea834472007-07-27 05:17:50 +0000398 self.assertEqual(self._box.get_string(key1),
399 self._template % 'changed 1')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000400 self._box[key0] = _sample_message
401 self._check_sample(self._box[key0])
402 self._box[key1] = self._box[key0]
403 self._check_sample(self._box[key1])
404 self._box[key0] = self._template % 'original 0'
Guido van Rossumea834472007-07-27 05:17:50 +0000405 self.assertEqual(self._box.get_string(key0),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000406 self._template % 'original 0')
407 self._check_sample(self._box[key1])
408 self.assertRaises(KeyError,
409 lambda: self._box.__setitem__('foo', 'bar'))
410 self.assertRaises(KeyError, lambda: self._box['foo'])
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000411 self.assertEqual(len(self._box), 2)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000412
413 def test_clear(self, iterations=10):
414 # Remove all messages using clear()
415 keys = []
Guido van Rossum805365e2007-05-07 22:24:25 +0000416 for i in range(iterations):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000417 self._box.add(self._template % i)
418 for i, key in enumerate(keys):
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000419 self.assertEqual(self._box.get_string(key), self._template % i)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000420 self._box.clear()
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000421 self.assertEqual(len(self._box), 0)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000422 for i, key in enumerate(keys):
423 self.assertRaises(KeyError, lambda: self._box.get_string(key))
424
425 def test_pop(self):
426 # Get and remove a message using pop()
427 key0 = self._box.add(self._template % 0)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000428 self.assertIn(key0, self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000429 key1 = self._box.add(self._template % 1)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000430 self.assertIn(key1, self._box)
Petri Lehtinen46809192012-09-25 21:58:51 +0300431 self.assertEqual(self._box.pop(key0).get_payload(), '0\n')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000432 self.assertNotIn(key0, self._box)
433 self.assertIn(key1, self._box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000434 key2 = self._box.add(self._template % 2)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000435 self.assertIn(key2, self._box)
Petri Lehtinen46809192012-09-25 21:58:51 +0300436 self.assertEqual(self._box.pop(key2).get_payload(), '2\n')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000437 self.assertNotIn(key2, self._box)
438 self.assertIn(key1, self._box)
Petri Lehtinen46809192012-09-25 21:58:51 +0300439 self.assertEqual(self._box.pop(key1).get_payload(), '1\n')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000440 self.assertNotIn(key1, self._box)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000441 self.assertEqual(len(self._box), 0)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000442
443 def test_popitem(self, iterations=10):
444 # Get and remove an arbitrary (key, message) using popitem()
445 keys = []
Guido van Rossum805365e2007-05-07 22:24:25 +0000446 for i in range(10):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000447 keys.append(self._box.add(self._template % i))
448 seen = []
Guido van Rossum805365e2007-05-07 22:24:25 +0000449 for i in range(10):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000450 key, msg = self._box.popitem()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000451 self.assertIn(key, keys)
452 self.assertNotIn(key, seen)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000453 seen.append(key)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000454 self.assertEqual(int(msg.get_payload()), keys.index(key))
455 self.assertEqual(len(self._box), 0)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000456 for key in keys:
457 self.assertRaises(KeyError, lambda: self._box[key])
458
459 def test_update(self):
460 # Modify multiple messages using update()
461 key0 = self._box.add(self._template % 'original 0')
462 key1 = self._box.add(self._template % 'original 1')
463 key2 = self._box.add(self._template % 'original 2')
464 self._box.update({key0: self._template % 'changed 0',
465 key2: _sample_message})
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000466 self.assertEqual(len(self._box), 3)
Guido van Rossumea834472007-07-27 05:17:50 +0000467 self.assertEqual(self._box.get_string(key0),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000468 self._template % 'changed 0')
Guido van Rossumea834472007-07-27 05:17:50 +0000469 self.assertEqual(self._box.get_string(key1),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000470 self._template % 'original 1')
471 self._check_sample(self._box[key2])
472 self._box.update([(key2, self._template % 'changed 2'),
473 (key1, self._template % 'changed 1'),
474 (key0, self._template % 'original 0')])
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000475 self.assertEqual(len(self._box), 3)
Guido van Rossumea834472007-07-27 05:17:50 +0000476 self.assertEqual(self._box.get_string(key0),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000477 self._template % 'original 0')
Guido van Rossumea834472007-07-27 05:17:50 +0000478 self.assertEqual(self._box.get_string(key1),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000479 self._template % 'changed 1')
Guido van Rossumea834472007-07-27 05:17:50 +0000480 self.assertEqual(self._box.get_string(key2),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000481 self._template % 'changed 2')
482 self.assertRaises(KeyError,
483 lambda: self._box.update({'foo': 'bar',
484 key0: self._template % "changed 0"}))
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000485 self.assertEqual(len(self._box), 3)
Guido van Rossumea834472007-07-27 05:17:50 +0000486 self.assertEqual(self._box.get_string(key0),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000487 self._template % "changed 0")
Guido van Rossumea834472007-07-27 05:17:50 +0000488 self.assertEqual(self._box.get_string(key1),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000489 self._template % "changed 1")
Guido van Rossumea834472007-07-27 05:17:50 +0000490 self.assertEqual(self._box.get_string(key2),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000491 self._template % "changed 2")
492
493 def test_flush(self):
494 # Write changes to disk
Christian Heimesf6cd9672008-03-26 13:45:42 +0000495 self._test_flush_or_close(self._box.flush, True)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000496
Petri Lehtinen02653f12012-06-15 20:50:51 +0300497 def test_popitem_and_flush_twice(self):
498 # See #15036.
499 self._box.add(self._template % 0)
500 self._box.add(self._template % 1)
501 self._box.flush()
502
503 self._box.popitem()
504 self._box.flush()
505 self._box.popitem()
506 self._box.flush()
507
Thomas Wouters477c8d52006-05-27 19:21:47 +0000508 def test_lock_unlock(self):
509 # Lock and unlock the mailbox
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000510 self.assertFalse(os.path.exists(self._get_lock_path()))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000511 self._box.lock()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000512 self.assertTrue(os.path.exists(self._get_lock_path()))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000513 self._box.unlock()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000514 self.assertFalse(os.path.exists(self._get_lock_path()))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000515
516 def test_close(self):
517 # Close mailbox and flush changes to disk
Christian Heimesf6cd9672008-03-26 13:45:42 +0000518 self._test_flush_or_close(self._box.close, False)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000519
Christian Heimesf6cd9672008-03-26 13:45:42 +0000520 def _test_flush_or_close(self, method, should_call_close):
Guido van Rossum805365e2007-05-07 22:24:25 +0000521 contents = [self._template % i for i in range(3)]
Thomas Wouters477c8d52006-05-27 19:21:47 +0000522 self._box.add(contents[0])
523 self._box.add(contents[1])
524 self._box.add(contents[2])
Guido van Rossumc12a8132007-10-26 04:29:23 +0000525 oldbox = self._box
Thomas Wouters477c8d52006-05-27 19:21:47 +0000526 method()
Christian Heimesf6cd9672008-03-26 13:45:42 +0000527 if should_call_close:
528 self._box.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000529 self._box = self._factory(self._path)
530 keys = self._box.keys()
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000531 self.assertEqual(len(keys), 3)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000532 for key in keys:
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000533 self.assertIn(self._box.get_string(key), contents)
Guido van Rossumc12a8132007-10-26 04:29:23 +0000534 oldbox.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000535
536 def test_dump_message(self):
537 # Write message representations to disk
538 for input in (email.message_from_string(_sample_message),
R. David Murrayb7deff12011-01-30 06:21:28 +0000539 _sample_message, io.BytesIO(_bytes_sample_message)):
540 output = io.BytesIO()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000541 self._box._dump_message(input, output)
R. David Murrayb7deff12011-01-30 06:21:28 +0000542 self.assertEqual(output.getvalue(),
543 _bytes_sample_message.replace(b'\n', os.linesep.encode()))
544 output = io.BytesIO()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000545 self.assertRaises(TypeError,
546 lambda: self._box._dump_message(None, output))
547
548 def _get_lock_path(self):
549 # Return the path of the dot lock file. May be overridden.
550 return self._path + '.lock'
551
552
R David Murray317c8d22012-04-08 16:46:18 -0400553class TestMailboxSuperclass(TestBase, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000554
555 def test_notimplemented(self):
556 # Test that all Mailbox methods raise NotImplementedException.
557 box = mailbox.Mailbox('path')
558 self.assertRaises(NotImplementedError, lambda: box.add(''))
559 self.assertRaises(NotImplementedError, lambda: box.remove(''))
560 self.assertRaises(NotImplementedError, lambda: box.__delitem__(''))
561 self.assertRaises(NotImplementedError, lambda: box.discard(''))
562 self.assertRaises(NotImplementedError, lambda: box.__setitem__('', ''))
Serhiy Storchakacd3aacf52014-08-13 09:35:21 +0300563 self.assertRaises(NotImplementedError, lambda: box.iterkeys())
Thomas Wouters477c8d52006-05-27 19:21:47 +0000564 self.assertRaises(NotImplementedError, lambda: box.keys())
Serhiy Storchakacd3aacf52014-08-13 09:35:21 +0300565 self.assertRaises(NotImplementedError, lambda: box.itervalues().__next__())
Guido van Rossumb5a755e2007-07-18 18:15:48 +0000566 self.assertRaises(NotImplementedError, lambda: box.__iter__().__next__())
Thomas Wouters477c8d52006-05-27 19:21:47 +0000567 self.assertRaises(NotImplementedError, lambda: box.values())
Serhiy Storchakacd3aacf52014-08-13 09:35:21 +0300568 self.assertRaises(NotImplementedError, lambda: box.iteritems().__next__())
Thomas Wouters477c8d52006-05-27 19:21:47 +0000569 self.assertRaises(NotImplementedError, lambda: box.items())
570 self.assertRaises(NotImplementedError, lambda: box.get(''))
571 self.assertRaises(NotImplementedError, lambda: box.__getitem__(''))
572 self.assertRaises(NotImplementedError, lambda: box.get_message(''))
573 self.assertRaises(NotImplementedError, lambda: box.get_string(''))
R. David Murrayb7deff12011-01-30 06:21:28 +0000574 self.assertRaises(NotImplementedError, lambda: box.get_bytes(''))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000575 self.assertRaises(NotImplementedError, lambda: box.get_file(''))
Guido van Rossume2b70bc2006-08-18 22:13:04 +0000576 self.assertRaises(NotImplementedError, lambda: '' in box)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000577 self.assertRaises(NotImplementedError, lambda: box.__contains__(''))
578 self.assertRaises(NotImplementedError, lambda: box.__len__())
579 self.assertRaises(NotImplementedError, lambda: box.clear())
580 self.assertRaises(NotImplementedError, lambda: box.pop(''))
581 self.assertRaises(NotImplementedError, lambda: box.popitem())
582 self.assertRaises(NotImplementedError, lambda: box.update((('', ''),)))
583 self.assertRaises(NotImplementedError, lambda: box.flush())
584 self.assertRaises(NotImplementedError, lambda: box.lock())
585 self.assertRaises(NotImplementedError, lambda: box.unlock())
586 self.assertRaises(NotImplementedError, lambda: box.close())
587
588
R David Murray317c8d22012-04-08 16:46:18 -0400589class TestMaildir(TestMailbox, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000590
591 _factory = lambda self, path, factory=None: mailbox.Maildir(path, factory)
592
593 def setUp(self):
594 TestMailbox.setUp(self)
Jesus Ceaf01d6952012-10-05 03:36:11 +0200595 if (os.name == 'nt') or (sys.platform == 'cygwin'):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000596 self._box.colon = '!'
597
R. David Murrayfc141142011-02-11 22:47:17 +0000598 def assertMailboxEmpty(self):
599 self.assertEqual(os.listdir(os.path.join(self._path, 'tmp')), [])
600
Thomas Wouters477c8d52006-05-27 19:21:47 +0000601 def test_add_MM(self):
602 # Add a MaildirMessage instance
603 msg = mailbox.MaildirMessage(self._template % 0)
604 msg.set_subdir('cur')
605 msg.set_info('foo')
606 key = self._box.add(msg)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000607 self.assertTrue(os.path.exists(os.path.join(self._path, 'cur', '%s%sfoo' %
Thomas Wouters477c8d52006-05-27 19:21:47 +0000608 (key, self._box.colon))))
609
610 def test_get_MM(self):
611 # Get a MaildirMessage instance
612 msg = mailbox.MaildirMessage(self._template % 0)
613 msg.set_subdir('cur')
614 msg.set_flags('RF')
615 key = self._box.add(msg)
616 msg_returned = self._box.get_message(key)
Ezio Melottie9615932010-01-24 19:26:24 +0000617 self.assertIsInstance(msg_returned, mailbox.MaildirMessage)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000618 self.assertEqual(msg_returned.get_subdir(), 'cur')
619 self.assertEqual(msg_returned.get_flags(), 'FR')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000620
621 def test_set_MM(self):
622 # Set with a MaildirMessage instance
623 msg0 = mailbox.MaildirMessage(self._template % 0)
624 msg0.set_flags('TP')
625 key = self._box.add(msg0)
626 msg_returned = self._box.get_message(key)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000627 self.assertEqual(msg_returned.get_subdir(), 'new')
628 self.assertEqual(msg_returned.get_flags(), 'PT')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000629 msg1 = mailbox.MaildirMessage(self._template % 1)
630 self._box[key] = msg1
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(), '')
Petri Lehtinen46809192012-09-25 21:58:51 +0300634 self.assertEqual(msg_returned.get_payload(), '1\n')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000635 msg2 = mailbox.MaildirMessage(self._template % 2)
636 msg2.set_info('2,S')
637 self._box[key] = msg2
638 self._box[key] = self._template % 3
639 msg_returned = self._box.get_message(key)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000640 self.assertEqual(msg_returned.get_subdir(), 'new')
641 self.assertEqual(msg_returned.get_flags(), 'S')
Petri Lehtinen46809192012-09-25 21:58:51 +0300642 self.assertEqual(msg_returned.get_payload(), '3\n')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000643
Christian Heimesfdab48e2008-01-20 09:06:41 +0000644 def test_consistent_factory(self):
645 # Add a message.
646 msg = mailbox.MaildirMessage(self._template % 0)
647 msg.set_subdir('cur')
648 msg.set_flags('RF')
649 key = self._box.add(msg)
650
651 # Create new mailbox with
652 class FakeMessage(mailbox.MaildirMessage):
653 pass
654 box = mailbox.Maildir(self._path, factory=FakeMessage)
Christian Heimes15ebc882008-02-04 18:48:49 +0000655 box.colon = self._box.colon
Christian Heimesfdab48e2008-01-20 09:06:41 +0000656 msg2 = box.get_message(key)
Ezio Melottie9615932010-01-24 19:26:24 +0000657 self.assertIsInstance(msg2, FakeMessage)
Christian Heimesfdab48e2008-01-20 09:06:41 +0000658
Thomas Wouters477c8d52006-05-27 19:21:47 +0000659 def test_initialize_new(self):
660 # Initialize a non-existent mailbox
661 self.tearDown()
662 self._box = mailbox.Maildir(self._path)
Georg Brandlfb16cf12008-05-11 21:31:44 +0000663 self._check_basics()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000664 self._delete_recursively(self._path)
665 self._box = self._factory(self._path, factory=None)
666 self._check_basics()
667
668 def test_initialize_existing(self):
669 # Initialize an existing mailbox
670 self.tearDown()
671 for subdir in '', 'tmp', 'new', 'cur':
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000672 os.mkdir(os.path.normpath(os.path.join(self._path, subdir)))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000673 self._box = mailbox.Maildir(self._path)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000674 self._check_basics()
675
676 def _check_basics(self, factory=None):
677 # (Used by test_open_new() and test_open_existing().)
678 self.assertEqual(self._box._path, os.path.abspath(self._path))
679 self.assertEqual(self._box._factory, factory)
680 for subdir in '', 'tmp', 'new', 'cur':
681 path = os.path.join(self._path, subdir)
682 mode = os.stat(path)[stat.ST_MODE]
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000683 self.assertTrue(stat.S_ISDIR(mode), "Not a directory: '%s'" % path)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000684
685 def test_list_folders(self):
686 # List folders
687 self._box.add_folder('one')
688 self._box.add_folder('two')
689 self._box.add_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000690 self.assertEqual(len(self._box.list_folders()), 3)
Guido van Rossumea834472007-07-27 05:17:50 +0000691 self.assertEqual(set(self._box.list_folders()),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000692 set(('one', 'two', 'three')))
693
694 def test_get_folder(self):
695 # Open folders
696 self._box.add_folder('foo.bar')
697 folder0 = self._box.get_folder('foo.bar')
698 folder0.add(self._template % 'bar')
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000699 self.assertTrue(os.path.isdir(os.path.join(self._path, '.foo.bar')))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000700 folder1 = self._box.get_folder('foo.bar')
Guido van Rossumea834472007-07-27 05:17:50 +0000701 self.assertEqual(folder1.get_string(folder1.keys()[0]),
702 self._template % 'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +0000703
704 def test_add_and_remove_folders(self):
705 # Delete folders
706 self._box.add_folder('one')
707 self._box.add_folder('two')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000708 self.assertEqual(len(self._box.list_folders()), 2)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000709 self.assertEqual(set(self._box.list_folders()), set(('one', 'two')))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000710 self._box.remove_folder('one')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000711 self.assertEqual(len(self._box.list_folders()), 1)
712 self.assertEqual(set(self._box.list_folders()), set(('two',)))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000713 self._box.add_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000714 self.assertEqual(len(self._box.list_folders()), 2)
Guido van Rossumea834472007-07-27 05:17:50 +0000715 self.assertEqual(set(self._box.list_folders()), set(('two', 'three')))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000716 self._box.remove_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000717 self.assertEqual(len(self._box.list_folders()), 1)
718 self.assertEqual(set(self._box.list_folders()), set(('two',)))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000719 self._box.remove_folder('two')
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000720 self.assertEqual(len(self._box.list_folders()), 0)
721 self.assertEqual(self._box.list_folders(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +0000722
723 def test_clean(self):
724 # Remove old files from 'tmp'
725 foo_path = os.path.join(self._path, 'tmp', 'foo')
726 bar_path = os.path.join(self._path, 'tmp', 'bar')
Brian Curtin5acec042010-10-13 02:29:46 +0000727 with open(foo_path, 'w') as f:
728 f.write("@")
729 with open(bar_path, 'w') as f:
730 f.write("@")
Thomas Wouters477c8d52006-05-27 19:21:47 +0000731 self._box.clean()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000732 self.assertTrue(os.path.exists(foo_path))
733 self.assertTrue(os.path.exists(bar_path))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000734 foo_stat = os.stat(foo_path)
735 os.utime(foo_path, (time.time() - 129600 - 2,
736 foo_stat.st_mtime))
737 self._box.clean()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000738 self.assertFalse(os.path.exists(foo_path))
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000739 self.assertTrue(os.path.exists(bar_path))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000740
741 def test_create_tmp(self, repetitions=10):
742 # Create files in tmp directory
743 hostname = socket.gethostname()
744 if '/' in hostname:
745 hostname = hostname.replace('/', r'\057')
746 if ':' in hostname:
747 hostname = hostname.replace(':', r'\072')
748 pid = os.getpid()
749 pattern = re.compile(r"(?P<time>\d+)\.M(?P<M>\d{1,6})P(?P<P>\d+)"
Serhiy Storchakaf4ea6422017-09-30 17:10:57 +0300750 r"Q(?P<Q>\d+)\.(?P<host>[^:/]*)")
Thomas Wouters477c8d52006-05-27 19:21:47 +0000751 previous_groups = None
Guido van Rossum805365e2007-05-07 22:24:25 +0000752 for x in range(repetitions):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000753 tmp_file = self._box._create_tmp()
754 head, tail = os.path.split(tmp_file.name)
755 self.assertEqual(head, os.path.abspath(os.path.join(self._path,
756 "tmp")),
757 "File in wrong location: '%s'" % head)
758 match = pattern.match(tail)
Serhiy Storchaka578c6772014-02-08 15:06:08 +0200759 self.assertIsNotNone(match, "Invalid file name: '%s'" % tail)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000760 groups = match.groups()
Benjamin Peterson2a691a82008-03-31 01:51:45 +0000761 if previous_groups is not None:
Petri Lehtinen1c371b22012-09-01 14:22:36 +0300762 self.assertGreaterEqual(int(groups[0]), int(previous_groups[0]),
Thomas Wouters477c8d52006-05-27 19:21:47 +0000763 "Non-monotonic seconds: '%s' before '%s'" %
764 (previous_groups[0], groups[0]))
Petri Lehtinen1c371b22012-09-01 14:22:36 +0300765 if int(groups[0]) == int(previous_groups[0]):
766 self.assertGreaterEqual(int(groups[1]), int(previous_groups[1]),
767 "Non-monotonic milliseconds: '%s' before '%s'" %
768 (previous_groups[1], groups[1]))
Guido van Rossumea834472007-07-27 05:17:50 +0000769 self.assertEqual(int(groups[2]), pid,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000770 "Process ID mismatch: '%s' should be '%s'" %
771 (groups[2], pid))
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000772 self.assertEqual(int(groups[3]), int(previous_groups[3]) + 1,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000773 "Non-sequential counter: '%s' before '%s'" %
774 (previous_groups[3], groups[3]))
Guido van Rossumea834472007-07-27 05:17:50 +0000775 self.assertEqual(groups[4], hostname,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000776 "Host name mismatch: '%s' should be '%s'" %
777 (groups[4], hostname))
778 previous_groups = groups
R. David Murrayb7deff12011-01-30 06:21:28 +0000779 tmp_file.write(_bytes_sample_message)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000780 tmp_file.seek(0)
R. David Murrayb7deff12011-01-30 06:21:28 +0000781 self.assertEqual(tmp_file.read(), _bytes_sample_message)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000782 tmp_file.close()
783 file_count = len(os.listdir(os.path.join(self._path, "tmp")))
Guido van Rossumea834472007-07-27 05:17:50 +0000784 self.assertEqual(file_count, repetitions,
Thomas Wouters477c8d52006-05-27 19:21:47 +0000785 "Wrong file count: '%s' should be '%s'" %
786 (file_count, repetitions))
787
788 def test_refresh(self):
789 # Update the table of contents
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000790 self.assertEqual(self._box._toc, {})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000791 key0 = self._box.add(self._template % 0)
792 key1 = self._box.add(self._template % 1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000793 self.assertEqual(self._box._toc, {})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000794 self._box._refresh()
Guido van Rossumea834472007-07-27 05:17:50 +0000795 self.assertEqual(self._box._toc, {key0: os.path.join('new', key0),
796 key1: os.path.join('new', key1)})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000797 key2 = self._box.add(self._template % 2)
Guido van Rossumea834472007-07-27 05:17:50 +0000798 self.assertEqual(self._box._toc, {key0: os.path.join('new', key0),
799 key1: os.path.join('new', key1)})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000800 self._box._refresh()
Guido van Rossumea834472007-07-27 05:17:50 +0000801 self.assertEqual(self._box._toc, {key0: os.path.join('new', key0),
802 key1: os.path.join('new', key1),
803 key2: os.path.join('new', key2)})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000804
Petri Lehtinen8c482ee2011-11-05 09:44:59 +0200805 def test_refresh_after_safety_period(self):
806 # Issue #13254: Call _refresh after the "file system safety
807 # period" of 2 seconds has passed; _toc should still be
808 # updated because this is the first call to _refresh.
809 key0 = self._box.add(self._template % 0)
810 key1 = self._box.add(self._template % 1)
811
812 self._box = self._factory(self._path)
813 self.assertEqual(self._box._toc, {})
814
815 # Emulate sleeping. Instead of sleeping for 2 seconds, use the
816 # skew factor to make _refresh think that the filesystem
817 # safety period has passed and re-reading the _toc is only
818 # required if mtimes differ.
Petri Lehtinenc153cd32011-11-12 21:02:42 +0200819 self._box._skewfactor = -3
Petri Lehtinen8c482ee2011-11-05 09:44:59 +0200820
821 self._box._refresh()
822 self.assertEqual(sorted(self._box._toc.keys()), sorted([key0, key1]))
823
Thomas Wouters477c8d52006-05-27 19:21:47 +0000824 def test_lookup(self):
825 # Look up message subpaths in the TOC
826 self.assertRaises(KeyError, lambda: self._box._lookup('foo'))
827 key0 = self._box.add(self._template % 0)
Guido van Rossumea834472007-07-27 05:17:50 +0000828 self.assertEqual(self._box._lookup(key0), os.path.join('new', key0))
Thomas Wouters477c8d52006-05-27 19:21:47 +0000829 os.remove(os.path.join(self._path, 'new', key0))
Guido van Rossumea834472007-07-27 05:17:50 +0000830 self.assertEqual(self._box._toc, {key0: os.path.join('new', key0)})
Antoine Pitrou03f13442009-11-02 11:36:51 +0000831 # Be sure that the TOC is read back from disk (see issue #6896
832 # about bad mtime behaviour on some systems).
833 self._box.flush()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000834 self.assertRaises(KeyError, lambda: self._box._lookup(key0))
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000835 self.assertEqual(self._box._toc, {})
Thomas Wouters477c8d52006-05-27 19:21:47 +0000836
837 def test_lock_unlock(self):
838 # Lock and unlock the mailbox. For Maildir, this does nothing.
839 self._box.lock()
840 self._box.unlock()
841
Thomas Wouters89f507f2006-12-13 04:49:30 +0000842 def test_folder (self):
843 # Test for bug #1569790: verify that folders returned by .get_folder()
844 # use the same factory function.
845 def dummy_factory (s):
846 return None
847 box = self._factory(self._path, factory=dummy_factory)
848 folder = box.add_folder('folder1')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000849 self.assertIs(folder._factory, dummy_factory)
Thomas Wouters9fe394c2007-02-05 01:24:16 +0000850
Thomas Wouters89f507f2006-12-13 04:49:30 +0000851 folder1_alias = box.get_folder('folder1')
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000852 self.assertIs(folder1_alias._factory, dummy_factory)
Thomas Wouters89f507f2006-12-13 04:49:30 +0000853
Guido van Rossumb5a755e2007-07-18 18:15:48 +0000854 def test_directory_in_folder (self):
855 # Test that mailboxes still work if there's a stray extra directory
856 # in a folder.
857 for i in range(10):
858 self._box.add(mailbox.Message(_sample_message))
Thomas Wouters9fe394c2007-02-05 01:24:16 +0000859
Guido van Rossumb5a755e2007-07-18 18:15:48 +0000860 # Create a stray directory
861 os.mkdir(os.path.join(self._path, 'cur', 'stray-dir'))
862
863 # Check that looping still works with the directory present.
864 for msg in self._box:
865 pass
Thomas Wouters477c8d52006-05-27 19:21:47 +0000866
Serhiy Storchaka43767632013-11-03 21:31:38 +0200867 @unittest.skipUnless(hasattr(os, 'umask'), 'test needs os.umask()')
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000868 def test_file_permissions(self):
869 # Verify that message files are created without execute permissions
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000870 msg = mailbox.MaildirMessage(self._template % 0)
871 orig_umask = os.umask(0)
872 try:
873 key = self._box.add(msg)
874 finally:
875 os.umask(orig_umask)
876 path = os.path.join(self._path, self._box._lookup(key))
877 mode = os.stat(path).st_mode
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +0000878 self.assertFalse(mode & 0o111)
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000879
Serhiy Storchaka43767632013-11-03 21:31:38 +0200880 @unittest.skipUnless(hasattr(os, 'umask'), 'test needs os.umask()')
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000881 def test_folder_file_perms(self):
882 # From bug #3228, we want to verify that the file created inside a Maildir
883 # subfolder isn't marked as executable.
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000884 orig_umask = os.umask(0)
885 try:
886 subfolder = self._box.add_folder('subfolder')
887 finally:
888 os.umask(orig_umask)
889
890 path = os.path.join(subfolder._path, 'maildirfolder')
891 st = os.stat(path)
892 perms = st.st_mode
893 self.assertFalse((perms & 0o111)) # Execute bits should all be off.
894
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000895 def test_reread(self):
Petri Lehtinen8c482ee2011-11-05 09:44:59 +0200896 # Do an initial unconditional refresh
897 self._box._refresh()
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000898
R David Murraycaed7fe2011-05-06 22:07:19 -0400899 # Put the last modified times more than two seconds into the past
900 # (because mtime may have a two second granularity)
R David Murrayb9a428d2011-03-25 16:03:47 -0400901 for subdir in ('cur', 'new'):
902 os.utime(os.path.join(self._box._path, subdir),
903 (time.time()-5,)*2)
904
R David Murraycaed7fe2011-05-06 22:07:19 -0400905 # Because mtime has a two second granularity in worst case (FAT), a
906 # refresh is done unconditionally if called for within
907 # two-second-plus-a-bit of the last one, just in case the mbox has
908 # changed; so now we have to wait for that interval to expire.
Petri Lehtinenc153cd32011-11-12 21:02:42 +0200909 #
910 # Because this is a test, emulate sleeping. Instead of
911 # sleeping for 2 seconds, use the skew factor to make _refresh
912 # think that 2 seconds have passed and re-reading the _toc is
913 # only required if mtimes differ.
914 self._box._skewfactor = -3
R David Murraycaed7fe2011-05-06 22:07:19 -0400915
R David Murrayb9a428d2011-03-25 16:03:47 -0400916 # Re-reading causes the ._toc attribute to be assigned a new dictionary
917 # object, so we'll check that the ._toc attribute isn't a different
918 # object.
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000919 orig_toc = self._box._toc
920 def refreshed():
921 return self._box._toc is not orig_toc
922
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000923 self._box._refresh()
R David Murraycaed7fe2011-05-06 22:07:19 -0400924 self.assertFalse(refreshed())
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000925
926 # Now, write something into cur and remove it. This changes
Petri Lehtinenc153cd32011-11-12 21:02:42 +0200927 # the mtime and should cause a re-read. Note that "sleep
928 # emulation" is still in effect, as skewfactor is -3.
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000929 filename = os.path.join(self._path, 'cur', 'stray-file')
Hai Shi96a6a6d2020-07-09 21:25:10 +0800930 os_helper.create_empty_file(filename)
Andrew M. Kuchlingfa815342009-05-03 02:52:20 +0000931 os.unlink(filename)
932 self._box._refresh()
R David Murraycaed7fe2011-05-06 22:07:19 -0400933 self.assertTrue(refreshed())
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000934
Petri Lehtinenf29435f2012-06-28 13:48:17 +0300935
936class _TestSingleFile(TestMailbox):
937 '''Common tests for single-file mailboxes'''
938
939 def test_add_doesnt_rewrite(self):
940 # When only adding messages, flush() should not rewrite the
941 # mailbox file. See issue #9559.
942
943 # Inode number changes if the contents are written to another
944 # file which is then renamed over the original file. So we
945 # must check that the inode number doesn't change.
946 inode_before = os.stat(self._path).st_ino
947
948 self._box.add(self._template % 0)
949 self._box.flush()
950
951 inode_after = os.stat(self._path).st_ino
952 self.assertEqual(inode_before, inode_after)
953
954 # Make sure the message was really added
955 self._box.close()
956 self._box = self._factory(self._path)
957 self.assertEqual(len(self._box), 1)
958
Petri Lehtinen5b5619f2012-06-29 15:09:12 +0300959 def test_permissions_after_flush(self):
960 # See issue #5346
961
962 # Make the mailbox world writable. It's unlikely that the new
963 # mailbox file would have these permissions after flush(),
964 # because umask usually prevents it.
965 mode = os.stat(self._path).st_mode | 0o666
966 os.chmod(self._path, mode)
967
968 self._box.add(self._template % 0)
969 i = self._box.add(self._template % 1)
970 # Need to remove one message to make flush() create a new file
971 self._box.remove(i)
972 self._box.flush()
973
974 self.assertEqual(os.stat(self._path).st_mode, mode)
975
Petri Lehtinenf29435f2012-06-28 13:48:17 +0300976
977class _TestMboxMMDF(_TestSingleFile):
Thomas Wouters477c8d52006-05-27 19:21:47 +0000978
979 def tearDown(self):
Brett Cannon653238a2010-10-30 00:13:00 +0000980 super().tearDown()
Guido van Rossumc12a8132007-10-26 04:29:23 +0000981 self._box.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000982 self._delete_recursively(self._path)
Serhiy Storchaka93558682020-06-20 11:10:31 +0300983 for lock_remnant in glob.glob(glob.escape(self._path) + '.*'):
Hai Shi96a6a6d2020-07-09 21:25:10 +0800984 os_helper.unlink(lock_remnant)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000985
R. David Murrayfc141142011-02-11 22:47:17 +0000986 def assertMailboxEmpty(self):
987 with open(self._path) as f:
988 self.assertEqual(f.readlines(), [])
989
Cheryl Sabellad16f0122018-10-18 20:21:47 -0400990 def test_get_bytes_from(self):
991 # Get bytes representations of messages with _unixfrom.
992 unixfrom = 'From foo@bar blah\n'
993 key0 = self._box.add(unixfrom + self._template % 0)
994 key1 = self._box.add(unixfrom + _sample_message)
995 self.assertEqual(self._box.get_bytes(key0, from_=False),
996 (self._template % 0).encode('ascii'))
997 self.assertEqual(self._box.get_bytes(key1, from_=False),
998 _bytes_sample_message)
999 self.assertEqual(self._box.get_bytes(key0, from_=True),
1000 (unixfrom + self._template % 0).encode('ascii'))
1001 self.assertEqual(self._box.get_bytes(key1, from_=True),
1002 unixfrom.encode('ascii') + _bytes_sample_message)
1003
1004 def test_get_string_from(self):
1005 # Get string representations of messages with _unixfrom.
1006 unixfrom = 'From foo@bar blah\n'
1007 key0 = self._box.add(unixfrom + self._template % 0)
1008 key1 = self._box.add(unixfrom + _sample_message)
1009 self.assertEqual(self._box.get_string(key0, from_=False),
1010 self._template % 0)
1011 self.assertEqual(self._box.get_string(key1, from_=False).split('\n'),
1012 _sample_message.split('\n'))
1013 self.assertEqual(self._box.get_string(key0, from_=True),
1014 unixfrom + self._template % 0)
1015 self.assertEqual(self._box.get_string(key1, from_=True).split('\n'),
1016 (unixfrom + _sample_message).split('\n'))
1017
Thomas Wouters477c8d52006-05-27 19:21:47 +00001018 def test_add_from_string(self):
1019 # Add a string starting with 'From ' to the mailbox
Petri Lehtinen46809192012-09-25 21:58:51 +03001020 key = self._box.add('From foo@bar blah\nFrom: foo\n\n0\n')
Guido van Rossumea834472007-07-27 05:17:50 +00001021 self.assertEqual(self._box[key].get_from(), 'foo@bar blah')
Petri Lehtinen46809192012-09-25 21:58:51 +03001022 self.assertEqual(self._box[key].get_payload(), '0\n')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001023
R. David Murrayb7deff12011-01-30 06:21:28 +00001024 def test_add_from_bytes(self):
1025 # Add a byte string starting with 'From ' to the mailbox
Petri Lehtinen46809192012-09-25 21:58:51 +03001026 key = self._box.add(b'From foo@bar blah\nFrom: foo\n\n0\n')
R. David Murrayb7deff12011-01-30 06:21:28 +00001027 self.assertEqual(self._box[key].get_from(), 'foo@bar blah')
Petri Lehtinen46809192012-09-25 21:58:51 +03001028 self.assertEqual(self._box[key].get_payload(), '0\n')
R. David Murrayb7deff12011-01-30 06:21:28 +00001029
Thomas Wouters477c8d52006-05-27 19:21:47 +00001030 def test_add_mbox_or_mmdf_message(self):
1031 # Add an mboxMessage or MMDFMessage
1032 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
Petri Lehtinen46809192012-09-25 21:58:51 +03001033 msg = class_('From foo@bar blah\nFrom: foo\n\n0\n')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001034 key = self._box.add(msg)
1035
1036 def test_open_close_open(self):
1037 # Open and inspect previously-created mailbox
Guido van Rossum805365e2007-05-07 22:24:25 +00001038 values = [self._template % i for i in range(3)]
Thomas Wouters477c8d52006-05-27 19:21:47 +00001039 for value in values:
1040 self._box.add(value)
1041 self._box.close()
1042 mtime = os.path.getmtime(self._path)
1043 self._box = self._factory(self._path)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001044 self.assertEqual(len(self._box), 3)
Serhiy Storchakacd3aacf52014-08-13 09:35:21 +03001045 for key in self._box.iterkeys():
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001046 self.assertIn(self._box.get_string(key), values)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001047 self._box.close()
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001048 self.assertEqual(mtime, os.path.getmtime(self._path))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001049
1050 def test_add_and_close(self):
1051 # Verifying that closing a mailbox doesn't change added items
1052 self._box.add(_sample_message)
Guido van Rossum805365e2007-05-07 22:24:25 +00001053 for i in range(3):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001054 self._box.add(self._template % i)
1055 self._box.add(_sample_message)
1056 self._box._file.flush()
1057 self._box._file.seek(0)
1058 contents = self._box._file.read()
1059 self._box.close()
R. David Murrayb7deff12011-01-30 06:21:28 +00001060 with open(self._path, 'rb') as f:
Brian Curtin5acec042010-10-13 02:29:46 +00001061 self.assertEqual(contents, f.read())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001062 self._box = self._factory(self._path)
1063
Charles-François Natali78ed83d2011-12-19 12:18:55 +01001064 @unittest.skipUnless(hasattr(os, 'fork'), "Test needs fork().")
Charles-François Natalibf383152011-12-20 11:48:22 +01001065 @unittest.skipUnless(hasattr(socket, 'socketpair'), "Test needs socketpair().")
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001066 def test_lock_conflict(self):
Charles-François Natali78ed83d2011-12-19 12:18:55 +01001067 # Fork off a child process that will lock the mailbox temporarily,
1068 # unlock it and exit.
Charles-François Natalibf383152011-12-20 11:48:22 +01001069 c, p = socket.socketpair()
1070 self.addCleanup(c.close)
1071 self.addCleanup(p.close)
Charles-François Natali78ed83d2011-12-19 12:18:55 +01001072
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001073 pid = os.fork()
1074 if pid == 0:
Charles-François Natali78ed83d2011-12-19 12:18:55 +01001075 # child
Guido van Rossum62cbc8a2007-04-09 00:41:25 +00001076 try:
Charles-François Natali78ed83d2011-12-19 12:18:55 +01001077 # lock the mailbox, and signal the parent it can proceed
Guido van Rossum62cbc8a2007-04-09 00:41:25 +00001078 self._box.lock()
Charles-François Natalibf383152011-12-20 11:48:22 +01001079 c.send(b'c')
Charles-François Natali78ed83d2011-12-19 12:18:55 +01001080
1081 # wait until the parent is done, and unlock the mailbox
Charles-François Natalibf383152011-12-20 11:48:22 +01001082 c.recv(1)
Guido van Rossum62cbc8a2007-04-09 00:41:25 +00001083 self._box.unlock()
1084 finally:
1085 os._exit(0)
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001086
Charles-François Natali78ed83d2011-12-19 12:18:55 +01001087 # In the parent, wait until the child signals it locked the mailbox.
Charles-François Natalibf383152011-12-20 11:48:22 +01001088 p.recv(1)
Thomas Wouters00ee7ba2006-08-21 19:07:27 +00001089 try:
1090 self.assertRaises(mailbox.ExternalClashError,
1091 self._box.lock)
1092 finally:
Charles-François Natali78ed83d2011-12-19 12:18:55 +01001093 # Signal the child it can now release the lock and exit.
Charles-François Natalibf383152011-12-20 11:48:22 +01001094 p.send(b'p')
Thomas Wouters00ee7ba2006-08-21 19:07:27 +00001095 # Wait for child to exit. Locking should now succeed.
Victor Stinner278c1e12020-03-31 20:08:12 +02001096 support.wait_process(pid, exitcode=0)
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001097
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001098 self._box.lock()
1099 self._box.unlock()
1100
Thomas Wouters89f507f2006-12-13 04:49:30 +00001101 def test_relock(self):
1102 # Test case for bug #1575506: the mailbox class was locking the
1103 # wrong file object in its flush() method.
1104 msg = "Subject: sub\n\nbody\n"
1105 key1 = self._box.add(msg)
1106 self._box.flush()
1107 self._box.close()
1108
1109 self._box = self._factory(self._path)
1110 self._box.lock()
1111 key2 = self._box.add(msg)
1112 self._box.flush()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001113 self.assertTrue(self._box._locked)
Thomas Wouters89f507f2006-12-13 04:49:30 +00001114 self._box.close()
1115
1116
R David Murray317c8d22012-04-08 16:46:18 -04001117class TestMbox(_TestMboxMMDF, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001118
1119 _factory = lambda self, path, factory=None: mailbox.mbox(path, factory)
1120
Serhiy Storchaka43767632013-11-03 21:31:38 +02001121 @unittest.skipUnless(hasattr(os, 'umask'), 'test needs os.umask()')
Georg Brandl6aa2d1f2008-08-12 08:35:52 +00001122 def test_file_perms(self):
1123 # From bug #3228, we want to verify that the mailbox file isn't executable,
1124 # even if the umask is set to something that would leave executable bits set.
1125 # We only run this test on platforms that support umask.
Serhiy Storchaka43767632013-11-03 21:31:38 +02001126 try:
1127 old_umask = os.umask(0o077)
1128 self._box.close()
1129 os.unlink(self._path)
1130 self._box = mailbox.mbox(self._path, create=True)
1131 self._box.add('')
1132 self._box.close()
1133 finally:
1134 os.umask(old_umask)
Georg Brandl6aa2d1f2008-08-12 08:35:52 +00001135
Serhiy Storchaka43767632013-11-03 21:31:38 +02001136 st = os.stat(self._path)
1137 perms = st.st_mode
1138 self.assertFalse((perms & 0o111)) # Execute bits should all be off.
Thomas Wouters477c8d52006-05-27 19:21:47 +00001139
Petri Lehtinenf39884b2012-09-25 22:00:32 +03001140 def test_terminating_newline(self):
1141 message = email.message.Message()
1142 message['From'] = 'john@example.com'
1143 message.set_payload('No newline at the end')
1144 i = self._box.add(message)
1145
1146 # A newline should have been appended to the payload
1147 message = self._box.get(i)
1148 self.assertEqual(message.get_payload(), 'No newline at the end\n')
1149
1150 def test_message_separator(self):
1151 # Check there's always a single blank line after each message
1152 self._box.add('From: foo\n\n0') # No newline at the end
1153 with open(self._path) as f:
1154 data = f.read()
1155 self.assertEqual(data[-3:], '0\n\n')
1156
1157 self._box.add('From: foo\n\n0\n') # Newline at the end
1158 with open(self._path) as f:
1159 data = f.read()
1160 self.assertEqual(data[-3:], '0\n\n')
1161
1162
R David Murray317c8d22012-04-08 16:46:18 -04001163class TestMMDF(_TestMboxMMDF, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001164
1165 _factory = lambda self, path, factory=None: mailbox.MMDF(path, factory)
1166
1167
R David Murray317c8d22012-04-08 16:46:18 -04001168class TestMH(TestMailbox, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001169
1170 _factory = lambda self, path, factory=None: mailbox.MH(path, factory)
1171
R. David Murrayfc141142011-02-11 22:47:17 +00001172 def assertMailboxEmpty(self):
1173 self.assertEqual(os.listdir(self._path), ['.mh_sequences'])
1174
Thomas Wouters477c8d52006-05-27 19:21:47 +00001175 def test_list_folders(self):
1176 # List folders
1177 self._box.add_folder('one')
1178 self._box.add_folder('two')
1179 self._box.add_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001180 self.assertEqual(len(self._box.list_folders()), 3)
Guido van Rossumea834472007-07-27 05:17:50 +00001181 self.assertEqual(set(self._box.list_folders()),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001182 set(('one', 'two', 'three')))
1183
1184 def test_get_folder(self):
1185 # Open folders
Thomas Wouters89f507f2006-12-13 04:49:30 +00001186 def dummy_factory (s):
1187 return None
1188 self._box = self._factory(self._path, dummy_factory)
Thomas Wouters9fe394c2007-02-05 01:24:16 +00001189
Thomas Wouters89f507f2006-12-13 04:49:30 +00001190 new_folder = self._box.add_folder('foo.bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001191 folder0 = self._box.get_folder('foo.bar')
1192 folder0.add(self._template % 'bar')
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001193 self.assertTrue(os.path.isdir(os.path.join(self._path, 'foo.bar')))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001194 folder1 = self._box.get_folder('foo.bar')
Guido van Rossumea834472007-07-27 05:17:50 +00001195 self.assertEqual(folder1.get_string(folder1.keys()[0]),
1196 self._template % 'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001197
Thomas Wouters89f507f2006-12-13 04:49:30 +00001198 # Test for bug #1569790: verify that folders returned by .get_folder()
1199 # use the same factory function.
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001200 self.assertIs(new_folder._factory, self._box._factory)
1201 self.assertIs(folder0._factory, self._box._factory)
Thomas Wouters89f507f2006-12-13 04:49:30 +00001202
Thomas Wouters477c8d52006-05-27 19:21:47 +00001203 def test_add_and_remove_folders(self):
1204 # Delete folders
1205 self._box.add_folder('one')
1206 self._box.add_folder('two')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001207 self.assertEqual(len(self._box.list_folders()), 2)
Guido van Rossumea834472007-07-27 05:17:50 +00001208 self.assertEqual(set(self._box.list_folders()), set(('one', 'two')))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001209 self._box.remove_folder('one')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001210 self.assertEqual(len(self._box.list_folders()), 1)
1211 self.assertEqual(set(self._box.list_folders()), set(('two',)))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001212 self._box.add_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001213 self.assertEqual(len(self._box.list_folders()), 2)
Guido van Rossumea834472007-07-27 05:17:50 +00001214 self.assertEqual(set(self._box.list_folders()), set(('two', 'three')))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001215 self._box.remove_folder('three')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001216 self.assertEqual(len(self._box.list_folders()), 1)
1217 self.assertEqual(set(self._box.list_folders()), set(('two',)))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001218 self._box.remove_folder('two')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001219 self.assertEqual(len(self._box.list_folders()), 0)
1220 self.assertEqual(self._box.list_folders(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001221
1222 def test_sequences(self):
1223 # Get and set sequences
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001224 self.assertEqual(self._box.get_sequences(), {})
Thomas Wouters477c8d52006-05-27 19:21:47 +00001225 msg0 = mailbox.MHMessage(self._template % 0)
1226 msg0.add_sequence('foo')
1227 key0 = self._box.add(msg0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001228 self.assertEqual(self._box.get_sequences(), {'foo':[key0]})
Thomas Wouters477c8d52006-05-27 19:21:47 +00001229 msg1 = mailbox.MHMessage(self._template % 1)
1230 msg1.set_sequences(['bar', 'replied', 'foo'])
1231 key1 = self._box.add(msg1)
Guido van Rossumea834472007-07-27 05:17:50 +00001232 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001233 {'foo':[key0, key1], 'bar':[key1], 'replied':[key1]})
1234 msg0.set_sequences(['flagged'])
1235 self._box[key0] = msg0
Guido van Rossumea834472007-07-27 05:17:50 +00001236 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001237 {'foo':[key1], 'bar':[key1], 'replied':[key1],
1238 'flagged':[key0]})
1239 self._box.remove(key1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001240 self.assertEqual(self._box.get_sequences(), {'flagged':[key0]})
Thomas Wouters477c8d52006-05-27 19:21:47 +00001241
R. David Murray548ac412009-04-02 19:44:43 +00001242 def test_issue2625(self):
1243 msg0 = mailbox.MHMessage(self._template % 0)
1244 msg0.add_sequence('foo')
1245 key0 = self._box.add(msg0)
1246 refmsg0 = self._box.get_message(key0)
1247
Benjamin Peterson21896a32010-03-21 22:03:03 +00001248 def test_issue7627(self):
1249 msg0 = mailbox.MHMessage(self._template % 0)
1250 key0 = self._box.add(msg0)
1251 self._box.lock()
1252 self._box.remove(key0)
1253 self._box.unlock()
1254
Thomas Wouters477c8d52006-05-27 19:21:47 +00001255 def test_pack(self):
1256 # Pack the contents of the mailbox
1257 msg0 = mailbox.MHMessage(self._template % 0)
1258 msg1 = mailbox.MHMessage(self._template % 1)
1259 msg2 = mailbox.MHMessage(self._template % 2)
1260 msg3 = mailbox.MHMessage(self._template % 3)
1261 msg0.set_sequences(['foo', 'unseen'])
1262 msg1.set_sequences(['foo'])
1263 msg2.set_sequences(['foo', 'flagged'])
1264 msg3.set_sequences(['foo', 'bar', 'replied'])
1265 key0 = self._box.add(msg0)
1266 key1 = self._box.add(msg1)
1267 key2 = self._box.add(msg2)
1268 key3 = self._box.add(msg3)
Guido van Rossumea834472007-07-27 05:17:50 +00001269 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001270 {'foo':[key0,key1,key2,key3], 'unseen':[key0],
1271 'flagged':[key2], 'bar':[key3], 'replied':[key3]})
1272 self._box.remove(key2)
Guido van Rossumea834472007-07-27 05:17:50 +00001273 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001274 {'foo':[key0,key1,key3], 'unseen':[key0], 'bar':[key3],
1275 'replied':[key3]})
1276 self._box.pack()
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001277 self.assertEqual(self._box.keys(), [1, 2, 3])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001278 key0 = key0
1279 key1 = key0 + 1
1280 key2 = key1 + 1
Guido van Rossumea834472007-07-27 05:17:50 +00001281 self.assertEqual(self._box.get_sequences(),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001282 {'foo':[1, 2, 3], 'unseen':[1], 'bar':[3], 'replied':[3]})
1283
Thomas Wouters89f507f2006-12-13 04:49:30 +00001284 # Test case for packing while holding the mailbox locked.
1285 key0 = self._box.add(msg1)
1286 key1 = self._box.add(msg1)
1287 key2 = self._box.add(msg1)
1288 key3 = self._box.add(msg1)
1289
1290 self._box.remove(key0)
1291 self._box.remove(key2)
1292 self._box.lock()
1293 self._box.pack()
1294 self._box.unlock()
Guido van Rossumea834472007-07-27 05:17:50 +00001295 self.assertEqual(self._box.get_sequences(),
Thomas Wouters89f507f2006-12-13 04:49:30 +00001296 {'foo':[1, 2, 3, 4, 5],
1297 'unseen':[1], 'bar':[3], 'replied':[3]})
Thomas Wouters9fe394c2007-02-05 01:24:16 +00001298
Thomas Wouters477c8d52006-05-27 19:21:47 +00001299 def _get_lock_path(self):
1300 return os.path.join(self._path, '.mh_sequences.lock')
1301
1302
Petri Lehtinenf29435f2012-06-28 13:48:17 +03001303class TestBabyl(_TestSingleFile, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001304
1305 _factory = lambda self, path, factory=None: mailbox.Babyl(path, factory)
1306
R. David Murrayfc141142011-02-11 22:47:17 +00001307 def assertMailboxEmpty(self):
1308 with open(self._path) as f:
1309 self.assertEqual(f.readlines(), [])
1310
Thomas Wouters477c8d52006-05-27 19:21:47 +00001311 def tearDown(self):
Brett Cannon653238a2010-10-30 00:13:00 +00001312 super().tearDown()
Guido van Rossumc12a8132007-10-26 04:29:23 +00001313 self._box.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001314 self._delete_recursively(self._path)
Serhiy Storchaka93558682020-06-20 11:10:31 +03001315 for lock_remnant in glob.glob(glob.escape(self._path) + '.*'):
Hai Shi96a6a6d2020-07-09 21:25:10 +08001316 os_helper.unlink(lock_remnant)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001317
1318 def test_labels(self):
1319 # Get labels from the mailbox
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001320 self.assertEqual(self._box.get_labels(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001321 msg0 = mailbox.BabylMessage(self._template % 0)
1322 msg0.add_label('foo')
1323 key0 = self._box.add(msg0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001324 self.assertEqual(self._box.get_labels(), ['foo'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001325 msg1 = mailbox.BabylMessage(self._template % 1)
1326 msg1.set_labels(['bar', 'answered', 'foo'])
1327 key1 = self._box.add(msg1)
Guido van Rossumea834472007-07-27 05:17:50 +00001328 self.assertEqual(set(self._box.get_labels()), set(['foo', 'bar']))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001329 msg0.set_labels(['blah', 'filed'])
1330 self._box[key0] = msg0
Guido van Rossumea834472007-07-27 05:17:50 +00001331 self.assertEqual(set(self._box.get_labels()),
Thomas Wouters477c8d52006-05-27 19:21:47 +00001332 set(['foo', 'bar', 'blah']))
1333 self._box.remove(key1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001334 self.assertEqual(set(self._box.get_labels()), set(['blah']))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001335
1336
R David Murray05ff9902011-06-17 12:54:56 -04001337class FakeFileLikeObject:
1338
1339 def __init__(self):
1340 self.closed = False
1341
1342 def close(self):
1343 self.closed = True
1344
1345
1346class FakeMailBox(mailbox.Mailbox):
1347
1348 def __init__(self):
1349 mailbox.Mailbox.__init__(self, '', lambda file: None)
1350 self.files = [FakeFileLikeObject() for i in range(10)]
1351
1352 def get_file(self, key):
1353 return self.files[key]
1354
1355
1356class TestFakeMailBox(unittest.TestCase):
1357
1358 def test_closing_fd(self):
1359 box = FakeMailBox()
1360 for i in range(10):
1361 self.assertFalse(box.files[i].closed)
1362 for i in range(10):
1363 box[i]
1364 for i in range(10):
1365 self.assertTrue(box.files[i].closed)
1366
1367
R David Murray317c8d22012-04-08 16:46:18 -04001368class TestMessage(TestBase, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001369
1370 _factory = mailbox.Message # Overridden by subclasses to reuse tests
1371
1372 def setUp(self):
Hai Shi96a6a6d2020-07-09 21:25:10 +08001373 self._path = os_helper.TESTFN
Thomas Wouters477c8d52006-05-27 19:21:47 +00001374
1375 def tearDown(self):
1376 self._delete_recursively(self._path)
1377
1378 def test_initialize_with_eMM(self):
Thomas Woutersb2137042007-02-01 18:02:27 +00001379 # Initialize based on email.message.Message instance
Thomas Wouters477c8d52006-05-27 19:21:47 +00001380 eMM = email.message_from_string(_sample_message)
1381 msg = self._factory(eMM)
1382 self._post_initialize_hook(msg)
1383 self._check_sample(msg)
1384
1385 def test_initialize_with_string(self):
1386 # Initialize based on string
1387 msg = self._factory(_sample_message)
1388 self._post_initialize_hook(msg)
1389 self._check_sample(msg)
1390
1391 def test_initialize_with_file(self):
1392 # Initialize based on contents of file
Brian Curtin5acec042010-10-13 02:29:46 +00001393 with open(self._path, 'w+') as f:
1394 f.write(_sample_message)
1395 f.seek(0)
1396 msg = self._factory(f)
1397 self._post_initialize_hook(msg)
1398 self._check_sample(msg)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001399
R. David Murrayb7deff12011-01-30 06:21:28 +00001400 def test_initialize_with_binary_file(self):
1401 # Initialize based on contents of binary file
1402 with open(self._path, 'wb+') as f:
1403 f.write(_bytes_sample_message)
1404 f.seek(0)
1405 msg = self._factory(f)
1406 self._post_initialize_hook(msg)
1407 self._check_sample(msg)
1408
Thomas Wouters477c8d52006-05-27 19:21:47 +00001409 def test_initialize_with_nothing(self):
1410 # Initialize without arguments
1411 msg = self._factory()
1412 self._post_initialize_hook(msg)
Ezio Melottie9615932010-01-24 19:26:24 +00001413 self.assertIsInstance(msg, email.message.Message)
1414 self.assertIsInstance(msg, mailbox.Message)
1415 self.assertIsInstance(msg, self._factory)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001416 self.assertEqual(msg.keys(), [])
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001417 self.assertFalse(msg.is_multipart())
Serhiy Storchaka578c6772014-02-08 15:06:08 +02001418 self.assertIsNone(msg.get_payload())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001419
1420 def test_initialize_incorrectly(self):
1421 # Initialize with invalid argument
1422 self.assertRaises(TypeError, lambda: self._factory(object()))
1423
Min ho Kimc4cacc82019-07-31 08:16:13 +10001424 def test_all_eMM_attributes_exist(self):
R David Murrayb019ee72012-04-08 22:36:07 -04001425 # Issue 12537
1426 eMM = email.message_from_string(_sample_message)
1427 msg = self._factory(_sample_message)
1428 for attr in eMM.__dict__:
Serhiy Storchaka578c6772014-02-08 15:06:08 +02001429 self.assertIn(attr, msg.__dict__,
R David Murrayb019ee72012-04-08 22:36:07 -04001430 '{} attribute does not exist'.format(attr))
1431
Thomas Wouters477c8d52006-05-27 19:21:47 +00001432 def test_become_message(self):
1433 # Take on the state of another message
1434 eMM = email.message_from_string(_sample_message)
1435 msg = self._factory()
1436 msg._become_message(eMM)
1437 self._check_sample(msg)
1438
1439 def test_explain_to(self):
1440 # Copy self's format-specific data to other message formats.
1441 # This test is superficial; better ones are in TestMessageConversion.
1442 msg = self._factory()
R David Murrayc988e242012-04-08 21:00:27 -04001443 for class_ in self.all_mailbox_types:
Thomas Wouters477c8d52006-05-27 19:21:47 +00001444 other_msg = class_()
1445 msg._explain_to(other_msg)
Thomas Woutersb2137042007-02-01 18:02:27 +00001446 other_msg = email.message.Message()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001447 self.assertRaises(TypeError, lambda: msg._explain_to(other_msg))
1448
1449 def _post_initialize_hook(self, msg):
1450 # Overridden by subclasses to check extra things after initialization
1451 pass
1452
1453
R David Murray317c8d22012-04-08 16:46:18 -04001454class TestMaildirMessage(TestMessage, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001455
1456 _factory = mailbox.MaildirMessage
1457
1458 def _post_initialize_hook(self, msg):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001459 self.assertEqual(msg._subdir, 'new')
1460 self.assertEqual(msg._info, '')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001461
1462 def test_subdir(self):
1463 # Use get_subdir() and set_subdir()
1464 msg = mailbox.MaildirMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001465 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001466 msg.set_subdir('cur')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001467 self.assertEqual(msg.get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001468 msg.set_subdir('new')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001469 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001470 self.assertRaises(ValueError, lambda: msg.set_subdir('tmp'))
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001471 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001472 msg.set_subdir('new')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001473 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001474 self._check_sample(msg)
1475
1476 def test_flags(self):
1477 # Use get_flags(), set_flags(), add_flag(), remove_flag()
1478 msg = mailbox.MaildirMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001479 self.assertEqual(msg.get_flags(), '')
1480 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001481 msg.set_flags('F')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001482 self.assertEqual(msg.get_subdir(), 'new')
1483 self.assertEqual(msg.get_flags(), 'F')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001484 msg.set_flags('SDTP')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001485 self.assertEqual(msg.get_flags(), 'DPST')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001486 msg.add_flag('FT')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001487 self.assertEqual(msg.get_flags(), 'DFPST')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001488 msg.remove_flag('TDRP')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001489 self.assertEqual(msg.get_flags(), 'FS')
1490 self.assertEqual(msg.get_subdir(), 'new')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001491 self._check_sample(msg)
1492
1493 def test_date(self):
1494 # Use get_date() and set_date()
1495 msg = mailbox.MaildirMessage(_sample_message)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001496 self.assertLess(abs(msg.get_date() - time.time()), 60)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001497 msg.set_date(0.0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001498 self.assertEqual(msg.get_date(), 0.0)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001499
1500 def test_info(self):
1501 # Use get_info() and set_info()
1502 msg = mailbox.MaildirMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001503 self.assertEqual(msg.get_info(), '')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001504 msg.set_info('1,foo=bar')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001505 self.assertEqual(msg.get_info(), '1,foo=bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001506 self.assertRaises(TypeError, lambda: msg.set_info(None))
1507 self._check_sample(msg)
1508
1509 def test_info_and_flags(self):
1510 # Test interaction of info and flag methods
1511 msg = mailbox.MaildirMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001512 self.assertEqual(msg.get_info(), '')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001513 msg.set_flags('SF')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001514 self.assertEqual(msg.get_flags(), 'FS')
1515 self.assertEqual(msg.get_info(), '2,FS')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001516 msg.set_info('1,')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001517 self.assertEqual(msg.get_flags(), '')
1518 self.assertEqual(msg.get_info(), '1,')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001519 msg.remove_flag('RPT')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001520 self.assertEqual(msg.get_flags(), '')
1521 self.assertEqual(msg.get_info(), '1,')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001522 msg.add_flag('D')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001523 self.assertEqual(msg.get_flags(), 'D')
1524 self.assertEqual(msg.get_info(), '2,D')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001525 self._check_sample(msg)
1526
1527
R David Murray317c8d22012-04-08 16:46:18 -04001528class _TestMboxMMDFMessage:
Thomas Wouters477c8d52006-05-27 19:21:47 +00001529
1530 _factory = mailbox._mboxMMDFMessage
1531
1532 def _post_initialize_hook(self, msg):
1533 self._check_from(msg)
1534
1535 def test_initialize_with_unixfrom(self):
1536 # Initialize with a message that already has a _unixfrom attribute
1537 msg = mailbox.Message(_sample_message)
1538 msg.set_unixfrom('From foo@bar blah')
1539 msg = mailbox.mboxMessage(msg)
Guido van Rossumea834472007-07-27 05:17:50 +00001540 self.assertEqual(msg.get_from(), 'foo@bar blah', msg.get_from())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001541
1542 def test_from(self):
1543 # Get and set "From " line
1544 msg = mailbox.mboxMessage(_sample_message)
1545 self._check_from(msg)
1546 msg.set_from('foo bar')
Guido van Rossumea834472007-07-27 05:17:50 +00001547 self.assertEqual(msg.get_from(), 'foo bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001548 msg.set_from('foo@bar', True)
1549 self._check_from(msg, 'foo@bar')
1550 msg.set_from('blah@temp', time.localtime())
1551 self._check_from(msg, 'blah@temp')
1552
1553 def test_flags(self):
1554 # Use get_flags(), set_flags(), add_flag(), remove_flag()
1555 msg = mailbox.mboxMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001556 self.assertEqual(msg.get_flags(), '')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001557 msg.set_flags('F')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001558 self.assertEqual(msg.get_flags(), 'F')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001559 msg.set_flags('XODR')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001560 self.assertEqual(msg.get_flags(), 'RODX')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001561 msg.add_flag('FA')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001562 self.assertEqual(msg.get_flags(), 'RODFAX')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001563 msg.remove_flag('FDXA')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001564 self.assertEqual(msg.get_flags(), 'RO')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001565 self._check_sample(msg)
1566
1567 def _check_from(self, msg, sender=None):
1568 # Check contents of "From " line
1569 if sender is None:
1570 sender = "MAILER-DAEMON"
Serhiy Storchaka578c6772014-02-08 15:06:08 +02001571 self.assertIsNotNone(re.match(
1572 sender + r" \w{3} \w{3} [\d ]\d [\d ]\d:\d{2}:\d{2} \d{4}",
1573 msg.get_from()))
Thomas Wouters477c8d52006-05-27 19:21:47 +00001574
1575
R David Murray317c8d22012-04-08 16:46:18 -04001576class TestMboxMessage(_TestMboxMMDFMessage, TestMessage):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001577
1578 _factory = mailbox.mboxMessage
1579
1580
R David Murray317c8d22012-04-08 16:46:18 -04001581class TestMHMessage(TestMessage, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001582
1583 _factory = mailbox.MHMessage
1584
1585 def _post_initialize_hook(self, msg):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001586 self.assertEqual(msg._sequences, [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001587
1588 def test_sequences(self):
1589 # Get, set, join, and leave sequences
1590 msg = mailbox.MHMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001591 self.assertEqual(msg.get_sequences(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001592 msg.set_sequences(['foobar'])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001593 self.assertEqual(msg.get_sequences(), ['foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001594 msg.set_sequences([])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001595 self.assertEqual(msg.get_sequences(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001596 msg.add_sequence('unseen')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001597 self.assertEqual(msg.get_sequences(), ['unseen'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001598 msg.add_sequence('flagged')
Guido van Rossumea834472007-07-27 05:17:50 +00001599 self.assertEqual(msg.get_sequences(), ['unseen', 'flagged'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001600 msg.add_sequence('flagged')
Guido van Rossumea834472007-07-27 05:17:50 +00001601 self.assertEqual(msg.get_sequences(), ['unseen', 'flagged'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001602 msg.remove_sequence('unseen')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001603 self.assertEqual(msg.get_sequences(), ['flagged'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001604 msg.add_sequence('foobar')
Guido van Rossumea834472007-07-27 05:17:50 +00001605 self.assertEqual(msg.get_sequences(), ['flagged', 'foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001606 msg.remove_sequence('replied')
Guido van Rossumea834472007-07-27 05:17:50 +00001607 self.assertEqual(msg.get_sequences(), ['flagged', 'foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001608 msg.set_sequences(['foobar', 'replied'])
Guido van Rossumea834472007-07-27 05:17:50 +00001609 self.assertEqual(msg.get_sequences(), ['foobar', 'replied'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001610
1611
R David Murray317c8d22012-04-08 16:46:18 -04001612class TestBabylMessage(TestMessage, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001613
1614 _factory = mailbox.BabylMessage
1615
1616 def _post_initialize_hook(self, msg):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001617 self.assertEqual(msg._labels, [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001618
1619 def test_labels(self):
1620 # Get, set, join, and leave labels
1621 msg = mailbox.BabylMessage(_sample_message)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001622 self.assertEqual(msg.get_labels(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001623 msg.set_labels(['foobar'])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001624 self.assertEqual(msg.get_labels(), ['foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001625 msg.set_labels([])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001626 self.assertEqual(msg.get_labels(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001627 msg.add_label('filed')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001628 self.assertEqual(msg.get_labels(), ['filed'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001629 msg.add_label('resent')
Guido van Rossumea834472007-07-27 05:17:50 +00001630 self.assertEqual(msg.get_labels(), ['filed', 'resent'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001631 msg.add_label('resent')
Guido van Rossumea834472007-07-27 05:17:50 +00001632 self.assertEqual(msg.get_labels(), ['filed', 'resent'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001633 msg.remove_label('filed')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001634 self.assertEqual(msg.get_labels(), ['resent'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001635 msg.add_label('foobar')
Guido van Rossumea834472007-07-27 05:17:50 +00001636 self.assertEqual(msg.get_labels(), ['resent', 'foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001637 msg.remove_label('unseen')
Guido van Rossumea834472007-07-27 05:17:50 +00001638 self.assertEqual(msg.get_labels(), ['resent', 'foobar'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001639 msg.set_labels(['foobar', 'answered'])
Guido van Rossumea834472007-07-27 05:17:50 +00001640 self.assertEqual(msg.get_labels(), ['foobar', 'answered'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001641
1642 def test_visible(self):
1643 # Get, set, and update visible headers
1644 msg = mailbox.BabylMessage(_sample_message)
1645 visible = msg.get_visible()
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001646 self.assertEqual(visible.keys(), [])
Serhiy Storchaka578c6772014-02-08 15:06:08 +02001647 self.assertIsNone(visible.get_payload())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001648 visible['User-Agent'] = 'FooBar 1.0'
1649 visible['X-Whatever'] = 'Blah'
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001650 self.assertEqual(msg.get_visible().keys(), [])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001651 msg.set_visible(visible)
1652 visible = msg.get_visible()
Serhiy Storchaka578c6772014-02-08 15:06:08 +02001653 self.assertEqual(visible.keys(), ['User-Agent', 'X-Whatever'])
1654 self.assertEqual(visible['User-Agent'], 'FooBar 1.0')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001655 self.assertEqual(visible['X-Whatever'], 'Blah')
Serhiy Storchaka578c6772014-02-08 15:06:08 +02001656 self.assertIsNone(visible.get_payload())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001657 msg.update_visible()
Guido van Rossumea834472007-07-27 05:17:50 +00001658 self.assertEqual(visible.keys(), ['User-Agent', 'X-Whatever'])
Serhiy Storchaka578c6772014-02-08 15:06:08 +02001659 self.assertIsNone(visible.get_payload())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001660 visible = msg.get_visible()
Guido van Rossumea834472007-07-27 05:17:50 +00001661 self.assertEqual(visible.keys(), ['User-Agent', 'Date', 'From', 'To',
1662 'Subject'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001663 for header in ('User-Agent', 'Date', 'From', 'To', 'Subject'):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001664 self.assertEqual(visible[header], msg[header])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001665
1666
R David Murray317c8d22012-04-08 16:46:18 -04001667class TestMMDFMessage(_TestMboxMMDFMessage, TestMessage):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001668
1669 _factory = mailbox.MMDFMessage
1670
1671
R David Murray317c8d22012-04-08 16:46:18 -04001672class TestMessageConversion(TestBase, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00001673
1674 def test_plain_to_x(self):
1675 # Convert Message to all formats
R David Murrayc988e242012-04-08 21:00:27 -04001676 for class_ in self.all_mailbox_types:
Thomas Wouters477c8d52006-05-27 19:21:47 +00001677 msg_plain = mailbox.Message(_sample_message)
1678 msg = class_(msg_plain)
1679 self._check_sample(msg)
1680
1681 def test_x_to_plain(self):
1682 # Convert all formats to Message
R David Murrayc988e242012-04-08 21:00:27 -04001683 for class_ in self.all_mailbox_types:
Thomas Wouters477c8d52006-05-27 19:21:47 +00001684 msg = class_(_sample_message)
1685 msg_plain = mailbox.Message(msg)
1686 self._check_sample(msg_plain)
1687
R. David Murrayb7deff12011-01-30 06:21:28 +00001688 def test_x_from_bytes(self):
1689 # Convert all formats to Message
R David Murrayc988e242012-04-08 21:00:27 -04001690 for class_ in self.all_mailbox_types:
R. David Murrayb7deff12011-01-30 06:21:28 +00001691 msg = class_(_bytes_sample_message)
1692 self._check_sample(msg)
1693
Thomas Wouters477c8d52006-05-27 19:21:47 +00001694 def test_x_to_invalid(self):
1695 # Convert all formats to an invalid format
R David Murrayc988e242012-04-08 21:00:27 -04001696 for class_ in self.all_mailbox_types:
Thomas Wouters477c8d52006-05-27 19:21:47 +00001697 self.assertRaises(TypeError, lambda: class_(False))
1698
R David Murrayb019ee72012-04-08 22:36:07 -04001699 def test_type_specific_attributes_removed_on_conversion(self):
1700 reference = {class_: class_(_sample_message).__dict__
1701 for class_ in self.all_mailbox_types}
1702 for class1 in self.all_mailbox_types:
1703 for class2 in self.all_mailbox_types:
1704 if class1 is class2:
1705 continue
1706 source = class1(_sample_message)
1707 target = class2(source)
1708 type_specific = [a for a in reference[class1]
1709 if a not in reference[class2]]
1710 for attr in type_specific:
1711 self.assertNotIn(attr, target.__dict__,
1712 "while converting {} to {}".format(class1, class2))
1713
Thomas Wouters477c8d52006-05-27 19:21:47 +00001714 def test_maildir_to_maildir(self):
1715 # Convert MaildirMessage to MaildirMessage
1716 msg_maildir = mailbox.MaildirMessage(_sample_message)
1717 msg_maildir.set_flags('DFPRST')
1718 msg_maildir.set_subdir('cur')
1719 date = msg_maildir.get_date()
1720 msg = mailbox.MaildirMessage(msg_maildir)
1721 self._check_sample(msg)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001722 self.assertEqual(msg.get_flags(), 'DFPRST')
1723 self.assertEqual(msg.get_subdir(), 'cur')
1724 self.assertEqual(msg.get_date(), date)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001725
1726 def test_maildir_to_mboxmmdf(self):
1727 # Convert MaildirMessage to mboxmessage and MMDFMessage
1728 pairs = (('D', ''), ('F', 'F'), ('P', ''), ('R', 'A'), ('S', 'R'),
1729 ('T', 'D'), ('DFPRST', 'RDFA'))
1730 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1731 msg_maildir = mailbox.MaildirMessage(_sample_message)
1732 msg_maildir.set_date(0.0)
1733 for setting, result in pairs:
1734 msg_maildir.set_flags(setting)
1735 msg = class_(msg_maildir)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001736 self.assertEqual(msg.get_flags(), result)
Guido van Rossumea834472007-07-27 05:17:50 +00001737 self.assertEqual(msg.get_from(), 'MAILER-DAEMON %s' %
Thomas Wouters477c8d52006-05-27 19:21:47 +00001738 time.asctime(time.gmtime(0.0)))
1739 msg_maildir.set_subdir('cur')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001740 self.assertEqual(class_(msg_maildir).get_flags(), 'RODFA')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001741
1742 def test_maildir_to_mh(self):
1743 # Convert MaildirMessage to MHMessage
1744 msg_maildir = mailbox.MaildirMessage(_sample_message)
1745 pairs = (('D', ['unseen']), ('F', ['unseen', 'flagged']),
1746 ('P', ['unseen']), ('R', ['unseen', 'replied']), ('S', []),
1747 ('T', ['unseen']), ('DFPRST', ['replied', 'flagged']))
1748 for setting, result in pairs:
1749 msg_maildir.set_flags(setting)
Guido van Rossumea834472007-07-27 05:17:50 +00001750 self.assertEqual(mailbox.MHMessage(msg_maildir).get_sequences(),
1751 result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001752
1753 def test_maildir_to_babyl(self):
1754 # Convert MaildirMessage to Babyl
1755 msg_maildir = mailbox.MaildirMessage(_sample_message)
1756 pairs = (('D', ['unseen']), ('F', ['unseen']),
1757 ('P', ['unseen', 'forwarded']), ('R', ['unseen', 'answered']),
1758 ('S', []), ('T', ['unseen', 'deleted']),
1759 ('DFPRST', ['deleted', 'answered', 'forwarded']))
1760 for setting, result in pairs:
1761 msg_maildir.set_flags(setting)
Guido van Rossumea834472007-07-27 05:17:50 +00001762 self.assertEqual(mailbox.BabylMessage(msg_maildir).get_labels(),
1763 result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001764
1765 def test_mboxmmdf_to_maildir(self):
1766 # Convert mboxMessage and MMDFMessage to MaildirMessage
1767 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1768 msg_mboxMMDF = class_(_sample_message)
1769 msg_mboxMMDF.set_from('foo@bar', time.gmtime(0.0))
1770 pairs = (('R', 'S'), ('O', ''), ('D', 'T'), ('F', 'F'), ('A', 'R'),
1771 ('RODFA', 'FRST'))
1772 for setting, result in pairs:
1773 msg_mboxMMDF.set_flags(setting)
1774 msg = mailbox.MaildirMessage(msg_mboxMMDF)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001775 self.assertEqual(msg.get_flags(), result)
Alexandre Vassalottib27a1d22009-07-22 23:27:17 +00001776 self.assertEqual(msg.get_date(), 0.0)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001777 msg_mboxMMDF.set_flags('O')
Guido van Rossumea834472007-07-27 05:17:50 +00001778 self.assertEqual(mailbox.MaildirMessage(msg_mboxMMDF).get_subdir(),
1779 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001780
1781 def test_mboxmmdf_to_mboxmmdf(self):
1782 # Convert mboxMessage and MMDFMessage to mboxMessage and MMDFMessage
1783 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1784 msg_mboxMMDF = class_(_sample_message)
1785 msg_mboxMMDF.set_flags('RODFA')
1786 msg_mboxMMDF.set_from('foo@bar')
1787 for class2_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1788 msg2 = class2_(msg_mboxMMDF)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001789 self.assertEqual(msg2.get_flags(), 'RODFA')
1790 self.assertEqual(msg2.get_from(), 'foo@bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001791
1792 def test_mboxmmdf_to_mh(self):
1793 # Convert mboxMessage and MMDFMessage to MHMessage
1794 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1795 msg_mboxMMDF = class_(_sample_message)
1796 pairs = (('R', []), ('O', ['unseen']), ('D', ['unseen']),
1797 ('F', ['unseen', 'flagged']),
1798 ('A', ['unseen', 'replied']),
1799 ('RODFA', ['replied', 'flagged']))
1800 for setting, result in pairs:
1801 msg_mboxMMDF.set_flags(setting)
Guido van Rossumea834472007-07-27 05:17:50 +00001802 self.assertEqual(mailbox.MHMessage(msg_mboxMMDF).get_sequences(),
1803 result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001804
1805 def test_mboxmmdf_to_babyl(self):
1806 # Convert mboxMessage and MMDFMessage to BabylMessage
1807 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1808 msg = class_(_sample_message)
1809 pairs = (('R', []), ('O', ['unseen']),
1810 ('D', ['unseen', 'deleted']), ('F', ['unseen']),
1811 ('A', ['unseen', 'answered']),
1812 ('RODFA', ['deleted', 'answered']))
1813 for setting, result in pairs:
1814 msg.set_flags(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001815 self.assertEqual(mailbox.BabylMessage(msg).get_labels(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001816
1817 def test_mh_to_maildir(self):
1818 # Convert MHMessage to MaildirMessage
1819 pairs = (('unseen', ''), ('replied', 'RS'), ('flagged', 'FS'))
1820 for setting, result in pairs:
1821 msg = mailbox.MHMessage(_sample_message)
1822 msg.add_sequence(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001823 self.assertEqual(mailbox.MaildirMessage(msg).get_flags(), result)
1824 self.assertEqual(mailbox.MaildirMessage(msg).get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001825 msg = mailbox.MHMessage(_sample_message)
1826 msg.add_sequence('unseen')
1827 msg.add_sequence('replied')
1828 msg.add_sequence('flagged')
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001829 self.assertEqual(mailbox.MaildirMessage(msg).get_flags(), 'FR')
1830 self.assertEqual(mailbox.MaildirMessage(msg).get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001831
1832 def test_mh_to_mboxmmdf(self):
1833 # Convert MHMessage to mboxMessage and MMDFMessage
1834 pairs = (('unseen', 'O'), ('replied', 'ROA'), ('flagged', 'ROF'))
1835 for setting, result in pairs:
1836 msg = mailbox.MHMessage(_sample_message)
1837 msg.add_sequence(setting)
1838 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001839 self.assertEqual(class_(msg).get_flags(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001840 msg = mailbox.MHMessage(_sample_message)
1841 msg.add_sequence('unseen')
1842 msg.add_sequence('replied')
1843 msg.add_sequence('flagged')
1844 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001845 self.assertEqual(class_(msg).get_flags(), 'OFA')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001846
1847 def test_mh_to_mh(self):
1848 # Convert MHMessage to MHMessage
1849 msg = mailbox.MHMessage(_sample_message)
1850 msg.add_sequence('unseen')
1851 msg.add_sequence('replied')
1852 msg.add_sequence('flagged')
Guido van Rossumea834472007-07-27 05:17:50 +00001853 self.assertEqual(mailbox.MHMessage(msg).get_sequences(),
1854 ['unseen', 'replied', 'flagged'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001855
1856 def test_mh_to_babyl(self):
1857 # Convert MHMessage to BabylMessage
1858 pairs = (('unseen', ['unseen']), ('replied', ['answered']),
1859 ('flagged', []))
1860 for setting, result in pairs:
1861 msg = mailbox.MHMessage(_sample_message)
1862 msg.add_sequence(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001863 self.assertEqual(mailbox.BabylMessage(msg).get_labels(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001864 msg = mailbox.MHMessage(_sample_message)
1865 msg.add_sequence('unseen')
1866 msg.add_sequence('replied')
1867 msg.add_sequence('flagged')
Guido van Rossumea834472007-07-27 05:17:50 +00001868 self.assertEqual(mailbox.BabylMessage(msg).get_labels(),
1869 ['unseen', 'answered'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001870
1871 def test_babyl_to_maildir(self):
1872 # Convert BabylMessage to MaildirMessage
1873 pairs = (('unseen', ''), ('deleted', 'ST'), ('filed', 'S'),
1874 ('answered', 'RS'), ('forwarded', 'PS'), ('edited', 'S'),
1875 ('resent', 'PS'))
1876 for setting, result in pairs:
1877 msg = mailbox.BabylMessage(_sample_message)
1878 msg.add_label(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001879 self.assertEqual(mailbox.MaildirMessage(msg).get_flags(), result)
1880 self.assertEqual(mailbox.MaildirMessage(msg).get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001881 msg = mailbox.BabylMessage(_sample_message)
1882 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1883 'edited', 'resent'):
1884 msg.add_label(label)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001885 self.assertEqual(mailbox.MaildirMessage(msg).get_flags(), 'PRT')
1886 self.assertEqual(mailbox.MaildirMessage(msg).get_subdir(), 'cur')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001887
1888 def test_babyl_to_mboxmmdf(self):
1889 # Convert BabylMessage to mboxMessage and MMDFMessage
1890 pairs = (('unseen', 'O'), ('deleted', 'ROD'), ('filed', 'RO'),
1891 ('answered', 'ROA'), ('forwarded', 'RO'), ('edited', 'RO'),
1892 ('resent', 'RO'))
1893 for setting, result in pairs:
1894 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1895 msg = mailbox.BabylMessage(_sample_message)
1896 msg.add_label(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001897 self.assertEqual(class_(msg).get_flags(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001898 msg = mailbox.BabylMessage(_sample_message)
1899 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1900 'edited', 'resent'):
1901 msg.add_label(label)
1902 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001903 self.assertEqual(class_(msg).get_flags(), 'ODA')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001904
1905 def test_babyl_to_mh(self):
1906 # Convert BabylMessage to MHMessage
1907 pairs = (('unseen', ['unseen']), ('deleted', []), ('filed', []),
1908 ('answered', ['replied']), ('forwarded', []), ('edited', []),
1909 ('resent', []))
1910 for setting, result in pairs:
1911 msg = mailbox.BabylMessage(_sample_message)
1912 msg.add_label(setting)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001913 self.assertEqual(mailbox.MHMessage(msg).get_sequences(), result)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001914 msg = mailbox.BabylMessage(_sample_message)
1915 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1916 'edited', 'resent'):
1917 msg.add_label(label)
Guido van Rossumea834472007-07-27 05:17:50 +00001918 self.assertEqual(mailbox.MHMessage(msg).get_sequences(),
1919 ['unseen', 'replied'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001920
1921 def test_babyl_to_babyl(self):
1922 # Convert BabylMessage to BabylMessage
1923 msg = mailbox.BabylMessage(_sample_message)
1924 msg.update_visible()
1925 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1926 'edited', 'resent'):
1927 msg.add_label(label)
1928 msg2 = mailbox.BabylMessage(msg)
Guido van Rossumea834472007-07-27 05:17:50 +00001929 self.assertEqual(msg2.get_labels(), ['unseen', 'deleted', 'filed',
1930 'answered', 'forwarded', 'edited',
1931 'resent'])
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001932 self.assertEqual(msg.get_visible().keys(), msg2.get_visible().keys())
Thomas Wouters477c8d52006-05-27 19:21:47 +00001933 for key in msg.get_visible().keys():
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001934 self.assertEqual(msg.get_visible()[key], msg2.get_visible()[key])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001935
1936
1937class TestProxyFileBase(TestBase):
1938
1939 def _test_read(self, proxy):
1940 # Read by byte
1941 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001942 self.assertEqual(proxy.read(), b'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001943 proxy.seek(1)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001944 self.assertEqual(proxy.read(), b'ar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001945 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001946 self.assertEqual(proxy.read(2), b'ba')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001947 proxy.seek(1)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001948 self.assertEqual(proxy.read(-1), b'ar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001949 proxy.seek(2)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001950 self.assertEqual(proxy.read(1000), b'r')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001951
1952 def _test_readline(self, proxy):
1953 # Read by line
Guido van Rossum98297ee2007-11-06 21:34:58 +00001954 linesep = os.linesep.encode()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001955 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001956 self.assertEqual(proxy.readline(), b'foo' + linesep)
1957 self.assertEqual(proxy.readline(), b'bar' + linesep)
1958 self.assertEqual(proxy.readline(), b'fred' + linesep)
1959 self.assertEqual(proxy.readline(), b'bob')
Thomas Wouters477c8d52006-05-27 19:21:47 +00001960 proxy.seek(2)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001961 self.assertEqual(proxy.readline(), b'o' + linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001962 proxy.seek(6 + 2 * len(os.linesep))
Guido van Rossum98297ee2007-11-06 21:34:58 +00001963 self.assertEqual(proxy.readline(), b'fred' + linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001964 proxy.seek(6 + 2 * len(os.linesep))
Guido van Rossum98297ee2007-11-06 21:34:58 +00001965 self.assertEqual(proxy.readline(2), b'fr')
1966 self.assertEqual(proxy.readline(-10), b'ed' + linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001967
1968 def _test_readlines(self, proxy):
1969 # Read multiple lines
Guido van Rossum98297ee2007-11-06 21:34:58 +00001970 linesep = os.linesep.encode()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001971 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001972 self.assertEqual(proxy.readlines(), [b'foo' + linesep,
1973 b'bar' + linesep,
1974 b'fred' + linesep, b'bob'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001975 proxy.seek(0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001976 self.assertEqual(proxy.readlines(2), [b'foo' + linesep])
1977 proxy.seek(3 + len(linesep))
1978 self.assertEqual(proxy.readlines(4 + len(linesep)),
1979 [b'bar' + linesep, b'fred' + linesep])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001980 proxy.seek(3)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001981 self.assertEqual(proxy.readlines(1000), [linesep, b'bar' + linesep,
1982 b'fred' + linesep, b'bob'])
Thomas Wouters477c8d52006-05-27 19:21:47 +00001983
1984 def _test_iteration(self, proxy):
1985 # Iterate by line
Guido van Rossum98297ee2007-11-06 21:34:58 +00001986 linesep = os.linesep.encode()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001987 proxy.seek(0)
1988 iterator = iter(proxy)
Guido van Rossum98297ee2007-11-06 21:34:58 +00001989 self.assertEqual(next(iterator), b'foo' + linesep)
1990 self.assertEqual(next(iterator), b'bar' + linesep)
1991 self.assertEqual(next(iterator), b'fred' + linesep)
1992 self.assertEqual(next(iterator), b'bob')
Georg Brandla18af4e2007-04-21 15:47:16 +00001993 self.assertRaises(StopIteration, next, iterator)
Thomas Wouters477c8d52006-05-27 19:21:47 +00001994
1995 def _test_seek_and_tell(self, proxy):
1996 # Seek and use tell to check position
Guido van Rossum98297ee2007-11-06 21:34:58 +00001997 linesep = os.linesep.encode()
Thomas Wouters477c8d52006-05-27 19:21:47 +00001998 proxy.seek(3)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00001999 self.assertEqual(proxy.tell(), 3)
Guido van Rossum98297ee2007-11-06 21:34:58 +00002000 self.assertEqual(proxy.read(len(linesep)), linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00002001 proxy.seek(2, 1)
Guido van Rossum98297ee2007-11-06 21:34:58 +00002002 self.assertEqual(proxy.read(1 + len(linesep)), b'r' + linesep)
2003 proxy.seek(-3 - len(linesep), 2)
2004 self.assertEqual(proxy.read(3), b'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00002005 proxy.seek(2, 0)
Guido van Rossum98297ee2007-11-06 21:34:58 +00002006 self.assertEqual(proxy.read(), b'o' + linesep + b'bar' + linesep)
Thomas Wouters477c8d52006-05-27 19:21:47 +00002007 proxy.seek(100)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00002008 self.assertFalse(proxy.read())
Thomas Wouters477c8d52006-05-27 19:21:47 +00002009
2010 def _test_close(self, proxy):
2011 # Close a file
R David Murrayc88bce12011-06-17 22:24:05 -04002012 self.assertFalse(proxy.closed)
Thomas Wouters477c8d52006-05-27 19:21:47 +00002013 proxy.close()
R David Murrayc88bce12011-06-17 22:24:05 -04002014 self.assertTrue(proxy.closed)
2015 # Issue 11700 subsequent closes should be a no-op.
2016 proxy.close()
2017 self.assertTrue(proxy.closed)
Thomas Wouters477c8d52006-05-27 19:21:47 +00002018
2019
R David Murray317c8d22012-04-08 16:46:18 -04002020class TestProxyFile(TestProxyFileBase, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00002021
2022 def setUp(self):
Hai Shi96a6a6d2020-07-09 21:25:10 +08002023 self._path = os_helper.TESTFN
Thomas Wouters477c8d52006-05-27 19:21:47 +00002024 self._file = open(self._path, 'wb+')
2025
2026 def tearDown(self):
2027 self._file.close()
2028 self._delete_recursively(self._path)
2029
2030 def test_initialize(self):
2031 # Initialize and check position
Neal Norwitz9a923102007-08-30 06:20:05 +00002032 self._file.write(b'foo')
Thomas Wouters477c8d52006-05-27 19:21:47 +00002033 pos = self._file.tell()
2034 proxy0 = mailbox._ProxyFile(self._file)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002035 self.assertEqual(proxy0.tell(), pos)
2036 self.assertEqual(self._file.tell(), pos)
Thomas Wouters477c8d52006-05-27 19:21:47 +00002037 proxy1 = mailbox._ProxyFile(self._file, 0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002038 self.assertEqual(proxy1.tell(), 0)
2039 self.assertEqual(self._file.tell(), pos)
Thomas Wouters477c8d52006-05-27 19:21:47 +00002040
2041 def test_read(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002042 self._file.write(b'bar')
Thomas Wouters477c8d52006-05-27 19:21:47 +00002043 self._test_read(mailbox._ProxyFile(self._file))
2044
2045 def test_readline(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002046 self._file.write(bytes('foo%sbar%sfred%sbob' % (os.linesep, os.linesep,
2047 os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002048 self._test_readline(mailbox._ProxyFile(self._file))
2049
2050 def test_readlines(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002051 self._file.write(bytes('foo%sbar%sfred%sbob' % (os.linesep, os.linesep,
2052 os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002053 self._test_readlines(mailbox._ProxyFile(self._file))
2054
2055 def test_iteration(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002056 self._file.write(bytes('foo%sbar%sfred%sbob' % (os.linesep, os.linesep,
2057 os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002058 self._test_iteration(mailbox._ProxyFile(self._file))
2059
2060 def test_seek_and_tell(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002061 self._file.write(bytes('foo%sbar%s' % (os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002062 self._test_seek_and_tell(mailbox._ProxyFile(self._file))
2063
2064 def test_close(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002065 self._file.write(bytes('foo%sbar%s' % (os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002066 self._test_close(mailbox._ProxyFile(self._file))
2067
2068
R David Murray317c8d22012-04-08 16:46:18 -04002069class TestPartialFile(TestProxyFileBase, unittest.TestCase):
Thomas Wouters477c8d52006-05-27 19:21:47 +00002070
2071 def setUp(self):
Hai Shi96a6a6d2020-07-09 21:25:10 +08002072 self._path = os_helper.TESTFN
Thomas Wouters477c8d52006-05-27 19:21:47 +00002073 self._file = open(self._path, 'wb+')
2074
2075 def tearDown(self):
2076 self._file.close()
2077 self._delete_recursively(self._path)
2078
2079 def test_initialize(self):
2080 # Initialize and check position
Neal Norwitz9a923102007-08-30 06:20:05 +00002081 self._file.write(bytes('foo' + os.linesep + 'bar', 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002082 pos = self._file.tell()
2083 proxy = mailbox._PartialFile(self._file, 2, 5)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002084 self.assertEqual(proxy.tell(), 0)
2085 self.assertEqual(self._file.tell(), pos)
Thomas Wouters477c8d52006-05-27 19:21:47 +00002086
2087 def test_read(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002088 self._file.write(bytes('***bar***', 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002089 self._test_read(mailbox._PartialFile(self._file, 3, 6))
2090
2091 def test_readline(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002092 self._file.write(bytes('!!!!!foo%sbar%sfred%sbob!!!!!' %
2093 (os.linesep, os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002094 self._test_readline(mailbox._PartialFile(self._file, 5,
2095 18 + 3 * len(os.linesep)))
2096
2097 def test_readlines(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002098 self._file.write(bytes('foo%sbar%sfred%sbob?????' %
2099 (os.linesep, os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002100 self._test_readlines(mailbox._PartialFile(self._file, 0,
2101 13 + 3 * len(os.linesep)))
2102
2103 def test_iteration(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002104 self._file.write(bytes('____foo%sbar%sfred%sbob####' %
2105 (os.linesep, os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002106 self._test_iteration(mailbox._PartialFile(self._file, 4,
2107 17 + 3 * len(os.linesep)))
2108
2109 def test_seek_and_tell(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002110 self._file.write(bytes('(((foo%sbar%s$$$' % (os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002111 self._test_seek_and_tell(mailbox._PartialFile(self._file, 3,
2112 9 + 2 * len(os.linesep)))
2113
2114 def test_close(self):
Neal Norwitz9a923102007-08-30 06:20:05 +00002115 self._file.write(bytes('&foo%sbar%s^' % (os.linesep, os.linesep), 'ascii'))
Thomas Wouters477c8d52006-05-27 19:21:47 +00002116 self._test_close(mailbox._PartialFile(self._file, 1,
2117 6 + 3 * len(os.linesep)))
2118
2119
2120## Start: tests from the original module (for backward compatibility).
2121
Skip Montanaro5253da12004-07-24 19:56:03 +00002122FROM_ = "From some.body@dummy.domain Sat Jul 24 13:43:35 2004\n"
Fred Drakec02bc3e2001-05-21 20:23:21 +00002123DUMMY_MESSAGE = """\
2124From: some.body@dummy.domain
2125To: me@my.domain
Skip Montanaro5253da12004-07-24 19:56:03 +00002126Subject: Simple Test
Fred Drakec02bc3e2001-05-21 20:23:21 +00002127
2128This is a dummy message.
2129"""
2130
Fred Drakec02bc3e2001-05-21 20:23:21 +00002131class MaildirTestCase(unittest.TestCase):
2132
2133 def setUp(self):
2134 # create a new maildir mailbox to work with:
Hai Shi96a6a6d2020-07-09 21:25:10 +08002135 self._dir = os_helper.TESTFN
Vinay Sajipf9596182012-03-02 01:01:13 +00002136 if os.path.isdir(self._dir):
Hai Shi96a6a6d2020-07-09 21:25:10 +08002137 os_helper.rmtree(self._dir)
Vinay Sajipf9596182012-03-02 01:01:13 +00002138 elif os.path.isfile(self._dir):
Hai Shi96a6a6d2020-07-09 21:25:10 +08002139 os_helper.unlink(self._dir)
Fred Drakec02bc3e2001-05-21 20:23:21 +00002140 os.mkdir(self._dir)
2141 os.mkdir(os.path.join(self._dir, "cur"))
2142 os.mkdir(os.path.join(self._dir, "tmp"))
2143 os.mkdir(os.path.join(self._dir, "new"))
2144 self._counter = 1
2145 self._msgfiles = []
2146
2147 def tearDown(self):
Guido van Rossumc1f779c2007-07-03 08:25:58 +00002148 list(map(os.unlink, self._msgfiles))
Hai Shi96a6a6d2020-07-09 21:25:10 +08002149 os_helper.rmdir(os.path.join(self._dir, "cur"))
2150 os_helper.rmdir(os.path.join(self._dir, "tmp"))
2151 os_helper.rmdir(os.path.join(self._dir, "new"))
2152 os_helper.rmdir(self._dir)
Fred Drakec02bc3e2001-05-21 20:23:21 +00002153
Skip Montanaro5253da12004-07-24 19:56:03 +00002154 def createMessage(self, dir, mbox=False):
Jack Jansen97df7b62001-06-19 20:20:05 +00002155 t = int(time.time() % 1000000)
Fred Drakec02bc3e2001-05-21 20:23:21 +00002156 pid = self._counter
2157 self._counter += 1
Skip Montanaro7a98be22007-08-16 14:35:24 +00002158 filename = ".".join((str(t), str(pid), "myhostname", "mydomain"))
Fred Drakec02bc3e2001-05-21 20:23:21 +00002159 tmpname = os.path.join(self._dir, "tmp", filename)
2160 newname = os.path.join(self._dir, dir, filename)
Brian Curtin5acec042010-10-13 02:29:46 +00002161 with open(tmpname, "w") as fp:
2162 self._msgfiles.append(tmpname)
2163 if mbox:
2164 fp.write(FROM_)
2165 fp.write(DUMMY_MESSAGE)
Xavier de Gaye452b3a6a2016-12-12 09:55:57 +01002166 try:
Tim Peters6626c1f2001-05-22 16:29:01 +00002167 os.link(tmpname, newname)
Xavier de Gaye452b3a6a2016-12-12 09:55:57 +01002168 except (AttributeError, PermissionError):
Brian Curtin5acec042010-10-13 02:29:46 +00002169 with open(newname, "w") as fp:
2170 fp.write(DUMMY_MESSAGE)
Fred Drakec02bc3e2001-05-21 20:23:21 +00002171 self._msgfiles.append(newname)
Skip Montanaro5253da12004-07-24 19:56:03 +00002172 return tmpname
Fred Drakec02bc3e2001-05-21 20:23:21 +00002173
2174 def test_empty_maildir(self):
2175 """Test an empty maildir mailbox"""
2176 # Test for regression on bug #117490:
2177 # Make sure the boxes attribute actually gets set.
Hai Shi96a6a6d2020-07-09 21:25:10 +08002178 self.mbox = mailbox.Maildir(os_helper.TESTFN)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00002179 #self.assertTrue(hasattr(self.mbox, "boxes"))
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002180 #self.assertEqual(len(self.mbox.boxes), 0)
Serhiy Storchaka578c6772014-02-08 15:06:08 +02002181 self.assertIsNone(self.mbox.next())
2182 self.assertIsNone(self.mbox.next())
Fred Drakec02bc3e2001-05-21 20:23:21 +00002183
2184 def test_nonempty_maildir_cur(self):
2185 self.createMessage("cur")
Hai Shi96a6a6d2020-07-09 21:25:10 +08002186 self.mbox = mailbox.Maildir(os_helper.TESTFN)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002187 #self.assertEqual(len(self.mbox.boxes), 1)
Serhiy Storchaka578c6772014-02-08 15:06:08 +02002188 self.assertIsNotNone(self.mbox.next())
2189 self.assertIsNone(self.mbox.next())
2190 self.assertIsNone(self.mbox.next())
Fred Drakec02bc3e2001-05-21 20:23:21 +00002191
2192 def test_nonempty_maildir_new(self):
2193 self.createMessage("new")
Hai Shi96a6a6d2020-07-09 21:25:10 +08002194 self.mbox = mailbox.Maildir(os_helper.TESTFN)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002195 #self.assertEqual(len(self.mbox.boxes), 1)
Serhiy Storchaka578c6772014-02-08 15:06:08 +02002196 self.assertIsNotNone(self.mbox.next())
2197 self.assertIsNone(self.mbox.next())
2198 self.assertIsNone(self.mbox.next())
Fred Drakec02bc3e2001-05-21 20:23:21 +00002199
2200 def test_nonempty_maildir_both(self):
2201 self.createMessage("cur")
2202 self.createMessage("new")
Hai Shi96a6a6d2020-07-09 21:25:10 +08002203 self.mbox = mailbox.Maildir(os_helper.TESTFN)
Guido van Rossume61fd5b2007-07-11 12:20:59 +00002204 #self.assertEqual(len(self.mbox.boxes), 2)
Serhiy Storchaka578c6772014-02-08 15:06:08 +02002205 self.assertIsNotNone(self.mbox.next())
2206 self.assertIsNotNone(self.mbox.next())
2207 self.assertIsNone(self.mbox.next())
2208 self.assertIsNone(self.mbox.next())
Fred Drake0aaed272000-10-23 13:39:15 +00002209
Georg Brandledb978f2008-05-11 08:59:40 +00002210## End: tests from the original module (for backward compatibility).
Thomas Wouters477c8d52006-05-27 19:21:47 +00002211
2212
2213_sample_message = """\
2214Return-Path: <gkj@gregorykjohnson.com>
2215X-Original-To: gkj+person@localhost
2216Delivered-To: gkj+person@localhost
2217Received: from localhost (localhost [127.0.0.1])
2218 by andy.gregorykjohnson.com (Postfix) with ESMTP id 356ED9DD17
2219 for <gkj+person@localhost>; Wed, 13 Jul 2005 17:23:16 -0400 (EDT)
2220Delivered-To: gkj@sundance.gregorykjohnson.com
2221Received: from localhost [127.0.0.1]
2222 by localhost with POP3 (fetchmail-6.2.5)
2223 for gkj+person@localhost (single-drop); Wed, 13 Jul 2005 17:23:16 -0400 (EDT)
2224Received: from andy.gregorykjohnson.com (andy.gregorykjohnson.com [64.32.235.228])
2225 by sundance.gregorykjohnson.com (Postfix) with ESMTP id 5B056316746
2226 for <gkj@gregorykjohnson.com>; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)
2227Received: by andy.gregorykjohnson.com (Postfix, from userid 1000)
2228 id 490CD9DD17; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)
2229Date: Wed, 13 Jul 2005 17:23:11 -0400
2230From: "Gregory K. Johnson" <gkj@gregorykjohnson.com>
2231To: gkj@gregorykjohnson.com
2232Subject: Sample message
2233Message-ID: <20050713212311.GC4701@andy.gregorykjohnson.com>
2234Mime-Version: 1.0
2235Content-Type: multipart/mixed; boundary="NMuMz9nt05w80d4+"
2236Content-Disposition: inline
2237User-Agent: Mutt/1.5.9i
2238
2239
2240--NMuMz9nt05w80d4+
2241Content-Type: text/plain; charset=us-ascii
2242Content-Disposition: inline
2243
2244This is a sample message.
2245
2246--
2247Gregory K. Johnson
2248
2249--NMuMz9nt05w80d4+
2250Content-Type: application/octet-stream
2251Content-Disposition: attachment; filename="text.gz"
2252Content-Transfer-Encoding: base64
2253
2254H4sICM2D1UIAA3RleHQAC8nILFYAokSFktSKEoW0zJxUPa7wzJIMhZLyfIWczLzUYj0uAHTs
22553FYlAAAA
2256
2257--NMuMz9nt05w80d4+--
2258"""
2259
R. David Murrayb7deff12011-01-30 06:21:28 +00002260_bytes_sample_message = _sample_message.encode('ascii')
2261
Thomas Wouters477c8d52006-05-27 19:21:47 +00002262_sample_headers = {
2263 "Return-Path":"<gkj@gregorykjohnson.com>",
2264 "X-Original-To":"gkj+person@localhost",
2265 "Delivered-To":"gkj+person@localhost",
2266 "Received":"""from localhost (localhost [127.0.0.1])
2267 by andy.gregorykjohnson.com (Postfix) with ESMTP id 356ED9DD17
2268 for <gkj+person@localhost>; Wed, 13 Jul 2005 17:23:16 -0400 (EDT)""",
2269 "Delivered-To":"gkj@sundance.gregorykjohnson.com",
2270 "Received":"""from localhost [127.0.0.1]
2271 by localhost with POP3 (fetchmail-6.2.5)
2272 for gkj+person@localhost (single-drop); Wed, 13 Jul 2005 17:23:16 -0400 (EDT)""",
2273 "Received":"""from andy.gregorykjohnson.com (andy.gregorykjohnson.com [64.32.235.228])
2274 by sundance.gregorykjohnson.com (Postfix) with ESMTP id 5B056316746
2275 for <gkj@gregorykjohnson.com>; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)""",
2276 "Received":"""by andy.gregorykjohnson.com (Postfix, from userid 1000)
2277 id 490CD9DD17; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)""",
2278 "Date":"Wed, 13 Jul 2005 17:23:11 -0400",
2279 "From":""""Gregory K. Johnson" <gkj@gregorykjohnson.com>""",
2280 "To":"gkj@gregorykjohnson.com",
2281 "Subject":"Sample message",
2282 "Mime-Version":"1.0",
2283 "Content-Type":"""multipart/mixed; boundary="NMuMz9nt05w80d4+\"""",
2284 "Content-Disposition":"inline",
2285 "User-Agent": "Mutt/1.5.9i" }
2286
2287_sample_payloads = ("""This is a sample message.
2288
2289--
2290Gregory K. Johnson
2291""",
2292"""H4sICM2D1UIAA3RleHQAC8nILFYAokSFktSKEoW0zJxUPa7wzJIMhZLyfIWczLzUYj0uAHTs
22933FYlAAAA
2294""")
Fred Drake0aaed272000-10-23 13:39:15 +00002295
Fred Drakec02bc3e2001-05-21 20:23:21 +00002296
Martin Pantered84ab32016-06-06 01:56:09 +00002297class MiscTestCase(unittest.TestCase):
2298 def test__all__(self):
Martin Panter83815ae2016-06-06 02:49:54 +00002299 blacklist = {"linesep", "fcntl"}
Martin Pantered84ab32016-06-06 01:56:09 +00002300 support.check__all__(self, mailbox, blacklist=blacklist)
2301
2302
Fred Drake2e2be372001-09-20 21:33:42 +00002303def test_main():
Thomas Wouters477c8d52006-05-27 19:21:47 +00002304 tests = (TestMailboxSuperclass, TestMaildir, TestMbox, TestMMDF, TestMH,
2305 TestBabyl, TestMessage, TestMaildirMessage, TestMboxMessage,
2306 TestMHMessage, TestBabylMessage, TestMMDFMessage,
2307 TestMessageConversion, TestProxyFile, TestPartialFile,
Martin Pantered84ab32016-06-06 01:56:09 +00002308 MaildirTestCase, TestFakeMailBox, MiscTestCase)
Benjamin Petersonee8712c2008-05-20 21:35:26 +00002309 support.run_unittest(*tests)
2310 support.reap_children()
Fred Drake2e2be372001-09-20 21:33:42 +00002311
2312
Thomas Wouters477c8d52006-05-27 19:21:47 +00002313if __name__ == '__main__':
Fred Drake2e2be372001-09-20 21:33:42 +00002314 test_main()