|
Size: 261
Comment:
|
← Revision 7 as of 2023-06-15 18:40:42 ⇥
Size: 1843
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| '''`json`''' is a module that supports encoding and decoding JSON files. | '''`json`''' is a module that supports (de-)serializing JSON files. |
| Line 6: | Line 6: |
---- == 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. |
|
| Line 15: | Line 102: |
| [[https://pymotw.com/3/json/|Python Module of the Day article for json]] |
Python Json
json is a module that supports (de-)serializing JSON files.
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.
See also
Python json module documentation
Python Module of the Day article for json