U  W[ã@sxdZddlmZmZGdd„deƒZGdd„deƒZGdd„deƒZGd d „d eƒZGd d „d eƒZGd d„deƒZ dS)z Public Jabber Interfaces. é)Ú AttributeÚ Interfacec@seZdZdZdS)Ú IInitializerz¡ Interface for XML stream initializers. Initializers perform a step in getting the XML stream ready to be used for the exchange of XML stanzas. N)Ú__name__Ú __module__Ú __qualname__Ú__doc__©r r úH/usr/lib/python3/dist-packages/twisted/words/protocols/jabber/ijabber.pyr src@s eZdZdZedƒZdd„ZdS)ÚIInitiatingInitializerzJ Interface for XML stream initializers for the initiating entity. zThe associated XML streamcCsdS)z‚ Initiate the initialization step. May return a deferred when the initialization is done asynchronously. Nr r r r r Ú initializesz!IInitiatingInitializer.initializeN)rrrrrÚ xmlstreamr r r r r r sr c@seZdZdZedƒZdS)ÚIIQResponseTrackeraº IQ response tracker interface. The XMPP stanza C{iq} has a request-response nature that fits naturally with deferreds. You send out a request and when the response comes back a deferred is fired. The L{twisted.words.protocols.jabber.client.IQ} class implements a C{send} method that returns a deferred. This deferred is put in a dictionary that is kept in an L{XmlStream} object, keyed by the request stanzas C{id} attribute. An object providing this interface (usually an instance of L{XmlStream}), keeps the said dictionary and sets observers on the iq stanzas of type C{result} and C{error} and lets the callback fire the associated deferred. z2Dictionary of deferreds waiting for an iq responseN)rrrrrZ iqDeferredsr r r r r$src@sPeZdZdZedƒZedƒZdd„Zdd„Zdd „Z d d „Z d d „Z dd„Z dS)Ú IXMPPHandlerz° Interface for XMPP protocol handlers. Objects that provide this interface can be added to a stream manager to handle of (part of) an XMPP extension protocol. z#XML stream manager for this handlerzThe managed XML streamcCsdS)za Set the parent of the handler. @type parent: L{IXMPPHandlerCollection} Nr ©Úparentr r r ÚsetHandlerParentEszIXMPPHandler.setHandlerParentcCsdS)zd Remove the parent of the handler. @type parent: L{IXMPPHandlerCollection} Nr rr r r ÚdisownHandlerParentMsz IXMPPHandler.disownHandlerParentcCsdS)aj A connection over the underlying transport of the XML stream has been established. At this point, no traffic has been exchanged over the XML stream given in C{xs}. This should setup L{xmlstream} and call L{connectionMade}. @type xs: L{twisted.words.protocols.jabber.xmlstream.XmlStream} Nr ©Zxsr r r ÚmakeConnectionUszIXMPPHandler.makeConnectioncCsdS)zý Called after a connection has been established. This method can be used to change properties of the XML Stream, its authenticator or the stream manager prior to stream initialization (including authentication). Nr r r r r ÚconnectionMadedszIXMPPHandler.connectionMadecCsdS)a The XML stream has been initialized. At this point, authentication was successful, and XML stanzas can be exchanged over the XML stream L{xmlstream}. This method can be used to setup observers for incoming stanzas. Nr r r r r ÚconnectionInitializednsz"IXMPPHandler.connectionInitializedcCsdS)zê The XML stream has been closed. Subsequent use of C{parent.send} will result in data being queued until a new connection has been established. @type reason: L{twisted.python.failure.Failure} Nr )Úreasonr r r ÚconnectionLostxszIXMPPHandler.connectionLostN) rrrrrrr rrrrrrr r r r r:s  rc@s(eZdZdZdd„Zdd„Zdd„ZdS) ÚIXMPPHandlerCollectionz\ Collection of handlers. Contain several handlers and manage their connection. cCsdS)z: Get an iterator over all child handlers. Nr r r r r Ú__iter__‹szIXMPPHandlerCollection.__iter__cCsdS)zN Add a child handler. @type handler: L{IXMPPHandler} Nr ©Zhandlerr r r Ú addHandler‘sz!IXMPPHandlerCollection.addHandlercCsdS)zQ Remove a child handler. @type handler: L{IXMPPHandler} Nr rr r r Ú removeHandler™sz$IXMPPHandlerCollection.removeHandlerN)rrrrrrrr r r r r„src@s(eZdZdZdd„Zdd„Zdd„ZdS) ÚIServicezÒ External server-side component service interface. Services that provide this interface can be added to L{ServiceManager} to implement (part of) the functionality of the server-side component. cCsdS)ax Parent component has established a connection. At this point, authentication was successful, and XML stanzas can be exchanged over the XML stream C{xs}. This method can be used to setup observers for incoming stanzas. @param xs: XML Stream that represents the established connection. @type xs: L{xmlstream.XmlStream} Nr rr r r ÚcomponentConnectedªszIService.componentConnectedcCsdS)zÕ Parent component has lost the connection to the Jabber server. Subsequent use of C{self.parent.send} will result in data being queued until a new connection has been established. Nr r r r r ÚcomponentDisconnected·szIService.componentDisconnectedcCsdS)ay Parent component has established a connection over the underlying transport. At this point, no traffic has been exchanged over the XML stream. This method can be used to change properties of the XML Stream (in C{xs}), the service manager or it's authenticator prior to stream initialization (including authentication). Nr rr r r ÚtransportConnectedÀszIService.transportConnectedN)rrrrr r!r"r r r r r¢s  rN) rZzope.interfacerrrr rrrrr r r r Ús J