- 1. Preámbulo
- 2. Resumen del proyecto
- 3. Guía de instalación y uso
- 4. Test
- 5. Flujo de trabajo
- 6. Checklist
Markdown es un lenguaje de marcado ligero muy popular entre developers. Es usado en muchísimas plataformas que manejan texto plano (GitHub, foros, blogs, ...) y es muy común
encontrar varios archivos en ese formato en cualquier tipo de repositorio (empezando por el tradicional README.md
).
Estos archivos Markdown
normalmente contienen links (vínculos/ligas) que muchas veces están rotos o ya no son válidos y eso perjudica mucho el valor de
la información que se quiere compartir.
Es precisamente este problema lo que busca solucionar este proyecto, ya que se trata de una herramienta que lee y analiza archivos en formato Markdown
, para verificar los links que
contengan y reportar estadísticas.
Desarrollado en NodeJS y Javascript, este módulo es una biblioteca que se puede usar para recuperar todos los enlaces dentro de una ruta específica; permitiendo consultar el estado de todos los enlaces encontrados y enviar un resumen con las estadísticas encontradas en el análisis.
Puede utilizar esta biblioteca como aplicación CLI o como API.
Para utilizar la biblioteca como una API, siga estos pasos:
- Clonar este repositorio
- Abra su terminal y use el comando cd para ir a la carpeta donde desea guardar el proyecto.
- Ejecute el siguiente comando: git clone https://github.com/PaosLuna/DEV007-md-links.git
- Abra la carpeta en su software de edición de código.
- Abre la terminal y podrás comenzar a usar la API.
Deberás usar el siguiente comando en tu terminal:
node cli.js path [options]
path: es la ruta al archivo o directorio que deseas analizar. options: --validate, --stats o ambas.
Si se usa el siguiente comando: node cli.js path
Se mostrarán todos los enlaces que se encuentran en esa ruta.
Si la ruta no es válida o no se encuentra ningún archivo .md, aparecerá un error.
Si se usa el siguiente comando: node cli.js path --validate
Se mostrarán todos los enlaces encontrados y comprobará si son válidos o no enviando un mensaje de ok/fail de acuerdo al caso.
Si se usa el siguiente comando: node cli.js path --stats
Se mostrará un mensaje con el total de enlaces encontrados y cuantos de ellos son únicos.
Si se usa el siguiente comando: node cli.js path --validate --stats
Se mostrará un mensaje diciendo la cantidad total de enlaces encontrados, cuántos de ellos son únicos y cuántos están rotos.
Abre tu terminal y ejecuta el siguiente comando:
npm i md-links-paos-luna
Una vez completada la instalación, ejecute el siguiente comando en su terminal:
npx md-links-paos-luna path [options]
Si se usa el siguiente comando: npx md-links-paos-luna path
Se mostrarán todos los enlaces que se encuentran en esa ruta.
Si la ruta no es válida o no se encuentra ningún archivo .md, aparecerá un error.
Si se usa el siguiente comando: npx md-links-paos-luna path --validate
Se mostrarán todos los enlaces encontrados y comprobará si son válidos o no enviando un mensaje de ok/fail de acuerdo al caso.
Si se usa el siguiente comando: npx md-links-paos-luna path --stats
Se mostrará un mensaje con el total de enlaces encontrados y cuantos de ellos son únicos.
Si se usa el siguiente comando: npx md-links-paos-luna path --validate --stats
Se mostrará un mensaje diciendo la cantidad total de enlaces encontrados, cuántos de ellos son únicos y cuántos están rotos.
Las 23 pruebas unitarias se ejecutaron usando Jest.
El tiempo para desarrollar este proyecto fue de 3 strings, durante este tiempo la organización del proyecto se realizó en GitHub Projects.
- [👍] Puede instalarse via
npm install --global <github-user>/md-links
- [👍] Un board con el backlog para la implementación de la librería.
- [👍] Documentación técnica de la librería.
- [👍] Guía de uso e instalación de la librería
- [👍] El módulo exporta una función con la interfaz (API) esperada.
- [👍] Implementa soporte para archivo individual
- [👍] Implementa soporte para directorios
- [👍] Implementa
options.validate
- [👍] Expone ejecutable
md-links
en el path (configurado enpackage.json
) - [👍] Se ejecuta sin errores / output esperado
- [👍] Implementa
--validate
- [👍] Implementa
--stats
- [👍] Pruebas unitarias cubren un mínimo del 70% de statements, functions, lines, y branches.
- [👍] Pasa tests (y linters) (
npm test
).