from __future__ import *

Kailash and Friends Kailash Kher Kaipa

simplejson is a simple, fast, complete, correct and extensible JSON (RFC 4627) encoder/decoder for Python 2.3+. It is pure Python code with no dependencies.

simplejson 1.9 is a minor update:

• Rewrote test suite with unittest and doctest (no more nosetest dependency)
• Better PEP 7 and PEP 8 source compliance
• Removed simplejson.jsonfilter demo module
• Misc. bug fixes

There is one backwards incompatible changes in this release:

• simplejson.jsonfilter is no longer included

simplejson is a simple, fast, complete, correct and extensible JSON (RFC 4627) encoder/decoder for Python 2.3+. It is pure Python code with no dependencies.

simplejson 1.8.1 is a major update:

• Optional C extension for accelerating the decoding of JSON strings
• Command line interface for pretty-printing JSON (via python -msimplejson)
• Decoding of integers and floats is now extensible (e.g. to use Decimal) via parse_int, parse_float options.
• Subversion and issue tracker moved to google code: http://code.google.com/p/simplejson/
• Misc. bug fixes

There is one incompatible change:

• "/" is no longer escaped, so if you're embedding JSON directly in HTML you'll want to use .replace("/", "\\/") to prevent a close-tag attack. Sorry, but the in-HTML use case just isn't worth the bloat in everyone else's documents.

simplejson is a simple, fast, complete, correct and extensible JSON (RFC 4627) encoder/decoder for Python 2.3+. It is pure Python code with no dependencies.

simplejson 1.7 is a minor update that improves encoding performance with an optional C extension to speed up str/unicode encoding (by 10-150x or so), which yields an overall speed boost of 2x+ (JSON is string-heavy). Additionally 1.7 adds support for encoding unicode code points outside the BMP to UTF-16 surrogate code pairs (specified by the Strings section of RFC 4627).

simplejson is a simple, fast, complete, correct and extensible JSON encoder/decoder for Python 2.3+. It is pure Python code with no dependencies.

simplejson 1.6 is a minor update that improves str support for encoding. Previous versions of simplejson integrated strings directly into the output stream, this version ensures they're of a particular encoding (default is UTF-8) so that the output stream is valid. See the documentation for more information.

simplejson is a simple, fast, complete, correct and extensible JSON encoder/decoder for Python 2.3+. It is pure Python code with no dependencies.

simplejson 1.5 is a major update that provides better Python 2.5 and Windows compatibility, and two new features that control encoding (indent for pretty-printing, and separators for generating optimally compact JSON). See the documentation for more information.

simplejson is a simple, fast, complete, correct and extensible JSON encoder/decoder for Python 2.3+. It is pure Python code with no dependencies. It's now the recommended module for Python use by JSON.org (replacing json-py).

simplejson was previously named simple_json, but was renamed to comply with PEP 8 module naming guidelines.

simplejson 1.3 is a minor update that provides a new feature: an object_hook parameter to the decoder. The optional object_hook function is called upon decoding of any JSON object literal, and its return value is used instead of the dict that would normally be used. This can be used to efficiently implement features such as JSON-RPC class hinting, or other custom decodings of JSON. See the documentation for more information.

simplejson is a simple, fast, complete, correct and extensible JSON encoder/decoder for Python 2.3+. It is pure Python code with no dependencies. It's now the recommended module for Python use by JSON.org (replacing json-py).

simplejson was previously named simple_json, but was renamed to comply with PEP 8 module naming guidelines.

simplejson 1.1 has a much bigger test suite, a full set of documentation and a couple new features.

• The encoder and decoder have been extended to understand NaN, Infinity, and -Infinity (but this can be turned off via allow_nan=False for strict JSON compliance)
• The decoder's scanner has been fixed so that it no longer accepts invalid JSON documents
• The decoder now reports line and column information as well as character numbers for easier debugging
• The encoder now has a circular reference checker, which can be optionally disabled with check_circular=False
• dump, dumps, load, loads now accept an optional cls kwarg to use an alternate JSONEncoder or JSONDecoder class for convenience.
• The read/write compatibility shim for json-py now have deprecation warnings

simple_json is a simple, fast, complete, correct and extensible JSON encoder/decoder for Python 2.3+. It's pure Python code with no dependencies.

simple_json exists because json-py sucks. simple_json is a drop-in replacement for json-py, but it also exposes more sanely named APIs, and can be extended by subclassing.

Here are the issues I found in json-py after evaluating the source:

• LGPL (does this license have a clear interpretation for Python modules?)
• Doesn't have a proper egg (or source) distribution on Cheese Shop.
• Wonky API. read and write are very bad names to call something that doesn't act file-like!
• No streaming encoder support.
• The decoder is extremely inefficient as it invokes at least one method call per character of input.
• The encoder supports exactly these types: dict, list, tuple, str, unicode, int, long, float plus the singletons True, False, and None. It can't be made to support anything else, not even subclasses of those types. The implementation is in a single function and has no extensibility hook.
• The encoder has no clue about unicode. Depending on the input, it may return a str or unicode. It has no option to escape the output.
• The decoder similarly has no clue about unicode. If it ain't ASCII or escaped, then BOOM!
• It uses custom exception subclasses that descend directly from Exception, so will not be caught by traditional ValueError clauses.
• The source code mixes tabs and spaces. That's uh.. reassuring :)

simple_json is designed to address all of those issues:

• MIT license
• It's on Cheese Shop, so setuptools users can depend on it with a simple install_requires
• The official API follows the familiar convention of marshal and pickle
• Encoding can be streamed (via dump or iterator)
• The decoder is fast, because it uses regular expressions rather than processing each character with Python code
• The encoder can be subclassed and extended to support serialization of any type, and it supports subclasses of dict, list, str, etc. by default
• The encoder outputs ASCII by default, with unicode characters escaped with \uXXXX. Optionally, it can also output a unicode string with ensure_ascii=False.
• The decoder understands encoded strings (and unicode). It defaults to UTF-8, but can use anything ASCII-based. If the input is of an encoding that is not ASCII-based (such as UCS-2), it can be decoded to unicode first.
• Exceptions during encoding or decoding are simply ValueError (though a future version could provide more informative messages)