Django 5.2 LTS est sorti
par Makersquad ·
Date de sortie : 2 avril 2025
Mis à jour le 17 novembre 2026
Documentation officielle : Django 5.2 release notes
Nouvelle LTS, et pas des moindres. Django 5.2 résout le ticket #373 (s’ouvre dans un nouvel onglet), ouvert depuis 2005 : les clés primaires composites sont enfin là. L’import automatique des modèles dans le shell va aussi changer votre quotidien. Cette version est une LTS, avec des mises à jour de sécurité pendant au moins trois ans après sa sortie.
Les nouveautés principales
Clés primaires composites, 20 ans d’attente
Le ticket #373 (s’ouvre dans un nouvel onglet), ouvert depuis 2005, est enfin résolu. La clé primaire composite se déclare comme un champ pk sur le modèle :
from django.db import models
class OrderItem(models.Model):
pk = models.CompositePrimaryKey('order', 'product')
order = models.ForeignKey(Order, on_delete=models.CASCADE)
product = models.ForeignKey(Product, on_delete=models.CASCADE)
quantity = models.IntegerField()
Parfait pour les tables de liaison, les données legacy et les cas où une PK auto-incrémentée n’a pas de sens.
Import automatique des modèles, le shell devient utilisable
Plus besoin de from myapp.models import * :
$ python manage.py shell
>>> User.objects.count() # Directement disponible !
42
>>> Article.objects.filter(status='published')
<QuerySet [...]>
Tous les modèles des apps installées sont importés automatiquement.
Négociation de contenu HTTP
Nouvelle méthode pour implémenter la négociation de contenu :
def api_view(request):
preferred = request.get_preferred_type(['text/html', 'application/json'])
if preferred == 'application/json':
return JsonResponse({'data': 'value'})
return render(request, 'page.html')
request.accepted_types est maintenant trié par préférence du client.
Personnalisation du rendu des formulaires
Nouvel attribut bound_field_class pour personnaliser BoundField, au niveau du projet (BaseRenderer), du formulaire (Form) ou du champ (Field), sans surcharger Field.get_bound_field() :
# Niveau projet
class MyRenderer(BaseRenderer):
bound_field_class = MyBoundField
# Niveau formulaire
class MyForm(forms.Form):
bound_field_class = MyBoundField
# Niveau champ
class MyField(forms.CharField):
bound_field_class = CustomBoundField
Autres améliorations
- Python 3.14 supporté à partir de Django 5.2.8
- PostgreSQL 14+ requis (fin du support 13)
- MySQL utilise
utf8mb4par défaut UniqueConstraint.violation_error_codetoujours respecté
À retenir
Django 5.2 LTS est la nouvelle référence pour les projets de production. Les clés primaires composites répondent à un ticket ouvert en 2005. L’import automatique des modèles et la négociation de contenu sont des bonus appréciables. Sécurité assurée pendant au moins trois ans après la sortie.