mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
131 lines
4 KiB
Python
131 lines
4 KiB
Python
# (c) 2012-2014, Michael DeHaan <michael.dehaan@gmail.com>
|
|
#
|
|
# This file is part of Ansible
|
|
#
|
|
# Ansible is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# Ansible is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
# Make coding more python3-ish
|
|
from __future__ import (absolute_import, division, print_function)
|
|
__metaclass__ = type
|
|
|
|
import ast
|
|
from json import JSONEncoder
|
|
from collections import MutableMapping
|
|
|
|
from ansible.compat.six import iteritems, string_types
|
|
|
|
from ansible import constants as C
|
|
from ansible.errors import AnsibleError
|
|
from ansible.parsing.splitter import parse_kv
|
|
from ansible.utils.unicode import to_unicode
|
|
|
|
def _validate_mutable_mappings(a, b):
|
|
"""
|
|
Internal convenience function to ensure arguments are MutableMappings
|
|
|
|
This checks that all arguments are MutableMappings or raises an error
|
|
|
|
:raises AnsibleError: if one of the arguments is not a MutableMapping
|
|
"""
|
|
|
|
# If this becomes generally needed, change the signature to operate on
|
|
# a variable number of arguments instead.
|
|
|
|
if not (isinstance(a, MutableMapping) and isinstance(b, MutableMapping)):
|
|
raise AnsibleError("failed to combine variables, expected dicts but"
|
|
" got a '{0}' and a '{1}'".format(
|
|
a.__class__.__name__, b.__class__.__name__))
|
|
|
|
def combine_vars(a, b):
|
|
"""
|
|
Return a copy of dictionaries of variables based on configured hash behavior
|
|
"""
|
|
|
|
if C.DEFAULT_HASH_BEHAVIOUR == "merge":
|
|
return merge_hash(a, b)
|
|
else:
|
|
# HASH_BEHAVIOUR == 'replace'
|
|
_validate_mutable_mappings(a, b)
|
|
result = a.copy()
|
|
result.update(b)
|
|
return result
|
|
|
|
def merge_hash(a, b):
|
|
"""
|
|
Recursively merges hash b into a so that keys from b take precedence over keys from a
|
|
"""
|
|
|
|
_validate_mutable_mappings(a, b)
|
|
result = a.copy()
|
|
|
|
# next, iterate over b keys and values
|
|
for k, v in iteritems(b):
|
|
# if there's already such key in a
|
|
# and that key contains a MutableMapping
|
|
if k in result and isinstance(result[k], MutableMapping):
|
|
# merge those dicts recursively
|
|
result[k] = merge_hash(result[k], v)
|
|
else:
|
|
# otherwise, just copy the value from b to a
|
|
result[k] = v
|
|
|
|
return result
|
|
|
|
def load_extra_vars(loader, options):
|
|
extra_vars = {}
|
|
for extra_vars_opt in options.extra_vars:
|
|
extra_vars_opt = to_unicode(extra_vars_opt, errors='strict')
|
|
if extra_vars_opt.startswith(u"@"):
|
|
# Argument is a YAML file (JSON is a subset of YAML)
|
|
data = loader.load_from_file(extra_vars_opt[1:])
|
|
elif extra_vars_opt and extra_vars_opt[0] in u'[{':
|
|
# Arguments as YAML
|
|
data = loader.load(extra_vars_opt)
|
|
else:
|
|
# Arguments as Key-value
|
|
data = parse_kv(extra_vars_opt)
|
|
extra_vars = combine_vars(extra_vars, data)
|
|
return extra_vars
|
|
|
|
def isidentifier(ident):
|
|
"""
|
|
Determines, if string is valid Python identifier using the ast module.
|
|
Orignally posted at: http://stackoverflow.com/a/29586366
|
|
"""
|
|
|
|
if not isinstance(ident, string_types):
|
|
return False
|
|
|
|
try:
|
|
root = ast.parse(ident)
|
|
except SyntaxError:
|
|
return False
|
|
|
|
if not isinstance(root, ast.Module):
|
|
return False
|
|
|
|
if len(root.body) != 1:
|
|
return False
|
|
|
|
if not isinstance(root.body[0], ast.Expr):
|
|
return False
|
|
|
|
if not isinstance(root.body[0].value, ast.Name):
|
|
return False
|
|
|
|
if root.body[0].value.id != ident:
|
|
return False
|
|
|
|
return True
|
|
|