Django REST Framework 3.10 est sorti

Date de sortie : 15 juillet 2019

Documentation officielle : DRF 3.10 Announcement

DRF 3.10 marque un tournant : c’est la dernière version à supporter Python 2, et la première à générer nativement des schémas OpenAPI. Autrement dit, c’est le moment de moderniser vos APIs.

Les nouveautés principales

Fin du support Python 2 (enfin !)

DRF 3.10 est la dernière version à supporter Python 2. Il faut migrer vers Python 3 avant d’upgrader.

Versions supportées :

- Python 3.5, 3.6, 3.7

- Django 1.11, 2.0, 2.1, 2.2

Génération de schémas OpenAPI

OpenAPI devient le standard pour documenter les APIs. DRF 3.10 introduit la génération native :

from rest_framework.schemas import get_schema_view

schema_view = get_schema_view(
    title="My API",
    description="API documentation",
    version="1.0.0"
)

urlpatterns = [
    path('openapi/', schema_view),
]

Dépréciation de CoreAPI

CoreAPI est déprécié en faveur d’OpenAPI. La migration est recommandée pour tous les projets.

Exemple de schéma OpenAPI

openapi: 3.0.2
info:
  title: My API
  version: 1.0.0
paths:
  /users/:
    get:
      operationId: listUsers
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'

Pourquoi OpenAPI ?

• Standard industriel largement adopté
• Meilleure intégration avec les outils (Swagger, Postman)
• Génération de clients automatique
• Documentation interactive

Migration Python 2 → 3

Si vous êtes encore sur Python 2 :

1. Tester avec python -3 pour les warnings
2. Utiliser 2to3 pour la conversion automatique
3. Vérifier les dépendances tierces
4. Migrer vers Python 3.6+ pour profiter des features modernes

À retenir

OpenAPI devient le standard de fait pour documenter les APIs REST. La génération native dans DRF 3.10 simplifie énormément l’intégration avec Swagger, Postman et les générateurs de clients. Si vous maintenez encore une doc CoreAPI, c’est le bon moment pour migrer.