summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--slixmpp/plugins/xep_0333/markers.py31
-rw-r--r--slixmpp/plugins/xep_0333/stanza.py13
2 files changed, 39 insertions, 5 deletions
diff --git a/slixmpp/plugins/xep_0333/markers.py b/slixmpp/plugins/xep_0333/markers.py
index 5a3d3f9a..b8a003df 100644
--- a/slixmpp/plugins/xep_0333/markers.py
+++ b/slixmpp/plugins/xep_0333/markers.py
@@ -7,8 +7,9 @@
"""
import logging
+from typing import Optional
-from slixmpp import Message
+from slixmpp import Message, JID
from slixmpp.plugins import BasePlugin
from slixmpp.xmlstream import register_stanza_plugin
from slixmpp.xmlstream.handler import Callback
@@ -22,6 +23,7 @@ class XEP_0333(BasePlugin):
name = 'xep_0333'
description = 'XEP-0333: Chat Markers'
stanza = stanza
+ dependencies = {'xep_0030'}
def plugin_init(self):
register_stanza_plugin(Message, Markable)
@@ -42,6 +44,12 @@ class XEP_0333(BasePlugin):
StanzaPath('message/acknowledged'),
self._handle_acknowledged))
+ def session_bind(self, jid):
+ self.xmpp.plugin['xep_0030'].add_feature(stanza.NS)
+
+ def plugin_end(self):
+ self.xmpp.plugin['xep_0030'].del_feature(feature=stanza.NS)
+
def _handle_received(self, message):
self.xmpp.event('marker_received', message)
self.xmpp.event('marker', message)
@@ -53,3 +61,24 @@ class XEP_0333(BasePlugin):
def _handle_acknowledged(self, message):
self.xmpp.event('marker_acknowledged', message)
self.xmpp.event('marker', message)
+
+ def send_marker(self, mto: JID, id: str, marker: str,
+ thread: Optional[str] = None, *,
+ mfrom: Optional[JID] = None):
+ """
+ Send a chat marker.
+
+ :param JID mto: recipient of the marker
+ :param str id: Identifier of the marked message
+ :param str marker: Marker to send (one of
+ displayed, retrieved, or acknowledged)
+ :param str thread: Message thread
+ :param str mfrom: Use a specific JID to send the message
+ """
+ if marker not in ('displayed', 'retrieved', 'acknowledged'):
+ raise ValueError('Invalid marker: %s' % marker)
+ msg = self.xmpp.make_message(mto=mto, mfrom=mfrom)
+ if thread:
+ msg['thread'] = thread
+ msg[marker]['id'] = id
+ msg.send()
diff --git a/slixmpp/plugins/xep_0333/stanza.py b/slixmpp/plugins/xep_0333/stanza.py
index 42cfc21a..77cd47a4 100644
--- a/slixmpp/plugins/xep_0333/stanza.py
+++ b/slixmpp/plugins/xep_0333/stanza.py
@@ -8,25 +8,30 @@
from slixmpp.xmlstream import ElementBase
+NS ='urn:xmpp:chat-markers:0'
+
class Markable(ElementBase):
name = 'markable'
plugin_attrib = 'markable'
- namespace = 'urn:xmpp:chat-markers:0'
+ namespace = NS
+
class Received(ElementBase):
name = 'received'
plugin_attrib = 'received'
- namespace = 'urn:xmpp:chat-markers:0'
+ namespace = NS
interfaces = {'id'}
+
class Displayed(ElementBase):
name = 'displayed'
plugin_attrib = 'displayed'
- namespace = 'urn:xmpp:chat-markers:0'
+ namespace = NS
interfaces = {'id'}
+
class Acknowledged(ElementBase):
name = 'acknowledged'
plugin_attrib = 'acknowledged'
- namespace = 'urn:xmpp:chat-markers:0'
+ namespace = NS
interfaces = {'id'}