summaryrefslogtreecommitdiff
path: root/docs/api/plugins
diff options
context:
space:
mode:
authormathieui <mathieui@mathieui.net>2021-02-14 12:02:13 +0100
committermathieui <mathieui@mathieui.net>2021-02-26 00:08:56 +0100
commit9947d3db85e98a44a495f749d96b8632a10bde8d (patch)
tree34a1526fa6c8a42b1ac13a23df233d7e782a69db /docs/api/plugins
parentab87b2503042ec9cf226574fa68af1b5b9809cc7 (diff)
downloadslixmpp-9947d3db85e98a44a495f749d96b8632a10bde8d.tar.gz
slixmpp-9947d3db85e98a44a495f749d96b8632a10bde8d.tar.bz2
slixmpp-9947d3db85e98a44a495f749d96b8632a10bde8d.tar.xz
slixmpp-9947d3db85e98a44a495f749d96b8632a10bde8d.zip
XEP-0231: API changes
- ``get_bob`` and ``set_bob`` are now coroutines. - ``del_bob`` returns a Future.
Diffstat (limited to 'docs/api/plugins')
-rw-r--r--docs/api/plugins/xep_0231.rst34
1 files changed, 34 insertions, 0 deletions
diff --git a/docs/api/plugins/xep_0231.rst b/docs/api/plugins/xep_0231.rst
index 29f403ca..bed0e4bb 100644
--- a/docs/api/plugins/xep_0231.rst
+++ b/docs/api/plugins/xep_0231.rst
@@ -9,6 +9,40 @@ XEP-0231: Bits of Binary
:exclude-members: session_bind, plugin_init, plugin_end
+Internal API methods
+--------------------
+
+The default API handlers for this plugin manage an in-memory cache of
+bits of binary by content-id.
+
+.. glossary::
+
+ set_bob
+ - **jid**: :class:`~.JID` sending the bob
+ - **node**: unused
+ - **ifrom**: :class:`~JID` receiving the bob
+ - **args**: :class:`~.BitsOfBinary` element.
+
+ Set a BoB in the cache.
+
+ get_bob
+ - **jid**: :class:`~.JID` receiving the bob
+ - **node**: unused
+ - **ifrom**: :class:`~JID` sending the bob
+ - **args**: ``str`` content-id of the bob
+ - **returns**: :class:`~.BitsOfBinary` element.
+
+ Get a BoB from the cache.
+
+ del_bob
+ - **jid**: unused
+ - **node**: unused
+ - **ifrom**: :class:`~JID` sending the bob
+ - **args**: ``str`` content-id of the bob
+
+ Delete a BoB from the cache.
+
+
Stanza elements
---------------