Installations

npm install vanillas

Pull Requests

Open

2

Total

20

Closed

6

Merged

12

Issues

Open

0

Total

2

Closed

2

Releases

Unable to fetch releases

Developer

arizonatribe

Developer Guide

BETA

Module System

CommonJS, UMD

Min. Node Version

Typescript Support

Yes

Node Version

16.13.0

NPM Version

8.1.0 Statistics

11 Stars

167 Commits

1 Forks

2 Watching

5 Branches

1 Contributors

Updated on 23 Jul 2023

Bundle Size

16.75 kB

Minified

5.04 kB

Minified + Gzipped

Bundlephobia

Languages

JavaScript (99.84%)

TypeScript (0.16%)

Total Downloads

Cumulative downloads

Total Downloads

117,611

Last day

-32.4%

46

Compared to previous day

Last week

-16.5%

248

Compared to previous week

Last month

3.6%

1,505

Compared to previous month

Last year

-23.6%

16,866

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

No dependencies detected.

Versions

Vanillas

Vanillas JS

JavaScript utility functions. Comparable to Lodash or Ramda, but faster. In some cases it even outperforms native implementations (or leverages native implementations that are messy to type out).

Why Another Utils Lib?

Lodash/Underscore created an API many years ago which is unfavorable to Currying. For currying to be possible you need the final argument to your function to be the data on which you operate (rather than the first arg). And although Lodash/Underscore has an "fp" (functional programming) subset, the fundamental flaw in the argument order can't be corrected.

A similar utils library Ramda was created as a classic functional programming library, and the most notable change was to reorder the arguments to be favorable to currying. Ramda took it a step further than than (perhaps too far) of making every function in the whole library curried. This isn't always desired. But the more critical flaw with Ramda is it is slow. Very slow.

Vanillas was created to correct those perceived flaws in both Lodash/Underscore and Ramda. It outperforms those libraries, makes currying possible, yet allows you to opt-in to currying.

Docs

View the full docs. These are generated from - and always in-sync with - the JsDoc code annotations.

Curried vs Non-Curried

Importing from the root vanillas namespace yields all the non-curried utility functions (including the curry() function itself if you want to do your own). To use the curried versions of the Vanillas utility functions though, just import from the vanillas/curried directory rather than from the root.

Installation

npm install vanillas

Benchmarks

Run any of the files in the benchmark/test/ directory.

Examples (run one or more benchmark tests, space-delimited):

npm run benchmark compose
npm run benchmark propAt
npm run benchmark mapObject
npm run benchmark compose mapObject propAt

Or you can run all of them (grab a cup of coffee while you wait):

npm run benchmark

View Current Benchmarks

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

0

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Security-Policy

Determines if the project has published a security policy.

0

License

Determines if the project has defined a license.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.2

/10

Last Scanned on 2024-11-25

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More