ratelimit

Documentation

Index

• Variables
• type Window
  • func NewWindow(capacity int, size time.Duration) *Window
  • func (w *Window) Add() error
  • func (w *Window) Cap() int
  • func (w *Window) Len() int
  • func (w *Window) Newest() time.Time
  • func (w *Window) Oldest() time.Time
  • func (w *Window) Span() time.Duration

Variables

var ErrRateLimitExceeded = errors.New("rate limit exceeded")

Types

type Window

type Window struct {
	// contains filtered or unexported fields
}

Window is a time windows for counting events within a span of time. The windows slides forward in time so that it spans from the most recent event to size time in the past.

func NewWindow

func NewWindow(capacity int, size time.Duration) *Window

NewWindow creates a new Window that limits the number of events to maximum count of events within a duration of time. The capacity sets the maximum number of events, and size sets the span of time over which the events are counted.

func (*Window) Add

func (w *Window) Add() error

Add attempts to append a new timestamp into the current window. Previously added values that are not within `size` difference from the value being added are first removed. Add fails if adding the value would cause the window to exceed capacity.

func (*Window) Cap

func (w *Window) Cap() int

Cap returns the maximum number of items the window can hold.

func (*Window) Len

func (w *Window) Len() int

Len returns the number of elements currently in the window.

func (*Window) Newest

func (w *Window) Newest() time.Time

Newest returns the newest timestamp in the window.

func (*Window) Oldest

func (w *Window) Oldest() time.Time

Oldest returns the oldest timestamp in the window.

func (*Window) Span

func (w *Window) Span() time.Duration

Span returns the distance from the first to the last item in the window.