Índice
Cuando desarrollas una librería en JavaScript, es común que quieras probar cómo se comporta en proyectos reales antes de publicarla. Esta práctica es esencial para asegurarte de que tu librería funcione correctamente en diferentes entornos y casos de uso. Sin embargo, realizar esta tarea puede ser un poco complicado si no se utilizan las herramientas adecuadas.
Aquí es donde pnpm, un gestor de paquetes rápido y eficiente para Node.js, se convierte en una opción muy valiosa. Con pnpm link, puedes conectar tu paquete local a tus proyectos de prueba de manera sencilla y efectiva. Esto te permite simular cómo tu librería se comportará cuando sea instalada desde un registro de paquetes, pero sin necesidad de publicarla cada vez que quieras hacer un cambio.
En este post, te guiaremos a través de los pasos necesarios para utilizar pnpm link para probar tu paquete local en proyectos reales. Aprenderás cómo configurar tu entorno, enlazar tu librería local y verificar su funcionamiento dentro de otros proyectos. Con esta técnica, podrás iterar rápidamente sobre tu código y asegurarte de que todo esté en orden antes de hacer una publicación oficial.
Global Link
Paso 1: «Publicar» el paquete en el entorno global
Dentro del directorio de tu librería ejecuta el siguiente comando
pnpm link --globalPaso 2: Agregar el paquete global al proyecto donde se probará
Dentro del directorio del proyecto donde vas a probar la librería ejecuta el siguiente comando:
pnpm link --global mi-libreriaRecuerda que «mi-libreria» es el valor de «name» que se encuentra en el package.json de tu librería.
Desenlazar librería global
Para desenlazar todos los proyectos de la librería «mi-libreria» ejecuta el siguiente comando:
pnpm remove --global mi-libreriaDesenlazar librería en proyecto específico
Si deseas desenlazar la librería en algún proyecto específico, sitúate en la carpeta del proyecto y ejecuta el siguiente comando:
# restaurar todo
pnpm i
# restaurar solo la librería enlazada
pnpm unlink mi-libreriaEnlazar por medio de path
Para enlazar por medio de directorio deberás ejecutar el siguiente comando en la carpeta del proyecto donde probarás la librería
Enlazar desde el directorio del proyecto
# cambiar al directorio del proyecto
cd ~/mis-proyectos/proyecto-prueba
# enlazar la librería por medio de path
pnpm link ~/path/de/mi-libreriaEnlazar desde el directorio de la librería
Si deseas enlazar la librería desde su directorio deberás ejecutar el siguiente comando:
pnpm link --dir ~/proyectos/mi-proyecto-pruebaCancelar enlace de path
Para desenlazar el proyecto ejecuta cualquiera de los siguientes comandos:
# por medio del path de la librería
pnpm unlink ~/path/de/mi-libreria# por medio del nombre de la librería
pnpm unlink mi-libreriaConclusión
Probar tu librería local en proyectos reales es una práctica fundamental para garantizar su calidad y funcionalidad. Utilizando pnpm link, puedes simplificar este proceso y asegurarte de que todo esté en orden antes de realizar una publicación oficial. Hemos visto cómo configurar y usar pnpm link para conectar tu paquete local a otros proyectos, permitiéndote iterar rápidamente sobre tu código.
Esperamos que esta guía te haya sido útil y que puedas aplicar estos pasos en tus propios proyectos. Si tienes alguna pregunta o comentario, no dudes en dejarlo en la sección de comentarios. ¡Buena suerte con el desarrollo de tu librería y felices pruebas!
