Wrap a factory in order to wrap the protocols it builds.

Method __init__
Method startedConnecting A connection attempt was started. Remember the connector which started said attempt, for use later.
Method doStart Start notifications are passed straight through to the wrapped factory.
Method doStop Stop notifications are passed straight through to the wrapped factory.
Method buildProtocol Proxy buildProtocol to our self._wrappedFactory or errback the self._onConnection Deferred if the wrapped factory raises an exception or returns None.
Method clientConnectionFailed Errback the self._onConnection Deferred when the client connection fails.
Instance Variable _wrappedFactory A provider of IProtocolFactory whose buildProtocol method will be called and whose resulting protocol will be wrapped.
Instance Variable _onConnection A Deferred that fires when the protocol is connected
Instance Variable _connector A connector that is managing the current or previous connection attempt.
Method _canceller The outgoing connection attempt was cancelled. Fail that Deferred with an error.ConnectingCancelledError.

Inherited from ClientFactory:

Method clientConnectionLost Called when an established connection is lost.

Inherited from Factory (via ClientFactory):

Class Method forProtocol Create a factory for the given protocol.
Method logPrefix Describe this factory for log messages.
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.
_wrappedFactory =
A provider of IProtocolFactory whose buildProtocol method will be called and whose resulting protocol will be wrapped.
_onConnection =
A Deferred that fires when the protocol is connected
_connector =
A connector that is managing the current or previous connection attempt.
def __init__(self, wrappedFactory): (source)
ParameterswrappedFactoryA provider of IProtocolFactory whose buildProtocol method will be called and whose resulting protocol will be wrapped.
def startedConnecting(self, connector): (source)

A connection attempt was started. Remember the connector which started said attempt, for use later.

def _canceller(self, deferred): (source)

The outgoing connection attempt was cancelled. Fail that Deferred with an error.ConnectingCancelledError.

ParametersdeferredThe Deferred that was cancelled; should be the same as self._onConnection. (type: Deferred)
ReturnsNone
NoteThis relies on startedConnecting having been called, so it may seem as though there's a race condition where _connector may not have been set. However, using public APIs, this condition is impossible to catch, because a connection API (connectTCP/SSL/UNIX) is always invoked before a _WrappingFactory's Deferred is returned to connect()'s caller.
def doStart(self): (source)

Start notifications are passed straight through to the wrapped factory.

def doStop(self): (source)

Stop notifications are passed straight through to the wrapped factory.

def buildProtocol(self, addr): (source)

Proxy buildProtocol to our self._wrappedFactory or errback the self._onConnection Deferred if the wrapped factory raises an exception or returns None.

ReturnsAn instance of _WrappingProtocol or None
def clientConnectionFailed(self, connector, reason): (source)

Errback the self._onConnection Deferred when the client connection fails.

API Documentation for Twisted, generated by pydoctor at 2018-10-15 19:29:43.