yarn tag

Ajoute, retire ou liste les tags d'un package.

Que sont les tags ?

Les tags de distribution (ou dist-tags) sont un moyen de marquer avec un libellé des versions publiées de votre package. Les utilisateurs de votre package peuvent l’installer en utilisant le label à la place d’un numéro de version.

Par exemple, si vous avez un canal de release stable et un canal de release canary, vous pouvez utiliser les tags pour permettre à l’utilisateur de taper :

yarn add le-nom-de-votre-package@stable
yarn add le-nom-de-votre-package@canary

Différents tags peuvent avoir différentes significations :

  • latest: la version actuelle du package
  • stable: la dernière release stable du package, normalement la même que la dernière release à moins que vous ayez un support à long terme (ou Long-term Support - LTS)
  • beta: une release avant de devenir la dernière release et/ou la dernière version stable, utilisé pour partager des changements à venir avant qu’ils ne soient finalisés.
  • canary: une release “nightly” ou pre-beta, vous pouvez utiliser cette méthode si votre projet est fréquemment mis à jour et utilisé par de nombreuses personnes et que vous voulez partager au plus tôt du code.
  • dev: parfois vous voulez pouvoir tester une version via le gestionnaire alors même que vous continuez à bosser sur certaines choses, ce tag est utile pour ça.

Certains projets gèreront leurs propres tags, éventuellement en remplacement de certains tags standards. Par exemple next est parfois utilisé à la place de beta.

Bien que ces tags soient largement considérés comme des “standards”, le seul qui a une réelle signification est le tag latest car c’est celui qui sera utilisé à l’installation lorsqu’aucune version n’est spécifiée.

Mises en garde

Vous ne pouvez pas créer des tags dont le nom correspond à un numéro de version étant donné qu’ils partagent le même namespace :

yarn add votre-nom-de-package@<version>
yarn add votre-nom-de-package@<tag>

N’importe quel tag pouvant également être considéré comme un intervalle semver valide sera rejeté. Par exemple, vous ne pouvez pas nommer un tag v2.3 car en semver cela signifie >=2.3.0 <2.4.0.

En général, évitez d’utiliser des tags qui ressemblent à des versions, ils ont de toute façon tendance à embrouiller les gens.

Commandes

yarn tag add <package>@<version> <tag>

Ajoute un tag intitulé <tag> pour une <version> spécifique d’un <package>.

yarn tag rm <package> <tag>

Supprime un tag intitulé <tag> d’un <package> qui n’est plus à utiliser.

Remarque : vous n’avez pas besoin de supprimer un tag avant de le déplacer sur une autre version du package. Au contraire, il est préférable de ne pas le faire.

yarn tag list [<package>]

Liste tous les tags d’un <package>. Si aucun <package> n’est spécifié, listera par défaut tous les tags du package du répertoire dans lequel vous vous trouvez actuellement.