Security News
The Unpaid Backbone of Open Source: Solo Maintainers Face Increasing Security Demands
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
ramda-adjunct
Advanced tools
Ramda-adjunct is a community-maintained extension of the Ramda library, providing additional utility functions that complement Ramda's core functionality. It offers a wide range of functions for data manipulation, validation, and functional programming.
Data Manipulation
The `partitionIndexed` function splits a list into two lists based on a predicate function that takes both the value and the index. This is useful for more complex partitioning logic.
const RA = require('ramda-adjunct');
const R = require('ramda');
const data = [1, 2, 3, 4, 5];
const result = RA.partitionIndexed((val, idx) => idx % 2 === 0, data);
console.log(result); // [[1, 3, 5], [2, 4]]
Validation
The `isNotNilOrEmpty` function checks if a value is neither null nor an empty string, array, or object. This is useful for validation checks in your application.
const RA = require('ramda-adjunct');
const isValid = RA.isNotNilOrEmpty('Hello');
console.log(isValid); // true
Functional Programming
The `curryN` function allows you to curry a function with a specified arity. This is useful for creating more flexible and reusable functions.
const RA = require('ramda-adjunct');
const R = require('ramda');
const add = (a, b, c) => a + b + c;
const curriedAdd = RA.curryN(3, add);
console.log(curriedAdd(1)(2)(3)); // 6
Lodash is a popular utility library that provides a wide range of functions for data manipulation, validation, and functional programming. It is more widely used and has a larger community compared to ramda-adjunct.
Underscore is another utility library similar to Lodash, offering a variety of functions for data manipulation and functional programming. It is older and less feature-rich compared to Lodash but still widely used.
Ramda is the core library that ramda-adjunct extends. It focuses on functional programming and immutability, providing a set of utility functions for working with data in a functional style.
This library is a community maintained extension of Ramda.
It seems to be very common for people to create their own utils and recipes composing the Ramda functions and creating yet more complex aggregate functions. Ramda Adjunct tries to eliminate this repetitive wheel of reinvention and centralize most aggregate utils in its codebase.
As a maintainers, we see three main benefits in Ramda Adjunct.
All Ramda recipes and aggregate utils not present in Ramda are centralized here. There is no more need for everybody to create their own utils in their own codebases.
Creating custom aggregate utils or implementing recipes from Ramda wiki creates the defectiveness problem. The problem is caused by the absence of any tests. Ramda Adjunct keeps 100% code coverage and mimics the Ramda test patterns.
You cannot call a library great without a great documentation. Ramda Adjnuct generates its documentation directly from its codebase and uses patterns both found in Ramda and Lodash to document its API.
Do you want to find out more why this library exists ? Read this article.
Ramda Adjunct is being automatically tested against node version >=4 <=7.
We are building our npm distributions by Webpack to support also legacy versions of node starting from 0.10.48. Although all tests are run only against node version >=4 <=7, we rely on Webpack to transpile ramda-adjunct into legacy ES5. It is also possible that our ES5 distributions run on node versions older than 0.10.48 as long as they support ES5.
$ npm i ramda-adjunct
0.0.1, 0.1.0, 0.2.0, 0.3.0, 0.4.0, 0.5.1, 0.6.0, 0.7.0, 1.0.0, 1.1.0, 1.2.0, 1.3.0, 1.3.1, 1.3.2, 1.4.0, 1.5.0, 1.6.0, LATEST
If you want to contribute to this project, please consult the CONTRIBUTING.md guideline.
Obtaining project copy
$ git clone https://github.com/char0n/ramda-adjunct
$ npm i
Running tests
$ npm run test
Running linter
$ npm run lint
$ npm run build:es
If you use bundler that supports tree shaking and ES2015 imports.
package.json
is automatically pre-configured to tell ES2015 import
to import from this directory.
es/*
- ES5 code containing ES2015 imports
$ npm run build:commonjs
If you use node to import ramda-adjunct.
package.json
is automatically pre-configured to tell require
to import from this directory.
lib/*
- ES5 code containing commonjs
imports
$ npm run build:umd
The command will create three types of bundles.
dist/RA.node.js
- ES5 compliant bundle, running on all node versions
dist/RA.web.js
- ES5 compliant bundle, running in browsers. Requires ramda.js
to be required before
dist/RA.web.standalone.js
- ES5 compliant bundle, running in browsers. It has ramda.js
pre-bundled
You can always find fresh build files in circle-ci artifacts.
<script src="ramda.js"></script>
<script src="RA.web.js"></script>
or
<script src="RA.web.standalone.js"></script>
Including Ramda Adjunct into HTML document exposes global variable RA on window
object.
RA.isArray([]);
const RA = require('ramda-adjunct');
RA.isArray([]);
or
const { isArray } = require('ramda-adjunct');
isArray([]);
Although Ramda Adjunct is written in ES2016, we support Typescript. When Ramda Adjunct gets imported into Typescript project, typings are automatically imported and used.
char0n (Vladimir Gorej)
https://www.linkedin.com/in/vladimirgorej/
FAQs
Ramda Adjunct is the most popular and most comprehensive set of utilities for use with Ramda, providing a variety of useful, well tested functions with excellent documentation.
The npm package ramda-adjunct receives a total of 1,194,922 weekly downloads. As such, ramda-adjunct popularity was classified as popular.
We found that ramda-adjunct demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers 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
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Security News
License exceptions modify the terms of open source licenses, impacting how software can be used, modified, and distributed. Developers should be aware of the legal implications of these exceptions.
Security News
A developer is accusing Tencent of violating the GPL by modifying a Python utility and changing its license to BSD, highlighting the importance of copyleft compliance.