SMARTY DISCLAIMER: Subject to the terms of the associated license agreement, this software is freely available for your use. This software is FREE, AS IN PUPPIES, and is a gift. Enjoy your new responsibility. This means that while we may consider enhancement requests, we may or may not choose to entertain requests at our sole and absolute discretion.

funnel

A generic fan-out/fan-in library in Go.

Allows for easy implementation of the fan-out/fan-in pattern described on the Go blog.

How to use:

1. Load up (and CLOSE!) an input channel (optionally in a separate goroutine).
2. Provide the desired number of workers, the input channel, and a function that will process each item from the input channel to the FanOut function.
3. Read processed items from the channel returned by the FanOut function until it is consumed.

See the test file for an example.

Notes:

• Responsibility to close the input channel rests with the caller.
• Responsibility to close the output channel rests with this library.
• Passing 0 as the number of workers will result in a panic.
• While each item provided to the input channel will be processed, the order of those items on the output channel is non-deterministic.
• Calling FanOut will result in 2N+1 goroutines, where N is the number of workers specified.
• Each goroutine created will have exited by the time the output channel has been consumed.