twisted.mail.smtp.ESMTPClient : API documentation

Known subclasses: twisted.mail.relay.ESMTPRelayer, twisted.mail.smtp.ESMTPSender

A client for sending emails over ESMTP.

Instance Variable	heloFallback	Whether or not to fall back to plain SMTP if the `EHLO` command is not recognised by the server. If `requireAuthentication` is `True`, or `requireTransportSecurity` is `True` and the connection is not over TLS, this fallback flag will not be honored. (type: `bool`)
Instance Variable	requireAuthentication	If `True`, refuse to proceed if authentication cannot be performed. Overrides `heloFallback`. (type: `bool`)
Instance Variable	requireTransportSecurity	If `True`, refuse to proceed if the transport cannot be secured. If the transport layer is not already secured via TLS, this will override `heloFallback`.
Instance Variable	context	The context factory to use for STARTTLS, if desired. (type: `ssl.ClientContextFactory`)
Method	__init__	Undocumented
Method	__getattr__	Undocumented
Method	__setattr__	Undocumented
Method	esmtpEHLORequired	Fail because authentication is required, but the server does not support ESMTP, which is required for authentication.
Method	esmtpAUTHRequired	Fail because authentication is required, but the server does not support any schemes we support.
Method	esmtpTLSRequired	Fail because TLS is required and the server does not support it.
Method	esmtpTLSFailed	Fail because the TLS handshake wasn't able to be completed.
Method	esmtpAUTHDeclined	Fail because the authentication was rejected.
Method	esmtpAUTHMalformedChallenge	Fail because the server sent a malformed authentication challenge.
Method	esmtpAUTHServerError	Fail because of some other authentication error.
Method	registerAuthenticator	No summary
Method	connectionMade	Called when a connection has been made, and triggers sending an `EHLO` to the server.
Method	esmtpState_ehlo	Send an `EHLO` to the server.
Method	esmtpState_serverConfig	Handle a positive response to the EHLO command by parsing the capabilities in the server's response and then taking the most appropriate next step towards entering a mail transaction.
Method	tryTLS	Take a necessary step towards being able to begin a mail transaction.
Method	esmtpState_starttls	Handle a positive response to the STARTTLS command by starting a new TLS session on `self.transport`.
Method	authenticate	Undocumented
Method	esmtpState_challenge	Undocumented
Method	smtpState_maybeAuthenticated	Called to handle the next message from the server after sending a response to a SASL challenge. The server response might be another challenge or it might indicate authentication has succeeded.
Instance Variable	_tlsMode	Whether or not the connection is over TLS. (type: `bool`)
Method	_esmtpState_plainAuth	Undocumented
Method	_authResponse	Undocumented

Inherited from SMTPClient:

Method	sendLine	Sends a line to the other end of the connection.
Method	connectionLost	We are no longer connected
Method	timeoutConnection	Called when the connection times out.
Method	lineReceived	Override this for when each line is received.
Method	smtpConnectionFailed	Undocumented
Method	smtpTransferFailed	Undocumented
Method	smtpState_helo	Undocumented
Method	smtpState_from	Undocumented
Method	smtpState_disconnect	Undocumented
Method	smtpState_to	Undocumented
Method	smtpState_toOrData	Undocumented
Method	smtpState_data	Undocumented
Method	smtpState_msgSent	Undocumented
Method	transformChunk	Perform the necessary local to network newline conversion and escape leading periods.
Method	finishedFileTransfer	Undocumented
Method	getMailFrom	Return the email address the mail is from.
Method	getMailTo	Return a list of emails to send to.
Method	getMailData	Return file-like object containing data of message to be sent.
Method	sendError	If an error occurs before a mail message is sent sendError will be called. This base class method sends a QUIT if the error is non-fatal and disconnects the connection.
Method	sentMail	Called when an attempt to send an email is completed.
Method	_disconnectFromServer	Undocumented

Inherited from LineReceiver (via SMTPClient):

Class Variable	delimiter	The line-ending delimiter to use. By default this is `b'\r\n'`.
Class Variable	MAX_LENGTH	The maximum length of a line to allow (If a sent line is longer than this, the connection is dropped). Default is 16384.
Method	clearLineBuffer	Clear buffered data.
Method	dataReceived	Protocol.dataReceived. Translates bytes into lines, and calls lineReceived (or rawDataReceived, depending on mode.)
Method	setLineMode	Sets the line-mode of this receiver.
Method	setRawMode	Sets the raw mode of this receiver. Further data received will be sent to rawDataReceived rather than lineReceived.
Method	rawDataReceived	Override this for when raw data is received.
Method	lineLengthExceeded	Called when the maximum line length has been reached. Override if it needs to be dealt with in some special way.

Inherited from Protocol (via SMTPClient, LineReceiver):

Method

logPrefix

Return a prefix matching the class name, to identify log messages related to this protocol instance.

Inherited from BaseProtocol (via SMTPClient, LineReceiver, Protocol):

Method

makeConnection

Make a connection to a transport and a server.

Inherited from _PauseableMixin (via SMTPClient, LineReceiver):

Method	pauseProducing	Undocumented
Method	resumeProducing	Undocumented
Method	stopProducing	Undocumented

Inherited from TimeoutMixin (via SMTPClient):

Class Variable	timeOut	The number of seconds after which to timeout the connection.
Method	callLater	Wrapper around `reactor.callLater` for test purpose.
Method	resetTimeout	Reset the timeout count down.
Method	setTimeout	Change the timeout period
Method	__timedOut	Undocumented

heloFallback =

Whether or not to fall back to plain SMTP if the EHLO command is not recognised by the server. If requireAuthentication is True, or requireTransportSecurity is True and the connection is not over TLS, this fallback flag will not be honored. (type: bool)

requireAuthentication =

If True, refuse to proceed if authentication cannot be performed. Overrides heloFallback. (type: bool)

requireTransportSecurity =

If True, refuse to proceed if the transport cannot be secured. If the transport layer is not already secured via TLS, this will override heloFallback.

context =

The context factory to use for STARTTLS, if desired. (type: ssl.ClientContextFactory)

_tlsMode =

Whether or not the connection is over TLS. (type: bool)

def __init__(self, secret, *args, contextFactory=None, **kw): (source)

overrides twisted.mail.smtp.SMTPClient.__init__

overridden in twisted.mail.relay.ESMTPRelayer, twisted.mail.smtp.ESMTPSender

Undocumented

def __getattr__(self, name): (source)

Undocumented

def __setattr__(self, name, value): (source)

Undocumented

def esmtpEHLORequired(self, code=-1, resp=None): (source)

Fail because authentication is required, but the server does not support ESMTP, which is required for authentication.

Parameters	code	The server status code from the most recently received server message. (type: `int`)
	resp	The server status response from the most recently received server message. (type: `bytes`)

def esmtpAUTHRequired(self, code=-1, resp=None): (source)

Fail because authentication is required, but the server does not support any schemes we support.

Parameters	code	The server status code from the most recently received server message. (type: `int`)
	resp	The server status response from the most recently received server message. (type: `bytes`)

def esmtpTLSRequired(self, code=-1, resp=None): (source)

Fail because TLS is required and the server does not support it.

Parameters	code	The server status code from the most recently received server message. (type: `int`)
	resp	The server status response from the most recently received server message. (type: `bytes`)

def esmtpTLSFailed(self, code=-1, resp=None): (source)

Fail because the TLS handshake wasn't able to be completed.

Parameters	code	The server status code from the most recently received server message. (type: `int`)
	resp	The server status response from the most recently received server message. (type: `bytes`)

def esmtpAUTHDeclined(self, code=-1, resp=None): (source)

Fail because the authentication was rejected.

Parameters	code	The server status code from the most recently received server message. (type: `int`)
	resp	The server status response from the most recently received server message. (type: `bytes`)

def esmtpAUTHMalformedChallenge(self, code=-1, resp=None): (source)

Fail because the server sent a malformed authentication challenge.

Parameters	code	The server status code from the most recently received server message. (type: `int`)
	resp	The server status response from the most recently received server message. (type: `bytes`)

def esmtpAUTHServerError(self, code=-1, resp=None): (source)

Fail because of some other authentication error.

Parameters	code	The server status code from the most recently received server message. (type: `int`)
	resp	The server status response from the most recently received server message. (type: `bytes`)

def registerAuthenticator(self, auth): (source)

Registers an Authenticator with the ESMTPClient. The ESMTPClient will attempt to login to the SMTP Server in the order the Authenticators are registered. The most secure Authentication mechanism should be registered first.

Parameters	auth	The Authentication mechanism to register (type: `IClientAuthentication` implementor)
Returns	`None`

def connectionMade(self): (source)

from twisted.internet.interfaces.IProtocol

overrides twisted.mail.smtp.SMTPClient.connectionMade

Called when a connection has been made, and triggers sending an EHLO to the server.

def esmtpState_ehlo(self, code, resp): (source)

Send an EHLO to the server.

If heloFallback is True, and there is no requirement for TLS or authentication, the client will fall back to basic SMTP.

Parameters	code	The server status code from the most recently received server message. (type: `int`)
	resp	The server status response from the most recently received server message. (type: `bytes`)
Returns	`None`

def esmtpState_serverConfig(self, code, resp): (source)

Handle a positive response to the EHLO command by parsing the capabilities in the server's response and then taking the most appropriate next step towards entering a mail transaction.

def tryTLS(self, code, resp, items): (source)

Take a necessary step towards being able to begin a mail transaction.

The step may be to ask the server to being a TLS session. If TLS is already in use or not necessary and not available then the step may be to authenticate with the server. If TLS is necessary and not available, fail the mail transmission attempt.

This is an internal helper method.

Parameters	code	The server status code from the most recently received server message. (type: `int`)
	resp	The server status response from the most recently received server message. (type: `bytes`)
	items	A mapping of ESMTP extensions offered by the server. Keys are extension identifiers and values are the associated values. (type: `dict` mapping `bytes` to `bytes`)
Returns	`None`

def esmtpState_starttls(self, code, resp): (source)

Handle a positive response to the STARTTLS command by starting a new TLS session on self.transport.

Upon success, re-handshake with the server to discover what capabilities it has when TLS is in use.

def authenticate(self, code, resp, items): (source)

Undocumented

def _esmtpState_plainAuth(self, code, resp): (source)

Undocumented

def esmtpState_challenge(self, code, resp): (source)

Undocumented

def _authResponse(self, auth, challenge): (source)

Undocumented

def smtpState_maybeAuthenticated(self, code, resp): (source)

Called to handle the next message from the server after sending a response to a SASL challenge. The server response might be another challenge or it might indicate authentication has succeeded.

API Documentation for Twisted, generated by pydoctor at 2017-09-23 19:45:03.

twisted.mail.smtp.ESMTPClient(SMTPClient) class documentation

`twisted.mail.smtp.ESMTPClient(SMTPClient)` class documentation