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

Qué es NPN y como funciona

¿Qué es?

NPM (node package manager) es el gestor de paquetes javascript, es el manejador de paquetes por defecto de NodeJS por excelencia. Gracias a él, tenemos casi cualquier librería disponible a tan solo una linea de comando de distancia, permitiéndonos utilizarla en cuestión de segundos.

Desde la versión 0.6.3 de Node.js npm es instalado automáticamente con el entorno. npm se ejecuta desde la linea de comandos y maneja las dependencias para una aplicación. Escrito enteramente en JavaScript  permite a los usuarios instalar aplicaciones NodeJS que se encuentran en el repositorio.

En los ultimas años javascript ha tomado gran importancia, pasando de ser utilizado solamente para simples validaciones de formularios del lado del cliente, a ser el responsable de la puesta en marcha de servidores con NodeJS y demás.

¿Cómo funciona? 

Esta una herramienta de línea de comandos que permite gestionar todas las dependencias de una aplicación hecha en NodeJS.

Cuando usamos NodeJS rápidamente tenemos que instalar módulos nuevos (librerías) ya que Node al ser un sistema fuertemente modular viene prácticamente vacío. Así que para la mayoría de las operaciones deberemos instalar módulos adicionales. Esta operación se realiza de forma muy sencilla con la herramienta NPM.

Es un poco distinto a otros gestores de paquetes que podemos conocer, porque los instala localmente en los proyectos. Es decir, al descargarse un módulo, se agrega a un proyecto local, que es el que lo tendrá disponible para incluir. Aunque también existe la posibilidad de instalar los paquetes de manera global en nuestro sistema.