tf!dZddlmZmZGddeZGddeZGddeZGd d eZGd d eZGd deZ GddeZ dS)z Pan-protocol chat client. ) Attribute InterfacecbeZdZdZedZedZdZdZdZ dZ dZ d Z d S) IAccountz; I represent a user's account with a chat service. z} Nr groupNames rgetGroupzIAccount.getGroup?rrcdS)z, @rtype: L{Person} Nr) personNames r getPersonzIAccount.getPersonDrrN) __name__ __module__ __qualname____doc__rclient gatewayTyperrrrrr rrrrrsYU V VF)EK                     rrcDeZdZedZdZdZdZd dZdZ dS) IClientz!The L{IAccount} I am a Client forcdS)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 rrzIClient.__init__MrrcdS)zb @param groupName: The name of the group to join. @type groupName: string Nrrs r joinGroupzIClient.joinGroupUrrcdS)zc @param groupName: The name of the group to leave. @type groupName: string Nrrs r leaveGroupzIClient.leaveGroup[rrrcdSNr)namehides rgetGroupConversationzIClient.getGroupConversationa rcdSr1r)r2s rr zIClient.getPersondr5rNr) r!r"r#rr*rr-r/r4r rrrr(r(Jsti;<r@rErrrr9r9hsd                  rr9c^eZdZdZedZedZdZdZd dZ dZ d Z dS) 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.cdS)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} Nrr;s rrzIGroup.__init__rrcdS)zR Set this Groups topic on the server. @type text: string Nr)rCs rsetTopiczIGroup.setTopicrrNcdS)a 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 NrrBs rsendGroupMessagezIGroup.sendGroupMessagerrcdS)z" Join this group. Nrrrrjoinz IGroup.joinrrcdS)z$ Depart this group. Nrrrrleavez IGroup.leaverrr1) r!r"r#r$rr2r*rrJrLrNrPrrrrGrGs 9> ? ?DiIJJG                   rrGc6eZdZdZdZdZdZdZdZdZ dS) IConversationz0 A conversation with a specific person. cdS)z* @type person: L{IPerson} Nr)personrs rrzIConversation.__init__rrcdSzA doesn't seem like it belongs in this interface. NrrrrshowzIConversation.showrrcdSz# nor this neither. Nrrrrr3zIConversation.hiderrcdSr1rrBs rsendTextzIConversation.sendTextr5rcdSr1rrBs r showMessagezIConversation.showMessager5rcdS)zR @param person: XXX Shouldn't this always be Conversation.person? Nr)rTnewnicks r changedNickzIConversation.changedNickrrN) r!r"r#r$rrWr3r[r]r`rrrrRrRsx                    rrRcDeZdZdZdZdZdZdZdZdZ dZ d Z d S) IGroupConversationcdSrVrrrrrWzIGroupConversation.showrrcdSrYrrrrr3zIGroupConversation.hiderrcdSr1rrBs rr[zIGroupConversation.sendTextr5rcdSr1r)senderrCrDs rshowGroupMessagez#IGroupConversation.showGroupMessager5rcdS)zT Sets the list of members in the group and displays it to the user. Nr)memberss rsetGroupMembersz"IGroupConversation.setGroupMembersrrcdS)z Displays the topic (from the server) for the group conversation window. @type topic: string @type author: string (XXX: Not Person?) Nr)topicauthors rrJzIGroupConversation.setTopicrrcdS)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 memberJoinedzIGroupConversation.memberJoinedrrcdS)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 rmemberChangedNickz$IGroupConversation.memberChangedNick rrcdS)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?) Nrrps r memberLeftzIGroupConversation.memberLeftrrN) r!r"r#rWr3r[rhrkrJrrrvrxrrrrbrbs                             rrbcBeZdZdZdZdZd dZd dZdZdZ d Z d S) IChatUIcdS)zp Notifies user that an account has been signed on to. @type client: L{Client} Nrr%s rregisterAccountClientzIChatUI.registerAccountClientrrcdS)z~ Notifies user that an account has been signed off or disconnected. @type client: L{Client} Nrr|s runregisterAccountClientzIChatUI.unregisterAccountClient#rrcdS)z) @rtype: L{ContactsList} NrrrrgetContactsListzIChatUI.getContactsList*rrrcdS)aT 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)rTClass stayHiddens rgetConversationzIChatUI.getConversation2rrcdS)a 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 rr4zIChatUI.getGroupConversation>rrcdS)z Get a Person for a client. Duplicates L{IAccount.getPerson}. @type name: string @type client: L{Client} @rtype: L{Person} Nrr2r%s rr zIChatUI.getPersonJrrcdS)z Get a Group for a client. Duplicates L{IAccount.getGroup}. @type name: string @type client: L{Client} @rtype: L{Group} Nrrs rrzIChatUI.getGroupVrrcdS)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 Nrrts rcontactChangedNickzIChatUI.contactChangedNickbrrNr7) r!r"r#r}rrrr4r rrrrrrzrzs                                rrzN) r$zope.interfacerrrr(r9rGrRrbrzrrrrsh 0///////2 2 2 2 2 y2 2 2 j     i   <$ $ $ $ $ i$ $ $ N1 1 1 1 1 Y1 1 1 h     I   @5 5 5 5 5 5 5 5 pO O O O O iO O O O O r