blob: e10e327a82eec5aa47d68cd5446835a2eded5502 [file] [log] [blame]
Barry Warsaw4c4bec81998-12-22 03:02:20 +00001#! /usr/bin/env python
2
Barry Warsawa1ae8842000-07-09 21:24:31 +00003'''SMTP/ESMTP client class.
Guido van Rossumbbe323e1998-01-29 17:24:40 +00004
Guido van Rossumf7fcf5e2001-09-14 16:08:44 +00005This should follow RFC 821 (SMTP), RFC 1869 (ESMTP), RFC 2554 (SMTP
6Authentication) and RFC 2487 (Secure SMTP over TLS).
Guido van Rossumbbe323e1998-01-29 17:24:40 +00007
Guido van Rossumfcfb6321998-08-04 15:29:54 +00008Notes:
9
10Please remember, when doing ESMTP, that the names of the SMTP service
Barry Warsaw4c4bec81998-12-22 03:02:20 +000011extensions are NOT the same thing as the option keywords for the RCPT
Guido van Rossumfcfb6321998-08-04 15:29:54 +000012and MAIL commands!
13
Guido van Rossumbbe323e1998-01-29 17:24:40 +000014Example:
15
Barry Warsawa7d9bdf1998-12-22 03:24:27 +000016 >>> import smtplib
17 >>> s=smtplib.SMTP("localhost")
Guido van Rossum7131f842007-02-09 20:13:25 +000018 >>> print(s.help())
Barry Warsawa7d9bdf1998-12-22 03:24:27 +000019 This is Sendmail version 8.8.4
20 Topics:
21 HELO EHLO MAIL RCPT DATA
22 RSET NOOP QUIT HELP VRFY
23 EXPN VERB ETRN DSN
24 For more info use "HELP <topic>".
25 To report bugs in the implementation send email to
26 sendmail-bugs@sendmail.org.
27 For local information send email to Postmaster at your site.
28 End of HELP info
29 >>> s.putcmd("vrfy","someone@here")
30 >>> s.getreply()
31 (250, "Somebody OverHere <somebody@here.my.org>")
32 >>> s.quit()
Barry Warsawa1ae8842000-07-09 21:24:31 +000033'''
Guido van Rossumbbe323e1998-01-29 17:24:40 +000034
Guido van Rossum98d9fd32000-02-28 15:12:25 +000035# Author: The Dragon De Monsyne <dragondm@integral.org>
36# ESMTP support, test code and doc fixes added by
37# Eric S. Raymond <esr@thyrsus.com>
38# Better RFC 821 compliance (MAIL and RCPT, and CRLF in data)
39# by Carey Evans <c.evans@clear.net.nz>, for picky mail servers.
Guido van Rossumae010462001-09-11 15:57:46 +000040# RFC 2554 (authentication) support by Gerhard Haering <gerhard@bigfoot.de>.
Tim Peters495ad3c2001-01-15 01:36:40 +000041#
Guido van Rossum98d9fd32000-02-28 15:12:25 +000042# This was modified from the Python 1.5 library HTTP lib.
43
Guido van Rossumbbe323e1998-01-29 17:24:40 +000044import socket
Barry Warsaw07201771998-12-22 20:37:36 +000045import re
Thomas Woutersb2137042007-02-01 18:02:27 +000046import email.utils
Guido van Rossumae010462001-09-11 15:57:46 +000047import base64
48import hmac
Barry Warsaw2cc1f6d2007-08-30 14:28:55 +000049from email.base64mime import body_encode as encode_base64
Brett Cannone6f8a892004-07-10 23:14:30 +000050from sys import stderr
Guido van Rossumbbe323e1998-01-29 17:24:40 +000051
Skip Montanaro0de65802001-02-15 22:15:14 +000052__all__ = ["SMTPException","SMTPServerDisconnected","SMTPResponseException",
53 "SMTPSenderRefused","SMTPRecipientsRefused","SMTPDataError",
Guido van Rossumae010462001-09-11 15:57:46 +000054 "SMTPConnectError","SMTPHeloError","SMTPAuthenticationError",
Thomas Wouters47b49bf2007-08-30 22:15:33 +000055 "quoteaddr","quotedata","SMTP"]
Skip Montanaro0de65802001-02-15 22:15:14 +000056
Guido van Rossumbbe323e1998-01-29 17:24:40 +000057SMTP_PORT = 25
Thomas Wouters89f507f2006-12-13 04:49:30 +000058SMTP_SSL_PORT = 465
Guido van Rossumbbe323e1998-01-29 17:24:40 +000059CRLF="\r\n"
60
Piers Lauder385a77a2002-07-27 00:38:30 +000061OLDSTYLE_AUTH = re.compile(r"auth=(.*)", re.I)
62
Tim Peters495ad3c2001-01-15 01:36:40 +000063# Exception classes used by this module.
Guido van Rossum296e1431999-04-07 15:03:39 +000064class SMTPException(Exception):
65 """Base class for all exceptions raised by this module."""
66
67class SMTPServerDisconnected(SMTPException):
68 """Not connected to any SMTP server.
69
70 This exception is raised when the server unexpectedly disconnects,
71 or when an attempt is made to use the SMTP instance before
72 connecting it to a server.
73 """
74
75class SMTPResponseException(SMTPException):
76 """Base class for all exceptions that include an SMTP error code.
77
78 These exceptions are generated in some instances when the SMTP
79 server returns an error code. The error code is stored in the
80 `smtp_code' attribute of the error, and the `smtp_error' attribute
81 is set to the error message.
82 """
83
84 def __init__(self, code, msg):
85 self.smtp_code = code
86 self.smtp_error = msg
87 self.args = (code, msg)
88
89class SMTPSenderRefused(SMTPResponseException):
90 """Sender address refused.
Guido van Rossumae010462001-09-11 15:57:46 +000091
Guido van Rossum296e1431999-04-07 15:03:39 +000092 In addition to the attributes set by on all SMTPResponseException
Barry Warsawd25c1b71999-11-28 17:11:06 +000093 exceptions, this sets `sender' to the string that the SMTP refused.
Guido van Rossum296e1431999-04-07 15:03:39 +000094 """
95
96 def __init__(self, code, msg, sender):
97 self.smtp_code = code
98 self.smtp_error = msg
99 self.sender = sender
100 self.args = (code, msg, sender)
101
Guido van Rossum20c92281999-04-21 16:52:20 +0000102class SMTPRecipientsRefused(SMTPException):
Barry Warsawd25c1b71999-11-28 17:11:06 +0000103 """All recipient addresses refused.
Guido van Rossumae010462001-09-11 15:57:46 +0000104
Thomas Wouters7e474022000-07-16 12:04:32 +0000105 The errors for each recipient are accessible through the attribute
Tim Peters495ad3c2001-01-15 01:36:40 +0000106 'recipients', which is a dictionary of exactly the same sort as
107 SMTP.sendmail() returns.
Guido van Rossum296e1431999-04-07 15:03:39 +0000108 """
109
110 def __init__(self, recipients):
111 self.recipients = recipients
112 self.args = ( recipients,)
113
114
Guido van Rossum296e1431999-04-07 15:03:39 +0000115class SMTPDataError(SMTPResponseException):
116 """The SMTP server didn't accept the data."""
117
118class SMTPConnectError(SMTPResponseException):
Barry Warsawd25c1b71999-11-28 17:11:06 +0000119 """Error during connection establishment."""
Guido van Rossum296e1431999-04-07 15:03:39 +0000120
121class SMTPHeloError(SMTPResponseException):
Barry Warsawd25c1b71999-11-28 17:11:06 +0000122 """The server refused our HELO reply."""
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000123
Guido van Rossumae010462001-09-11 15:57:46 +0000124class SMTPAuthenticationError(SMTPResponseException):
125 """Authentication error.
126
127 Most probably the server didn't accept the username/password
128 combination provided.
129 """
Peter Schneider-Kamp7bc82bb2000-08-10 14:02:23 +0000130
Guido van Rossum69a79bc1998-07-13 15:18:49 +0000131def quoteaddr(addr):
132 """Quote a subset of the email addresses defined by RFC 821.
133
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000134 Should be able to handle anything rfc822.parseaddr can handle.
135 """
Raymond Hettinger342456d2002-09-05 01:14:07 +0000136 m = (None, None)
Guido van Rossum69a79bc1998-07-13 15:18:49 +0000137 try:
Thomas Woutersb2137042007-02-01 18:02:27 +0000138 m = email.utils.parseaddr(addr)[1]
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000139 except AttributeError:
140 pass
Raymond Hettinger342456d2002-09-05 01:14:07 +0000141 if m == (None, None): # Indicates parse failure or AttributeError
Georg Brandlbd3bc4d2006-02-17 09:52:53 +0000142 # something weird here.. punt -ddm
Raymond Hettinger342456d2002-09-05 01:14:07 +0000143 return "<%s>" % addr
Georg Brandlbd3bc4d2006-02-17 09:52:53 +0000144 elif m is None:
145 # the sender wants an empty return address
146 return "<>"
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000147 else:
148 return "<%s>" % m
Guido van Rossum69a79bc1998-07-13 15:18:49 +0000149
150def quotedata(data):
151 """Quote data for email.
152
Barry Warsawd25c1b71999-11-28 17:11:06 +0000153 Double leading '.', and change Unix newline '\\n', or Mac '\\r' into
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000154 Internet CRLF end-of-line.
155 """
Guido van Rossum69a79bc1998-07-13 15:18:49 +0000156 return re.sub(r'(?m)^\.', '..',
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000157 re.sub(r'(?:\r\n|\n|\r(?!\n))', CRLF, data))
Guido van Rossum69a79bc1998-07-13 15:18:49 +0000158
Thomas Wouters47b49bf2007-08-30 22:15:33 +0000159try:
160 import ssl
161except ImportError:
162 _have_ssl = False
163else:
Thomas Wouters47b49bf2007-08-30 22:15:33 +0000164 class SSLFakeFile:
165 """A fake file like object that really wraps a SSLObject.
166
167 It only supports what is needed in smtplib.
168 """
169 def __init__(self, sslobj):
170 self.sslobj = sslobj
171
172 def readline(self):
173 str = b""
174 chr = None
175 while chr != b"\n":
176 chr = self.sslobj.read(1)
177 str += chr
178 return str
179
180 def close(self):
181 pass
182
183 _have_ssl = True
184
Peter Schneider-Kamp7bc82bb2000-08-10 14:02:23 +0000185
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000186class SMTP:
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000187 """This class manages a connection to an SMTP or ESMTP server.
188 SMTP Objects:
Tim Peters495ad3c2001-01-15 01:36:40 +0000189 SMTP objects have the following attributes:
190 helo_resp
191 This is the message given by the server in response to the
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000192 most recent HELO command.
Tim Peters495ad3c2001-01-15 01:36:40 +0000193
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000194 ehlo_resp
Tim Peters495ad3c2001-01-15 01:36:40 +0000195 This is the message given by the server in response to the
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000196 most recent EHLO command. This is usually multiline.
197
Tim Peters495ad3c2001-01-15 01:36:40 +0000198 does_esmtp
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000199 This is a True value _after you do an EHLO command_, if the
200 server supports ESMTP.
201
Tim Peters495ad3c2001-01-15 01:36:40 +0000202 esmtp_features
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000203 This is a dictionary, which, if the server supports ESMTP,
Barry Warsawd25c1b71999-11-28 17:11:06 +0000204 will _after you do an EHLO command_, contain the names of the
205 SMTP service extensions this server supports, and their
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000206 parameters (if any).
Barry Warsawd25c1b71999-11-28 17:11:06 +0000207
Tim Peters495ad3c2001-01-15 01:36:40 +0000208 Note, all extension names are mapped to lower case in the
209 dictionary.
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000210
Barry Warsawd25c1b71999-11-28 17:11:06 +0000211 See each method's docstrings for details. In general, there is a
212 method of the same name to perform each SMTP command. There is also a
213 method called 'sendmail' that will do an entire mail transaction.
214 """
Guido van Rossum95e6f701998-06-25 02:15:50 +0000215 debuglevel = 0
216 file = None
217 helo_resp = None
Guido van Rossumd8faa362007-04-27 19:54:29 +0000218 ehlo_msg = "ehlo"
Guido van Rossum95e6f701998-06-25 02:15:50 +0000219 ehlo_resp = None
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000220 does_esmtp = 0
Guido van Rossum95e6f701998-06-25 02:15:50 +0000221
Guido van Rossumd8faa362007-04-27 19:54:29 +0000222 def __init__(self, host='', port=0, local_hostname=None, timeout=None):
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000223 """Initialize a new instance.
224
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000225 If specified, `host' is the name of the remote host to which to
226 connect. If specified, `port' specifies the port to which to connect.
Barry Warsawd25c1b71999-11-28 17:11:06 +0000227 By default, smtplib.SMTP_PORT is used. An SMTPConnectError is raised
Neil Schemenauer6730f262002-03-24 15:30:40 +0000228 if the specified `host' doesn't respond correctly. If specified,
Tim Peters863ac442002-04-16 01:38:40 +0000229 `local_hostname` is used as the FQDN of the local host. By default,
230 the local hostname is found using socket.getfqdn().
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000231
232 """
Guido van Rossumd8faa362007-04-27 19:54:29 +0000233 self.timeout = timeout
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000234 self.esmtp_features = {}
Thomas Wouters89f507f2006-12-13 04:49:30 +0000235 self.default_port = SMTP_PORT
Guido van Rossum296e1431999-04-07 15:03:39 +0000236 if host:
237 (code, msg) = self.connect(host, port)
238 if code != 220:
239 raise SMTPConnectError(code, msg)
Raymond Hettingerf13eb552002-06-02 00:40:05 +0000240 if local_hostname is not None:
Barry Warsaw13e34f72002-03-26 20:27:35 +0000241 self.local_hostname = local_hostname
Neil Schemenauer6730f262002-03-24 15:30:40 +0000242 else:
Barry Warsaw13e34f72002-03-26 20:27:35 +0000243 # RFC 2821 says we should use the fqdn in the EHLO/HELO verb, and
244 # if that can't be calculated, that we should use a domain literal
245 # instead (essentially an encoded IP address like [A.B.C.D]).
246 fqdn = socket.getfqdn()
247 if '.' in fqdn:
248 self.local_hostname = fqdn
249 else:
250 # We can't find an fqdn hostname, so use a domain literal
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000251 addr = '127.0.0.1'
252 try:
253 addr = socket.gethostbyname(socket.gethostname())
254 except socket.gaierror:
255 pass
Barry Warsaw13e34f72002-03-26 20:27:35 +0000256 self.local_hostname = '[%s]' % addr
Tim Peters495ad3c2001-01-15 01:36:40 +0000257
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000258 def set_debuglevel(self, debuglevel):
259 """Set the debug output level.
260
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000261 A non-false value results in debug messages for connection and for all
262 messages sent to and received from the server.
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000263
264 """
265 self.debuglevel = debuglevel
266
Guido van Rossumd8faa362007-04-27 19:54:29 +0000267 def _get_socket(self, port, host, timeout):
Thomas Wouters89f507f2006-12-13 04:49:30 +0000268 # This makes it simpler for SMTP_SSL to use the SMTP connect code
269 # and just alter the socket connection bit.
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000270 if self.debuglevel > 0: print('connect:', (host, port), file=stderr)
Guido van Rossumd8faa362007-04-27 19:54:29 +0000271 return socket.create_connection((port, host), timeout)
Thomas Wouters89f507f2006-12-13 04:49:30 +0000272
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000273 def connect(self, host='localhost', port = 0):
274 """Connect to a host on a given port.
Guido van Rossum95e6f701998-06-25 02:15:50 +0000275
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000276 If the hostname ends with a colon (`:') followed by a number, and
277 there is no port specified, that suffix will be stripped off and the
278 number interpreted as the port number to use.
Guido van Rossum95e6f701998-06-25 02:15:50 +0000279
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000280 Note: This method is automatically invoked by __init__, if a host is
281 specified during instantiation.
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000282
283 """
Martin v. Löwis4eb59402001-07-26 13:37:33 +0000284 if not port and (host.find(':') == host.rfind(':')):
Martin v. Löwisa43c2f82001-07-24 20:34:08 +0000285 i = host.rfind(':')
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000286 if i >= 0:
287 host, port = host[:i], host[i+1:]
Eric S. Raymondc013f302001-02-09 05:40:38 +0000288 try: port = int(port)
Eric S. Raymond8d876032001-02-09 10:14:53 +0000289 except ValueError:
Guido van Rossumd8faa362007-04-27 19:54:29 +0000290 raise socket.error("nonnumeric port")
Thomas Wouters89f507f2006-12-13 04:49:30 +0000291 if not port: port = self.default_port
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000292 if self.debuglevel > 0: print('connect:', (host, port), file=stderr)
Guido van Rossumd8faa362007-04-27 19:54:29 +0000293 self.sock = self._get_socket(host, port, self.timeout)
Martin v. Löwisa43c2f82001-07-24 20:34:08 +0000294 (code, msg) = self.getreply()
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000295 if self.debuglevel > 0: print("connect:", msg, file=stderr)
Martin v. Löwisa43c2f82001-07-24 20:34:08 +0000296 return (code, msg)
Tim Peters495ad3c2001-01-15 01:36:40 +0000297
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000298 def send(self, str):
299 """Send `str' to the server."""
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000300 if self.debuglevel > 0: print('send:', repr(str), file=stderr)
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000301 if self.sock:
Guido van Rossum2880f6e1998-08-10 20:07:00 +0000302 try:
Martin v. Löwise12454f2002-02-16 23:06:19 +0000303 self.sock.sendall(str)
Guido van Rossum2880f6e1998-08-10 20:07:00 +0000304 except socket.error:
Barry Warsaw76750972001-12-14 20:34:20 +0000305 self.close()
Guido van Rossum40233ea1999-01-15 03:23:55 +0000306 raise SMTPServerDisconnected('Server not connected')
Guido van Rossumfc40a831998-01-29 17:26:45 +0000307 else:
Guido van Rossum40233ea1999-01-15 03:23:55 +0000308 raise SMTPServerDisconnected('please run connect() first')
Tim Peters495ad3c2001-01-15 01:36:40 +0000309
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000310 def putcmd(self, cmd, args=""):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000311 """Send a command to the server."""
Guido van Rossumdb23d3d1999-06-09 15:13:10 +0000312 if args == "":
313 str = '%s%s' % (cmd, CRLF)
314 else:
315 str = '%s %s%s' % (cmd, args, CRLF)
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000316 self.send(str)
Tim Peters495ad3c2001-01-15 01:36:40 +0000317
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000318 def getreply(self):
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000319 """Get a reply from the server.
Tim Peters495ad3c2001-01-15 01:36:40 +0000320
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000321 Returns a tuple consisting of:
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000322
323 - server response code (e.g. '250', or such, if all goes well)
324 Note: returns -1 if it can't read response code.
325
326 - server response string corresponding to response code (multiline
327 responses are converted to a single, multiline string).
Guido van Rossumf123f841999-03-29 20:33:21 +0000328
329 Raises SMTPServerDisconnected if end-of-file is reached.
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000330 """
331 resp=[]
Guido van Rossum296e1431999-04-07 15:03:39 +0000332 if self.file is None:
333 self.file = self.sock.makefile('rb')
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000334 while 1:
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000335 line = self.file.readline()
Guido van Rossum806c2462007-08-06 23:33:07 +0000336 if not line:
Guido van Rossum296e1431999-04-07 15:03:39 +0000337 self.close()
338 raise SMTPServerDisconnected("Connection unexpectedly closed")
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000339 if self.debuglevel > 0: print('reply:', repr(line), file=stderr)
Guido van Rossum806c2462007-08-06 23:33:07 +0000340 resp.append(line[4:].strip(b' \t\r\n'))
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000341 code=line[:3]
Guido van Rossum296e1431999-04-07 15:03:39 +0000342 # Check that the error code is syntactically correct.
343 # Don't attempt to read a continuation line if it is broken.
344 try:
Eric S. Raymondc013f302001-02-09 05:40:38 +0000345 errcode = int(code)
Guido van Rossum296e1431999-04-07 15:03:39 +0000346 except ValueError:
347 errcode = -1
348 break
Guido van Rossumf123f841999-03-29 20:33:21 +0000349 # Check if multiline response.
Guido van Rossum806c2462007-08-06 23:33:07 +0000350 if line[3:4] != b"-":
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000351 break
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000352
Guido van Rossumc43e79f2007-06-18 18:26:36 +0000353 errmsg = b"\n".join(resp)
Tim Peters495ad3c2001-01-15 01:36:40 +0000354 if self.debuglevel > 0:
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000355 print('reply: retcode (%s); Msg: %s' % (errcode,errmsg), file=stderr)
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000356 return errcode, errmsg
Tim Peters495ad3c2001-01-15 01:36:40 +0000357
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000358 def docmd(self, cmd, args=""):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000359 """Send a command, and return its response code."""
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000360 self.putcmd(cmd,args)
Guido van Rossum296e1431999-04-07 15:03:39 +0000361 return self.getreply()
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000362
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000363 # std smtp commands
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000364 def helo(self, name=''):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000365 """SMTP 'helo' command.
366 Hostname to send for this command defaults to the FQDN of the local
367 host.
368 """
Neil Schemenauer6730f262002-03-24 15:30:40 +0000369 self.putcmd("helo", name or self.local_hostname)
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000370 (code,msg)=self.getreply()
371 self.helo_resp=msg
Guido van Rossum296e1431999-04-07 15:03:39 +0000372 return (code,msg)
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000373
Guido van Rossum95e6f701998-06-25 02:15:50 +0000374 def ehlo(self, name=''):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000375 """ SMTP 'ehlo' command.
376 Hostname to send for this command defaults to the FQDN of the local
377 host.
378 """
Guido van Rossumf7fcf5e2001-09-14 16:08:44 +0000379 self.esmtp_features = {}
Guido van Rossumd8faa362007-04-27 19:54:29 +0000380 self.putcmd(self.ehlo_msg, name or self.local_hostname)
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000381 (code,msg)=self.getreply()
Tim Peters495ad3c2001-01-15 01:36:40 +0000382 # According to RFC1869 some (badly written)
383 # MTA's will disconnect on an ehlo. Toss an exception if
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000384 # that happens -ddm
385 if code == -1 and len(msg) == 0:
Barry Warsaw76750972001-12-14 20:34:20 +0000386 self.close()
Guido van Rossum40233ea1999-01-15 03:23:55 +0000387 raise SMTPServerDisconnected("Server not connected")
Guido van Rossum95e6f701998-06-25 02:15:50 +0000388 self.ehlo_resp=msg
Fred Drake8152d322000-12-12 23:20:45 +0000389 if code != 250:
Guido van Rossum296e1431999-04-07 15:03:39 +0000390 return (code,msg)
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000391 self.does_esmtp=1
Thomas Wouters7e474022000-07-16 12:04:32 +0000392 #parse the ehlo response -ddm
Guido van Rossum04110fb2007-08-24 16:32:05 +0000393 assert isinstance(self.ehlo_resp, bytes), repr(self.ehlo_resp)
394 resp=self.ehlo_resp.decode("latin-1").split('\n')
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000395 del resp[0]
Guido van Rossum2880f6e1998-08-10 20:07:00 +0000396 for each in resp:
Piers Lauder385a77a2002-07-27 00:38:30 +0000397 # To be able to communicate with as many SMTP servers as possible,
398 # we have to take the old-style auth advertisement into account,
399 # because:
400 # 1) Else our SMTP feature parser gets confused.
401 # 2) There are some servers that only advertise the auth methods we
402 # support using the old style.
403 auth_match = OLDSTYLE_AUTH.match(each)
404 if auth_match:
405 # This doesn't remove duplicates, but that's no problem
406 self.esmtp_features["auth"] = self.esmtp_features.get("auth", "") \
407 + " " + auth_match.groups(0)[0]
408 continue
409
Barry Warsawbe22ae62002-04-15 20:03:30 +0000410 # RFC 1869 requires a space between ehlo keyword and parameters.
411 # It's actually stricter, in that only spaces are allowed between
412 # parameters, but were not going to check for that here. Note
413 # that the space isn't present if there are no parameters.
414 m=re.match(r'(?P<feature>[A-Za-z0-9][A-Za-z0-9\-]*) ?',each)
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000415 if m:
Eric S. Raymondc013f302001-02-09 05:40:38 +0000416 feature=m.group("feature").lower()
417 params=m.string[m.end("feature"):].strip()
Piers Lauder385a77a2002-07-27 00:38:30 +0000418 if feature == "auth":
419 self.esmtp_features[feature] = self.esmtp_features.get(feature, "") \
420 + " " + params
421 else:
422 self.esmtp_features[feature]=params
Guido van Rossum296e1431999-04-07 15:03:39 +0000423 return (code,msg)
Guido van Rossum95e6f701998-06-25 02:15:50 +0000424
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000425 def has_extn(self, opt):
426 """Does the server support a given SMTP service extension?"""
Raymond Hettinger54f02222002-06-01 14:18:47 +0000427 return opt.lower() in self.esmtp_features
Guido van Rossum95e6f701998-06-25 02:15:50 +0000428
Guido van Rossum18586f41998-04-03 17:03:13 +0000429 def help(self, args=''):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000430 """SMTP 'help' command.
431 Returns help text from server."""
Guido van Rossum18586f41998-04-03 17:03:13 +0000432 self.putcmd("help", args)
Kurt B. Kaiser58bd1902005-06-26 18:27:36 +0000433 return self.getreply()[1]
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000434
435 def rset(self):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000436 """SMTP 'rset' command -- resets session."""
Guido van Rossum296e1431999-04-07 15:03:39 +0000437 return self.docmd("rset")
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000438
439 def noop(self):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000440 """SMTP 'noop' command -- doesn't do anything :>"""
Guido van Rossum296e1431999-04-07 15:03:39 +0000441 return self.docmd("noop")
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000442
Guido van Rossum95e6f701998-06-25 02:15:50 +0000443 def mail(self,sender,options=[]):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000444 """SMTP 'mail' command -- begins mail xfer session."""
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000445 optionlist = ''
446 if options and self.does_esmtp:
Eric S. Raymondc013f302001-02-09 05:40:38 +0000447 optionlist = ' ' + ' '.join(options)
Guido van Rossumdb23d3d1999-06-09 15:13:10 +0000448 self.putcmd("mail", "FROM:%s%s" % (quoteaddr(sender) ,optionlist))
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000449 return self.getreply()
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000450
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000451 def rcpt(self,recip,options=[]):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000452 """SMTP 'rcpt' command -- indicates 1 recipient for this mail."""
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000453 optionlist = ''
454 if options and self.does_esmtp:
Eric S. Raymondc013f302001-02-09 05:40:38 +0000455 optionlist = ' ' + ' '.join(options)
Guido van Rossum348fd061999-01-14 04:18:46 +0000456 self.putcmd("rcpt","TO:%s%s" % (quoteaddr(recip),optionlist))
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000457 return self.getreply()
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000458
459 def data(self,msg):
Tim Peters495ad3c2001-01-15 01:36:40 +0000460 """SMTP 'DATA' command -- sends message data to server.
Guido van Rossum296e1431999-04-07 15:03:39 +0000461
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000462 Automatically quotes lines beginning with a period per rfc821.
Guido van Rossum296e1431999-04-07 15:03:39 +0000463 Raises SMTPDataError if there is an unexpected reply to the
464 DATA command; the return value from this method is the final
465 response code received when the all data is sent.
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000466 """
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000467 self.putcmd("data")
468 (code,repl)=self.getreply()
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000469 if self.debuglevel >0 : print("data:", (code,repl), file=stderr)
Fred Drake8152d322000-12-12 23:20:45 +0000470 if code != 354:
Guido van Rossum296e1431999-04-07 15:03:39 +0000471 raise SMTPDataError(code,repl)
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000472 else:
Guido van Rossum20c92281999-04-21 16:52:20 +0000473 q = quotedata(msg)
474 if q[-2:] != CRLF:
475 q = q + CRLF
476 q = q + "." + CRLF
477 self.send(q)
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000478 (code,msg)=self.getreply()
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000479 if self.debuglevel >0 : print("data:", (code,msg), file=stderr)
Guido van Rossum296e1431999-04-07 15:03:39 +0000480 return (code,msg)
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000481
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000482 def verify(self, address):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000483 """SMTP 'verify' command -- checks for address validity."""
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000484 self.putcmd("vrfy", quoteaddr(address))
485 return self.getreply()
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000486 # a.k.a.
487 vrfy=verify
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000488
489 def expn(self, address):
Barry Warsawa7d9bdf1998-12-22 03:24:27 +0000490 """SMTP 'verify' command -- checks for address validity."""
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000491 self.putcmd("expn", quoteaddr(address))
492 return self.getreply()
493
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000494 # some useful methods
Guido van Rossumae010462001-09-11 15:57:46 +0000495
496 def login(self, user, password):
497 """Log in on an SMTP server that requires authentication.
498
499 The arguments are:
500 - user: The user name to authenticate with.
501 - password: The password for the authentication.
502
503 If there has been no previous EHLO or HELO command this session, this
504 method tries ESMTP EHLO first.
505
506 This method will return normally if the authentication was successful.
507
508 This method may raise the following exceptions:
509
510 SMTPHeloError The server didn't reply properly to
511 the helo greeting.
512 SMTPAuthenticationError The server didn't accept the username/
513 password combination.
Fred Drake2f8f4d32001-10-13 18:35:32 +0000514 SMTPException No suitable authentication method was
Guido van Rossumae010462001-09-11 15:57:46 +0000515 found.
516 """
517
518 def encode_cram_md5(challenge, user, password):
519 challenge = base64.decodestring(challenge)
520 response = user + " " + hmac.HMAC(password, challenge).hexdigest()
Barry Warsaw2cc1f6d2007-08-30 14:28:55 +0000521 return encode_base64(response)
Guido van Rossumae010462001-09-11 15:57:46 +0000522
523 def encode_plain(user, password):
Barry Warsaw2cc1f6d2007-08-30 14:28:55 +0000524 return encode_base64("\0%s\0%s" % (user, password))
Tim Peters469cdad2002-08-08 20:19:19 +0000525
Guido van Rossumae010462001-09-11 15:57:46 +0000526
527 AUTH_PLAIN = "PLAIN"
528 AUTH_CRAM_MD5 = "CRAM-MD5"
Piers Lauder385a77a2002-07-27 00:38:30 +0000529 AUTH_LOGIN = "LOGIN"
Guido van Rossumae010462001-09-11 15:57:46 +0000530
531 if self.helo_resp is None and self.ehlo_resp is None:
532 if not (200 <= self.ehlo()[0] <= 299):
533 (code, resp) = self.helo()
534 if not (200 <= code <= 299):
535 raise SMTPHeloError(code, resp)
536
537 if not self.has_extn("auth"):
538 raise SMTPException("SMTP AUTH extension not supported by server.")
539
540 # Authentication methods the server supports:
541 authlist = self.esmtp_features["auth"].split()
542
543 # List of authentication methods we support: from preferred to
544 # less preferred methods. Except for the purpose of testing the weaker
545 # ones, we prefer stronger methods like CRAM-MD5:
Piers Lauder385a77a2002-07-27 00:38:30 +0000546 preferred_auths = [AUTH_CRAM_MD5, AUTH_PLAIN, AUTH_LOGIN]
Guido van Rossumae010462001-09-11 15:57:46 +0000547
548 # Determine the authentication method we'll use
549 authmethod = None
550 for method in preferred_auths:
551 if method in authlist:
552 authmethod = method
553 break
Tim Petersb64bec32001-09-18 02:26:39 +0000554
Guido van Rossumae010462001-09-11 15:57:46 +0000555 if authmethod == AUTH_CRAM_MD5:
556 (code, resp) = self.docmd("AUTH", AUTH_CRAM_MD5)
557 if code == 503:
558 # 503 == 'Error: already authenticated'
559 return (code, resp)
560 (code, resp) = self.docmd(encode_cram_md5(resp, user, password))
561 elif authmethod == AUTH_PLAIN:
Tim Petersb64bec32001-09-18 02:26:39 +0000562 (code, resp) = self.docmd("AUTH",
Guido van Rossumae010462001-09-11 15:57:46 +0000563 AUTH_PLAIN + " " + encode_plain(user, password))
Piers Lauder385a77a2002-07-27 00:38:30 +0000564 elif authmethod == AUTH_LOGIN:
565 (code, resp) = self.docmd("AUTH",
Barry Warsaw2cc1f6d2007-08-30 14:28:55 +0000566 "%s %s" % (AUTH_LOGIN, encode_base64(user)))
Piers Lauder385a77a2002-07-27 00:38:30 +0000567 if code != 334:
568 raise SMTPAuthenticationError(code, resp)
Barry Warsaw2cc1f6d2007-08-30 14:28:55 +0000569 (code, resp) = self.docmd(encode_base64(password))
Raymond Hettinger7fdfc2d2002-05-31 17:49:10 +0000570 elif authmethod is None:
Fred Drake2f8f4d32001-10-13 18:35:32 +0000571 raise SMTPException("No suitable authentication method found.")
Raymond Hettingerdbecd932005-02-06 06:57:08 +0000572 if code not in (235, 503):
Guido van Rossumae010462001-09-11 15:57:46 +0000573 # 235 == 'Authentication successful'
574 # 503 == 'Error: already authenticated'
575 raise SMTPAuthenticationError(code, resp)
576 return (code, resp)
577
Guido van Rossumf7fcf5e2001-09-14 16:08:44 +0000578 def starttls(self, keyfile = None, certfile = None):
579 """Puts the connection to the SMTP server into TLS mode.
Tim Petersb64bec32001-09-18 02:26:39 +0000580
Guido van Rossumf7fcf5e2001-09-14 16:08:44 +0000581 If the server supports TLS, this will encrypt the rest of the SMTP
582 session. If you provide the keyfile and certfile parameters,
583 the identity of the SMTP server and client can be checked. This,
584 however, depends on whether the socket module really checks the
585 certificates.
586 """
Tim Petersb64bec32001-09-18 02:26:39 +0000587 (resp, reply) = self.docmd("STARTTLS")
Guido van Rossumf7fcf5e2001-09-14 16:08:44 +0000588 if resp == 220:
Thomas Wouters47b49bf2007-08-30 22:15:33 +0000589 if not _have_ssl:
590 raise RuntimeError("No SSL support included in this Python")
Thomas Wouters1b7f8912007-09-19 03:06:30 +0000591 self.sock = ssl.wrap_socket(self.sock, keyfile, certfile)
Thomas Wouters47b49bf2007-08-30 22:15:33 +0000592 self.file = SSLFakeFile(self.sock)
Guido van Rossumf7fcf5e2001-09-14 16:08:44 +0000593 return (resp, reply)
Tim Petersb64bec32001-09-18 02:26:39 +0000594
Jeremy Hylton31bb8ce1998-08-13 19:57:46 +0000595 def sendmail(self, from_addr, to_addrs, msg, mail_options=[],
Tim Peters495ad3c2001-01-15 01:36:40 +0000596 rcpt_options=[]):
597 """This command performs an entire mail transaction.
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000598
Tim Peters495ad3c2001-01-15 01:36:40 +0000599 The arguments are:
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000600 - from_addr : The address sending this mail.
601 - to_addrs : A list of addresses to send this mail to. A bare
602 string will be treated as a list with 1 address.
Tim Peters495ad3c2001-01-15 01:36:40 +0000603 - msg : The message to send.
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000604 - mail_options : List of ESMTP options (such as 8bitmime) for the
605 mail command.
606 - rcpt_options : List of ESMTP options (such as DSN commands) for
607 all the rcpt commands.
608
609 If there has been no previous EHLO or HELO command this session, this
610 method tries ESMTP EHLO first. If the server does ESMTP, message size
611 and each of the specified options will be passed to it. If EHLO
612 fails, HELO will be tried and ESMTP options suppressed.
613
614 This method will return normally if the mail is accepted for at least
Barry Warsawd25c1b71999-11-28 17:11:06 +0000615 one recipient. It returns a dictionary, with one entry for each
616 recipient that was refused. Each entry contains a tuple of the SMTP
617 error code and the accompanying error message sent by the server.
Guido van Rossum296e1431999-04-07 15:03:39 +0000618
619 This method may raise the following exceptions:
620
621 SMTPHeloError The server didn't reply properly to
Tim Peters495ad3c2001-01-15 01:36:40 +0000622 the helo greeting.
Barry Warsawd25c1b71999-11-28 17:11:06 +0000623 SMTPRecipientsRefused The server rejected ALL recipients
Guido van Rossum296e1431999-04-07 15:03:39 +0000624 (no mail was sent).
625 SMTPSenderRefused The server didn't accept the from_addr.
626 SMTPDataError The server replied with an unexpected
627 error code (other than a refusal of
628 a recipient).
629
630 Note: the connection will be open even after an exception is raised.
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000631
Guido van Rossum95e6f701998-06-25 02:15:50 +0000632 Example:
Tim Peters495ad3c2001-01-15 01:36:40 +0000633
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000634 >>> import smtplib
635 >>> s=smtplib.SMTP("localhost")
Guido van Rossumfc40a831998-01-29 17:26:45 +0000636 >>> tolist=["one@one.org","two@two.org","three@three.org","four@four.org"]
Martin v. Löwis301b1cd2002-07-28 16:52:01 +0000637 >>> msg = '''\\
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000638 ... From: Me@my.org
639 ... Subject: testin'...
640 ...
641 ... This is a test '''
642 >>> s.sendmail("me@my.org",tolist,msg)
643 { "three@three.org" : ( 550 ,"User unknown" ) }
644 >>> s.quit()
Tim Peters495ad3c2001-01-15 01:36:40 +0000645
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000646 In the above example, the message was accepted for delivery to three
647 of the four addresses, and one was rejected, with the error code
Barry Warsawd25c1b71999-11-28 17:11:06 +0000648 550. If all addresses are accepted, then the method will return an
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000649 empty dictionary.
650
651 """
Guido van Rossum296e1431999-04-07 15:03:39 +0000652 if self.helo_resp is None and self.ehlo_resp is None:
653 if not (200 <= self.ehlo()[0] <= 299):
654 (code,resp) = self.helo()
655 if not (200 <= code <= 299):
656 raise SMTPHeloError(code, resp)
Guido van Rossum95e6f701998-06-25 02:15:50 +0000657 esmtp_opts = []
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000658 if self.does_esmtp:
659 # Hmmm? what's this? -ddm
660 # self.esmtp_features['7bit']=""
661 if self.has_extn('size'):
Walter Dörwald70a6b492004-02-12 17:35:32 +0000662 esmtp_opts.append("size=%d" % len(msg))
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000663 for option in mail_options:
Guido van Rossum95e6f701998-06-25 02:15:50 +0000664 esmtp_opts.append(option)
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000665
Guido van Rossum95e6f701998-06-25 02:15:50 +0000666 (code,resp) = self.mail(from_addr, esmtp_opts)
Fred Drake8152d322000-12-12 23:20:45 +0000667 if code != 250:
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000668 self.rset()
Guido van Rossum296e1431999-04-07 15:03:39 +0000669 raise SMTPSenderRefused(code, resp, from_addr)
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000670 senderrs={}
Guido van Rossum3172c5d2007-10-16 18:12:55 +0000671 if isinstance(to_addrs, str):
Jeremy Hylton31bb8ce1998-08-13 19:57:46 +0000672 to_addrs = [to_addrs]
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000673 for each in to_addrs:
Guido van Rossumfcfb6321998-08-04 15:29:54 +0000674 (code,resp)=self.rcpt(each, rcpt_options)
Fred Drake8152d322000-12-12 23:20:45 +0000675 if (code != 250) and (code != 251):
Guido van Rossumfc40a831998-01-29 17:26:45 +0000676 senderrs[each]=(code,resp)
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000677 if len(senderrs)==len(to_addrs):
Guido van Rossum95e6f701998-06-25 02:15:50 +0000678 # the server refused all our recipients
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000679 self.rset()
Guido van Rossum296e1431999-04-07 15:03:39 +0000680 raise SMTPRecipientsRefused(senderrs)
Fred Drake8152d322000-12-12 23:20:45 +0000681 (code,resp) = self.data(msg)
682 if code != 250:
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000683 self.rset()
Guido van Rossum296e1431999-04-07 15:03:39 +0000684 raise SMTPDataError(code, resp)
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000685 #if we got here then somebody got our mail
Tim Peters495ad3c2001-01-15 01:36:40 +0000686 return senderrs
Guido van Rossumbbe323e1998-01-29 17:24:40 +0000687
688
689 def close(self):
690 """Close the connection to the SMTP server."""
691 if self.file:
692 self.file.close()
693 self.file = None
694 if self.sock:
695 self.sock.close()
696 self.sock = None
697
698
699 def quit(self):
Guido van Rossum95e6f701998-06-25 02:15:50 +0000700 """Terminate the SMTP session."""
Guido van Rossum45e2fbc1998-03-26 21:13:24 +0000701 self.docmd("quit")
702 self.close()
Guido van Rossum95e6f701998-06-25 02:15:50 +0000703
Thomas Wouters47b49bf2007-08-30 22:15:33 +0000704if _have_ssl:
Thomas Wouters89f507f2006-12-13 04:49:30 +0000705
Thomas Wouters47b49bf2007-08-30 22:15:33 +0000706 class SMTP_SSL(SMTP):
707 """ This is a subclass derived from SMTP that connects over an SSL encrypted
708 socket (to use this class you need a socket module that was compiled with SSL
709 support). If host is not specified, '' (the local host) is used. If port is
710 omitted, the standard SMTP-over-SSL port (465) is used. keyfile and certfile
711 are also optional - they can contain a PEM formatted private key and
712 certificate chain file for the SSL connection.
713 """
714 def __init__(self, host='', port=0, local_hostname=None,
715 keyfile=None, certfile=None, timeout=None):
716 self.keyfile = keyfile
717 self.certfile = certfile
718 SMTP.__init__(self, host, port, local_hostname, timeout)
719 self.default_port = SMTP_SSL_PORT
720
721 def _get_socket(self, host, port, timeout):
722 if self.debuglevel > 0: print('connect:', (host, port), file=stderr)
723 self.sock = socket.create_connection((host, port), timeout)
Thomas Wouters1b7f8912007-09-19 03:06:30 +0000724 self.sock = ssl.wrap_socket(self.sock, self.keyfile, self.certfile)
Thomas Wouters89d996e2007-09-08 17:39:28 +0000725 self.file = SSLFakeFile(self.sock)
Thomas Wouters47b49bf2007-08-30 22:15:33 +0000726
727 __all__.append("SMTP_SSL")
Barry Warsaw4c4bec81998-12-22 03:02:20 +0000728
Guido van Rossumd8faa362007-04-27 19:54:29 +0000729#
730# LMTP extension
731#
732LMTP_PORT = 2003
733
734class LMTP(SMTP):
735 """LMTP - Local Mail Transfer Protocol
736
737 The LMTP protocol, which is very similar to ESMTP, is heavily based
738 on the standard SMTP client. It's common to use Unix sockets for LMTP,
739 so our connect() method must support that as well as a regular
740 host:port server. To specify a Unix socket, you must use an absolute
741 path as the host, starting with a '/'.
742
743 Authentication is supported, using the regular SMTP mechanism. When
744 using a Unix socket, LMTP generally don't support or require any
745 authentication, but your mileage might vary."""
746
747 ehlo_msg = "lhlo"
748
749 def __init__(self, host = '', port = LMTP_PORT, local_hostname = None):
750 """Initialize a new instance."""
751 SMTP.__init__(self, host, port, local_hostname)
752
753 def connect(self, host = 'localhost', port = 0):
754 """Connect to the LMTP daemon, on either a Unix or a TCP socket."""
755 if host[0] != '/':
756 return SMTP.connect(self, host, port)
757
758 # Handle Unix-domain sockets.
759 try:
760 self.sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
761 self.sock.connect(host)
762 except socket.error as msg:
763 if self.debuglevel > 0: print>>stderr, 'connect fail:', host
764 if self.sock:
765 self.sock.close()
766 self.sock = None
767 raise socket.error(msg)
768 (code, msg) = self.getreply()
769 if self.debuglevel > 0: print>>stderr, "connect:", msg
770 return (code, msg)
771
772
Guido van Rossum95e6f701998-06-25 02:15:50 +0000773# Test the sendmail method, which tests most of the others.
774# Note: This always sends to localhost.
775if __name__ == '__main__':
Andrew M. Kuchling6be424f2001-08-13 14:41:39 +0000776 import sys
Guido van Rossum95e6f701998-06-25 02:15:50 +0000777
778 def prompt(prompt):
779 sys.stdout.write(prompt + ": ")
Eric S. Raymondc013f302001-02-09 05:40:38 +0000780 return sys.stdin.readline().strip()
Guido van Rossum95e6f701998-06-25 02:15:50 +0000781
782 fromaddr = prompt("From")
Eric S. Raymond38151ed2001-02-09 07:40:17 +0000783 toaddrs = prompt("To").split(',')
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000784 print("Enter message, end with ^D:")
Guido van Rossum95e6f701998-06-25 02:15:50 +0000785 msg = ''
786 while 1:
787 line = sys.stdin.readline()
788 if not line:
789 break
790 msg = msg + line
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000791 print("Message length is %d" % len(msg))
Guido van Rossum95e6f701998-06-25 02:15:50 +0000792
793 server = SMTP('localhost')
794 server.set_debuglevel(1)
795 server.sendmail(fromaddr, toaddrs, msg)
796 server.quit()