Programación funcional con JavaScript
Instalación paquete
npm i flight-extension
Documentación del API
Ejemplo
const cons first rest isEmpty isList = ; console; // ['1']console; // ['2', '1']console; // TRUEconsole; // falseconsole; // falseconsole; // trueconsole; // falseconsole; // [2]console; // []console; // []console; // 3 const foo = ;consoleconsole; // Debe imprimir [484]
Crear un nuevo proyecto usando esta librería
Crear un nuevo directorio para el proyecto. En este ejemplo usaremos fl-extended. Luego debemos inicializar el proyecto usando npm init y llenar los campos de manera adecuada según le pregunte la herramienta. Usar jest para las pruebas
mkdir fl-extendedcd fl-extendednpm init
Luego instalamos la librería functional-light y jest para la pruebas. Con los comando siguientes no solo se instalan las librerías, sino que además se incluyen las librerías en el archivo package.json
npm i functional-lightnpm i jest --save-devnpm i browserify --save-dev
Incluya los siguientes scripts en el archivo package.json
"scripts":"test": "jest""build": "browserify -r ./src/index.js:fl-extended -o ./dist/fl-extended.js"
El archivo package.json debería verse como esto:
"name": "fl-extended""version": "1.0.0""description": "Example project""main": "src/index.js""scripts":"test": "jest""build": "browserify -r ./src/index.js:fl-extended -o ./dist/fl-extended.js""author": "Andres M. Castillo""license": "MIT""dependencies":"functional-light": "^0.2.0""devDependencies":"browserify": "^16.5.0""jest": "^24.8.0"
Creamos la carpeta que contendrá el código fuente. Estos pasos se pueden hacer desde el IDE de desarrollo o desde el navegador de archivos. Aqui continuo en bash
mkdir src
Dentro de esta carpeta pondremos todo nuestro código fuente. Para este ejemplo supongamos que queremos extender nuestra librería functional-light para agregar la función map, que recibe un arreglo, un función f y retorna una nueva lista con los elementos de la lista original mapeados usando la función f. El siguiente código debe ir en src/index.js
const cons first rest isEmpty isList append length = ;/*** Apply a function f to each element of the array a* @param* @param* @example console.log(map([1,2,3], x => x*x)); // => [1, 4, 9]*/let {ifreturn ;elsereturn ;}// We export all the previous functions + our current implementation of mapmoduleexports = cons first rest isEmpty isList append length map
Compilar el paquete para el navegador
Ahora para obtener una librería que pueda ser usada en nuestro framework-canvas, debemos compilar el proyecto para obtener un archivo javascript para el navegador. Para esto, debemos compilar usando browserify
npm run build
Ahora tendremos nuestro archivo compilado en la carpeta dist. El archivo se llama fl-extended.js según especificamos en el package.json Ahora pueden copiar este archivo dentro de la carpeta web-lib de su proyecto HTML y deben importarlo usando una etiqueta de script. Algo como esto:
Crear una suite de pruebas usando JEST
Para crear las pruebas de las funciones vamos a utilizar el framework para pruebas JEST.
La pruebas se deben poner una carpeta con nombre tests. A continuación se muesta un ejemplo de suite de pruebas. deepEqual sirve para hacer pruebas sobre arreglos
const assert = ;const cons first rest isEmpty isList append length filter map = ;