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.CORRECTIFoù 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.
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.