Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Version sémantique et journal engendré

Version sémantique et journal engendré

Hooks et qualité automatiqueavance

Un numéro de version sémantique est un contrat, pas un compteur.

MAJEUR . MINEUR . CORRECTIF
  │        │         └─ correction compatible
  │        └─ ajout compatible
  └─ changement incompatible

La règle de calcul

À partir des commits conventionnels depuis la dernière étiquette, on prend l'incrément le plus fort, une seule fois.

Ce qu'on trouve depuis l'étiquette 1.4.2 devient
que des fix 1.4.3
au moins un feat 1.5.0
au moins une rupture 2.0.0
que des docs, chore, test aucune version

Dix fix donnent 1.4.3, pas 1.4.12 : on n'additionne pas les commits, on qualifie l'intervalle.

Le cas qui trompe tout le monde

0.6.3  +  une rupture  →  0.7.0

En 0.y.z, le majeur reste à zéro : la spécification y autorise les ruptures, et la rupture monte donc la mineure. Passer en 1.0.0 est une décision — elle annonce la stabilité de l'API — pas une conséquence automatique.

Le journal des modifications

git log v1.4.2..HEAD --pretty=format:'%s'

Même intervalle, même source. Les messages sont regroupés par type, et seuls les types visibles par un utilisateur y figurent.

## 1.5.0

### Fonctionnalités
- **panier** : appliquer les codes promotionnels au total

### Corrections
- **auth** : rejeter un jeton expiré depuis moins d'une seconde

Les termes à connaître

Versionnement sémantique

Numérotation MAJEUR.MINEUR.CORRECTIF où chaque incrément a un sens contractuel : majeur casse, mineur ajoute, correctif répare.

Version 0.y.z

Phase de développement initial. La spécification y autorise des ruptures sans incrément majeur : tout peut changer à chaque version mineure.

Étiquette

git tag v2.4.0, un nom fixe pointant un commit. C'est elle qui marque le début de l'intervalle lu pour calculer la version suivante.

Journal des modifications

Le fichier qui liste ce qui a changé entre deux versions, pour les humains. Engendré depuis les messages conventionnels, il cesse d'être oublié.

Version de pré-publication

Un suffixe après un tiret — 2.0.0-rc.1. Elle se compare avant la version sans suffixe, ce qui est contre-intuitif la première fois.

Publication automatisée

Chaîne qui lit les commits depuis la dernière étiquette, calcule la version, écrit le journal, pose l'étiquette et publie. Elle rend la livraison reproductible.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.