t.w.p.j.c.BasicAuthenticator(xmlstream.ConnectAuthenticator) : class documentation

Part of twisted.words.protocols.jabber.client View Source View In Hierarchy

Authenticates an XmlStream against a Jabber server as a Client.

This only implements non-SASL authentication, per JEP-0078. Additionally, this authenticator provides the ability to perform inline registration, per JEP-0077.

Under normal circumstances, the BasicAuthenticator generates the xmlstream.STREAM_AUTHD_EVENT once the stream has authenticated. However, it can also generate other events, such as:

If authentication fails for any reason, you can attempt to register by calling the registerAccount method. If the registration succeeds, a xmlstream.STREAM_AUTHD_EVENT will be fired. Otherwise, one of the above errors will be generated (again).

Method __init__ Undocumented
Method associateWithStream Called by the XmlStreamFactory when a connection has been made to the requested peer, and an XmlStream object has been instantiated.
Method registerAccount Undocumented
Method _registerResultEvent Undocumented

Inherited from ConnectAuthenticator:

Method connectionMade Called by the XmlStream when the underlying socket connection is in place.
Method initializeStream Perform stream initialization procedures.
Method streamStarted Called by the XmlStream when the stream has started.

Inherited from Authenticator (via ConnectAuthenticator):

Instance Variable xmlstream The XmlStream that needs authentication (type: XmlStream)
def __init__(self, jid, password): (source)
Undocumented
def associateWithStream(self, xs): (source)
Called by the XmlStreamFactory when a connection has been made to the requested peer, and an XmlStream object has been instantiated.

The default implementation just saves a handle to the new XmlStream.

ParametersxmlstreamThe XmlStream that will be passing events to this Authenticator. (type: XmlStream)
def registerAccount(self, username=None, password=None): (source)
Undocumented
def _registerResultEvent(self, iq): (source)
Undocumented
API Documentation for Twisted, generated by pydoctor at 2012-09-01 11:44:56.