wrapper-path

wrapper-path

¿Que hace?

Este proyecto nace de la necesidad de poder hacer un "require" con una "ruta" mas comprensible.

Es un paquete, para poder realizar require de manera más práctica, sin tener que agregar . o ../ a las rutas de los módulos o paquetes que se desean incluir y que pueda hacer desde cualquier lugar del proyecto de la misma manera.

Tomando una ruta base '/' como se hace en los sistemas operativos. Esta puede ser la ruta al directorio del proyecto o a cualquier otro punto dentro del sistema desde donde se desee.

Uso

Instalación

Instalar utilizando npm:

yarn add wrapper-path
# npm i --save wrapper-path 

Configuración

Pensemos en la siguiente estructura de archivos:

/home
    /personal
        /proyecto
            app.js
            /carpeta1
                index.js
                module1.js
                /modulo2
                    index.js
                    script.js
            /carpeta2
                script.js

Path

constructor

Este metodo es el que se llama cuando se realiza el siguiente codigo:

const Path = require('wrapper-path');
let path = new Path(param);

Argumentos:

• param (String) required: ruta que queremos tener como base de nuestro proyecto,

Retorna:

(Path): Retorna la instancia de la clase Path.

get

Este metodo permite obtener la ruta completa a el archivo o directorio que solicitemos por parametro.

const Path = require('wrapper-path');
let path = new Path('/home/personal/proyecto');

path.get('/app.js'); // /home/personal/proyecto/app.js

Argumentos:

• param (String) required: ruta que queremos obtener.

Retorna:

(String): retorna la ruta completa.

require

Este metodo permite hacer el require como si fuera nativo pero tomando la ruta base con la cual instanciamos nuestro objeto path.

const Path = require('wrapper-path');
let path = new Path('/home/personal/proyecto');
let app = path.require('/app.js');
let carpeta1 = path.require('/carpeta1');

Argumentos:

• param (String) required: ruta que queremos hacer require.

Retorna:

(File/Folder): retorna la carga del archivo o carpeta.

recursive(files,folders)

Esta funcionalidad recursive, es para obtener un listado recursivamente de todos los archivos o carpetas de un directorio en especifico.

const Path = require('wrapper-path');
let path = new Path('/home/personal/proyecto');
let files = path.recursive.files(param, opts);
let folders = path.recursive.folders(param, opts);

Argumentos:

• param (String) required: ruta de la carpeta que queremos obtener los archivos o carpetas.
• opts (Object):
  • match (RegExp): expresión regular para determinar que rutas conservar
  • exclude (RegExp): expresión regular para determinar que rutas excluir del resultado

Retorna:

(Array): retorna un arreglo de con las rutas de los archivos o carpetas.

remove(file,files,folder,folders)

Esta funcionalidad remove, es para borrar un archivo, archivos de una carpeta, una carpeta, o las carpetas de una carpeta.

const Path = require('wrapper-path');
let path = new Path('/home/personal/proyecto');
path.remove.file(param);
path.remove.files(param, opts);
path.recursive.folder(param);
path.recursive.folders(param, opts);

Argumentos:

• param (String) required: ruta de la carpeta o archivo que queremos eliminar.
• opts (Object):
  • match (RegExp): expresión regular para determinar que rutas conservar
  • exclude (RegExp): expresión regular para determinar que rutas excluir del resultado

Retorna:

(Array): retorna un arreglo de con las rutas de los archivos o carpetas.

Pruebas funcionales (Unit Testing)

Se llebaron a cabo 12 pruebas funcionales las cuales evaluan todos los casos de exito y fallo de cada una de las funcionalidades antes nombradas, para ver el resultado:

$ yarn test-spec # yarn test

Pruebas de rendimiento (benchmark)

Con el objetivo de que sea optimo el código se realizaron 2 pruebas de rendimiento, de las cuales se determino que:

• utilizar *startsWith es mucho mas optimo que hacer un RegExp, cuando uno quiere validar si una cadena contiene un texto al inicio. Para correr la prueba:

  $ yarn benchmark benchmarck/regex-startsWith.js
  

• Utilizar slice o substr es muy similar en rendimiento. Para correr la prueba:

  $ yarn benchmark benchmarck/slice-substr.js