Gecko [ goons4good.org ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2022-10-11 05:09
__init__.py	723 B	-rw-r--r--	2022-05-16 09:16
configparser.py	2.42 KB	-rw-r--r--	2022-05-16 09:16
json.py	1.65 KB	-rw-r--r--	2022-05-16 09:16
msgpack.py	3.34 KB	-rw-r--r--	2022-05-16 09:16
plist.py	2.07 KB	-rw-r--r--	2022-05-16 09:16
python.py	973 B	-rw-r--r--	2022-05-16 09:16
toml.py	1.43 KB	-rw-r--r--	2022-05-16 09:16
yaml.py	4.89 KB	-rw-r--r--	2022-05-16 09:16
yamlex.py	12.63 KB	-rw-r--r--	2022-05-16 09:16

Rename

"""
    salt.serializers.plist
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
    .. versionadded:: 3001

Implements plist serializer.

Wrapper around plistlib.
"""
import logging
import plistlib

from salt.serializers import DeserializationError, SerializationError

log = logging.getLogger(__name__)

__all__ = ["deserialize", "serialize", "available"]

available = True

def deserialize(stream_or_string, **options):
    """
    Deserialize any string or stream like object into a Python data structure.

:param stream_or_string: stream or string to deserialize.
    :param options: options given to lower plist module.

:returns: Deserialized data structure.
    """
    try:
        if not isinstance(stream_or_string, (bytes, str)):
            log.trace("Using plistlib.load to deserialize.")
            return plistlib.load(stream_or_string, **options)

if isinstance(stream_or_string, str):
            log.trace("Need to encode plist string.")
            stream_or_string = stream_or_string.encode("utf-8")

log.trace("Using plistlib.loads to deserialize.")
        return plistlib.loads(stream_or_string, **options)
    except Exception as error:  # pylint: disable=broad-except
        raise DeserializationError(error)

def serialize(value, **options):
    """
    Serialize Python data to plist. To create a binary plist pass
    ``fmt: FMT_BINARY`` as an option.

:param obj: the data structure to serialize
    :param options: options given to lower plist module.

:returns: bytes of serialized plist.
    """
    fmt = options.pop("fmt", None)
    # add support for serializing to binary.
    if fmt == "FMT_BINARY":
        log.trace("Adding plistlib.FMT_BINARY to options.")
        options["fmt"] = plistlib.FMT_BINARY

try:
        if "fp" in options:
            log.trace("Using plistlib.dump to serialize.")
            return plistlib.dump(value, **options)

log.trace("Using plistlib.dumps to serialize.")
        return plistlib.dumps(value, **options)
    except Exception as error:  # pylint: disable=broad-except
        raise SerializationError(error)