https://github.com/modern-go/concurrent

concurrency utilities
https://github.com/modern-go/concurrent

concurrency concurrent go golang

Last synced: 30 days ago
JSON representation

concurrency utilities

• Host: GitHub
• URL: https://github.com/modern-go/concurrent
• Owner: modern-go
• License: apache-2.0
• Created: 2018-02-28T04:28:22.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2019-08-09T12:06:02.000Z (over 5 years ago)
• Last Synced: 2024-10-29T17:54:58.105Z (about 1 month ago)
• Topics: concurrency, concurrent, go, golang
• Language: Go
• Size: 23.4 KB
• Stars: 287
• Watchers: 7
• Forks: 23
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• go-awesome - concurrent - Concurrency Utilities (Open source library / Concurrency)

README

        
# concurrent

[![Sourcegraph](https://sourcegraph.com/github.com/modern-go/concurrent/-/badge.svg)](https://sourcegraph.com/github.com/modern-go/concurrent?badge)

[![GoDoc](http://img.shields.io/badge/go-documentation-blue.svg?style=flat-square)](http://godoc.org/github.com/modern-go/concurrent)

[![Build Status](https://travis-ci.org/modern-go/concurrent.svg?branch=master)](https://travis-ci.org/modern-go/concurrent)

[![codecov](https://codecov.io/gh/modern-go/concurrent/branch/master/graph/badge.svg)](https://codecov.io/gh/modern-go/concurrent)

[![rcard](https://goreportcard.com/badge/github.com/modern-go/concurrent)](https://goreportcard.com/report/github.com/modern-go/concurrent)

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://raw.githubusercontent.com/modern-go/concurrent/master/LICENSE)

* concurrent.Map: backport sync.Map for go below 1.9

* concurrent.Executor: goroutine with explicit ownership and cancellable

# concurrent.Map

because sync.Map is only available in go 1.9, we can use concurrent.Map to make code portable

```go

m := concurrent.NewMap()

m.Store("hello", "world")

elem, found := m.Load("hello")

// elem will be "world"

// found will be true

```

# concurrent.Executor

```go

executor := concurrent.NewUnboundedExecutor()

executor.Go(func(ctx context.Context) {

    everyMillisecond := time.NewTicker(time.Millisecond)

    for {

        select {

        case <-ctx.Done():

            fmt.Println("goroutine exited")

            return

        case <-everyMillisecond.C:

            // do something

        }

    }

})

time.Sleep(time.Second)

executor.StopAndWaitForever()

fmt.Println("executor stopped")

```

attach goroutine to executor instance, so that we can

* cancel it by stop the executor with Stop/StopAndWait/StopAndWaitForever

* handle panic by callback: the default behavior will no longer crash your application