k3s/vendor/github.com/modern-go/concurrent
Darren Shepherd d246c89254 go mod vendor 2019-09-05 15:16:39 -07:00
..
.gitignore Update vendor 2019-01-11 21:58:27 -07:00
.travis.yml Update vendor 2019-01-11 21:58:27 -07:00
LICENSE Update vendor 2019-01-11 21:58:27 -07:00
README.md Update vendor 2019-01-11 21:58:27 -07:00
executor.go Update vendor 2019-01-11 21:58:27 -07:00
go_above_19.go Update vendor 2019-01-11 21:58:27 -07:00
go_below_19.go Update vendor 2019-01-11 21:58:27 -07:00
log.go Update vendor 2019-01-11 21:58:27 -07:00
test.sh go mod vendor 2019-09-05 15:16:39 -07:00
unbounded_executor.go Update vendor 2019-01-11 21:58:27 -07:00

README.md

concurrent

Sourcegraph GoDoc Build Status codecov rcard 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

m := concurrent.NewMap()
m.Store("hello", "world")
elem, found := m.Load("hello")
// elem will be "world"
// found will be true

concurrent.Executor

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