Django Utils

The data__filling dropdown filter open in the Django admin sidebar, listing Avocado, Bacon, Cheddar, Corned Beef and Turkey

Django Utils is a collection of the small Django helpers, admin power-ups and ORM utilities that most projects end up writing themselves: JSON-aware admin filters, encrypted model fields, memory-bounded queryset iteration, resumable management commands, and more. It builds on the Python Utils library. It is by no means a complete collection, but it has served production projects well and keeps growing.

Full documentation, including a "why this over the alternatives" page, is at https://django-utils-2.readthedocs.io/en/latest/.

Requirements

Python 3.10+
Django 4.2, 5.2, or 6.0

Install

Run pip install django-utils2
Add django_utils to your INSTALLED_APPS

If you want to run the tests, install the tests extra (pip install "django-utils2[tests]") and run pytest.

Quickstart

Filter an admin changelist on a nested JSONField value without writing a custom SimpleListFilter:

from django.contrib import admin
from django_utils.admin.filters import JSONFieldFilterDropdown

from myapp.models import Sandwich


class SandwichAdmin(admin.ModelAdmin):
    list_filter = (
        JSONFieldFilterDropdown.create('data__filling'),
    )


admin.site.register(Sandwich, SandwichAdmin)

A sidebar filter on data['filling'], no JOIN or denormalized column. The quickstart page has two more features like this.

Features

Every feature below has its own page on the docs site, with runnable examples, edge cases, and (for the admin features) screenshots or a live in-browser demo.

Admin dropdown / Select2 / JSON filters: dropdown, autocomplete, and JSON sub-path list filters for the changelist sidebar, plus an operator selector (gte, lte, icontains, ...) for typed comparisons. See Select / dropdown / autocomplete filters and Operator filters.
JSON widget: a drop-in JSONField admin widget that pretty-prints and validates JSON as you type. See JSON widget.
Read-only admin: turn any ModelAdmin into a read-only view: add/change/delete denied for everyone, filtering and search still work. See Read-only admin.
Count columns: sortable related-object count columns for list_display, without the N+1 or JOIN fan-out footguns. See Count columns.
Admin export: streaming CSV/JSON export actions for the changelist, memory-bounded via queryset_iterator. See Export.
Choices: metadata-carrying choices with dict-like access and a real enum.Enum on demand via as_enum(). See Choices.
PostgreSQL ENUM field: a CharField backed by a native PostgreSQL ENUM type on Postgres, plain VARCHAR everywhere else, with hand-written migration operations for creating the type and adding values. See PostgreSQL ENUM field.
Request/user context (ASGI-safe): access the current request/user from anywhere via contextvars, isolated per asyncio task, unlike thread-local equivalents. See Current request / user (ASGI-safe).
Query budgets: catch N+1 regressions in production code paths, not just in tests, with a query-counting context manager/decorator. See Query budgets.
Auth helpers: superuser_required/staff_required decorators and a permission_string() builder for has_perm() checks. See Auth helpers.
Fetch-Metadata CSRF middleware: defense-in-depth CSRF hardening using the Sec-Fetch-Site header, run alongside (not instead of) Django's own CSRF middleware. See Fetch-Metadata CSRF middleware.
Subquery aggregates: SubqueryCount/SubquerySum/SubqueryAvg/... annotate each aggregate in its own subquery, avoiding the JOIN fan-out that multiplies counts. See Subquery aggregates.
Bulk upsert: bulk_update_or_create(): one INSERT ... ON CONFLICT DO UPDATE batch instead of a racy, two-query-per-row loop. See Bulk upsert.
Chunked management commands: ChunkedCommand: memory-bounded, resumable processing of large querysets with progress logging and a transactional dry-run. See ChunkedCommand.
Encrypted model fields: EncryptedCharField/EncryptedTextField/ EncryptedJSONField: Fernet-encrypted values in a plain TEXT column, with key-rotation support. See Encrypted model fields.

Release files for django-utils2 4.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-utils2 4.1.2
File	Size	Uploaded
django_utils2-4.1.2.tar.gz	61.2 kB	Aug 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-utils2 4.1.2
File	Interpreter	ABI	Platform	Reset
django_utils2-4.1.2-py3-none-any.whl 77.4 kB Aug 10, 2026	Python 3	none	any	Details

Total release size: 138.6 kB

Release files / django_utils2-4.1.2.tar.gz

Download URL	django_utils2-4.1.2.tar.gz
Size	61.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`cd27162027d22f6ee0bb1b87d162de2e0f6dc3c2c6a40e08118fd25b5c6e4269`
BLAKE2b-256 checksum How to use checksums	`49485331a499a666d84cfa53686aba19ad33a0a019ba720fde40edf03170801d`
Upload date	Aug 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/wolph/django-utils
Publishing commit: github.com/wolph/django-utils/tree/a68fb1776142049175f9f36934b68d8b1d5b19e3

Workflow

Publishing configuration: github.com/wolph/django-utils/blob/a68fb1776142049175f9f36934b68d8b1d5b19e3/.github/workflows/publish.yml
Publishing logs: github.com/wolph/django-utils/actions/runs/31379521716/attempts/1

Artifact

Subject: django_utils2-4.1.2.tar.gz
SHA-256 checksum: cd27162027d22f6ee0bb1b87d162de2e0f6dc3c2c6a40e08118fd25b5c6e4269 Verifying attestations

Release files / django_utils2-4.1.2-py3-none-any.whl

Download URL	django_utils2-4.1.2-py3-none-any.whl
Size	77.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`acdeb39af8ea769770080ed4d4bf136729a8f4437ca8bb9e36799eacdc6dd976`
BLAKE2b-256 checksum How to use checksums	`fdeb9ab017cdfc35a80f61494b66d86aefc17cbb04b9aa148a2d315ef66206a6`
Upload date	Aug 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/wolph/django-utils
Publishing commit: github.com/wolph/django-utils/tree/a68fb1776142049175f9f36934b68d8b1d5b19e3

Workflow

Publishing configuration: github.com/wolph/django-utils/blob/a68fb1776142049175f9f36934b68d8b1d5b19e3/.github/workflows/publish.yml
Publishing logs: github.com/wolph/django-utils/actions/runs/31379521716/attempts/1

Artifact

Subject: django_utils2-4.1.2-py3-none-any.whl
SHA-256 checksum: acdeb39af8ea769770080ed4d4bf136729a8f4437ca8bb9e36799eacdc6dd976 Verifying attestations