Comandos NPM Essenciais: install, update, uninstall

Boas-vindas à nossa aula prática sobre gerenciamento de dependências com NPM! 🚀

Nesta aula, vamos mergulhar nos comandos mais fundamentais do Node Package Manager (NPM): install, update e uninstall. Eles são a espinha dorsal de qualquer projeto Node.js, permitindo que você adicione, atualize e remova bibliotecas e ferramentas necessárias para o seu desenvolvimento.

Ao final desta aula, você será capaz de:

• Instalar pacotes localmente e globalmente.
• Gerenciar dependências de desenvolvimento.
• Atualizar pacotes para suas versões mais recentes (dentro das regras de versionamento semântico).
• Remover pacotes de forma eficiente.

Vamos colocar a mão na massa! 💪

1. npm install: Adicionando Poder ao Seu Projeto

O comando npm install é o seu ponto de partida para adicionar pacotes ao seu projeto Node.js. Ele é usado para baixar e instalar dependências listadas no arquivo package.json ou para instalar pacotes específicos diretamente.

Como funciona?

Quando você executa npm install (sem argumentos) em um diretório que contém um arquivo package.json, o NPM lê as seções dependencies e devDependencies e baixa todos os pacotes listados, instalando-os na pasta node_modules. Ele também cria ou atualiza o arquivo package-lock.json, que garante que as instalações futuras usem exatamente as mesmas versões dos pacotes.

Exemplos Práticos:

1.1. Instalar todas as dependências do package.json

npm install

Este comando é essencial quando você clona um projeto Node.js de um repositório e precisa configurar o ambiente.

1.2. Instalar um pacote específico localmente

npm install <nome-do-pacote>

Isso instala o pacote na pasta node_modules do seu projeto. Por padrão, ele também adiciona o pacote à seção dependencies do seu package.json com um prefixo ^ (caret), significando que o NPM pode instalar atualizações de patch e minor no futuro.

Exemplo: Vamos instalar a popular biblioteca Express para criar servidores web.

npm install express

Após executar, seu package.json terá uma linha similar a:

  "dependencies": {
    "express": "^4.18.2" // A versão pode variar
  }

1.3. Instalar um pacote como dependência de desenvolvimento (--save-dev ou -D)

Dependências de desenvolvimento são pacotes que são necessários apenas durante o desenvolvimento e teste do seu projeto, mas não são essenciais para o seu código em produção. Ferramentas de teste, linters e bundlers são exemplos comuns.

npm install <nome-do-pacote> --save-dev
# ou a forma abreviada
npm install <nome-do-pacote> -D

Exemplo: Vamos instalar o nodemon, uma ferramenta que reinicia automaticamente o servidor Node.js quando detecta mudanças nos arquivos.

npm install nodemon --save-dev

Seu package.json agora terá uma seção devDependencies:

  "devDependencies": {
    "nodemon": "^3.0.1" // A versão pode variar
  }

1.4. Instalar um pacote globalmente (-g)

Pacotes globais são ferramentas de linha de comando que você deseja usar em qualquer lugar do seu sistema, independentemente do projeto. Eles não são adicionados ao package.json de nenhum projeto específico.

npm install <nome-do-pacote> -g

Exemplo: Vamos instalar o http-server, um servidor estático simples.

npm install http-server -g

Agora você pode usar o comando http-server em qualquer diretório do seu terminal.

1.5. Instalar uma versão específica de um pacote

Às vezes, você pode precisar de uma versão exata de um pacote.

npm install <nome-do-pacote>@<versao>

Exemplo: Instalar uma versão mais antiga do Express.

npm install express@4.17.1

Documentação Oficial:

Para mais detalhes sobre npm install, consulte a documentação oficial: npm install | npm Docs

2. npm update: Mantendo Suas Dependências em Dia

O comando npm update é usado para atualizar os pacotes instalados para suas versões mais recentes, respeitando as regras de versionamento semântico definidas no seu package.json.

Como funciona?

Quando você executa npm update, o NPM verifica as versões mais recentes dos pacotes que correspondem aos intervalos especificados no package.json (por exemplo, ^4.18.2 significa "qualquer versão 4.x.x que seja maior ou igual a 4.18.2"). Ele então baixa e instala essas novas versões, atualizando a pasta node_modules e o package-lock.json.

Exemplos Práticos:

2.1. Atualizar todas as dependências

npm update

Este comando irá verificar todas as dependências listadas no seu package.json e as atualizará para as versões mais recentes que se encaixam nos intervalos de versão definidos.

2.2. Atualizar um pacote específico

npm update <nome-do-pacote>

Se você quiser atualizar apenas um pacote, use este comando.

Exemplo: Se o seu package.json tem express: "^4.18.1" e uma nova versão 4.18.2 foi lançada, este comando a instalará.

npm update express

2.3. Atualizar um pacote globalmente

npm update -g <nome-do-pacote>

Exemplo: Atualizar o http-server globalmente.

npm update -g http-server

Documentação Oficial:

Para mais detalhes sobre npm update, consulte a documentação oficial: npm update | npm Docs

3. npm uninstall: Removendo o que Não é Mais Necessário

O comando npm uninstall (ou npm remove, npm rm) é usado para remover pacotes da pasta node_modules e, opcionalmente, do seu package.json.

Como funciona?

Quando você desinstala um pacote, o NPM o remove da pasta node_modules e, se você usar a flag --save (ou --save-dev), ele também remove a entrada correspondente do seu package.json e atualiza o package-lock.json.

Exemplos Práticos:

3.1. Desinstalar um pacote localmente (e remover do package.json)

npm uninstall <nome-do-pacote> --save
# ou a forma abreviada
npm uninstall <nome-do-pacote>

Desde o NPM 5, npm uninstall <nome-do-pacote> por padrão também remove a entrada do package.json. O --save é redundante, mas pode ser usado para clareza. Para dependências de desenvolvimento, use --save-dev.

Exemplo: Vamos remover o Express do nosso projeto.

npm uninstall express

Após este comando, o Express será removido de node_modules e a linha express desaparecerá da seção dependencies do seu package.json.

3.2. Desinstalar uma dependência de desenvolvimento

npm uninstall <nome-do-pacote> --save-dev
# ou a forma abreviada
npm uninstall <nome-do-pacote> -D

Exemplo: Remover o nodemon.

npm uninstall nodemon --save-dev

3.3. Desinstalar um pacote globalmente

npm uninstall -g <nome-do-pacote>

Exemplo: Desinstalar o http-server globalmente.

npm uninstall -g http-server

Documentação Oficial:

Para mais detalhes sobre npm uninstall, consulte a documentação oficial: npm uninstall | npm Docs

4. Exercícios Práticos: Mão na Massa! 🛠️

Agora é a sua vez de praticar! Siga os passos abaixo para consolidar seu conhecimento sobre os comandos npm install, npm update e npm uninstall.

Tarefas:

1. Inicializar um Novo Projeto:

Crie um novo diretório para o seu projeto e inicialize-o com o NPM.

mkdir meu-projeto-npm
cd meu-projeto-npm
npm init -y # O "-y" aceita todas as opções padrão

2. Instalar Dependências Essenciais:

Instale os pacotes axios (para fazer requisições HTTP) e lodash (uma biblioteca de utilitários) como dependências normais.

npm install axios lodash

3. Adicionar uma Dependência de Desenvolvimento:

Instale o pacote eslint (um linter de código) como uma dependência de desenvolvimento.

npm install eslint --save-dev

4. Verificar package.json e node_modules:

Abra seu arquivo package.json e confirme que axios, lodash e eslint estão listados nas seções corretas. Verifique também a existência da pasta node_modules e dos pacotes instalados dentro dela.

5. Simular uma Atualização:

Para este exercício, vamos simular que uma nova versão de axios foi lançada que ainda se encaixa no seu range de package.json. Não podemos forçar uma atualização se não houver uma versão mais nova disponível no range. Para fins de aprendizado, execute o comando de atualização. Se não houver uma atualização real, o NPM informará que nada foi atualizado.

npm update axios

Dica: Para realmente ver uma atualização, você poderia editar o package.json para uma versão mais antiga (e.g., axios@0.21.1) e depois executar npm update axios para ver ele subir para a versão mais recente dentro do range ^.

6. Instalar um Pacote Global:

Instale o pacote create-react-app globalmente (se você não o tiver). Este é um pacote que cria novos projetos React.

npm install create-react-app -g

7. Desinstalar uma Dependência Local:

Remova o pacote lodash do seu projeto.

npm uninstall lodash

Verifique seu package.json para confirmar que lodash foi removido.

8. Desinstalar uma Dependência de Desenvolvimento:

Remova o eslint do seu projeto.

npm uninstall eslint --save-dev

Verifique seu package.json novamente.

9. Desinstalar um Pacote Global:

Remova o create-react-app que você instalou globalmente.

npm uninstall create-react-app -g

10. Limpeza Final:

Delete a pasta meu-projeto-npm para limpar o ambiente.

cd ..
rm -rf meu-projeto-npm # No Windows, use `rmdir /s /q meu-projeto-npm`

Resumo e Próximos Passos ✨

Nesta aula, você aprendeu os comandos NPM mais cruciais para gerenciar as dependências do seu projeto Node.js:

• npm install: Para adicionar pacotes, seja localmente (como dependência normal ou de desenvolvimento) ou globalmente.
• npm update: Para manter seus pacotes atualizados dentro dos limites de versionamento semântico.
• npm uninstall: Para remover pacotes que não são mais necessários.

Dominar esses comandos é fundamental para qualquer desenvolvedor Node.js, pois eles garantem que seu projeto tenha as ferramentas certas, nas versões corretas, e que seu ambiente de desenvolvimento seja limpo e eficiente.

Próximos Passos:

• package-lock.json: Entenda a importância do package-lock.json para garantir instalações consistentes.
• Versionamento Semântico (SemVer): Aprofunde-se em como o SemVer (^, ~, *) funciona e como ele afeta as atualizações de pacotes.
• npm audit: Aprenda a usar npm audit para verificar vulnerabilidades de segurança em suas dependências.
• npm run: Descubra como usar scripts personalizados no seu package.json para automatizar tarefas.

Continue praticando e explorando a vasta gama de pacotes disponíveis no NPM! 👩‍💻👨‍💻