/usr/lib/python3/dist-packages/twisted/words/im/__pycache__
Edit: /usr/lib/python3/dist-packages/twisted/words/im/__pycache__/basechat.cpython-310.pyc (16683B)
o
b @ @ sT d Z ddlmZmZmZ G dd dZG dd dZG dd dZG d d
d
Zd S ) z.
Base classes for Instance Messenger clients.
)AWAYOFFLINEONLINEc @ s8 e Zd ZdZdd 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
}
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} provider
@ivar clients: The signed-on clients.
@type clients: C{list} of L{IClient} providers
c C s || _ i | _i | _g | _dS )zx
@param chatui: The GUI chat client associated with this contacts list.
@type chatui: L{ChatUI}
N)chatuicontactsonlineContactsclients)selfr r ;/usr/lib/python3/dist-packages/twisted/words/im/basechat.py__init__ s
zContactsList.__init__c C sp |j | jvr || j|j < |j | jvr"|jtks |jtkr"|| j|j < |j | jv r4|jtkr6| j|j = dS dS dS )z
Inform the user that a person's status has changed.
@param person: The person whose status has changed.
@type person: L{IPerson} provider
N)namer r statusr r r )r
personr r r setContactStatus* s z ContactsList.setContactStatusc C || j vr
| j | dS dS )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} provider
N)r appendr
clientr r r registerAccountClient: s
z"ContactsList.registerAccountClientc C || j v r
| j | dS dS )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} provider
N)r remover r r r unregisterAccountClientD s
z$ContactsList.unregisterAccountClientc C sP |j }|| jv r$| j|= ||_ || j|< || jv r&| j|= || j|< dS dS dS )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} provider
@param newnick: The new nickname for this person.
@type newnick: C{str}
N)r r r )r
r newnickoldnamer r r contactChangedNickP s
z ContactsList.contactChangedNickN) __name__
__module__ __qualname____doc__r
r r r r r r r r r s
r c @ sB e Zd ZdZdd Zdd Zdd Zdd Zdd d 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} provider
@ivar chatui: The GUI chat client associated with this conversation.
@type chatui: L{ChatUI}
c C s || _ || _dS )a
@param person: The person who you're having this conversation with.
@type person: L{IPerson} provider
@param chatui: The GUI chat client associated with this conversation.
@type chatui: L{ChatUI}
N)r r )r
r r r r r r
q s
zConversation.__init__c C t d)z1
Display the ConversationWindow.
%Subclasses must implement this methodNotImplementedErrorr
r r r show| zConversation.showc C r" )z.
Hide the ConversationWindow.
r# r$ r& r r r hide r( zConversation.hidec C | 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 sendMessager
textr r r sendText zConversation.sendTextNc C r" )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- metadatar r r showMessage s
zConversation.showMessagec C s || j _dS )z
Change a person's name.
@param person: The person whose nickname is changing.
@type person: L{IPerson} provider
@param newnick: The new nickname for this person.
@type newnick: C{str}
N)r r )r
r r r r r r s
z Conversation.contactChangedNickN)
r r r r r
r' r) r. r1 r r r r r r! f s
r! c @ sb e Zd ZdZdd Zdd Zdd Zdd Zdd d Zd
d Z dd Z
dd Z dd 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} provider
@ivar members: The names of the people in this conversation.
@type members: C{list} of C{str}
c C s || _ || _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} provider
N)r groupmembers)r
r4 r r r r r
s
zGroupConversation.__init__c C r" )z6
Display the GroupConversationWindow.
r# r$ r& r r r r' r( zGroupConversation.showc C r" )z3
Hide the GroupConversationWindow.
r# r$ r& r r r r) r( zGroupConversation.hidec C r* )zo
Send text to the group.
@param text: The text to be sent.
@type text: C{str}
N)r4 sendGroupMessager, r r r r. r/ zGroupConversation.sendTextNc C r" )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- r0 r r r showGroupMessage s
z"GroupConversation.showGroupMessagec C s
|| _ 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
r5 r r r setGroupMembers s
z!GroupConversation.setGroupMembersc C r" )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
topicauthorr r r setTopic s zGroupConversation.setTopicc C r )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)r5 r r
memberr r r memberJoined
z GroupConversation.memberJoinedc C s* || j v r| j | | j | dS dS )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)r5 r r )r
oldnickr r r r memberChangedNick s
z#GroupConversation.memberChangedNickc C r )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)r5 r r= r r r
memberLeft r@ z GroupConversation.memberLeftr2 )r r r r r
r' r) r. r8 r9 r< r? rB rC r r r r r3 s
r3 c @ sd e Zd ZdZdd Zdd Zdd Zdd Zed
fd d Z e
d
fd
dZ dd 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} provider) and values that are
L{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} provider) and values that are
L{IGroup} provider
@ivar groups: A cache of all the groups associated with this client.
@type onlineClients: C{list} of L{IClient} providers
@ivar onlineClients: A list of message sources currently online.
@type contactsList: L{ContactsList}
@ivar contactsList: A contacts list.
c C s, i | _ i | _i | _i | _g | _t| | _d S r2 )
conversationsgroupConversationspersonsgroups
onlineClientsr contactsListr& r r r r
? s zChatUI.__init__c C s | j | | j| |S )aZ
Notify the user that an account has been signed on to.
@type client: L{IClient} provider
@param client: The client account for the person who has just signed on.
@rtype: L{IClient} provider
@return: The client, so that it may be used in a callback chain.
)rI r rJ r r r r r r G s
z ChatUI.registerAccountClientc C s | j | | j| dS )z
Notify the user that an account has been signed off or disconnected.
@type client: L{IClient} provider
@param client: The client account for the person who has just signed
off.
N)rI r rJ r r r r r r U s z ChatUI.unregisterAccountClientc C s | j S )z
Get the contacts list associated with this chat window.
@rtype: L{ContactsList}
@return: The contacts list associated with this chat window.
)rJ r& r r r getContactsList` s zChatUI.getContactsListFc C @ | 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} provider
@param person: The person whose conversation window we want to get.
@type Class: L{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} provider
@return: The conversation window.
)rE getr) r' )r
r Class
stayHiddenconvr r r getConversationi
zChatUI.getConversationc C rL )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} provider
@param group: The group whose conversation window we want to get.
@type Class: L{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} provider
@return: The group conversation window.
)rF rM r) r' )r
r4 rN rO rP r r r getGroupConversation rR zChatUI.getGroupConversationc C 6 |j }| j||f}|s||}|| j||f< |S )a
For the given name and account client, return an instance of a
L{IGroup} provider or create and return a new
instance of a L{IGroup} provider.
@type name: C{str}
@param name: The name of the person of interest.
@type client: L{IClient} provider
@param client: The client account of interest.
@rtype: L{IPerson} provider
@return: The person with that C{name}.
)accountrG rM getPerson)r
r r rU pr r r rV s
zChatUI.getPersonc C rT )a
For the given name and account client, return an instance of a
L{IGroup} provider or create and return a new instance
of a L{IGroup} provider.
@type name: C{str}
@param name: The name of the group of interest.
@type client: L{IClient} provider
@param client: The client account of interest.
@rtype: L{IGroup} provider
@return: The group with that C{name}.
)rU rH rM getGroup)r
r r rU gr r r rX s
zChatUI.getGroupc C sn |j }||jf| jv r5| j|}|r||| | j|| | j||jf= ||_ || j|j |jf< dS dS )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} 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)r rU rG rE rM r rJ )r
r r rA rP r r r r s zChatUI.contactChangedNickN)r r r r r
r r rK r! rQ r3 rS rV rX r r r r r rD $ s rD N) r twisted.words.im.localsr r r r r! r3 rD r r r r s ZDz