Functional programming for Norwegians ⛷️
Not exactly. Well, not only for Norwegians. Inspired by Ramda, this an automatically curried, data-last, functional JavaScript library.
Declarative code
Much favored over "smart" code. As an example it is preferred to use existing higher-order functions like Array.prototype.every() instead of reimplementing similar logic using loops.
Predictable behaviors
B.map(B.inc, 1) should return 2. Not [], [undefined] or [2]. Just 2.
ES6 compliant
It is totally fine to do B.map(B.inc, new Set([1, 2, 3])). This will simply return Set {2, 3, 4}.
Feature-rich
As seen above, B.map knows how to handle Sets. Similarly, other B functions that can operate on Arrays, typically knows how to operate on other data structures as well.
const incCollection = B.map(B.inc)
incCollection([1, 2, 3])
// => [2, 3, 4]
incCollection(new Set([1, 2, 3]))
// => Set {2, 3, 4}
const isFoo = B.equals('foo')
const allIsFoo = B.all(isFoo)
allIsFoo({x: 'foo', y: 'foo', z: 'foo'})
// => true
allIsFoo(['foo', 'bar', 'baz'])
// => false
const takeTwo = B.take(2)
takeTwo(new Map([[1, 'a'], [2, 'b'], [3, 'c']]))
// => Map { 1 => 'a', 2 => 'b' }
takeTwo('foobar')
// => 'fo'
const double = B.multiply(2)
const addFive = B.add(5)
const incDoubleAndAddFive = B.compose(addFive, double, B.inc)
incDoubleAndAddFive(1)
// => 9
const sqrtOfProduct = B.pipe(B.multiply, Math.sqrt)
sqrtOfProduct(3, 12)
// => 6
const multiplyThree = (a, b, c) => a * b * c
const multiplyThreeCurried = B.curry(multiplyThree)
multiplyThreeCurried(2)
// => Function
multiplyThreeCurried(2)(3)
multiplyThreeCurried(2, 3)
// => Function
multiplyThreeCurried(2)(3)(4)
multiplyThreeCurried(2, 3)(4)
multiplyThreeCurried(2)(3, 4)
// => 24
Install using yarn:
yarn add bukk
Or npm:
npm install --save bukk
Import module:
import * as B from 'bukk'
import { compose, map, prop } from 'bukk'
Or add the B variable to the global scope:
<script src="nodule_modules/bukk/dist/bukk.js"></script>
Install dependencies:
yarn install
Build:
yarn run build
Will lint the source code, run tests and generate code coverage, and build a minified version of the library.
Test once:
yarn run test
Test in watch mode:
yarn run dev
Reading coverage reports:
yarn run report
"Bukk" means "ram" in Norwegian :)
B.addNumber --> Number --> Number
B.all(* --> Boolean) --> Array | Map | Object | Set | String --> Boolean
B.anda --> b --> a | b
B.any(* --> Boolean) --> Array | Map | Object | Set | String --> Boolean
B.append* --> Array | Map | Set | String --> Array | Map | Set | String
B.both(*... --> b) --> (*... --> d) --> b | d
B.composeFunction... --> Function
B.concatArray | Map | Set | String --> Array | Map | Set | String --> Array | Map | Set | String
B.curryFunction --> Function
B.decNumber --> Number
B.divideNumber --> Number --> Number
B.either(*... --> b) --> (*... --> d) --> b | d
B.equals* --> * --> Boolean
B.filter(* --> Boolean) --> Array | Map | Object | Set | String --> Array | Map | Object | Set | String
B.find(* --> Boolean) --> Array | Map | Object | Set | String --> *
B.flattenArray --> Array
B.gtNumber --> Number --> Boolean
B.gteNumber --> Number --> Boolean
B.headArray | Map | Set | String --> *
B.incNumber --> Number
B.initArray | Map | Set | String --> Array | Map | Set | String
B.kind* --> String
B.lastArray | Map | Set | String --> *
B.ltNumber --> Number --> Boolean
B.lteNumber --> Number --> Boolean
B.mapFunction --> * --> *
B.maxNumber --> Number --> Number
B.mergeObject --> Object --> Object
B.minNumber --> Number --> Number
B.multiplyNumber --> Number --> Number
B.none(* --> Boolean) --> Array | Map | Object | Set | String --> Boolean
B.ora --> b --> a | b
B.pipeFunction... --> Function
B.prepend* --> Array | Map | Set | String --> Array | Map | Set | String
B.propString --> Object --> *
B.rangeNumber --> Number --> Array
B.reduce(a --> b --> a) --> a --> Array | Map | Object | Set | String --> a
B.reject(* --> Boolean) --> Array | Map | Object | Set | String --> Array | Map | Object | Set | String
B.reverseArray | Map | Set | String --> Array | Map | Set | String
B.sliceNumber --> Number --> Array | Map | Set | String --> Array | Map | Set | String
B.sortByFunction --> Array | Map | Set --> Array | Map | Set
B.subtractNumber --> Number --> Number
B.tailArray | Map | Set | String --> Array | Map | Set | String
B.takeNumber --> Array | Map | Set | String --> Array | Map | Set | String
B.trimString --> String
B.type* --> String
B.zipArray --> Array --> Array
FAQs
Functional programming for Norwegians ⛷️
We found that bukk demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
pnpm 10 blocks lifecycle scripts by default to improve security, addressing supply chain attack risks but sparking debate over compatibility and workflow changes.
Product
Socket now supports uv.lock files to ensure consistent, secure dependency resolution for Python projects and enhance supply chain security.
Research
Security News
Socket researchers have discovered multiple malicious npm packages targeting Solana private keys, abusing Gmail to exfiltrate the data and drain Solana wallets.