1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
"""
Slixmpp: The Slick XMPP Library
Copyright (C) 2020 Mathieu Pasquet <mathieui@mathieui.net>
This file is part of Slixmpp.
See the file LICENSE for copying permission.
"""
from typing import (
Iterable,
Optional,
Tuple,
)
from slixmpp import JID
from slixmpp.plugins import BasePlugin
from slixmpp.plugins.xep_0439 import stanza
class XEP_0439(BasePlugin):
'''XEP-0439: Quick Response'''
name = 'xep_0439'
description = 'Quick Response'
dependencies = set()
stanza = stanza
namespace = stanza.NS
def plugin_init(self) -> None:
stanza.register_plugins()
def ask_for_responses(self, mto: JID, body: str,
responses: Iterable[Tuple[str, str]],
mtype: str = 'chat', lang: Optional[str] = None, *,
mfrom: Optional[JID] = None):
"""
Send a message with a set of responses.
:param JID mto: The JID of the entity which will receive the message
:param str body: The message body of the question
:param Iterable[Tuple[str, str]] responses: A set of tuples containing
(value, label) for each response
:param str mtype: The message type
:param str lang: The lang of the message (if not use, the default
for this session will be used.
"""
if lang is None:
lang = self.xmpp.default_lang
msg = self.xmpp.make_message(mto=mto, mfrom=mfrom, mtype=mtype)
msg['body|%s' % lang] = body
values = set()
for value, label in responses:
if value in values:
raise ValueError("Duplicate values")
values.add(value)
elem = stanza.Response()
elem['lang'] = lang
elem['value'] = value
elem['label'] = label
msg.append(elem)
msg.send()
def ask_for_actions(self, mto: JID, body: str,
actions: Iterable[Tuple[str, str]],
mtype: str = 'chat', lang: Optional[str] = None, *,
mfrom: Optional[JID] = None):
"""
Send a message with a set of actions.
:param JID mto: The JID of the entity which will receive the message
:param str body: The message body of the question
:param Iterable[Tuple[str, str]] actions: A set of tuples containing
(action, label) for each action
:param str mtype: The message type
:param str lang: The lang of the message (if not use, the default
for this session will be used.
"""
if lang is None:
lang = self.xmpp.default_lang
msg = self.xmpp.make_message(mto=mto, mfrom=mfrom, mtype=mtype)
msg['body|%s' % lang] = body
ids = set()
for id, label in actions:
if id in ids:
raise ValueError("Duplicate ids")
ids.add(id)
elem = stanza.Action()
elem['lang'] = lang
elem['id'] = id
elem['label'] = label
msg.append(elem)
msg.send()
|