HEX

File: //usr/lib/python3/dist-packages/twisted/words/protocols/jabber/__pycache__/ijabber.cpython-38.pyc
U


W[�@sxdZddlmZmZGdd�de�ZGdd�de�ZGdd�de�ZGd	d
�d
e�ZGdd�de�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�	xmlstreamrr	r	r	r
rsrc@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)rrrrrZiqDeferredsr	r	r	r
r$src@sPeZdZdZed�Zed�Zdd�Zdd�Zdd	�Z	d
d�Z
dd
�Zdd�ZdS)�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.interfacerrrrrrrrr	r	r	r
�<module>s
J