Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/1-liners/1-liners
Functional tools that couldn’t be simpler.
https://github.com/1-liners/1-liners
Last synced: 4 months ago
JSON representation
Functional tools that couldn’t be simpler.
- Host: GitHub
- URL: https://github.com/1-liners/1-liners
- Owner: 1-liners
- License: mit
- Created: 2015-04-19T07:45:41.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-04-16T13:08:38.000Z (almost 2 years ago)
- Last Synced: 2024-10-23T13:39:36.429Z (4 months ago)
- Language: JavaScript
- Homepage:
- Size: 608 KB
- Stars: 792
- Watchers: 24
- Forks: 57
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: license
Awesome Lists containing this project
- awesome-github-repos - 1-liners/1-liners - Functional tools that couldn’t be simpler. (JavaScript)
README
MADE IN SWITZERLAND
[](https://coveralls.io/r/1-liners/1-liners?branch=master)
[](https://travis-ci.org/1-liners/1-liners)
[](https://david-dm.org/1-liners/1-liners)
[](http://badge.fury.io/js/1-liners)
[](https://github.com/1-liners/1-liners/milestones/1.0)
[](https://gitter.im/1-liners/1-liners)
**Functional tools that couldn’t be simpler.**
We’re proud to present *1-liners* – a dead simple functional utility belt. **[137 one-liner functions][docs]** (and counting). Each hand-crafted with love and attention.
[docs]: ./documentation
## Our decalogue
You get a product of top-quality functional programming craftmanship. Each function follows the *KISS* principle, which we’ve broken down into ten strict rules.
We always follow them. You have our word.
1. Each function shall **[fit in one readable line of code][]**
– take a glimpse at the source and you know exactly what’s going on.
2. Each function shall **[have no side-effects][]**
– you can use it with confidence.
3. Each function shall **[have a fixed number of arguments][]**
– it’s dead easy to bind, curry and uncurry, apply partially, implode and explode.
4. Each function shall **[deal with data in an immutable way][]**
– no more debugging nightmares.
5. Each function shall **[take data as the last argument][]**
– this makes currying and composing new functions a breeze.
6. Each function shall **[be in a separate micro-module][]**
– you only load/bundle the single 1-liner you need.
7. Each function shall **[be thoroughly tested][]**
– 100% code coverage guaranteed. We even test if every function fits in one line!
8. Each function shall **[have great documentation][]**
– the docs explain usage, present the source, and link to the specs.
9. We shall provide functional versions of **[native object methods][]**
– like `reduce(callback, array)` for `array.reduce(callback)`.
10. We shall provide functional versions of **[language constructs][]**
– like `plus(a, b)` for `a + b`.
[fit in one readable line of code]: https://github.com/1-liners/1-liners/blob/28b02d0939d6bb4034693e48440f450141453ae9/module/flip.js#L18
[have no side-effects]: ./documentation#extend
[have a fixed number of arguments]: ./documentation#shave
[deal with data in an immutable way]: ./documentation#put
[take data as the last argument]: ./documentation#split
[be in a separate micro-module]: https://github.com/1-liners/1-liners/blob/28b02d0939d6bb4034693e48440f450141453ae9/module/compose.js
[be thoroughly tested]: https://coveralls.io/r/1-liners/1-liners?branch=master
[have great documentation]: ./documentation
[native object methods]: ./documentation#reduce
[language constructs]: ./documentation#plus
## Usage
### Install
```
$ npm install --save 1-liners
```
### Usage in ES5
```js
// The lightweight, recommended way:
var map = require('1-liners/map');
// Sometimes practical:
var map = require('1-liners').map;
```
### Usage in ES 2015 (formerly ES6)
```js
// The lightweight, recommended way:
import map from '1-liners/module/map';
// Sometimes practical:
import { map, filter } from '1-liners/module';
```
## API
Checkout the [documentation](./documentation)
## Maintainers
| [](https://github.com/stoeffel) | [](https://github.com/tomekwi) | [](https://github.com/hemanth) |
| :--:|:--:|:--: |
| [stoeffel](https://github.com/stoeffel) | [tomekwi](https://github.com/tomekwi) | [hemanth](https://github.com/hemanth) |
| [](https://github.com/davidchase) | [](https://github.com/tristaaan) |
| :--:|:--: |
| [davidchase](https://github.com/davidchase) | [tristaaan](https://github.com/tristaaan) |
created with [gh-contributors-table](https://github.com/stoeffel/gh-contributors-table)
## License
MIT © [stoeffel](http://schtoeffel.ch) [tomekwi](http://github.com/tomekwi) [hemanth](http://www.h3manth.com/) [davidchase](http://github.com/davidchase) [tristaaan](http://github.com/tristaaan)