npm installer depuis Git dans une version spécifique

Supposons que j'ai écrit un module pour Node.js que je voudrais garder privé. Je sais que je peux (dois) ajouter la ligne:

"private": "true"

au package.jsonfichier, et je sais aussi que je peux npm installutiliser ce module en utilisant un chemin d'accès au système de fichiers ou un lien vers un référentiel git, y compris GitHub.

Je sais aussi que je peux mettre un tel chemin de système de fichiers ou un lien vers un dépôt git package.json, afin que la dependenciespartie ressemble un peu à ceci:

"dependencies": {
  "myprivatemodule": "[email protected]:..."
}

Ce que je veux maintenant, ce n'est pas un lien vers la dernière version, mais vers une version spécifique. La seule possibilité que je connaisse est de créer un lien vers un commit spécifique en utilisant son ID. Mais c'est beaucoup moins lisible et pire maintenable que d'utiliser un numéro de version tel que 0.3.1.

Ma question est donc la suivante: est-il possible de spécifier un tel numéro de version de toute façon et de demander à npm de rechercher dans le référentiel git le dernier commit qui inclut cette version?

Sinon, comment résolvez-vous ce problème dans vos projets? Vivez-vous avec des ID de validation ou existe-t-il une meilleure solution à cela?

Une dépendance doit être disponible à partir de registrypour être installée simplement en spécifiant un versiondescripteur .

Vous pouvez certainement créer et utiliser votre propre registre au lieu de registry.npmjs.orgne pas partager publiquement vos projets.

Mais si ce n'est pas dans un registre, il devra être référencé par URL ou URL Git . Pour spécifier une version avec une URL Git, incluez un élément approprié <commit-ish>, tel qu'une balise, à la fin en tant que fragment d'URL .

Exemple, pour une balise nommée 0.3.1 :

"dependencies": {
  "myprivatemodule": "[email protected]:...#0.3.1"
}

Remarque : L'extrait de code ci-dessus montre l'URL de base de la même manière qu'elle a été publiée dans la question.

La partie coupée (... ) doit être remplie:

"myprivatemodule": "[email protected]:{owner}/{project}.git#0.3.1"

Et, un format d'adresse différent sera nécessaire lorsque l'accès SSH n'est pas disponible:

"myprivatemodule": "git://github.com/{owner}/{project}.git#0.3.1"

En fonction de votre système d'exploitation, vous pouvez également accéder linkà la dépendance dans un autre dossier où vous l'avez clonée à partir de Github.

La réponse acceptée n'a pas fonctionné pour moi. Voici ce que je fais pour extraire un paquet de github:

npm install --save "git://github.com/username/package.git#commit"

Ou en l'ajoutant manuellement sur package.json:

"dependencies": {
  "package": "git://github.com/username/package.git#commit"
}

Si par version vous entendez une balise ou une version, alors github fournit des liens de téléchargement pour ceux-ci. Par exemple, si je veux installer la version 0.3.2 de fetch (elle n'est pas disponible sur npm), alors j'ajoute à mon package.jsonsous dependencies:

"fetch": "https://github.com/github/fetch/archive/v0.3.2.tar.gz",

Le seul inconvénient par rapport à l'approche de hachage de validation est qu'un hachage est garanti de ne pas représenter le code modifié, alors qu'une balise pourrait être remplacée. Heureusement, cela arrive rarement.

Mettre à jour:

Ces jours-ci, l'approche que j'utilise est la notation compacte pour une dépendance servie GitHub:

"dependencies": {
  "package": "github:username/package#commit"
}

Où commit peut être n'importe quoi, comme une balise. Dans le cas de GitHub, vous pouvez même supprimer l'initiale github:car c'est la valeur par défaut.

Mon exemple de commentaire à @qubyte ci-dessus a été haché, alors voici quelque chose de plus facile à lire ...

La méthode @surjikal décrite ci - dessus fonctionne pour les commits de branche, mais cela n'a pas fonctionné pour un commit d' arbre que j'essayais d'inclure.

Le mode archive fonctionne également pour les commits. Par exemple, récupérez @ a2fbf83

npm :

npm install  https://github.com/github/fetch/archive/a2fbf834773b8dc20eef83bb53d081863d3fc87f.tar.gz

fil :

yarn add  https://github.com/github/fetch/archive/a2fbf834773b8dc20eef83bb53d081863d3fc87f.tar.gz

format :

 https://github.com/<owner>/<repo>/archive/<commit-id>.tar.gz

yarn add  https://github.com/vuejs/vuex/archive/c3626f779b8ea902789dd1c4417cb7d7ef09b557.tar.gz

pour le commit vuex associé

Cette commande installe le package npm à username/packagepartir d'un commit git spécifique:

npm install https://github.com/username/package#3d0a21cc

Voici les 3d0a21cc8 premiers caractères du hachage de validation.

Je décris ici un problème auquel j'ai été confronté lors de l'exécution npm install- le package n'apparaît pas dans node_modules.

Le problème était que la namevaleur package.jsondu package installé était différente du nom du package importé (entrée package.jsonde mon projet).

Donc , si votre nom de projet est installé some-package(valeur de nom dans son package.json) puis dans package.jsonvotre écriture de projet: "some-package": "owner/some-repo#tag".

J'avais besoin d'exécuter deux versions de tfjs-core et trouvé que les deux devaient être construits après avoir été installés.

package.json:

"dependencies": {
  "tfjs-core-0.14.3": "git://github.com/tensorflow/tfjs-core#bb0a830b3bda1461327f083ceb3f889117209db2",
  "tfjs-core-1.1.0": "git://github.com/tensorflow/tfjs-core#220660ed8b9a252f9d0847a4f4e3c76ba5188669"
}

Ensuite:

cd node_modules/tfjs-core-0.14.3 && yarn install && yarn build-npm && cd ../../
cd node_modules/tfjs-core-1.1.0  && yarn install && yarn build-npm && cd ../../

Et enfin, pour utiliser les bibliothèques:

import * as tf0143 from '../node_modules/tfjs-core-0.14.3/dist/tf-core.min.js';
import * as tf110 from '../node_modules/tfjs-core-1.1.0/dist/tf-core.min.js';

Cela a très bien fonctionné mais est très certainement #hoodrat

Si vous faites cela avec plus d'un module et que vous souhaitez avoir plus de contrôle sur les versions, vous devriez envisager d'avoir votre propre registre npm privé.

De cette façon, vous pouvez npm publier vos modules dans votre registre npm privé et utiliser les entrées package.json de la même manière que vous le feriez pour les modules publics.

https://docs.npmjs.com/files/package.json#dependencies