1-liners
Version:
Useful oneliners and shorthand functions
178 lines (134 loc) • 5.86 kB
Markdown
<sup>MADE IN SWITZERLAND</sup>
[](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)
<h1 align="center"><a
title="Functional tools that couldn’t be simpler"
href="./documentation/README.md"
>
<br/>
<br/>
<br/>
<img
alt="1-liners"
src="https://cdn.rawgit.com/1-liners/Logos/master/logo.png"
width="382px"
height="125px"
/>
<br/>
<br/>
<br/>
<br/>
</a></h1>
**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
<p align="center">
<br/>
<br/>
<br/>
<img
src="https://cdn.rawgit.com/1-liners/Logos/master/swissknife.gif"
width="400px"
height="300px"
/>
<br/>
<br/>
<br/>
<br/>
<br/>
<br/>
</p>
## 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.
<p align="center"><a
title="from Beautiful Flat Icons by Nick Roach"
href="https://www.elegantthemes.com/blog/freebie-of-the-week/beautiful-flat-icons-for-free"
>
<br/>
<br/>
<img
alt="1-liners"
src="https://cdn.rawgit.com/1-liners/Logos/04c6949/megaphone.svg"
width="120px"
height="120px"
/>
<br/>
<br/>
<br/>
</a></p>
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)