ramda-adjunct 5.0.0 → 5.0.1

package/src/reduceRightP.js

@@ -1,101 +0,0 @@
-import { curryN, pipe, equals, reduceRight, length, concat } from 'ramda';
-
-import isUndefined from './isUndefined.js';
-import resolveP from './resolveP.js';
-import allP from './allP.js';
-
-// in older ramda versions the order of the arguments is flipped
-const flipArgs = pipe(reduceRight(concat, ''), equals('ba'))(['a', 'b']);
-
-/* eslint-disable max-len */
-/**
- * Given an `Iterable`(arrays are `Iterable`), or a promise of an `Iterable`,
- * which produces promises (or a mix of promises and values),
- * iterate over all the values in the `Iterable` into an array and
- * reduce the array to a value using the given iterator function.
- *
- * Similar to {@link RA.reduceP|reduceP} except moves through the input list from the right to the left.
- * The iterator function receives two values: (value, acc),
- * while the arguments' order of reduceP's iterator function is (acc, value).
- *
- * @func reduceRightP
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/1.13.0|v1.13.0}
- * @category List
- * @typedef MaybePromise = Promise.<*> | *
- * @sig ((MaybePromise b, Promise a) -> Promise a) -> MaybePromise a -> MaybePromise [MaybePromise b] -> Promise a
- * @param {Function} fn The iterator function. Receives two values, the current element from the list and the accumulator
- * @param {*|Promise.<*>} acc The accumulator value
- * @param {Array.<*>|Promise.<Array<*|Promise.<*>>>} list The list to iterate over
- * @return {Promise} The final, accumulated value
- * @see {@link RA.reduceP|reduceP}, {@link http://bluebirdjs.com/docs/api/promise.reduce.html|bluebird.reduce}
- * @example
- *
- * RA.reduceRightP(
- *   (fileName, total) => fs
- *     .readFileAsync(fileName, 'utf8')
- *     .then(contents => total + parseInt(contents, 10)),
- *   0,
- *   ['file1.txt', 'file2.txt', 'file3.txt']
- * ); // => Promise(10)
- *
- * RA.reduceRightP(
- *   (fileName, total) => fs
- *     .readFileAsync(fileName, 'utf8')
- *     .then(contents => total + parseInt(contents, 10)),
- *   Promise.resolve(0),
- *   ['file1.txt', 'file2.txt', 'file3.txt']
- * ); // => Promise(10)
- *
- * RA.reduceRightP(
- *   (fileName, total) => fs
- *     .readFileAsync(fileName, 'utf8')
- *     .then(contents => total + parseInt(contents, 10)),
- *   0,
- *   [Promise.resolve('file1.txt'), 'file2.txt', 'file3.txt']
- * ); // => Promise(10)
- *
- * RA.reduceRightP(
- *   (fileName, total) => fs
- *     .readFileAsync(fileName, 'utf8')
- *     .then(contents => total + parseInt(contents, 10)),
- *   0,
- *   Promise.resolve([Promise.resolve('file1.txt'), 'file2.txt', 'file3.txt'])
- * ); // => Promise(10)
- *
- */
-/* esline-enable max-len */
-const reduceRightP = curryN(3, (fn, acc, list) =>
-  resolveP(list).then((iterable) => {
-    const listLength = length(iterable);
-
-    if (listLength === 0) {
-      return acc;
-    }
-
-    const reducer = reduceRight((arg1, arg2) => {
-      let accP;
-      let currentValueP;
-
-      if (flipArgs) {
-        [accP, currentValueP] = [arg1, arg2];
-      } else {
-        [accP, currentValueP] = [arg2, arg1];
-      }
-
-      return accP
-        .then((previousValue) => allP([previousValue, currentValueP]))
-        .then(([previousValue, currentValue]) => {
-          if (isUndefined(previousValue) && listLength === 1) {
-            return currentValue;
-          }
-
-          return fn(currentValue, previousValue);
-        });
-    });
-
-    return reducer(resolveP(acc), iterable);
-  })
-);
-
-export default reduceRightP;

package/src/rejectP.js

@@ -1,24 +0,0 @@
-import { bind } from 'ramda';
-
-/**
- * Composable shortcut for `Promise.reject`.
- *
- * Returns a Promise object that is rejected with the given reason.
- *
- * @func rejectP
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/1.16.0|v1.16.0}
- * @category Function
- * @sig a -> Promise a
- * @param {*} [reason=undefined] Reason why this Promise rejected
- * @return {Promise} A Promise that is rejected with the given reason
- * @see {@link RA.resolveP|resolveP}
- * @example
- *
- * RA.rejectP(); //=> Promise(undefined)
- * RA.rejectP('a'); //=> Promise('a')
- * RA.rejectP([1, 2, 3]); //=> Promise([1, 2, 3])
- */
-const rejectP = bind(Promise.reject, Promise);
-
-export default rejectP;

package/src/renameKey.js

@@ -1,33 +0,0 @@
-import { curry } from 'ramda';
-
-import renameKeys from './renameKeys.js';
-
-/**
- * Creates a new object with the own properties of the provided object, but a
- * single key is renamed from `oldKey` to `newKey`.
- *
- * Keep in mind that in the case of keys conflict is behavior undefined and
- * the result may vary between various JS engines!
- *
- * @func renameKey
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/4.1.0|v4.1.0}
- * @category Object
- * @sig (String a, String b) => a -> b ->  {a: *} -> {b: *}
- * @param {!string} oldKey
- * @param {!string} newKey
- * @param {!Object} obj
- * @return {!Object} New object with renamed key
- * @see {@link https://github.com/ramda/ramda/wiki/Cookbook#rename-key-of-an-object|Ramda Cookbook}, {@link RA.renameKeyWith|renameKeyWith}
- * @example
- *
- * const input = { firstName: 'Elisia', age: 22, type: 'human' };
- *
- * RA.renameKey('firstName', 'name')(input);
- * //=> { name: 'Elisia', age: 22, type: 'human' }
- */
-const renameKey = curry((oldKey, newKey, obj) =>
-  renameKeys({ [oldKey]: newKey }, obj)
-);
-
-export default renameKey;

package/src/renameKeyWith.js

@@ -1,30 +0,0 @@
-import { curry, equals, when } from 'ramda';
-
-import renameKeysWith from './renameKeysWith.js';
-
-/**
- * Creates a new object with the own properties of the provided object, but the
- * key `key` renamed according to logic of renaming function.
- *
- * Keep in mind that in case the new key name already existed on the object,
- * the behaviour is undefined and the result may vary between various JS engines!
- *
- * @func renameKeyWith
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/2.29.0|v2.29.0}
- * @category Object
- * @sig (k -> k) -> k -> {k: v} -> {k: v}
- * @param {Function} fn Function that renames the keys
- * @param {!string} key Key to rename
- * @param {!Object} obj Provided object
- * @return {!Object} New object with renamed key
- * @see {@link RA.renameKeysWith|renameKeysWith}
- * @example
- *
- * RA.renameKeyWith(R.concat('a'), 'A', { A: 1 }) //=> { aA: 1 }
- */
-const renameKeyWith = curry((fn, key, obj) =>
-  renameKeysWith(when(equals(key), fn), obj)
-);
-
-export default renameKeyWith;

package/src/renameKeys.js

@@ -1,40 +0,0 @@
-import { curry, has } from 'ramda';
-
-import renameKeysWith from './renameKeysWith.js';
-
-const valueOrKey = (keysMap) => (key) => {
-  if (has(key, keysMap)) {
-    return keysMap[key];
-  }
-  return key;
-};
-
-/**
- * Creates a new object with the own properties of the provided object, but the
- * keys renamed according to the keysMap object as `{oldKey: newKey}`.
- * When some key is not found in the keysMap, then it's passed as-is.
- *
- * Keep in mind that in the case of keys conflict is behaviour undefined and
- * the result may vary between various JS engines!
- *
- * @func renameKeys
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/1.5.0|v1.5.0}
- * @category Object
- * @sig {a: b} -> {a: *} -> {b: *}
- * @param {!Object} keysMap
- * @param {!Object} obj
- * @return {!Object} New object with renamed keys
- * @see {@link https://github.com/ramda/ramda/wiki/Cookbook#rename-keys-of-an-object|Ramda Cookbook}, {@link RA.renameKeysWith|renameKeysWith}
- * @example
- *
- * const input = { firstName: 'Elisia', age: 22, type: 'human' };
- *
- * RA.renameKeys({ firstName: 'name', type: 'kind', foo: 'bar' })(input);
- * //=> { name: 'Elisia', age: 22, kind: 'human' }
- */
-const renameKeys = curry((keysMap, obj) =>
-  renameKeysWith(valueOrKey(keysMap), obj)
-);
-
-export default renameKeys;

package/src/renameKeysWith.js

@@ -1,27 +0,0 @@
-import { curry, toPairs, pipe, map, over, lensIndex, fromPairs } from 'ramda';
-
-/**
- * Creates a new object with the own properties of the provided object, but the
- * keys renamed according to logic of renaming function.
- *
- * Keep in mind that in the case of keys conflict is behaviour undefined and
- * the result may vary between various JS engines!
- *
- * @func renameKeysWith
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/1.5.0|v1.5.0}
- * @category Object
- * @sig (a -> b) -> {a: *} -> {b: *}
- * @param {Function} fn Function that renames the keys
- * @param {!Object} obj Provided object
- * @return {!Object} New object with renamed keys
- * @see {@link https://github.com/ramda/ramda/wiki/Cookbook#rename-keys-of-an-object-by-a-function|Ramda Cookbook}, {@link RA.renameKeys|renameKeys}
- * @example
- *
- * RA.renameKeysWith(R.concat('a'), { A: 1, B: 2, C: 3 }) //=> { aA: 1, aB: 2, aC: 3 }
- */
-const renameKeysWith = curry((fn, obj) =>
-  pipe(toPairs, map(over(lensIndex(0), fn)), fromPairs)(obj)
-);
-
-export default renameKeysWith;

package/src/repeatStr.js

@@ -1,30 +0,0 @@
-import { curry, invoker, flip } from 'ramda';
-
-import ponyfill from './internal/ponyfills/String.repeat.js';
-import isFunction from './isFunction.js';
-
-export const repeatStrPonyfill = curry(ponyfill);
-
-export const repeatStrInvoker = flip(invoker(1, 'repeat'));
-
-/**
- * Constructs and returns a new string which contains the specified
- * number of copies of the string on which it was called, concatenated together.
- *
- * @func repeatStr
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/2.11.0|v2.11.0}
- * @category List
- * @sig String -> Number -> String
- * @param {string} value String value to be repeated
- * @param {number} count An integer between 0 and +∞: [0, +∞), indicating the number of times to repeat the string in the newly-created string that is to be returned
- * @return {string} A new string containing the specified number of copies of the given string
- * @example
- *
- * RA.repeatStr('a', 3); //=> 'aaa'
- */
-const repeatStr = isFunction(String.prototype.repeat)
-  ? repeatStrInvoker
-  : repeatStrPonyfill;
-
-export default repeatStr;

package/src/replaceAll.js

@@ -1,35 +0,0 @@
-import { curryN, invoker } from 'ramda';
-
-import isFunction from './isFunction.js';
-import ponyfill from './internal/ponyfills/String.replaceAll.js';
-
-export const replaceAllPonyfill = curryN(3, ponyfill);
-
-export const replaceAllInvoker = invoker(2, 'replaceAll');
-
-/**
- * Replaces all substring matches in a string with a replacement.
- *
- * @func replaceAll
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/2.17.0|v2.17.0}
- * @category String
- * @sig String -> String -> String -> String
- * @param {string} searchValue The substring or a global RegExp to match
- * @param {string} replaceValue The string to replace the matches with
- * @param {string} str The String to do the search and replacement in
- * @return {string} A new string containing all the `searchValue` replaced with the `replaceValue`
- * @throws {TypeError} When invalid arguments provided
- * @see {@link http://ramdajs.com/docs/#replace|R.replace}, {@link https://github.com/tc39/proposal-string-replaceall|TC39 proposal}
- * @example
- *
- * RA.replaceAll('ac', 'ef', 'ac ab ac ab'); //=> 'ef ab ef ab'
- * RA.replaceAll('', '_', 'xxx'); //=> '_x_x_x_'
- * RA.replaceAll(/x/g, 'v', 'xxx'); //=> 'vvv'
- * RA.replaceAll(/x/, 'v', 'xxx'); //=> TypeError
- */
-const replaceAll = isFunction(String.prototype.replaceAll)
-  ? replaceAllInvoker
-  : replaceAllPonyfill;
-
-export default replaceAll;

package/src/resolveP.js

@@ -1,28 +0,0 @@
-import { bind } from 'ramda';
-
-/* eslint-disable max-len */
-/**
- * Composable shortcut for `Promise.resolve`.
- *
- * Returns a Promise object that is resolved with the given value.
- * If the value is a thenable (i.e. has a "then" method), the returned promise will
- * "follow" that thenable, adopting its eventual state.
- *
- * @func resolveP
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/1.16.0|v1.16.0}
- * @category Function
- * @sig a -> Promise a
- * @param {*} [value=undefined] Argument to be resolved by this Promise. Can also be a Promise or a thenable to resolve
- * @return {Promise} A Promise that is resolved with the given value, or the promise passed as value, if the value was a promise object
- * @see {@link RA.rejectP|rejectP}
- * @example
- *
- * RA.resolveP(); //=> Promise(undefined)
- * RA.resolveP('a'); //=> Promise('a')
- * RA.resolveP([1, 2, 3]); //=> Promise([1, 2, 3])
- */
-/* eslint-enable max-len */
-const resolveP = bind(Promise.resolve, Promise);
-
-export default resolveP;

package/src/round.js

@@ -1,26 +0,0 @@
-import { bind, curryN } from 'ramda';
-
-/**
- * Returns the value of a number rounded to the nearest integer.
- *
- * @func round
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/2.15.0|v2.15.0}
- * @category Math
- * @sig Number -> Number
- * @param {number} number The number to round
- * @return {number} The value of the given number rounded to the nearest integer
- * @example
- *
- * RA.round(0.9); //=> 1
- * RA.round(5.95); //=> 6
- * RA.round(5.5); //=> 6
- * RA.round(5.05); //=> 5
- * RA.round(-5.05); //=> -5
- * RA.round(-5.5); //=> -5
- * RA.round(-5.95); //=> -6
- */
-
-const round = curryN(1, bind(Math.round, Math));
-
-export default round;

package/src/seq.js

@@ -1,38 +0,0 @@
-import { curry, map, tap } from 'ramda';
-
-/* eslint-disable max-len */
-/**
- * Runs the given list of functions in order with the supplied object, then returns the object.
- * Also known as the normal order sequencing combinator.
- *
- * Acts as a transducer if a transformer is given as second parameter.
- *
- * @func seq
- * @aliases sequencing
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/2.3.0|v2.3.0}
- * @category Function
- * @sig [(a -> *), (a -> *), ...] -> a -> a
- * @param {Array} fns The list of functions to call in order with `x` whose return values will be thrown away
- * @param {*} x
- * @return {*} `x`
- * @see {@link http://ramdajs.com/docs/#tap|R.tap}, {@link http://www.cs.rpi.edu/academics/courses/spring11/proglang/handouts/lambda-calculus-chapter.pdf|sequencing combinator explained}
- * @example
- *
- * RA.seq([console.info, console.log])('foo'); //=> prints 'foo' via info then log
- *
- * // usage in composition
- * R.pipe(
- *   R.concat('prefix '),
- *   RA.seq([
- *     console.info, //=> prints 'prefix test'
- *     console.log //=> prints 'prefix test'
- *   ]),
- *   R.toUpper
- * )('test'); //=> 'PREFIX TEST'
- */
-/* eslint-enable max-len */
-
-const seq = curry((fns, x) => tap((tx) => map((fn) => fn(tx))(fns))(x));
-
-export default seq;

package/src/sign.js

@@ -1,33 +0,0 @@
-import { bind, curryN } from 'ramda';
-
-import isFunction from './isFunction.js';
-import ponyfill from './internal/ponyfills/Math.sign.js';
-
-export const signPonyfill = curryN(1, ponyfill);
-
-/**
- * Returns the sign of a number, indicating whether the number is positive, negative or zero.
- *
- * @func sign
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/2.15.0|v2.15.0}
- * @category Math
- * @sig Number | String -> Number
- * @param {number} number A number
- * @return {number} A number representing the sign of the given argument. If the argument is a positive number, negative number, positive zero or negative zero, the function will return 1, -1, 0 or -0 respectively. Otherwise, NaN is returned
- * @example
- *
- * RA.sign(3); //  1
- * RA.sign(-3); // -1
- * RA.sign('-3'); // -1
- * RA.sign(0); //  0
- * RA.sign(-0); // -0
- * RA.sign(NaN); // NaN
- * RA.sign('foo'); // NaN
- */
-
-const sign = isFunction(Math.sign)
-  ? curryN(1, bind(Math.sign, Math))
-  : signPonyfill;
-
-export default sign;

package/src/skipTake.js

@@ -1,33 +0,0 @@
-import {
-  curry,
-  addIndex,
-  filter,
-  pipe,
-  modulo,
-  identical,
-  nthArg,
-  __,
-} from 'ramda';
-
-/**
- * When given a number n and an array, returns an array containing every nth element.
- *
- * @func skipTake
- * @memberOf RA
- * @category List
- * @since {@link https://char0n.github.io/ramda-adjunct/2.26.0|v2.26.0}
- * @sig Number -> [a] -> [a]
- * @param {number} the nth element to extract
- * @param {Array} value the input array
- * @return {Array} An array containing every nth element
- * @example
- *
- * RA.skipTake(2, [1,2,3,4]) //=> [1, 3]
- * RA.skipTake(3, R.range(0, 20)); //=> [0, 3, 6, 9, 12, 15, 18]
- */
-
-const skipTake = curry((n, list) =>
-  addIndex(filter)(pipe(nthArg(1), modulo(__, n), identical(0)))(list)
-);
-
-export default skipTake;

package/src/sliceFrom.js

@@ -1,23 +0,0 @@
-import { __, slice } from 'ramda';
-
-/**
- * Returns the elements of the given list or string (or object with a slice method)
- * from fromIndex (inclusive).
- * Dispatches to the slice method of the second argument, if present.
- *
- * @func sliceFrom
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/1.16.0|v1.16.0}
- * @category List
- * @sig  Number -> [a] -> [a]
- * @param {number} fromIndex The start index (inclusive)
- * @param {Array|string} list The list or string to slice
- * @return {Array|string} The sliced list or string
- * @see {@link http://ramdajs.com/docs/#slice|R.slice}, {@link RA.sliceTo|sliceTo}
- * @example
- *
- * RA.sliceFrom(1, [1, 2, 3]); //=> [2, 3]
- */
-const sliceFrom = slice(__, Infinity);
-
-export default sliceFrom;

package/src/sliceTo.js

@@ -1,23 +0,0 @@
-import { slice } from 'ramda';
-
-/**
- * Returns the elements of the given list or string (or object with a slice method)
- * to toIndex (exclusive).
- * Dispatches to the slice method of the second argument, if present.
- *
- * @func sliceTo
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/1.16.0|v1.16.0}
- * @category List
- * @sig  Number -> [a] -> [a]
- * @param {number} toIndex The end index (exclusive)
- * @param {Array|string} list The list or string to slice
- * @return {Array|string} The sliced list or string
- * @see {@link http://ramdajs.com/docs/#slice|R.slice}, {@link RA.sliceFrom|sliceFrom}
- * @example
- *
- * RA.sliceTo(2, [1, 2, 3]); //=> [1, 2]
- */
-const sliceTo = slice(0);
-
-export default sliceTo;

package/src/sortByPaths.js

@@ -1,55 +0,0 @@
-import { ascend, identity, map, path, pipe, sortWith, useWith } from 'ramda';
-
-const pathToAscendSort = pipe(path, ascend);
-const mapPathsToAscendSort = map(pathToAscendSort);
-
-/**
- * Sort a list of objects by a list of paths (if first path value is equivalent, sort by second, etc).
- *
- * @func sortByPaths
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/3.1.0|v3.1.0}
- * @category List
- * @sig [[k]] -> [{k: v}] -> [{k: v}]
- * @param {Array.<Array.<string>>} paths A list of paths in the list param to sort by
- * @param {Array.<object>} list A list of objects to be sorted
- * @return {Array.<object>} A new list sorted by the paths in the paths param
- * @example
- *
- * const alice = {
- *   name: 'Alice',
- *   address: {
- *     street: 31,
- *     zipCode: 97777,
- *   },
- * };
- * const bob = {
- *   name: 'Bob',
- *   address: {
- *     street: 31,
- *     zipCode: 55555,
- *   },
- * };
- * const clara = {
- *   name: 'Clara',
- *   address: {
- *     street: 32,
- *     zipCode: 90210,
- *   },
- * };
- * const people = [clara, bob, alice]
- *
- * RA.sortByPaths([
- *   ['address', 'street'],
- *   ['address', 'zipCode'],
- * ], people); // => [bob, alice, clara]
- *
- * RA.sortByPaths([
- *   ['address', 'zipCode'],
- *   ['address', 'street'],
- * ], people); // => [bob, clara, alice]
- */
-
-const sortByPaths = useWith(sortWith, [mapPathsToAscendSort, identity]);
-
-export default sortByPaths;

package/src/sortByProp.js

@@ -1,45 +0,0 @@
-import { __, append, identity, useWith } from 'ramda';
-
-import sortByProps from './sortByProps.js';
-
-/**
- * Sort a list of objects by a property.
- *
- * @func sortByProp
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/3.4.0|v3.4.0}
- * @category List
- * @sig k -> [{k: v}] -> [{k: v}]
- * @param {Array.<string>} prop The property in the list param to sort by
- * @param {Array.<object>} list A list of objects to be sorted
- * @return {Array.<object>} A new list sorted by the property in the prop param
- * @example
- *
- * // sorting list of tuples
- * const sortByFirstItem = sortByProp(0);
- * const listOfTuples = [[-1, 1], [-2, 2], [-3, 3]];
- * sortByFirstItem(listOfTuples); // => [[-3, 3], [-2, 2], [-1, 1]]
- *
- * // sorting list of objects
- * const sortByName = sortByProp('name');
- * const alice = {
- *   name: 'ALICE',
- *   age: 101,
- * };
- * const bob = {
- *   name: 'Bob',
- *   age: -10,
- * };
- * const clara = {
- *   name: 'clara',
- *   age: 314.159,
- * };
- * const people = [clara, bob, alice];
- * sortByName(people); // => [alice, bob, clara]
- */
-
-const addValueInAnArray = append(__, []);
-
-const sortByProp = useWith(sortByProps, [addValueInAnArray, identity]);
-
-export default sortByProp;

package/src/sortByProps.js

@@ -1,31 +0,0 @@
-import { comparator, curry, either, lt, map, prop, reduce, sort } from 'ramda';
-
-/**
- * Sort a list of objects by a list of props (if first prop value is equivalent, sort by second, etc).
- *
- * @func sortByProps
- * @memberOf RA
- * @since {@link https://char0n.github.io/ramda-adjunct/2.26.0|v2.26.0}
- * @category List
- * @sig [k] -> [{k: v}] -> [{k: v}]
- * @param {Array.<string>} props A list of properties in the list param to sort by
- * @param {Array.<object>} list A list of objects to be sorted
- * @return {Array.<object>} A new list sorted by the properties in the props param
- * @example
- *
- * sortByProps(['num'], [{num: 3}, {num: 2}, {num: 1}])
- * //=> [{num: 1}, {num: 2} {num: 3}]
- * sortByProps(['letter', 'num'], [{num: 3, letter: 'a'}, {num: 2, letter: 'a'} {num: 1, letter: 'z'}])
- * //=> [ {num: 2, letter: 'a'}, {num: 3, letter: 'a'}, {num: 1, letter: 'z'}]
- * sortByProps(['name', 'num'], [{num: 3}, {num: 2}, {num: 1}])
- * //=> [{num: 1}, {num: 2}, {num: 3}]
- */
-
-const sortByProps = curry((props, list) => {
-  const firstTruthy = ([head, ...tail]) => reduce(either, head, tail);
-  const makeComparator = (propName) =>
-    comparator((a, b) => lt(prop(propName, a), prop(propName, b)));
-  return sort(firstTruthy(map(makeComparator, props)), list);
-});
-
-export default sortByProps;