mirror of https://github.com/python/cpython
#16333: document a way to get rid of trailing whitespace when indent is used.
This commit is contained in:
parent
0d68ab3f48
commit
3a237ebcaa
|
@ -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.
|
||||
|
|
|
@ -37,8 +37,8 @@ Compact encoding::
|
|||
Pretty printing::
|
||||
|
||||
>>> import json
|
||||
>>> s = json.dumps({'4': 5, '6': 7}, sort_keys=True, indent=4)
|
||||
>>> print '\n'.join([l.rstrip() for l in s.splitlines()])
|
||||
>>> print json.dumps({'4': 5, '6': 7}, sort_keys=True,
|
||||
... indent=4, separators=(',', ': '))
|
||||
{
|
||||
"4": 5,
|
||||
"6": 7
|
||||
|
@ -150,7 +150,9 @@ def dump(obj, fp, skipkeys=False, ensure_ascii=True, check_circular=True,
|
|||
If ``indent`` is a non-negative integer, then JSON array elements and
|
||||
object members will be pretty-printed with that indent level. An indent
|
||||
level of 0 will only insert newlines. ``None`` is the most compact
|
||||
representation.
|
||||
representation. 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.
|
||||
|
@ -212,7 +214,9 @@ def dumps(obj, skipkeys=False, ensure_ascii=True, check_circular=True,
|
|||
If ``indent`` is a non-negative integer, then JSON array elements and
|
||||
object members will be pretty-printed with that indent level. An indent
|
||||
level of 0 will only insert newlines. ``None`` is the most compact
|
||||
representation.
|
||||
representation. 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.
|
||||
|
|
|
@ -131,7 +131,10 @@ class JSONEncoder(object):
|
|||
If indent is a non-negative integer, then JSON array
|
||||
elements and object members will be pretty-printed with that
|
||||
indent level. An indent level of 0 will only insert newlines.
|
||||
None is the most compact representation.
|
||||
None is the most compact representation. 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 a (item_separator, key_separator)
|
||||
tuple. The default is (', ', ': '). To get the most compact JSON
|
||||
|
|
Loading…
Reference in New Issue