Conventional Commits + SemVer

Un bon message de commit raconte le quoi et le pourquoi — et il dicte la prochaine version. Composez le vôtre et visualisez son impact SemVer.

La convention Conventional Commits structure vos messages (type(scope): description) et permet d'automatiser le versioning SemVer. Composez votre commit ci-dessous : l'aperçu et l'impact de version se mettent à jour en direct.

Du commit à la version

Un message normé d'un côté, une version qui se calcule toute seule de l'autre. À gauche, on décortique l'anatomie d'un commit ; à droite, on voit quel chiffre de la version chaque type fait bouger.

Anatomie d'un message
feat(api)!: ajoute l'authentification type nature du changement description à l'impératif, concise scope (portée) ! = rupture (breaking) BREAKING CHANGE: l'API /v1 est supprimée

Le pied BREAKING CHANGE: force une version majeure, même sans le !.

Type de commit → incrément SemVer
MAJOR . MINOR . PATCH 1.4.2 version actuelle fix: PATCH 1.4.2 → 1.4.3 feat: MINOR 1.4.2 → 1.5.0 feat!: MAJOR 1.4.2 → 2.0.0 ou BREAKING CHANGE

Un message normé décrit l'intention (type, portée, rupture). De là, l'incrément de version se déduit tout seul : fix → PATCH, feat → MINOR, rupture (! ou BREAKING CHANGE) → MAJOR — et le changelog s'écrit automatiquement.

À l'impératif, sans majuscule ni point final.
Message de commit 

                        
                    


                    

                        
Impact SemVer

                        

                    

                

            


            

                 Retour aux outils