Référence rapide

Aide-mémoire Gestion Sémantique de Version (SemVer)

Guide de référence rapide pour SemVer : incréments MAJEUR.MINEUR.CORRECTIF, balises de pré-version et plages de gestionnaires de paquets.

· Publié le

Semantic Versioning (SemVer) définit une spécification formelle pour l'attribution des numéros de version de logiciels : MAJOR.MINOR.PATCH.

Les Trois Composants

$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$

  1. MAJOR (1.0.0 -> 2.0.0) : Changements incompatibles cassant l'API.
  2. MINOR (1.0.0 -> 1.1.0) : Nouvelles fonctionnalités rétrocompatibles.
  3. PATCH (1.0.0 -> 1.0.1) : Corrections de bugs rétrocompatibles.

Pré-versions et Métadonnées de Build

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # Métadonnées de build (+ignorées dans la priorité de version)

Ordre de préséance : 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


Spécificateurs de Plages des Gestionnaires de Paquets

Plage Versions Incluses Description
1.2.3 1.2.3 Correspondance exacte de version
>1.2.3 1.2.4, 2.0.0, ... Supérieur à
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 Plage délimitée
~1.2.3 >=1.2.3 <1.3.0 Raisonnablement proche (correctifs uniquement)
^1.2.3 >=1.2.3 <2.0.0 Compatible (mineures et correctifs autorisés)
^0.2.3 >=0.2.3 <0.3.0 En 0.x.x, une version mineure casse la compatibilité
* Any version Joker universel sans restriction

Références

Sujets associés