Fred Drake | 295da24 | 1998-08-10 19:42:37 +0000 | [diff] [blame] | 1 | \section{\module{smtplib} --- |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 2 | SMTP protocol client} |
Fred Drake | b91e934 | 1998-07-23 17:59:49 +0000 | [diff] [blame] | 3 | |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 4 | \declaremodule{standard}{smtplib} |
Fred Drake | b91e934 | 1998-07-23 17:59:49 +0000 | [diff] [blame] | 5 | \modulesynopsis{SMTP protocol client (requires sockets).} |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 6 | \sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com} |
Fred Drake | b91e934 | 1998-07-23 17:59:49 +0000 | [diff] [blame] | 7 | |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 8 | \indexii{SMTP}{protocol} |
| 9 | \index{Simple Mail Transfer Protocol} |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 10 | |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 11 | The \module{smtplib} module defines an SMTP client session object that |
| 12 | can be used to send mail to any Internet machine with an SMTP or ESMTP |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 13 | listener daemon. For details of SMTP and ESMTP operation, consult |
Fred Drake | ebe0341 | 1999-11-09 20:11:17 +0000 | [diff] [blame] | 14 | \rfc{821} (\citetitle{Simple Mail Transfer Protocol}) and \rfc{1869} |
| 15 | (\citetitle{SMTP Service Extensions}). |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 16 | |
Neil Schemenauer | ccbb0ed | 2002-03-24 15:41:40 +0000 | [diff] [blame] | 17 | \begin{classdesc}{SMTP}{\optional{host\optional{, port\optional{, |
| 18 | local_hostname}}}} |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 19 | A \class{SMTP} instance encapsulates an SMTP connection. It has |
| 20 | methods that support a full repertoire of SMTP and ESMTP |
| 21 | operations. If the optional host and port parameters are given, the |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 22 | SMTP \method{connect()} method is called with those parameters during |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 23 | initialization. An \exception{SMTPConnectError} is raised if the |
| 24 | specified host doesn't respond correctly. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 25 | |
| 26 | For normal use, you should only require the initialization/connect, |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 27 | \method{sendmail()}, and \method{quit()} methods. An example is |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 28 | included below. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 29 | \end{classdesc} |
| 30 | |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 31 | |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 32 | A nice selection of exceptions is defined as well: |
| 33 | |
| 34 | \begin{excdesc}{SMTPException} |
| 35 | Base exception class for all exceptions raised by this module. |
| 36 | \end{excdesc} |
| 37 | |
| 38 | \begin{excdesc}{SMTPServerDisconnected} |
| 39 | This exception is raised when the server unexpectedly disconnects, |
| 40 | or when an attempt is made to use the \class{SMTP} instance before |
| 41 | connecting it to a server. |
| 42 | \end{excdesc} |
| 43 | |
| 44 | \begin{excdesc}{SMTPResponseException} |
| 45 | Base class for all exceptions that include an SMTP error code. |
| 46 | These exceptions are generated in some instances when the SMTP |
| 47 | server returns an error code. The error code is stored in the |
| 48 | \member{smtp_code} attribute of the error, and the |
| 49 | \member{smtp_error} attribute is set to the error message. |
| 50 | \end{excdesc} |
| 51 | |
| 52 | \begin{excdesc}{SMTPSenderRefused} |
Tim Peters | 9ca3f02 | 2003-06-15 23:08:45 +0000 | [diff] [blame] | 53 | Sender address refused. In addition to the attributes set by on all |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 54 | \exception{SMTPResponseException} exceptions, this sets `sender' to |
| 55 | the string that the SMTP server refused. |
| 56 | \end{excdesc} |
| 57 | |
| 58 | \begin{excdesc}{SMTPRecipientsRefused} |
| 59 | All recipient addresses refused. The errors for each recipient are |
Thomas Wouters | f831663 | 2000-07-16 19:01:10 +0000 | [diff] [blame] | 60 | accessible through the attribute \member{recipients}, which is a |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 61 | dictionary of exactly the same sort as \method{SMTP.sendmail()} |
| 62 | returns. |
| 63 | \end{excdesc} |
| 64 | |
| 65 | \begin{excdesc}{SMTPDataError} |
| 66 | The SMTP server refused to accept the message data. |
| 67 | \end{excdesc} |
| 68 | |
| 69 | \begin{excdesc}{SMTPConnectError} |
| 70 | Error occurred during establishment of a connection with the server. |
| 71 | \end{excdesc} |
| 72 | |
| 73 | \begin{excdesc}{SMTPHeloError} |
| 74 | The server refused our \samp{HELO} message. |
| 75 | \end{excdesc} |
| 76 | |
| 77 | |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 78 | \begin{seealso} |
Fred Drake | 58a2dff | 2000-10-03 05:56:55 +0000 | [diff] [blame] | 79 | \seerfc{821}{Simple Mail Transfer Protocol}{Protocol definition for |
| 80 | SMTP. This document covers the model, operating procedure, |
| 81 | and protocol details for SMTP.} |
| 82 | \seerfc{1869}{SMTP Service Extensions}{Definition of the ESMTP |
| 83 | extensions for SMTP. This describes a framework for |
| 84 | extending SMTP with new commands, supporting dynamic |
| 85 | discovery of the commands provided by the server, and |
| 86 | defines a few additional commands.} |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 87 | \end{seealso} |
| 88 | |
| 89 | |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 90 | \subsection{SMTP Objects \label{SMTP-objects}} |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 91 | |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 92 | An \class{SMTP} instance has the following methods: |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 93 | |
| 94 | \begin{methoddesc}{set_debuglevel}{level} |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 95 | Set the debug output level. A true value for \var{level} results in |
| 96 | debug messages for connection and for all messages sent to and |
| 97 | received from the server. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 98 | \end{methoddesc} |
| 99 | |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 100 | \begin{methoddesc}{connect}{\optional{host\optional{, port}}} |
Tim Peters | 9ca3f02 | 2003-06-15 23:08:45 +0000 | [diff] [blame] | 101 | Connect to a host on a given port. The defaults are to connect to the |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 102 | local host at the standard SMTP port (25). |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 103 | If the hostname ends with a colon (\character{:}) followed by a |
Tim Peters | 9ca3f02 | 2003-06-15 23:08:45 +0000 | [diff] [blame] | 104 | number, that suffix will be stripped off and the number interpreted as |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 105 | the port number to use. |
Fred Drake | 0aa811c | 2001-10-20 04:24:09 +0000 | [diff] [blame] | 106 | This method is automatically invoked by the constructor if a |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 107 | host is specified during instantiation. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 108 | \end{methoddesc} |
| 109 | |
| 110 | \begin{methoddesc}{docmd}{cmd, \optional{, argstring}} |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 111 | Send a command \var{cmd} to the server. The optional argument |
| 112 | \var{argstring} is simply concatenated to the command, separated by a |
| 113 | space. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 114 | |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 115 | This returns a 2-tuple composed of a numeric response code and the |
| 116 | actual response line (multiline responses are joined into one long |
| 117 | line.) |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 118 | |
| 119 | In normal operation it should not be necessary to call this method |
| 120 | explicitly. It is used to implement other methods and may be useful |
| 121 | for testing private extensions. |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 122 | |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 123 | If the connection to the server is lost while waiting for the reply, |
| 124 | \exception{SMTPServerDisconnected} will be raised. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 125 | \end{methoddesc} |
| 126 | |
| 127 | \begin{methoddesc}{helo}{\optional{hostname}} |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 128 | Identify yourself to the SMTP server using \samp{HELO}. The hostname |
| 129 | argument defaults to the fully qualified domain name of the local |
| 130 | host. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 131 | |
| 132 | In normal operation it should not be necessary to call this method |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 133 | explicitly. It will be implicitly called by the \method{sendmail()} |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 134 | when necessary. |
| 135 | \end{methoddesc} |
| 136 | |
| 137 | \begin{methoddesc}{ehlo}{\optional{hostname}} |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 138 | Identify yourself to an ESMTP server using \samp{EHLO}. The hostname |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 139 | argument defaults to the fully qualified domain name of the local |
| 140 | host. Examine the response for ESMTP option and store them for use by |
Greg Ward | 19b6f60 | 2003-01-08 03:04:42 +0000 | [diff] [blame] | 141 | \method{has_extn()}. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 142 | |
Greg Ward | 19b6f60 | 2003-01-08 03:04:42 +0000 | [diff] [blame] | 143 | Unless you wish to use \method{has_extn()} before sending |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 144 | mail, it should not be necessary to call this method explicitly. It |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 145 | will be implicitly called by \method{sendmail()} when necessary. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 146 | \end{methoddesc} |
| 147 | |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 148 | \begin{methoddesc}{has_extn}{name} |
Raymond Hettinger | 9b4dab4 | 2003-12-31 18:37:28 +0000 | [diff] [blame] | 149 | Return \constant{True} if \var{name} is in the set of SMTP service |
| 150 | extensions returned by the server, \constant{False} otherwise. |
| 151 | Case is ignored. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 152 | \end{methoddesc} |
| 153 | |
| 154 | \begin{methoddesc}{verify}{address} |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 155 | Check the validity of an address on this server using SMTP \samp{VRFY}. |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 156 | Returns a tuple consisting of code 250 and a full \rfc{822} address |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 157 | (including human name) if the user address is valid. Otherwise returns |
| 158 | an SMTP error code of 400 or greater and an error string. |
| 159 | |
Fred Drake | 0aa811c | 2001-10-20 04:24:09 +0000 | [diff] [blame] | 160 | \note{Many sites disable SMTP \samp{VRFY} in order to foil spammers.} |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 161 | \end{methoddesc} |
| 162 | |
Fred Drake | aae8da1 | 2001-09-11 16:58:00 +0000 | [diff] [blame] | 163 | \begin{methoddesc}{login}{user, password} |
| 164 | Log in on an SMTP server that requires authentication. |
| 165 | The arguments are the username and the password to authenticate with. |
| 166 | If there has been no previous \samp{EHLO} or \samp{HELO} command this |
| 167 | session, this method tries ESMTP \samp{EHLO} first. |
| 168 | This method will return normally if the authentication was successful, |
| 169 | or may raise the following exceptions: |
| 170 | |
| 171 | \begin{description} |
| 172 | \item[\exception{SMTPHeloError}] |
| 173 | The server didn't reply properly to the \samp{HELO} greeting. |
| 174 | \item[\exception{SMTPAuthenticationError}] |
| 175 | The server didn't accept the username/password combination. |
| 176 | \item[\exception{SMTPError}] |
| 177 | No suitable authentication method was found. |
| 178 | \end{description} |
| 179 | \end{methoddesc} |
| 180 | |
Fred Drake | f2a5f3f | 2001-09-14 17:48:41 +0000 | [diff] [blame] | 181 | \begin{methoddesc}{starttls}{\optional{keyfile\optional{, certfile}}} |
| 182 | Put the SMTP connection in TLS (Transport Layer Security) mode. All |
| 183 | SMTP commands that follow will be encrypted. You should then call |
| 184 | \method{ehlo()} again. |
Guido van Rossum | f7fcf5e | 2001-09-14 16:08:44 +0000 | [diff] [blame] | 185 | |
Fred Drake | f2a5f3f | 2001-09-14 17:48:41 +0000 | [diff] [blame] | 186 | If \var{keyfile} and \var{certfile} are provided, these are passed to |
| 187 | the \refmodule{socket} module's \function{ssl()} function. |
Guido van Rossum | f7fcf5e | 2001-09-14 16:08:44 +0000 | [diff] [blame] | 188 | \end{methoddesc} |
| 189 | |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 190 | \begin{methoddesc}{sendmail}{from_addr, to_addrs, msg\optional{, |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 191 | mail_options, rcpt_options}} |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 192 | Send mail. The required arguments are an \rfc{822} from-address |
Georg Brandl | 9020a21 | 2005-06-25 18:24:03 +0000 | [diff] [blame] | 193 | string, a list of \rfc{822} to-address strings (a bare string will be |
| 194 | treated as a list with 1 address), and a message string. The caller |
| 195 | may pass a list of ESMTP options (such as \samp{8bitmime}) to be used |
| 196 | in \samp{MAIL FROM} commands as \var{mail_options}. ESMTP options |
| 197 | (such as \samp{DSN} commands) that should be used with all \samp{RCPT} |
| 198 | commands can be passed as \var{rcpt_options}. (If you need to use |
| 199 | different ESMTP options to different recipients you have to use the |
| 200 | low-level methods such as \method{mail}, \method{rcpt} and |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 201 | \method{data} to send the message.) |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 202 | |
Fred Drake | 0aa811c | 2001-10-20 04:24:09 +0000 | [diff] [blame] | 203 | \note{The \var{from_addr} and \var{to_addrs} parameters are |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 204 | used to construct the message envelope used by the transport agents. |
Fred Drake | 0aa811c | 2001-10-20 04:24:09 +0000 | [diff] [blame] | 205 | The \class{SMTP} does not modify the message headers in any way.} |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 206 | |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 207 | If there has been no previous \samp{EHLO} or \samp{HELO} command this |
| 208 | session, this method tries ESMTP \samp{EHLO} first. If the server does |
| 209 | ESMTP, message size and each of the specified options will be passed |
| 210 | to it (if the option is in the feature set the server advertises). If |
| 211 | \samp{EHLO} fails, \samp{HELO} will be tried and ESMTP options |
| 212 | suppressed. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 213 | |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 214 | This method will return normally if the mail is accepted for at least |
| 215 | one recipient. Otherwise it will throw an exception. That is, if this |
| 216 | method does not throw an exception, then someone should get your mail. |
| 217 | If this method does not throw an exception, it returns a dictionary, |
| 218 | with one entry for each recipient that was refused. Each entry |
| 219 | contains a tuple of the SMTP error code and the accompanying error |
| 220 | message sent by the server. |
| 221 | |
| 222 | This method may raise the following exceptions: |
| 223 | |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 224 | \begin{description} |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 225 | \item[\exception{SMTPRecipientsRefused}] |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 226 | All recipients were refused. Nobody got the mail. The |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 227 | \member{recipients} attribute of the exception object is a dictionary |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 228 | with information about the refused recipients (like the one returned |
| 229 | when at least one recipient was accepted). |
| 230 | |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 231 | \item[\exception{SMTPHeloError}] |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 232 | The server didn't reply properly to the \samp{HELO} greeting. |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 233 | |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 234 | \item[\exception{SMTPSenderRefused}] |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 235 | The server didn't accept the \var{from_addr}. |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 236 | |
Fred Drake | 79936fe | 1999-04-22 17:23:34 +0000 | [diff] [blame] | 237 | \item[\exception{SMTPDataError}] |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 238 | The server replied with an unexpected error code (other than a refusal |
| 239 | of a recipient). |
| 240 | \end{description} |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 241 | |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 242 | Unless otherwise noted, the connection will be open even after |
Guido van Rossum | 7969f31 | 1999-04-07 15:56:51 +0000 | [diff] [blame] | 243 | an exception is raised. |
| 244 | |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 245 | \end{methoddesc} |
| 246 | |
| 247 | \begin{methoddesc}{quit}{} |
| 248 | Terminate the SMTP session and close the connection. |
| 249 | \end{methoddesc} |
| 250 | |
| 251 | Low-level methods corresponding to the standard SMTP/ESMTP commands |
Fred Drake | 3240dd2 | 1998-07-01 14:10:52 +0000 | [diff] [blame] | 252 | \samp{HELP}, \samp{RSET}, \samp{NOOP}, \samp{MAIL}, \samp{RCPT}, and |
| 253 | \samp{DATA} are also supported. Normally these do not need to be |
| 254 | called directly, so they are not documented here. For details, |
| 255 | consult the module code. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 256 | |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 257 | |
Fred Drake | 60c3caf | 1998-08-07 16:03:32 +0000 | [diff] [blame] | 258 | \subsection{SMTP Example \label{SMTP-example}} |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 259 | |
Fred Drake | 7be0cde | 1998-12-22 18:04:48 +0000 | [diff] [blame] | 260 | This example prompts the user for addresses needed in the message |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 261 | envelope (`To' and `From' addresses), and the message to be |
Tim Peters | 9ca3f02 | 2003-06-15 23:08:45 +0000 | [diff] [blame] | 262 | delivered. Note that the headers to be included with the message must |
Fred Drake | 7be0cde | 1998-12-22 18:04:48 +0000 | [diff] [blame] | 263 | be included in the message as entered; this example doesn't do any |
| 264 | processing of the \rfc{822} headers. In particular, the `To' and |
| 265 | `From' addresses must be included in the message headers explicitly. |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 266 | |
| 267 | \begin{verbatim} |
Fred Drake | f6c59e8 | 1998-11-30 15:07:26 +0000 | [diff] [blame] | 268 | import smtplib |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 269 | |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 270 | def prompt(prompt): |
Fred Drake | e9719fe | 2001-05-20 12:26:04 +0000 | [diff] [blame] | 271 | return raw_input(prompt).strip() |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 272 | |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 273 | fromaddr = prompt("From: ") |
Fred Drake | e9719fe | 2001-05-20 12:26:04 +0000 | [diff] [blame] | 274 | toaddrs = prompt("To: ").split() |
Tim Peters | 9ca3f02 | 2003-06-15 23:08:45 +0000 | [diff] [blame] | 275 | print "Enter message, end with ^D (Unix) or ^Z (Windows):" |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 276 | |
| 277 | # Add the From: and To: headers at the start! |
| 278 | msg = ("From: %s\r\nTo: %s\r\n\r\n" |
Raymond Hettinger | 1e80359 | 2003-09-22 06:25:10 +0000 | [diff] [blame] | 279 | % (fromaddr, ", ".join(toaddrs))) |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 280 | while 1: |
Fred Drake | e9719fe | 2001-05-20 12:26:04 +0000 | [diff] [blame] | 281 | try: |
| 282 | line = raw_input() |
| 283 | except EOFError: |
| 284 | break |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 285 | if not line: |
| 286 | break |
| 287 | msg = msg + line |
Fred Drake | 38e5d27 | 2000-04-03 20:13:55 +0000 | [diff] [blame] | 288 | |
Raymond Hettinger | 1e80359 | 2003-09-22 06:25:10 +0000 | [diff] [blame] | 289 | print "Message length is " + repr(len(msg)) |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 290 | |
Fred Drake | f6c59e8 | 1998-11-30 15:07:26 +0000 | [diff] [blame] | 291 | server = smtplib.SMTP('localhost') |
Fred Drake | 5b68362 | 1998-06-30 16:53:52 +0000 | [diff] [blame] | 292 | server.set_debuglevel(1) |
| 293 | server.sendmail(fromaddr, toaddrs, msg) |
| 294 | server.quit() |
Guido van Rossum | 8668e8e | 1998-06-28 17:55:53 +0000 | [diff] [blame] | 295 | \end{verbatim} |