En el Manual de NodeJS estamos partiendo como base de las charlas #nodeIO ofrecidas por Alejandro Morales para DesarrolloWeb.com. En este caso todavía nos encontramos viendo contenido de nuestra primera charla, en la que nuestro ponente nos informa de una de las partes fundamentales en nuestros procesos de desarrollo en NodeJS, como son los módulos. Además, vimos el gestor de paquetes que viene en el framework.

En NodeJS el código se organiza por medio de módulos. Son como los paquetes o librerías de otros lenguajes como Java. Por su parte, NPM es el nombre del gestor de paquetes (package manager) que usamos en Node JS.

Si conoces los gestores de paquetes de Linux podrás hacerte una buena idea de lo que es npm, si no, pues simplemente entiéndelo como una forma de administrar módulos que deseas tener instalados, distribuir los paquetes y agregar dependencias a tus programas.

El gestor de paquetes npm, no obstante, es un poquito 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 cabe decir que también existe la posibilidad de instalar los paquetes de manera global en nuestro sistema.

Incluir módulos con "require"

Javascript nativo no da soporte a los módulos. Esto es algo que se ha agregado en NodeJS y se realiza con la sentencia require(), que está inspirada en la variante propuesta por CommonJS.

La instrucción require() recibe como parámetro el nombre del paquete que queremos incluir e inicia una búsqueda en el sistema de archivos, en la carpeta "node_modules" y sus hijos, que contienen todos los módulos que podrían ser requeridos.

Por ejemplo, si deseamos traernos la librería para hacer un servidor web, que escuche solicitudes http, haríamos lo siguiente:

var http = require("http");

Existen distintos módulos que están disponibles de manera predeterminada en cualquier proyecto NodeJS y que por tanto no necesitamos traernos previamente a local mediante el gestor de paquetes npm. Esos toman el nombre de "Módulos nativos" y ejemplos de ellos tenemos el propio "http", "fs" para el acceso al sistema de archivos, "net" que es un módulo para conexiones de red todavía de más bajo nivel que "http" (de hecho "http" está mayormente escrito sobre el módulo "net" github.com/joyent/node/blob/master/lib/http.js), "URL" que permite realizar operaciones sobre "url", el módulo "util" que es un conjunto de utilidades, "child_process" que te da herramientas para ejecutar sobre el sistema, "domain" que te permite manejar errores, etc.

Podemos crear fácilmente nuestros módulos exportando las funciones que deseemos

Por supuesto, nosotros también podemos escribir nuestros propios módulos y para ello usamos module.exports. Escribimos el código de nuestro módulo, con todas las funciones locales que queramos, luego hacemos un module.exports = {} y entre las llaves colocamos todo aquello que queramos exportar.

function suma(a,b){
   return a + b;
}

function multiplicar(a,b){
   return a * b;
}

module.exports = {
   suma: suma,
   multiplicar: multiplicar
}

Asumiendo que el archivo anterior se llame “operaciones.js”, nosotros podriamos requerirlo más tarde e otro archivo.js de la siguiente manera:

var operaciones = require('./operaciones');
operaciones.suma(2,3);

Obviamente, esto es solo una toma de contacto y volveremos sobre este asunto más adelante.

Comando npm para gestión de paquetes

Por lo que respecta al uso de npm, es un comando que funciona desde la línea de comandos de NodeJS. Por tanto lo tenemos que invocar con npm seguido de la operación que queramos realizar.

npm install async

Esto instalará el paquete async dentro de mi proyecto. Lo instalará dentro de la carpeta "node_modules" y a partir de ese momento estará disponible en mi proyecto y podré incluirlo por medio de "require":

require("async");

Otras instrucciones posibles de npm son la de publicar paquetes (con "publish"), instalar globalmente (poniendo el flag -g al hacer el "install"), desinstalar, incluso premiar (puntuar paquetes hechos por otras personas), etc.

Podemos ver paquetes a instalar entrando en la página del gestor de paquetes npm: npmjs.org

Por último, sobre npm se mencionó que cada paquete tiene entre su código un archivo package.json que contiene en notación JSON los datos del paquete en sí. Es como una tarjeta de identificación del paquete, que puede servir para informarte a ti mismo y a cualquier sistema informático de sus características. Si tú fueras el creador de un paquete, o crearas alguna aplicación con NodeJS, también deberías incluir "package.json" con los datos del módulo o aplicación que se está creando, como son el autor, versión, dependencias, etc.

En el siguiente artículo vamos a ver algo más específico, que también nos sirva como primer ejemplo para realizar en NodeJS. En concreto veremos el módulo HTTP, con el que podremos hacer un rudimentario servidor web.

Instalar paquetes de manera global con npm

Como se ha dicho antes, npm instala los paquetes para un proyecto en concreto, sin embargo existen muchos paquetes de Node que te facilitan tareas relacionadas con el sistema operativo. Estos paquetes, una vez instalados, se convierten en comandos disponibles en terminal, con los que se pueden hacer multitud de cosas. Existen cada vez más módulos de Node que nos ofrecen muchas utilidades para los desarrolladores, accesibles por línea de comandos, como Bower, Grunt, etc.

Las instrucciones para la instalación de paquetes de manera global son prácticamente las mismas que ya hemos pasado para la instalación de paquetes en proyectos. En este caso simplemente colocamos la opción "-g" que permite que ese comando se instale de manera global en tu sistema operativo.

npm install -g grunt-cli

Ese comando instala el módulo grunt-cli de manera global en tu sistema.