Taydash


Description

A collection of utility functions and types which have proved useful, and are lacking from other utility libraries. Strives to maintain functional programming best practises where possible.

Usage

``shell
npm i taydash
`

$3

Each exported function of this library is curried by default.

For convenience, each curried function will have a corresponding uncurried function, prefixed with _.

For example:

`typescript
const addOne = (num) => num + 1
const curried = mapLeafNodes(addOne)(1)
const uncurried = _mapLeafNodes(addOne, 1)
const sameResult = curried === uncurried
console.log(sameResult)
// true
`

Highlights

$3

- Iterates over a JSONValue (JSON style object, array, or primitive) and applies a passed function to each leaf node of the value.

`typescript
const addOne = (num) => num + 1
const result = mapLeafNodes(addOne)({ num: 0, arr: [1, 2, 3] })
console.log(result)
// { num: 1, arr: [ 2, 3, 4 ] }
`

$3

- Rounds a value to a specified number of decimal places, if the input is a number. Returns the value otherwise.
- decimalPlaces argument must be between 0 and 20, inclusive. If this constraint is violated, the function returns null.

`typescript
const numResult = roundIfNum(2)(1.459)
console.log(numResult)
// 1.46
const strResult = roundIfNum(2)('hello')
console.log(strResult)
// 'hello'
const nullResult = roundIfNum(-1)(1.459)
console.log(nullResult)
// null
``