twisted.spread.pb.PBClientFactory : API documentation

Method	__init__
Method	buildProtocol	Build the broker instance, passing the security options to it.
Method	clientConnectionFailed	Called when a connection has failed to connect.
Method	clientConnectionLost	Reconnecting subclasses should call with reconnecting=1.
Method	clientConnectionMade	Undocumented
Method	getRootObject	Get root object of remote PB server.
Method	disconnect	If the factory is connected, close the connection.
Method	login	Login and get perspective from remote PB server.
Method	_reset	Undocumented
Method	_failAll	Undocumented
Method	_cbSendUsername	Undocumented
Method	_cbResponse	Undocumented
Method	_cbLoginAnonymous	Attempt an anonymous login on the given remote root object.

Inherited from Factory (via ClientFactory):

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.

Inherited from Factory (via ClientFactory):

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.

def __init__(self, unsafeTracebacks=False, security=globalSecurity): (source)

Parameters	unsafeTracebacks	if set, tracebacks for exceptions will be sent over the wire. (type: `bool`)
	security	security options used by the broker, default to `globalSecurity`. (type: `twisted.spread.jelly.SecurityOptions`)

def buildProtocol(self, addr): (source)

from twisted.internet.interfaces.IProtocolFactory

overrides twisted.internet.protocol.Factory.buildProtocol

Build the broker instance, passing the security options to it.

def _reset(self): (source)

Undocumented

def _failAll(self, reason): (source)

Undocumented

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

overrides twisted.internet.protocol.ClientFactory.clientConnectionFailed

Called when a connection has failed to connect.

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

def clientConnectionLost(self, connector, reason, reconnecting=0): (source)

overrides twisted.internet.protocol.ClientFactory.clientConnectionLost

Reconnecting subclasses should call with reconnecting=1.

def clientConnectionMade(self, broker): (source)

Undocumented

def getRootObject(self): (source)

Get root object of remote PB server.

Returns Deferred of the root object.

def disconnect(self): (source)

If the factory is connected, close the connection.

Note that if you set up the factory to reconnect, you will need to implement extra logic to prevent automatic reconnection after this is called.

def _cbSendUsername(self, root, username, password, client): (source)

Undocumented

def _cbResponse(self, (challenge, challenger), password, client): (source)

Undocumented

def _cbLoginAnonymous(self, root, client): (source)

Attempt an anonymous login on the given remote root object.

Parameters	root	The object on which to attempt the login, most likely returned by a call to `PBClientFactory.getRootObject`. (type: `RemoteReference`)
	client	A jellyable object which will be used as the mind parameter for the login attempt.
Returns	A `Deferred` which will be called back with a `RemoteReference` to an avatar when anonymous login succeeds, or which will errback if anonymous login fails. (type: `Deferred`)

def login(self, credentials, client=None): (source)

Currently the following credentials are supported:

   L{twisted.cred.credentials.IUsernamePassword}
   L{twisted.cred.credentials.IAnonymous}

Returns A Deferred which will be called back with a RemoteReference for the avatar logged in to, or which will errback if login fails. (type: Deferred)

twisted.spread.pb.PBClientFactory(protocol.ClientFactory) class documentation

`twisted.spread.pb.PBClientFactory(protocol.ClientFactory)` class documentation