Python Json

json is a module that supports (de-)serializing JSON files.

Contents

Python Json

Example

some_object = {"a": "a", "b": [1, 2.1]}
some_string = json.dumps(some_object)           # '{"a": "a", "b": [1, 2.1]}'
assert some_object == json.loads(some_string)   # True

Usage

JSON and Python objects are translated as:

JSON	Python
object	dict
array	list
string	str
number (int)	int
number (real)	float
`true`	`True`
`false`	`False`
`null`	`None`

Dump

Serialize an object and write it to a file.

with open('example.json', 'w') as f:
    json.dump(['example'], f)

Can also be used with a filestream object.

from io import StringIO
io = StringIO()
json.dump(['example'], io)

DumpS

Serialize an object into a JSON-encoded string.

All dictionary keys are coerced into strings for this serialization. This may break roundtrip conversions.

Load

Deserialize a JSON-encoded file.

with open('example.json', 'r') as f:
    some_object = json.load(f)

If the file is opened as a binary file (i.e. 'rb' instead of 'r'), it should be UTF-{8,16,32} encoded.

LoadS

Deserialize a JSON-encoded str-like object.

The str-like object can be any of str, byte, or bytearray types, as long as it is UTF-{8,16,32} encoded.

Python/Json