Espresso Labs ionic-general

Módulo com utilidades gerais para ser usado entre projetos

Instalação

npm i @espressolabs/ionic-general

E então faça a importaçao no seu app.module.ts

Utilitários

Existem diversos utilitários de programação que podem ser usados após a importação e declaração do provider na sua classe. A intenção é que essa lista cresça e abarque inclusive algumas funcionalidades de polyfill para simular novas funcionalidades do ECMAScript.

Para iniciar a utilização no seu projeto, importe o provider como no exemplo a seguir:

import { GeneralProvider } from "@espressolabs/general-provider";

const generalProvider = new GeneralProvider();

Criar hash

Para criar um novo hash baseado no sha256, o método é chamado de createHash, e pode ser usado como a seguir:

const hash = generalProvider.createHash([ENTROPIA OPCIONAL]);
console.log(hash);
// Imprime um hash de 32 caracteres

Este metódo cria sempre o memso hash caso seja passado o mesmo valor com entrada de entropia.

Criar hash aleatório

Para criar um novo hash aletória baseado no sha256, o método é chamado de createRandomHash, e pode ser usado como a seguir:

const randomHash = generalProvider.createRandomHash([ENTROPIA OPCIONAL]);
console.log(randomHash);
// Imprime um hash de 32 caracteres

Com este metódo, é adicionado um valor aleatório a entropia, de modo que a mesma entrada pode produzir valores completamente diferentes.

Ordenar arrays baseado em strings

Este metódo aceita como entrada um array qualquer e uma chave opcional presente em todos os objetos para usar em comparações. Caso não seja passada uma chave, espera-se que o array seja composto apenas de strings. Os possíveis casos de uso são como a seguir:

const flatArray = ["d", "a", "b"];
console.log(generalProvider.orderArrayStrings(flatArray));
// Imprime ["a", "b", "d"]

const objectArray = [{ name: "karl", age: 19 }, { name: "thiago", age: 43 }, { name: "melissa", age: 21 }];
console.log(generalProvider.orderArrayStrings(objectArray, "name")); 
// Imprime [{ name: "karl", age: 19 }, { name: "melissa", age: 21 }, { name: "thiago", age: 43 }]

Particionar array

O método a seguir particiona um array maior em arrays menores e retorna um novo conjunto destes arrays.

const array = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];

const arrayOfChunks = generalProvider.chunkArray(array, 4); // Divide o array em dois arrays com tamanho 4 e a parte final com tamanho 2

console.log(arrayOfChunks);
// Imprime [[1, 2, 3, 4], [5, 6, 7, 8], [9, 10]]

Com este metódo, é adicionado um valor aleatório a entropia, de modo que a mesma entrada pode produzir valores completamente diferentes.

Próximos passos

• [] Finalizar a documentação nas classes
• [] Atingir 100% em cobertura de testes
• [] Finalizar README.md com todos os utils

Licença

Este projeto só pode ser compartilhado entre projetos da Espresso Labs, de acordo com o código de conduta.

Espresso Labs 2019