Práctica Espree logging

Guía de uso

Para instalar el paquete, ejecute:

npm install @francisco-marques-armas/constant-folding

Para utilizar el ejecutable, escriba el siguiente comando:

npx funlog <fichero con la función>

Resumen de lo aprendido

Se han añadido opciones en la línea de comandos y mensajes en la entrada de funciones, anotando también el número de línea. Se cuenta con scripts en el package.json (test y cov) para poner a prueba el funcionamiento del programa y estos se ejecutan al realizar integración continua con Github Actions. El paquete ha sido publicado en npmjs con ámbito francisco-marques-armas. Se ha documentado y se ha probado que está accesible. Además, se realiza un estudio de cobertura y se ha aprendido el significado del versionado.

...

Indicar los valores de los argumentos

Se ha modificado el código de logging-espree.js para que el log también indique los valores de los argumentos que se pasaron a la función. Ejemplo:

function foo(a, b) {
  var x = 'blah';
  var y = (function (z) {
    return z+3;
  })(2);
}
foo(1, 'wut', 3);

function foo(a, b) {
    console.log(`Entering foo(${ a }, ${ b })`);
    var x = 'blah';
    var y = function (z) {
        console.log(`Entering <anonymous function>(${ z })`);
        return z + 3;
    }(2);
}
foo(1, 'wut', 3);

CLI con Commander.js

Se han añadido opciones -h y -V automáticamente con Commander, y una opción que permite especificar el fichero de salida.

La opción -h nos permite mostrar una descripción del programa y sus opciones por la terminal.

La opción -V muestra la versión del programa. En este caso es la versión 1.0.4, ya que se trata de la primera versión funcional, no han habido parches y se han arreglado cuatro fallos.

La opción -o vuelva la salida en el archivo que especifiquemos.

Reto 1: Soportar funciones flecha

Se ha añadido una condición a la entrada del traverse de espree para que también analice nodos ArrowFunctionExpression.

Reto 2: Añadir el número de línea

Se cuenta con una variable lineN, que obtiene la propiedad del número de línea de la localización de comienzo del nodo, y se añade al mensaje que se implementa en el código.

Tests and Covering

Se realiza un estudio de cobertura del programa, con el script cov. Se utiliza c8 en vez de nyc porque el segundo causa problemas.