singleflight

package

v1.0.39 Latest Latest Go to latest Published: Nov 29, 2023 License: Apache-2.0 Imports: 11 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/go-pay/gopher

Links

Open Source Insights

Documentation ¶

Overview ¶

Package singleflight provides a duplicate function call suppression mechanism.

Index ¶

type Group
type RedisGroup
- func WithRedisLock[V any](rd redis.Scripter) (g RedisGroup[V])
- func (g *RedisGroup[V]) Do(ctx context.Context, key string, ttl time.Duration, fn func() (V, error)) (v V, err error)
type Result

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Group ¶

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

Group represents a class of work and forms a namespace in which units of work can be executed with duplicate suppression.

func (*Group[V]) Do ¶

func (g *Group[V]) Do(key string, fn func() (V, error)) (v V, shared bool, err 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, the duplicate caller waits for the original to complete and receives the same results. The return value shared indicates whether v was given to multiple callers.

func (*Group[V]) DoChan ¶

func (g *Group[V]) DoChan(key string, fn func() (V, error)) <-chan Result[V]

DoChan is like Do but returns a channel that will receive the results when they are ready.

The returned channel will not be closed.

func (*Group[V]) Forget ¶

func (g *Group[V]) Forget(key string)

Forget tells the singleflight to forget about a key. Future calls to Do for this key will call the function rather than waiting for an earlier call to complete.

type RedisGroup ¶

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

func WithRedisLock ¶

func WithRedisLock[V any](rd redis.Scripter) (g RedisGroup[V])

func (*RedisGroup[V]) Do ¶

func (g *RedisGroup[V]) Do(ctx context.Context, key string, ttl time.Duration, fn func() (V, error)) (v V, err error)

type Result ¶

type Result[V any] struct {
	Val    V
	Shared bool
	Err    error
}

Result holds the results of Do, so they can be passed on a channel.

Source Files ¶

View all Source files

singleflight.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL