skip to navigation
skip to content

jsonobject 0.2.12

A library for dealing with JSON as python objects

Latest Version: 0.7.1

[![Build Status](](

A python library for handling deeply nested JSON objects
as well-schema'd python objects.

It is supposed to be a simpler, more standalone, and faster version
of the DocumentSchema portion of `couchdbkit`

This is just in the hacking stages and the API is not stable.


The code below defines a simple user model, and it's natural mapping to JSON.

from jsonobject import *

class User(JsonObject):
username = StringProperty()
name = StringProperty()
active = BooleanProperty(default=False)
date_joined = DateTimeProperty()
tags = ListProperty(unicode)


Once it is defined, it can be used to wrap or produce deserialized JSON.

>>> user1 = User(
name='John Doe',
tags=['generic', 'anonymous']
>>> user1.to_json()
'name': u'John Doe',
'username': u'jdoe',
'active': False,
'date_joined': '2013-08-05T02:46:58Z',
'tags': [u'generic', u'anonymous']

Notice that the datetime is converted to an ISO format string in JSON, but is a real datetime on the object:

>>> user1.date_joined
datetime.datetime(2013, 8, 5, 2, 46, 58)

##Performance Comparison with Couchdbkit##
In order to do a direct comparison with couchdbkit, the test suite includes a large sample schema originally written with couchdbkit. It is easy to swap in jsonobject for couchdbkit and run the tests with each. Here are the results:
$ python -m unittest test.test_couchdbkit
Ran 4 tests in 1.403s

$ python -m unittest test.test_couchdbkit
Ran 4 tests in 0.153s


File Type Py Version Uploaded on Size
jsonobject-0.2.12.tar.gz (md5) Source 2014-01-23 12KB
  • Downloads (All Versions):
  • 97 downloads in the last day
  • 778 downloads in the last week
  • 3447 downloads in the last month