diff options
Diffstat (limited to 'lib/python2.7/test/test_smtplib.py')
-rw-r--r-- | lib/python2.7/test/test_smtplib.py | 517 |
1 files changed, 0 insertions, 517 deletions
diff --git a/lib/python2.7/test/test_smtplib.py b/lib/python2.7/test/test_smtplib.py deleted file mode 100644 index 81806c9..0000000 --- a/lib/python2.7/test/test_smtplib.py +++ /dev/null @@ -1,517 +0,0 @@ -import asyncore -import email.utils -import socket -import smtpd -import smtplib -import StringIO -import sys -import time -import select - -import unittest -from test import test_support - -try: - import threading -except ImportError: - threading = None - -HOST = test_support.HOST - -def server(evt, buf, serv): - serv.listen(5) - evt.set() - try: - conn, addr = serv.accept() - except socket.timeout: - pass - else: - n = 500 - while buf and n > 0: - r, w, e = select.select([], [conn], []) - if w: - sent = conn.send(buf) - buf = buf[sent:] - - n -= 1 - - conn.close() - finally: - serv.close() - evt.set() - -@unittest.skipUnless(threading, 'Threading required for this test.') -class GeneralTests(unittest.TestCase): - - def setUp(self): - self._threads = test_support.threading_setup() - self.evt = threading.Event() - self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM) - self.sock.settimeout(15) - self.port = test_support.bind_port(self.sock) - servargs = (self.evt, "220 Hola mundo\n", self.sock) - self.thread = threading.Thread(target=server, args=servargs) - self.thread.start() - self.evt.wait() - self.evt.clear() - - def tearDown(self): - self.evt.wait() - self.thread.join() - test_support.threading_cleanup(*self._threads) - - def testBasic1(self): - # connects - smtp = smtplib.SMTP(HOST, self.port) - smtp.close() - - def testBasic2(self): - # connects, include port in host name - smtp = smtplib.SMTP("%s:%s" % (HOST, self.port)) - smtp.close() - - def testLocalHostName(self): - # check that supplied local_hostname is used - smtp = smtplib.SMTP(HOST, self.port, local_hostname="testhost") - self.assertEqual(smtp.local_hostname, "testhost") - smtp.close() - - def testTimeoutDefault(self): - self.assertTrue(socket.getdefaulttimeout() is None) - socket.setdefaulttimeout(30) - try: - smtp = smtplib.SMTP(HOST, self.port) - finally: - socket.setdefaulttimeout(None) - self.assertEqual(smtp.sock.gettimeout(), 30) - smtp.close() - - def testTimeoutNone(self): - self.assertTrue(socket.getdefaulttimeout() is None) - socket.setdefaulttimeout(30) - try: - smtp = smtplib.SMTP(HOST, self.port, timeout=None) - finally: - socket.setdefaulttimeout(None) - self.assertTrue(smtp.sock.gettimeout() is None) - smtp.close() - - def testTimeoutValue(self): - smtp = smtplib.SMTP(HOST, self.port, timeout=30) - self.assertEqual(smtp.sock.gettimeout(), 30) - smtp.close() - - -# Test server thread using the specified SMTP server class -def debugging_server(serv, serv_evt, client_evt): - serv_evt.set() - - try: - if hasattr(select, 'poll'): - poll_fun = asyncore.poll2 - else: - poll_fun = asyncore.poll - - n = 1000 - while asyncore.socket_map and n > 0: - poll_fun(0.01, asyncore.socket_map) - - # when the client conversation is finished, it will - # set client_evt, and it's then ok to kill the server - if client_evt.is_set(): - serv.close() - break - - n -= 1 - - except socket.timeout: - pass - finally: - if not client_evt.is_set(): - # allow some time for the client to read the result - time.sleep(0.5) - serv.close() - asyncore.close_all() - serv_evt.set() - -MSG_BEGIN = '---------- MESSAGE FOLLOWS ----------\n' -MSG_END = '------------ END MESSAGE ------------\n' - -# NOTE: Some SMTP objects in the tests below are created with a non-default -# local_hostname argument to the constructor, since (on some systems) the FQDN -# lookup caused by the default local_hostname sometimes takes so long that the -# test server times out, causing the test to fail. - -# Test behavior of smtpd.DebuggingServer -@unittest.skipUnless(threading, 'Threading required for this test.') -class DebuggingServerTests(unittest.TestCase): - - def setUp(self): - # temporarily replace sys.stdout to capture DebuggingServer output - self.old_stdout = sys.stdout - self.output = StringIO.StringIO() - sys.stdout = self.output - - self._threads = test_support.threading_setup() - self.serv_evt = threading.Event() - self.client_evt = threading.Event() - # Pick a random unused port by passing 0 for the port number - self.serv = smtpd.DebuggingServer((HOST, 0), ('nowhere', -1)) - # Keep a note of what port was assigned - self.port = self.serv.socket.getsockname()[1] - serv_args = (self.serv, self.serv_evt, self.client_evt) - self.thread = threading.Thread(target=debugging_server, args=serv_args) - self.thread.start() - - # wait until server thread has assigned a port number - self.serv_evt.wait() - self.serv_evt.clear() - - def tearDown(self): - # indicate that the client is finished - self.client_evt.set() - # wait for the server thread to terminate - self.serv_evt.wait() - self.thread.join() - test_support.threading_cleanup(*self._threads) - # restore sys.stdout - sys.stdout = self.old_stdout - - def testBasic(self): - # connect - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=3) - smtp.quit() - - def testNOOP(self): - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=3) - expected = (250, 'Ok') - self.assertEqual(smtp.noop(), expected) - smtp.quit() - - def testRSET(self): - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=3) - expected = (250, 'Ok') - self.assertEqual(smtp.rset(), expected) - smtp.quit() - - def testNotImplemented(self): - # EHLO isn't implemented in DebuggingServer - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=3) - expected = (502, 'Error: command "EHLO" not implemented') - self.assertEqual(smtp.ehlo(), expected) - smtp.quit() - - def testVRFY(self): - # VRFY isn't implemented in DebuggingServer - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=3) - expected = (502, 'Error: command "VRFY" not implemented') - self.assertEqual(smtp.vrfy('nobody@nowhere.com'), expected) - self.assertEqual(smtp.verify('nobody@nowhere.com'), expected) - smtp.quit() - - def testSecondHELO(self): - # check that a second HELO returns a message that it's a duplicate - # (this behavior is specific to smtpd.SMTPChannel) - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=3) - smtp.helo() - expected = (503, 'Duplicate HELO/EHLO') - self.assertEqual(smtp.helo(), expected) - smtp.quit() - - def testHELP(self): - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=3) - self.assertEqual(smtp.help(), 'Error: command "HELP" not implemented') - smtp.quit() - - def testSend(self): - # connect and send mail - m = 'A test message' - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=3) - smtp.sendmail('John', 'Sally', m) - # XXX(nnorwitz): this test is flaky and dies with a bad file descriptor - # in asyncore. This sleep might help, but should really be fixed - # properly by using an Event variable. - time.sleep(0.01) - smtp.quit() - - self.client_evt.set() - self.serv_evt.wait() - self.output.flush() - mexpect = '%s%s\n%s' % (MSG_BEGIN, m, MSG_END) - self.assertEqual(self.output.getvalue(), mexpect) - - -class NonConnectingTests(unittest.TestCase): - - def testNotConnected(self): - # Test various operations on an unconnected SMTP object that - # should raise exceptions (at present the attempt in SMTP.send - # to reference the nonexistent 'sock' attribute of the SMTP object - # causes an AttributeError) - smtp = smtplib.SMTP() - self.assertRaises(smtplib.SMTPServerDisconnected, smtp.ehlo) - self.assertRaises(smtplib.SMTPServerDisconnected, - smtp.send, 'test msg') - - def testNonnumericPort(self): - # check that non-numeric port raises socket.error - self.assertRaises(socket.error, smtplib.SMTP, - "localhost", "bogus") - self.assertRaises(socket.error, smtplib.SMTP, - "localhost:bogus") - - -# test response of client to a non-successful HELO message -@unittest.skipUnless(threading, 'Threading required for this test.') -class BadHELOServerTests(unittest.TestCase): - - def setUp(self): - self.old_stdout = sys.stdout - self.output = StringIO.StringIO() - sys.stdout = self.output - - self._threads = test_support.threading_setup() - self.evt = threading.Event() - self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM) - self.sock.settimeout(15) - self.port = test_support.bind_port(self.sock) - servargs = (self.evt, "199 no hello for you!\n", self.sock) - self.thread = threading.Thread(target=server, args=servargs) - self.thread.start() - self.evt.wait() - self.evt.clear() - - def tearDown(self): - self.evt.wait() - self.thread.join() - test_support.threading_cleanup(*self._threads) - sys.stdout = self.old_stdout - - def testFailingHELO(self): - self.assertRaises(smtplib.SMTPConnectError, smtplib.SMTP, - HOST, self.port, 'localhost', 3) - - -sim_users = {'Mr.A@somewhere.com':'John A', - 'Ms.B@somewhere.com':'Sally B', - 'Mrs.C@somewhereesle.com':'Ruth C', - } - -sim_auth = ('Mr.A@somewhere.com', 'somepassword') -sim_cram_md5_challenge = ('PENCeUxFREJoU0NnbmhNWitOMjNGNn' - 'dAZWx3b29kLmlubm9zb2Z0LmNvbT4=') -sim_auth_credentials = { - 'login': 'TXIuQUBzb21ld2hlcmUuY29t', - 'plain': 'AE1yLkFAc29tZXdoZXJlLmNvbQBzb21lcGFzc3dvcmQ=', - 'cram-md5': ('TXIUQUBZB21LD2HLCMUUY29TIDG4OWQ0MJ' - 'KWZGQ4ODNMNDA4NTGXMDRLZWMYZJDMODG1'), - } -sim_auth_login_password = 'C29TZXBHC3N3B3JK' - -sim_lists = {'list-1':['Mr.A@somewhere.com','Mrs.C@somewhereesle.com'], - 'list-2':['Ms.B@somewhere.com',], - } - -# Simulated SMTP channel & server -class SimSMTPChannel(smtpd.SMTPChannel): - - def __init__(self, extra_features, *args, **kw): - self._extrafeatures = ''.join( - [ "250-{0}\r\n".format(x) for x in extra_features ]) - smtpd.SMTPChannel.__init__(self, *args, **kw) - - def smtp_EHLO(self, arg): - resp = ('250-testhost\r\n' - '250-EXPN\r\n' - '250-SIZE 20000000\r\n' - '250-STARTTLS\r\n' - '250-DELIVERBY\r\n') - resp = resp + self._extrafeatures + '250 HELP' - self.push(resp) - - def smtp_VRFY(self, arg): - # For max compatibility smtplib should be sending the raw address. - if arg in sim_users: - self.push('250 %s %s' % (sim_users[arg], smtplib.quoteaddr(arg))) - else: - self.push('550 No such user: %s' % arg) - - def smtp_EXPN(self, arg): - list_name = arg.lower() - if list_name in sim_lists: - user_list = sim_lists[list_name] - for n, user_email in enumerate(user_list): - quoted_addr = smtplib.quoteaddr(user_email) - if n < len(user_list) - 1: - self.push('250-%s %s' % (sim_users[user_email], quoted_addr)) - else: - self.push('250 %s %s' % (sim_users[user_email], quoted_addr)) - else: - self.push('550 No access for you!') - - def smtp_AUTH(self, arg): - if arg.strip().lower()=='cram-md5': - self.push('334 {0}'.format(sim_cram_md5_challenge)) - return - mech, auth = arg.split() - mech = mech.lower() - if mech not in sim_auth_credentials: - self.push('504 auth type unimplemented') - return - if mech == 'plain' and auth==sim_auth_credentials['plain']: - self.push('235 plain auth ok') - elif mech=='login' and auth==sim_auth_credentials['login']: - self.push('334 Password:') - else: - self.push('550 No access for you!') - - def handle_error(self): - raise - - -class SimSMTPServer(smtpd.SMTPServer): - - def __init__(self, *args, **kw): - self._extra_features = [] - smtpd.SMTPServer.__init__(self, *args, **kw) - - def handle_accept(self): - conn, addr = self.accept() - self._SMTPchannel = SimSMTPChannel(self._extra_features, - self, conn, addr) - - def process_message(self, peer, mailfrom, rcpttos, data): - pass - - def add_feature(self, feature): - self._extra_features.append(feature) - - def handle_error(self): - raise - - -# Test various SMTP & ESMTP commands/behaviors that require a simulated server -# (i.e., something with more features than DebuggingServer) -@unittest.skipUnless(threading, 'Threading required for this test.') -class SMTPSimTests(unittest.TestCase): - - def setUp(self): - self._threads = test_support.threading_setup() - self.serv_evt = threading.Event() - self.client_evt = threading.Event() - # Pick a random unused port by passing 0 for the port number - self.serv = SimSMTPServer((HOST, 0), ('nowhere', -1)) - # Keep a note of what port was assigned - self.port = self.serv.socket.getsockname()[1] - serv_args = (self.serv, self.serv_evt, self.client_evt) - self.thread = threading.Thread(target=debugging_server, args=serv_args) - self.thread.start() - - # wait until server thread has assigned a port number - self.serv_evt.wait() - self.serv_evt.clear() - - def tearDown(self): - # indicate that the client is finished - self.client_evt.set() - # wait for the server thread to terminate - self.serv_evt.wait() - self.thread.join() - test_support.threading_cleanup(*self._threads) - - def testBasic(self): - # smoke test - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=15) - smtp.quit() - - def testEHLO(self): - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=15) - - # no features should be present before the EHLO - self.assertEqual(smtp.esmtp_features, {}) - - # features expected from the test server - expected_features = {'expn':'', - 'size': '20000000', - 'starttls': '', - 'deliverby': '', - 'help': '', - } - - smtp.ehlo() - self.assertEqual(smtp.esmtp_features, expected_features) - for k in expected_features: - self.assertTrue(smtp.has_extn(k)) - self.assertFalse(smtp.has_extn('unsupported-feature')) - smtp.quit() - - def testVRFY(self): - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=15) - - for email, name in sim_users.items(): - expected_known = (250, '%s %s' % (name, smtplib.quoteaddr(email))) - self.assertEqual(smtp.vrfy(email), expected_known) - - u = 'nobody@nowhere.com' - expected_unknown = (550, 'No such user: %s' % u) - self.assertEqual(smtp.vrfy(u), expected_unknown) - smtp.quit() - - def testEXPN(self): - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=15) - - for listname, members in sim_lists.items(): - users = [] - for m in members: - users.append('%s %s' % (sim_users[m], smtplib.quoteaddr(m))) - expected_known = (250, '\n'.join(users)) - self.assertEqual(smtp.expn(listname), expected_known) - - u = 'PSU-Members-List' - expected_unknown = (550, 'No access for you!') - self.assertEqual(smtp.expn(u), expected_unknown) - smtp.quit() - - def testAUTH_PLAIN(self): - self.serv.add_feature("AUTH PLAIN") - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=15) - - expected_auth_ok = (235, b'plain auth ok') - self.assertEqual(smtp.login(sim_auth[0], sim_auth[1]), expected_auth_ok) - - # SimSMTPChannel doesn't fully support LOGIN or CRAM-MD5 auth because they - # require a synchronous read to obtain the credentials...so instead smtpd - # sees the credential sent by smtplib's login method as an unknown command, - # which results in smtplib raising an auth error. Fortunately the error - # message contains the encoded credential, so we can partially check that it - # was generated correctly (partially, because the 'word' is uppercased in - # the error message). - - def testAUTH_LOGIN(self): - self.serv.add_feature("AUTH LOGIN") - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=15) - try: smtp.login(sim_auth[0], sim_auth[1]) - except smtplib.SMTPAuthenticationError as err: - if sim_auth_login_password not in str(err): - raise "expected encoded password not found in error message" - - def testAUTH_CRAM_MD5(self): - self.serv.add_feature("AUTH CRAM-MD5") - smtp = smtplib.SMTP(HOST, self.port, local_hostname='localhost', timeout=15) - - try: smtp.login(sim_auth[0], sim_auth[1]) - except smtplib.SMTPAuthenticationError as err: - if sim_auth_credentials['cram-md5'] not in str(err): - raise "expected encoded credentials not found in error message" - - #TODO: add tests for correct AUTH method fallback now that the - #test infrastructure can support it. - - -def test_main(verbose=None): - test_support.run_unittest(GeneralTests, DebuggingServerTests, - NonConnectingTests, - BadHELOServerTests, SMTPSimTests) - -if __name__ == '__main__': - test_main() |