# HammerBackendRedis

A Redis backend for the [Hammer]( rate-limiter.

## Installation

is [available in Hex](, the package
can be installed by adding `hammer_backend_redis` to your list of dependencies in `mix.exs`:

def deps do
  [{:hammer_backend_redis, "~> 6.1"},
   {:hammer, "~> 6.0"}]

## Usage

Configure the `:hammer` application to use the Redis backend:

config :hammer,
  backend: {Hammer.Backend.Redis, [delete_buckets_timeout: 10_0000,
                                   expiry_ms: 60_000 * 60 * 2,
                                   redix_config: [host: "localhost",
                                                  port: 6379]]}

(the `redix_config` arg is a keyword-list which is passed to
[Redix](, it's also aliased to `redis_config`,
with an `s`)

Another option to configure Redis is to use the Redis Url format (see to configure Redis. If both options are specified
the redis_url will be used first.

config :hammer,
  backend: {Hammer.Backend.Redis, [delete_buckets_timeout: 10_0000,
                                   expiry_ms: 60_000 * 60 * 2,
                                   redis_url: "redis://HOST:PORT"]}

And that's it, calls to `Hammer.check_rate/3` and so on will use Redis to store
the rate-limit counters.

See the [Hammer Tutorial]( for more.

## Documentation

On hexdocs: [](

## Run tests locally

You need a running Redis instance. One can be started locally using `docker-compose up -d`.
See the docker-compose.yml for more details on.

## Getting Help

If you're having trouble, open an issue on this repo.