debouncer

README

Debouncer

Library for suppress duplicated calls in distributed systems.

Supported distributed cache and locker

• Redis
• Memcached
• Tarantool(coming soon)

Usage

package main

import (
	"time"

	"github.com/moeryomenko/debouncer"
	cache "github.com/moeryomenko/ttlcache"
)

func main() {
	// create distributed suppressor.
	redisCache, redisLocker := adapters.NewRedisDriver(redis.NewClient(&redis.Options{Addr: "<ip:port>"}))

	suppressor, err := debouncer.NewDebouncer(debouncer.Config{
		Local: {
			TTL:      time.Second,
			Caceh:    cache.NewCache(100, cache.ARC),
		},
		Distributed: {
			Cache:  redisCache,
			Locker: redisLocker,
			Retry:  20 * time.Millisecond,
			TTL:    3 * time.Second,
		},
	})
	if err != nil {
		panic("could not create suppressor")
	}

	...

	result, err := suppressor.Do(key /* token for acquire fn */, fn)
	if err != nil {
		panic("something gone wrong")
	}

	...
}

License

Debouncer is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and/or LICENSE-MIT for details.

Documentation

Index

• type Closure
• type Config
• type Debouncer
  • func NewDebouncer[V any](cfg Config[V]) (*Debouncer[V], error)
  • func (d *Debouncer[V]) Do(key string, closure Closure[V]) (V, error)
• type Distributed
• type DistributedGroup
  • func (g *DistributedGroup[V]) Do(key string, closure Closure[V]) (V, error)
• type Local
• type Serializer

Types

type Closure

type Closure[V any] func() (V, error)

type Config

type Config[V any] struct {
	Local[V]
	Distributed[V]
}

type Debouncer

type Debouncer[V any] struct {
	// contains filtered or unexported fields
}

Debouncer represents distributed suppressor duplicated calls.

func NewDebouncer

func NewDebouncer[V any](cfg Config[V]) (*Debouncer[V], error)

NewDebouncer returns new instance of Debouncer.

func (*Debouncer[V]) Do

func (d *Debouncer[V]) Do(key string, closure Closure[V]) (V, error)

Do executes and returns the results of the given function, making sure that only one execution is in-flight for a given key at a time. If a duplicate comes in from same instance, the duplicate caller waits for the original to complete and receives the same results. The return a channel that will receive the results when they are ready.

type Distributed

type Distributed[V any] struct {
	Locker     adapters.LockFactory
	Cache      adapters.Cache
	Retry      time.Duration
	TTL        time.Duration
	Serializer Serializer[V]
}

type DistributedGroup

type DistributedGroup[V any] struct {
	// contains filtered or unexported fields
}

DistributedGroup suppress duplicated calls.

func (*DistributedGroup[V]) Do

func (g *DistributedGroup[V]) Do(key string, closure Closure[V]) (V, error)

Do executes and returns the results of the given function, making sure that only one execution is in-flight for a given key at a time. If a duplicate comes in from intances, the duplicate caller waits for the only once instance to complete and receives the same results. The return a channel that will receive the results when they are ready.

type Local

type Local[V any] struct {
	TTL   time.Duration
	Cache suppressor.Cache[string, suppressor.Result[V]]
}

type Serializer

type Serializer[V any] interface {
	Serialize(V) ([]byte, error)
	Deserilize([]byte) (V, error)
}