+ j!Rt^RIHtHt!RR]4t!RR]4t!RR]4t!RR ]4t!R R ]4t!R R ]4t !RR]4t R#)z Pan-protocol chat client. ) Attribute Interfacecha]tRt^toRt]!R4t]!R4tRtRt Rt Rt Rt R t R tVtR #) IAccountz3 I represent a user's account with a chat service. z} Nr groupNames&rgetGroupIAccount.getGroup?rrc R#)z @rtype: L{Person} Nr) personNames&r getPersonIAccount.getPersonDrrrN)__name__ __module__ __qualname____firstlineno____doc__rclient gatewayTyperrrrr r$__static_attributes____classdictcell__ __classdict__s@rrrsGU VFEK        rrcRa]tRt^Jto]!R4tRtRtRtR Rlt Rt Rt Vt R#) IClientz!The L{IAccount} I am a Client forc R#)z @type account: L{IAccount} @type chatui: L{IChatUI} @param logonDeferred: Will be called back once I am logged on. @type logonDeferred: L{Deferred} Nr)accountr logonDeferreds&&&rrIClient.__init__Mrrc R#)zJ @param groupName: The name of the group to join. @type groupName: string Nrrs&r joinGroupIClient.joinGroupUrrc R#)zK @param groupName: The name of the group to leave. @type groupName: string Nrrs&r leaveGroupIClient.leaveGroup[rrcR#Nr)namehides&&rgetGroupConversationIClient.getGroupConversationa rcR#r>r)r?s&rr$IClient.getPersondrCrrN) r&r'r(r)rr4rr8r;rAr$r-r.r/s@rr2r2Js.;) r&r'r(r)rrrPrSrYr-r.r/s@rrIrIhs#      rrIcfa]tRt^toRt]!R4t]!R4tRtRt R Rlt Rt R t R t VtR#) IGroupz A group which you may have a conversation with. Groups generally have a loosely-defined set of members, who may leave and join at any time. z'My C{str} name, as the server knows me.z/The L{Account} I am accessed through.c R#)z Initialize me. @param name: My name, as the server knows me. @type name: str @param account: The account I am accessed through. @type account: L{Account} NrrKs&&rrIGroup.__init__rrc R#)z: Set this Groups topic on the server. @type text: string Nr)rWs&rsetTopicIGroup.setTopicrrNc R#)z Send a message to this group. @type text: str @type metadata: dict @param metadata: Valid keys for this dictionary include: - C{'style'}: associated with one of: - C{'emote'}: indicates this is an action NrrVs&&rsendGroupMessageIGroup.sendGroupMessagerrc R#)z Join this group. Nrrrrjoin IGroup.joinrrc R#)z Depart this group. Nrrrrleave IGroup.leaverrrr>)r&r'r(r)r*rr?r4rr`rcrfrir-r.r/s@rr\r\s@ > ?DIJG       rr\cHa]tRt^toRtRtRtRtRtRt Rt Rt Vt R #) IConversationz( A conversation with a specific person. c R#)z @type person: L{IPerson} Nr)personrs&&rrIConversation.__init__rrc R#z1 doesn't seem like it belongs in this interface. NrrrrshowIConversation.showrrc R#z nor this neither. Nrrrrr@IConversation.hiderrcR#r>rrVs&&rsendTextIConversation.sendTextrCrcR#r>rrVs&&r showMessageIConversation.showMessagerCrc R#)zB @param person: XXX Shouldn't this always be Conversation.person? Nr)rnnewnicks&&r changedNickIConversation.changedNickrrrN) r&r'r(r)r*rrrr@rxr{rr-r.r/s@rrlrls-       rrlcVa]tRt^toRtRtRtRtRtRt Rt Rt R t R t VtR #) IGroupConversationc R#rqrrrrrrIGroupConversation.showrrc R#rurrrrr@IGroupConversation.hiderrcR#r>rrVs&&rrxIGroupConversation.sendTextrCrcR#r>r)senderrWrXs&&&rshowGroupMessage#IGroupConversation.showGroupMessagerCrc R#)zD Sets the list of members in the group and displays it to the user. Nr)memberss&rsetGroupMembers"IGroupConversation.setGroupMembersrrc R#)z Displays the topic (from the server) for the group conversation window. @type topic: string @type author: string (XXX: Not Person?) Nr)topicauthors&&rr`IGroupConversation.setTopicrrc R#)z Adds the given member to the list of members in the group conversation and displays this to the user, @type member: string (XXX: Not Person?) Nrmembers&r memberJoinedIGroupConversation.memberJoinedrrc R#)z Changes the oldnick in the list of members to C{newnick} and displays this change to the user, @type oldnick: string (XXX: Not Person?) @type newnick: string Nroldnickr~s&&rmemberChangedNick$IGroupConversation.memberChangedNick rrc R#)z Deletes the given member from the list of members in the group conversation and displays the change to the user. @type member: string (XXX: Not Person?) Nrrs&r memberLeftIGroupConversation.memberLeftrrrN)r&r'r(r)rrr@rxrrr`rrrr-r.r/s@rrrs7          rrcXa]tRtRtoRtRtRtR RltR RltRt Rt R t R t Vt R #) IChatUIic R#)zX Notifies user that an account has been signed on to. @type client: L{Client} Nrr+s&rregisterAccountClientIChatUI.registerAccountClientrrc R#)zf Notifies user that an account has been signed off or disconnected. @type client: L{Client} Nrrs&runregisterAccountClientIChatUI.unregisterAccountClient#rrc R#)z @rtype: L{ContactsList} NrrrrgetContactsListIChatUI.getContactsList*rrc R#)a For the given person object, returns the conversation window or creates and returns a new conversation window if one does not exist. @type person: L{Person} @type Class: L{Conversation} class @type stayHidden: boolean @rtype: L{Conversation} Nr)rnClass stayHiddens&&&rgetConversationIChatUI.getConversation2rrc R#)aM For the given group object, returns the group conversation window or creates and returns a new group conversation window if it doesn't exist. @type group: L{Group} @type Class: L{Conversation} class @type stayHidden: boolean @rtype: L{GroupConversation} Nr)grouprrs&&&rrAIChatUI.getGroupConversation>rrc R#)z Get a Person for a client. Duplicates L{IAccount.getPerson}. @type name: string @type client: L{Client} @rtype: L{Person} Nrr?r+s&&rr$IChatUI.getPersonJrrc R#)z Get a Group for a client. Duplicates L{IAccount.getGroup}. @type name: string @type client: L{Client} @rtype: L{Group} Nrrs&&rr IChatUI.getGroupVrrc R#)z For the given person, changes the person's name to newnick, and tells the contact list and any conversation windows with that person to change as well. @type oldnick: string @type newnick: string Nrrs&&rcontactChangedNickIChatUI.contactChangedNickbrrrNrF)r&r'r(r)rrrrrAr$r rr-r.r/s@rrrs2             rrN) r*zope.interfacerrrr2rIr\rlrrrrrrsj 02 y2 j i <$ i$ N1 Y1 h I @5 5 pO iO r