Depuis la version 1.0, la numérotation des versions de Django fonctionne comme ceci :
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.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é.
Les 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é.
Ces 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 ».
Certaines 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.
Voir la page de téléchargement pour connaître les publications désignées comme prises en charge à long terme.
Starting with Django 2.0, version numbers will use a loose form of semantic versioning such that each version following an LTS will bump to the next « dot zero » version. For example: 2.0, 2.1, 2.2 (LTS), 3.0, 3.1, 3.2 (LTS), etc.
SemVer 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.
Une 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 :
RemovedInDjango51Warning
.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
At any moment in time, Django’s developer team will support a set of releases to varying levels. See the supported versions section of the download page for the current state of support for each version.
The current development master will get new features and bug fixes requiring non-trivial refactoring.
Patches applied to the master branch must also be applied to the last feature release branch, to be released in the next patch release of that feature series, when they fix critical problems:
The rule of thumb is that fixes will be backported to the last feature release for bugs that would have prevented a release in the first place (release blockers).
Security fixes and data loss bugs will be applied to the current master, the last two feature release branches, and any other supported long-term support release branches.
Documentation fixes generally will be more freely backported to the last release branch. That’s because it’s highly advantageous to have the docs for the last release be up-to-date and correct, and the risk of introducing regressions is much less of a concern.
As a concrete example, consider a moment in time halfway between the release of Django 5.1 and 5.2. At this point in time:
stable/5.1.x
branch, and
released as 5.1.1, 5.1.2, etc.master
and to the stable/5.1.x
, stable/5.0.x
, and
stable/4.2.x
(LTS) branches. They will trigger the release of 5.1.1
,
5.0.5
, 4.2.8
, etc.5.1.x
.Django uses a time-based release schedule, with feature releases every eight months or so.
After each feature release, the release manager will announce a timeline for the next feature release.
Each release cycle consists of three parts:
The first phase of the release process will include figuring out what major features to include in the next version. This should include a good deal of preliminary work on those features – working code trumps grand design.
Major features for an upcoming release will be added to the wiki roadmap page, e.g. https://code.djangoproject.com/wiki/Version1.11Roadmap.
The second part of the release schedule is the « heads-down » working period. Using the roadmap produced at the end of phase one, we’ll all work very hard to get everything on it done.
At the end of phase two, any unfinished features will be postponed until the next release.
Phase two will culminate with an alpha release. At this point, the
stable/A.B.x
branch will be forked from master
.
The last part of a release cycle is spent fixing bugs – no new features will be accepted during this time. We’ll try to release a beta release one month after the alpha and a release candidate one month after the beta.
The release candidate marks the string freeze, and it happens at least two weeks before the final release. After this point, new translatable strings must not be added.
During this phase, committers will be more and more conservative with backports, to avoid introducing regressions. After the release candidate, only release blockers and documentation fixes should be backported.
In parallel to this phase, master
can receive new features, to be released
in the A.B+1
cycle.
After a feature release (e.g. A.B), the previous release will go into bugfix mode.
The branch for the previous feature release (e.g. stable/A.B-1.x
) will
include bugfixes. Critical bugs fixed on master must also be fixed on the
bugfix branch; this means that commits need to cleanly separate bug fixes from
feature additions. The developer who commits a fix to master will be
responsible for also applying the fix to the current bugfix branch.
août 01, 2018