Depuis la version 1.0, la numérotation des versions de Django fonctionne comme ceci :
\nLes versions sont numérotées sous la forme A.B ou A.B.C.
A.B est le numéro de version de publication majeure. Chaque version est rétrocompatible autant que possible avec la version précédente. Les exceptions à cette règle sont énumérées dans les notes de publication.
C est le numéro de version corrective, qui est incrémenté pour les corrections de bogues et de sécurité. Ces publications sont 100% rétrocompatibles avec les précédentes versions correctives. La seule exception concerne les cas où un problème de sécurité ou de perte de données ne peut pas être résolu sans casser la rétrocompatibilité. Si cela se produit, les notes de publication donnent alors des instructions de mise à jour détaillées.
Avant une nouvelle publication majeure, des publications alpha, beta et d’évaluation sont diffusées. Elles sont numérotées sous la forme A.B alpha/beta/rc N, ce qui signifie la Nième version alpha/beta/d’évaluation de la version A.B.
Dans git, chaque version de Django possède un « tag » nommé selon son numéro de version, signé avec la clé de publication de Django. De plus, chaque série de versions possède sa propre branche, appelée stable/A.B.x, et les publications corrigeant des anomalies ou des failles de sécurité sont produites à partir de ces branches.
Pour plus d’informations sur la manière dont le projet Django produit de nouvelles publications à des fins de sécurité, veuillez consulter nos politiques de sécurité.
\nLes publications majeures (A.B, A.B+1, etc.) apparaissent environ tous les huit mois, voir processus de publication pour les détails. Ces publications contiennent de nouvelles fonctionnalités ainsi que des améliorations à celles déjà existantes, entre autres.
\nLes publications correctives (A.B.C, A.B.C+1, etc.) sont diffusées si nécessaire, pour corriger des anomalies ou des problèmes de sécurité.
\nCes publications sont 100% compatibles avec la version majeure à laquelle elle correspond, sauf si c’est impossible en raison de problèmes de sécurité ou de pertes de données. Ainsi, la réponse à la question « dois-je mettre à jour à la dernière publication corrective ? » est toujours « oui ».
\nCertaines publications majeures sont désignées comme des versions prises en charge à long terme (LTS). Celles-ci vont recevoir les correctifs de sécurité et liées aux pertes de données pendant une durée garantie, habituellement pendant trois ans.
\nVoir la page de téléchargement pour connaître les publications désignées comme prises en charge à long terme.
\nÀ partir de la version 2.0, les numéros de version utilisent une forme libre du versionnement sémantique de façon à ce que chaque version suivant une LTS recommence à la prochaine version « point zéro ». Par exemple : 2.0, 2.1, 2.2 (LTS), 3.0, 3.1, 3.2 (LTS), etc.
\nSemVer facilite la détection au premier coup d’œil de la compatibilité des versions les unes avec les autres. C’est aussi une aide pour anticiper le moment où les blocs de compatibilité seront supprimés. Il ne s’agit pas d’une forme pure de SemVer, car chaque version majeure continue de comporter quelques incompatibilités documentées lorsqu’un chemin d’obsolescence n’est pas possible ou que le coût en serait trop élevé. De plus, les obsolescences démarrées lors d’une version LTS (X.2) sont supprimées dans une version non .0 (Y.1) pour correspondre à notre politique de conservation des blocs de compatibilité durant au minimum deux version majeures. Lisez la section suivante qui comporte un exemple.
\nUne version majeure peut rendre obsolètes certaines fonctionnalités de versions précédentes. Si une fonctionnalité est rendue obsolète lors de la version majeure A.x, elle continuera de fonctionner dans toutes les versions A.x (quel que soit x), mais produira des avertissements. Les fonctionnalités obsolètes seront supprimées dans la version B.0, ou B.1 pour les fonctionnalités rendues obsolètes dans la dernière version A.x afin de s’assurer que les avertissements d’obsolescence apparaissent au minimum dans deux versions majeures.
Par exemple, si nous décidons de rendre obsolète une fonction dans Django 4.2 :
\nDjango 4.2 contiendra une copie rétrocompatible de la fonction, mais en déclenchant un avertissement RemovedInDjango51Warning.
Django 5.0 (la version qui suit 4.2) contiendra encore la copie rétrocompatible.
Django 5.1 supprimera totalement la fonction.
Les avertissements sont silencieux par défaut. Vous pouvez faire afficher ces avertissements avec l’option -Wd de Python.
Un exemple plus générique
\nX.0
X.1
X.2 LTS
Y.0 : abandon des blocs de compatibilité ajoutés dans X.0 et X.1.
Y.1 : abandon des blocs de compatibilité ajoutés dans X.2.
Y.2 LTS : aucune suppression de bloc de compatibilité (même si Y.0 n’est plus prise en charge, les applications tierces doivent maintenir la compatibilité avec X.2 LTS pour faciliter les transitions de LTS à LTS).
Z.0 : abandon des blocs de compatibilité ajoutés dans Y.0 et Y.1.
See also the Deprecating a feature guide.
\nAt any moment in time, Django’s developer team will support a set of releases to\nvarying levels. See the supported versions section of the download\npage for the current state of support for each version.
\nLa branche master de développement reçoit les nouvelles fonctionnalités et les corrections de bogues qui nécessitent des révisions de code non triviales.
Les correctifs appliqués à la branche principale doivent également être appliqués à la dernière branche de publications stables, afin d’être publiés lors de la version corrective suivante de cette série, s’ils concernent des corrections de problèmes critiques :
\nFailles de sécurité.
Bogues provoquant des pertes de données.
Bogues provoquant des plantages.
Des bogues fonctionnels majeurs dans des nouvelles fonctionnalités de la dernière version stable.
Regressions from older versions of Django introduced in the current release\nseries.
La règle de base est que des corrections sont rétroportées vers la dernière version stable s’il s’agit de bogues qui auraient bloqué une publication normale (bloqueurs de publication).
\nLes correctifs de sécurité et les bogues de perte de données sont appliqués à la branche master actuelle, aux deux dernières branches de version stable et à toute autre branche faisant partie d’une prise en charge à long terme (LTS).
Documentation fixes generally will be more freely backported to the last\nrelease branch. That’s because it’s highly advantageous to have the docs for\nthe last release be up-to-date and correct, and the risk of introducing\nregressions is much less of a concern.
As a concrete example, consider a moment in time halfway between the release of\nDjango 5.1 and 5.2. At this point in time:
\nFeatures will be added to development master, to be released as Django 5.2.
Critical bug fixes will be applied to the stable/5.1.x branch, and\nreleased as 5.1.1, 5.1.2, etc.
Security fixes and bug fixes for data loss issues will be applied to\nmaster and to the stable/5.1.x, stable/5.0.x, and\nstable/4.2.x (LTS) branches. They will trigger the release of 5.1.1,\n5.0.5, 4.2.8, etc.
Documentation fixes will be applied to master, and, if easily backported, to\nthe latest stable branch, 5.1.x.
Django suit un calendrier de publication à date fixe, avec des publications majeures environ tous les 8 mois.
\nAprès chaque publication majeure, le gestionnaire de publication annonce le calendrier de la prochaine version majeure.
\nChaque cycle de publication consiste en trois parties :
\nLa première phase du processus de publication comprend l’évaluation des fonctionnalités majeures à inclure dans la prochaine version. Ceci implique qu’une grande partie du travail préliminaire sur ces fonctionnalités ait été fait, du code fonctionnel étant toujours préférable aux grandes idées.
\nLes fonctionnalités majeures d’une publication à venir seront ajoutées à la page wiki de la feuille de route, par ex. https://code.djangoproject.com/wiki/Version1.11Roadmap.
\nThe second part of the release schedule is the « heads-down » working period.\nUsing the roadmap produced at the end of phase one, we’ll all work very hard to\nget everything on it done.
\nAt the end of phase two, any unfinished features will be postponed until the\nnext release.
\nPhase two will culminate with an alpha release. At this point, the\nstable/A.B.x branch will be forked from master.
The last part of a release cycle is spent fixing bugs – no new features will\nbe accepted during this time. We’ll try to release a beta release one month\nafter the alpha and a release candidate one month after the beta.
\nThe release candidate marks the string freeze, and it happens at least two\nweeks before the final release. After this point, new translatable strings\nmust not be added.
\nDuring this phase, committers will be more and more conservative with\nbackports, to avoid introducing regressions. After the release candidate, only\nrelease blockers and documentation fixes should be backported.
\nIn parallel to this phase, master can receive new features, to be released\nin the A.B+1 cycle.
À la suite d’une publication majeure (par ex. A.B), la version précédente passe en mode correction de bogues.
\nThe branch for the previous feature release (e.g. stable/A.B-1.x) will\ninclude bugfixes. Critical bugs fixed on master must also be fixed on the\nbugfix branch; this means that commits need to cleanly separate bug fixes from\nfeature additions. The developer who commits a fix to master will be\nresponsible for also applying the fix to the current bugfix branch.