twisted.application.internet.ClientService : API documentation

Method	__init__
Method	whenConnected	Retrieve the currently-connected `Protocol`, or the next one to connect.
Method	startService	Start this `ClientService`, initiating the connection retry loop.
Method	stopService	Stop attempting to reconnect and close any existing connections.

Inherited from Service:

Method	__getstate__	Undocumented
Method	setName	Set the name of the service.
Method	setServiceParent	Set the parent of the service. This method is responsible for setting the `parent` attribute on this service (the child service).
Method	disownServiceParent	Use this API to remove an `IService` from an `IServiceCollection`.
Method	privilegedStartService	Do preparation work for starting the service.

def __init__(self, endpoint, factory, retryPolicy=None, clock=None): (source)

Parameters	endpoint	A `stream client endpoint` provider which will be used to connect when the service starts.
	factory	A `protocol factory` which will be used to create clients for the endpoint.
	retryPolicy	A policy configuring how long `ClientService` will wait between attempts to connect to `endpoint`. (type: callable taking (the number of failed connection attempts made in a row (`int`)) and returning the number of seconds to wait before making another attempt.)
	clock	The clock used to schedule reconnection. It's mainly useful to be parametrized in tests. If the factory is serialized, this attribute will not be serialized, and the default value (the reactor) will be restored when deserialized. (type: `IReactorTime`)

def whenConnected(self, failAfterFailures=None): (source)

Retrieve the currently-connected Protocol, or the next one to connect.

Parameters	failAfterFailures	number of connection failures after which the Deferred will deliver a Failure (None means the Deferred will only fail if/when the service is stopped). Set this to 1 to make the very first connection failure signal an error. Use 2 to allow one failure but signal an error if the subsequent retry then fails. (type: `int` or None)
Returns	a Deferred that fires with a protocol produced by the factory passed to `__init__` (type: `Deferred` that may: fire with `IProtocol` fail with `CancelledError` when the service is stopped fail with e.g. `DNSLookupError` or `ConnectionRefusedError` when the number of consecutive failed connection attempts equals the value of "failAfterFailures" )

def startService(self): (source)

Start this ClientService, initiating the connection retry loop.

def stopService(self): (source)

Stop attempting to reconnect and close any existing connections.

Returns a Deferred that fires when all outstanding connections are closed and all in-progress connection attempts halted.

twisted.application.internet.ClientService(service.Service, object) class documentation