1
# Copyright (C) 2007, 2009, 2010, 2011 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18
from email.message import Message
19
except ImportError: # python < 3
20
from email.Message import Message
34
def connection_refuser():
36
raise socket.error(errno.ECONNREFUSED, 'Connection Refused')
38
smtp.connect = connect
42
class StubSMTPFactory(object):
43
"""A fake SMTP connection to test the connection setup."""
44
def __init__(self, fail_on=None, smtp_features=None):
45
self._fail_on = fail_on or []
47
self._smtp_features = smtp_features or []
48
self._ehlo_called = False
51
# The factory pretends to be a connection
54
def connect(self, server):
55
self._calls.append(('connect', server))
58
self._calls.append(('helo',))
59
if 'helo' in self._fail_on:
60
return 500, 'helo failure'
62
return 200, 'helo success'
65
self._calls.append(('ehlo',))
66
if 'ehlo' in self._fail_on:
67
return 500, 'ehlo failure'
69
self._ehlo_called = True
70
return 200, 'ehlo success'
72
def has_extn(self, extension):
73
self._calls.append(('has_extn', extension))
74
return self._ehlo_called and extension in self._smtp_features
77
self._calls.append(('starttls',))
78
if 'starttls' in self._fail_on:
79
return 500, 'starttls failure'
81
self._ehlo_called = True
82
return 200, 'starttls success'
85
class WideOpenSMTPFactory(StubSMTPFactory):
86
"""A fake smtp server that implements login by accepting anybody."""
88
def login(self, user, password):
89
self._calls.append(('login', user, password))
92
class TestSMTPConnection(tests.TestCaseInTempDir):
94
def get_connection(self, text, smtp_factory=None):
95
my_config = config.MemoryStack(text)
96
return smtp_connection.SMTPConnection(
97
my_config, _smtp_factory=smtp_factory)
99
def test_defaults(self):
100
conn = self.get_connection(b'')
101
self.assertEqual('localhost', conn._smtp_server)
102
self.assertEqual(None, conn._smtp_username)
103
self.assertEqual(None, conn._smtp_password)
105
def test_smtp_server(self):
106
conn = self.get_connection(b'smtp_server=host:10')
107
self.assertEqual('host:10', conn._smtp_server)
109
def test_missing_server(self):
110
conn = self.get_connection(b'', smtp_factory=connection_refuser)
111
self.assertRaises(smtp_connection.DefaultSMTPConnectionRefused,
113
conn = self.get_connection(b'smtp_server=smtp.example.com',
114
smtp_factory=connection_refuser)
115
self.assertRaises(smtp_connection.SMTPConnectionRefused, conn._connect)
117
def test_smtp_username(self):
118
conn = self.get_connection(b'')
119
self.assertIs(None, conn._smtp_username)
121
conn = self.get_connection(b'smtp_username=joebody')
122
self.assertEqual(u'joebody', conn._smtp_username)
124
def test_smtp_password_from_config(self):
125
conn = self.get_connection(b'')
126
self.assertIs(None, conn._smtp_password)
128
conn = self.get_connection(b'smtp_password=mypass')
129
self.assertEqual(u'mypass', conn._smtp_password)
131
def test_smtp_password_from_user(self):
134
factory = WideOpenSMTPFactory()
135
conn = self.get_connection(
136
b'[DEFAULT]\nsmtp_username=%s\n' % user.encode('ascii'),
137
smtp_factory=factory)
138
self.assertIs(None, conn._smtp_password)
140
ui.ui_factory = ui.CannedInputUIFactory([password])
142
self.assertEqual(password, conn._smtp_password)
144
def test_smtp_password_from_auth_config(self):
147
factory = WideOpenSMTPFactory()
148
conn = self.get_connection(
149
b'[DEFAULT]\nsmtp_username=%s\n' % user.encode('ascii'),
150
smtp_factory=factory)
151
self.assertEqual(user, conn._smtp_username)
152
self.assertIs(None, conn._smtp_password)
153
# Create a config file with the right password
154
conf = config.AuthenticationConfig()
155
conf._get_config().update({'smtptest':
156
{'scheme': 'smtp', 'user':user,
157
'password': password}})
161
self.assertEqual(password, conn._smtp_password)
163
def test_authenticate_with_byte_strings(self):
165
unicode_pass = u'h\xECspass'
166
utf8_pass = unicode_pass.encode('utf-8')
167
factory = WideOpenSMTPFactory()
168
conn = self.get_connection(
169
b'[DEFAULT]\nsmtp_username=%s\nsmtp_password=%s\n'
170
% (user, utf8_pass), smtp_factory=factory)
171
self.assertEqual(unicode_pass, conn._smtp_password)
173
self.assertEqual([('connect', 'localhost'),
175
('has_extn', 'starttls'),
176
('login', user, utf8_pass)], factory._calls)
177
smtp_username, smtp_password = factory._calls[-1][1:]
178
self.assertIsInstance(smtp_username, bytes)
179
self.assertIsInstance(smtp_password, bytes)
181
def test_create_connection(self):
182
factory = StubSMTPFactory()
183
conn = self.get_connection(b'', smtp_factory=factory)
184
conn._create_connection()
185
self.assertEqual([('connect', 'localhost'),
187
('has_extn', 'starttls')], factory._calls)
189
def test_create_connection_ehlo_fails(self):
190
# Check that we call HELO if EHLO failed.
191
factory = StubSMTPFactory(fail_on=['ehlo'])
192
conn = self.get_connection(b'', smtp_factory=factory)
193
conn._create_connection()
194
self.assertEqual([('connect', 'localhost'),
197
('has_extn', 'starttls')], factory._calls)
199
def test_create_connection_ehlo_helo_fails(self):
200
# Check that we raise an exception if both EHLO and HELO fail.
201
factory = StubSMTPFactory(fail_on=['ehlo', 'helo'])
202
conn = self.get_connection(b'', smtp_factory=factory)
203
self.assertRaises(smtp_connection.SMTPError, conn._create_connection)
204
self.assertEqual([('connect', 'localhost'),
206
('helo',)], factory._calls)
208
def test_create_connection_starttls(self):
209
# Check that STARTTLS plus a second EHLO are called if the
210
# server says it supports the feature.
211
factory = StubSMTPFactory(smtp_features=['starttls'])
212
conn = self.get_connection(b'', smtp_factory=factory)
213
conn._create_connection()
214
self.assertEqual([('connect', 'localhost'),
216
('has_extn', 'starttls'),
218
('ehlo',)], factory._calls)
220
def test_create_connection_starttls_fails(self):
221
# Check that we raise an exception if the server claims to
222
# support STARTTLS, but then fails when we try to activate it.
223
factory = StubSMTPFactory(fail_on=['starttls'],
224
smtp_features=['starttls'])
225
conn = self.get_connection(b'', smtp_factory=factory)
226
self.assertRaises(smtp_connection.SMTPError, conn._create_connection)
227
self.assertEqual([('connect', 'localhost'),
229
('has_extn', 'starttls'),
230
('starttls',)], factory._calls)
232
def test_get_message_addresses(self):
235
from_, to = smtp_connection.SMTPConnection.get_message_addresses(msg)
236
self.assertEqual('', from_)
237
self.assertEqual([], to)
239
msg['From'] = '"J. Random Developer" <jrandom@example.com>'
240
msg['To'] = 'John Doe <john@doe.com>, Jane Doe <jane@doe.com>'
241
msg['CC'] = u'Pepe P\xe9rez <pperez@ejemplo.com>'
242
msg['Bcc'] = 'user@localhost'
244
from_, to = smtp_connection.SMTPConnection.get_message_addresses(msg)
245
self.assertEqual('jrandom@example.com', from_)
246
self.assertEqual(sorted(['john@doe.com', 'jane@doe.com',
247
'pperez@ejemplo.com', 'user@localhost']), sorted(to))
249
# now with breezy's EmailMessage
250
msg = email_message.EmailMessage(
251
'"J. Random Developer" <jrandom@example.com>',
252
['John Doe <john@doe.com>', 'Jane Doe <jane@doe.com>',
253
u'Pepe P\xe9rez <pperez@ejemplo.com>', 'user@localhost' ],
256
from_, to = smtp_connection.SMTPConnection.get_message_addresses(msg)
257
self.assertEqual('jrandom@example.com', from_)
258
self.assertEqual(sorted(['john@doe.com', 'jane@doe.com',
259
'pperez@ejemplo.com', 'user@localhost']), sorted(to))
261
def test_destination_address_required(self):
263
msg['From'] = '"J. Random Developer" <jrandom@example.com>'
265
smtp_connection.NoDestinationAddress,
266
smtp_connection.SMTPConnection(config.MemoryStack(b"")
269
msg = email_message.EmailMessage('from@from.com', '', 'subject')
271
smtp_connection.NoDestinationAddress,
272
smtp_connection.SMTPConnection(config.MemoryStack(b"")
275
msg = email_message.EmailMessage('from@from.com', [], 'subject')
277
smtp_connection.NoDestinationAddress,
278
smtp_connection.SMTPConnection(config.MemoryStack(b"")