README
¶
fun -- Go Generic Functions and Tools
fun is a simple, well tested, zero-dependency, collection of
packages with generic function, tools, patterns, and the kind of thing
you could write one-offs for but shouldn't.
Packages:
- erc (error collecting)
- itertool (iterator tools)
- pubsub (message broker and queues)
- set (generic ordered and unordered sets)
For more information, see the documentation, but of general interest:
- In
itertoolsand withfun.Iterator, an iterator framework and tools for interacting with iterators and generators. - In
pubsub, a channel-based message broker (for one-to-many channel patterns), with several backend patterns for dealing with load-shedding and message distribution patterns. - In
erc, an error collector implementation for threadsafe error aggregation and introspection, particularly in worker-pool, applications. - In set, a
Settype, with ordered and unordered implementations. - Queue and Deque implementations (in
pubsub) that provide thread-safe linked-list based implementations andWaitmethods to block until new items added.
Contributions welcome, the general goals of the project:
- superior API ergonomics.
- great high-level abstractions.
- obvious and clear implementations.
Have fun!
Documentation
¶
Overview ¶
Package fun is a zero-dependency collection of tools and idoms that takes advantage of generics. Iterators, error handling, a native-feeling Set type, and a simple pub-sub framework for distributing messages in fan-out patterns.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Is ¶
Is a generic version of `errors.Is` that takes advantage of the Unwrap function, and is useful for checking if an object of an interface type is or wraps an implementation of the type parameter.
func Must ¶
Must wraps a function that returns a value and an error, and converts the error to a panic.
func Unwrap ¶
func Unwrap[T any](in T) T
Unwrap is a generic equivalent of the `errors.Unwrap()` function for any type that implements an `Unwrap() T` method. useful in combination with Is.
Types ¶
type Iterator ¶
type Iterator[T any] interface { Next(context.Context) bool Close(context.Context) error Value() T }
Iterator provides a safe, context-respecting iterator paradigm for iterable objects, along with a set of consumer functions and basic implementations.
The itertool package provides a number of tools and paradigms for creating and processing Iterator objects, including Generators, Map and Reduce, Filter as well as Split and Merge to combine or divide iterators.
In general, Iterators cannot be safe for access from multiple concurrent goroutines, because it is impossible to synchronize calls to Next() and Value(); however, itertool.Range() and itertool.Split() provide support for these workloads.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package erc provides a simple/fast error aggregation tool for collecting and aggregating errors.
|
Package erc provides a simple/fast error aggregation tool for collecting and aggregating errors. |
|
Package itertool provides a set of functional helpers for managinging and using fun.Iterator implementations, including a parallel Map/Reduce, Merge, and other convenient tools.
|
Package itertool provides a set of functional helpers for managinging and using fun.Iterator implementations, including a parallel Map/Reduce, Merge, and other convenient tools. |
|
Package pubsub provides a message broker for one-to-many or many-to-many message distribution.
|
Package pubsub provides a message broker for one-to-many or many-to-many message distribution. |
|
Package Set provides ordered and unordered set implementations for arbitrary comparable types.
|
Package Set provides ordered and unordered set implementations for arbitrary comparable types. |