limiting

type KeyLimit struct {
	Keys  []string
	Limit int64
}

type Limiter interface {
	// Acquire attempts to reserve a slot without blocking.
	//
	// Returns a release function and true if successful. The function must be
	// called to release the limiter. The function must be called exactly once.
	// Calling the function more that once will cause incorrect behavior of the
	// limiter.
	//
	// Returns nil and false if fails.
	//
	// If the key was not defined in the limiter, no limit is applied.
	Acquire(key string) (ReleaseFunc, bool)

	// AcquireFirstOf attempts to reserve a slot without blocking.
	// Slot will be reserved by the first found key. Order in the provided keys
	// is important.
	//
	// Returns a release function and true if successful. The function must be
	// called to release the limiter. The function must be called exactly once.
	// Calling the function more that once will cause incorrect behavior of the
	// limiter.
	//
	// Returns nil and false if fails.
	//
	// If the keys was not defined in the limiter, no limit is applied.
	AcquireFirstOf(keys ...string) (ReleaseFunc, bool)
}

type ReleaseFunc func()

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