NodeJS primer package.json

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:

1. Documentar los paquetes que usa nuestro proyecto.
2. Especificar la versión del paquete específica que usará nuestro proyecto.
3. 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:

npm uninstall –-save nombre_paquete

Si quieres instalar algo una versión especifica del paquete:

npm install algunpaquete@1.1.0

O en su defecto instalar directamente desde un repositorio en git

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:

sudo npm install -g jshint 

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.

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

Si no está seguro qué versión utilizar, agregue el comodín * y ejecute el comando npm update –save, el cual veremos más adelante en este tutorial.

npm update --save

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 ls -l

Para chequear qué paquete puede ser actualizado local y globalmente, ejecute lo siguiente:

npm outdated

npm outdated -g --depth=0

 Para llevar localmente un paquete a una versión mayor a la actual, ejecute lo siguiente:

npm update

 Para realizarlo globalmente, agregue el atributo -g