home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2006 January / Gamestar_80_2006-01_dvd.iso / Dema / Civilization4 / data1.cab / Civ4DemoComponent / Assets / Python / System / smtplib.pyc (.txt) < prev    next >
Encoding:
Python Compiled Bytecode  |  2005-11-09  |  24.9 KB  |  822 lines
  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.4)
  3.  
  4. '''SMTP/ESMTP client class.
  5.  
  6. This should follow RFC 821 (SMTP), RFC 1869 (ESMTP), RFC 2554 (SMTP
  7. Authentication) and RFC 2487 (Secure SMTP over TLS).
  8.  
  9. Notes:
  10.  
  11. Please remember, when doing ESMTP, that the names of the SMTP service
  12. extensions are NOT the same thing as the option keywords for the RCPT
  13. and MAIL commands!
  14.  
  15. Example:
  16.  
  17.   >>> import smtplib
  18.   >>> s=smtplib.SMTP("localhost")
  19.   >>> print s.help()
  20.   This is Sendmail version 8.8.4
  21.   Topics:
  22.       HELO    EHLO    MAIL    RCPT    DATA
  23.       RSET    NOOP    QUIT    HELP    VRFY
  24.       EXPN    VERB    ETRN    DSN
  25.   For more info use "HELP <topic>".
  26.   To report bugs in the implementation send email to
  27.       sendmail-bugs@sendmail.org.
  28.   For local information send email to Postmaster at your site.
  29.   End of HELP info
  30.   >>> s.putcmd("vrfy","someone@here")
  31.   >>> s.getreply()
  32.   (250, "Somebody OverHere <somebody@here.my.org>")
  33.   >>> s.quit()
  34. '''
  35. import socket
  36. import re
  37. import rfc822
  38. import base64
  39. import hmac
  40. from email.base64MIME import encode as encode_base64
  41. from sys import stderr
  42. __all__ = [
  43.     'SMTPException',
  44.     'SMTPServerDisconnected',
  45.     'SMTPResponseException',
  46.     'SMTPSenderRefused',
  47.     'SMTPRecipientsRefused',
  48.     'SMTPDataError',
  49.     'SMTPConnectError',
  50.     'SMTPHeloError',
  51.     'SMTPAuthenticationError',
  52.     'quoteaddr',
  53.     'quotedata',
  54.     'SMTP']
  55. SMTP_PORT = 25
  56. CRLF = '\r\n'
  57. OLDSTYLE_AUTH = re.compile('auth=(.*)', re.I)
  58.  
  59. class SMTPException(Exception):
  60.     '''Base class for all exceptions raised by this module.'''
  61.     pass
  62.  
  63.  
  64. class SMTPServerDisconnected(SMTPException):
  65.     '''Not connected to any SMTP server.
  66.  
  67.     This exception is raised when the server unexpectedly disconnects,
  68.     or when an attempt is made to use the SMTP instance before
  69.     connecting it to a server.
  70.     '''
  71.     pass
  72.  
  73.  
  74. class SMTPResponseException(SMTPException):
  75.     """Base class for all exceptions that include an SMTP error code.
  76.  
  77.     These exceptions are generated in some instances when the SMTP
  78.     server returns an error code.  The error code is stored in the
  79.     `smtp_code' attribute of the error, and the `smtp_error' attribute
  80.     is set to the error message.
  81.     """
  82.     
  83.     def __init__(self, code, msg):
  84.         self.smtp_code = code
  85.         self.smtp_error = msg
  86.         self.args = (code, msg)
  87.  
  88.  
  89.  
  90. class SMTPSenderRefused(SMTPResponseException):
  91.     """Sender address refused.
  92.  
  93.     In addition to the attributes set by on all SMTPResponseException
  94.     exceptions, this sets `sender' to the string that the SMTP refused.
  95.     """
  96.     
  97.     def __init__(self, code, msg, sender):
  98.         self.smtp_code = code
  99.         self.smtp_error = msg
  100.         self.sender = sender
  101.         self.args = (code, msg, sender)
  102.  
  103.  
  104.  
  105. class SMTPRecipientsRefused(SMTPException):
  106.     """All recipient addresses refused.
  107.  
  108.     The errors for each recipient are accessible through the attribute
  109.     'recipients', which is a dictionary of exactly the same sort as
  110.     SMTP.sendmail() returns.
  111.     """
  112.     
  113.     def __init__(self, recipients):
  114.         self.recipients = recipients
  115.         self.args = (recipients,)
  116.  
  117.  
  118.  
  119. class SMTPDataError(SMTPResponseException):
  120.     """The SMTP server didn't accept the data."""
  121.     pass
  122.  
  123.  
  124. class SMTPConnectError(SMTPResponseException):
  125.     '''Error during connection establishment.'''
  126.     pass
  127.  
  128.  
  129. class SMTPHeloError(SMTPResponseException):
  130.     '''The server refused our HELO reply.'''
  131.     pass
  132.  
  133.  
  134. class SMTPAuthenticationError(SMTPResponseException):
  135.     """Authentication error.
  136.  
  137.     Most probably the server didn't accept the username/password
  138.     combination provided.
  139.     """
  140.     pass
  141.  
  142.  
  143. class SSLFakeSocket:
  144.     '''A fake socket object that really wraps a SSLObject.
  145.  
  146.     It only supports what is needed in smtplib.
  147.     '''
  148.     
  149.     def __init__(self, realsock, sslobj):
  150.         self.realsock = realsock
  151.         self.sslobj = sslobj
  152.  
  153.     
  154.     def send(self, str):
  155.         self.sslobj.write(str)
  156.         return len(str)
  157.  
  158.     sendall = send
  159.     
  160.     def close(self):
  161.         self.realsock.close()
  162.  
  163.  
  164.  
  165. class SSLFakeFile:
  166.     '''A fake file like object that really wraps a SSLObject.
  167.  
  168.     It only supports what is needed in smtplib.
  169.     '''
  170.     
  171.     def __init__(self, sslobj):
  172.         self.sslobj = sslobj
  173.  
  174.     
  175.     def readline(self):
  176.         str = ''
  177.         chr = None
  178.         while chr != '\n':
  179.             chr = self.sslobj.read(1)
  180.             str += chr
  181.         return str
  182.  
  183.     
  184.     def close(self):
  185.         pass
  186.  
  187.  
  188.  
  189. def quoteaddr(addr):
  190.     '''Quote a subset of the email addresses defined by RFC 821.
  191.  
  192.     Should be able to handle anything rfc822.parseaddr can handle.
  193.     '''
  194.     m = (None, None)
  195.     
  196.     try:
  197.         m = rfc822.parseaddr(addr)[1]
  198.     except AttributeError:
  199.         pass
  200.  
  201.     if m == (None, None):
  202.         return '<%s>' % addr
  203.     else:
  204.         return '<%s>' % m
  205.  
  206.  
  207. def quotedata(data):
  208.     """Quote data for email.
  209.  
  210.     Double leading '.', and change Unix newline '\\n', or Mac '\\r' into
  211.     Internet CRLF end-of-line.
  212.     """
  213.     return re.sub('(?m)^\\.', '..', re.sub('(?:\\r\\n|\\n|\\r(?!\\n))', CRLF, data))
  214.  
  215.  
  216. class SMTP:
  217.     """This class manages a connection to an SMTP or ESMTP server.
  218.     SMTP Objects:
  219.         SMTP objects have the following attributes:
  220.             helo_resp
  221.                 This is the message given by the server in response to the
  222.                 most recent HELO command.
  223.  
  224.             ehlo_resp
  225.                 This is the message given by the server in response to the
  226.                 most recent EHLO command. This is usually multiline.
  227.  
  228.             does_esmtp
  229.                 This is a True value _after you do an EHLO command_, if the
  230.                 server supports ESMTP.
  231.  
  232.             esmtp_features
  233.                 This is a dictionary, which, if the server supports ESMTP,
  234.                 will _after you do an EHLO command_, contain the names of the
  235.                 SMTP service extensions this server supports, and their
  236.                 parameters (if any).
  237.  
  238.                 Note, all extension names are mapped to lower case in the
  239.                 dictionary.
  240.  
  241.         See each method's docstrings for details.  In general, there is a
  242.         method of the same name to perform each SMTP command.  There is also a
  243.         method called 'sendmail' that will do an entire mail transaction.
  244.         """
  245.     debuglevel = 0
  246.     file = None
  247.     helo_resp = None
  248.     ehlo_resp = None
  249.     does_esmtp = 0
  250.     
  251.     def __init__(self, host = '', port = 0, local_hostname = None):
  252.         """Initialize a new instance.
  253.  
  254.         If specified, `host' is the name of the remote host to which to
  255.         connect.  If specified, `port' specifies the port to which to connect.
  256.         By default, smtplib.SMTP_PORT is used.  An SMTPConnectError is raised
  257.         if the specified `host' doesn't respond correctly.  If specified,
  258.         `local_hostname` is used as the FQDN of the local host.  By default,
  259.         the local hostname is found using socket.getfqdn().
  260.  
  261.         """
  262.         self.esmtp_features = { }
  263.         if host:
  264.             (code, msg) = self.connect(host, port)
  265.             if code != 220:
  266.                 raise SMTPConnectError(code, msg)
  267.             
  268.         
  269.         if local_hostname is not None:
  270.             self.local_hostname = local_hostname
  271.         else:
  272.             fqdn = socket.getfqdn()
  273.             if '.' in fqdn:
  274.                 self.local_hostname = fqdn
  275.             else:
  276.                 addr = socket.gethostbyname(socket.gethostname())
  277.                 self.local_hostname = '[%s]' % addr
  278.  
  279.     
  280.     def set_debuglevel(self, debuglevel):
  281.         '''Set the debug output level.
  282.  
  283.         A non-false value results in debug messages for connection and for all
  284.         messages sent to and received from the server.
  285.  
  286.         '''
  287.         self.debuglevel = debuglevel
  288.  
  289.     
  290.     def connect(self, host = 'localhost', port = 0):
  291.         """Connect to a host on a given port.
  292.  
  293.         If the hostname ends with a colon (`:') followed by a number, and
  294.         there is no port specified, that suffix will be stripped off and the
  295.         number interpreted as the port number to use.
  296.  
  297.         Note: This method is automatically invoked by __init__, if a host is
  298.         specified during instantiation.
  299.  
  300.         """
  301.         if not port and host.find(':') == host.rfind(':'):
  302.             i = host.rfind(':')
  303.             if i >= 0:
  304.                 host = host[:i]
  305.                 port = host[i + 1:]
  306.                 
  307.                 try:
  308.                     port = int(port)
  309.                 except ValueError:
  310.                     raise socket.error, 'nonnumeric port'
  311.                 except:
  312.                     None<EXCEPTION MATCH>ValueError
  313.                 
  314.  
  315.             None<EXCEPTION MATCH>ValueError
  316.         
  317.         if not port:
  318.             port = SMTP_PORT
  319.         
  320.         if self.debuglevel > 0:
  321.             print >>stderr, 'connect:', (host, port)
  322.         
  323.         msg = 'getaddrinfo returns an empty list'
  324.         self.sock = None
  325.         for res in socket.getaddrinfo(host, port, 0, socket.SOCK_STREAM):
  326.             (af, socktype, proto, canonname, sa) = res
  327.             
  328.             try:
  329.                 self.sock = socket.socket(af, socktype, proto)
  330.                 if self.debuglevel > 0:
  331.                     print >>stderr, 'connect:', (host, port)
  332.                 
  333.                 self.sock.connect(sa)
  334.             except socket.error:
  335.                 msg = None
  336.                 if self.debuglevel > 0:
  337.                     print >>stderr, 'connect fail:', (host, port)
  338.                 
  339.                 if self.sock:
  340.                     self.sock.close()
  341.                 
  342.                 self.sock = None
  343.                 continue
  344.  
  345.         
  346.         if not self.sock:
  347.             raise socket.error, msg
  348.         
  349.         (code, msg) = self.getreply()
  350.         if self.debuglevel > 0:
  351.             print >>stderr, 'connect:', msg
  352.         
  353.         return (code, msg)
  354.  
  355.     
  356.     def send(self, str):
  357.         """Send `str' to the server."""
  358.         if self.debuglevel > 0:
  359.             print >>stderr, 'send:', repr(str)
  360.         
  361.         if self.sock:
  362.             
  363.             try:
  364.                 self.sock.sendall(str)
  365.             except socket.error:
  366.                 self.close()
  367.                 raise SMTPServerDisconnected('Server not connected')
  368.             except:
  369.                 None<EXCEPTION MATCH>socket.error
  370.             
  371.  
  372.         None<EXCEPTION MATCH>socket.error
  373.         raise SMTPServerDisconnected('please run connect() first')
  374.  
  375.     
  376.     def putcmd(self, cmd, args = ''):
  377.         '''Send a command to the server.'''
  378.         if args == '':
  379.             str = '%s%s' % (cmd, CRLF)
  380.         else:
  381.             str = '%s %s%s' % (cmd, args, CRLF)
  382.         self.send(str)
  383.  
  384.     
  385.     def getreply(self):
  386.         """Get a reply from the server.
  387.  
  388.         Returns a tuple consisting of:
  389.  
  390.           - server response code (e.g. '250', or such, if all goes well)
  391.             Note: returns -1 if it can't read response code.
  392.  
  393.           - server response string corresponding to response code (multiline
  394.             responses are converted to a single, multiline string).
  395.  
  396.         Raises SMTPServerDisconnected if end-of-file is reached.
  397.         """
  398.         resp = []
  399.         if self.file is None:
  400.             self.file = self.sock.makefile('rb')
  401.         
  402.         while None:
  403.             line = self.file.readline()
  404.             if line == '':
  405.                 self.close()
  406.                 raise SMTPServerDisconnected('Connection unexpectedly closed')
  407.             
  408.             if self.debuglevel > 0:
  409.                 print >>stderr, 'reply:', repr(line)
  410.             
  411.             code = line[:3]
  412.             
  413.             try:
  414.                 errcode = int(code)
  415.             except ValueError:
  416.                 errcode = -1
  417.                 break
  418.  
  419.             if line[3:4] != '-':
  420.                 break
  421.                 continue
  422.         errmsg = '\n'.join(resp)
  423.         if self.debuglevel > 0:
  424.             print >>stderr, 'reply: retcode (%s); Msg: %s' % (errcode, errmsg)
  425.         
  426.         return (errcode, errmsg)
  427.  
  428.     
  429.     def docmd(self, cmd, args = ''):
  430.         '''Send a command, and return its response code.'''
  431.         self.putcmd(cmd, args)
  432.         return self.getreply()
  433.  
  434.     
  435.     def helo(self, name = ''):
  436.         """SMTP 'helo' command.
  437.         Hostname to send for this command defaults to the FQDN of the local
  438.         host.
  439.         """
  440.         if not name:
  441.             pass
  442.         self.putcmd('helo', self.local_hostname)
  443.         (code, msg) = self.getreply()
  444.         self.helo_resp = msg
  445.         return (code, msg)
  446.  
  447.     
  448.     def ehlo(self, name = ''):
  449.         """ SMTP 'ehlo' command.
  450.         Hostname to send for this command defaults to the FQDN of the local
  451.         host.
  452.         """
  453.         self.esmtp_features = { }
  454.         if not name:
  455.             pass
  456.         self.putcmd('ehlo', self.local_hostname)
  457.         (code, msg) = self.getreply()
  458.         if code == -1 and len(msg) == 0:
  459.             self.close()
  460.             raise SMTPServerDisconnected('Server not connected')
  461.         
  462.         self.ehlo_resp = msg
  463.         if code != 250:
  464.             return (code, msg)
  465.         
  466.         self.does_esmtp = 1
  467.         resp = self.ehlo_resp.split('\n')
  468.         del resp[0]
  469.         for each in resp:
  470.             auth_match = OLDSTYLE_AUTH.match(each)
  471.             if auth_match:
  472.                 self.esmtp_features['auth'] = self.esmtp_features.get('auth', '') + ' ' + auth_match.groups(0)[0]
  473.                 continue
  474.             
  475.             m = re.match('(?P<feature>[A-Za-z0-9][A-Za-z0-9\\-]*) ?', each)
  476.             if m:
  477.                 feature = m.group('feature').lower()
  478.                 params = m.string[m.end('feature'):].strip()
  479.                 if feature == 'auth':
  480.                     self.esmtp_features[feature] = self.esmtp_features.get(feature, '') + ' ' + params
  481.                 else:
  482.                     self.esmtp_features[feature] = params
  483.             feature == 'auth'
  484.         
  485.         return (code, msg)
  486.  
  487.     
  488.     def has_extn(self, opt):
  489.         '''Does the server support a given SMTP service extension?'''
  490.         return opt.lower() in self.esmtp_features
  491.  
  492.     
  493.     def help(self, args = ''):
  494.         """SMTP 'help' command.
  495.         Returns help text from server."""
  496.         self.putcmd('help', args)
  497.         return self.getreply()
  498.  
  499.     
  500.     def rset(self):
  501.         """SMTP 'rset' command -- resets session."""
  502.         return self.docmd('rset')
  503.  
  504.     
  505.     def noop(self):
  506.         """SMTP 'noop' command -- doesn't do anything :>"""
  507.         return self.docmd('noop')
  508.  
  509.     
  510.     def mail(self, sender, options = []):
  511.         """SMTP 'mail' command -- begins mail xfer session."""
  512.         optionlist = ''
  513.         if options and self.does_esmtp:
  514.             optionlist = ' ' + ' '.join(options)
  515.         
  516.         self.putcmd('mail', 'FROM:%s%s' % (quoteaddr(sender), optionlist))
  517.         return self.getreply()
  518.  
  519.     
  520.     def rcpt(self, recip, options = []):
  521.         """SMTP 'rcpt' command -- indicates 1 recipient for this mail."""
  522.         optionlist = ''
  523.         if options and self.does_esmtp:
  524.             optionlist = ' ' + ' '.join(options)
  525.         
  526.         self.putcmd('rcpt', 'TO:%s%s' % (quoteaddr(recip), optionlist))
  527.         return self.getreply()
  528.  
  529.     
  530.     def data(self, msg):
  531.         """SMTP 'DATA' command -- sends message data to server.
  532.  
  533.         Automatically quotes lines beginning with a period per rfc821.
  534.         Raises SMTPDataError if there is an unexpected reply to the
  535.         DATA command; the return value from this method is the final
  536.         response code received when the all data is sent.
  537.         """
  538.         self.putcmd('data')
  539.         (code, repl) = self.getreply()
  540.         if self.debuglevel > 0:
  541.             print >>stderr, 'data:', (code, repl)
  542.         
  543.         if code != 354:
  544.             raise SMTPDataError(code, repl)
  545.         else:
  546.             q = quotedata(msg)
  547.             if q[-2:] != CRLF:
  548.                 q = q + CRLF
  549.             
  550.             q = q + '.' + CRLF
  551.             self.send(q)
  552.             (code, msg) = self.getreply()
  553.             if self.debuglevel > 0:
  554.                 print >>stderr, 'data:', (code, msg)
  555.             
  556.             return (code, msg)
  557.  
  558.     
  559.     def verify(self, address):
  560.         """SMTP 'verify' command -- checks for address validity."""
  561.         self.putcmd('vrfy', quoteaddr(address))
  562.         return self.getreply()
  563.  
  564.     vrfy = verify
  565.     
  566.     def expn(self, address):
  567.         """SMTP 'verify' command -- checks for address validity."""
  568.         self.putcmd('expn', quoteaddr(address))
  569.         return self.getreply()
  570.  
  571.     
  572.     def login(self, user, password):
  573.         """Log in on an SMTP server that requires authentication.
  574.  
  575.         The arguments are:
  576.             - user:     The user name to authenticate with.
  577.             - password: The password for the authentication.
  578.  
  579.         If there has been no previous EHLO or HELO command this session, this
  580.         method tries ESMTP EHLO first.
  581.  
  582.         This method will return normally if the authentication was successful.
  583.  
  584.         This method may raise the following exceptions:
  585.  
  586.          SMTPHeloError            The server didn't reply properly to
  587.                                   the helo greeting.
  588.          SMTPAuthenticationError  The server didn't accept the username/
  589.                                   password combination.
  590.          SMTPException            No suitable authentication method was
  591.                                   found.
  592.         """
  593.         
  594.         def encode_cram_md5(challenge, user, password):
  595.             challenge = base64.decodestring(challenge)
  596.             response = user + ' ' + hmac.HMAC(password, challenge).hexdigest()
  597.             return encode_base64(response, eol = '')
  598.  
  599.         
  600.         def encode_plain(user, password):
  601.             return encode_base64('%s\x00%s\x00%s' % (user, user, password), eol = '')
  602.  
  603.         AUTH_PLAIN = 'PLAIN'
  604.         AUTH_CRAM_MD5 = 'CRAM-MD5'
  605.         AUTH_LOGIN = 'LOGIN'
  606.         if self.helo_resp is None and self.ehlo_resp is None:
  607.             if self.ehlo()[0] <= self.ehlo()[0]:
  608.                 pass
  609.             elif not self.ehlo()[0] <= 299:
  610.                 (code, resp) = self.helo()
  611.                 if code <= code:
  612.                     pass
  613.                 elif not code <= 299:
  614.                     raise SMTPHeloError(code, resp)
  615.                 
  616.             
  617.         
  618.         if not self.has_extn('auth'):
  619.             raise SMTPException('SMTP AUTH extension not supported by server.')
  620.         
  621.         authlist = self.esmtp_features['auth'].split()
  622.         preferred_auths = [
  623.             AUTH_CRAM_MD5,
  624.             AUTH_PLAIN,
  625.             AUTH_LOGIN]
  626.         authmethod = None
  627.         for method in preferred_auths:
  628.             if method in authlist:
  629.                 authmethod = method
  630.                 break
  631.                 continue
  632.         
  633.         if authmethod == AUTH_CRAM_MD5:
  634.             (code, resp) = self.docmd('AUTH', AUTH_CRAM_MD5)
  635.             if code == 503:
  636.                 return (code, resp)
  637.             
  638.             (code, resp) = self.docmd(encode_cram_md5(resp, user, password))
  639.         elif authmethod == AUTH_PLAIN:
  640.             (code, resp) = self.docmd('AUTH', AUTH_PLAIN + ' ' + encode_plain(user, password))
  641.         elif authmethod == AUTH_LOGIN:
  642.             (code, resp) = self.docmd('AUTH', '%s %s' % (AUTH_LOGIN, encode_base64(user, eol = '')))
  643.             if code != 334:
  644.                 raise SMTPAuthenticationError(code, resp)
  645.             
  646.             (code, resp) = self.docmd(encode_base64(password, eol = ''))
  647.         elif authmethod is None:
  648.             raise SMTPException('No suitable authentication method found.')
  649.         
  650.         if code not in [
  651.             235,
  652.             503]:
  653.             raise SMTPAuthenticationError(code, resp)
  654.         
  655.         return (code, resp)
  656.  
  657.     
  658.     def starttls(self, keyfile = None, certfile = None):
  659.         '''Puts the connection to the SMTP server into TLS mode.
  660.  
  661.         If the server supports TLS, this will encrypt the rest of the SMTP
  662.         session. If you provide the keyfile and certfile parameters,
  663.         the identity of the SMTP server and client can be checked. This,
  664.         however, depends on whether the socket module really checks the
  665.         certificates.
  666.         '''
  667.         (resp, reply) = self.docmd('STARTTLS')
  668.         if resp == 220:
  669.             sslobj = socket.ssl(self.sock, keyfile, certfile)
  670.             self.sock = SSLFakeSocket(self.sock, sslobj)
  671.             self.file = SSLFakeFile(sslobj)
  672.         
  673.         return (resp, reply)
  674.  
  675.     
  676.     def sendmail(self, from_addr, to_addrs, msg, mail_options = [], rcpt_options = []):
  677.         '''This command performs an entire mail transaction.
  678.  
  679.         The arguments are:
  680.             - from_addr    : The address sending this mail.
  681.             - to_addrs     : A list of addresses to send this mail to.  A bare
  682.                              string will be treated as a list with 1 address.
  683.             - msg          : The message to send.
  684.             - mail_options : List of ESMTP options (such as 8bitmime) for the
  685.                              mail command.
  686.             - rcpt_options : List of ESMTP options (such as DSN commands) for
  687.                              all the rcpt commands.
  688.  
  689.         If there has been no previous EHLO or HELO command this session, this
  690.         method tries ESMTP EHLO first.  If the server does ESMTP, message size
  691.         and each of the specified options will be passed to it.  If EHLO
  692.         fails, HELO will be tried and ESMTP options suppressed.
  693.  
  694.         This method will return normally if the mail is accepted for at least
  695.         one recipient.  It returns a dictionary, with one entry for each
  696.         recipient that was refused.  Each entry contains a tuple of the SMTP
  697.         error code and the accompanying error message sent by the server.
  698.  
  699.         This method may raise the following exceptions:
  700.  
  701.          SMTPHeloError          The server didn\'t reply properly to
  702.                                 the helo greeting.
  703.          SMTPRecipientsRefused  The server rejected ALL recipients
  704.                                 (no mail was sent).
  705.          SMTPSenderRefused      The server didn\'t accept the from_addr.
  706.          SMTPDataError          The server replied with an unexpected
  707.                                 error code (other than a refusal of
  708.                                 a recipient).
  709.  
  710.         Note: the connection will be open even after an exception is raised.
  711.  
  712.         Example:
  713.  
  714.          >>> import smtplib
  715.          >>> s=smtplib.SMTP("localhost")
  716.          >>> tolist=["one@one.org","two@two.org","three@three.org","four@four.org"]
  717.          >>> msg = \'\'\'\\
  718.          ... From: Me@my.org
  719.          ... Subject: testin\'...
  720.          ...
  721.          ... This is a test \'\'\'
  722.          >>> s.sendmail("me@my.org",tolist,msg)
  723.          { "three@three.org" : ( 550 ,"User unknown" ) }
  724.          >>> s.quit()
  725.  
  726.         In the above example, the message was accepted for delivery to three
  727.         of the four addresses, and one was rejected, with the error code
  728.         550.  If all addresses are accepted, then the method will return an
  729.         empty dictionary.
  730.  
  731.         '''
  732.         if self.helo_resp is None and self.ehlo_resp is None:
  733.             if self.ehlo()[0] <= self.ehlo()[0]:
  734.                 pass
  735.             elif not self.ehlo()[0] <= 299:
  736.                 (code, resp) = self.helo()
  737.                 if code <= code:
  738.                     pass
  739.                 elif not code <= 299:
  740.                     raise SMTPHeloError(code, resp)
  741.                 
  742.             
  743.         
  744.         esmtp_opts = []
  745.         if self.does_esmtp:
  746.             if self.has_extn('size'):
  747.                 esmtp_opts.append('size=%d' % len(msg))
  748.             
  749.             for option in mail_options:
  750.                 esmtp_opts.append(option)
  751.             
  752.         
  753.         (code, resp) = self.mail(from_addr, esmtp_opts)
  754.         if code != 250:
  755.             self.rset()
  756.             raise SMTPSenderRefused(code, resp, from_addr)
  757.         
  758.         senderrs = { }
  759.         if isinstance(to_addrs, basestring):
  760.             to_addrs = [
  761.                 to_addrs]
  762.         
  763.         for each in to_addrs:
  764.             (code, resp) = self.rcpt(each, rcpt_options)
  765.             if code != 250 and code != 251:
  766.                 senderrs[each] = (code, resp)
  767.                 continue
  768.         
  769.         if len(senderrs) == len(to_addrs):
  770.             self.rset()
  771.             raise SMTPRecipientsRefused(senderrs)
  772.         
  773.         (code, resp) = self.data(msg)
  774.         if code != 250:
  775.             self.rset()
  776.             raise SMTPDataError(code, resp)
  777.         
  778.         return senderrs
  779.  
  780.     
  781.     def close(self):
  782.         '''Close the connection to the SMTP server.'''
  783.         if self.file:
  784.             self.file.close()
  785.         
  786.         self.file = None
  787.         if self.sock:
  788.             self.sock.close()
  789.         
  790.         self.sock = None
  791.  
  792.     
  793.     def quit(self):
  794.         '''Terminate the SMTP session.'''
  795.         self.docmd('quit')
  796.         self.close()
  797.  
  798.  
  799. if __name__ == '__main__':
  800.     import sys
  801.     
  802.     def prompt(prompt):
  803.         sys.stdout.write(prompt + ': ')
  804.         return sys.stdin.readline().strip()
  805.  
  806.     fromaddr = prompt('From')
  807.     toaddrs = prompt('To').split(',')
  808.     print 'Enter message, end with ^D:'
  809.     msg = ''
  810.     while 1:
  811.         line = sys.stdin.readline()
  812.         if not line:
  813.             break
  814.         
  815.         msg = msg + line
  816.     print 'Message length is %d' % len(msg)
  817.     server = SMTP('localhost')
  818.     server.set_debuglevel(1)
  819.     server.sendmail(fromaddr, toaddrs, msg)
  820.     server.quit()
  821.  
  822.