pip_services3_commons.convert.RecursiveMapConverter module

pip_services3_commons.convert.RecursiveMapConverter

Recursive map conversion utilities

copyright: Conceptual Vision Consulting LLC 2018-2019, see AUTHORS for more details.
license: MIT, see LICENSE for more details.

class pip_services3_commons.convert.RecursiveMapConverter.RecursiveMapConverter

Bases: object

Converts arbitrary values into map objects using extended conversion __rules. This class is similar to MapConverter, but is recursively converts all values stored in objects and arrays.

Example:

value1 = RecursiveMapConverted.to_nullable_map("ABC")        # Result: None
value2 = RecursiveMapConverted.to_nullable_map({ key: 123 }) # Result: { key: 123 }
value3 = RecursiveMapConverted.to_nullable_map([1,[2,3])     # Result: { "0": 1, { "0": 2, "1": 3 } }

static to_map(value: Any) → Any

Converts args into map object or returns empty map when conversion is not possible

Parameters: value – the args to convert.
Returns: map object or empty map when conversion is not supported.

static to_map_with_default(value: Any, default_value: Any) → Any

Converts args into map object or returns default when conversion is not possible

Parameters

value – the args to convert.
default_value – the default args.

Returns

map object or emptu map when conversion is not supported.

static to_nullable_map(value: Any) → Any

Converts args into map object or returns null when conversion is not possible.

Parameters: value – the args to convert.
Returns: map object or null when conversion is not supported.