Which one do you like guys? Feedback?

@hemanth

• green
• red

@tomekwi

• green
• red

@stoeffel

• green
• red

I have just one revision at fiverr and I will get it as a SVG.

green	red

Something better than

Useful oneliners and shorthand functions

Check #34 for ideas.

I'm pretty bad with writing, would be nice to get some help from you guys. @hemanth @tomekwi

• toExponential
• toFixed
• toLocaleString
• toPrecision
• toString (does it make sense? we have the native String())
• valueOf

Mention that:

• all functions are pure
• all functions have a stable number of arguments
• all functions are in one line
• we have functional versions of many native object methods
• and functional versions of most operators

How about:

• showing the source of every function in the readme

There’s lots of fiery development going on at the moment. I know the 0.x semver version already means the same – but why not warn people even so?

How about one of these ugly guys https://github.com/badges/stability-badges:

Or some prettier ones http://shields.io:

This way taking off the “unstable” badge will be a point to look forward to and celebrate :D

That’s the name scala uses: http://www.scala-lang.org/api/current/index.html#scala.Array@fold[A1>:A](z:A1)(op:(A1,A1)=>A1):A1

Create a npm task to create the documentation in the readme from jsdoc.

Add functions to check if argument is of a type

• isString
• isObject
• isPlainObject
• isBoolean
• isNumber
• isFunction
• isTypeOf === typeof arg === 'function'
• isTrue
• isFalse
• isNull
• isUndefined

• concat
• copyWithin
• entries
• every
• fill
• filter
• find
• findIndex
• forEach
• includes
• indexOf
• join
• keys
• lastIndexOf
• map
• pop
• push
• reduce
• reduceRight
• reverse
• shift
• slice
• some
• sort (immutable version)
• splice (immutable version)
• toLocaleString
• toString (does it make sense? we have the native String())
• unshift
• values

^^

^^

#94 (comment)

For example: “same as array.reduce”

^^

• lt
• gt
• le
• ge

• clear
• delete
• entries
• forEach
• get
• has
• keys
• set
• values

replace(regEx, string)

see #19

How about we add pre-commit to ensure that npm run toc and npm run test is run before commiting?

^^

• TOC in the readme
• add them as owners
• create a nice logo (WIP)
• contributors list

How do you feel about adding a step to the prepublish task to create a folder ./curry with all the functions curryied.
So a user can require i.e.

var ifElse = require('1-liners/curry/ifElse');
ifElse(cond)(then)(otherwise);

The generated modules in curry would look like this:

var curry = require('../curry3'); // 1, 2, 3 or 4 the task needs to check the length of the function
module.exports = curry(require('../ifElse'));

// cc @hemanth @tomekwi @tristaaan

When size doesn’t matter, you’d sometimes just want to save 5 lines of code and write:

import {flip, curry2, split, and, or, isTruthy} from '1-liners/module';

Here’s one way to do it – which works both for require and the ES6 import:

• module.js
• module/index.js

in readme

Like 101/put.

For example:

(key, value, object) => Object.assign({}, object, {[key]: value});

• exec
• test
• toString (does it make sense? We have the native String())

#94 (comment)

We want them to match those at MDN. For example, instead of:

// 1-liners/reduceFrom
export default (reduce, initial, arr) => arr.reduce(reduce, initial);

we’d want:

export default (callback, initialValue, array) => array.reduce(callback, initialValue);

In JS:

arr.reduce(callback[, initialValue])

In 1-liners:

reduce

Same as [1, 2, 3].reduce(sum).

var reduce = require('1-liners/reduce');

reduce(sum, [1, 2, 3]); // => 6

^{Spec • Source: (reduce, arr) => arr.reduce(reduce);}

We don’t want to overload the function, because it will make auto-currying impossible. How about this then:

const reduce = require('1-liners/reduce/2');  // or just '1-liners/reduce'

reduce(callback, array);

const reduce = require('1-liners/reduce/3');

reduce(callback, array, initialValue);

I can't see the repo on coveralls.io

• apply
• bind
• call
• toString (does it make sense? we have the native String())

I’ve never really had the time to get my hands on it, but AFAIK pure functional languages come with currying out of the box.

I like it how 1-liners stays lean – without dependencies – without inter-module imports – without auto-currying and other fancy. But I often find myself currying half of the 1-liners functions I import.

How about creating another repo with all functions auto-curried by default? With chickencurry or something.

import between from '1-liners-plus/between';

between(1, 10, 2.5) ===
between(1)(10, 2.5) ===
between(1, 10)(2.5) ===
between(1)(10)(2.5);

• add
• clear
• delete
• entries
• forEach
• has
• values

Converges two functions into one.

converge(plus, times, by)(3, 3) // === plus(times(3, 3), by(3, 3))

@stoeffel seems quite similar in scope. Why not integrate head and tail into 101?

• 1-liners/es6-indexer (utils/createIndex.js)
• use doxie
• 1-liners/get-modules (utils/getModules.js)

It doesn’t have a stable number of arguments. I suggest splitting this down into two functions:

export const ifThen (predicate, then) => …
export const ifThenElse (predicate, then, else) => …

Then it’ll also be more clear from the name of the function what it does.

We should add includes.

includes(2, [1, 2, 3]); // => true
var includes2 = curry(includes)(2);
includes2([1, 2, 3]); // => true

match(regEx, string)

#67 (comment)

• charAt
• charCodeAt
• codePointAt
• concat (is it needed when we have plus?)
• endsWith
• includes
• indexOf
• lastIndexOf
• localeCompare
• match
• normalize
• repeat
• replace
• search
• slice
• split
• startsWith
• substr
• substring
• toLocaleLowerCase
• toLocaleUpperCase
• toLowerCase
• toString (does it make sense? we have the native String())
• toUpperCase
• trim
• valueOf

https://github.com/blog/1184-contributing-guidelines

We should state in the contributing.md that all new functions must be in one line.

• and
• bitAnd
• or
• bitOr
• not
• compose
• nand
• nor
• nth
• noop
• apply
• pipe
• length
• inc
• dec
• equal
• looseEqual
• lt
• gt
• le
• ge
• bind
• call
• has
• converge
• isString
• isObject
• isBoolean
• isNumber
• isInt
• isPlainObject
• plus
• minus
• times (I don’t like this name)
• by
• isTrue
• isFalse
• isNull
• isUndefined

Function

• curry1,2,3,4

Array functions

• filter(function, array)
• reduce(function, array)
• every(function, array)
• some(function, array)
• reduceRight(function, array)
• reduceFrom(function, initialValue, array)
• reduceRightFrom(function, initialValue, array)
• forEach(function, array)

String functions

• join(string, array)
• split(splitStr, string)
• word
• csv

RegExp

• replace(regEx, string)
• match(regEx, string)

This is what happened to me after a fresh npm install (only the relevant part):

> [email protected] istanbul …/1-liners/1-liners
> istanbul cover ./node_modules/mocha/bin/_mocha  -- --report lcov --compilers js:babel/register --ui qunit ./tests

No coverage information was collected, exit without writing coverage information
…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/transformation/file/logger.js:37
    throw new Constructor(this._buildMessage(msg));
          ^
ReferenceError: [BABEL] …/1-liners/1-liners/tests/always.js: Unknown option: attachAuxiliaryComment
    at Logger.error (…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/transformation/file/logger.js:37:11)
    at File.normalizeOptions (…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/transformation/file/index.js:154:29)
    at new File (…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/transformation/file/index.js:133:22)
    at TransformerPipeline.transform (…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/transformation/transformer-pipeline.js:96:16)
    at Object.transformFileSync (…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/api/node.js:108:42)
    at compile (…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/api/register/node.js:109:20)
    at Object._fs2.default.readFileSync (…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/api/register/node.js:143:18)
    at Module._extensions.(anonymous function) (…/1-liners/1-liners/node_modules/istanbul/lib/hook.js:103:29)
    at istanbulLoader (…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/api/register/node.js:156:3)
    at Object.require.extensions.(anonymous function) [as .js] (…/1-liners/1-liners/node_modules/babel/node_modules/babel-core/lib/babel/api/register/node.js:173:7)
    at Module.load (module.js:355:32)
    at Function.Module._load (module.js:310:12)
    at Module.require (module.js:365:17)
    at require (module.js:384:17)
    at …/1-liners/1-liners/node_modules/mocha/lib/mocha.js:192:27
    at Array.forEach (native)
    at Mocha.loadFiles (…/1-liners/1-liners/node_modules/mocha/lib/mocha.js:189:14)
    at Mocha.run (…/1-liners/1-liners/node_modules/mocha/lib/mocha.js:422:31)
    at Object.<anonymous> (…/1-liners/1-liners/node_modules/mocha/bin/_mocha:398:16)
    at Module._compile (module.js:460:26)
    at Object.Module._extensions..js (module.js:478:10)
    at Object.Module._extensions.(anonymous function) (…/1-liners/1-liners/node_modules/istanbul/lib/hook.js:107:37)
    at Module.load (module.js:355:32)
    at Function.Module._load (module.js:310:12)
    at Function.Module.runMain (module.js:501:10)
    at runFn (…/1-liners/1-liners/node_modules/istanbul/lib/command/common/run-with-cover.js:122:16)
    at …/1-liners/1-liners/node_modules/istanbul/lib/command/common/run-with-cover.js:248:17
    at …/1-liners/1-liners/node_modules/istanbul/lib/util/file-matcher.js:68:16
    at …/1-liners/1-liners/node_modules/istanbul/node_modules/async/lib/async.js:251:17
    at done (…/1-liners/1-liners/node_modules/istanbul/node_modules/async/lib/async.js:132:19)
    at …/1-liners/1-liners/node_modules/istanbul/node_modules/async/lib/async.js:32:16
    at …/1-liners/1-liners/node_modules/istanbul/node_modules/async/lib/async.js:248:21
    at LOOP (fs.js:1474:14)
    at process._tickCallback (node.js:355:11)

import curry from '1-liners/curry2';

const f = (a, b, c, d) => a * b - c * d + e;
const fβ = curry(f)                       // ~= curry2       
const fγ = curry(curry(f))                // ~= curry3                
const fδ = curry(curry(curry(f)))         // ~= curry4                           
const fε = curry(curry(curry(curry(f))))  // ~= curry5

f(1, 2, 3, 4, 5)  === -5

fβ(1)(2, 3, 4, 5) === -5
fβ(1, 2)(3, 4, 5) === -5
fβ(1, 2, 3)(4, 5) === -5
fβ(1, 2, 3, 4)(5) === -5

fγ(1)(2)(3, 4, 5) === -5
fγ(1)(2, 3)(4, 5) === -5
fγ(1, 2)(3, 4)(5) === -5

fδ(1)(2)(3)(4, 5) === -5
fδ(1)(2)(3, 4)(5) === -5
fδ(1)(2, 3)(4)(5) === -5
fδ(1, 2)(3)(4)(5) === -5

fε(1)(2)(3)(4)(5) === -5

Let’s just leave curry2 and name it curry.

Less is more.

• getDate
• getDay
• getFullYear
• getHours
• getMilliseconds
• getMinutes
• getMonth
• getSeconds
• getTime
• getTimezoneOffset
• getUTCDate
• getUTCDay
• getUTCFullYear
• getUTCHours
• getUTCMilliseconds
• getUTCMinutes
• getUTCMonth
• getUTCSeconds
• setDate
• setFullYear
• setHours
• setMilliseconds
• setMinutes
• setMonth
• setSeconds
• setTime
• setUTCDate
• setUTCFullYear
• setUTCHours
• setUTCMilliseconds
• setUTCMinutes
• setUTCMonth
• setUTCSeconds
• toDateString
• toISOString
• toJSON
• toLocaleDateString
• toLocaleString
• toLocaleTimeString
• toString (does it make sense? we have the native String())
• toTimeString
• toUTCString
• valueOf

add coveralls and coverage badge

^^

#94 (comment)

I think we’d need to link between functions that do more or less the same thing, but take a different number of parameters.