Notes de publication de Django 2.1¶

La permission d’affichage (view) des modèles¶

Une permission d’affichage (view) a été ajoutée aux permissions Meta.default_permissions des modèles. Les nouvelles permissions seront automatiquement créées lors du lancement de migrate.

Cela permet de donner un accès en lecture seule aux modèles dans l’interface d’administration. ModelAdmin.has_view_permission() est une nouvelle méthode. L’implémentation est rétrocompatible dans la mesure où il n’est pas nécessaire d’attribuer la permission view pour permettre aux utilisateurs qui ont la permission de modification de modifier des objets.

Il existe cependant un certain nombre de considérations sur la rétrocompatibilité.

Fonctionnalités mineures¶

API de moteur de base de données¶

Cette section décrit des modifications qui pourraient être nécessaires dans des moteurs de base de données tiers.

• Pour se conformer à la PEP 249, les exceptions qui concernent l’absence de prise en charge d’une fonctionnalité de base de données sont modifiées de NotImplementedError à django.db.NotSupportedError.

• Le drapeau de fonctionnalité de base de données allow_sliced_subqueries a été renommé en allow_sliced_subqueries_with_in.

• DatabaseOperations.distinct_sql() now requires an additional params argument and returns a tuple of SQL and parameters instead of an SQL string.

• DatabaseFeatures.introspected_boolean_field_type a été modifiée, la méthode est devenue propriété.

django.contrib.gis¶

• La prise en charge de SpatiaLite 4.0 a été supprimée.

Abandon de la prise en charge de MySQL 5.5¶

La fin de la prise en charge amont de MySQL 5.5 est en décembre 2018. Django 2.1 prend en charge MySQL 5.6 et plus récent.

Abandon de la prise en charge de PostgreSQL 9.3¶

La fin de la prise en charge amont de PostgreSQL 9.3 est en septembre 2018. Django 2.1 prend en charge PostgreSQL 9.4 et plus récent.

BCryptPasswordHasher a été retiré du réglage PASSWORD_HASHERS par défaut¶

SI vous avez utilisé bcrypt avec Django 1.4 ou 1.5 (avant que BCryptSHA256PasswordHasher ait été ajouté dans Django 1.6), il est possible que vous ayez certains mots de passe utilisant l’algorithme BCryptPasswordHasher.

Vous pouvez vérifier si c’est le cas comme ceci

from django.contrib.auth import get_user_model

User = get_user_model()
User.objects.filter(password__startswith="bcrypt$$")

Si vous souhaitez continuer à autoriser l’emploi de ces mots de passe, vous devrez redéfinir le réglage PASSWORD_HASHERS (si ce n’est pas déjà le cas) et inclure 'django.contrib.auth.hashers.BCryptPasswordHasher'.

Déplacement de la variable de contexte de gabarit de composant wrap_label¶

Pour corriger l’absence de <label> lors de l’utilisation de RadioSelect et CheckboxSelectMultiple avec MultiWidget, la variable de contexte wrap_label apparaît dorénavant comme attribut de toutes les options. Par exemple, dans un gabarit personnalisé input_option.html, modifiez {% if wrap_label %} en {% if widget.wrap_label %}.

Cookies SameSite¶

Les cookies utilisés pour django.contrib.sessions, django.contrib.messages et la protection CSRF de Django définissent désormais par défaut l’option SameSite à Lax. Les navigateurs qui respectent cette option n’enverront pas ces cookies dans les requêtes vers une origine différente. Si vous comptez sur le comportement précédent, définissez les réglages SESSION_COOKIE_SAMESITE et/ou CSRF_COOKIE_SAMESITE à None.

Considérations sur la nouvelle permission d’affichage des modèles (view)¶

class MyAdmin(admin.ModelAdmin):
    def get_form(self, request, obj=None, **kwargs):
        if not self.has_change_permission(request, obj):
            return super().get_form(request, obj, **kwargs)
        return CustomForm

Divers¶

• La version minimum de mysqlclient prise en charge est passée de 1.3.3 à 1.3.7.

• La prise en charge de SQLite < 3.7.15 a été supprimée.

• Le format de date de la directive Expires de Set-Cookie a été modifiée pour obéir à la RFC 7231 Section 7.1.1.1 au lieu du standard de cookie Netscape. Les tirets présents dans les dates comme Tue, 25-Dec-2018 22:26:13 GMT sont supprimés. Cette modification est essentiellement cosmétique sauf peut-être pour de très anciens navigateurs qui n’analysent pas le nouveau format.

• allowed_hosts est dorénavant un paramètre obligatoire de l’API privée django.utils.http.is_safe_url().

• L’attribut multiple produit par le composant SelectMultiple utilise dorénavant la syntaxe booléenne HTML5 plutôt que la forme XHTML multiple="multiple".

• Le code HTML produit par les composants de formulaires n’incluent plus la barre oblique de fermeture pour les éléments vides, par ex. <br>. Ceci est incompatible avec XHTML, même si certains composants utilisaient déjà certains aspects de HTML5 comme les attributs booléens.

• La valeur des options vides de SelectDateWidget es passée de 0 à la chaîne vide, ce qui pourrait essentiellement demander quelques ajustements dans les tests qui comparent du HTML.

• meth:.User.has_usable_password et la fonction is_password_usable() ne renvoient plus False si le mot de passe vaut None ou une chaîne vide, ou si le mot de passe utilise un algorithme absent du réglage PASSWORD_HASHERS. Ce comportement non documenté était une régression dans Django 1.6 et empêchait les utilisateurs ayant de tels mots de passe de demander une réinitialisation de leur mot de passe. Examinez votre code pour confirmer que votre utilisation de cette API ne compte pas sur l’ancien comportement.

• Comme les migrations sont dorénavant aussi chargées à partir de fichiers .pyc, il pourrait être nécessaire de les supprimer si vous travaillez dans un environnement mixte Python 2 et Python 3.

• Using None as a django.contrib.postgres.fields.JSONField lookup value now matches objects that have the specified key and a null value rather than objects that don’t have the key.

• La classe CSS d’administration field-box a été renommée en fieldBox pour éviter des conflits avec la classe attribuée aux champs de modèle nommés box.

• Since the admin’s actions.html, change_list_results.html, date_hierarchy.html, pagination.html, prepopulated_fields_js.html, search_form.html, and submit_line.html templates can now be overridden per app or per model, you may need to rename existing templates with those names that were written for a different purpose.

• QuerySet.raw() place désormais en mémoire cache ses résultats tout comme les jeux de requête normaux. Utilisez iterator() si vous voulez éviter le cache.

• La méthode de routeur de base de données allow_relation() est appelée dans plus de situations. Les routeurs mal écrits pourraient avoir besoin d’être mis à jour en conséquence.

• Les traductions ne sont plus désactivées avant de lancer les commandes d’administration. Si votre commande personnalisée a besoin de fonctionner sans les traductions (par exemple pour insérer du contenu non traduit dans la base de données), utilisez le nouveau décorateur @no_translations.

• Les commandes d’administration n’autorisent plus les formes abrégées des paramètres --settings et --pythonpath.

• La constante privée django.db.models.sql.constants.QUERY_TERMS a été supprimée. Les méthodes get_lookup() et get_lookups() de l”API d’inscription des recherches peuvent constituer de bonnes alternatives. Comparées à la constante QUERY_TERMS, elles permettent à votre code de tenir aussi compte des recherches personnalisées qui ont été inscrites.

• Compatibility with py-bcrypt is removed as it’s unmaintained. Use bcrypt instead.

Divers¶

• La fonction GIS ForceRHR a été rendue obsolète en faveur de la nouvelle fonction ForcePolygonCW.

• django.utils.http.cookie_date() a été rendue obsolète en faveur de http_date(), qui respecte le format de la RFC la plus récente.

• {% load staticfiles %} et {% load admin_static %} sont obsolètes en faveur de {% load static %}, qui remplit le même rôle.

• django.contrib.staticfiles.templatetags.static() est obsolète en faveur de django.templatetags.static.static().

• La prise en charge des méthodes InlineModelAdmin.has_add_permission() qui n’acceptent pas obj comme second paramètre positionnel sera supprimée dans Django 3.0.