Perspective Broker

"This isn't a professional opinion, but it's probably got enough internet to kill you." --glyph

Introduction

This is a broker for proxies for and copies of objects. It provides a translucent interface layer to those proxies.

The protocol is not opaque, because it provides objects which represent the remote proxies and require no context (server references, IDs) to operate on.

It is not transparent because it does not attempt to make remote objects behave identically, or even similiarly, to local objects. Method calls are invoked asynchronously, and specific rules are applied when serializing arguments.

To get started, begin with PBClientFactory and PBServerFactory.

Author

Glyph Lefkowitz

Class	Serializable	An object that can be passed remotely.
Class	Referenceable	No class docstring; 2/2 methods documented
Class	NoSuchMethod	Raised if there is no such remote method
Class	Root	I provide a root object to pb.Brokers for a pb.BrokerFactory.
Interface	IPBRoot	Factory for root Referenceable objects for PB servers.
Class	ViewPoint	I act as an indirect reference to an object accessed through a pb.Perspective.
Class	Viewable	I will be converted to a ViewPoint when passed to or returned from a remote method.
Class	Copyable	Subclass me to get copied each time you are returned from or passed to a remote method.
Class	Cacheable	A cached instance.
Class	RemoteCopy	I am a remote copy of a Copyable object.
Class	RemoteCache	A cache is a local representation of a remote Cacheable object.
Class	RemoteCacheObserver	I am a reverse-reference to the peer's RemoteCache.
Class	ProtocolError	This error is raised when an invalid protocol statement is received.
Class	DeadReferenceError	This error is raised when a method is called on a dead reference (one whose broker has been disconnected).
Class	Error	This error can be raised to generate known error conditions.
Class	RemoteMethod	This is a translucent reference to a remote message.
Function	noOperation	Do nothing.
Class	PBConnectionLost	Undocumented
Function	printTraceback	Print a traceback (string) to the standard log.
Interface	IPerspective	per*spec*tive, n. : The relationship of aspects of a subject to each other and to a whole: 'a perspective of history'; 'a need to view the problem in the proper perspective'.
Class	Avatar	A default IPerspective implementor.
Class	AsReferenceable	A reference directed towards another object.
Class	RemoteReference	A translucent reference to a remote object.
Class	Local	(internal) A reference to a local object.
Class	CopyableFailure	A flavors.RemoteCopy and flavors.Copyable version of twisted.python.failure.Failure for serialization.
Class	CopiedFailure	Undocumented
Function	failure2Copyable	Undocumented
Class	Broker	I am a broker for objects.
Function	respond	Respond to a challenge.
Function	challenge	I return some random data.
Class	PBClientFactory	Client factory for PB brokers.
Class	PBServerFactory	Server factory for perspective broker.
Interface	IUsernameMD5Password	I encapsulate a username and a hashed password.
Class	_PortalRoot	Root object, used to login to portal.
Class	_JellyableAvatarMixin	Helper class for code which deals with avatars which PB must be capable of sending to a peer.
Class	_PortalWrapper	Root Referenceable object, used to login to portal.
Class	_PortalAuthChallenger	Called with response to password challenge.