summaryrefslogtreecommitdiffstats
path: root/Doc/library/json.rst
diff options
context:
space:
mode:
authorBerker Peksag <berker.peksag@gmail.com>2014-11-10 07:56:54 (GMT)
committerBerker Peksag <berker.peksag@gmail.com>2014-11-10 07:56:54 (GMT)
commit39e4c4d873927b902c53aeb0e2e15c12d2678e1b (patch)
tree8fc68f205c657f36ec637d658cc1b1a1aeae38fd /Doc/library/json.rst
parentffd842e1d6736d48d45e741e2006a181c9ad4272 (diff)
downloadcpython-39e4c4d873927b902c53aeb0e2e15c12d2678e1b.zip
cpython-39e4c4d873927b902c53aeb0e2e15c12d2678e1b.tar.gz
cpython-39e4c4d873927b902c53aeb0e2e15c12d2678e1b.tar.bz2
Issue #21650: Add an `--sort-keys` option to json.tool CLI.
Diffstat (limited to 'Doc/library/json.rst')
-rw-r--r--Doc/library/json.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index cff0c72..edbc5e0 100644
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -567,6 +567,7 @@ the last name-value pair for a given name::
The *object_pairs_hook* parameter can be used to alter this behavior.
.. highlight:: bash
+.. module:: json.tool
.. _json-commandline:
@@ -586,6 +587,10 @@ specified, :attr:`sys.stdin` and :attr:`sys.stdout` will be used respectively::
$ echo '{1.2:3.4}' | python -m json.tool
Expecting property name enclosed in double quotes: line 1 column 2 (char 1)
+.. versionchanged:: 3.5
+ The output is now in the same order as the input. Use the
+ :option:`--sort-keys` option to sort the output of dictionaries
+ alphabetically by key.
Command line options
^^^^^^^^^^^^^^^^^^^^
@@ -613,6 +618,12 @@ Command line options
Write the output of the *infile* to the given *outfile*. Otherwise, write it
to :attr:`sys.stdout`.
+.. cmdoption:: --sort-keys
+
+ Sort the output of dictionaries alphabetically by key.
+
+ .. versionadded:: 3.5
+
.. cmdoption:: -h, --help
Show the help message.