Instalación desde GitHub con npm y tags específicos

Clase 22 de 28Curso para Certificacion de Node.js con OpenJS Foundation 2023

Resumen

Domina la instalación de dependencias en Node.js con confianza: aprende a usar npm install y semantic versioning (semver) para apuntar a repositorios de GitHub y tags específicos. Aquí verás cómo resolver un ejercicio real centrado en package.json, con pasos claros y código puntual.

¿Qué evalúa el dominio de package.json y por qué importa?

Este dominio pesa 6 % del examen y se enfoca en el manejo e instalación de dependencias en un proyecto de Node. El reto principal (task 12.1 / 12.x) exige modificar package.json para depender de un módulo desde su repositorio de Git y no desde el registry de npm, respetando una versión específica mediante tag.

Las claves son dos: comprender a fondo semver y dominar las opciones de npm install. La documentación relevante es: npm install y semantic versioning (semver). Saber interpretarlas te permite instalar desde fuentes como tarball, GitHub y más, no solo desde el registry.

¿Cómo instalar un módulo desde GitHub con npm usando una versión tagueada?

La tarea pide agregar una dependencia al módulo Colored, pero desde su repositorio de GitHub usando el tag 1.4.0. Además, se debe asegurar que el paquete quede instalado en la carpeta node_modules y luego requerirlo en el archivo answer.js.

  • Edita package.json o instala directamente para que se actualice automáticamente.
  • Usa npm install apuntando al repositorio de GitHub con usuario/repositorio.
  • Agrega el tag con el símbolo numeral (#) para fijar la versión 1.4.0.
  • Verifica que la dependencia aparezca en package.json y que exista en node_modules.
  • En answer.js, haz el require del módulo y no realices más acciones.
  • Ten presente: instalar desde GitHub puede tardar más que desde el registry de npm.

¿Cuál es el comando clave de npm install?

Puedes instalar con la forma corta de GitHub o con la URL remota. La variante simple ilustra mejor la instrucción del ejercicio:

npm install usuario/repositorio#1.4.0
  • El formato usuario/repositorio apunta al repositorio en GitHub.
  • El #1.4.0 fija el tag exacto. También puede apuntar a un branch si fuera necesario.

Otra opción mencionada es la forma con URL remota de git:

npm install git+https://ruta-al-repositorio.git#1.4.0

¿Cómo reflejar el cambio en package.json y requerir el módulo?

Tras instalar, el cambio queda reflejado en la sección de dependencias de package.json y el paquete aparece en node_modules. Para finalizar, en answer.js basta con requerir el módulo:

const colored = require('colored');

¿Qué conceptos, habilidades y keywords debes dominar?

Para resolver correctamente este dominio, asegúrate de comprender estos puntos:

  • package.json: archivo que define dependencias del proyecto.
  • Manejo de dependencias: instalación, actualización y fuentes alternativas.
  • npm install: comando central; múltiples opciones y orígenes de instalación.
  • semantic versioning (semver): base de cómo se resuelven versiones en Node.js.
  • Instalación desde GitHub: uso de usuario/repositorio y #tag o branch.
  • Tag 1.4.0: versión específica solicitada para el módulo Colored.
  • Registry vs repositorio git: diferencia entre instalar desde npm y desde GitHub.
  • tarball: otro origen posible según la documentación de npm install.
  • node_modules: carpeta donde debe quedar instalado el paquete antes de responder.
  • README: fuente de requisitos del ejercicio y estructura del proyecto.
  • answer.js: archivo donde solo se pide el require del módulo.
  • colored: nombre del módulo requerido por el ejercicio.

¿Tienes dudas puntuales sobre npm install o semver? Cuéntame tu caso en los comentarios y lo resolvemos juntos.

      Instalación desde GitHub con npm y tags específicos