Aller au contenu
Tout en local

Calculateur de version sémantique

Calcule automatiquement la prochaine version sémantique à partir de la version actuelle et du type d'incrément choisi, en suivant les règles SemVer 2.0.0.

Entrée
Sortie

Calculateur de version sémantique

Collez une version comme 1.4.2 et choisissez un type d'incrément — major, minor, patch, premajor ou prerelease — et cet outil calcule la prochaine version sémantique exacte, en suivant les règles de SemVer 2.0.0 pour les pré-versions et les métadonnées de compilation. Il est conçu pour les responsables qui créent une version, les scripts CI qui ont besoin de la prochaine balise, et toute personne qui souhaite vérifier un incrément de version avant qu'il ne se retrouve dans package.json ou dans une balise git.

Les incréments premajor et prerelease utilisent l'option d'identifiant de pré-version — alpha, beta ou rc — pour ouvrir ou poursuivre un cycle de pré-version, donc 2.0.0 devient 2.0.0-beta.0, et un deuxième incrément de prerelease sur le même identifiant le passe à beta.1. Ajoutez des métadonnées de compilation telles qu'un hash de commit et elles sont ajoutées après un signe plus. Activez « Recommander l'incrément à partir de la liste des commits » et mettez votre version actuelle sur la première ligne, suivie d'un message Conventional Commits par ligne : feat: recommande un incrément minor, fix: ou perf: recommande un patch, et un « ! » après le type, ou un pied de page BREAKING CHANGE:, recommande un incrément major. Saisissez une plage caret (^1.2.0) ou tilde (~1.2.0) pour voir si la version calculée se situe toujours à l'intérieur.

La calculatrice accepte un « v » de début optionnel (v1.4.2), lit correctement les identifiants de pré-version et de compilation existants, et traite les fins de ligne Windows et Unix de la même manière. Une version qui n'est pas un SemVer valide, ou une plage qui n'est pas une expression caret ou tilde valide, est signalée en langage naturel plutôt que comme une réponse silencieusement erronée.

Tout s'exécute dans votre navigateur. Aucun numéro de version ou message de commit ne sont jamais téléchargés, il est donc sûr à utiliser avec un projet non publié. Copiez le résultat, téléchargez-le en tant que fichier .txt, ou renvoyez-le à l'entrée pour enchaîner un autre incrément par-dessus.

FAQ

Comment la recommandation de liste de commits décide-t-elle du type d'incrément ?
Il lit chaque ligne après la version comme un message Conventional Commits. N'importe quel « ! » après le type, ou un pied de page BREAKING CHANGE:, recommande un incrément major ; sinon une ligne feat: recommande minor et une ligne fix: ou perf: recommande patch. Sans commits reconnaissables, il revient au type d'incrément choisi manuellement.
Que se passe-t-il avec une pré-version existante quand j'incrémente major, minor ou patch ?
Incrémenter un champ qui est déjà à sa valeur suivante sur une pré-version (par exemple 2.0.0-rc.1 avec un incrément major) supprime simplement la pré-version au lieu d'incrémenter deux fois, ce qui correspond à la façon dont des outils comme npm version le gèrent.
Que signifient les vérifications de plages caret et tilde ?
Une plage caret comme ^1.2.0 autorise toute modification qui ne touche pas le chiffre le plus à gauche non nul ; une plage tilde comme ~1.2.0 n'autorise que les modifications au niveau du correctif. L'outil indique si votre version calculée se situe dans la plage que vous avez saisie.
Accepte-t-il les versions avec un « v » initial, comme v1.4.2 ?
Oui. Le « v » de début est reconnu et supprimé avant l'analyse, ce qui correspond à la dénomination courante des balises git, et n'est pas porté au résultat calculé.
Mon numéro de version ou ma liste de commits sont-ils téléchargés quelque part ?
Non. Le calcul d'incrément s'exécute entièrement dans votre navigateur — rien de ce que vous collez ne quitte jamais votre appareil.