# -*- coding: utf-8 -*- # (c) 2020-2024, Alexei Znamensky # Copyright (c) 2020-2024, Ansible Project # Simplified BSD License (see LICENSES/BSD-2-Clause.txt or https://opensource.org/licenses/BSD-2-Clause) # SPDX-License-Identifier: BSD-2-Clause from __future__ import absolute_import, division, print_function __metaclass__ = type from ansible.module_utils.common.dict_transformations import dict_merge from ansible_collections.community.general.plugins.module_utils.vardict import VarDict from ansible_collections.community.general.plugins.module_utils.mh.base import ModuleHelperBase from ansible_collections.community.general.plugins.module_utils.mh.mixins.state import StateMixin from ansible_collections.community.general.plugins.module_utils.mh.mixins.deprecate_attrs import DeprecateAttrsMixin class ModuleHelper(DeprecateAttrsMixin, ModuleHelperBase): facts_name = None output_params = () diff_params = () change_params = () facts_params = () def __init__(self, module=None): super(ModuleHelper, self).__init__(module) self.vars = VarDict() for name, value in self.module.params.items(): self.vars.set( name, value, diff=name in self.diff_params, output=name in self.output_params, change=None if not self.change_params else name in self.change_params, fact=name in self.facts_params, ) def update_vars(self, meta=None, **kwargs): if meta is None: meta = {} for k, v in kwargs.items(): self.vars.set(k, v, **meta) def update_output(self, **kwargs): self.update_vars(meta={"output": True}, **kwargs) def update_facts(self, **kwargs): self.update_vars(meta={"fact": True}, **kwargs) def _vars_changed(self): return self.vars.has_changed def has_changed(self): return self.changed or self._vars_changed() @property def output(self): result = dict(self.vars.output()) if self.facts_name: facts = self.vars.facts() if facts is not None: result['ansible_facts'] = {self.facts_name: facts} if self.diff_mode: diff = result.get('diff', {}) vars_diff = self.vars.diff() or {} result['diff'] = dict_merge(dict(diff), vars_diff) return result class StateModuleHelper(StateMixin, ModuleHelper): pass