@@ -116,7 +116,10 @@ Using json.tool from the shell to validate and pretty-print::
116116Basic Usage
117117-----------
118118
119- .. function :: dump(obj, fp, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, **kw)
119+ .. function :: dump(obj, fp, skipkeys=False, ensure_ascii=True, \
120+ check_circular=True, allow_nan=True, cls=None, \
121+ indent=None, separators=None, default=None, \
122+ sort_keys=False, **kw)
120123
121124 Serialize *obj * as a JSON formatted stream to *fp * (a ``.write() ``-supporting
122125 :term: `file-like object `).
@@ -159,12 +162,18 @@ Basic Usage
159162 *default(obj) * is a function that should return a serializable version of
160163 *obj * or raise :exc: `TypeError `. The default simply raises :exc: `TypeError `.
161164
165+ If *sort_keys * is ``True `` (default: ``False ``), then the output of
166+ dictionaries will be sorted by key.
167+
162168 To use a custom :class: `JSONEncoder ` subclass (e.g. one that overrides the
163169 :meth: `default ` method to serialize additional types), specify it with the
164170 *cls * kwarg; otherwise :class: `JSONEncoder ` is used.
165171
166172
167- .. function :: dumps(obj, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, **kw)
173+ .. function :: dumps(obj, skipkeys=False, ensure_ascii=True, \
174+ check_circular=True, allow_nan=True, cls=None, \
175+ indent=None, separators=None, default=None, \
176+ sort_keys=False, **kw)
168177
169178 Serialize *obj * to a JSON formatted :class: `str `. The arguments have the
170179 same meaning as in :func: `dump `.
0 commit comments