jofontea-md-links/docs/03-milestone.md

Librería para extraer enlaces de archivos Markdown y realizar diversas operaciones con estos

# **HITO 3:** Buscando dentro de un directorio

Para este hito vas a trabajar con la misma función `mdLinks` pero esta vez la
usuaria será capaz de pasar un directorio como ruta para el argumento `path`.

La función `mdLinks(path, validate)` debe recorrer todos los archivos
existentes en el directorio y por cada archivo `.md` que encuentre deberá
extraer los links para mostrarlos en pantalla.

Debes tener en cuenta que el directorio puede contener archivos con extensiones
que no sean `.md`. En este caso la función debe ignorarlos. Crea un
directorio con archivos de diferentes extensiones para probar tu función.

Ejemplo:

(resultados como comentarios)

```js
const mdLinks = require("md-links");


mdLinks("./some/dir")
  .then(links => {
    // => [{ href, text, file }, ...]
  })
  .catch(console.error);


mdLinks("./some/dir", true)
  .then(links => {
    // => [{ href, text, file, status, ok }, ...]
  })
  .catch(console.error);


mdLinks("./some/dir", false)
  .then(links => {
    // => [{ href, text, file }, ...]
  })
  .catch(console.error);

```

## Tareas de este hito

* Obtén el contenido de un directorio

  Este hito consiste en buscar archivos en un directorio. Para eso,
  hay que leer el directorio, en otras palabras ver que está dentro.

  El módulo de `fs` también te será útil aquí. Recomendamos `readdirSync`.

  Intenta imprimir en consola la lista de archivos en un directorio para probar
  como funciona.

* Une dos rutas

  Para poder acceder a directorios y archivos será necesario que indiques en qué
  lugar de tu computadora se encuentran, a esto le llamamos rutas.

  Usa el módulo path para unir dos segmentos de ruta a una ruta completa, por
  ejemplo, si queremos unir:

  `/home/Laboratoria/`

  `./test`

  El resultado sería: `/home/Laboratoria/test`

⚠️ **Test unitarios.** Te recomendamos antes de pasar al siguiente hito hacer
los tests del hito actual

[👈Todos los hitos](../README.md#6-hitos)