##// END OF EJS Templates
Backport PR #2194: clean nan/inf in json_clean...
MinRK -
Show More
@@ -1,200 +1,207 b''
1 """Utilities to manipulate JSON objects.
1 """Utilities to manipulate JSON objects.
2 """
2 """
3 #-----------------------------------------------------------------------------
3 #-----------------------------------------------------------------------------
4 # Copyright (C) 2010-2011 The IPython Development Team
4 # Copyright (C) 2010-2011 The IPython Development Team
5 #
5 #
6 # Distributed under the terms of the BSD License. The full license is in
6 # Distributed under the terms of the BSD License. The full license is in
7 # the file COPYING.txt, distributed as part of this software.
7 # the file COPYING.txt, distributed as part of this software.
8 #-----------------------------------------------------------------------------
8 #-----------------------------------------------------------------------------
9
9
10 #-----------------------------------------------------------------------------
10 #-----------------------------------------------------------------------------
11 # Imports
11 # Imports
12 #-----------------------------------------------------------------------------
12 #-----------------------------------------------------------------------------
13 # stdlib
13 # stdlib
14 import math
14 import re
15 import re
15 import sys
16 import sys
16 import types
17 import types
17 from base64 import encodestring
18 from base64 import encodestring
18 from datetime import datetime
19 from datetime import datetime
19
20
20 from IPython.utils import py3compat
21 from IPython.utils import py3compat
21 from IPython.utils.encoding import DEFAULT_ENCODING
22 from IPython.utils.encoding import DEFAULT_ENCODING
22 from IPython.utils import text
23 from IPython.utils import text
23 next_attr_name = '__next__' if py3compat.PY3 else 'next'
24 next_attr_name = '__next__' if py3compat.PY3 else 'next'
24
25
25 #-----------------------------------------------------------------------------
26 #-----------------------------------------------------------------------------
26 # Globals and constants
27 # Globals and constants
27 #-----------------------------------------------------------------------------
28 #-----------------------------------------------------------------------------
28
29
29 # timestamp formats
30 # timestamp formats
30 ISO8601="%Y-%m-%dT%H:%M:%S.%f"
31 ISO8601="%Y-%m-%dT%H:%M:%S.%f"
31 ISO8601_PAT=re.compile(r"^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d+$")
32 ISO8601_PAT=re.compile(r"^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d+$")
32
33
33 #-----------------------------------------------------------------------------
34 #-----------------------------------------------------------------------------
34 # Classes and functions
35 # Classes and functions
35 #-----------------------------------------------------------------------------
36 #-----------------------------------------------------------------------------
36
37
37 def rekey(dikt):
38 def rekey(dikt):
38 """Rekey a dict that has been forced to use str keys where there should be
39 """Rekey a dict that has been forced to use str keys where there should be
39 ints by json."""
40 ints by json."""
40 for k in dikt.iterkeys():
41 for k in dikt.iterkeys():
41 if isinstance(k, basestring):
42 if isinstance(k, basestring):
42 ik=fk=None
43 ik=fk=None
43 try:
44 try:
44 ik = int(k)
45 ik = int(k)
45 except ValueError:
46 except ValueError:
46 try:
47 try:
47 fk = float(k)
48 fk = float(k)
48 except ValueError:
49 except ValueError:
49 continue
50 continue
50 if ik is not None:
51 if ik is not None:
51 nk = ik
52 nk = ik
52 else:
53 else:
53 nk = fk
54 nk = fk
54 if nk in dikt:
55 if nk in dikt:
55 raise KeyError("already have key %r"%nk)
56 raise KeyError("already have key %r"%nk)
56 dikt[nk] = dikt.pop(k)
57 dikt[nk] = dikt.pop(k)
57 return dikt
58 return dikt
58
59
59
60
60 def extract_dates(obj):
61 def extract_dates(obj):
61 """extract ISO8601 dates from unpacked JSON"""
62 """extract ISO8601 dates from unpacked JSON"""
62 if isinstance(obj, dict):
63 if isinstance(obj, dict):
63 obj = dict(obj) # don't clobber
64 obj = dict(obj) # don't clobber
64 for k,v in obj.iteritems():
65 for k,v in obj.iteritems():
65 obj[k] = extract_dates(v)
66 obj[k] = extract_dates(v)
66 elif isinstance(obj, (list, tuple)):
67 elif isinstance(obj, (list, tuple)):
67 obj = [ extract_dates(o) for o in obj ]
68 obj = [ extract_dates(o) for o in obj ]
68 elif isinstance(obj, basestring):
69 elif isinstance(obj, basestring):
69 if ISO8601_PAT.match(obj):
70 if ISO8601_PAT.match(obj):
70 obj = datetime.strptime(obj, ISO8601)
71 obj = datetime.strptime(obj, ISO8601)
71 return obj
72 return obj
72
73
73 def squash_dates(obj):
74 def squash_dates(obj):
74 """squash datetime objects into ISO8601 strings"""
75 """squash datetime objects into ISO8601 strings"""
75 if isinstance(obj, dict):
76 if isinstance(obj, dict):
76 obj = dict(obj) # don't clobber
77 obj = dict(obj) # don't clobber
77 for k,v in obj.iteritems():
78 for k,v in obj.iteritems():
78 obj[k] = squash_dates(v)
79 obj[k] = squash_dates(v)
79 elif isinstance(obj, (list, tuple)):
80 elif isinstance(obj, (list, tuple)):
80 obj = [ squash_dates(o) for o in obj ]
81 obj = [ squash_dates(o) for o in obj ]
81 elif isinstance(obj, datetime):
82 elif isinstance(obj, datetime):
82 obj = obj.strftime(ISO8601)
83 obj = obj.strftime(ISO8601)
83 return obj
84 return obj
84
85
85 def date_default(obj):
86 def date_default(obj):
86 """default function for packing datetime objects in JSON."""
87 """default function for packing datetime objects in JSON."""
87 if isinstance(obj, datetime):
88 if isinstance(obj, datetime):
88 return obj.strftime(ISO8601)
89 return obj.strftime(ISO8601)
89 else:
90 else:
90 raise TypeError("%r is not JSON serializable"%obj)
91 raise TypeError("%r is not JSON serializable"%obj)
91
92
92
93
93 # constants for identifying png/jpeg data
94 # constants for identifying png/jpeg data
94 PNG = b'\x89PNG\r\n\x1a\n'
95 PNG = b'\x89PNG\r\n\x1a\n'
95 JPEG = b'\xff\xd8'
96 JPEG = b'\xff\xd8'
96
97
97 def encode_images(format_dict):
98 def encode_images(format_dict):
98 """b64-encodes images in a displaypub format dict
99 """b64-encodes images in a displaypub format dict
99
100
100 Perhaps this should be handled in json_clean itself?
101 Perhaps this should be handled in json_clean itself?
101
102
102 Parameters
103 Parameters
103 ----------
104 ----------
104
105
105 format_dict : dict
106 format_dict : dict
106 A dictionary of display data keyed by mime-type
107 A dictionary of display data keyed by mime-type
107
108
108 Returns
109 Returns
109 -------
110 -------
110
111
111 format_dict : dict
112 format_dict : dict
112 A copy of the same dictionary,
113 A copy of the same dictionary,
113 but binary image data ('image/png' or 'image/jpeg')
114 but binary image data ('image/png' or 'image/jpeg')
114 is base64-encoded.
115 is base64-encoded.
115
116
116 """
117 """
117 encoded = format_dict.copy()
118 encoded = format_dict.copy()
118 pngdata = format_dict.get('image/png')
119 pngdata = format_dict.get('image/png')
119 if isinstance(pngdata, bytes) and pngdata[:8] == PNG:
120 if isinstance(pngdata, bytes) and pngdata[:8] == PNG:
120 encoded['image/png'] = encodestring(pngdata).decode('ascii')
121 encoded['image/png'] = encodestring(pngdata).decode('ascii')
121 jpegdata = format_dict.get('image/jpeg')
122 jpegdata = format_dict.get('image/jpeg')
122 if isinstance(jpegdata, bytes) and jpegdata[:2] == JPEG:
123 if isinstance(jpegdata, bytes) and jpegdata[:2] == JPEG:
123 encoded['image/jpeg'] = encodestring(jpegdata).decode('ascii')
124 encoded['image/jpeg'] = encodestring(jpegdata).decode('ascii')
124 return encoded
125 return encoded
125
126
126
127
127 def json_clean(obj):
128 def json_clean(obj):
128 """Clean an object to ensure it's safe to encode in JSON.
129 """Clean an object to ensure it's safe to encode in JSON.
129
130
130 Atomic, immutable objects are returned unmodified. Sets and tuples are
131 Atomic, immutable objects are returned unmodified. Sets and tuples are
131 converted to lists, lists are copied and dicts are also copied.
132 converted to lists, lists are copied and dicts are also copied.
132
133
133 Note: dicts whose keys could cause collisions upon encoding (such as a dict
134 Note: dicts whose keys could cause collisions upon encoding (such as a dict
134 with both the number 1 and the string '1' as keys) will cause a ValueError
135 with both the number 1 and the string '1' as keys) will cause a ValueError
135 to be raised.
136 to be raised.
136
137
137 Parameters
138 Parameters
138 ----------
139 ----------
139 obj : any python object
140 obj : any python object
140
141
141 Returns
142 Returns
142 -------
143 -------
143 out : object
144 out : object
144
145
145 A version of the input which will not cause an encoding error when
146 A version of the input which will not cause an encoding error when
146 encoded as JSON. Note that this function does not *encode* its inputs,
147 encoded as JSON. Note that this function does not *encode* its inputs,
147 it simply sanitizes it so that there will be no encoding errors later.
148 it simply sanitizes it so that there will be no encoding errors later.
148
149
149 Examples
150 Examples
150 --------
151 --------
151 >>> json_clean(4)
152 >>> json_clean(4)
152 4
153 4
153 >>> json_clean(range(10))
154 >>> json_clean(range(10))
154 [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
155 [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
155 >>> sorted(json_clean(dict(x=1, y=2)).items())
156 >>> sorted(json_clean(dict(x=1, y=2)).items())
156 [('x', 1), ('y', 2)]
157 [('x', 1), ('y', 2)]
157 >>> sorted(json_clean(dict(x=1, y=2, z=[1,2,3])).items())
158 >>> sorted(json_clean(dict(x=1, y=2, z=[1,2,3])).items())
158 [('x', 1), ('y', 2), ('z', [1, 2, 3])]
159 [('x', 1), ('y', 2), ('z', [1, 2, 3])]
159 >>> json_clean(True)
160 >>> json_clean(True)
160 True
161 True
161 """
162 """
162 # types that are 'atomic' and ok in json as-is. bool doesn't need to be
163 # types that are 'atomic' and ok in json as-is. bool doesn't need to be
163 # listed explicitly because bools pass as int instances
164 # listed explicitly because bools pass as int instances
164 atomic_ok = (unicode, int, float, types.NoneType)
165 atomic_ok = (unicode, int, types.NoneType)
165
166
166 # containers that we need to convert into lists
167 # containers that we need to convert into lists
167 container_to_list = (tuple, set, types.GeneratorType)
168 container_to_list = (tuple, set, types.GeneratorType)
168
169
170 if isinstance(obj, float):
171 # cast out-of-range floats to their reprs
172 if math.isnan(obj) or math.isinf(obj):
173 return repr(obj)
174 return obj
175
169 if isinstance(obj, atomic_ok):
176 if isinstance(obj, atomic_ok):
170 return obj
177 return obj
171
178
172 if isinstance(obj, bytes):
179 if isinstance(obj, bytes):
173 return obj.decode(DEFAULT_ENCODING, 'replace')
180 return obj.decode(DEFAULT_ENCODING, 'replace')
174
181
175 if isinstance(obj, container_to_list) or (
182 if isinstance(obj, container_to_list) or (
176 hasattr(obj, '__iter__') and hasattr(obj, next_attr_name)):
183 hasattr(obj, '__iter__') and hasattr(obj, next_attr_name)):
177 obj = list(obj)
184 obj = list(obj)
178
185
179 if isinstance(obj, list):
186 if isinstance(obj, list):
180 return [json_clean(x) for x in obj]
187 return [json_clean(x) for x in obj]
181
188
182 if isinstance(obj, dict):
189 if isinstance(obj, dict):
183 # First, validate that the dict won't lose data in conversion due to
190 # First, validate that the dict won't lose data in conversion due to
184 # key collisions after stringification. This can happen with keys like
191 # key collisions after stringification. This can happen with keys like
185 # True and 'true' or 1 and '1', which collide in JSON.
192 # True and 'true' or 1 and '1', which collide in JSON.
186 nkeys = len(obj)
193 nkeys = len(obj)
187 nkeys_collapsed = len(set(map(str, obj)))
194 nkeys_collapsed = len(set(map(str, obj)))
188 if nkeys != nkeys_collapsed:
195 if nkeys != nkeys_collapsed:
189 raise ValueError('dict can not be safely converted to JSON: '
196 raise ValueError('dict can not be safely converted to JSON: '
190 'key collision would lead to dropped values')
197 'key collision would lead to dropped values')
191 # If all OK, proceed by making the new dict that will be json-safe
198 # If all OK, proceed by making the new dict that will be json-safe
192 out = {}
199 out = {}
193 for k,v in obj.iteritems():
200 for k,v in obj.iteritems():
194 out[str(k)] = json_clean(v)
201 out[str(k)] = json_clean(v)
195 return out
202 return out
196
203
197 # If we get here, we don't know how to handle the object, so we just get
204 # If we get here, we don't know how to handle the object, so we just get
198 # its repr and return that. This will catch lambdas, open sockets, class
205 # its repr and return that. This will catch lambdas, open sockets, class
199 # objects, and any other complicated contraption that json can't encode
206 # objects, and any other complicated contraption that json can't encode
200 return repr(obj)
207 return repr(obj)
General Comments 0
You need to be logged in to leave comments. Login now