django-picklefield

What it is and what it does

django-picklefield extends Django models with a field type that transparently serializes and stores arbitrary Python objects in the database. Instead of manually pickling and unpickling data or designing a schema for each object type, you define a PickledObjectField and assign any picklable Python object to it—lists, dicts, custom classes, or nested structures—and the field handles encoding, storage, and retrieval automatically.

The package base64-encodes pickled data to ensure ASCII-safe storage across database backends and supports optional zlib compression, configurable pickle protocols, and database lookups (exact, in, isnull). It is designed for cases where a proper relational schema does not exist, such as storing configuration objects, cached computations, or heterogeneous data. The critical caveat is that pickle is inherently unsafe for untrusted input; the field is marked non-editable by default and should never receive unsanitized user data.

Use it for

• Store configuration or settings objects in a Django model without designing a separate schema for each setting type.
• Cache computed Python objects (e.g., analysis results, transformed data) directly in the database for later retrieval.
• Persist application state or workflow context that does not fit a normalized relational structure.
• Store lookup tables or reference data as Python dicts or lists without creating additional database tables.
• Handle heterogeneous data in a single field when the object structure varies per record.

Worth the install?

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

Install

django-picklefield on PyPI

Before you install

Low install friction with a single Django dependency. Last release was 260 days ago; the repository is active and not archived, though maintenance status is aging. Supports current Python versions (3.10+) and recent Django versions through 6.0.

Do not store untrusted user input directly in PickledObjectField; pickle.loads() can execute arbitrary code. The field is marked editable=False by default to prevent form exposure, but programmatic assignment of unsanitized data remains a security risk.

License in practice

MIT license is permissive and places no restrictions on use or redistribution. You may use this package in commercial or proprietary projects without obligation to share modifications.

Quickstart

pip install django-picklefield

from picklefield.fields import PickledObjectField
from django.db import models

class MyModel(models.Model):
    data = PickledObjectField()

obj = MyModel()
obj.data = ['any', {'picklable': 'object'}]
obj.save()

Package facts

Evidence: django_picklefield-3.4.0-py3-none-any.whl

Tags

More Python Modules packages

See also jsonfield · pypickle · django-dirtyfields · dill · django-versatileimagefield · cloudpickle · django-hashids · django-sqids · sqlitedict · jsonpickle