django.contrib.formtools¶
Un ensemble d’abstractions de haut niveau pour les formulaires Django (django.forms).
Historiquement, Django était livré avec django.contrib.formtools, un ensemble d’utilitaires associés qui étaient utiles pour certains cas d’utilisation des formulaires. Ce code est dorénavant livré séparément de Django, pour faciliter sa maintenance et pour réduire la taille du code de Django. Dans Django 1.8, l’importation à partir de django.contrib.formtools ne fonctionne plus.
Le nouveau paquet formtools s’appelle django-formtools, avec un module principal nommé formtools. La version 1.0 inclut les deux mêmes fonctionnalités principales qui étaient présentes dans le code livré avec Django : un utilitaire pour la prévisualisation des formulaires et une vue d’assistant de formulaire.
Consultez la documentation officielle pour plus d’informations.
Instructions de migration¶
Si vous avez par le passé utilisé l’ancien paquet django.contrib.formtools, suivez ces deux étapes simples pour mettre à jour votre code :
Installez la version 1.0 du paquet externe django-formtools.
Modifiez l’instruction d’importation de l’application afin de référencer le nouveau paquet.
Par exemple, modifiez :
from django.contrib.formtools.wizard.views import WizardView
en :
from formtools.wizard.views import WizardView
Le code de la version 1.0 du nouveau paquet est identique (il a été copié directement depuis Django), vous n’avez donc pas à vous préoccuper de rétrocompatibilité en termes de fonctionnalités. Seules les importations ont changé.