HEX
Server: Apache/2.4.52 (Ubuntu)
System: Linux spn-python 5.15.0-89-generic #99-Ubuntu SMP Mon Oct 30 20:42:41 UTC 2023 x86_64
User: arjun (1000)
PHP: 8.1.2-1ubuntu2.20
Disabled: NONE
$ pwd: /lib/python3/dist-packages/twisted/words/im/__pycache__/
Upload Files
File: //lib/python3/dist-packages/twisted/words/im/__pycache__/basechat.cpython-310.pyc
o

�b@�@sTdZddlmZmZmZGdd�d�ZGdd�d�ZGdd�d�ZGd	d
�d
�ZdS)z.
Base classes for Instance Messenger clients.
�)�AWAY�OFFLINE�ONLINEc@s8eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�ZdS)
�ContactsListah
    A GUI object that displays a contacts list.

    @ivar chatui: The GUI chat client associated with this contacts list.
    @type chatui: L{ChatUI}

    @ivar contacts: The contacts.
    @type contacts: C{dict} mapping C{str} to a L{IPerson<interfaces.IPerson>}
        provider

    @ivar onlineContacts: The contacts who are currently online (have a status
        that is not C{OFFLINE}).
    @type onlineContacts: C{dict} mapping C{str} to a
        L{IPerson<interfaces.IPerson>} provider

    @ivar clients: The signed-on clients.
    @type clients: C{list} of L{IClient<interfaces.IClient>} providers
    cCs||_i|_i|_g|_dS)zx
        @param chatui: The GUI chat client associated with this contacts list.
        @type chatui: L{ChatUI}
        N)�chatui�contacts�onlineContacts�clients)�selfr�r�;/usr/lib/python3/dist-packages/twisted/words/im/basechat.py�__init__ s
zContactsList.__init__cCsp|j|jvr||j|j<|j|jvr"|jtks|jtkr"||j|j<|j|jvr4|jtkr6|j|j=dSdSdS)z�
        Inform the user that a person's status has changed.

        @param person: The person whose status has changed.
        @type person: L{IPerson<interfaces.IPerson>} provider
        N)�namerr�statusrrr)r
�personrrr�setContactStatus*s�zContactsList.setContactStatuscC�||jvr
|j�|�dSdS)z�
        Notify the user that an account client has been signed on to.

        @param client: The client being added to your list of account clients.
        @type client: L{IClient<interfaces.IClient>} provider
        N)r	�append�r
�clientrrr�registerAccountClient:s
�z"ContactsList.registerAccountClientcC�||jvr
|j�|�dSdS)a
        Notify the user that an account client has been signed off or
        disconnected from.

        @param client: The client being removed from the list of account
            clients.
        @type client: L{IClient<interfaces.IClient>} provider
        N)r	�removerrrr�unregisterAccountClientDs
	�z$ContactsList.unregisterAccountClientcCsP|j}||jvr$|j|=||_||j|<||jvr&|j|=||j|<dSdSdS)a^
        Update your contact information to reflect a change to a contact's
        nickname.

        @param person: The person in your contacts list whose nickname is
            changing.
        @type person: L{IPerson<interfaces.IPerson>} provider

        @param newnick: The new nickname for this person.
        @type newnick: C{str}
        N)rrr)r
r�newnick�oldnamerrr�contactChangedNickPs


�zContactsList.contactChangedNickN)	�__name__�
__module__�__qualname__�__doc__r
rrrrrrrrrs

rc@sBeZdZdZdd�Zdd�Zdd�Zdd	�Zddd�Zd
d�Z	d
S)�Conversationa(
    A GUI window of a conversation with a specific person.

    @ivar person: The person who you're having this conversation with.
    @type person: L{IPerson<interfaces.IPerson>} provider

    @ivar chatui: The GUI chat client associated with this conversation.
    @type chatui: L{ChatUI}
    cCs||_||_dS)a
        @param person: The person who you're having this conversation with.
        @type person: L{IPerson<interfaces.IPerson>} provider

        @param chatui: The GUI chat client associated with this conversation.
        @type chatui: L{ChatUI}
        N)rr)r
rrrrrr
qs
zConversation.__init__cC�td��)z1
        Display the ConversationWindow.
        �%Subclasses must implement this method��NotImplementedError�r
rrr�show|�zConversation.showcCr")z.
        Hide the ConversationWindow.
        r#r$r&rrr�hide�r(zConversation.hidecC�|j�|d�dS)z�
        Send text to the person with whom the user is conversing.

        @param text: The text to be sent.
        @type text: C{str}
        N)r�sendMessage�r
�textrrr�sendText��zConversation.sendTextNcCr")z�
        Display a message sent from the person with whom the user is conversing.

        @param text: The sent message.
        @type text: C{str}

        @param metadata: Metadata associated with this message.
        @type metadata: C{dict}
        r#r$)r
r-�metadatarrr�showMessage�s
zConversation.showMessagecCs||j_dS)z�
        Change a person's name.

        @param person: The person whose nickname is changing.
        @type person: L{IPerson<interfaces.IPerson>} provider

        @param newnick: The new nickname for this person.
        @type newnick: C{str}
        N)rr)r
rrrrrr�s
zConversation.contactChangedNick�N)
rrrr r
r'r)r.r1rrrrrr!fs

	r!c@sbeZdZdZdd�Zdd�Zdd�Zdd	�Zddd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
d
S)�GroupConversationa�
    A GUI window of a conversation with a group of people.

    @ivar chatui: The GUI chat client associated with this conversation.
    @type chatui: L{ChatUI}

    @ivar group: The group of people that are having this conversation.
    @type group: L{IGroup<interfaces.IGroup>} provider

    @ivar members: The names of the people in this conversation.
    @type members: C{list} of C{str}
    cCs||_||_g|_dS)a
        @param chatui: The GUI chat client associated with this conversation.
        @type chatui: L{ChatUI}

        @param group: The group of people that are having this conversation.
        @type group: L{IGroup<interfaces.IGroup>} provider
        N)r�group�members)r
r4rrrrr
�s
zGroupConversation.__init__cCr")z6
        Display the GroupConversationWindow.
        r#r$r&rrrr'�r(zGroupConversation.showcCr")z3
        Hide the GroupConversationWindow.
        r#r$r&rrrr)�r(zGroupConversation.hidecCr*)zo
        Send text to the group.

        @param text: The text to be sent.
        @type text: C{str}
        N)r4�sendGroupMessager,rrrr.�r/zGroupConversation.sendTextNcCr")aR
        Display to the user a message sent to this group from the given sender.

        @param sender: The person sending the message.
        @type sender: C{str}

        @param text: The sent message.
        @type text: C{str}

        @param metadata: Metadata associated with this message.
        @type metadata: C{dict}
        r#r$)r
�senderr-r0rrr�showGroupMessage�s
z"GroupConversation.showGroupMessagecCs
||_dS)z�
        Set the list of members in the group.

        @param members: The names of the people that will be in this group.
        @type members: C{list} of C{str}
        N)r5)r
r5rrr�setGroupMembers�s
z!GroupConversation.setGroupMemberscCr")a
        Change the topic for the group conversation window and display this
        change to the user.

        @param topic: This group's topic.
        @type topic: C{str}

        @param author: The person changing the topic.
        @type author: C{str}
        r#r$)r
�topic�authorrrr�setTopic�szGroupConversation.setTopiccCr)z�
        Add the given member to the list of members in the group conversation
        and displays this to the user.

        @param member: The person joining the group conversation.
        @type member: C{str}
        N)r5r�r
�memberrrr�memberJoined��
�zGroupConversation.memberJoinedcCs*||jvr|j�|�|j�|�dSdS)a
        Change the nickname for a member of the group conversation and displays
        this change to the user.

        @param oldnick: The old nickname.
        @type oldnick: C{str}

        @param newnick: The new nickname.
        @type newnick: C{str}
        N)r5rr)r
�oldnickrrrr�memberChangedNick	s
�z#GroupConversation.memberChangedNickcCr)z�
        Delete the given member from the list of members in the group
        conversation and displays the change to the user.

        @param member: The person leaving the group conversation.
        @type member: C{str}
        N)r5rr=rrr�
memberLeftr@zGroupConversation.memberLeftr2)rrrr r
r'r)r.r8r9r<r?rBrCrrrrr3�s

		
r3c@sdeZdZdZdd�Zdd�Zdd�Zdd	�Zed
fdd�Z	e
d
fd
d�Zdd�Zdd�Z
dd�ZdS)�ChatUIa�
    A GUI chat client.

    @type conversations: C{dict} of L{Conversation}
    @ivar conversations: A cache of all the direct windows.

    @type groupConversations: C{dict} of L{GroupConversation}
    @ivar groupConversations: A cache of all the group windows.

    @type persons: C{dict} with keys that are a C{tuple} of (C{str},
       L{IAccount<interfaces.IAccount>} provider) and values that are
       L{IPerson<interfaces.IPerson>} provider
    @ivar persons: A cache of all the users associated with this client.

    @type groups: C{dict} with keys that are a C{tuple} of (C{str},
        L{IAccount<interfaces.IAccount>} provider) and values that are
        L{IGroup<interfaces.IGroup>} provider
    @ivar groups: A cache of all the groups associated with this client.

    @type onlineClients: C{list} of L{IClient<interfaces.IClient>} providers
    @ivar onlineClients: A list of message sources currently online.

    @type contactsList: L{ContactsList}
    @ivar contactsList: A contacts list.
    cCs,i|_i|_i|_i|_g|_t|�|_dSr2)�
conversations�groupConversations�persons�groups�
onlineClientsr�contactsListr&rrrr
?szChatUI.__init__cCs|j�|�|j�|�|S)aZ
        Notify the user that an account has been signed on to.

        @type client: L{IClient<interfaces.IClient>} provider
        @param client: The client account for the person who has just signed on.

        @rtype: L{IClient<interfaces.IClient>} provider
        @return: The client, so that it may be used in a callback chain.
        )rIrrJrrrrrrGs
zChatUI.registerAccountClientcCs|j�|�|j�|�dS)z�
        Notify the user that an account has been signed off or disconnected.

        @type client: L{IClient<interfaces.IClient>} provider
        @param client: The client account for the person who has just signed
            off.
        N)rIrrJrrrrrrUszChatUI.unregisterAccountClientcCs|jS)z�
        Get the contacts list associated with this chat window.

        @rtype: L{ContactsList}
        @return: The contacts list associated with this chat window.
        )rJr&rrr�getContactsList`szChatUI.getContactsListFcC�@|j�|�}|s|||�}||j|<|r|��|S|��|S)a
        For the given person object, return the conversation window or create
        and return a new conversation window if one does not exist.

        @type person: L{IPerson<interfaces.IPerson>} provider
        @param person: The person whose conversation window we want to get.

        @type Class: L{IConversation<interfaces.IConversation>} implementor
        @param Class: The kind of conversation window we want. If the conversation
            window for this person didn't already exist, create one of this type.

        @type stayHidden: C{bool}
        @param stayHidden: Whether or not the conversation window should stay
            hidden.

        @rtype: L{IConversation<interfaces.IConversation>} provider
        @return: The conversation window.
        )rE�getr)r')r
r�Class�
stayHidden�convrrr�getConversationi�

�zChatUI.getConversationcCrL)a 
        For the given group object, return the group conversation window or
        create and return a new group conversation window if it doesn't exist.

        @type group: L{IGroup<interfaces.IGroup>} provider
        @param group: The group whose conversation window we want to get.

        @type Class: L{IConversation<interfaces.IConversation>} implementor
        @param Class: The kind of conversation window we want. If the conversation
            window for this person didn't already exist, create one of this type.

        @type stayHidden: C{bool}
        @param stayHidden: Whether or not the conversation window should stay
            hidden.

        @rtype: L{IGroupConversation<interfaces.IGroupConversation>} provider
        @return: The group conversation window.
        )rFrMr)r')r
r4rNrOrPrrr�getGroupConversation�rRzChatUI.getGroupConversationcC�6|j}|j�||f�}|s|�|�}||j||f<|S)a
        For the given name and account client, return an instance of a
        L{IGroup<interfaces.IPerson>} provider or create and return a new
        instance of a L{IGroup<interfaces.IPerson>} provider.

        @type name: C{str}
        @param name: The name of the person of interest.

        @type client: L{IClient<interfaces.IClient>} provider
        @param client: The client account of interest.

        @rtype: L{IPerson<interfaces.IPerson>} provider
        @return: The person with that C{name}.
        )�accountrGrM�	getPerson)r
rrrU�prrrrV�s
zChatUI.getPersoncCrT)a
        For the given name and account client, return an instance of a
        L{IGroup<interfaces.IGroup>} provider or create and return a new instance
        of a L{IGroup<interfaces.IGroup>} provider.

        @type name: C{str}
        @param name: The name of the group of interest.

        @type client: L{IClient<interfaces.IClient>} provider
        @param client: The client account of interest.

        @rtype: L{IGroup<interfaces.IGroup>} provider
        @return: The group with that C{name}.
        )rUrHrM�getGroup)r
rrrU�grrrrX�s
zChatUI.getGroupcCsn|j}||jf|jvr5|j�|�}|r|�||�|j�||�|j||jf=||_||j|j|jf<dSdS)a�
        For the given C{person}, change the C{person}'s C{name} to C{newnick}
        and tell the contact list and any conversation windows with that
        C{person} to change as well.

        @type person: L{IPerson<interfaces.IPerson>} provider
        @param person: The person whose nickname will get changed.

        @type newnick: C{str}
        @param newnick: The new C{name} C{person} will take.
        N)rrUrGrErMrrJ)r
rrrArPrrrr�s�zChatUI.contactChangedNickN)rrrr r
rrrKr!rQr3rSrVrXrrrrrrD$s	rDN)	r �twisted.words.im.localsrrrrr!r3rDrrrr�<module>sZDz
@ Telegram