1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
.. include:: ../README.rst
Main components
---------------------------------------
Support for numpy, pandas and other libraries should work automatically if those libraries are installed. They are not installed automatically as dependencies because `json-tricks` can be used without them.
dumps
+++++++++++++++++++++++++++++++++++++++
.. autofunction:: json_tricks.nonp.dumps
.. autofunction:: json_tricks.np.dumps
dump
+++++++++++++++++++++++++++++++++++++++
.. autofunction:: json_tricks.nonp.dump
.. autofunction:: json_tricks.np.dump
loads
+++++++++++++++++++++++++++++++++++++++
.. autofunction:: json_tricks.nonp.loads
.. autofunction:: json_tricks.np.loads
load
+++++++++++++++++++++++++++++++++++++++
.. autofunction:: json_tricks.nonp.load
.. autofunction:: json_tricks.np.load
Utilities
---------------------------------------
strip comments
+++++++++++++++++++++++++++++++++++++++
.. autofunction:: json_tricks.comment.strip_comments
numpy
+++++++++++++++++++++++++++++++++++++++
.. autofunction:: json_tricks.np.numpy_encode
.. autofunction:: json_tricks.np.json_numpy_obj_hook
class instances
+++++++++++++++++++++++++++++++++++++++
.. autofunction:: json_tricks.encoders.class_instance_encode
.. autoclass:: json_tricks.decoders.ClassInstanceHook
enum instances
+++++++++++++++++++++++++++++++++++++++
Support for enums was added in Python 3.4. Support for previous versions of Python is available with the `enum 34`_ package.
.. autofunction:: json_tricks.encoders.enum_instance_encode
.. autoclass:: json_tricks.decoders.EnumInstanceHook
By default ``IntEnum`` cannot be encoded as enums since they cannot be differenciated from integers. To serialize them, you must use `encode_intenums_inplace` which mutates a nested data structure (in place!) to replace any ``IntEnum`` by their representation. If you serialize this result, it can subsequently be loaded without further adaptations.
.. autofunction:: json_tricks.utils.encode_intenums_inplace
date/time
+++++++++++++++++++++++++++++++++++++++
.. autofunction:: json_tricks.encoders.json_date_time_encode
.. autofunction:: json_tricks.decoders.json_date_time_hook
numpy scalars
+++++++++++++++++++++++++++++++++++++++
It's not possible (without a lot of hacks) to encode numpy scalars. This is the case because some numpy scalars (`float64`, and depending on Python version also `int64`) are subclasses of `float` and `int`. This means that the Python json encoder will stringify them without them ever reaching the custom encoders.
So if you really want to encode numpy scalars, you'll have to do the conversion beforehand. For that purpose you can use `encode_scalars_inplace`, which mutates a nested data structure (in place!) to replace any numpy scalars by their representation. If you serialize this result, it can subsequently be loaded without further adaptations.
It's not great, but unless the Python json module changes, it's the best that can be done. See `issue 18`_ for more details.
.. autofunction:: json_tricks.np_utils.encode_scalars_inplace
Table of content
---------------------------------------
This is a simple module so the documentation is single-page.
.. toctree::
:maxdepth: 2
.. _`issue 18`: https://github.com/mverleg/pyjson_tricks/issues/18
.. _`enum 34`: https://pypi.org/project/enum34/
|
