shad-go/ratelimit/README.md
2022-03-08 18:56:01 +03:00

1.8 KiB
Raw Blame History

ratelimit

Напишите примитив синхронизации, ограничивающий число вызовов на интервале времени.

func NewLimiter(maxCount int, interval time.Duration) *Limiter

func (l *Limiter) Acquire(ctx context.Context) error

func (l *Limiter) Stop()

Пользователь создаёт *Limiter, указывая параметры maxCount и interval.

После этого, пользователь вызывает Acquire из многих горутин. Некоторые из вызовов Acquire могут завершиться сразу, а некоторые могут заблокироваться.

Limiter должен гарантировать, что на любом интервале времени interval не больше maxCount вызовов Acquire могут завершиться без ошибки. Например, если interval равен 1s, maxCount равен 100, и 200 горутин сделали вызов Acquire одновременно, то 100 горутин должны выйти из Acquire сразу, а 100 других должны заблокироваться на секунду.

Каждый вызов Acquire должен либо завершаться успешно, либо завершаться с ошибкой в случае если ctx отменили во время ожидания. Об отмене ctx нужно узнавать по закрытию канала ctx.Done(). Если ctx отменён, нужно возвращать ошибку ctx.Err().

Вызовы Acquire() после Stop() должны сразу завершаться с ошибкой ErrStopped.