Header Ads Widget

Ticker

6/recent/ticker-posts

Tutorial de Node Package Manager

 tutorial de npm


Este tutorial de npm se centrará en Node Package Manager, o NPM, como se le conoce comúnmente. NPM tiene dos funciones principales. Es una herramienta de línea de comandos para ejecutar todo tipo de herramientas de desarrollo y scripts, además de un registro de bibliotecas de terceros. De hecho, en el último recuento, NPM tiene alrededor de 650.000 paquetes de software disponibles. Esto significa que para cualquier problema que esté intentando resolver con Node.js, es probable que ya haya creado un paquete gratuito que puede aprovechar en su propio proyecto. Por supuesto, puede encontrar NPM en https://www.npmjs.com . Además, si tiene una idea de software que le gustaría compartir con la comunidad, puede crear su propio paquete y compartirlo con el mundo. Aprendamos un poco más sobre NPM ahora.


¿Qué es un archivo package.json?

Antes de seguir adelante, querrá asegurarse de tener npm instalado en su sistema. Para verificar esto, puede escribir algo como npm -ven la línea de comando. Su versión puede ser diferente a la que ve aquí, pero siempre que haya un valor numérico, es probable que esté listo.
cómo comprobar la versión npm

Mientras lo hace, no está de más verificar también la versión del nodo instalado. Puede hacer esto con node -ven la línea de comando.
cómo comprobar la versión del nodo

Ahora queremos crear un nuevo directorio llamado npm-tutorialy luego podemos movernos a ese directorio como vemos aquí.
hacer directorio para contener el proyecto

Ahora estamos listos para crear un archivo package.json y aprender cómo funciona. Este es un archivo JSON que contiene la información básica sobre nuestro proyecto. Todas las aplicaciones de nodo tendrán este archivo package.json. Para crear su archivo package.json, siga adelante y ejecute npm init .
cómo ejecutar npm init

Cuando ejecutamos el comando npm-init, el programa nos guía a través de un proceso para completar los metadatos necesarios para crear el archivo package.json. Vemos un nombre de paquete, versión, descripción, punto de entrada, comando de prueba, repositorio de git, palabras clave, autor, licencia y una confirmación. Una vez que haya pasado por el proceso, tendrá un archivo package.json que podría verse así.

El punto principal aquí es que antes de que pueda agregar paquetes de nodos, debe crear un archivo package.json. Tomamos el camino largo anterior, pero si prefiere crear el archivo y aceptar todos los valores predeterminados de inmediato, puede escribir npm init --yesy el archivo se preparará para usted en un instante.


Cómo instalar un módulo de nodo

Bueno, tenemos nuestro archivo package.json en su lugar, sigamos adelante y agreguemos algunos paquetes de terceros al proyecto. Para comenzar, instalemos la biblioteca de JavaScript de subrayado . En primer lugar, puede consultar la información sobre el subrayado en su página npm . Muestra que para instalarlo, todo lo que tenemos que hacer es escribir npm i underscoreen nuestra terminal. Hagámoslo ahora.
instalar subrayado con npm

Fantástico. Podemos consultar el archivo package.json y se ha actualizado para reflejar que la biblioteca de subrayado ahora es una dependencia de nuestro proyecto.

Ahora, en segundo plano, npm hizo su trabajo y descargó todos los archivos para la biblioteca que instaló. También podemos ver esto en la carpeta node_modules. Ahora tiene una carpeta de subrayado que contiene los archivos que necesitamos para trabajar con subrayado js.
paquetes almacenados en node_modules

Es de destacar que dentro de la carpeta de subrayado, en realidad hay otro archivo package.json. De hecho, cada módulo de terceros que instale contendrá su propio archivo package.json, al igual que su propia aplicación principal tiene un archivo package.json.


Usando un módulo instalado

Instalamos el módulo de terceros, usémoslo ahora. Para hacerlo, todo lo que tenemos que hacer es incluirlo en nuestro proyecto. Cree un nuevo archivo index.js en la raíz de su proyecto y agregue este código.

La función require toma los siguientes pasos para incluir un paquete.

  • Verifique que sea un módulo principal, si es así, cárguelo.
  • Compruebe si se requiere un archivo o carpeta, si es así, cárguelo.
  • Compruebe si el módulo nombrado existe en node_modules, si es así, cárguelo.

Así es como npm resuelve un módulo para usted.

Así que necesitamos probar el subrayado para ver si funciona. En un tutorial anterior, aprendimos cómo funciona la función every () en el subrayado en el navegador. Ahora llevemos uno de esos ejemplos a Node.js. En nuestro archivo index.js:

Podemos ejecutar el programa para ver si funciona. En este caso, el subrayado verificará a todas las personas para ver si tienen bigote. No todas las personas tienen bigote en este ejemplo, por lo que debería mostrarse falso. Veamos.
subrayado en nodejs

¡Parece que está funcionando bien! Esto verifica que la biblioteca es, de hecho, parte de nuestro proyecto y podemos ver que está haciendo su trabajo como debería.


Los módulos pueden tener sus propias dependencias

Cuando se instala un módulo de terceros, ese paquete puede instalar su propio conjunto de dependencias durante la instalación. Veamos qué queremos decir con eso. Podemos instalar mongoose para nuestro proyecto escribiendo npm i mongoose .
npm instalar mangosta

La inspección de nuestro archivo package.json nos muestra la nueva entrada para mangosta como dependencia.

Ahora, enumeremos el contenido de node_modules para ver qué hay allí.
dependencias de mangosta
¡Guau! Hay muchas carpetas nuevas ahí. Todo lo que hicimos fue instalar el paquete mongoose, ¿qué pasó? Bueno, resulta que el paquete mongoose realmente necesita muchos otros paquetes de software para hacer su trabajo. Por lo tanto, cuando se instala mongoose, npm instala automáticamente todas las dependencias de ese paquete. Bastante dulce, ¿verdad? Sé que lo estropearías si tuvieras que instalar todas esas dependencias a mano. ¡Sé que lo haría!


Paquetes de NPM y control de código fuente

Si construye un proyecto hasta el punto en que lo va a compartir en Github o algún otro tipo de mecanismo de control de código fuente, nunca incluiría la carpeta node_modules. Esto se debe a que a medida que la aplicación crece, es posible que vea que la carpeta node_modules aumenta a cientos de megabytes de tamaño. Si tuviera que incluir esto en el control de código fuente, cada vez que otro desarrollador quisiera revisar su proyecto, estaría esperando en esa carpeta node_modules para descargar. No es una buena práctica. Sin embargo, esto no es un problema, porque el archivo package.json contiene todas las dependencias que necesita el proyecto. Entonces, si otro desarrollador revisa su código, todo lo que tiene que hacer es ejecutarnpm instally npm descargará e instalará cualquier número de dependencias necesarias directamente en node_modules en su máquina. Aquí hay un ejemplo de cómo excluir node_modules. Primero inicializamos un repositorio de git. Aprende Git )
git init

Luego, agregamos un archivo .gitignore y especificamos que no queremos incluir la carpeta node_modules.
agregar archivo gitignore

Ahora, cuando ejecutamos git statusnuevamente, la carpeta node_modules ya no se rastrea ni se confirma.
node_modules ahora se ignora

Podemos continuar y agregar los archivos y enviarlos también.

npm-tutorial $ git add.
npm-tutorial $ git commit -m "¡Primera confirmación!"
[master (root-commit) f65e415] ¡Primera confirmación!

 4 archivos modificados, 193 inserciones (+)
 modo de creación 100644 .gitignore
 modo de creación 100644 index.js
 modo de creación 100644 package-lock.json
 modo de creación 100644 package.json

SemVer (control de versiones semántico)

Veamos un poco más de cerca las versiones de nuestras dependencias de package.json.

  "dependencias": {
    "mangosta": "^ 5.1.1",
    "subrayado": "^ 1.9.0"
  }

Tenga en cuenta que tenemos instalados mangosta y subrayado. Cada una de las versiones comienza con un ^símbolo de intercalación o. ¿Qué significa esto? Bueno, en los paquetes de nodos hay tres componentes. Tiene el formato XYZ. La X representa la versión principal . La Y representa la versión Minor . Ellos Z representa el parcheversión. Esto es lo que se conoce como SemVer o Control de versiones semántico. Volviendo a ese carácter de intercalación. Esto indica que las dependencias deben usar esta versión principal. Entonces, en nuestro ejemplo anterior, cuando las dependencias están instaladas, queremos la versión más actualizada o mongoose siempre que sea parte de la 5 versión principal. De manera similar, nos interesa el subrayado que tiene 1 como versión principal. En otras palabras, las versiones principales deben ser 5 o 1, sin embargo, tomaremos versiones menores y de parche más nuevas si están disponibles. ¡Esto es importante! Obtenga más información aquí .


Listado de paquetes instalados

Para ver qué usa el proyecto como dependencias instaladas, simplemente podemos usar el comando list.
lista npm

Esto enumera todas las dependencias del proyecto, así como las dependencias de cada dependencia. Tal vez solo desee ver de qué depende su proyecto real, y no todo el árbol de dependencias. Para esto, simplemente use la bandera de profundidad establecida en 0.
profundidad de lista npm 0


Visualización de la información del registro de un paquete

Es posible que desee obtener más información sobre el paquete npm que está utilizando. Para hacerlo, puede visitar el sitio web de npm y leer sobre el paquete. Sin embargo, puede obtener mucha información útil sobre el paquete directamente en la terminal. Por ejemplo, escriba npm view mongooseen la terminal.
npm ver mangosta

¡Guauu! Esa es una gran cantidad de información. Podemos ver prácticamente todo lo que necesitamos saber sobre ese paquete. Aprendamos más sobre el subrayado también.
npm ver subrayado


Desinstalar un paquete

Por supuesto, habrá ocasiones en las que quizás desee eliminar un paquete de su aplicación. Sigamos adelante y eliminemos el subrayado de nuestro proyecto.
paquete de desinstalación npm

Con eso, el subrayado ahora se elimina de nuestro proyecto. Si inspeccionamos el archivo package.json una vez más, veremos que también se elimina del área de dependencias. En este punto, solo se instala mongoose como paquete de terceros.


Instalación de una versión específica de un paquete

También puede haber ocasiones en las que se necesite una versión específica de una biblioteca para garantizar que funcione en un proyecto determinado. Digamos que nuestro proyecto realmente necesitaba la versión 1.8.3 de subrayado en lugar de la versión 1.9.0. Podemos especificar qué versión instalar así.
npm instalar versión específica

Así, tienes la versión específica que necesitas.


Actualización de un paquete npm

En realidad, podría ser mejor si usa los paquetes más actualizados en su proyecto. Primero, debe verificar si hay algo desactualizado con el npm outdatedcomando. Con esto, npm puede determinar fácilmente si alguno de sus paquetes necesita ser actualizado.
npm desactualizado

Ahora podemos ejecutar npm updatepara actualizar el guión bajo una vez más.
actualización npm
Nota: ejecutar el npm updatecomando solo actualizará las versiones menores y de parche de cualquier cosa que se enumere en package.json. Las versiones principales no se actualizarán. Si necesita cambiar la versión principal, puede usar npm-check-updates .


¿Qué pasa con DevDependencies?

Hasta ahora hemos visto cómo hacer uso de las dependencias en nuestro proyecto. En otras palabras, nuestra aplicación necesitará estos paquetes para funcionar correctamente. Habrá ocasiones en las que solo necesitemos ciertos paquetes durante el desarrollo. Esto suele ocurrir cuando se realiza un desarrollo basado en pruebas o alguna aplicación de este tipo. Sigamos adelante e instalemos el paquete de prueba Mocha como una dependencia solo de desarrollo. Podemos hacerlo escribiendo npm i mocha --save-deven la línea de comando.
npm install dev dependency

Esto nos instala mocha y si inspeccionamos el archivo package.json, podemos ver que tenemos un nuevo paquete en la sección devDependencies .

Esto especifica que mocha debe incluirse al construir y probar la aplicación, pero que no debe incluirse en un entorno de producción.


hoja de trucos de npm

A continuación, se muestran algunos comandos para usar como referencia rápida.

  • npm i <packageName> Instalar un paquete
  • npm i <packageName> @ <version> Instalar una versión específica de un paquete
  • npm i <packageName> —save-dev Instalar un paquete como una dependencia de desarrollo
  • npm un <packageName> Desinstalar un paquete
  • npm list —depth = 0 Lista de paquetes instalados
  • npm desactualizado Ver paquetes desactualizados
  • npm update Paquetes de actualización
  • Para instalar / desinstalar paquetes globalmente, use - gflag.

Resumen del tutorial de Node Package Manager

En este tutorial de npm aprendimos que cada aplicación Node tiene un archivo package.json que incluye metadatos sobre el proyecto. El nombre de la aplicación, su versión, dependencias y otra información es parte de estos metadatos. Podemos hacer uso de NPM para descargar e instalar paquetes de terceros desde el registro de NPM. Cuando lo hagamos, estos paquetes instalados y sus dependencias se almacenarán en la carpeta node_modules . Los paquetes de nodo siguen la convención de versiones semánticas de major.minor.patch.

Publicar un comentario

0 Comentarios