JS: Configuración del entorno

Teoría: Instalación global de paquetes

Cuando pensamos en Node.js, muchas veces lo asociamos solamente con código JavaScript. Pero en realidad, hay paquetes que son verdaderas utilidades o herramientas que podemos usar directamente desde la terminal, sin necesidad de escribir una sola línea de JavaScript. Una de esas herramientas es cloc. Vamos a ver juntos cómo instalarla y usarla fácilmente.

¿Qué es cloc?

cloc es una herramienta que sirve para contar líneas de código en diferentes lenguajes de programación.

Es muy útil cuando queremos saber cuánto código tenemos en un proyecto, o cómo está distribuido entre archivos de distintos tipos (por ejemplo, archivos .js, .html, .md, .css, etc.).

Ejemplo práctico: Si tienes una carpeta con varios archivos de tu sitio web, code>cloc puede decirte cuántas líneas de código hay en total y en qué tipo de archivos están.

¿Cómo se instala una herramienta como cloc?

Algunas herramientas como cloc no necesitan que tengas un proyecto Node específico. Puedes instalarlas globalmente para poder usarlas desde cualquier parte de tu sistema, sin importar en qué carpeta estés.

Instalación global con npm

Para instalar cloc a nivel global, usamos el siguiente comando en la terminal:

npm install -g cloc

La bandera -g significa que queremos instalar el paquete de forma global, es decir, que estará disponible en todo el sistema, no solo en un proyecto.

💡 En algunos sistemas (especialmente en Linux o macOS), podrías necesitar permisos de administrador.

En ese caso, anteponemos sudo al comando:

sudo npm install -g cloc

¿Dónde se instalan los paquetes globales?

Cuando instalamos un paquete con -g, npm lo guarda en una carpeta especial que no siempre es fácil de encontrar a simple vista. Si quieres ver exactamente dónde están instalados tus paquetes globales, puedes usar el siguiente comando:

npm config ls -l

Este comando muestra toda la configuración de npm. Fíjate en una línea como esta:

prefix = "/Users/tu_usuario/.asdf/installs/nodejs/14.5.0/.npm"

Ese es el directorio donde npm guarda los paquetes que se instalan de forma global.

💡 En sistemas diferentes, la ruta puede cambiar, pero el principio es el mismo en todos.

¿Cómo se usa cloc?

Una vez instalado, puedes ejecutar cloc desde cualquier carpeta. Lo más básico es analizar todas las líneas de código del directorio actual (el punto . representa la carpeta en la que estás):

cloc .

Ejemplo de salida

Supongamos que ejecutamos ese comando dentro de una carpeta de proyecto. El resultado podría verse así:

49 text files.
41 unique files.
11 files ignored.
Language files blank comment code
-------------------------------------------------------------------------------
Markdown 19 213 0 523
YAML 21 35 0 471
CSS 1 0 0 3
-------------------------------------------------------------------------------
SUM: 41 248 0 997
-------------------------------------------------------------------------------

¿Cómo interpretamos estos datos?

ClaveDescripción
LanguageTipo de archivo (por su lenguaje o extensión).
filesNúmero de archivos de ese tipo.
blankLíneas en blanco.
commentLíneas que son solo comentarios.
codeLíneas de código "reales", sin contar espacios ni comentarios.

Entonces, en el ejemplo:

  • Hay 523 líneas de contenido en archivos Markdown (.md).

  • 471 líneas vienen de archivos YAML (usados comúnmente en configuraciones).

  • Y también vemos un archivo CSS con 3 líneas de código.

Usos prácticos

  • Si trabajas con varios lenguajes, te ayuda a ver cuál ocupa más espacio en tu proyecto.

  • Puedes usar cloc en proyectos personales o profesionales para hacer reportes de avance.

  • Te permite identificar fácilmente archivos innecesarios o con poco contenido.

Resumen

  • Algunos paquetes de Node.js, como cloc, son herramientas de línea de comandos, no solo bibliotecas de código.
  • Puedes instalarlos globalmente con:npm install -g <paquete>, en este caso:npm install -g cloc
  • Si tu sistema lo requiere, usa sudo al instalar.
  • Para saber dónde se instalan los paquetes globales, ejecuta:npm config ls -l
  • Una vez instalado, puedes usar cloc desde cualquier carpeta para contar líneas de código usando:cloc .
NavegaciónTeoría

Completado

0 / 11