Skip to main content

A Django json field behaves as a model instance and supports seamless inline editing in Django admin.

Project description

A Django field which: works like a model instance, stores sub-model fields in single DB column, and supports smooth editing in Django admin.

django-submodel works on Django 1.3+


  1. pip install django-submodel


# in you_app/

from django.db import models
from submodel.fields import SubModelField

# Define (field_name, model_field_instance) tuples in "fields" parameter in SubModelField,
#   similar as normal Model definition
# If SubModelField such as pref field is newly added to an existed model,
#   you may want to use south to migrate the schema
class UserProfile(models.Model):
    realname = models.CharField(max_length=100)
    pref = SubModelField(u'user preference',
                     ('title', models.CharField(max_length=10)),
                     ('color', models.IntegerField(choices=((0, 'Black'), (1, 'White')))),
                     ('birthday_day', models.DateTimeField()),
                     ('feel_luck', models.BooleanField(default=True))))
# in you_app/, to enable editing of sub fields of pref in Django admin

from submodel.admin import SubModelFieldInlineAdmin
from . models import UserProfile

class PrefInilneAdmin(SubModelFieldInlineAdmin):
    model = UserProfile._meta.get_field('pref').submodel # TODO improve

class UserProfileAdmin(admin.ModelAdmin):
    inlines = [PrefInilneAdmin], UserProfileAdmin)
>>> # TODO in Python shell, the value of pref field as a model instance


  • add tests
  • simpler API
  • dump and modify Deserializer to support missing subfields. schema policy?
  • better history
  • check compatibility w/ django-reversion and others …
  • possible config
  • more strict check such as attname confliction, for example FK field user and field user_id

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-submodel, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size django-submodel-0.1.tar.gz (3.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page