npm-README - En ligne dans le Cloud

PROGRAMME:

Nom

NPM - un gestionnaire de packages JavaScript

État de la construction https://travis-ci.org/npm/npm

SYNOPSIS

C'est juste assez d'informations pour vous aider à démarrer.

Beaucoup plus d'informations disponibles via NPM vous aider une fois installé.

IMPORTANT

Vous need nœud v0.8 or augmentation à courir ceci. .

Pour installer un ancien et non pris en charge version de npm qui fonctionne sur le nœud 0.3 et antérieur, clone
le repo git et fouillez dans les anciennes balises et branches.

NPM is configurée à utilisé npm, Inc. public paquet enregistrement at https://registry.npmjs.org
par défaut.

Vous pouvez configurer npm pour utiliser n'importe quel registre compatible que vous aimez, et même exécuter le vôtre
enregistrement. Consultez la doc sur les registres https://docs.npmjs.com/misc/registry.

L'utilisation du registre de quelqu'un d'autre peut être régie par des conditions d'utilisation. Les conditions d'utilisation du
registre public par défaut sont disponibles sur https://www.npmjs.com.

Super Facile Installer

npm est fourni avec le nœud http://nodejs.org/download/.

Windows Ordinateur
Obtenez le MSI http://nodejs.org/download/. npm est dedans.

Apple Macintosh Ordinateur
Obtenez le paquet http://nodejs.org/download/. npm est dedans.

Autres Trie of Unix
Courir a prendre une installer. npm sera installé avec node.

Si vous voulez une installation de pantalon plus sophistiquée (une version différente, des chemins personnalisés, etc.), alors
continuer à lire.

Chic Installer (Unix)

Il y a un script d'installation assez robuste sur https://www.npmjs.com/install.sh. Vous pouvez
téléchargez-le et exécutez-le.

Voici un exemple utilisant curl :

curl -L https://www.npmjs.com/install.sh | merde

Légèrement Amateur
Vous pouvez définir n'importe quel paramètre de configuration npm avec ce script :

npm_config_prefix=/some/path sh install.sh

Ou, vous pouvez l'exécuter en mode uber-debugger :

npm_debug=1 sh install.sh

Pourtant, la Amateur
Obtenez le code avec git. Utilisation a prendre une pour construire les documents et faire d'autres choses. Si vous prévoyez
piratage sur npm, a prendre une lien est votre ami.

Si vous avez le code source npm, vous pouvez également définir de manière semi-permanente des clés de configuration arbitraires
en utilisant l' . / Configure --key=val ..., puis exécutez les commandes npm en faisant nœud cli.js
. (Ceci est utile pour tester ou exécuter des choses sans installer réellement npm
lui-même.)

Windows Installer or Mise à niveau

Vous pouvez télécharger un fichier zip à partir de https://github.com/npm/npm/releases, et déballez-le dans le
node_modules\npm\ dossier dans le dossier d'installation du nœud.

Pour mettre à niveau vers npm 2, suivez les instructions de mise à niveau de Windows dans le dépannage npm
Guide:

https://github.com/npm/npm/wiki/Troubleshooting#upgrading-on-windows

Si cela ne vous suffit pas, vous pouvez récupérer le code avec git et le modifier
.

Pose on Cygwin

No.

Désinstallation

Tellement triste de te voir partir.

sudo npm désinstaller npm -g

Ou, si cela échoue,

sudo faire désinstaller

Plus Sévère Désinstallation

Habituellement, les instructions ci-dessus sont suffisantes. Cela supprimera npm, mais laissera derrière
tout ce que vous avez installé.

Si vous souhaitez supprimer tous les packages que vous avez installés, vous pouvez utiliser le
NPM ls commande pour les trouver, puis NPM rm pour les enlever.

Pour supprimer les déchets laissés par npm 0.x, vous pouvez utiliser le inclus nettoyer-vieux.sh Fichier de script.
Vous pouvez l'exécuter facilement comme ceci :

npm explorer npm -g -- sh scripts/clean-old.sh

npm utilise deux fichiers de configuration, un pour les configurations par utilisateur et un autre pour les configurations globales
(tous les utilisateurs) configs. Vous pouvez les visualiser en faisant :

npm config get userconfig # par défaut ~/.npmrc
npm config get globalconfig # par défaut sur /usr/local/etc/npmrc

La désinstallation de npm ne supprime pas les fichiers de configuration par défaut. Vous devez les supprimer
vous-même manuellement si vous voulez qu'ils disparaissent. Notez que cela signifie que les futures installations de npm
ne se souviendra pas des paramètres que vous avez choisis.

En utilisant NPM Par programme

Bien que npm puisse être utilisé par programmation, son API est destinée à être utilisée par la CLI uniquementet
aucune garantie n'est donnée quant à son adéquation à d'autres fins. Si vous voulez utiliser npm
pour effectuer une tâche de manière fiable, la chose la plus sûre à faire est d'invoquer le NPM commander
avec des arguments appropriés.

La version sémantique de npm fait référence à la CLI elle-même, plutôt qu'à l'API sous-jacente. Le manuel de formation
interne API is pas garantie à rester stable pair quand npm version indique aucune
rupture change avons était LES PLANTES selon à semeur.

Si vous parfois surprenante voudrais utiliser npm par programmation, c'est possible. L'API n'est pas très
bien documenté, mais il is plutôt simple.

Finalement, npm ne sera qu'un mince wrapper CLI autour des modules dont il dépend, mais
pour l'instant, il y a certaines choses que seule la CLI peut faire. Vous devriez essayer d'utiliser l'un des npm
dépendances d'abord, et n'utilisez l'API que si ce que vous essayez de faire n'est pris en charge que par
npm lui-même.

var npm = require("npm")
npm.load(monObjetConfig, fonction (euh) {
if (er) renvoie handleError(er)
npm.commands.install(["certains", "args"], fonction (euh, données) {
si (euh) renvoie commandFailed (euh)
// la commande a réussi et les données peuvent avoir des informations
})
npm.registry.log.on("log", fonction (message) { .... })
})

Le manuel de formation charge La fonction prend un hachage d'objet des configurations de ligne de commande. Les différents
npm.commandes. les fonctions prennent un tableau de l'argument positionnel instruments à cordes. Le dernier
argument à n'importe quel npm.commandes. la fonction est un rappel. Certaines commandes en prennent d'autres
arguments optionnels. Lire la source.

Vous ne pouvez pas définir de configuration individuellement pour une seule fonction npm pour le moment. Depuis NPM is
un singleton, tout appel à npm.config.set changera la valeur de tous commandes npm dans ce
processus.

See ./bin/npm-cli.js pour un exemple d'extraction des valeurs de configuration de la ligne de commande
arguments utilisant nopt. Vous pouvez également consulter NPM vous aider config pour tout savoir
les options que vous pouvez y définir.

Plus Docs

Consultez les documents https://docs.npmjs.com/, en particulier la faq
https://docs.npmjs.com/misc/faq.

Vous pouvez utiliser le NPM vous aider commande de lire l'un d'entre eux.

Si vous êtes un développeur et que vous souhaitez utiliser npm pour publier votre programme, vous devriez lire
ceci. https://docs.npmjs.com/misc/developers

Utilisez npm-README en ligne à l'aide des services onworks.net