Skip to content

Improve json section #515

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Feb 15, 2015
Merged

Improve json section #515

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
fc0fa67
Merge pull request #1 from kennethreitz/master
mplewis Feb 5, 2015
4fbc739
Add details on how to use simplejson
mplewis Feb 5, 2015
ecc570d
Improve wording of intro paragraph
mplewis Feb 5, 2015
2e2d70c
Add info on working with file objects
mplewis Feb 5, 2015
f6d503d
Revert "Add info on working with file objects"
mplewis Feb 11, 2015
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 12 additions & 4 deletions docs/scenarios/json.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
JSON
====

The `json <https://docs.python.org/2/library/json.html>`_ library can parse JSON from strings or files. When parsing, the library converts the JSON into a Python dictionary or list. It can also parse Python dictionaries or lists into JSON strings.
The `json <https://docs.python.org/2/library/json.html>`_ library can parse JSON from strings or files. The library parses JSON into a Python dictionary or list. It can also convert Python dictionaries or lists into JSON strings.

Parsing JSON
------------
Expand All @@ -26,7 +26,7 @@ and can now be used as a normal dictionary:
print(parsed_json['first_name'])
"Guido"

You can also convert a the following to JSON:
You can also convert the following to JSON:

.. code-block:: python

Expand All @@ -43,6 +43,14 @@ You can also convert a the following to JSON:
simplejson
----------

`simplejson <https://simplejson.readthedocs.org/en/latest/>`_ is the externally maintained development version of the json library.
The JSON library was added to Python in version 2.6. If you're using an earlier version of Python, the `simplejson <https://simplejson.readthedocs.org/en/latest/>`_ library is available via PyPI.

simplejson mimics the json standard library, it is available so that developers that use an older version of python can use the latest features available in the json lib.
simplejson mimics the json standard library. It is available so that developers that use older versions of Python can use the latest features available in the json lib.

You can start using simplejson when the json library is not available by importing simplejson under a different name:

.. code-block:: python

import simplejson as json

After importing simplejson as json, the above examples will all work as if you were using the standard json library.