Comenzando un nuevo proyecto
Cuando
comenzamos un nuevo proyecto usando node.js es necesario crear un
archivo llamado package.json. Éste es una especie de manifiesto que a su
vez contiene el listado de todas las dependencias que usará tu proyecto.
La mejor manera de gestionar los paquetes instalados localmente es crear un archivo package.json, esto nos permite:
- Documentar los paquetes que usa nuestro proyecto.
- Especificar la versión del paquete específica que usará nuestro proyecto.
- Permite compartir nuestras dependencias con otros desarrolladores.
Los requisitos mínimos para crear un package.json deben ser como mínimo nombre (mínusculas y sin espacios) y versión.
Existen dos formas para iniciar un package.json:
1. Crear uno nuevo [ npm init ]
2. Cargar uno ya existente en caso que lo haya [ npm init --yes ]
Una vez definido el archivo package.json, podrás agregar en él las dependencias y agregar una lista de todo lo que necesites:
"dependencies": { "express": "*", "grunt": "*", "bower": "*" }
De este modo quedara:
Ahora procedemos a instalar los paquetes listados en package.json y sus dependencias
npm install
Se generara un directorio que contendra todos los modulos de las dependencias y paquetes "node_modules"
Tambien se puede instalar paquetes individualmente con el siguiente comando:
npm install –-save nombre_paquete_nuevo
De igual forma desisntalarlos y borrarlos del package.json:Si quieres instalar algo una versión especifica del paquete:npm uninstall –-save nombre_paquete
O en su defecto instalar directamente desde un repositorio en gitnpm install algunpaquete@1.1.0
npm install git://github.com/blured/mipaquete.git
Otra forma de instalar paquetes es haciéndolo de forma global. Ésta es
comúnmente usada para paquetes que proveen funcionalidad desde la línea
de comando como son grunt, bower, yeoman, entre otros.
Tomemos como ejemplo el paquete JSHint,
el cual es un analizador de código JavaScript que nos permite mostrar
puntos en el que tu código no cumpla unas determinadas reglas
establecidas de “código limpio“. Para instalar el mismo globalmente,
ejecutamos el comando install agregando el atributo –g y con privilegio root.
sudo npm install -g jshint
Para conocer la ruta donde se almacenan todas estas librerías con ámbito global, podemos hacer uso del comando prefix y del marcador global -g, de la siguiente manera:
NPM permite gestionar las dependencias de tus proyectos y las versiones que necesitas. Como es sabido, los proyectos de código abierto se mueven activamente y cambian frecuentemente de versión. El package.json puede ser configurado para controlar este tipo de cambios.sudo npm install -g jshint
Los números de versión normalmente contienen 3 elementos:
- Versión principal cuando rompe con funcionalidades anteriores, por ejemplo: 2.0.0
- Versión menor con nuevas características que no rompen las existentes, por ejemplo: 1.1.0
- Lanzamiento del parche con correcciones de errores y otros cambios menores, por ejemplo 1.0.1
Para ver todos los paquetes instalados localmente, utilice el comando ls y añada el atributo –l para una descripción breve. Para visualizar los paquetes instalados globalmente agregue el atributo –g.npm update --save
npm ls -l
Para chequear qué paquete puede ser actualizado local y globalmente, ejecute lo siguiente:
npm outdated
Para llevar localmente un paquete a una versión mayor a la actual, ejecute lo siguiente:npm outdated -g --depth=0
Para realizarlo globalmente, agregue el atributo -gnpm update