npm-marklink

MarkLink

Índice

• 1. Resumen del proyecto
• 2. Diagrama de Flujo
• 3. Instalación y guía de uso de la librería
• 4. Características técnicas
• 5. Autora

---

1. Resumen del proyecto

Este proyecto consta en la creación de una herramienta de línea de comando (CLI) así como una propia librería (o biblioteca - library) en JavaScript.

Diseñar una librería propia es una experiencia fundamental para cualquier desarrollador porque obliga a pensar en la interfaz (API) de módulos propios y cómo será usado por otros developers. Se tomó en cuenta especial consideración en peculiaridades del lenguaje, convenciones y buenas prácticas.

2. Diagrama de Flujo

3. Instalación y guía de uso de la librería

La libreria se instala mediante la siguiente vía:

npm install --marklink <DafneAquino>/md-links

Una vez que el usuario tenga instalada la librería marklink, va a tener las siguientes herramientas:

• En el terminal ingresamos el comando global md-link seguido de la dirección de la ubicación del archivo y/o carpeta de la cual queremos saber cuales son los links existentes en ese archivo y su texto descriptivo. Ejemplo:

• Si ingresamos el comando global md-link seguido de la dirección de la ubicación del archivo y seguido del comando --validate obtendremos las propiedades de los links que encontramos en ese archivo. Ejemplo:

• Si ingresamos el comando global md-link seguido de la dirección de la ubicación del archivo y seguido del comando --stats obtendremos la cantidad total de links que encontremos en ese archivo y el total de links unicos encontrados:

• Si ingresamos el comando global md-link seguido de la dirección de la ubicación del archivo y seguido de los comandos --stats --validate obtendremos la cantidad total de links que encontremos en ese archivo, el total de links unicos encontrados y el total de links rotos:

• Si ingresamos el comando global md-link seguido de la dirección de la ubicación del archivo y seguido del comando --help obtendremos un texto de ayuda como el siguiente:

4. Características técnicas

El proyecto se realizó bajo estas características técnicas de javascript y node:

JavaScript

• [x] Diferenciar entre tipos de datos primitivos y no primitivos

• [x] Arrays (arreglos)

  Links

  • Arreglos
  • Array - MDN
  • Array.prototype.sort() - MDN
  • Array.prototype.forEach() - MDN
  • Array.prototype.map() - MDN
  • Array.prototype.filter() - MDN
  • Array.prototype.reduce() - MDN

• [x] Objetos (key, value)

  Links

  • Objetos en JavaScript

• [x] Uso de condicionales (if-else, switch, operador ternario, lógica booleana)

  Links

  • Estructuras condicionales y repetitivas
  • Tomando decisiones en tu código — condicionales - MDN

• [x] Funciones (params, args, return)

  Links

  • Funciones (control de flujo)
  • Funciones clásicas
  • Arrow Functions
  • Funciones — bloques de código reutilizables - MDN

• [x] Recursión o recursividad

  Links

  • Píldora recursión - YouTube Laboratoria Developers
  • Recursión o Recursividad - Laboratoria Developers en Medium

• [x] Módulos de CommonJS

  Links

  • Modules: CommonJS modules - Node.js Docs

• [ ] Diferenciar entre expresiones (expressions) y sentencias (statements)

• [x] Callbacks

  Links

  • Función Callback - MDN

• [x] Promesas

  Links

  • Promise - MDN
  • How to Write a JavaScript Promise - freecodecamp (en inglés)

• [x] Pruebas unitarias (unit tests)

  Links

  • Empezando con Jest - Documentación oficial

• [x] Pruebas asíncronas

  Links

  • Tests de código asincrónico con Jest - Documentación oficial

• [x] Uso de mocks y espías

  Links

  • Manual Mocks con Jest - Documentación oficial

• [ ] Pruebas de compatibilidad en múltiples entornos de ejecución

• [x] Uso de linter (ESLINT)

• [x] Uso de identificadores descriptivos (Nomenclatura y Semántica)

Node.js

• [x] Instalar y usar módulos con npm

  Links

  • Sitio oficial de npm (en inglés)

• [x] Configuración de package.json

  Links

  • package.json - Documentación oficial (en inglés)

• [x] Configuración de npm-scripts

  Links

  • scripts - Documentación oficial (en inglés)

• [x] process (env, argv, stdin-stdout-stderr, exit-code)

  Links

  • Process - Documentación oficial (en inglés)

• [x] File system (fs, path)

  Links

  • File system - Documentación oficial (en inglés)
  • Path - Documentación oficial (en inglés)

Control de Versiones (Git y GitHub)

• [x] Git: Instalación y configuración

• [x] Git: Control de versiones con git (init, clone, add, commit, status, push, pull, remote)

• [x] Git: Integración de cambios entre ramas (branch, checkout, fetch, merge, reset, rebase, tag)

• [x] GitHub: Creación de cuenta y repos, configuración de llaves SSH

• [x] GitHub: Despliegue con GitHub Pages

  Links

  • Sitio oficial de GitHub Pages

• [ ] GitHub: Colaboración en Github (branches | forks | pull requests | code review | tags)

• [x] GitHub: Organización en Github (projects | issues | labels | milestones | releases)

HTTP

• [x] Consulta o petición (request) y respuesta (response).

  Links

  • Generalidades del protocolo HTTP - MDN
  • Mensajes HTTP - MDN

• [x] Codigos de status de HTTP

  Links

  • Códigos de estado de respuesta HTTP - MDN
  • The Complete Guide to Status Codes for Meaningful ReST APIs - dev.to

5. Autora

Dafne Aquino Manyari - LIM015 Laboratoria.