+ j @nRt^RIHtHtHt!RR4t!RR4t!RR4t!RR 4tR #) z. Base classes for Instance Messenger clients. )AWAYOFFLINEONLINEcBa]tRt^ toRtRtRtRtRtRt Rt Vt R#) ContactsLista4 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 <Wn/Vn/Vn.VnR#)z` @param chatui: The GUI chat client associated with this contacts list. @type chatui: L{ChatUI} N)chatuicontactsonlineContactsclients)selfrs&&;/usr/lib/python3/dist-packages/twisted/words/im/basechat.py__init__ContactsList.__init__ s     c VPVP9dWPVP&VPVP9dCVP\8XgVP\ 8XdWPVP&VPVP9d1VP\ 8XdVPVPR#R#R#)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 statusrrr)r persons&&r setContactStatusContactsList.setContactStatus*s ;;dmm +)/MM&++ & ;;d11 1 MMV #v}}'} provider N)r appendr clients&&r registerAccountClient"ContactsList.registerAccountClient:s%  % LL   ' &rc `WP9dVPPV4R#R#)z 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 removers&&r unregisterAccountClient$ContactsList.unregisterAccountClientDs% \\ ! LL   ' "rc VPpW0P9dQVPVW!nWPV&W0P9dVPVWPV&R#R#R#)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)rr r )r rnewnickoldnames&&& r contactChangedNickContactsList.contactChangedNickPsf++ mm # g&!K%+MM' "---''0/5##G,. $r)rr r r N) __name__ __module__ __qualname____firstlineno____doc__rrrrr$__static_attributes____classdictcell__ __classdict__s@r rr s(&1 ( (66rrcLa]tRt^ftoRtRtRtRtRtR Rlt Rt R t Vt R#) 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 W nWnR#)z @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} Nrr)r rrs&&&r rConversation.__init__qs  rc \R4h)z! Display the ConversationWindow. %Subclasses must implement this methodNotImplementedErrorr s&r showConversation.show|""IJJrc \R4h)z Hide the ConversationWindow. r5r6r8s&r hideConversation.hider;rc >VPPVR4R#)zq 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 texts&&r sendTextConversation.sendTexts d+rNc \R4h)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} r5r6)r rBmetadatas&&&r showMessageConversation.showMessages""IJJrc &W PnR#)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)rr)r rr"s&&&r r$Conversation.contactChangedNicks# rr2N) r&r'r(r)r*rr9r=rCrGr$r+r,r-s@r r0r0fs0 K K , K # #rr0cda]tRt^toRtRtRtRtRtRRlt Rt R t R t R t R tR tVtR#)GroupConversationam 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 ,W nWn.VnR#)z @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 Nrgroupmembers)r rPrs&&&r rGroupConversation.__init__s   rc \R4h)z& Display the GroupConversationWindow. r5r6r8s&r r9GroupConversation.showr;rc \R4h)z# Hide the GroupConversationWindow. r5r6r8s&r r=GroupConversation.hider;rc >VPPVR4R#)zO Send text to the group. @param text: The text to be sent. @type text: C{str} N)rPsendGroupMessagerAs&&r rCGroupConversation.sendTexts ##D$/rNc \R4h)a 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} r5r6)r senderrBrFs&&&&r showGroupMessage"GroupConversation.showGroupMessages""IJJrc WnR#)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)rQ)r rQs&&r setGroupMembers!GroupConversation.setGroupMemberss  rc \R4h)z 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} r5r6)r topicauthors&&&r setTopicGroupConversation.setTopics""IJJrc `WP9dVPPV4R#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)rQrr members&&r memberJoinedGroupConversation.memberJoineds%  % LL   ' &rc WP9d9VPPV4VPPV4R#R#)z 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)rQrr)r oldnickr"s&&&r memberChangedNick#GroupConversation.memberChangedNick s7 ll " LL   ( LL   ( #rc `WP9dVPPV4R#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)rQrrgs&&r memberLeftGroupConversation.memberLefts% \\ ! LL   ' "rrOrK)r&r'r(r)r*rr9r=rCr\r_rdrirmrpr+r,r-s@r rMrMsE  K K 0 K K ( ) ( (rrMcja]tRtRtoRtRtRtRtRt] R3Rlt ] R3R lt R t R tR tR tVtR#)ChatUIi$a 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. cl/Vn/Vn/Vn/Vn.Vn\ V4VnR#rK) conversationsgroupConversationspersonsgroups onlineClientsr contactsListr8s&r rChatUI.__init__?s5"$  (.rc rVPPV4VPPV4V#)a* 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. )ryrrzrrs&&r rChatUI.registerAccountClientGs1 !!&) //7 rc rVPPV4VPPV4R#)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)ryrrzrrs&&r rChatUI.unregisterAccountClientUs, !!&) 11&9rc VP#)z Get the contacts list associated with this chat window. @rtype: L{ContactsList} @return: The contacts list associated with this chat window. )rzr8s&r getContactsListChatUI.getContactsList`s   rFc VPPV4pV'gV!W4pW@PV&V'dVP4V#VP4V#)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. )rugetr=r9)r rClass stayHiddenconvs&&&& r getConversationChatUI.getConversationisX&!!%%f-&D)-  v &  IIK  IIK rc VPPV4pV'gV!W4pW@PV&V'dVP4V#VP4V#)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. )rvrr=r9)r rPrrrs&&&& r getGroupConversationChatUI.getGroupConversationsX&&&**51%D-1 # #E *  IIK  IIK rc VPpVPPW34pV'g!VPV4pW@PW3&V#)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}. )accountrwr getPerson)r rrrps&&& r rChatUI.getPersonsI.. LL  d_ -!!$'A*+LL 'rc VPpVPPW34pV'g!VPV4pW@PW3&V#)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}. )rrxrgetGroup)r rrrgs&&& r rChatUI.getGroupsG$.. KKOOTO ,  &A)*KK &rc |VPpW1P3VP9dVPP V4pV'dVP W4VP P W4VPW1P3W!nWPVPVP3&R#R#)ac 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)rrrwrurr$rz)r rr"rlrs&&& r r$ChatUI.contactChangedNicks++ ^^ $ 4%%))&1D''8    0 0 A Wnn45!K8>LLfnn4 5 5r)rzrurvrxryrwN)r&r'r(r)r*rrrrr0rrMrrrr$r+r,r-s@r rsrs$sK4/  :!-9U:1Be:,2??rrsN) r*twisted.words.im.localsrrrrr0rMrsrr rsE :9W6W6tA#A#Hw(w(tB?B?r