diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 16:04:21 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 16:04:21 +0000 |
commit | 8a754e0858d922e955e71b253c139e071ecec432 (patch) | |
tree | 527d16e74bfd1840c85efd675fdecad056c54107 /lib/ansible/utils/unsafe_proxy.py | |
parent | Initial commit. (diff) | |
download | ansible-core-8a754e0858d922e955e71b253c139e071ecec432.tar.xz ansible-core-8a754e0858d922e955e71b253c139e071ecec432.zip |
Adding upstream version 2.14.3.upstream/2.14.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'lib/ansible/utils/unsafe_proxy.py')
-rw-r--r-- | lib/ansible/utils/unsafe_proxy.py | 128 |
1 files changed, 128 insertions, 0 deletions
diff --git a/lib/ansible/utils/unsafe_proxy.py b/lib/ansible/utils/unsafe_proxy.py new file mode 100644 index 0000000..d78ebf6 --- /dev/null +++ b/lib/ansible/utils/unsafe_proxy.py @@ -0,0 +1,128 @@ +# PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2 +# -------------------------------------------- +# +# 1. This LICENSE AGREEMENT is between the Python Software Foundation +# ("PSF"), and the Individual or Organization ("Licensee") accessing and +# otherwise using this software ("Python") in source or binary form and +# its associated documentation. +# +# 2. Subject to the terms and conditions of this License Agreement, PSF hereby +# grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce, +# analyze, test, perform and/or display publicly, prepare derivative works, +# distribute, and otherwise use Python alone or in any derivative version, +# provided, however, that PSF's License Agreement and PSF's notice of copyright, +# i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, +# 2011, 2012, 2013, 2014 Python Software Foundation; All Rights Reserved" are +# retained in Python alone or in any derivative version prepared by Licensee. +# +# 3. In the event Licensee prepares a derivative work that is based on +# or incorporates Python or any part thereof, and wants to make +# the derivative work available to others as provided herein, then +# Licensee hereby agrees to include in any such work a brief summary of +# the changes made to Python. +# +# 4. PSF is making Python available to Licensee on an "AS IS" +# basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +# IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND +# DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +# FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT +# INFRINGE ANY THIRD PARTY RIGHTS. +# +# 5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON +# FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS +# A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, +# OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. +# +# 6. This License Agreement will automatically terminate upon a material +# breach of its terms and conditions. +# +# 7. Nothing in this License Agreement shall be deemed to create any +# relationship of agency, partnership, or joint venture between PSF and +# Licensee. This License Agreement does not grant permission to use PSF +# trademarks or trade name in a trademark sense to endorse or promote +# products or services of Licensee, or any third party. +# +# 8. By copying, installing or otherwise using Python, Licensee +# agrees to be bound by the terms and conditions of this License +# Agreement. +# +# Original Python Recipe for Proxy: +# http://code.activestate.com/recipes/496741-object-proxying/ +# Author: Tomer Filiba + +from __future__ import (absolute_import, division, print_function) +__metaclass__ = type + +from collections.abc import Mapping, Set + +from ansible.module_utils._text import to_bytes, to_text +from ansible.module_utils.common.collections import is_sequence +from ansible.module_utils.six import string_types, binary_type, text_type +from ansible.utils.native_jinja import NativeJinjaText + + +__all__ = ['AnsibleUnsafe', 'wrap_var'] + + +class AnsibleUnsafe(object): + __UNSAFE__ = True + + +class AnsibleUnsafeBytes(binary_type, AnsibleUnsafe): + def decode(self, *args, **kwargs): + """Wrapper method to ensure type conversions maintain unsafe context""" + return AnsibleUnsafeText(super(AnsibleUnsafeBytes, self).decode(*args, **kwargs)) + + +class AnsibleUnsafeText(text_type, AnsibleUnsafe): + def encode(self, *args, **kwargs): + """Wrapper method to ensure type conversions maintain unsafe context""" + return AnsibleUnsafeBytes(super(AnsibleUnsafeText, self).encode(*args, **kwargs)) + + +class NativeJinjaUnsafeText(NativeJinjaText, AnsibleUnsafeText): + pass + + +def _wrap_dict(v): + return dict((wrap_var(k), wrap_var(item)) for k, item in v.items()) + + +def _wrap_sequence(v): + """Wraps a sequence with unsafe, not meant for strings, primarily + ``tuple`` and ``list`` + """ + v_type = type(v) + return v_type(wrap_var(item) for item in v) + + +def _wrap_set(v): + return set(wrap_var(item) for item in v) + + +def wrap_var(v): + if v is None or isinstance(v, AnsibleUnsafe): + return v + + if isinstance(v, Mapping): + v = _wrap_dict(v) + elif isinstance(v, Set): + v = _wrap_set(v) + elif is_sequence(v): + v = _wrap_sequence(v) + elif isinstance(v, NativeJinjaText): + v = NativeJinjaUnsafeText(v) + elif isinstance(v, binary_type): + v = AnsibleUnsafeBytes(v) + elif isinstance(v, text_type): + v = AnsibleUnsafeText(v) + + return v + + +def to_unsafe_bytes(*args, **kwargs): + return wrap_var(to_bytes(*args, **kwargs)) + + +def to_unsafe_text(*args, **kwargs): + return wrap_var(to_text(*args, **kwargs)) |