tfdZddlmZmZGddeZGddeZGddeZGd d eZGd d eZGd deZ dS)z Public Jabber Interfaces. ) Attribute InterfaceceZdZdZdS) 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__e/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/words/protocols/jabber/ijabber.pyrr sr rc.eZdZdZedZdZdS)IInitiatingInitializerzJ Interface for XML stream initializers for the initiating entity. zThe associated XML streamcdS)z Initiate the initialization step. May return a deferred when the initialization is done asynchronously. Nr r r r initializez!IInitiatingInitializer.initializer N)rrr r r xmlstreamrr r r rrs? 9::I     r rc(eZdZdZedZdS)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)rrr r r iqDeferredsr r r rr#s*")STTKKKr rcbeZdZdZedZedZdZdZdZ dZ dZ d Z d S) 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 streamcdS)za Set the parent of the handler. @type parent: L{IXMPPHandlerCollection} Nr parents r setHandlerParentzIXMPPHandler.setHandlerParentCrr cdS)zd Remove the parent of the handler. @type parent: L{IXMPPHandlerCollection} Nr rs r disownHandlerParentz IXMPPHandler.disownHandlerParentJrr cdS)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 xss r makeConnectionzIXMPPHandler.makeConnectionQrr cdS)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 connectionMadezIXMPPHandler.connectionMade_rr cdS)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 connectionInitializedz"IXMPPHandler.connectionInitializedhrr cdS)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 )reasons r connectionLostzIXMPPHandler.connectionLostqrr N) rrr r rrrrrr"r$r&r)r r r rr8sY@ A AF 677I                     r rc$eZdZdZdZdZdZdS)IXMPPHandlerCollectionz\ Collection of handlers. Contain several handlers and manage their connection. cdS)z: Get an iterator over all child handlers. Nr r r r __iter__zIXMPPHandlerCollection.__iter__rr cdS)zN Add a child handler. @type handler: L{IXMPPHandler} Nr handlers r addHandlerz!IXMPPHandlerCollection.addHandlerrr cdS)zQ Remove a child handler. @type handler: L{IXMPPHandler} Nr r/s r removeHandlerz$IXMPPHandlerCollection.removeHandlerrr N)rrr r r-r1r3r r r r+r+|sK            r r+c$eZdZdZdZdZdZdS)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. cdS)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 r s r componentConnectedzIService.componentConnectedrr cdS)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 componentDisconnectedzIService.componentDisconnectedrr cdS)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 r s r transportConnectedzIService.transportConnectedrr N)rrr r r7r9r;r r r r5r5sK             r r5N) r zope.interfacerrrrrrr+r5r r r r=s@0///////9      \    UUUUUUUU*A A A A A 9A A A H     Y   6% % % % % y% % % % % r