Publicar un paquete en NPM

Clase 16 de 18Curso de Gestión de Dependencias y Paquetes con NPM

Resumen

Antes de publicar un paquete en NPM debes asegurarte de cumplir con los siguientes requisitos:

  • Asegurar que el programa funcione reduciendo en lo posible los bugs
  • Revisar que la configuración del archivo package.json sea correcta
  • Tener un nombre único para el proyecto, usando guiones (-) para separar palabras y evitando números
  • Crear una cuenta en NPM, ya que aquí estarán tus paquetes a tu nombre. Después, debes utilizar el comando npm adduser para iniciar sesión en la terminal. Si no aparece tu contraseña, no te preocupes, es una forma de seguridad

Una vez hayas cumplido los requisitos, ejecuta el comando npm publish y si no existen errores, tu paquete será publicado. Puedes utilizar el comando npm whoami para visualizar el usuario en el que publicarás el paquete, esto es importante si tienes varias cuentas de NPM.

Si realizas cambios en tu código, deberás cambiar la versión de tu proyecto, puedes utilizar los siguientes comandos:

##Aumenta una version path (1.0.0) -> (1.0.1)
$ npm version patch 

##Aumenta una version minor (1.0.0) -> (1.1.0)
$ npm version minor

##Aumenta una version major (1.0.0) -> (2.0.0)
$ npm version major

##Aumenta una version específica (1.0.0) -> (3.1.1)
$ npm version <version>

Una vez actualizada la versión de tu proyecto, puedes ejecutar nuevamente el comando npm publish para actualizarlo en los repositorios de NPM.

Publicando el proyecto de mensajes aleatorios

Antes de publicar el proyecto de mensajes aleatorios, debemos asegurarnos de que el programa se ejecute bien en la terminal. Para esto, identifica el directorio en el que te encuentras, debe ser el mismo del proyecto con el comando pwd.

También debes ejecutar el comando sudo npm link que te permitirá hacer una referencia al paquete hacia el directorio global de NPM, similar a cómo se instalaría desde los servidores de NPM.

Otra forma es instalarlo de manera global, como cualquier otra dependencia, pero en lugar del nombre de la dependencia, estará la ruta del proyecto:

$ sudo npm install -g /users/tuUsuario/random-messages

De esta manera, ya puedes ejecutar el programa con el comando que creamos en "bin", random-msg y funcionará de forma global en el sistema.

Una vez revisado todo, ya puedes ingresar tu usuario con npm adduser y publicarlo con npm publish. En los paquetes de tu usuario de NPM aparecerá algo parecido a esto:

Proyecto publicado en NPM

Contribución creada con aportes de: Andrés Guano.