rubico 1.9.7 → 2.0.0

package/benchmarks/transform.js

@@ -1,218 +1,40 @@
-const timeInLoop = require('../x/timeInLoop')
-const rubico = require('rubico')
 const R = require('ramda')
-const _ = require('lodash')
-const _fp = require('lodash/fp')
-const { Readable, Writable } = require('stream')
+const Transducer = require('../Transducer')
+const TimeInLoopSuite = require('../_internal/TimeInLoopSuite')
+const transform = require('../transform')
 
-const isPromise = value => value != null && typeof value.then == 'function'
+const ramdaInto = R.into
+const ramdaMap = R.map
 
-const {
-  pipe, fork, assign,
-  tap, tryCatch, switchCase,
-  map, filter, reduce, transform, flatMap,
-  any, all, and, or, not,
-  eq, gt, lt, gte, lte,
-  get, pick, omit,
-} = rubico
+const suite = new TimeInLoopSuite()
 
-const square = number => number ** 2
+suite.add('rubico transform array -> array', () => {
+  transform([1, 2, 3, 4, 5], Transducer.map(number => number ** 2), [])
+})
 
-const isOdd = number => number % 2 == 1
+suite.add('rubico transform array -> array tacit', () => {
+  transform(Transducer.map(number => number ** 2), [])([1, 2, 3, 4, 5])
+})
 
-const squaredOdds = pipe([
-  filter(isOdd),
-  map(square),
-])
+suite.add('rubico transform array -> string', () => {
+  transform([1, 2, 3, 4, 5], Transducer.map(number => number ** 2), '')
+})
 
-const squaredOddsArrayConcat = transform(
-  squaredOdds, [],
-)
+suite.add('rubico transform array -> string tacit', () => {
+  transform(Transducer.map(number => number ** 2), '')([1, 2, 3, 4, 5])
+})
 
-/**
- * @name squaredOddsArrayConcat
- *
- * @benchmark
- * squaredOddsArrayConcat: 1e+5: 85.147ms
- *
- * @note Bo5
- */
+suite.add('ramda into array -> array', () => {
+  ramdaInto([], ramdaMap(number => number ** 2), [1, 2, 3, 4, 5])
+})
 
-{
-  const numbers = [1, 2, 3, 4, 5]
+suite.add('ramda into array -> string', () => {
+  ramdaInto('', ramdaMap(number => number ** 2), [1, 2, 3, 4, 5])
+})
 
-  const arrayEmpty = () => []
-
-  const squaredOddsArrayConcat = transform(squaredOdds, arrayEmpty)
-
-  // timeInLoop('squaredOddsArrayConcat', 1e5, () => squaredOddsArrayConcat(numbers))
-}
-
-/**
- * @name squaredOddsStringAdd
- *
- * @benchmark
- * squaredOddsStringAdd: 1e+5: 176.517ms
- *
- * @note Bo5
- */
-
-{
-  const numbers = [1, 2, 3, 4, 5]
-
-  const squaredOddsStringAdd = transform(squaredOdds, '')
-
-  // console.log(squaredOddsStringAdd(numbers))
-
-  // timeInLoop('squaredOddsStringAdd', 1e5, () => squaredOddsStringAdd(numbers))
-}
-
-/**
- * @name squaredOddsSetAdd
- *
- * @benchmark
- * squaredOddsSetAdd: 1e+5: 93.28ms
- *
- * @note Bo5
- */
-
-{
-  const numbers = [1, 2, 3, 4, 5]
-
-  const setEmpty = () => new Set()
-
-  const squaredOddsSetAdd = transform(squaredOdds, setEmpty)
-
-  // console.log(squaredOddsSetAdd(numbers))
-
-  // timeInLoop('squaredOddsSetAdd', 1e5, () => squaredOddsSetAdd(numbers))
-}
-
-/**
- * @name squaredOddsUint8ArrayConcat
- *
- * @benchmark
- * squaredOddsUint8ArrayConcat: 1e+5: 237.538ms
- *
- * @note Bo5
- */
-
-{
-  const numbers = [1, 2, 3, 4, 5]
-
-  const setEmpty = () => new Set()
-
-  const uint8ArrayEmpty = () => new Uint8Array(0)
-
-  const squaredOddsUint8ArrayConcat = transform(squaredOdds, uint8ArrayEmpty)
-
-  // console.log(squaredOddsUint8ArrayConcat(numbers))
-
-  // timeInLoop('squaredOddsUint8ArrayConcat', 1e5, () => squaredOddsUint8ArrayConcat(numbers))
-}
-
-const MockWritable = function (values) {
-  Writable.call(this)
-  this.array = [...values]
-  this.handlers = new Map()
-}
-
-MockWritable.prototype.write = function (chunk, encoding, callback) {
-  this.array.push(chunk)
-}
-
-MockWritable.prototype.on = function (eventName, handler) {
-  if (this.handlers.has(eventName)) {
-    this.handlers.get(eventName).push(handler)
-  } else {
-    this.handlers.set(eventName, [handler])
-  }
-}
-
-MockWritable.prototype.once = function (eventName, handler) {
-  this.handlers.set(eventName, [handler])
-}
-
-MockWritable.prototype.emit = function (eventName, ...args) {
-  if (!this.handlers.has(eventName)) {
-    return undefined
-  }
-  return this.handlers.get(eventName).map(handler => handler(...args))
-}
-
-/**
- * @name squaredOddsStreamConcat
- *
- * @benchmark
- *
- * @note Bo5
- * squaredOddsStreamConcat: 1e+5: 90.274ms
- */
-
-{
-  const numbers = [1, 2, 3, 4, 5]
-
-  const setEmpty = () => new Set()
-
-  const uint8ArrayEmpty = () => new Uint8Array(0)
-
-  const square = number => number ** 2
-
-  const squaredOddsStreamConcat = transform(squaredOdds, new MockWritable([]))
-
-  // console.log(squaredOddsStreamConcat(numbers))
-
-  // timeInLoop('squaredOddsStreamConcat', 1e5, () => squaredOddsStreamConcat(numbers))
-}
-
-/**
- * @name squaredOddsObjectAssign
- *
- * @benchmark
- * squaredOddsObjectAssign: 1e+5: 96.854ms
- *
- * @note Bo5
- */
-
-{
-  const numbers = [1, 2, 3, 4, 5]
-
-  const setEmpty = () => new Set()
-
-  const uint8ArrayEmpty = () => new Uint8Array(0)
-
-  const square = number => number ** 2
-
-  const objectEmpty = () => ({})
-
-  const squaredOddsObjectAssign = transform(squaredOdds, objectEmpty)
-
-  // console.log(squaredOddsObjectAssign(numbers))
-
-  // timeInLoop('squaredOddsObjectAssign', 1e5, () => squaredOddsObjectAssign(numbers))
+if (process.argv[1] == __filename) {
+  suite.on('caseBestRun', run => console.log(run.output))
+  suite.run()
 }
 
-/**
- * @name squaredOddsNullTransform
- *
- * @benchmark
- * squaredOddsNullTransform: 1e+5: 78.409ms
- *
- * @note Bo5
- */
-
-{
-  const numbers = [1, 2, 3, 4, 5]
-
-  const setEmpty = () => new Set()
-
-  const uint8ArrayEmpty = () => new Uint8Array(0)
-
-  const square = number => number ** 2
-
-  const squaredOddsNullTransform = transform(squaredOdds, null)
-
-  // console.log(squaredOddsNullTransform(numbers))
-
-  // timeInLoop('squaredOddsNullTransform', 1e5, () => squaredOddsNullTransform(numbers))
-}
+module.exports = suite

package/benchmarks/tryCatch.async.js

@@ -0,0 +1,25 @@
+const TimeInLoopSuite = require('../_internal/TimeInLoopSuite')
+const tryCatch = require('../tryCatch')
+
+const suite = new TimeInLoopSuite({ async: true, loopCount: 1e4 })
+
+suite.add('rubico tryCatch', async () => {
+  await tryCatch('hello', async message => {
+    throw new Error(message)
+    console.log(message)
+  }, async error => error)
+})
+
+suite.add('rubico tryCatch tacit', async () => {
+  await tryCatch(async message => {
+    throw new Error(message)
+  }, async error => error)('hello')
+})
+
+if (require.main == module) {
+  suite.on('caseBestRun', run => console.log(run.output))
+  suite.on('suiteBestRun', () => process.exit(0))
+  suite.run()
+}
+
+module.exports = suite

package/benchmarks/tryCatch.js

@@ -1,108 +1,32 @@
+const _fp = require('lodash/fp')
+const R = require('ramda')
+const TimeInLoopSuite = require('../_internal/TimeInLoopSuite')
 const tryCatch = require('../tryCatch')
-const timeInLoop = require('../x/timeInLoop')
 
-const isPromise = value => value != null && typeof value.then == 'function'
+const ramdaTryCatch = R.tryCatch
+const suite = new TimeInLoopSuite({ loopCount: 1e5 })
 
-const tryCatch2 = (tryer, catcher) => function tryCatcher(...args) {
-  try {
-    const output = tryer.apply(null, args)
-    return isPromise(output)
-      ? output.catch(err => catcher.call(null, err, ...args))
-      : output
-  } catch (err) {
-    return catcher.call(null, err, ...args)
-  }
-}
+suite.add('rubico tryCatch', () => {
+  tryCatch('hello', message => {
+    throw new Error(message)
+  }, error => error)
+})
 
-// argument resolver for curry3
-const curry3ResolveArg0 = (
-  baseFunc, arg1, arg2,
-) => function arg0Resolver(arg0) {
-  return baseFunc(arg0, arg1, arg2)
-}
+suite.add('rubico tryCatch tacit', () => {
+  tryCatch(message => {
+    throw new Error(message)
+  }, error => error)('hello')
+})
 
-// argument resolver for curry3
-const curry3ResolveArg1 = (
-  baseFunc, arg0, arg2,
-) => function arg1Resolver(arg1) {
-  return baseFunc(arg0, arg1, arg2)
-}
-
-// argument resolver for curry3
-const curry3ResolveArg2 = (
-  baseFunc, arg0, arg1,
-) => function arg2Resolver(arg2) {
-  return baseFunc(arg0, arg1, arg2)
-}
+suite.add('ramda tryCatch', () => {
+  ramdaTryCatch(message => {
+    throw new Error(message)
+  }, error => error)('hello')
+})
 
-/**
- * @name curry3
- *
- * @synopsis
- * __ = Symbol('placeholder')
- *
- * curry3(
- *   baseFunc function,
- *   arg0 __|any,
- *   arg1 __|any,
- *   arg2 __|any
- * ) -> function
- */
-const curry3 = function (baseFunc, arg0, arg1, arg2) {
-  if (arg0 == __) {
-    return curry3ResolveArg0(baseFunc, arg1, arg2)
-  }
-  if (arg1 == __) {
-    return curry3ResolveArg1(baseFunc, arg0, arg2)
-  }
-  return curry3ResolveArg2(baseFunc, arg0, arg1)
+if (process.argv[1] == __filename) {
+  suite.on('caseBestRun', run => console.log(run.output))
+  suite.run()
 }
 
-const tryCatch3 = (tryer, catcher) => function tryCatcher(...args) {
-  try {
-    const result = tryer(...args)
-    return isPromise(result)
-      ? result.catch(curry3(catcherApply, catcher, __, args))
-      : result
-  } catch (err) {
-    return catcher(err, ...args)
-  }
-}
-
-/**
- * @name tryCatch
- *
- * @benchmark
- * tryCatch2: 1e+6: 36.369ms
- * tryCatch3: 1e+6: 17.027ms
- *
- * TODO find the date
- */
-
-{
-  const identity = value => value
-
-  const noop = () => {}
-
-  const isPromise = value => value != null && typeof value.then == 'function'
-
-  // console.log(tryCatch2(identity, noop)('yo'))
-  // console.log(tryCatch3(identity, noop)('yo'))
-
-  // timeInLoop('tryCatch2', 1e6, () => tryCatch2(identity, noop)('yo'))
-
-  // timeInLoop('tryCatch3', 1e6, () => tryCatch3(identity, noop)('yo'))
-}
-
-/**
- * @name tryCatch 2022-06-13
- *
- * @benchmark
- * tryCatch: 1e+6: tryCatch: 1e+6: 39.787ms
- */
-
-{
-  const identity = value => value
-  const noop = () => {}
-  timeInLoop('tryCatch', 1e6, () => tryCatch2(identity, noop)('yo'))
-}
+module.exports = suite

package/{distributor.js → build}

@@ -1,21 +1,14 @@
+#!/usr/bin/env node
+
+require('./global')
 const rubico = require('./rubico')
 const rubicoX = require('./x')
+const Transducer = require('./Transducer')
 const rubicoVersion = require('./package.json').version
 const fs = require('fs')
 const nodePath = require('path')
 const { minify } = require('terser')
 
-const {
-  pipe, tap,
-  switchCase, tryCatch,
-  fork, assign, get, pick, omit,
-  map, filter, reduce, transform, flatMap,
-  and, or, not, any, all,
-  eq, gt, lt, gte, lte,
-  thunkify, always,
-  curry, __,
-} = rubico
-
 const {
   identity,
   noop,
@@ -56,7 +49,7 @@ const pathResolve = nodePath.resolve
 const pathDirname = nodePath.dirname
 
 // path string => cjs string
-const pathToCode = pipe.sync([
+const pathToCode = pipe([
   fs.readFileSync,
   toString,
   replace(/\/\*\*[\s\S]+?\*\//g, ''),
@@ -65,18 +58,19 @@ const pathToCode = pipe.sync([
 
 // path string => codeBundle string
 const pathToCodeBundle = pipe([
-  fork({
+  all({
     path: identity,
     code: pathToCode,
   }),
 
   ({ path, code }) => {
     const alreadyRequiredPaths = new Set()
-    let cwd = pathDirname(path),
-      result = code
+    const cwd = pathDirname(path)
+    let result = code
     while (result.includes('require(')) {
-      result = result.replace(/const \w+ = require\('(.+)'\)/g, (match, $1) => {
-        const requiredPath = pathResolve(cwd, `${$1}.js`)
+      result = result.replace(/const \w+ = require\('(?<path>.+)'\)/g, (match, p1, offset, source, groups) => {
+        const { path } = groups
+        const requiredPath = pathResolve(cwd, `${path}.js`)
         if (alreadyRequiredPaths.has(requiredPath)) {
           return ''
         }
@@ -85,26 +79,30 @@ const pathToCodeBundle = pipe([
 
         while (requiredCode.includes('require(')) {
           requiredCode = requiredCode.replace(
-            /const \w+ = require\('(.+)'\)/,
+            /const \w+ = require\('(?<path>.+)'\)/,
             pipe([
-              (match, $1) => $1,
-              filename => `${filename}.js`,
+              (match, p1, offset, source, groups) => groups.path,
+              path => `${path}.js`,
               curry.arity(2, pathResolve, pathDirname(requiredPath), __),
               switchCase([
                 requiredPath => alreadyRequiredPaths.has(requiredPath),
                 always(''),
                 pipe([
                   tap(requiredPath => alreadyRequiredPaths.add(requiredPath)),
-                  fork({
+                  all({
                     requiredPath: identity,
                     code: pathToCode,
                   }),
                   ({ requiredPath, code }) => {
-                    code = code.replace(/const (\w+) = require\('(.+)'\)/g, (match, $1, $2) => {
-                      const newPath = pathResolve(pathDirname(requiredPath), $2)
-                      const newStatement = `const ${$1} = require('${newPath}')`
-                      return newStatement
-                    })
+                    code = code.replace(
+                      /const (?<moduleName>\w+) = require\('(?<path>.+)'\)/g,
+                      (match, p1, p2, offset, source, groups) => {
+                        const { moduleName, path } = groups
+                        const newPath = pathResolve(pathDirname(requiredPath), path)
+                        const newStatement = `const ${moduleName} = require('${newPath}')`
+                        return newStatement
+                      }
+                    )
                     return code
                   },
                 ]),
@@ -129,25 +127,26 @@ const ignoredNames = new Set([
 // name string => boolean
 const nameIsIgnored = name => ignoredNames.has(name)
 
-pipe([
+const distributor = pipe([
   tap(tryCatch(
     thunkify(fs.promises.rm, `${__dirname}/dist`, { recursive: true }),
     noop)),
   tap(thunkify(fs.promises.mkdir, `${__dirname}/dist/x`, { recursive: true })),
   transform(
-    pipe([
-      filter(pipe([
+    compose([
+      Transducer.filter(pipe([
         get('name'),
         not(nameIsIgnored),
       ])),
-      map(assign({
+
+      Transducer.map(assign({
         baseCodeBundle: pipe([
           get('path'),
           pathToCodeBundle,
         ]),
       })),
 
-      map(switchCase([
+      Transducer.map(switchCase([
         or([
           ({ distPath }) => distPath.endsWith('rubico.mjs'),
           ({ distPath }) => distPath.endsWith('rubico.es.js'),
@@ -157,15 +156,15 @@ pipe([
 /**
  * rubico v${rubicoVersion}
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 ${baseCodeBundle}export {
   pipe, tap,
   switchCase, tryCatch,
-  fork, assign, get, set, pick, omit,
+  all, assign, get, set, pick, omit,
   map, filter, reduce, transform, flatMap,
-  and, or, not, any, all,
+  and, or, not, some, every,
   eq, gt, lt, gte, lte,
   thunkify, always,
   curry, __,
@@ -184,15 +183,15 @@ export default ${name}
 /**
  * rubico v${rubicoVersion}
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 ${(await minify(`${baseCodeBundle}export {
   pipe, tap,
   switchCase, tryCatch,
-  fork, assign, get, set, pick, omit,
+  all, assign, get, set, pick, omit,
   map, filter, reduce, transform, flatMap,
-  and, or, not, any, all,
+  and, or, not, some, every,
   eq, gt, lt, gte, lte,
   thunkify, always,
   curry, __,
@@ -208,7 +207,7 @@ export default ${name}`)).code}
 /**
  * rubico v${rubicoVersion}
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 ${baseCodeBundle}export default ${name}
@@ -221,7 +220,7 @@ ${baseCodeBundle}export default ${name}
 /**
  * rubico v${rubicoVersion}
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 ${(await minify(`${baseCodeBundle}export default ${name}`)).code}
@@ -234,7 +233,7 @@ ${(await minify(`${baseCodeBundle}export default ${name}`)).code}
 /**
  * rubico v${rubicoVersion}
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 
@@ -254,7 +253,7 @@ ${baseCodeBundle}return ${name}
 /**
  * rubico v${rubicoVersion}
  * https://github.com/a-synchronous/rubico
- * (c) 2019-2021 Richard Tong
+ * (c) 2019-2023 Richard Tong
  * rubico may be freely distributed under the MIT license.
  */
 
@@ -272,11 +271,11 @@ ${baseCodeBundle}return ${name}
         }
       ])),
 
-      forEach(pipe([
+      Transducer.map(tap(pipe([
         get('distPath'),
         replace(process.env.HOME, '~'),
         curry.arity(2, console.log, 'writing', __),
-      ])),
+      ]))),
     ]),
     {
       async concat({ distPath, codeBundle }) {
@@ -287,18 +286,19 @@ ${baseCodeBundle}return ${name}
     // Stdout,
     null,
   ),
-])([
+])
 
+distributor([
   Object.keys(rubico).map(pipe([
-    fork({
+    all({
       name: identity,
       path: pipe([
         name => `${name}.js`,
         curry.arity(2, pathResolve, __dirname, __),
       ]),
     }),
-  ])).flatMap(fork([
-
+  ]))
+  .flatMap(all([
     assign({
       type: always('esm'),
       distPath: pipe([
@@ -352,15 +352,15 @@ ${baseCodeBundle}return ${name}
   ])),
 
   Object.keys(rubicoX).map(pipe([
-    fork({
+    all({
       name: identity,
       path: pipe([
         name => `${name}.js`,
         curry.arity(3, pathResolve, __dirname, 'x', __),
       ]),
     }),
-
-  ])).flatMap(fork([
+  ]))
+  .flatMap(all([
     assign({
       type: always('esm'),
       distPath: pipe([