Skip to content

πŸ”’ Verrou is a library for managing Locks in Node.js. Support multiple drivers

License

Notifications You must be signed in to change notification settings

Julien-R44/verrou

Repository files navigation

banner


Verrou πŸ” is a locking library for Node.js applications

Features

  • πŸ”’ Easy usage
  • πŸ”„ Multiple drivers (Redis, Postgres, MySQL, Sqlite, In-Memory and others)
  • πŸ“¦ Multiple database adapters ( Knex, Kysely ... )
  • πŸ”‘ Customizable named locks
  • 🌐 Consistent API across all drivers
  • πŸ§ͺ Easy testing by switching to an in-memory driver
  • πŸ”¨ Easily extensible with your own drivers

See documentation at verrou.dev

Why Verrou ?

Main advantage of Verrou is that it provides a consistent API across all drivers. This means that you can switch from one driver to another without having to change your code. It also means you can switch to an in-memory in your test environment, making tests faster and easier to setup (no infrastructure or anything fancy to setup).

Having a consistent API also means that you don't have to learn a new API when switching from one driver to another. Today, in the node ecosystem, we have different npm packages to manage locks, but they all have differents APIs and behaviors.

But having a consistent API doesn't mean having a less powerful API. Verrou provides every features you would expect from a locking library, and even more.

Basic usage

import { Verrou } from '@verrou/core'
import { redisStore } from '@verrou/core/drivers/redis'
import { memoryStore } from '@verrou/core/drivers/memory'

const verrou = new Verrou({
  default: 'redis',
  stores: {
    redis: { driver: redisStore() },
    memory: { driver: memoryStore() }
  }
})

// Lock a resource and run a function
await verrou.createLock('my-resource').run(async () => {
  await doSomething()
}) // Lock is automatically released

Sponsors

If you like this project, please consider supporting it by sponsoring it. It will help a lot to maintain and improve it. Thanks a lot !