Usage

$ npm install --save nanoutils

$ yarn add nanoutils

$ npm install --save-dev babel-plugin-nanoutils

$ yarn add --dev babel-plugin-nanoutils

{  "preset": ["env"]+ "plugins": ["nanoutils"]}

{  "scripts": {+   "babel": "babel --plugins nanoutils app.js",    "test": "jest && eslint ."  }}

const babel = require('babel-core')babel.transform('code', {+ plugins: ['nanoutils']})

Examples

Sort array of values by name alphabetically or by age

import{ascend,az,prop,sortBy}from"nanoutils";constsortByName=sortBy(az(prop("name")));constsortByAge=sortBy(ascend(prop("age")));constconsultants=[{name:"Mike",age:30},{name:"David",age:35},{name:"Alex",age:25},];sortByName(consultants);// [{ name: 'Alex', age: 25 }, { name: 'David', age: 35 }, { name: 'Mike', age: 30 }]sortByAge(consultants);// [{ name: 'Alex', age: 25 }, { name: 'Mike', age: 30 }, { name: 'David', age: 35 }]

Find sum of all ages which will be even next year

import{add,filterT,mapT,pipeT,prop,transduce}from"nanoutils";constisEven=(value)=>value%2===0;constsumOfAllEvenAgesNextYear=(array)=>transduce(pipeT(mapT(prop("age")),mapT(add(1)),filterT(isEven)),add,0,array);constconsultants=[{name:"Mike",age:30},{name:"David",age:35},{name:"Alex",age:25},];sumOfAllEvenAgesNextYear(ages);// 62

Return memoized mean

import{ascend,identity,join,mean,memoizeWith,sort}from"nanoutils";constgetHash=pipe(sort(ascend(identity)),join("-"));constmemoizedMean=memoizeWith(getHash,mean);memoizedMean([1,2,3]);// 2memoizedMean([1,2,3]);// 2 (extracts from memoizeWith function with hash='1-2-3')memoizedMean([3,1,2]);// 2 (extracts from memoizeWith function with hash='1-2-3')

Inspiration

Basic ideas

Can I use it in my project?

Roadmap

NPM scripts

Shortcut for new methods

npm run method:add <...methods> -- [flags]yarn method:add <...methods> -- [flags]Params:    methods           List with method names (separated by space)Flags:    -f                Overwrite methods (if exists)    --curried         Add curried method                      you can use --curried=<N> to add curryN    --types           Add index.d.ts for method typings    --perf            Add <method>.performance.js for performance test of method

index.js                File with methodindex.d.ts              TypeScript typings (if --types passed)method.test.js          Test for method (I use Jest)method.performance.js   Performance test for method (if --perf passed)

Check sizes of methods

npm run size <...methods>yarn size <...methods>Paramsmethods           List of method names (separated by space) you want to check.                  If no methods it will check size of all methods

Check time of methods

npm run time <...methods>yarn time <...methods>Paramsmethods           List of method names (separated by space) you want to check.                  If no methods it will check time of all possible methods (which have *.performance.js file)                  If type is set as no_perf (by default), it will throw an error: max.performance.js must have data to return

Check ramda/nanoutils diff

npm run method:check <type>yarn method:check <type>Paramstype           What to display?               - both: display methods that are both in ramda and nanoutils               - nano: display nanoutils methods that ramda doesn't have               - ramda: display ramda methods that nanoutils doesn't have