class documentation

class twisted.mail.smtp.SMTPSenderFactory(protocol.ClientFactory): (source)

Known subclasses: twisted.mail.smtp.ESMTPSenderFactory

View In Hierarchy

Utility factory for sending emails easily.

Instance Variable currentProtocol The current running protocol returned by buildProtocol.
Instance Variable sendFinished When the value is set to True, it means the message has been sent or there has been an unrecoverable error or the sending has been cancelled. The default value is False.
Method __init__
Instance Variable fromEmail Undocumented
Instance Variable nEmails Undocumented
Instance Variable toEmail Undocumented
Instance Variable file Undocumented
Instance Variable result Undocumented
Instance Variable retries Undocumented
Instance Variable timeout Undocumented
Method clientConnectionFailed Called when a connection has failed to connect.
Method clientConnectionLost Called when an established connection is lost.
Method buildProtocol Create an instance of a subclass of Protocol.
Method _removeDeferred Undocumented
Method _processConnectionError Undocumented
Method _removeProtocol Remove the protocol created in buildProtocol.

Inherited from ClientFactory:

Method startedConnecting Called when a connection has been started.

Inherited from Factory (via ClientFactory):

Class Variable protocol Undocumented
Instance Variable numPorts Undocumented
Class Variable noisy Undocumented
Class Method forProtocol Create a factory for the given protocol.
Method logPrefix Describe this factory for log messages.
Method doStart Make sure startFactory is called.
Method doStop Make sure stopFactory is called.
Method startFactory This will be called before I begin listening on a Port or Connector.
Method stopFactory This will be called before I stop listening on all Ports/Connectors.
currentProtocol = (source)
The current running protocol returned by buildProtocol.
(type: SMTPSender)
sendFinished = (source)
When the value is set to True, it means the message has been sent or there has been an unrecoverable error or the sending has been cancelled. The default value is False.
(type: bool)
def __init__(self, fromEmail, toEmail, file, deferred, retries=5, timeout=None): (source)
ParametersfromEmailThe RFC 2821 address from which to send this message.
toEmailA sequence of RFC 2821 addresses to which to send this message.
fileA file-like object containing the message to send.
deferredA Deferred to callback or errback when sending of this message completes. (type: defer.Deferred)
retriesThe number of times to retry delivery of this message.
timeoutPeriod, in seconds, for which to wait for server responses, or None to wait forever.
fromEmail = (source)

Undocumented

nEmails = (source)

Undocumented

toEmail = (source)

Undocumented

file = (source)

Undocumented

result = (source)

Undocumented

retries = (source)

Undocumented

timeout = (source)

Undocumented

def _removeDeferred(self, result): (source)

Undocumented

def clientConnectionFailed(self, connector, err): (source)

Called when a connection has failed to connect.

It may be useful to call connector.connect() - this will reconnect.

ParametersconnectorUndocumented
errUndocumented
reasonUndocumented (type: twisted.python.failure.Failure)
def clientConnectionLost(self, connector, err): (source)

Called when an established connection is lost.

It may be useful to call connector.connect() - this will reconnect.

ParametersconnectorUndocumented
errUndocumented
reasonUndocumented (type: twisted.python.failure.Failure)
def _processConnectionError(self, connector, err): (source)

Undocumented

def buildProtocol(self, addr): (source)

Create an instance of a subclass of Protocol.

The returned instance will handle input on an incoming server connection, and an attribute "factory" pointing to the creating factory.

Alternatively, None may be returned to immediately close the new connection.

Override this method to alter how Protocol instances get created.

Parametersaddran object implementing twisted.internet.interfaces.IAddress
def _removeProtocol(self, result): (source)

Remove the protocol created in buildProtocol.

ParametersresultThe result/error passed to the callback/errback of defer.Deferred.
ReturnsThe result untouched.
API Documentation for Twisted, generated by pydoctor 20.12.1 at 2021-02-28 19:53:36.