#16333: document a way to get rid of trailing whitespace when indent is used.

This commit is contained in:
Ezio Melotti 2012-11-29 00:22:30 +02:00
parent 0d68ab3f48
commit 3a237ebcaa
3 changed files with 26 additions and 6 deletions

View file

@ -43,7 +43,8 @@ Compact encoding::
Pretty printing::
>>> import json
>>> print json.dumps({'4': 5, '6': 7}, sort_keys=True, indent=4)
>>> print json.dumps({'4': 5, '6': 7}, sort_keys=True,
... indent=4, separators=(',', ': '))
{
"4": 5,
"6": 7
@ -153,6 +154,12 @@ Basic Usage
or negative, will only insert newlines. ``None`` (the default) selects the
most compact representation.
.. note::
Since the default item separator is ``', '``, the output might include
trailing whitespace when *indent* is specified. You can use
``separators=(',', ': ')`` to avoid this.
If *separators* is an ``(item_separator, dict_separator)`` tuple, then it
will be used instead of the default ``(', ', ': ')`` separators. ``(',',
':')`` is the most compact JSON representation.
@ -410,6 +417,12 @@ Encoders and Decoders
level. An indent level of 0 will only insert newlines. ``None`` is the most
compact representation.
.. note::
Since the default item separator is ``', '``, the output might include
trailing whitespace when *indent* is specified. You can use
``separators=(',', ': ')`` to avoid this.
If specified, *separators* should be an ``(item_separator, key_separator)``
tuple. The default is ``(', ', ': ')``. To get the most compact JSON
representation, you should specify ``(',', ':')`` to eliminate whitespace.