diff options
author | Bob Ippolito <bob@redivi.com> | 2009-12-27 19:36:35 +0000 |
---|---|---|
committer | Bob Ippolito <bob@redivi.com> | 2009-12-27 19:36:35 +0000 |
commit | a73172930ad3b22927d816dc14675eaae72e0501 (patch) | |
tree | 3cdcfda95aa043a3ee227f8194b6fcdeb2a9959b /index.rst | |
parent | b5dc76b12bdb1dd53f572be6379243c5b7ef47bb (diff) | |
download | simplejson-a73172930ad3b22927d816dc14675eaae72e0501.tar.gz |
officially drop py2.4 support, doc tweaks, use only py2.5+ C API
git-svn-id: http://simplejson.googlecode.com/svn/trunk@208 a4795897-2c25-0410-b006-0d3caba88fa1
Diffstat (limited to 'index.rst')
-rw-r--r-- | index.rst | 18 |
1 files changed, 8 insertions, 10 deletions
@@ -12,7 +12,7 @@ syntax (ECMA-262 3rd edition) used as a lightweight data interchange format. :mod:`simplejson` exposes an API familiar to users of the standard library :mod:`marshal` and :mod:`pickle` modules. It is the externally maintained version of the :mod:`json` library contained in Python 2.6, but maintains -compatibility with Python 2.4 and Python 2.5 and (currently) has +compatibility with Python 2.5 and (currently) has significant performance advantages, even without using the optional C extension for speedups. @@ -44,7 +44,7 @@ Compact encoding:: Pretty printing:: >>> import simplejson as json - >>> s = json.dumps({'4': 5, '6': 7}, sort_keys=True, indent=' ') + >>> s = json.dumps({'4': 5, '6': 7}, sort_keys=True, indent=4 * ' ') >>> print '\n'.join([l.rstrip() for l in s.splitlines()]) { "4": 5, @@ -161,10 +161,8 @@ Basic Usage *encoding* is the character encoding for str instances, default is ``'utf-8'``. - If specified, *default* should be a function that gets called for objects - that can't otherwise be serialized. It should return a JSON encodable - version of the object or raise a :exc:`TypeError`. If not specified, - :exc:`TypeError` is always raised in those cases. + *default(obj)* is a function that should return a serializable version of + *obj* or raise :exc:`TypeError`. The default simply raises :exc:`TypeError`. To use a custom :class:`JSONEncoder` subclass (e.g. one that overrides the :meth:`default` method to serialize additional types), specify it with the @@ -304,10 +302,10 @@ Encoders and decoders Note that currently only encodings that are a superset of ASCII work, strings of other encodings should be passed in as :class:`unicode`. - *object_hook*, if specified, will be called with the result of every JSON - object decoded and its return value will be used in place of the given - :class:`dict`. This can be used to provide custom deserializations (e.g. to - support JSON-RPC class hinting). + *object_hook* is an optional function that will be called with the result of + every JSON object decoded and its return value will be used in place of the + given :class:`dict`. This can be used to provide custom deserializations + (e.g. to support JSON-RPC class hinting). *object_pairs_hook* is an optional function that will be called with the result of any object literal decode with an ordered list of pairs. The |