A reusable Django field that allows you to store validated JSON in your model.
Project description
django-jsonfield
django-jsonfield is looking for maintainers that want to help keep the software up-to-date with bug patches & Django versions. Please email bjasper@gmail.com if interested.
django-jsonfield is a reusable Django field that allows you to store validated JSON in your model.
It silently takes care of serialization. To use, simply add the field to one of your models.
Python 3 & Django 1.8 through 1.11 supported!
Use PostgreSQL? 1.0.0 introduced a breaking change to the underlying data type, so if you were using < 1.0.0 please read https://github.com/bradjasper/django-jsonfield/issues/57 before upgrading.
Note: There are a couple of JSONField’s for Django. This one is django-jsonfield here on GitHub but jsonfield on PyPi.
Note: Semver is followed after the 1.0 release.
Install
pip install jsonfieldUsage
from django.db import models
from jsonfield import JSONField
class MyModel(models.Model):
json = JSONField()Advanced Usage
By default python deserializes json into dict objects. This behavior differs from the standard json behavior because python dicts do not have ordered keys.
To overcome this limitation and keep the sort order of OrderedDict keys the deserialisation can be adjusted on model initialisation:
import collections
class MyModel(models.Model):
json = JSONField(load_kwargs={'object_pairs_hook': collections.OrderedDict})Other Fields
jsonfield.JSONCharField
If you need to use your JSON field in an index or other constraint, you can use JSONCharField which subclasses CharField instead of TextField. You’ll also need to specify a max_length parameter if you use this field.
Compatibility
django-jsonfield aims to support the same versions of Django currently maintained by the main Django project. See Django supported versions, currently:
Django 1.8 (LTS) with Python 2.7, 3.3, 3.4, or 3.5
Django 1.9 with Python 2.7, 3.4, or 3.5
Django 1.10 with Python 2.7, 3.4, or 3.5
Testing django-jsonfield Locally
To test against all supported versions of Django:
$ docker-compose build && docker-compose upOr just one version (for example Django 1.10 on Python 3.5):
$ docker-compose build && docker-compose run tox tox -e py35-1.10Travis CI
Contact
Twitter: @bradjasper
Email: contact@bradjasper.com
Changes
Take a look at the changelog.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for jsonfield-2.0.1-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | cb5304c037acc3cb67225f8d324a1f801d864df3e7d9e612502e418752426bf1 |
|
| MD5 | c9aa58e84504b54257067e364fdae885 |
|
| BLAKE2b-256 | ccc6b2af6db108613baef3becc1b0d82954cefbfc80f3c7839c8e920aff36813 |
