django-lifecycle

What it is and what it does

Django Lifecycle Hooks provides a decorator-based alternative to Django Signals for attaching code to model lifecycle events. Instead of overriding save() or __init__ and manually tracking field changes, you decorate methods with @hook and specify when they should run (before/after create, update, or delete) and under what conditions. The package includes a LifecycleModel base class and condition helpers like WhenFieldHasChanged and WhenFieldValueIs to express complex logic declaratively.

The main appeal is readability and maintainability: lifecycle logic stays close to the model definition rather than scattered across signal handlers. It works with Django 4.2, 5.0, 5.2, and 6.0, and supports Python 3.8 through 3.14. The package has been in active development since 2018 and carries no known security vulnerabilities.

Use it for

• Automatically update a timestamp field whenever a model's content changes, without overriding save().
• Trigger side effects (like sending emails) only when a model transitions between specific states (e.g., draft to published).
• Run validation or cleanup logic before or after a model is created, updated, or deleted, with fine-grained conditions.
• Track field changes and react to them in the same model class, keeping related logic together and readable.
• Replace Signal handlers for simple lifecycle events when you want less indirection and clearer code flow.

Worth the install?

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

Install

django-lifecycle on PyPI

Before you install

Low friction install with a single runtime dependency (Django). Active maintenance as of 2026-06-14 with 1405 repository stars and recent releases.

License in practice

MIT license (permissive) — you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.

Quickstart

pip install django-lifecycle

from django_lifecycle import LifecycleModel, hook, BEFORE_UPDATE
from django_lifecycle.conditions import WhenFieldHasChanged

class Article(LifecycleModel):
    contents = models.TextField()
    updated_at = models.DateTimeField(null=True)

    @hook(BEFORE_UPDATE, WhenFieldHasChanged("contents", has_changed=True))
    def on_content_change(self):
        self.updated_at = timezone.now()

Package facts

Evidence: django_lifecycle-1.3.0-py3-none-any.whl

Tags

More Application Frameworks packages

See also django-dirtyfields · django-signal-webhooks · snapshot-restore-py · django-fsm-2 · django-click · django-upgrade · django-fsm-log · django-ordered-model · django-waffle · django-admin-extra-buttons