:mod:`json` -- JSON encoding and decoding ========================================= .. module:: json :synopsis: JSON encoding and decoding |see_cpython_module| :mod:`python:json`. This modules allows to convert between Python objects and the JSON data format. Functions --------- .. function:: dump(obj, stream, separators=None) Serialise *obj* to a JSON string, writing it to the given *stream*. If specified, separators should be an ``(item_separator, key_separator)`` tuple. The default is ``(', ', ': ')``. To get the most compact JSON representation, you should specify ``(',', ':')`` to eliminate whitespace. .. function:: dumps(obj, separators=None) Return *obj* represented as a JSON string. The arguments have the same meaning as in `dump`. .. function:: load(stream) Parse the given *stream*, interpreting it as a JSON string and deserialising the data to a Python object. The resulting object is returned. Parsing continues until end-of-file is encountered. A :exc:`ValueError` is raised if the data in *stream* is not correctly formed. .. function:: loads(str) Parse the JSON *str* and return an object. Raises :exc:`ValueError` if the string is not correctly formed.