כh!SrSSKJrJr "SS\5r"SS\5r"SS\5r"S S \5r"S S \5r"S S\5r "SS\5r g)z Pan-protocol chat client. ) Attribute Interfacec\\rSrSrSr\"S5r\"S5rSrSr Sr Sr S r S r S rg ) IAccountz3 I represent a user's account with a chat service. z} Nr  groupNames rgetGroupIAccount.getGroup?rrcg)z @rtype: L{Person} Nr ) personNames r getPersonIAccount.getPersonDrrr N)__name__ __module__ __qualname____firstlineno____doc__rclient gatewayTyperrrrr"r&__static_attributes__r rrrrs?U VFEK       rrcF\rSrSr\"S5rSrSrSrS Sjr Sr Sr g ) IClientJz!The L{IAccount} I am a Client forcg)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__Mrrcg)zJ @param groupName: The name of the group to join. @type groupName: string Nr r s r joinGroupIClient.joinGroupUrrcg)zK @param groupName: The name of the group to leave. @type groupName: string Nr r s r leaveGroupIClient.leaveGroup[rrcgNr )namehides rgetGroupConversationIClient.getGroupConversationa rcgr>r )r?s rr&IClient.getPersondrCrr Nr) r(r)r*r+rr4rr8r;rAr&r/r rrr1r1Js&;) r(r)r*r+rrrPrSrYr/r rrrHrHhs     rrHcZ\rSrSrSr\"S5r\"S5rSrSr S Sjr S r S r S r g) 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.cg)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} Nr rKs rrIGroup.__init__rrcg)z: Set this Groups topic on the server. @type text: string Nr )rWs rsetTopicIGroup.setTopicrrNcg)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 Nr rVs rsendGroupMessageIGroup.sendGroupMessagerrcg)z Join this group. Nr r rrjoin IGroup.joinrrcg)z Depart this group. Nr r rrleave IGroup.leaverrr r>)r(r)r*r+r,rr?r4rrardrgrjr/r rrr\r\s8 > ?DIJG      rr\c<\rSrSrSrSrSrSrSrSr Sr S r g ) IConversationz( A conversation with a specific person. cg)z @type person: L{IPerson} Nr )personrs rrIConversation.__init__rrcgz1 doesn't seem like it belongs in this interface. Nr r rrshowIConversation.showrrcgz nor this neither. Nr r rrr@IConversation.hiderrcgr>r rVs rsendTextIConversation.sendTextrCrcgr>r rVs r showMessageIConversation.showMessagerCrcg)zB @param person: XXX Shouldn't this always be Conversation.person? Nr )rpnewnicks r changedNickIConversation.changedNickrrr N) r(r)r*r+r,rrtr@rzr}rr/r rrrmrms%      rrmcJ\rSrSrSrSrSrSrSrSr Sr S r S r S r g ) IGroupConversationcgrsr r rrrtIGroupConversation.showrrcgrwr r rrr@IGroupConversation.hiderrcgr>r rVs rrzIGroupConversation.sendTextrCrcgr>r )senderrWrXs rshowGroupMessage#IGroupConversation.showGroupMessagerCrcg)zD Sets the list of members in the group and displays it to the user. Nr )memberss rsetGroupMembers"IGroupConversation.setGroupMembersrrcg)z Displays the topic (from the server) for the group conversation window. @type topic: string @type author: string (XXX: Not Person?) Nr )topicauthors rraIGroupConversation.setTopicrrcg)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?) Nr members r memberJoinedIGroupConversation.memberJoinedrrcg)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 Nr oldnickrs rmemberChangedNick$IGroupConversation.memberChangedNick rrcg)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?) Nr rs r memberLeftIGroupConversation.memberLeftrrr N)r(r)r*r+rtr@rzrrrarrrr/r rrrrs/         rrcL\rSrSrSrSrSrS SjrS SjrSr Sr S r S r g ) IChatUIicg)zX Notifies user that an account has been signed on to. @type client: L{Client} Nr r-s rregisterAccountClientIChatUI.registerAccountClientrrcg)zf Notifies user that an account has been signed off or disconnected. @type client: L{Client} Nr rs runregisterAccountClientIChatUI.unregisterAccountClient#rrcg)z @rtype: L{ContactsList} Nr r rrgetContactsListIChatUI.getContactsList*rrcg)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 )rpClass stayHiddens rgetConversationIChatUI.getConversation2rrcg)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>rrcg)z Get a Person for a client. Duplicates L{IAccount.getPerson}. @type name: string @type client: L{Client} @rtype: L{Person} Nr r?r-s rr&IChatUI.getPersonJrrcg)z Get a Group for a client. Duplicates L{IAccount.getGroup}. @type name: string @type client: L{Client} @rtype: L{Group} Nr rs rr"IChatUI.getGroupVrrcg)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 Nr rs rcontactChangedNickIChatUI.contactChangedNickbrrr NrF) r(r)r*r+rrrrrAr&r"rr/r rrrrs*            rrN) r,zope.interfacerrrr1rHr\rmrrr rrrsj 02 y2 j i <$ i$ N1 Y1 h I @5 5 pO iO r