cdanae-mdlinks v0.1.0
Markdown Links
Índice
1. Uso
El comando md-links te permite analizar archivos Markdown para extraer y mostrar información sobre los enlaces que contienen. A continuación se muestra la sintaxis general para ejecutar md-links:
md-links <path-to-file> [options]
<path-to-file>
: Ruta del archivo o directorio a analizar.[options]
: Opciones que se pueden incluir para obtener resultados específicos:--validate
: Realiza una validación de cada enlace encontrado, verificando su estado y mostrando si es válido o no.--stats
: Muestra estadísticas básicas sobre los enlaces encontrados, como el total de enlaces y los enlaces únicos.
Ejemplos de Uso:
Ejemplo 1: Analizar un archivo Markdown sin validación de enlaces:
md-links archivo.md
Este comando analizará el archivo archivo.md en busca de enlaces y mostrará información detallada sobre cada enlace encontrado, incluyendo la URL y el texto de anclaje.
Ejemplo 2: Analizar un archivo Markdown con validación de enlaces:
md-links archivo.md --validate
Al agregar la opción --validate, md-links realizará una validación de cada enlace encontrado. Mostrará información adicional sobre cada enlace, incluyendo el estado de validez, indicando si el enlace es válido o no.
Ejemplo 3: Mostrar estadísticas de los enlaces encontrados en un archivo Markdown:
md-links archivo.md --stats
La opción --stats generará estadísticas básicas sobre los enlaces encontrados en el archivo archivo.md. Mostrará el total de enlaces y los enlaces únicos.
Ejemplo 4: Combinar opciones para validar y mostrar estadísticas de los enlaces:
md-links archivo.md --validate --stats
Al combinar las opciones --validate y --stats, md-links realizará una validación de los enlaces y, además, proporcionará estadísticas sobre los enlaces encontrados en el archivo archivo.md.
2. Estructura
El proyecto está estructurado de la siguiente manera:
DEV011-MD-LINKS/
├─── package.json
├─── package-lock.json
├─── README.md
├─── .gitignore
├─── src/
│ ├─── cli.js
│ ├─── functions.js
│ ├─── md-links.js
├─── test/
│ ├─── functions.spec.js
│ └─── md-links.spec.js
├─── testFiles/
│ ├─── archivo-2links.md
│ ├─── archivo-3links1error.md
│ ├─── archivo-noLinks.md
│ └─── prueba-txt.txt
3. Archivos principales
cli.js
: archivo de entrada de la aplicación. Se encarga de tomar argumentos de la línea de comandos y gestionar las opciones proporcionadas por el usuario.functions.js
: contiene las funciones principales utilizadas para realizar diferentes tareas en la aplicación, como la verificación de la existencia de archivos, la lectura de contenido de archivos, la extracción de enlaces y la validación de enlaces.md-links.js
: Orquesta la funcionalidad principal de la herramienta md-links, utilizando las funciones definidas en functions.js para realizar el análisis de enlaces en archivos Markdown.
4. Pruebas
Se han incluido pruebas para garantizar la funcionalidad correcta de la herramienta. Están ubicadas en la carpeta test y se utilizan para verificar las funciones implementadas en functions.js y md-links.js.
Se usa Jest para ejecutar las pruebas y mostrará un informe de cobertura del código con el siguiente comando:
npm test
5. Dependencias
- axios: para realizar peticiones HTTP para validar enlaces.
- jsdom: para manipulación del DOM para extraer enlaces de archivos Markdown.
- marked: para analizar archivos Markdown y convertirlos a HTML.
5 months ago