interface documentation

The realm connects application-specific objects to the authentication system.

Method requestAvatar Return avatar which provides one of the given interfaces.
def requestAvatar(avatarId: Union[bytes, Tuple[]], mind: object, *interfaces: _InterfaceItself) -> Union[Deferred[_requestResult], _requestResult]: (source)

Return avatar which provides one of the given interfaces.

Parameters
avatarId:Union[bytes, Tuple[]]a string that identifies an avatar, as returned by ICredentialsChecker.requestAvatarId (via a Deferred). Alternatively, it may be twisted.cred.checkers.ANONYMOUS.
mind:objectusually None. See the description of mind in Portal.login.
*interfaces:_InterfaceItselfthe interface(s) the returned avatar should implement, e.g. IMailAccount. See the description of Portal.login.
Returns
Union[Deferred[_requestResult], _requestResult]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.