twisted.words.service.WordsRealm : API documentation

Method	__init__	Undocumented
Method	userFactory	Undocumented
Method	groupFactory	Undocumented
Method	logoutFactory	Undocumented
Method	requestAvatar	Return avatar which provides one of the given interfaces.
Method	lookupUser	Undocumented
Method	lookupGroup	Retrieve a group by name.
Method	addUser	Add the given user to this service.
Method	addGroup	Add the given group to this service.
Method	getGroup	Retrieve the group by the given name.
Method	getUser	Retrieve the user by the given name.
Method	createUser	Create a new user with the given name.
Method	createGroup	Create a new group with the given name.

def __init__(self, name): (source)

overridden in twisted.words.service.InMemoryWordsRealm

Undocumented

def userFactory(self, name): (source)

Undocumented

def groupFactory(self, name): (source)

Undocumented

def logoutFactory(self, avatar, facet): (source)

Undocumented

def requestAvatar(self, avatarId, mind, *interfaces): (source)

from twisted.cred.portal.IRealm

Return avatar which provides one of the given interfaces.

Parameters	avatarId	a string that identifies an avatar, as returned by `ICredentialsChecker.requestAvatarId` (via a Deferred). Alternatively, it may be `twisted.cred.checkers.ANONYMOUS`.
	mind	usually None. See the description of mind in `Portal.login`.
	interfaces	the interface(s) the returned avatar should implement, e.g. `IMailAccount`. See the description of `Portal.login`.
Returns	a deferred which will fire a tuple of (interface, avatarAspect, logout), or the tuple itself. The interface will be one of the interfaces passed in the 'interfaces' argument. The 'avatarAspect' will implement that interface. The 'logout' object is a callable which will detach the mind from the avatar.

def lookupUser(self, name): (source)

overridden in twisted.words.service.InMemoryWordsRealm

Undocumented

def lookupGroup(self, group): (source)

from twisted.words.iwords.IChatService

overridden in twisted.words.service.InMemoryWordsRealm

Retrieve a group by name.

Unlike getGroup, this will never implicitly create a group.

Returns A Deferred which fires with the group by the given name, or which fails with twisted.words.ewords.NoSuchGroup. (type: twisted.internet.defer.Deferred)

def addUser(self, user): (source)

overridden in twisted.words.service.InMemoryWordsRealm

Add the given user to this service.

This is an internal method intented to be overridden by WordsRealm subclasses, not called by external code.

Returns A Deferred which fires with None when the user is added, or which fails with twisted.words.ewords.DuplicateUser if a user with the same name exists already. (type: twisted.internet.defer.Deferred)

def addGroup(self, group): (source)

overridden in twisted.words.service.InMemoryWordsRealm

Add the given group to this service.

Returns A Deferred which fires with None when the group is added, or which fails with twisted.words.ewords.DuplicateGroup if a group with the same name exists already. (type: twisted.internet.defer.Deferred)

def getGroup(self, name): (source)

from twisted.words.iwords.IChatService

Retrieve the group by the given name.

Returns A Deferred which fires with the group with the given name if one exists (or if one is created due to the setting of createGroupOnRequest, or which fails with twisted.words.ewords.NoSuchGroup if no such group exists. (type: twisted.internet.defer.Deferred)

def getUser(self, name): (source)

from twisted.words.iwords.IChatService

Retrieve the user by the given name.

Returns A Deferred which fires with the user with the given name if one exists (or if one is created due to the setting of createUserOnRequest, or which fails with twisted.words.ewords.NoSuchUser if no such user exists. (type: twisted.internet.defer.Deferred)

def createUser(self, name): (source)

from twisted.words.iwords.IChatService

Create a new user with the given name.

Returns A Deferred which fires with the created user, or with fails with twisted.words.ewords.DuplicateUser if a user by that name exists already. (type: twisted.internet.defer.Deferred)

def createGroup(self, name): (source)

from twisted.words.iwords.IChatService

Create a new group with the given name.

Returns A Deferred which fires with the created group, or with fails with twisted.words.ewords.DuplicateGroup if a group by that name exists already. (type: twisted.internet.defer.Deferred)

t.w.s.WordsRealm(object) : class documentation