mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

Added descriptions of the various exceptions, based on the docstrings.

Browse source 
Various small cleanups.
This commit is contained in:
Fred Drake 1999-04-22 17:23:34 +00:00
parent c8993aad10
commit 79936fe73f
1 changed files with 65 additions and 24 deletions
Download patch file Download diff file Expand all files Collapse all files

87
Doc/lib/libsmtplib.tex
View file

@ -1,9 +1,9 @@
\section{\module{smtplib} --- \section{\module{smtplib} ---
SMTP protocol client.} SMTP protocol client}
\declaremodule{standard}{smtplib}
\sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com}
\declaremodule{standard}{smtplib}
\modulesynopsis{SMTP protocol client (requires sockets).} \modulesynopsis{SMTP protocol client (requires sockets).}
\sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com}
\indexii{SMTP}{protocol} \indexii{SMTP}{protocol}
\index{Simple Mail Transfer Protocol} \index{Simple Mail Transfer Protocol}
@ -28,8 +28,53 @@ included below.
\end{classdesc} \end{classdesc}
\subsection{SMTP Objects} A nice selection of exceptions is defined as well:
\label{SMTP-objects}
\begin{excdesc}{SMTPException}
Base exception class for all exceptions raised by this module.
\end{excdesc}
\begin{excdesc}{SMTPServerDisconnected}
This exception is raised when the server unexpectedly disconnects,
or when an attempt is made to use the \class{SMTP} instance before
connecting it to a server.
\end{excdesc}
\begin{excdesc}{SMTPResponseException}
Base class for all exceptions that include an SMTP error code.
These exceptions are generated in some instances when the SMTP
server returns an error code. The error code is stored in the
\member{smtp_code} attribute of the error, and the
\member{smtp_error} attribute is set to the error message.
\end{excdesc}
\begin{excdesc}{SMTPSenderRefused}
Sender address refused. In addition to the attributes set by on all
\exception{SMTPResponseException} exceptions, this sets `sender' to
the string that the SMTP server refused.
\end{excdesc}
\begin{excdesc}{SMTPRecipientsRefused}
All recipient addresses refused. The errors for each recipient are
accessable through the attribute \member{recipients}, which is a
dictionary of exactly the same sort as \method{SMTP.sendmail()}
returns.
\end{excdesc}
\begin{excdesc}{SMTPDataError}
The SMTP server refused to accept the message data.
\end{excdesc}
\begin{excdesc}{SMTPConnectError}
Error occurred during establishment of a connection with the server.
\end{excdesc}
\begin{excdesc}{SMTPHeloError}
The server refused our \samp{HELO} message.
\end{excdesc}
\subsection{SMTP Objects \label{SMTP-objects}}
An \class{SMTP} instance has the following methods: An \class{SMTP} instance has the following methods:
@ -64,8 +109,8 @@ In normal operation it should not be necessary to call this method
explicitly. It is used to implement other methods and may be useful explicitly. It is used to implement other methods and may be useful
for testing private extensions. for testing private extensions.
If the connection to the server is lost while waiting for the reply an If the connection to the server is lost while waiting for the reply,
\exception{SMTPServerDisconnected} exception will be raised. \exception{SMTPServerDisconnected} will be raised.
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}{helo}{\optional{hostname}} \begin{methoddesc}{helo}{\optional{hostname}}
@ -90,8 +135,8 @@ will be implicitly called by \method{sendmail()} when necessary.
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}{has_extn}{name} \begin{methoddesc}{has_extn}{name}
Return \code{1} if \var{name} is in the set of SMTP service extensions returned Return \code{1} if \var{name} is in the set of SMTP service extensions
by the server, \code{0} otherwise. Case is ignored. returned by the server, \code{0} otherwise. Case is ignored.
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}{verify}{address} \begin{methoddesc}{verify}{address}
@ -133,29 +178,23 @@ message sent by the server.
This method may raise the following exceptions: This method may raise the following exceptions:
\begin{itemize} \begin{itemize}
\item[\exception{SMTPRecipientsRefused}]
\item \exception{SMTPRecipientsRefused}
All recipients were refused. Nobody got the mail. The All recipients were refused. Nobody got the mail. The
\var{recipients} attribute of the exception object is a dictionary \var{recipients} attribute of the exception object is a dictionary
with information about the refused recipients (like the one returned with information about the refused recipients (like the one returned
when at least one recipient was accepted). when at least one recipient was accepted).
\item \exception{SMTPHeloError} \item[\exception{SMTPHeloError}]
The server didn't reply properly to The server didn't reply properly to
the helo greeting. the helo greeting.
\item \exception{SMTPSenderRefused} \item[\exception{SMTPSenderRefused}]
The server didn't accept the from_addr. The server didn't accept the from_addr.
\item \exception{SMTPDataError} \item[\exception{SMTPDataError}]
The server replied with an unexpected The server replied with an unexpected
error code (other than a refusal of error code (other than a refusal of
a recipient). a recipient).
\end{itemize} \end{itemize}
Unless otherwise noted the connection will be open even after Unless otherwise noted the connection will be open even after
@ -210,9 +249,11 @@ server.quit()
\begin{seealso} \begin{seealso}
\seetext{\rfc{821}, \emph{Simple Mail Transfer Protocol}. Available \seetext{Internet \rfc{821}, \emph{Simple Mail Transfer Protocol}.
online at \url{http://info.internet.isi.edu/in-notes/rfc/files/rfc821.txt}.} Available online at
\url{http://info.internet.isi.edu/in-notes/rfc/files/rfc821.txt}.}
\seetext{\rfc{1869}, \emph{SMTP Service Extensions}. Available online \seetext{Internet \rfc{1869}, \emph{SMTP Service Extensions}.
at \url{http://info.internet.isi.edu/in-notes/rfc/files/rfc1869.txt}.} Available online at
\url{http://info.internet.isi.edu/in-notes/rfc/files/rfc1869.txt}.}
\end{seealso} \end{seealso}