summaryrefslogtreecommitdiff
path: root/docs/api/plugins/xep_0115.rst
blob: 39ea133377226b02df56e696af1a5b994dd435d7 (plain)
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

XEP-0115: Entity Capabilities
=============================

.. module:: slixmpp.plugins.xep_0115

.. autoclass:: XEP_0115
    :members:
    :exclude-members: session_bind, plugin_init, plugin_end

Internal API methods
--------------------

This internal API extends the Disco internal API, and also manages an
in-memory cache of verstring→disco info, and fulljid→verstring.

.. glossary::

    cache_caps
        - **jid**: unused
        - **node**:  unused
        - **ifrom**: unused
        - **args**: a ``dict`` containing the verstring and
          :class:`~.DiscoInfo` payload (
          ``{'verstring': Optional[str], 'info': Optional[DiscoInfo]}``)

        Cache a verification string with its payload.

    get_caps
        - **jid**: JID to retrieve the verstring for (unused with the default
          handler)
        - **node**:  unused
        - **ifrom**: unused
        - **args**: a ``dict`` containing the verstring
          ``{'verstring': str}``
        - **returns**: The :class:`~.DiscoInfo` payload for that verstring.

        Get a disco payload from a verstring.

    assign_verstring
        - **jid**: :class:`~.JID` (full) to assign the verstring to
        - **node**:  unused
        - **ifrom**: unused
        - **args**: a ``dict`` containing the verstring
          ``{'verstring': str}``

        Cache JID→verstring information.

    get_verstring
        - **jid**: :class:`~.JID` to use for fetching the verstring
        - **node**:  unused
        - **ifrom**: unused
        - **args**: unused
        - **returns**: ``str``, the verstring

        Retrieve a verstring for a JID.

Stanza elements
---------------

.. automodule:: slixmpp.plugins.xep_0115.stanza
    :members:
    :undoc-members: