File: //usr/lib/python2.7/site-packages/salt/serializers/msgpack.py
# -*- coding: utf-8 -*-
'''
salt.serializers.msgpack
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Implements MsgPack serializer.
'''
# Import Python libs
from __future__ import absolute_import, print_function, unicode_literals
import copy
import logging
# Import Salt Libs
import salt.utils.msgpack
from salt.serializers import DeserializationError, SerializationError
# Import 3rd-party libs
from salt.ext import six
log = logging.getLogger(__name__)
available = salt.utils.msgpack.HAS_MSGPACK
if not available:
def _fail():
raise RuntimeError('msgpack is not available')
def _serialize(obj, **options):
_fail()
def _deserialize(stream_or_string, **options):
_fail()
elif salt.utils.msgpack.version >= (0, 2, 0):
def _serialize(obj, **options):
try:
return salt.utils.msgpack.dumps(obj, **options)
except Exception as error: # pylint: disable=broad-except
raise SerializationError(error)
def _deserialize(stream_or_string, **options):
try:
options.setdefault('use_list', True)
options.setdefault('encoding', 'utf-8')
return salt.utils.msgpack.loads(stream_or_string, **options)
except Exception as error: # pylint: disable=broad-except
raise DeserializationError(error)
else: # msgpack.version < 0.2.0
def _encoder(obj):
'''
Since OrderedDict is identified as a dictionary, we can't make use of
msgpack custom types, we will need to convert by hand.
This means iterating through all elements of dictionaries, lists and
tuples.
'''
if isinstance(obj, dict):
data = [(key, _encoder(value)) for key, value in six.iteritems(obj)]
return dict(data)
elif isinstance(obj, (list, tuple)):
return [_encoder(value) for value in obj]
return copy.copy(obj)
def _decoder(obj):
return obj
def _serialize(obj, **options):
try:
obj = _encoder(obj)
return salt.utils.msgpack.dumps(obj, **options)
except Exception as error: # pylint: disable=broad-except
raise SerializationError(error)
def _deserialize(stream_or_string, **options):
options.setdefault('use_list', True)
try:
obj = salt.utils.msgpack.loads(stream_or_string)
return _decoder(obj)
except Exception as error: # pylint: disable=broad-except
raise DeserializationError(error)
serialize = _serialize
deserialize = _deserialize
serialize.__doc__ = '''
Serialize Python data to MsgPack.
:param obj: the data structure to serialize
:param options: options given to lower msgpack module.
'''
deserialize.__doc__ = '''
Deserialize any string of stream like object into a Python data structure.
:param stream_or_string: stream or string to deserialize.
:param options: options given to lower msgpack module.
'''