summaryrefslogtreecommitdiff
path: root/sleekxmpp/plugins/xep_0249/stanza.py
blob: 43bb65d0a5b861e25c9cc09d0e53357c724e93dd (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
from sleekxmpp.xmlstream import ElementBase


class Invite(ElementBase):
    """
    XMPP allows for an agent in an MUC room to directly invite another
    user to join the chat room (as opposed to a mediated invitation
    done through the server).

    Example invite stanza:
      <message from='crone1@shakespeare.lit/desktop'
          to='hecate@shakespeare.lit'>
        <x xmlns='jabber:x:conference'
           jid='darkcave@macbeth.shakespeare.lit'
           password='cauldronburn'
           reason='Hey Hecate, this is the place for all good witches!'/>
      </message>

    Stanza Interface:
        jid          -- The JID of the groupchat room
        password     -- The password used to gain entry in the room
                        (optional)
        reason       -- The reason for the invitation (optional)

    """
    name = "x"
    namespace = "jabber:x:conference"
    plugin_attrib = "groupchat_invite"
    interfaces = ("jid", "password", "reason")