diff --git a/changelogs/fragments/6647-vardict-methods.yml b/changelogs/fragments/6647-vardict-methods.yml new file mode 100644 index 0000000000..75c2c8ccf4 --- /dev/null +++ b/changelogs/fragments/6647-vardict-methods.yml @@ -0,0 +1,4 @@ +minor_changes: + - vardict module utils - added convenience methods to ``VarDict`` (https://github.com/ansible-collections/community.general/pull/6647). +breaking_changes: + - vardict module utils - ``VarDict`` will no longer accept variables named ``_var``, ``get_meta``, and ``as_dict`` (https://github.com/ansible-collections/community.general/pull/6647). diff --git a/plugins/module_utils/vardict.py b/plugins/module_utils/vardict.py index c94ef669af..517b112bb4 100644 --- a/plugins/module_utils/vardict.py +++ b/plugins/module_utils/vardict.py @@ -66,6 +66,19 @@ class _Variable(object): if verbosity is not None: self.verbosity = verbosity + def as_dict(self, meta_only=False): + d = { + "diff": self.diff, + "change": self.change, + "output": self.output, + "fact": self.fact, + "verbosity": self.verbosity, + } + if not meta_only: + d["initial_value"] = copy.deepcopy(self.initial_value) + d["value"] = self.value + return d + def set_value(self, value): if not self.init: self.initial_value = copy.deepcopy(value) @@ -93,7 +106,7 @@ class _Variable(object): class VarDict(object): - reserved_names = ('__vars__', 'var', 'set_meta', 'set', 'output', 'diff', 'facts', 'has_changed') + reserved_names = ('__vars__', '_var', 'var', 'set_meta', 'get_meta', 'set', 'output', 'diff', 'facts', 'has_changed', 'as_dict') def __init__(self): self.__vars__ = dict() @@ -119,6 +132,9 @@ class VarDict(object): def _var(self, name): return self.__vars__[name] + def var(self, name): + return self._var(name).as_dict() + def set_meta(self, name, **kwargs): """Set the metadata for the variable @@ -133,6 +149,9 @@ class VarDict(object): """ self._var(name).set_meta(**kwargs) + def get_meta(self, name): + return self._var(name).as_dict(meta_only=True) + def set(self, name, value, **kwargs): """Set the value and optionally metadata for a variable. The variable is not required to exist prior to calling `set`. @@ -172,7 +191,7 @@ class VarDict(object): @property def has_changed(self): - return any(True for var in self.__vars__.values() if var.has_changed) + return any(var.has_changed for var in self.__vars__.values()) def as_dict(self): return dict((name, var.value) for name, var in self.__vars__.items()) diff --git a/tests/unit/plugins/module_utils/test_vardict.py b/tests/unit/plugins/module_utils/test_vardict.py index 27a5be1a99..01d710b445 100644 --- a/tests/unit/plugins/module_utils/test_vardict.py +++ b/tests/unit/plugins/module_utils/test_vardict.py @@ -131,3 +131,4 @@ def test_vardict_dict(): vd.set("zz", 789) assert vd.as_dict() == {"xx": 123, "yy": 456, "zz": 789} + assert vd.get_meta("xx") == {"output": True, "change": False, "diff": False, "fact": False, "verbosity": 0}