json¶

Utility functions related to json.

Attributes¶

JsonDataSelf

Classes¶

`JsonError`
`JsonDataInvalidJsonError`	An error thrown when input data string does not represent a dictionary.
`JsonData`	An object to represent JSON data content.

Functions¶

`dump_to_json_file`(→ None)	Dump a Python object to a json file.
`load_from_json_file`(→ Any)	Load a Python object from a JSON file.

Module Contents¶

json.JsonDataSelf¶

class json.JsonError¶: Bases: e3.error.E3Error

class json.JsonDataInvalidJsonError¶

Bases: e3.error.E3Error

An error thrown when input data string does not represent a dictionary.

class json.JsonData¶

Bases: abc.ABC

An object to represent JSON data content.

abstractmethod as_dict() → dict[str, object]¶: Return the dict representation of this JSON data object.

__eq__(other: object) → bool¶

Check if this JSON data is identical to other.

Parameters:: other – The object to compare this JSON data with.
Returns:: A bool set to True if both JSON data are identical, False if they are not, or if other is not a JsonData object.

as_json() → str¶: Return a JSON string representing this JSON data.

See also

python:json.dumps()

classmethod from_dict(obj: dict) → JsonDataSelf¶

Load a dictionary as a JSON data object.

Parameters:: obj – The dictionary to initialize the JSON data object with.
Returns:: A new JsonData object initialized with values from the input dictionary.

classmethod from_json(content: str) → JsonDataSelf¶

Load a JSON string as a JSON data object.

As this method calls for from_dict(), the input content string MUST represent a dictionary. If that’s not the case, a JsonDataInvalidJsonError is thrown.

Parameters:: content – The JSON string to initialize the JSON data object with.
Returns:: A new JsonData object initialized with values from the input dictionary.
Raise:: JsonDataInvalidJsonError when content string does not represent a dictionary.