Update format

This commit is contained in:
Andros Fenollosa 2022-02-05 18:14:35 +01:00
parent 22b2fc9a65
commit 9e6549b153
5 changed files with 260 additions and 181 deletions

7
Makefile Normal file
View File

@ -0,0 +1,7 @@
.DEFAULT_GOAL := help
help:
@perl -nle'print $& if m{^[a-zA-Z_-]+:.*?## .*$$}' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-25s\033[0m %s\n", $$1, $$2}'
build: ## Build in 'dist'
tsc src/fnTools.ts -t es2017 --module amd -outFile dist/fnTools.js

View File

@ -1,6 +1,31 @@
# fnTools
# Compile
Simple functional functions common to any development in Typescript or JavaScript.
- **inc**: Increase the value of a `number`.
- **dec**: Decrease the value of a `number`.
- **range**: Returns an array with a sequence.
- **uniqValuesArray**: Creates a duplicate-free version of an array.
- **cloneJSON**: Clone JSON.
- **updateJSON**: Returns a JSON with an updated value.
## Example
```typescript
```
## Compile
Install Typescript
```shell
tsc fn-tools.ts -t es2017 -outFile dist/fn-tools.js
````
npm install -g typescript
```
And build.
```shell
make build
````
Check 'dist' folder.

105
dist/fn-tools.js vendored
View File

@ -1,105 +0,0 @@
/**
* Returns a JSON with an updated value
* @param {string} key
* @param {string} newValue
* @param {JSON} json
* @return {JSON}
* @example
*
* const person = {name: 'James', age: 20, pets: ['dog', 'cat']};
* updateJSON('name', 'maria', person);
* // {"age": 20, "name": "maria", "pets": ["dog", "cat"]}
*
* Others: "modify" in Ramda
*/
function updateJSON(key, newValue, json) {
// JSON to Array
return Object.entries(json).map(function (row) {
// Replace value
return row[0] == key ? row.slice(0, 1).concat(newValue) : row;
}).reduce(function (jsonUpdate, valueUpdate) {
// Array to JSON
jsonUpdate[valueUpdate[0]] = valueUpdate[1];
return jsonUpdate;
}, {});
}
/**
* Returns an array with a sequence.
*
* @param {number} start - Beginning of the range.
* @param {number} stop - End of range.
* @param {number} step - Interval between numbers. Default is 1.
* @return {Array} Sequence.
* @example
*
* range(4)
* // => [0, 1, 2, 3, 4]
*
* range(2, 4)
* // => [2, 3, 4]
*
* range(0, 9, 3)
* // => [0, 3, 6, 9]
*/
function range(start, stop = null, step = 1) {
const startArray = stop === null ? 0 : start;
const stopArray = stop === null ? start : stop;
return Array.from({ length: (stopArray - startArray) / step + 1 }, (_, i) => startArray + (i * step));
}
/**
* Creates a duplicate-free version of an array.
*
* @param {Array} array - The array to inspect.
* @return {Array} - Returns the new duplicate free array.
* @example
*
* uniqValuesArray([2, 1, 2, 2])
* // => [2, 1]
*/
function uniqValuesArray(array) {
return Array.from(new Set(array));
}
/**
* Increase the value of a `number`.
*
* @param {number} number The number to increase.
* @param {number} number Increase.
* @return {number} Returns the decrease.
* @example
*
* inc(4)
* // => 5
*
* inc(5, 3)
* // => 8
*
* dec(7.3)
* // => 8.3
*
*/
function inc(number, increase = 1) {
return number + increase;
}
/**
* Decrease the value of a `number`.
*
* @param {number} number - The number to decrease.
* @param {number} number - Decrease.
* @return {number} Returns the decrease.
* @example
*
* dec(4)
* // => 3
*
* dec(5, 3)
* // => 2
*
* dec(7.3)
* // => 6.3
*
* dec("foo")
* // => false
*/
function dec(number, decrease = 1) {
return number - decrease;
}

133
dist/fnTools.js vendored Normal file
View File

@ -0,0 +1,133 @@
define("fnTools", ["require", "exports"], function (require, exports) {
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.cloneJSON = exports.uniqValuesArray = exports.updateJSON = exports.range = exports.dec = exports.inc = void 0;
/**
* Increase the value of a `number`.
*
* @param {number} number The number to increase.
* @param {number} number Increase.
* @return {number} Returns the decrease.
* @example
*
* inc(4)
* // => 5
*
* inc(5, 3)
* // => 8
*
* dec(7.3)
* // => 8.3
*
*/
function inc(number, increase = 1) {
return number + increase;
}
exports.inc = inc;
/**
* Decrease the value of a `number`.
*
* @param {number} number - The number to decrease.
* @param {number} number - Decrease.
* @return {number} Returns the decrease.
* @example
*
* dec(4)
* // => 3
*
* dec(5, 3)
* // => 2
*
* dec(7.3)
* // => 6.3
*
* dec("foo")
* // => false
*/
function dec(number, decrease = 1) {
return number - decrease;
}
exports.dec = dec;
/**
* Returns an array with a sequence.
*
* @param {number} start - Beginning of the range.
* @param {number} stop - End of range.
* @param {number} step - Interval between numbers. Default is 1.
* @return {Array} Sequence.
* @example
*
* range(4)
* // => [0, 1, 2, 3, 4]
*
* range(2, 4)
* // => [2, 3, 4]
*
* range(0, 9, 3)
* // => [0, 3, 6, 9]
*/
function range(start, stop = null, step = 1) {
const startArray = stop === null ? 0 : start;
const stopArray = stop === null ? start : stop;
return Array.from({ length: (stopArray - startArray) / step + 1 }, (_, i) => startArray + (i * step));
}
exports.range = range;
/**
* Returns a JSON with an updated value
* @param {string} key
* @param {string} newValue
* @param {JSON} json
* @return {JSON}
* @example
*
* const person = {name: 'James', age: 20, pets: ['dog', 'cat']};
* updateJSON('name', 'maria', person);
* // {"age": 20, "name": "maria", "pets": ["dog", "cat"]}
*
* Others: "modify" in Ramda
*/
function updateJSON(key, newValue, json) {
// JSON to Array
return Object.entries(json).map(function (row) {
// Replace value
return row[0] == key ? row.slice(0, 1).concat(newValue) : row;
}).reduce(function (jsonUpdate, valueUpdate) {
// Array to JSON
jsonUpdate[valueUpdate[0]] = valueUpdate[1];
return jsonUpdate;
}, {});
}
exports.updateJSON = updateJSON;
/**
* Creates a duplicate-free version of an array.
*
* @param {Array} array - The array to inspect.
* @return {Array} - Returns the new duplicate free array.
* @example
*
* uniqValuesArray([2, 1, 2, 2])
* // => [2, 1]
*/
function uniqValuesArray(array) {
return Array.from(new Set(array));
}
exports.uniqValuesArray = uniqValuesArray;
/**
* Clone JSON.
*
* @param {JSON} json - Object. Default {}.
* @return {JSON} New object.
* @example
*
* cloneObject({"edad": 23})
* // => {"edad": 23}
*
* cloneObject()
* // => {}
*
*/
function cloneJSON(json) {
return JSON.parse(JSON.stringify(json));
}
exports.cloneJSON = cloneJSON;
});

View File

@ -1,73 +1,3 @@
/**
* Returns a JSON with an updated value
* @param {string} key
* @param {string} newValue
* @param {JSON} json
* @return {JSON}
* @example
*
* const person = {name: 'James', age: 20, pets: ['dog', 'cat']};
* updateJSON('name', 'maria', person);
* // {"age": 20, "name": "maria", "pets": ["dog", "cat"]}
*
* Others: "modify" in Ramda
*/
function updateJSON(key: string, newValue: any, json: JSON): JSON {
// JSON to Array
return Object.entries(json).map(
function (row: any[]): any[] {
// Replace value
return row[0] == key ? row.slice(0, 1).concat(newValue) : row
}
).reduce(
function (jsonUpdate: any, valueUpdate: any): JSON {
// Array to JSON
jsonUpdate[valueUpdate[0]] = valueUpdate[1];
return jsonUpdate;
}, {});
}
/**
* Returns an array with a sequence.
*
* @param {number} start - Beginning of the range.
* @param {number} stop - End of range.
* @param {number} step - Interval between numbers. Default is 1.
* @return {Array} Sequence.
* @example
*
* range(4)
* // => [0, 1, 2, 3, 4]
*
* range(2, 4)
* // => [2, 3, 4]
*
* range(0, 9, 3)
* // => [0, 3, 6, 9]
*/
function range(start: number, stop: number | null=null, step: number=1): number[] {
const startArray = stop === null ? 0 : start;
const stopArray = stop === null ? start : stop;
return Array.from({ length: (stopArray - startArray) / step + 1}, (_, i) => startArray + (i * step));
}
/**
* Creates a duplicate-free version of an array.
*
* @param {Array} array - The array to inspect.
* @return {Array} - Returns the new duplicate free array.
* @example
*
* uniqValuesArray([2, 1, 2, 2])
* // => [2, 1]
*/
function uniqValuesArray(array: any[]): any[] {
return Array.from(new Set(array));
}
/**
* Increase the value of a `number`.
*
@ -82,11 +12,11 @@ function uniqValuesArray(array: any[]): any[] {
* inc(5, 3)
* // => 8
*
* dec(7.3)
* inc(7.3)
* // => 8.3
*
*/
function inc(number: number, increase: number=1): number {
export function inc(number: number, increase: number=1): number {
return number + increase;
}
@ -111,6 +41,95 @@ function inc(number: number, increase: number=1): number {
* dec("foo")
* // => false
*/
function dec(number: number, decrease: number=1): number {
export function dec(number: number, decrease: number=1): number {
return number - decrease;
}
/**
* Returns an array with a sequence.
*
* @param {number} start - Beginning of the range.
* @param {number} stop - End of range.
* @param {number} step - Interval between numbers. Default is 1.
* @return {Array} Sequence.
* @example
*
* range(4)
* // => [0, 1, 2, 3, 4]
*
* range(2, 4)
* // => [2, 3, 4]
*
* range(0, 9, 3)
* // => [0, 3, 6, 9]
*/
export function range(start: number, stop: number | null=null, step: number=1): number[] {
const startArray = stop === null ? 0 : start;
const stopArray = stop === null ? start : stop;
return Array.from({ length: (stopArray - startArray) / step + 1}, (_, i) => startArray + (i * step));
}
/**
* Returns a JSON with an updated value
* @param {string} key
* @param {string} newValue
* @param {JSON} json
* @return {JSON}
* @example
*
* const person = {name: 'James', age: 20, pets: ['dog', 'cat']};
* updateJSON('name', 'maria', person);
* // {"age": 20, "name": "maria", "pets": ["dog", "cat"]}
*
* Others: "modify" in Ramda
*/
export function updateJSON(key: string, newValue: any, json: JSON): JSON {
// JSON to Array
return Object.entries(json).map(
function (row: any[]): any[] {
// Replace value
return row[0] == key ? row.slice(0, 1).concat(newValue) : row
}
).reduce(
function (jsonUpdate: any, valueUpdate: any): JSON {
// Array to JSON
jsonUpdate[valueUpdate[0]] = valueUpdate[1];
return jsonUpdate;
}, {});
}
/**
* Creates a duplicate-free version of an array.
*
* @param {Array} array - The array to inspect.
* @return {Array} - Returns the new duplicate free array.
* @example
*
* uniqValuesArray([2, 1, 2, 2])
* // => [2, 1]
*/
export function uniqValuesArray(array: any[]): any[] {
return Array.from(new Set(array));
}
/**
* Clone JSON.
*
* @param {JSON} json - Object. Default {}.
* @return {JSON} New object.
* @example
*
* cloneObject({"edad": 23})
* // => {"edad": 23}
*
* cloneObject()
* // => {}
*
*/
export function cloneJSON(json: JSON): JSON {
return JSON.parse(JSON.stringify(json));
}