1#@!#!123s

: / proc / self / root / opt / saltstack / salt / lib / python3.10 / site-packages / salt / states /
Filename : eselect.py
back
"""
Management of Gentoo configuration using eselect
================================================

A state module to manage Gentoo configuration via eselect

"""


# Define a function alias in order not to shadow built-in's
__func_alias__ = {"set_": "set"}


def __virtual__():
    """
    Only load if the eselect module is available in __salt__
    """
    if "eselect.exec_action" in __salt__:
        return "eselect"
    return (False, "eselect module could not be loaded")


def set_(name, target, module_parameter=None, action_parameter=None):
    """
    Verify that the given module is set to the given target

    name
        The name of the module

    target
        The target to be set for this module

    module_parameter
        additional params passed to the defined module

    action_parameter
        additional params passed to the defined action

    .. code-block:: yaml

        profile:
          eselect.set:
            - target: hardened/linux/amd64
    """
    ret = {"changes": {}, "comment": "", "name": name, "result": True}

    old_target = __salt__["eselect.get_current_target"](
        name, module_parameter=module_parameter, action_parameter=action_parameter
    )

    if target == old_target:
        ret["comment"] = "Target '{}' is already set on '{}' module.".format(
            target, name
        )
    elif target not in __salt__["eselect.get_target_list"](
        name, action_parameter=action_parameter
    ):
        ret["comment"] = "Target '{}' is not available for '{}' module.".format(
            target, name
        )
        ret["result"] = False
    elif __opts__["test"]:
        ret["comment"] = "Target '{}' will be set on '{}' module.".format(target, name)
        ret["result"] = None
    else:
        result = __salt__["eselect.set_target"](
            name,
            target,
            module_parameter=module_parameter,
            action_parameter=action_parameter,
        )
        if result:
            ret["changes"][name] = {"old": old_target, "new": target}
            ret["comment"] = "Target '{}' set on '{}' module.".format(target, name)
        else:
            ret["comment"] = "Target '{}' failed to be set on '{}' module.".format(
                target, name
            )
            ret["result"] = False
    return ret