Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Tinkoff/utils.js
Fast, small and purely functional utility library
https://github.com/Tinkoff/utils.js
curry lodash perfomance ramda tinkoff utils
Last synced: about 1 month ago
JSON representation
Fast, small and purely functional utility library
- Host: GitHub
- URL: https://github.com/Tinkoff/utils.js
- Owner: Tinkoff
- License: apache-2.0
- Archived: true
- Created: 2018-06-07T09:24:54.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-08-01T04:59:58.000Z (about 1 year ago)
- Last Synced: 2024-04-25T22:43:36.143Z (5 months ago)
- Topics: curry, lodash, perfomance, ramda, tinkoff, utils
- Language: TypeScript
- Homepage: https://tinkoff.github.io/utils.js/
- Size: 5.43 MB
- Stars: 177
- Watchers: 21
- Forks: 23
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Tinkoff Utils [](https://img.shields.io/github/actions/workflow/status/Tinkoff/utils.js/build.yml?branch=master) [](https://coveralls.io/github/Tinkoff/utils.js?branch=master)
> Fast, small and purely functional utility library
## Install
```
$ npm install @tinkoff/utils
```
## Features
- [Fast](#benchmarks)
- [Small](#bundle-size)
- [Fully tested](https://coveralls.io/github/Tinkoff/utils.js)
- [Documented](https://Tinkoff.github.io/utils.js)
- Purely functional
- Modern codebase
## Structure of the library
* [`/object`](https://github.com/Tinkoff/utils.js/tree/master/src/object) – for objects
* [`/string`](https://github.com/Tinkoff/utils.js/tree/master/src/string) – for strings
* [`/promise`](https://github.com/Tinkoff/utils.js/tree/master/src/promise) – for promises
* [`/array`](https://github.com/Tinkoff/utils.js/tree/master/src/array) – for arrays or array-like objects
* [`/function`](https://github.com/Tinkoff/utils.js/tree/master/src/function) – for functions – composition, currying and so on, also a set of simple functions (noop, T, F)
* [`/is`](https://github.com/Tinkoff/utils.js/tree/master/src/is) – set of type checking methods
* [`/`](https://github.com/Tinkoff/utils.js/tree/master/src) – root contains utilities which don't satisfy any of the above categories or are universal
## Usage
```js
import pathOr from '@tinkoff/utils/object/pathOr';
import compose from '@tinkoff/utils/function/compose';
import toLower from '@tinkoff/utils/string/toLower';
import map from '@tinkoff/utils/array/map'
const toLowerName = compose(
toLower,
pathOr(['name'], '')
);
const result = map(toLowerName)([{name: 'testA'}, {name: 'testb'}])
```
## Benchmarks
```bash
$ npm run benchmark
```
| Utility | Lodash | Ramda | Utils |
| --- | --- | --- | --- |
| clone | 120,807 ops/sec | 112,053 ops/sec | 293,572 ops/sec |
| array/filter | 2,080,728 ops/sec | 1,849,633 ops/sec | 2,046,113 ops/sec |
| is/empty | 1,506,963 ops/sec | 474,177 ops/sec | 3,731,564 ops/sec |
| function/flip | 7,528,745 ops/sec | 3,735,143 ops/sec | 3,490,207 ops/sec |
| object/path | 12,023,128 ops/sec | 8,894,639 ops/sec | 7,587,076 ops/sec |
| string/trim | 4,215,928 ops/sec | 1,034,655 ops/sec | 6,029,794 ops/sec |
## Browser support
- Chrome >= 40
- Firefox >= 52
- Edge >= 14
- IE >= 11
- Safari >= 10
- iOS >= 10
- Android >= 4.4
## Node support
- 6.4.0 and higher
## Bundle size
| Library | Bundle size |
| --- | --- |
| import _ from 'lodash' | 70.1 kb |
| import ... from 'lodash/...' | 21.8 kb |
| import R from 'ramda' | 41.3 kb |
| import ... from 'ramda/src/...' | 10 kb |
| import ... from '@tinkoff/utils/...' | 2.32 kb |
For detailed comparison with specific libraries see [COMPARE.md](https://github.com/Tinkoff/utils.js/tree/master/COMPARE.md)