jsonobject

What it is and what it does

jsonobject is a Python library that bridges JSON and Python objects by letting you define typed schemas that automatically convert between JSON strings (or dicts) and native Python objects. You define a class inheriting from JsonObject with typed properties (StringProperty, DateTimeProperty, ListProperty, etc.), then use it to wrap raw JSON data or construct objects that serialize back to JSON with proper type coercion—datetimes become ISO strings, decimals preserve precision, and nested objects compose naturally.

The library handles both construction styles: passing a dict of raw JSON data or using keyword arguments with Python-native types. It was originally inspired by couchdbkit's Document/DocumentSchema API and is used in production by CommCare HQ. The API is largely stable, though it is maintained at a slower cadence and targets Python 3.9 and later with no external runtime dependencies.

Use it for

• Deserialize JSON API responses into typed Python objects with automatic datetime and decimal conversion.
• Define a schema once and use it to validate and wrap incoming JSON from external services or databases.
• Serialize complex Python objects with nested structures, dates, and custom types back to JSON for storage or transmission.
• Build configuration or data models that enforce type safety and provide IDE autocomplete for deeply nested JSON structures.
• Migrate from couchdbkit-based code to a simpler, standalone library with compatible API.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

jsonobject on PyPI

Before you install

Medium install friction due to compiled wheels for multiple Python versions (3.9–3.13), but no runtime dependencies. Last release was 533 days ago; repository is not archived and shows recent activity (last commit 2025-05-23), though maintenance status is aging.

License in practice

BSD 2-Clause license (permissive). You may use, modify, and distribute the package freely in commercial and private projects, provided you retain copyright notices and include the license text.

Quickstart

pip install jsonobject

from jsonobject import JsonObject, StringProperty, BooleanProperty, DateTimeProperty, ListProperty
import datetime

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

user = User(name='John Doe', username='jdoe', date_joined=datetime.datetime.utcnow(), tags=['generic'])
print(user.to_json())

Package facts

Evidence: jsonobject-2.3.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; jsonobject-2.3.1-cp310-cp310-musllinux_1_2_x86_64.whl; jsonobject-2.3.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; jsonobject-2.3.1-cp311-cp311-musllinux_1_2_x86_64.whl; jsonobject-2.3.1-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl; jsonobject-2.3.1-cp312-cp312-musllinux_1_2_x86_64.whl; jsonobject-2.3.1-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl; jsonobject-2.3.1-cp313-cp313-musllinux_1_2_x86_64.whl; jsonobject-2.3.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; jsonobject-2.3.1-cp39-cp39-musllinux_1_2_x86_64.whl

Tags

More Software Development packages

See also jsonconversion · databind.json · json-flatten · databind · logging-json · schema · databind.core · json-strong-typing · yamlable · json-encoder