Dev

.babelrc

@@ -0,0 +1,9 @@
+{
+    "presets": [
+      ["@babel/env", {
+        "targets": {
+          "node": "current"
+        }
+      }]
+    ]
+  }

cli.js

@@ -0,0 +1,46 @@
+const process = require("process")
+const { mdLinks } = require("./index.js")
+const { countUniqueLinks } = require("./md_links")
+
+const [, , ...args] = process.argv
+// console.log([, , ...args])
+if (args.length === 0) {
+  console.error("Enter a path to be validated");
+}
+if (args.length === 1) {
+  mdLinks(args[0], { validate: false })
+    .then(response => console.log(response))
+    .catch(error => console.log(error));
+} else if (args.length === 2 && (args[1] === "--validate")) {
+  mdLinks(args[0], { validate: true })
+    .then(response => console.log(response))
+    .catch(error => console.log(error));
+} else if (args.length === 2 && (args[1] === "--stats")) {
+  mdLinks(args[0], { validate: false })
+    .then(arrayObjects => console.log(
+      "Total links: " + arrayObjects.length + "\n" +
+      "Unique links: " + countUniqueLinks(arrayObjects))
+    )
+    .catch(error => console.log(error));
+} else if (args.length === 3 && (args[1] === "--stats" && args[2] === "--validate")) {
+  mdLinks(args[0], { validate: true })
+    .then(arrayObjects => console.log(
+      "Total links: " + arrayObjects.length + "\n" +
+      "Unique: " + countUniqueLinks(arrayObjects) + "\n" +
+      "Broken: " + arrayObjects.filter(link => link.message === "Fail").length)
+    )
+    .catch(error => console.log(error));
+} else {
+  console.log("--Verify the parameters entered--" + "\n" +
+  "Ex: " + "\n" +
+  "--validate" + "\n" +
+  "--stats" + "\n" +
+  "--stats --validate");
+}
+// mdLinks(getPathFromArguments(arguments), getOptionsFromArguments(arguments))
+// .then(response => console.log(response))
+// .catch(error => console.log(error));
+
+module.exports = { mdLinks }
+
+

index.js

@@ -1,3 +1,42 @@
-module.exports = () => {
-  // ...
-};
+const { getLinksFromFileOrDirectoryPromise,
+  validateArrayLinks,
+  getAbsolutePath } = require("./md_links.js");
+
+const mdLinks = (entryPath, options) => {
+  return new Promise((resolve, reject) => {
+    if (options === undefined || options === null) {
+      console.log(
+        "---------------------------------------------------------------------------" + "\n" +
+        "  THE SOLVED PATH: " + getAbsolutePath(entryPath) + "\n" +
+        "---------------------------------------------------------------------------" + "\n" + "\n" +
+        "--------------------contains the following information --------------------" + "\n" + "\n")
+      getLinksFromFileOrDirectoryPromise(entryPath)
+        .then(res => resolve(res))
+        .catch(error => reject(error))
+    } else if (options.validate === false) {
+      console.log(
+        "---------------------------------------------------------------------------" + "\n" +
+        "  THE SOLVED PATH: " + getAbsolutePath(entryPath) + "\n" +
+        "---------------------------------------------------------------------------" + "\n" + "\n" +
+        "--------------------contains the following information --------------------" + "\n" + "\n")
+      getLinksFromFileOrDirectoryPromise(entryPath)
+        .then(res => resolve(res))
+        .catch(error => reject(error))
+    } else if (options.validate === true) {
+      console.log(
+        "---------------------------------------------------------------------------" + "\n" +
+        "  THE SOLVED PATH: " + getAbsolutePath(entryPath) + "\n" +
+        "---------------------------------------------------------------------------" + "\n" + "\n" +
+        "--------------------contains the following information --------------------" + "\n" + "\n")
+      getLinksFromFileOrDirectoryPromise(entryPath)
+        .then(links => validateArrayLinks(links))
+        .then(arrayObjects => resolve(arrayObjects))
+        .catch(error => reject(error))
+    } else {
+      resolve("WARNING! Please, enter the following options: " + "\n"+
+      "{validate: true} OR" + "\n" +
+      "{validate: false}")
+    }
+  })
+}
+module.exports = {mdLinks}

md_files/consideraciones.md

@@ -0,0 +1,30 @@
+## 4. Consideraciones generales
+
+* Este proyecto se debe "resolver" de manera individual.
+
+* La **librería** y el **script ejecutable** (herramienta de línea de comando -
+  CLI) deben estar implementados en JavaScript para ser ejecutados con
+  Node.js. **Está permitido usar librerías externas**.
+
+* Tu módulo **debe ser instalable** via `npm install <github-user>/md-links`. Este
+  módulo debe incluir tanto un _ejecutable_ que podamos invocar en la línea de
+  comando como una interfaz que podamos importar con `require` para usarlo
+  programáticamente.
+
+* Los **tests unitarios** deben cubrir un mínimo del 70% de _statements_,
+  _functions_, _lines_ y _branches_. Te recomendamos explorar [Jest](https://jestjs.io/)
+  para tus pruebas unitarias.
+
+* Para este proyecto **no está permitido** utilizar `async/await`.
+
+* Para este proyecto te sugerimos **no utilizar** la versión síncrona
+de la función para leer archivos, `readFileSync`, y en cambio intentar
+resolver este desafío de manera asíncrona.
+
+* Para este proyecto es **opcional** el uso de ES Modules `(import/export)`, en el
+  caso optes utilizarlo deberás de crear un script de `build` en el `package.json`
+  que los transforme en `requires` y `module.exports` con ayuda de **babel**.
+
+* Para disminuir la complejidad de tu algoritmo recursivo, te recomendamos
+utilizar la versión síncrona de la función para leer directorios, `readdirSync`.
+

md_files/criterios.txt

@@ -0,0 +1,12 @@
+## 5. Criterios de aceptación mínimos del proyecto
+
+Para comenzar este proyecto tendrás que hacer un **_fork_** y **_clonar_** este
+repositorio.
+
+Antes de comenzar a codear, es necesario crear un **plan de acción**. Esto debería
+quedar detallado en el `README.md` de tu repo y en una serie de **_issues_**
+y **_milestones_** para priorizar y organizar el trabajo, y para poder hacer
+seguimiento de tu progreso.
+
+Dentro de cada **_milestone_** se crearán y asignarán los **_issues_** que cada quien
+considere necesarios.

md_files/nodo_1/hoja_1/preambulo.md

@@ -0,0 +1,18 @@
+## 1. Preámbulo
+
+[Markdown](https://es.wikipedia.org/wiki/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.
+
+Dentro de una comunidad de código abierto, nos han propuesto crear una
+herramienta usando [Node.js](https://nodejs.org/), que lea y analice archivos
+en formato `Markdown`, para verificar los links que contengan y reportar
+algunas estadísticas.
+
+![md-links](https://user-images.githubusercontent.com/110297/42118443-b7a5f1f0-7bc8-11e8-96ad-9cc5593715a6.jpg)

md_files/nodo_1/resumen.md

@@ -0,0 +1,20 @@
+## 2. Resumen del proyecto
+
+En este proyecto crearás una herramienta de línea de comando (CLI) así como tu
+propia librería (o biblioteca - library) en JavaScript.
+
+En esta oportunidad nos alejamos un poco del navegador para construir un
+programa que se ejecute usando Node.js. Aprenderemos sobre procesos
+(`process.env`, `process.argv`, ...), cómo interactuar con el sistema archivos,
+cómo hacer consultas de red, etc.
+
+[Node.js](https://nodejs.org/es/) es un entorno de ejecución para JavaScript
+construido con el [motor de JavaScript V8 de Chrome](https://developers.google.com/v8/).
+Esto nos va a permitir ejecutar JavaScript en el entorno del sistema operativo,
+ya sea tu máquina o un servidor, lo cual nos abre las puertas para poder
+interactuar con el sistema en sí, archivos, redes, ...
+
+Diseñar tu propia librería es una experiencia fundamental para cualquier
+desarrollador porque que te obliga a pensar en la interfaz (API) de tus
+_módulos_ y cómo será usado por otros developers. Debes tener especial
+consideración en peculiaridades del lenguaje, convenciones y buenas prácticas.

md_files/nodo_2/modulos.txt

@@ -0,0 +1,12 @@
+ [ ] **Módulos de CommonJS**
+
+  <details><summary>Links</summary><p>
+
+  * [Modules: CommonJS modules - Node.js Docs](https://nodejs.org/docs/latest/api/modules.html)
+</p></details>
+
+- [ ] **Diferenciar entre expresiones (expressions) y sentencias (statements)**
+
+- [ ] **Callbacks**
+
+  <details><summary>Links</summary><p>

md_files/nodo_2/recursion.md

@@ -0,0 +1,11 @@
+- [ ] **Recursión o recursividad**
+
+  <details><summary>Links</summary><p>
+
+  * [Píldora recursión - YouTube Laboratoria Developers](https://www.youtube.com/watch?v=lPPgY3HLlhQ)
+  * [Recursión o Recursividad - Laboratoria Developers en Medium](https://medium.com/laboratoria-developers/recursi%C3%B3n-o-recursividad-ec8f1a359727)
+</p></details>
+
+* [Debería ser 404](https://reqres.in/api/users/23)
+* [Debería ser 404](https://reqres.in/api/users/23)
+* [Debería ser 404](https://reqres.in/api/users/23)

md_files/peticion.md

@@ -0,0 +1,9 @@
+- [ ] **Consulta o petición (request) y respuesta (response).**
+
+  <details><summary>Links</summary><p>
+
+  * [Generalidades del protocolo HTTP - MDN](https://developer.mozilla.org/es/docs/Web/HTTP/Overview)
+  * [Mensajes HTTP - MDN](https://developer.mozilla.org/es/docs/Web/HTTP/Messages)
+</p></details>
+
+* [Debería ser fallido](https://reqres.in/api/uses/23)