npm

O Node Package Manager (npm) fornece duas funcionalidades principais:

• Repositórios online para pacotes e módulos node.js que podem ser localizados em http://search.nodejs.org
• Utilitários de linha de comando para instalar pacotes node.js, fazendo o gerenciamento de versões e dependências.

O npm é instalado junto com o node.js.  Para verificar qual a sua versão, abra a console (ou execute cmd no windows) e digite o seguinte comando:

$ npm -v
 4.3.0

Se você está rodando uma versão antiga do npm, então é muito fácil atualizar para a última versão, usando o seguinte comando:

$ sudo npm install npm -g
/usr/bin/npm  -> /usr/lib/node_modules/npm/bin/npm-cli.js
npm@2.7.1 /usr/lib/node_modules/npm   

Para iniciar um novo projeto use o seguinte comando:

$ mkdir teste
$ cd teste
$ npm init -y    

Este comando irá criar um arquivo package.js com a descrição do projeto que terá o mesmo nome que o diretório corrente.

Se agora quisermos instalar o módulo  chamado “Johnny-Five” localmente podemos usar o comando:

$ npm install --save  johnny-five   

Isso irá criar um diretório node\_modules no diretório atual onde o pacote johnny-five será instalado juntamente com todos os pacotes com quem tenha dependências.

A opção --save faz com que o arquivo package.json seja alterado para indicar que o  pacote johnny-five já foi instalado localmente. O comando

$ npm ls    
Irá listar todos os pacotes instalados localmente. O comando

$ npm search mkdir

Verifica se tem algum pacote com nome ou que realize funções similares de manipulação e diretório. O comando

$ npm uninstall johnny-five

Pode ser utilizado para desinstalar o pacote johnny-five junto  com as suas dependências. Na realidade há duas maneiras de instalar as coisas:

• globalmente – isso coloca os módulos em  {prefix}/lib/node_modules, e coloca os arquivos executáveis em  {prefix}/bin, onde {prefix} usualmente é  algo como /usr/local. Isso também instala as páginas de manuais em  {prefix}/share/man, se houver. 

• localmente – Isso instala seu pacote no diretório de trabalho atual  em  ./node_modules, executáveis vão para  ./node_modules/.bin/, e as páginas de manual não são instaladas.

Pacotes e dependências instalados globalmente são armazenados em um diretório do sistema. Em geral, a regra padrão é a seguinte:

• Se você está instalando que você deseja usar apenas no seu programas, usando require ('whatever'), então instale-o localmente, na raiz do seu projeto.

• Se você está instalando alguma coisa que você quer usar no seu shell, ou na linha de comando ou algo assim, instale-o globalmente, de modo que os binários possam ser encontrados no caminho definido pela variável de ambiente PATH.

Vamos tentar instalar o modulo johnny-five utilizando uma instalação global:

$ npm install johnny-five -g

Isso irá produzir um resultado similar mas o módulo será instalado globalmente. A primeira linha da saída amostra a versão do módulo e o lugar onde está sendo instalado.