Security News
Combatting Alert Fatigue by Prioritizing Malicious Intent
In 2023, data breaches surged 78% from zero-day and supply chain attacks, but developers are still buried under alerts that are unable to prevent these threats.
handy-redis
Advanced tools
A wrapper around node_redis with Promise and TypeScript support.
node_redis doesn't support Promises out-of-the-box - you have to use bluebird's promisifyAll
, which has the side effect of removing all TypeScript/intellisense support from the package.
This package is a wrapper around node_redis and exclusively uses Promises It publishes TypeScript types generated from the official redis documentation and examples, so it's much easier to know what parameters a command expects.
npm install --save handy-redis
ES6/TypeScript:
import { createHandyClient } from 'handy-redis';
(async function() {
const client = createHandyClient();
// or, call createHandyClient(opts) using opts for https://npmjs.com/package/redis
// or, call createHandyClient(oldClient) where oldClient is an existing node_redis client.
await client.set('foo', 'bar');
const foo = await client.get('foo');
console.log(foo);
})();
Vanilla JS:
const handyRedis = require('handy-redis');
const client = handyRedis.createHandyClient();
client
.set('foo', 'bar')
.then(() => client.get('foo'))
.then(foo => console.log(foo));
The package is published with TypeScript types, with the redis documentation and response type attached to each command:
See the snapshot tests for tons of usage examples (look at the .md
files).
Most members of node_redis's multi
type don't need to be promisified, because they execute synchronously. Only exec
is async. For a promisified version of that, use execMulti
:
import { createHandyClient } from 'handy-redis';
(async function() {
const client = createHandyClient();
const multi = client.multi().set("z:foo", "987").keys("z:*").get("z:foo");
const result = await client.execMulti(multi);
console.log(result); // ["OK", ["z:foo"], "987"]
})();
execMulti
is generic, so in TypeScript you can use something like const strings = await client.execMulti<string>(multi)
if you know all results will be strings. Otherwise the type will default to {}
.
Most of the package is generated by running sample commands from the redis documentation repo.
git clone https://github.com/mmkal/handy-redis --recursive
cd handy-redis
npm install
npm test
npm test
triggers npm run build
before running the tests - and the build
script generates the client before using TypeScript to compile it. If you want to run the tests without rebuilding, use npx ava
.
If you cloned without --recursive
you'll need to run git submodule update --init
to get the redis-doc repo locally.
If a snapshot test fails, it's possible it just needs to be updated. Make sure your git status is clean and run npm test -- -u
.
FAQs
A redis client with first-class Promise and TypeScript support, and extensive documentation.
The npm package handy-redis receives a total of 9,333 weekly downloads. As such, handy-redis popularity was classified as popular.
We found that handy-redis 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
In 2023, data breaches surged 78% from zero-day and supply chain attacks, but developers are still buried under alerts that are unable to prevent these threats.
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.