NPM: Gestionar paquetes JavaScript

AMPLIAR

Al descargar el archivo de instalación, simplemente hacemos doble clic sobre él y seguimos las indicaciones del asistente de instalación de Node.js.

Una vez instalado para los usuarios de Windows, se podrá acceder a la consola de node.js desde la barra de inicio, como lo muestra la siguiente imagen:

AMPLIAR

Los usuarios de Mac deberán abrir el terminal de su sistema operativo como lo muestra la siguiente imagen:

AMPLIAR

Para comprobar que está instalado correctamente, ejecutamos el siguiente comando en nuestro terminal:

node

Presionamos Enter e ingresamos la siguiente línea:

Console.log(‘Node.js se instaló correctamente’);

Al presionar Enter, nos mostrará el mensaje “Node.js se instaló correctamente”. Para ver la lista de comandos permitidos por node.js, ingresamos el comando .help como se muestra en la siguiente imagen:

Para visualizar la versión NPM instalada, ejecutamos el siguiente comando:

npm -v

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

Uso de package.json

• Documentar qué paquetes usa nuestro proyecto.
• Especificar qué versión de paquete específica usará nuestro proyecto.
• Nos permite de manera fácil compartir nuestras dependencias con otros desarrolladores.

Requisitos:

Un archivo package.json debe tener como mínimo:

1. Nombre:

• Todo en minúscula.
• Una palabra sin espacio.
• Guión y guión bajo están permitidos.

2. Versión:

Ejemplo de una package.json:

{
  "Name": "paquete_proyecto",
  "Versión": "1.0.0"
}

1. Cargar un package.json predeterminado: Desde la consola ejecutamos la siguiente línea de comando.

npm init --yes

Para modificar esta configuración, simplemente abrimos el archivo creado con algún editor de texto y modificamos los atributos que deseamos.

2. Crear un package.json con el asistente: En la consola ejecutamos el siguiente comando.

npm init

Instalación de dependencias

"dependencies": {
  "express": "*",
  "grunt": "*",
  "bower": "*"
}

npm install

npm install –-save nombre_paquete_nuevo

npm uninstall –-save nombre_paquete

npm install git://github.com/blured/mipaquete.git

npm install algunpaquete@1.1.0

Es importante recalcar que este método de instalación local significa que sus archivos serán almacenados y estarán disponibles solo dentro del directorio de su proyecto.

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 (para usuarios Mac y Linux).

sudo npm install -g jshint

npm install -g jshint

Para confirmar su instalación, basta con ejecutar su comando para evaluar algún archivo JavaScript en busca de errores. Como nuestra instalación fue global, desde cualquier ubicación podremos ejecutar Jshint, indicando la ruta donde se encuentre nuestro archivo JavaScript. Ejemplo:

jshint proyecto\MiApp\www\js\index.js

Para conocer la carpeta en la que son guardadas todas estas librerías con ámbito global, podemos hacer uso del comando prefix y del marcador global -g, de la siguiente manera:

npm prefix -g

En el command prompt de Windows se muestra la ruta, teniendo como única variable, el nombre de la carpeta del usuario que hizo la instalación. En este caso sería “Zhock”:

En Windows, NodeJS no tiene definida como global la carpeta anterior para la inclusión de sus librerías mediante require. Por lo que si intentamos incluir una librería global, obtendremos el error “Error: Cannot find module”.

Para solucionarlo deberemos definir la variable del sistema NODE_PATH, dándole el valor de la ruta global de NPM y añadiéndole la carpeta \node_modules\ al final.

Como pudimos ver, en Windows 7 la ruta de instalación global de NPM es:

C:\Users\USER\AppData\Roaming\npm\

C:\Users\USER\AppData\Roaming\npm\node_modules\

%APPDATA%\npm\node_modules\

AMPLIAR

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

Definir versiones de los paquetes

"dependencias" :  { 
  "Package1" :  "1.0.0" ,	 // acepta solamente la versión 1.0.0 
  "envase2" :  "1.0.x" , 	// cualquier versión de revisión en la versión 1.0 
  "Package3" :  "*" ,	   // última versión, no se recomienda 
  "Package4" :  "> = 1.0.0" ,	    // cambios después 1.0.0 
  "package5" :  "<1.9.0" ,		 // nada menos que 1.9.0 
  "package6" :  " ~ 1.8.0 " ,    // abreviatura de> = 1.8.0 <1.9.0 
  " package7 " :  " ^ 1.1.0 " , // abreviatura de> = 1.1.0 <2.0.0 
  " package8 " :  " último " ,  // nombre de la etiqueta de versión más reciente 
  "package9" :  "" ,   // igual que * es decir, la última versión 
  "packageX" :  "<1.0.0 ||> = 2.3.1 <2.4.5 ||> = 2.5.2 <3.0.0 "   
}

Comando:

npm update --save

Actualizar paquetes

npm ls -l

npm outdated 
npm outdated -g --depth=0

npm update

Manejando Caché

Posix(Linux, Os X…):   ~/.npm  
Windows:   %AppData%/npm-cache

npm config get cache

npm cache clean