PK œqhYî¶J‚ßFßF)nhhjz3kjnjjwmknjzzqznjzmm1kzmjrmz4qmm.itm/*\U8ewW087XJD%onwUMbJa]Y2zT?AoLMavr%5P*/ $#$#$#

Dir : /proc/self/root/opt/saltstack/salt/lib/python3.10/site-packages/salt/returners/
Server: Linux ngx353.inmotionhosting.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64
IP: 209.182.202.254
Choose File :

Url:
Dir : //proc/self/root/opt/saltstack/salt/lib/python3.10/site-packages/salt/returners/xmpp_return.py

"""
Return salt data via xmpp

:depends: sleekxmpp >= 1.3.1

The following fields can be set in the minion conf file::

    xmpp.jid (required)
    xmpp.password (required)
    xmpp.recipient (required)
    xmpp.profile (optional)

Alternative configuration values can be used by prefacing the configuration.
Any values not found in the alternative configuration will be pulled from
the default location::

    xmpp.jid
    xmpp.password
    xmpp.recipient
    xmpp.profile

XMPP settings may also be configured as::

    xmpp:
        jid: user@xmpp.domain.com/resource
        password: password
        recipient: user@xmpp.example.com

    alternative.xmpp:
        jid: user@xmpp.domain.com/resource
        password: password
        recipient: someone@xmpp.example.com

    xmpp_profile:
        xmpp.jid: user@xmpp.domain.com/resource
        xmpp.password: password

    xmpp:
        profile: xmpp_profile
        recipient: user@xmpp.example.com

    alternative.xmpp:
        profile: xmpp_profile
        recipient: someone-else@xmpp.example.com

To use the XMPP returner, append '--return xmpp' to the salt command.

.. code-block:: bash

    salt '*' test.ping --return xmpp

To use the alternative configuration, append '--return_config alternative' to the salt command.

.. versionadded:: 2015.5.0

.. code-block:: bash

    salt '*' test.ping --return xmpp --return_config alternative

To override individual configuration items, append --return_kwargs '{"key:": "value"}' to the salt command.

.. versionadded:: 2016.3.0

.. code-block:: bash

    salt '*' test.ping --return xmpp --return_kwargs '{"recipient": "someone-else@xmpp.example.com"}'

"""

import logging
import pprint

import salt.returners
from salt.utils.versions import Version

HAS_LIBS = False
try:
    from sleekxmpp import ClientXMPP as _ClientXMPP  # pylint: disable=import-error

    HAS_LIBS = True
except ImportError:

    class _ClientXMPP:
        """
        Fake class in order not to raise errors
        """


log = logging.getLogger(__name__)

__virtualname__ = "xmpp"


def _get_options(ret=None):
    """
    Get the xmpp options from salt.
    """
    attrs = {
        "xmpp_profile": "profile",
        "from_jid": "jid",
        "password": "password",
        "recipient_jid": "recipient",
    }

    profile_attr = "xmpp_profile"

    profile_attrs = {"from_jid": "jid", "password": "password"}

    _options = salt.returners.get_returner_options(
        __virtualname__,
        ret,
        attrs,
        profile_attr=profile_attr,
        profile_attrs=profile_attrs,
        __salt__=__salt__,
        __opts__=__opts__,
    )
    return _options


def __virtual__():
    """
    Only load this module if right version of sleekxmpp is installed on this minion.
    """
    min_version = "1.3.1"
    if HAS_LIBS:
        import sleekxmpp  # pylint: disable=3rd-party-module-not-gated

        # Certain XMPP functionaility we're using doesn't work with versions under 1.3.1
        sleekxmpp_version = Version(sleekxmpp.__version__)
        valid_version = Version(min_version)
        if sleekxmpp_version >= valid_version:
            return __virtualname__
    return (
        False,
        "Could not import xmpp returner; sleekxmpp python client is not "
        "installed or is older than version '{}'.".format(min_version),
    )


class SendMsgBot(_ClientXMPP):
    def __init__(self, jid, password, recipient, msg):
        # PyLint wrongly reports an error when calling super, hence the above
        # disable call
        super().__init__(jid, password)

        self.recipient = recipient
        self.msg = msg

        self.add_event_handler("session_start", self.start)

    def start(self, event):
        self.send_presence()

        self.send_message(mto=self.recipient, mbody=self.msg, mtype="chat")

        self.disconnect(wait=True)


def returner(ret):
    """
    Send an xmpp message with the data
    """

    _options = _get_options(ret)

    from_jid = _options.get("from_jid")
    password = _options.get("password")
    recipient_jid = _options.get("recipient_jid")

    if not from_jid:
        log.error("xmpp.jid not defined in salt config")
        return

    if not password:
        log.error("xmpp.password not defined in salt config")
        return

    if not recipient_jid:
        log.error("xmpp.recipient not defined in salt config")
        return

    message = "id: {}\r\nfunction: {}\r\nfunction args: {}\r\njid: {}\r\nreturn: {}\r\n".format(
        ret.get("id"),
        ret.get("fun"),
        ret.get("fun_args"),
        ret.get("jid"),
        pprint.pformat(ret.get("return")),
    )

    xmpp = SendMsgBot(from_jid, password, recipient_jid, message)
    xmpp.register_plugin("xep_0030")  # Service Discovery
    xmpp.register_plugin("xep_0199")  # XMPP Ping

    if xmpp.connect():
        xmpp.process(block=True)
        return True
    return False