History

Matthew Heon 1b761dbb02 Update json-iterator vendor to v1.1.5 We already have it vendored for a Kube package we import, but we want a more recent version with additional bugfixes over the 1.0 release we originally had. Signed-off-by: Matthew Heon <matthew.heon@pm.me>		2019-01-10 15:48:09 -05:00
..
LICENSE	Update json-iterator vendor to v1.1.5	2019-01-10 15:48:09 -05:00
README.md	Update json-iterator vendor to v1.1.5	2019-01-10 15:48:09 -05:00
executor.go	Update json-iterator vendor to v1.1.5	2019-01-10 15:48:09 -05:00
go_above_19.go	Update json-iterator vendor to v1.1.5	2019-01-10 15:48:09 -05:00
go_below_19.go	Update json-iterator vendor to v1.1.5	2019-01-10 15:48:09 -05:00
log.go	Update json-iterator vendor to v1.1.5	2019-01-10 15:48:09 -05:00
unbounded_executor.go	Update json-iterator vendor to v1.1.5	2019-01-10 15:48:09 -05:00

README.md

concurrent

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