https://github.com/gammazero/workerpool

Concurrency limiting goroutine pool
https://github.com/gammazero/workerpool

concurrency worker-pool

Last synced: 4 days ago
JSON representation

Concurrency limiting goroutine pool

• Host: GitHub
• URL: https://github.com/gammazero/workerpool
• Owner: gammazero
• License: mit
• Created: 2016-05-17T14:32:06.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-11-15T11:57:32.000Z (28 days ago)
• Last Synced: 2024-11-25T19:05:05.429Z (18 days ago)
• Topics: concurrency, worker-pool
• Language: Go
• Size: 85 KB
• Stars: 1,336
• Watchers: 22
• Forks: 139
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-go - workerpool - Goroutine pool that limits the concurrency of task execution, not the number of tasks queued. (Goroutines / Search and Analytic Databases)
• awesome-tools - workerpool - Concurrency limiting goroutine pool. (Programming / Go)
• awesome-go - workerpool - Goroutine pool that limits the concurrency of task execution, not the number of tasks queued. Stars:`1.3K`. (Goroutines / Search and Analytic Databases)
• awesome-go - workerpool - Concurrency limiting goroutine pool - ★ 51 (Goroutines)
• awesome-go-extra - workerpool - 05-17T14:32:06Z|2022-08-17T01:04:44Z| (Goroutines / Advanced Console UIs)

README

        
# workerpool

[![GoDoc](https://pkg.go.dev/badge/github.com/gammazero/workerpool)](https://pkg.go.dev/github.com/gammazero/workerpool)

[![Build Status](https://github.com/gammazero/workerpool/actions/workflows/go.yml/badge.svg)](https://github.com/gammazero/workerpool/actions/workflows/go.yml)

[![Go Report Card](https://goreportcard.com/badge/github.com/gammazero/workerpool)](https://goreportcard.com/report/github.com/gammazero/workerpool)

[![codecov](https://codecov.io/gh/gammazero/workerpool/branch/master/graph/badge.svg)](https://codecov.io/gh/gammazero/workerpool)

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/gammazero/workerpool/blob/master/LICENSE)

Concurrency limiting goroutine pool. Limits the concurrency of task execution, not the number of tasks queued. Never blocks submitting tasks, no matter how many tasks are queued.

This implementation builds on ideas from the following:

- http://marcio.io/2015/07/handling-1-million-requests-per-minute-with-golang

- http://nesv.github.io/golang/2014/02/25/worker-queues-in-go.html

## Installation

To install this package, you need to setup your Go workspace. The simplest way to install the library is to run:

```

$ go get github.com/gammazero/workerpool

```

## Example

```go

package main

import (

	"fmt"

	"github.com/gammazero/workerpool"

)

func main() {

	wp := workerpool.New(2)

	requests := []string{"alpha", "beta", "gamma", "delta", "epsilon"}

	for _, r := range requests {

		r := r

		wp.Submit(func() {

			fmt.Println("Handling request:", r)

		})

	}

	wp.StopWait()

}

```

[Example wrapper function](https://go.dev/play/p/BWnRhJYarZ1) to show start and finish time of submitted function.

## Usage Note

There is no upper limit on the number of tasks queued, other than the limits of system resources. If the number of inbound tasks is too many to even queue for pending processing, then the solution is outside the scope of workerpool. It should be solved by distributing workload over multiple systems, and/or storing input for pending processing in intermediate storage such as a file system, distributed message queue, etc.