2010-03-26 21:32:16 +00:00
|
|
|
"""
|
|
|
|
|
SleekXMPP: The Sleek XMPP Library
|
|
|
|
|
Copyright (C) 2010 Nathanael C. Fritz
|
|
|
|
|
This file is part of SleekXMPP.
|
|
|
|
|
|
2010-07-20 15:19:49 +00:00
|
|
|
See the file LICENSE for copying permission.
|
2010-03-26 21:32:16 +00:00
|
|
|
"""
|
2010-08-03 22:32:53 +00:00
|
|
|
|
|
|
|
|
from sleekxmpp.stanza import Message, Presence
|
|
|
|
|
from sleekxmpp.xmlstream.stanzabase import registerStanzaPlugin
|
|
|
|
|
from sleekxmpp.xmlstream.stanzabase import ElementBase, ET
|
|
|
|
|
|
2009-12-15 04:37:10 +00:00
|
|
|
|
2009-12-17 01:54:22 +00:00
|
|
|
class Nick(ElementBase):
|
2010-08-03 22:32:53 +00:00
|
|
|
|
|
|
|
|
"""
|
|
|
|
|
XEP-0172: User Nickname allows the addition of a <nick> element
|
|
|
|
|
in several stanza types, including <message> and <presence> stanzas.
|
|
|
|
|
|
|
|
|
|
The nickname contained in a <nick> should be the global, friendly or
|
|
|
|
|
informal name chosen by the owner of a bare JID. The <nick> element
|
|
|
|
|
may be included when establishing communications with new entities,
|
|
|
|
|
such as normal XMPP users or MUC services.
|
|
|
|
|
|
|
|
|
|
The nickname contained in a <nick> element will not necessarily be
|
|
|
|
|
the same as the nickname used in a MUC.
|
|
|
|
|
|
|
|
|
|
Example stanzas:
|
|
|
|
|
<message to="user@example.com">
|
|
|
|
|
<nick xmlns="http://jabber.org/nick/nick">The User</nick>
|
|
|
|
|
<body>...</body>
|
|
|
|
|
</message>
|
|
|
|
|
|
|
|
|
|
<presence to="otheruser@example.com" type="subscribe">
|
|
|
|
|
<nick xmlns="http://jabber.org/nick/nick">The User</nick>
|
|
|
|
|
</presence>
|
|
|
|
|
|
|
|
|
|
Stanza Interface:
|
|
|
|
|
nick -- A global, friendly or informal name chosen by a user.
|
|
|
|
|
|
|
|
|
|
Methods:
|
|
|
|
|
getNick -- Return the nickname in the <nick> element.
|
|
|
|
|
setNick -- Add a <nick> element with the given nickname.
|
|
|
|
|
delNick -- Remove the <nick> element.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
namespace = 'http://jabber.org/nick/nick'
|
|
|
|
|
name = 'nick'
|
|
|
|
|
plugin_attrib = name
|
|
|
|
|
interfaces = set(('nick',))
|
|
|
|
|
|
|
|
|
|
def setNick(self, nick):
|
|
|
|
|
"""
|
|
|
|
|
Add a <nick> element with the given nickname.
|
|
|
|
|
|
|
|
|
|
Arguments:
|
|
|
|
|
nick -- A human readable, informal name.
|
|
|
|
|
"""
|
|
|
|
|
self.xml.text = nick
|
|
|
|
|
|
|
|
|
|
def getNick(self):
|
|
|
|
|
"""Return the nickname in the <nick> element."""
|
|
|
|
|
return self.xml.text
|
|
|
|
|
|
|
|
|
|
def delNick(self):
|
|
|
|
|
"""Remove the <nick> element."""
|
|
|
|
|
if self.parent is not None:
|
|
|
|
|
self.parent().xml.remove(self.xml)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
registerStanzaPlugin(Message, Nick)
|
|
|
|
|
registerStanzaPlugin(Presence, Nick)
|
