codigos-utiles-ap | Mi primer módulo de Typescript subido a npm

Bienvenido! Este proyecto nació bajo el deseo de guardar y publicar en npm algunas de las funciones de JavaScript y Typescriot que ocasionalmente creo por necesidad en otros proyectos. La idea es ir agrandando este módulo cada vez más con el paso del tiempo, con el propósito de ayudarme tanto a mí como a otros programadores de ser posible.

Revisa la documentación regularmente aquí para chequear que utilizas la última versión.

Instalación y uso 🔧

• En la terminal, escribe

npm install codigos-utiles-ap

• Importa el módulo con el nombre que más te guste antes de utilizarlo, por ejemplo:

import codigosap from "codigos-utiles-ap"

Desde este momento, codigosap es un objeto que contiene como métodos a todas las funciones descritas en la sección Funciones.

Por ejemplo, si queremos obtener 3 elementos al azar del array [-50, 0, -3, "40", "josé", true, ["Kilo", 3]], simplemente escribimos:

const elementos = codigosap.obtenerNElementos([-50, 0, -3, "40", "josé", true, ["Kilo", 3]], 3)

Alternativamente puedes importar las funciones usando desestructuración:

import { obtenerNElementos } from "codigos-utiles-ap"

const elementos = obtenerNElementos([-50, 0, -3, "40", "josé", true, ["Kilo", 3]], 3)

• Si lo deseas, puedes instalar el módulo adhiriendo el siguiente link a tu archivo HTML:

<script src="https://cdn.jsdelivr.net/npm/codigos-utiles-ap/dist/index_CDN.min.js"></script>

Funciones 🤓

Aquí presento todas las funciones actuales del módulo, que pueden ser llamados tal como se describió anteriormente.

Consejo: En tu editor de código favorito pasa el mouse sobre ellas para obtener una breve explicación que te diga cómo deben ser usadas!

Funciones para obtener / modificar números

• probabilidadDeN(n) Recibe un número n entre 0 y 100. Devuelve true el n% de las veces.

• numeroAlAzar(num1, num2) Recibe dos números num1 y num2. Devuelve un número al azar entre ellos (no incluye al num2).

• numeroEnteroAlAzar(num1, num2 Recibe dos números enteros y devuelve un número entero al azar entre ellos.

• esDivisor(num1, num2) Recibe dos números. Si num2 es divisor de num1 entonces devuelve true (es decir, si num1/num2 tiene resto cero).

• divisores(num) Recibe un número entero y devuelve un array con todos sus divisores.

• factoresMasCercanos(n) Recibe un número natural n y devuelve un array con dos valores [a, b] tal que n=a*b, donde a y b son los valores más cercanos posibles.

• redondear(n) Recibe un número y lo devuelve redondeado a dos decimales.

• factorial(n) Recibe un número natural o cero. Devuelve el factorial de dicho número.

• esPar(n) Recibe un número. Devuelve true si es par, pero false si es imparr.

Funciones para obtener / modificar arrays

• elementoAlAzar(array) Recibe un array y retorna un elemento al azar.

• mezclarArray(array) Recibe un array y lo devuelve mezclado.

• obtenerNElementos(array, n) Recibe un array y un número natural n. Devuelve n elementos al azar del array.

• arange(origen, final, espaciado = 1) Recibe tres números. El tercero es opcional pero debe ser positivo. Devuelve un array de números equiespaciados desde el origen hasta el final (sin incluir) solicitado, considerando el espaciado especificado.

• linspace(origen, final, densidad) Recibe tres números. Los primeros dos deben ser distintos. El tercero debe ser positivo. Devuelve un array de números equiespaciados desde el origen hasta el final solicitado, considrando la densidad (cantidad) de valores especificados.

• ubicacionNElementosMasGrandes(array, n) Recibe un array de números y un número natural n. Devuelve un array de números enteros con las posiciones de los n elementos más grandes del array original, o más si hay un empate en los últimos puestos.

Funciones para obtener / modificar strings

• stringAleatorio(n) Recibe un número n natural, devuelve un string con carácteres aleatorios de longitud n.

• superTrim(string) Recibe un string, devuelve el mismo string sin espacios en blanco en ambos extremos y reemplaza todos los espacios consecutivos por uno solo.

Funciones para obtener / modificar objetos

• crearObjeto(claves, valores) Recibe dos arrays A y B, retorna un objeto cuyas claves son los elementos de A y los valores son los elementos de B.

Extras

• colorRandom() Retorna un color RGB al azar

• waitFor(time) Hace que tu código asincrónico espere un tiempo (en milisegundos) que le pases como parámetro antes de continuar la ejecución.

Estoy abierto a sugerencias!

Construido con 🛠️

• JavaScript
• Typescript
• NodeJs

Autor ✒️

• Alejandro Portaluppi - LinkedIn